Les entreprises qui souhaitent publier des annonces immobilières pour le commerce doivent être vérifiées.
Étape 1 : Créer un catalogue d’annonces immobilières
Étape 2 : Configurer les annonces et les prix
Étape 3 : Options de mise à jour
Étape 4 : Filtrer le catalogue sur un ensemble d’annonces
Étape 5 : Envoyer des conversions hors ligne (facultatif)
Étape 6 : Créer votre Audience pour l’immobilier. Pour les annonces immobilières publiées par des utilisateur·ices, les prospects sont transmis via le chat Messenger. Dans le cadre des intégrations de partenaires, en revanche, ils sont transmis aux partenaires via un formulaire prospect. Découvrez comment Récupérer des prospects pour le commerce.
Étape 7 : Créer et diffuser des publicités pour vos annonces immobilières
Étape 8 : Obtenir des informations sur la diffusion pour savoir comment les internautes interagissent avec vos publicités sur Facebook Voir Statistiques publicitaires
Étape 9 : Diagnostiquer et résoudre les problèmes avec les outils de débogage. Voir Outils de débogage des publicités de catalogue Advantage+
Votre catalogue doit contenir la liste des propriétés que vous souhaitez promouvoir. Consultez la documentation de référence sur les catalogues.
Pour créer un catalogue d’annonces immobilières destiné à des publicités de catalogue Advantage+, définissez vertical
sur home_listings
:
curl \
-F 'name=Home Listing Catalog Name' \
-F 'vertical=home_listings' \
-F 'access_token=<ACCESS TOKEN>' \
https://graph.facebook.com/<API_VERSION>
Pour utiliser l’API associée aux catalogues, vous devez disposer du niveau d’accès API Marketing et accepter les conditions d’utilisation en créant votre premier catalogue via Business Manager.
Consultez la documentation de la plateforme Marketplace qui explique comment créer un catalogue pour le commerce.
Vos annonces contiennent des informations sur les propriétés, telles que l’ID de l’annonce, le nom, la disponibilité, la description, l’adresse, le nombre de chambres, le nombre de salles de bains, etc. Vous pouvez importer ou récupérer un ensemble d’annonces depuis votre entreprise. Une annonce correspond à une propriété unique présentée sur votre site Web ou dans votre application.
Vous pouvez posséder un seul flux pour toutes les propriétés de votre catalogue, ou plusieurs flux représentant chacun les propriétés d’un pays, d’une agence immobilière ou d’un courtier.
Pour les publicités de catalogue Advantage+, vous devez fournir le flux d’annonces dans l’un des formats suivants :
Format de fichier | Description | Exemple de fichier |
---|---|---|
XML | Format communément généré par les systèmes automatisés de création de flux. Un nœud XML | |
CSV, TSV | La première ligne doit énumérer les noms des champs choisis dans l’ordre où les valeurs seront données. Les lignes suivantes fournissent ensuite les valeurs correspondantes pour chaque annonce immobilière. Les champs imbriqués ou à valeurs multiples, tels que image peuvent être représentés à l’aide de valeurs encodées au format JSON ou par un ensemble de colonnes en texte brut « simplifié » désignées au moyen de la syntaxe d’un chemin d’accès JSON (par exemple, | Télécharger (CSV) |
Pour le commerce, vous devez fournir un flux d’annonces au format XML :
Format de fichier | Description |
---|---|
XML | Format communément généré par les systèmes automatisés de création de flux. Un nœud XML |
CSV, TSV, JSON | Ces formats ne sont pas pris en charge actuellement. |
Notre outil d’analyse des flux détecte automatiquement les encodages de texte UTF8
, UTF16
ou UTF32
, et applique l’encodage LATIN1
s’il rencontre une séquence d’octets inattendue.
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>example.com Feed</title> <link rel="self" href="http://www.example.com"/> <listing> <home_listing_id>12345678</home_listing_id> <name>1 Hacker Way, Menlo Park, CA 94025</name> <availability>for_rent</availability> <description>An amazing listing</description> <address format="simple"> <component name="addr1">1 Hacker Way</component> <component name="city">Menlo Park</component> <component name="region">California</component> <component name="country">United States</component> <component name="postal_code">94025</component> </address> <latitude>1.11414</latitude> <longitude>-1.835003</longitude> <neighborhood>Menlo Oaks</neighborhood> <image> <url>http://example.com/12345678-1.jpg</url> </image> <image> <url>http://example.com/12345678-2.jpg</url> </image> <image> <url>http://example.com/12345678-3.jpg</url> </image> <listing_type>for_rent_by_agent</listing_type> <num_baths>6</num_baths> <num_beds>5</num_beds> <num_units>1</num_units> <price>110000 USD</price> <property_type>house</property_type> <url>http://www.example.com/link_to_listing</url> <year_built>2007</year_built> </listing> </listings>
Les champs pris en charge mentionnés ci-dessous se rapportent aux éléments que vous ajoutez dans votre catalogue produits.
S’il s’agit de catalogues localisés, consultez les champs pris en charge pour les annonces immobilières.
Notre outil d’analyse des flux détecte automatiquement les encodages de texte UTF8
, UTF16
ou UTF32
, et applique l’encodage LATIN1
s’il rencontre une séquence d’octets inattendue. Vous pouvez saisir les valeurs des champs dans la langue de votre choix, mais les noms des champs doivent être saisis en anglais, comme ci-dessous.
Nom du champ et type | Description |
---|---|
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. ID d’annonce unique d’une propriété (appartement/copropriété), le plus précis possible Exemple : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. ID unique du bâtiment ou de l’appartement. Doit être unique au sein du groupe. |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Titre de l’annonce immobilière. Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Disponibilité actuelle pour l’annonce immobilière. Les valeurs acceptées sont : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Adresse postale de la propriété qui doit indiquer son emplacement. Consultez Paramètres de l’objet adresse. Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Ville dans laquelle se trouve la propriété. Consultez Paramètres de l’objet adresse. Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. État, département, région ou province où se trouve la propriété. Consultez Paramètres de l’objet adresse. Exemple : |
type : objet | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Pays dans lequel se trouve la propriété. Consultez Paramètres de l’objet adresse. Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Pays dans lequel se trouve la propriété. Consultez Paramètres de l’objet adresse. Exemple : |
type : virgule flottante | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Latitude de la propriété. Exemple : |
type : virgule flottante | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Longitude de la propriété. Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+. Facultatif, mais vivement recommandé pour le commerce. Nombre de quartiers max. autorisés : 20 Quartier indiqué dans l’annonce pour la propriété. Plusieurs quartiers possibles. Si vous devez indiquer plusieurs quartiers, ajoutez une colonne pour chaque type et utilisez la syntaxe de chemin d’accès JSON dans le nom de chaque colonne pour indiquer le nombre de quartiers. Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Prix de vente ou de location de la propriété. Formatez le prix en indiquant la somme suivie du [code de devise ISO à trois caractères] (https://fr.wikipedia.org/wiki/ISO_4217), avec un espace entre la somme et la devise. Exemple : |
type : objet | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Nombre maximal d’images : 20 Taille maximale autorisée : 4 Mo URL de l’image utilisée dans votre publicité.
Exemple : |
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. Lien vers la page associée à l’annonce immobilière. Doit être une URL valide. Voir Paramètres de l’objet image. Exemple : |
type : chaîne | Facultatif pour les publicités de catalogue Advantage+. Obligatoire pour le commerce. Nombre maximal de caractères : 5 000 Description de la propriété. Exemple : |
type : virgule flottante | Facultatif pour les publicités de catalogue Advantage+. Obligatoire pour le commerce. Nombre total de chambres. Peut contenir la valeur Exemple : |
type : virgule flottante | Facultatif pour les publicités de catalogue Advantage+. Nombre total de salles de bain. Pour le commerce, doit être défini sur |
type : virgule flottante | Non applicable aux publicités de catalogue Advantage+. Obligatoire pour le commerce. Nombre total de pièces de la propriété. |
type : chaîne | Facultatif pour les publicités de catalogue Advantage+. Type de propriété. Les valeurs acceptées pour les publicités de catalogue Advantage+ sont les suivantes : |
type : chaîne | Facultatif pour les publicités de catalogue Advantage+. Type d’annonce de la propriété. Les valeurs acceptées pour les publicités de catalogue Advantage+ sont les suivantes : |
type : nombre entier | Non applicable aux publicités de catalogue Advantage+. Obligatoire pour le commerce. Surface au sol ou superficie de la propriété associée à l’annonce. |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Obligatoire pour le commerce. Unité de mesure de la superficie (pieds carrés ou mètres carrés). Valeurs acceptées : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Type de climatisation : Valeurs acceptées : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Type d’ameublement de la propriété. Valeurs acceptées : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Type de chauffage installé dans la propriété. Valeurs acceptées : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Type de buanderie disponible. Valeurs acceptées : |
type : nombre entier | Facultatif pour les publicités de catalogue Advantage+ et le commerce. Nombre total d’unités (appartements, copropriétés) disponibles à la location. Exemple : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Type de stationnement disponible sur la propriété. Valeurs acceptées : |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Indique si la société partenaire a vérifié l’annonce. Valeurs acceptées : |
type : chaîne | Année de construction de la propriété, au format AAAA avec quatre chiffres. Exemple : 1994. |
type : chaîne | Non applicable aux publicités de catalogue Advantage+. Facultatif pour le commerce. Indique quels sont les animaux autorisés sur la propriété : |
type : objet | Liste des dates auxquelles la propriété est disponible, avec les prix associés. Si vous indiquez des valeurs, Facebook peut recommander des annonces en fonction des dates de disponibilité et afficher le prix associé dans votre annonce de façon dynamique. |
type : objet | Lien de l’annonce dans l’application. |
type : chaîne | Détermine si un article est actif ou archivé dans votre catalogue. Seuls les articles actifs peuvent être vus par les internautes dans vos publicités, vos boutiques ou tout autre moyen de communication. Valeurs acceptées : Exemple : Remarque : certaines plateformes partenaires comme Shopify peuvent synchroniser des articles dans votre catalogue avec le statut staging, qui est équivalent au statut Ce champ était auparavant appelé |
Nom du champ et type | Description |
---|---|
type : chaîne | Obligatoire pour les publicités de catalogue Advantage+ et pour le commerce. URL source des images. Suivez les spécifications suivantes pour les images :
|
type : chaîne | Facultatif pour les publicités de catalogue Advantage+ et le commerce. Tag ajouté à l’image et qui montre ce qu’il y a dans l’image. Plusieurs tags peuvent être associés à une image. Exemples :
|
Nom du champ et type | Description |
---|---|
type : chaîne | Obligatoire. Adresse postale de l’hôtel. Exemple : |
type : chaîne | Obligatoire. Ville dans laquelle se trouve l’hôtel. Exemple : |
type : chaîne | Obligatoire. État, département, région ou province où se trouve l’hôtel. Exemple : |
type : chaîne | Obligatoire. Pays dans lequel se trouve l’hôtel. Exemple : |
type : chaîne | Code postal de la propriété. Obligatoire sauf si le pays ne comporte pas de système de codes postaux. Exemples : |
Le paramètre available_dates_price_config
vous permet d’indiquer la disponibilité et le prix de chaque propriété sur une période donnée. Lorsque vous indiquez des périodes dans ce champ, Facebook tient compte de cette disponibilité dans ses recommandations de produits et tente d’afficher les annonces qui sont disponibles aux dates que l’utilisateur ou l’utilisatrice a recherchées sur votre site. Si vous indiquez le prix associé à chaque période, nous pouvons aussi afficher ce prix dans votre contenu publicitaire. Pour activer cette fonctionnalité, vous devez également envoyer lease_start_date
et lease_end_date
à Facebook dans vos évènements de pixel.
Nom du champ et type | Description |
---|---|
type : chaîne | Facultatif si Début de la période de disponibilité au format ISO-8601, date de début incluse. Si vous n’indiquez que la Exemple : au format |
type : chaîne | Facultatif si Fin de la période de disponibilité au format ISO-8601, date de fin incluse. Si vous n’indiquez que la Exemple : au format |
type : chaîne | Nombre entier représentant le prix associé à l’annonce pour la période concernée. Exemple : |
type : chaîne | Obligatoire si vous fournissez Code de devise ISO-4217. Exemple : |
type : chaîne | Durée du séjour pour le prix spécifié. Les valeurs acceptées sont les suivantes : |
Voici un exemple de la disponibilité d’une annonce et de sa mise en forme en JSON :
"available_dates_price_config": [ { // available until 11/01 at $150/night "end_date": "2018-11-01", "rate": "15000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 - 12/01 at $200/night "start_date": "2018-11-01", "end_date": "2018-12-01", "rate": "20000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 onward at $500/week "start_date": "2018-11-01", "rate": "50000", "currency": "USD", "interval": "weekly", }, ]
Suivez la spécification des App Links ci-dessous pour fournir des liens profonds dans le flux. Les informations des liens profonds prévalent sur les informations collectées par Facebook avec son robot d’indexation via les métadonnées des App Links.
Si vous possédez déjà les informations des liens profonds via les App Links, vous n’avez pas besoin de spécifier ceci. Facebook utilise les informations provenant d’App Links pour afficher le lien profond correct. Pour afficher les liens profonds dans vos publicités, consultez la section Publicités de catalogue Advantage+, Modèle de publicité.
Pour les publicités de catalogue Advantage+, vous pouvez actualiser les informations relatives aux annonces immobilières de votre catalogue selon plusieurs méthodes, via l’importation directe. Voir Importation directe d’un flux, Documentation de référence
Exemple d’importation manuelle ponctuelle :
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
Pour le commerce, vous pouvez définir une importation récurrente (planifiée) du flux que vous mettez à jour régulièrement pour actualiser les informations d’une liste d’annonces dans le catalogue. Dans Marketplace, nous vous recommandons vivement d’utiliser l’option Définir un calendrier.
Le commerce prend en charge une expérience multilingue. Lorsque vous ajoutez un flux de langue secondaire à un catalogue, vous pouvez créer un autre flux dans la seconde langue à partir de ce catalogue. Les informations des flux secondaires remplacent votre langue par défaut lorsque l’audience correspondante visualise vos annonces.
Cette fonctionnalité ne s’applique qu’aux partenaires du pays concerné. Veuillez contacter votre représentant Facebook pour savoir si vous y avez accès.
Il s’agit d’un groupe d’éléments d’un catalogue dont vous faites la promotion dans vos publicités de catalogue Advantage+. Chaque catalogue peut comprendre plusieurs ensembles d’annonces.
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
Le filter
ci-dessus est composé des données et opérateurs suivants :
Opérateurs | Type de filtre |
---|---|
| Contient une sous-chaîne (non sensible à la casse) |
| Ne contient pas une sous-chaîne (non sensible à la casse) |
| Contient une sous-chaîne (sensible à la casse) |
| Ne contient pas une sous-chaîne (sensible à la casse) |
| Égal à (non sensible à la casse) |
| Différent de (non sensible à la casse) |
| Inférieur(e) à (champs numériques uniquement) |
| Inférieur(e) ou égal(e) à (champs numériques uniquement) |
| Supérieur(e) à (champs numériques uniquement) |
| Supérieur(e) ou égal(e) à (champs numériques uniquement) |
Données | Données à filtrer |
---|---|
| Disponibilité de l’annonce. Exemple : |
| Type d’annonce. Exemple : |
| Type de propriété. Exemple : |
| Prix indiqué dans l’annonce |
| Nom |
| Ville |
| Pays |
| Région ou État |
| Code postal |
| Nombre de chambres |
| Nombre de salles de bains |
Vous pouvez envoyer des évènements de conversion hors ligne et savoir combien de clients ou clientes ont vu les publicités et annonces de commerce Facebook, ou cliqué sur celles-ci, avant de déclencher une conversion. Pour ce faire, utilisez l’API Offline Conversions et ajoutez les champs suivants lors de l’étape 4. Importer des évènements hors ligne.
Les clés de correspondance comparent une conversion à un utilisateur ou une utilisatrice.
Clé | Description |
---|---|
| Adresse(s) e-mail Hash |
| Numéro(s) de téléphone Hash |
| Prénom Hash |
| Nom Hash |
| ID publicitaire Apple ou Android Hash |
| Code postal ou codes postaux Hash |
| Ville Hash |
| État Hash |
| Pays Hash |
| Date de naissance (format JJ) Hash |
| Date de naissance (format AAAA) Hash |
| Genre Hash |
| Âge Hash |
| ID de prospect des prospects Marketplace |
Les données personnalisées comparent une conversion à un vendeur ou une vendeuse.
Champ | Description |
---|---|
|
|
| Défini sur |
Les détails de l’évènement décrivent l’évènement de conversion hors ligne qui s’est produit. La fréquence d’importation est quotidienne, dans les 48 heures qui suivent l’évènement.
Champ | Description |
---|---|
| Obligatoire Énumération des types d’évènement :
|
| Obligatoire Date et heure de l’évènement |
| Obligatoire Valeur du loyer. Définie sur |
| Obligatoire Code de devise |