Créer une audience pour l’immobilier

À compter de la version 15.0 de l’API Marketing, vous ne pourrez plus créer d'audiences publicitaires spéciales. Pour plus d’informations, consultez la section Audiences publicitaires spéciales.

Créer une audience pour l’immobilier :

Étape 1 : configurer des signaux utilisateur·trice pour les évènements immobiliers

Voici les noms d’évènement que vous pouvez envoyer depuis votre site web ou votre app, qui permettent de mesurer les performances de vos campagnes et de capturer les intentions de vos audiences. Voir Configuration du pixel Facebook.

Les publicités pour l’immobilier requièrent ces évènements standards du pixel de votre site web et de votre application mobile :

Évènement de pixelApp EventNiveau d’exigenceDescription

Search

fb_mobile_search

Quelqu’un a parcouru les petites annonces immobilières

ViewContent

fb_mobile_content_view

Quelqu’un a consulté une annonce en particulier

InitiateCheckout

fb_mobile_initiated_ checkout

Quelqu’un a enregistré ou aimé une annonce, ou montré un intérêt particulier pour celle-ci

Purchase

fb_mobile_purchase

Quelqu’un a contacté un agent à propos d’une annonce

  • Obligatoire : les publicités ne fonctionneront pas sans ces paramètres.
  • Recommandé : paramètres non indispensables, mais qui offrent de meilleures recommandations et davantage d’options de ciblage pour vos publicités. Fournir le plus d’évènements possible.
  • Facultatif : ces paramètres peuvent être ignorés.

Par exemple, pour signaler un évènement Search pour une annonce à l’aide du pixel Facebook ou d’app events, placez ce code sur votre page de résultats de recherche :

<!-- 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
  }
];

Une fois que vous avez déterminé les évènements qui doivent se déclencher, vous devez fournir tous les paramètres de chaque évènement.

Paramètres d’évènement

Le tableau ci-dessous répertorie les paramètres obligatoires et recommandés.

Paramètre de pixelParamètre mobileNiveau d’exigence

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

Détails des paramètres

Nom du paramètreType de donnéesDescription

availability

string

La valeur doit être available_soon, for_rent, for_sale, off_market, recently_sold ou sale_pending.

city

string

Indiquer la ville de l’intérêt de l’utilisateur·trice, par exemple 'Menlo Park'

content_ids

string ou string[]

Tout ID dans votre catalogue de petites annonces. Par exemple, pour l’évènement ViewContent, envoyer l’ID de l’article consulté ou, pour l’évènement Search, envoyer un ensemble contenant les ID des premiers résultats : ['1234', '2345', '3456', '4567']

content_type

string ou string[]

Par exemple :

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

country

string

Pays cible de l’intérêt, par exemple 'United States'

currency

string

Spécifié dans le format de devise ISO 4217 : 'USD'

lease_start_date

string

Nous permet de recommander des propriétés en fonction de leur date de disponibilité (à l’aide du paramètre available_dates_price_config indiqué dans le catalogue) et améliorer l’expérience de destination de l’utilisateur·trice (avec des tags de modèle). Spécifié au format de date ISO 8601 : 'YYYY-MM-DD' (par exemple, 2018-01-01).

lease_end_date

string

Spécifié au format de date ISO 8601 : 'YYYY-MM-DD' (par exemple, '2018-02-01').

listing_type

string

La valeur doit être for_rent_by_agent, for_rent_by_owner, for_sale_by_agent, for_sale_by_owner, foreclosed, new_construction ou new_listing.

neighborhood

string

Quartier recherché : 'Menlo Oaks'

preferred_baths_range

[int(min), int(max)]

Nombre de salles de bain choisi sous forme de plage : [1, 2]

preferred_beds_range

[int(min), int(max)]

Nombre de chambres choisi sous forme de plage : [1, 2]

preferred_price_range

[float(min), float(max)]

Fourchette de prix : [1000.99, 2000.99]

property_type

string

La valeur doit être apartment, condo, house, land, manufactured, other ou townhouse.

region

string

État, district ou région recherchés : 'California'

Étape 2 : Associer des signaux au catalogue d’annonces

