Creazione di un pubblico nel settore immobiliare

A partire dal rilascio dell'API Marketing v15.0, non potrai più creare gruppi di pubblico dell'inserzione speciale. Per maggiori informazioni, consulta Gruppi di pubblico dell'inserzione speciale.

Come creare un pubblico nel settore immobiliare:

Passaggio 1: configurazione dei segnali dell'utente per gli eventi immobiliari

Si tratta di nomi di eventi predefiniti che puoi inviare dal tuo sito web o dalla tua app che consentono di misurare le prestazioni delle campagne e di acquisire le intenzioni del pubblico. Vedi Configurazione del pixel di Facebook.

Le inserzioni per il settore immobiliare richiedono questi eventi standard da parte del pixel del tuo sito web e della tua app mobile:

Evento del pixelEvento nell'appLivello di requisitiDescrizione

Search

fb_mobile_search

Qualcuno ha cercato annunci immobiliari

ViewContent

fb_mobile_content_view

Qualcuno ha visualizzato uno specifico annuncio

InitiateCheckout

fb_mobile_initiated_ checkout

Qualcuno ha salvato l'annuncio, messo "Mi piace" o mostrato un particolare interesse

Purchase

fb_mobile_purchase

Qualcuno ha contattato un agente in merito a un annuncio

  • Obbligatorio: le inserzioni non funzionano senza questi parametri.
  • Consigliato: non strettamente obbligatorio ma consente di offrire consigli migliori e opzioni più targetizzate per le tue inserzioni. Fornirne il più possibile.
  • Non obbligatorio: non è obbligatorio e può essere ignorato.

Ad esempio, per riportare un evento di ricerca per un annuncio utilizzando il pixel di FB o gli eventi nell'app, inserisci questo codice nella tua pagina dei risultati di ricerca:

<!-- Facebook Pixel Code -->
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "home_listing");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"1234\", \"2345\", \"3456\", \"4567\"]"); // top search results

// we must prefix all travel-specific parameters with fb_
parameters.putString("fb_city", "New York City"); // Required for Search event
parameters.putString("fb_region", "New York"); // region is the state for the US. Required for Search event
parameters.putString("fb_country", "US"); // Required for Search event

logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);
[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
  parameters:@{
    FBSDKAppEventParameterNameContentType : @"home_listing",
    FBSDKAppEventParameterNameContentID : @"[\"1234\", \"2345\", \"3456\", \"4567\"]", // top search results
		// we must prefix all travel-specific parameters with fb_
		@"fb_city" : @"New York City", //Required for Search event
	  @"fb_region" : @"New York", // region is the state for the US. Required for Search event
	  @"fb_country" : @"US", // Required for Search event
  }
];

Una volta stabilito quali eventi devono essere attivati, devi fornire i parametri per ciascuno di essi.

Parametri degli eventi

La tabella sotto elenca i parametri richiesti e consigliati.

Parametro del pixelParametro per app mobileLivello di requisiti

content_ids

fb_content_id

content_type

fb_content_type

lease_start_date

lease_end_date

preferred_baths_range

preferred_beds_range

preferred_price_range

currency

fb_currency

property_type

listing_type

availability

city

fb_city

neighborhood

region

fb_region

country

fb_country

Dettagli parametro

Nome del parametroTipo di datiDescrizione

availability

string

Il valore deve essere available_soon, for_rent, for_sale, off_market, recently_sold o sale_pending.

city

string

Indica la città di interesse dell'utente, ad esempio 'Menlo Park'

content_ids

string o string[]

Qualsiasi ID nel tuo catalogo di annunci. Ad esempio, per l'evento ViewContent invia l'ID dell'articolo visualizzato oppure per Search invia un array di ID per i risultati migliori: ['1234', '2345', '3456', '4567']

content_type

string o string[]

ad esempio

  • 'home_listing'
  • ['home_listing', 'product']
  • ['home_listing', 'hotel']

country

string

Paese di interesse, come 'United States'

currency

string

Specificato usando il formato della valuta ISO 4217: 'USD'

lease_start_date

string

Ci consente di consigliare proprietà sulla base della disponibilità di date (usando available_dates_price_config nel catalogo) e migliorare l'esperienza dell'utente (usando modelli di tag). Specificato usando il formato della data ISO 8601: 'YYYY-MM-DD' (ad es., 2018-01-01).

lease_end_date

string

Specificato usando il formato della data ISO 8601: 'YYYY-MM-DD' (ad es., '2018-02-01').

listing_type

string

Il valore deve essere for_rent_by_agent, for_rent_by_owner, for_sale_by_agent, for_sale_by_owner, foreclosed, new_construction o new_listing.

neighborhood

string

Quartiere di interesse: 'Menlo Oaks'

preferred_baths_range

[int(min), int(max)]

Numero di bagni scelto come intervallo: [1, 2]

preferred_beds_range

[int(min), int(max)]

Numero di camere da letto scelto come intervallo: [1, 2]

preferred_price_range

[float(min.), float(max.)]

Intervallo di prezzo: [1000.99, 2000.99]

property_type

string

Deve essere apartment, condo, house, land, manufactured, other o townhouse.

region

string

Stato, regione o area di interesse: 'California'

Passaggio 2: associazione dei segnali a un catalogo di annunci

Associa le tue origini dell'evento a ciascuno dei tuoi cataloghi di annunci. Consulta la Pagina del catalogo di Business Manager. Per selezionare il pixel e l'app tramite l'API che invia gli eventi, effettua una chiamata HTTP POST:

curl \
  -F '0=

Specifica questi parametri:

Nome del campoTipo di datiDescrizione

external_event_sources (obbligatorio)

int[]

Lista di pixel e ID dell'app da associare al catalogo.

Passaggio 3: creazione e condivisione di gruppi con origine degli eventi per il settore immobiliare

Per creare un pubblico, l'amministratore del tuo Business Manager deve creare un gruppo con origine degli eventi. In questo modo vengono raggruppate tutte le origini che inviano segnali di interesse nei confronti degli annunci. Invio di una richiesta HTTP POST:

curl \
  -F 'name=My Real Estate Company Events' \
  -F 'event_sources=['

Quindi condividi questo gruppo con origine degli eventi a tutti gli account pubblicitari che invieranno le inserzioni al pubblico generato da queste origini. Invio di una chiamata HTTP POST:

curl \
  -F 'accounts=['

Passaggio 4: creazione di un pubblico

A questo punto, hai configurato i segnali dai pixel o dagli eventi nell'app e li hai associati a un gruppo con origine degli eventi e al tuo catalogo immobiliare. Per definire le persone interessate ai tuoi annunci, crea un pubblico dinamico. Includi o escludi le persone dal pubblico in base ai segnali delle intenzioni. Puoi anche applicare altri filtri basati su regole per personalizzare il tuo pubblico così come per il pubblico personalizzato del sito web. Vedi Pubblico personalizzato.

Per configurare un nuovo pubblico, effettua una chiamata HTTP POST a /act_<AD_ACCOUNT_ID>/customaudiences.

Parametri obbligatori

Nome del campoTipo di datiDescrizione

name

string

Nome del pubblico.

subtype

enum {CLAIM}

Tipo di pubblico personalizzato. Deve essere impostato su CLAIM.

claim_objective

enum {HOME_LISTING}

Obiettivo del pubblico. Deve essere impostato su HOME_LISTING.

event_source_group

id

Gruppo con origine degli eventi per creare un pubblico.

inclusions

object[]

Array di oggetti JSON. Elenca tutti i segnali delle intenzioni che rendono una persona adatta a questo pubblico.

inclusioni: event (obbligatorio)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Nome dell'evento di un segnale. Usato per l'inclusione nel pubblico: {'event': 'Search', …}.

inclusioni: retention (obbligatorio)

object

Quantitativo massimo o minimo di tempo dalla ricezione dell'evento. Determina se l'evento viene considerato per l'inclusione. Esempio: {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. Il mantenimento deve essere di almeno 4 ore.

inclusioni: count

OperatoriJSON

Numero di volte in cui l'evento viene attivato. Puoi usare sia operatori di confronto numerico che di uguaglianza, come {…'count': {'lte': 3}, …}.

Parametri facoltativi

Nome del campoTipo di datiDescrizione

content_type

enum {HOME_LISTING}

Tipo di segnali usati per creare questo pubblico.

description

string

Descrizione del pubblico.

exclusions

object[]

Array di oggetti JSON che elenca ciascun segnale delle intenzioni che esclude qualcuno da questo pubblico.

esclusioni: event (obbligatorio)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Nome dell'evento di un segnale usato per l'esclusione: {'event': 'Search', …}.

esclusioni: retention (obbligatorio)

object

Quantitativo massimo o minimo di tempo dalla ricezione dell'evento. Determina se l'evento deve essere considerato per l'esclusione, ad esempio {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. Il mantenimento deve essere di almeno 4 ore.

rule

object

Regola del pubblico dal pubblico personalizzato del sito web. Filtra il flusso di eventi utilizzando queste regole prima di elaborare inclusions e exclusions.

Mostra una lista di campi specifici disponibili. Puoi usare questi campi con qualsiasi Operatore JSON per le regole del pubblico standard.

regola: home_listing_set_id (obbligatorio)

object

ID del gruppo di annunci: {'eq': '1234'}}

Ad esempio, per creare un pubblico che definisce come destinatari le persone che hanno visualizzato o acquistato negli ultimi 14 giorni:

curl \
  -F 'name=Viewed or Purchased Last 14 days' \
  -F 'subtype=CLAIM' \
  -F 'claim_objective=HOME_LISTING' \
  -F 'content_type=HOME_LISTING' \
  -F 'event_source_group=