Associez vos sources d’évènement à chacun de vos catalogues de petites annonces. Voir la page Catalogue de Business Manager. Pour sélectionner le pixel et l’application via l’API qui envoie les évènements, effectuez une requête HTTP POST :

curl \
  -F '0=

Spécifiez ces paramètres :

Nom du champType de donnéesDescription

external_event_sources (obligatoire)

int[]

Liste des pixels et ID d’app à associer au catalogue.

Étape 3 : Créer un groupe de sources d’évènements immobiliers

Pour créer une audience, un admin de votre entreprise doit créer un groupe de sources d’évènements. Ce groupe contient toutes les sources qui envoient des signaux d’intérêts dans des petites annonces. Envoyez une requête HTTP POST :

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

Puis partagez le groupe de sources d’évènements entre tous les comptes publicitaires qui diffuseront des publicités auprès des audiences générées par ces sources d’évènements. Envoyez une requête HTTP POST :

curl \
  -F 'accounts=['

Étape 4 : Créer des audiences

À ce stade, les signaux provenant de pixels ou d’app events sont configurés et associés à un groupe de sources d’évènements et à votre catalogue d’annonces immobilières. Pour cibler les personnes intéressées par vos petites annonces, créer une audience dynamique. Vous pouvez inclure de nouveaux prospects à votre audience ou en exclure, en fonction des signaux d’intention reçus. Vous pouvez également appliquer d’autres filtres basés sur des règles pour personnaliser votre audience, comme pour les audiences personnalisées de site web. Voir Audiences personnalisées.

Pour configurer une nouvelle audience, envoyez une requête HTTP POST à /act_<AD_ACCOUNT_ID>/customaudiences.

Paramètres obligatoires

Nom du champType de donnéesDescription

name

string

Nom de l’audience.

subtype

enum {CLAIM}

Type d’audience personnalisée. Doit être défini sur CLAIM.

claim_objective

enum {HOME_LISTING}

Objectif de l’audience. Doit être défini sur HOME_LISTING.

event_source_group

id

Groupe de sources d’évènements utilisé pour créer l’audience.

inclusions

object[]

Ensemble d’objets JSON. Répertorie chaque signal d’intention qui rend un utilisateur ou une utilisatrice éligible à cette audience.

inclusions : event (obligatoire)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Nom de l’évènement d’un signal. Utilisé pour l’inclusion dans l’audience : {'event': 'Search', …}.

inclusions : retention (obligatoire)

object

Durées minimum et maximum à partir de la réception de l’évènement. Détermine si l’évènement doit donner lieu à inclusion. Exemple : {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. La rétention doit être d’au moins 4 heures.

inclusions : count

OpérateursJSON

Nombre de déclenchements de l’évènement. Vous pouvez utiliser des opérateurs de comparaison d’égalité ou numériques, tels que {…'count': {'lte': 3}, …}.

Paramètres facultatifs

Nom du champType de donnéesDescription

content_type

enum {HOME_LISTING}

Types de signaux utilisés pour créer l’audience.

description

string

Description de l’audience.

exclusions

object[]

Ensemble d’objets JSON qui répertorient chaque signal d’intention qui exclut quelqu’un de cette audience.

exclusions : event (obligatoire)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Nom de l’évènement d’un signal utilisé pour l’exclusion : {'event': 'Search', …}.

exclusions : retention (obligatoire)

object

Durées minimum et maximum à partir de la réception de l’évènement. Détermine si l’évènement doit donner lieu à exclusion, par exemple, {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. La rétention doit être d’au moins 4 heures.

rule

object

Règle d’audience des audiences personnalisées du site web. Filtre le flux d’évènements en fonction de ces règles avant tout traitement d’inclusions ou d’exclusions.

Voir la liste des champs spécifiques disponibles. Vous pouvez les utiliser avec tous les opérateurs de règle d’audienceJSON standards.

règle : home_listing_set_id (obligatoire)

object

ID petites annonces : {'eq': '1234'}}

Par exemple, pour créer une audience qui cible les personnes qui ont consulté ou réalisé un achat au cours des 14 derniers jours :

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=