Intégration de Pixel et de l’API Conversions de l’extension Meta Business

Les processus du pixel et de l’API Conversions pour l’extension Meta Business (MBE) permettent aux utilisateur·ices de créer ou de sélectionner leur Business Manager, leur Page et leur pixel Meta. Ce processus est recommandé pour les partenaires disposant de capacités d’hébergement de sites web. À l’aide du pixel renvoyé à l’issue de ce processus, les partenaires peuvent envoyer des événements à Facebook au nom de leurs clients via un navigateur ou l’API Conversions. Ce processus ne permet pas de posséder un catalogue.

Avant de commencer

Votre application doit appartenir à un compte Business Manager qui est une entreprise vérifiée. Obtenez plus d’informations sur la procédure de vérification de votre entreprise.
Vous devez posséder une application Facebook dotée du niveau d’accès, de la fonctionnalité et des autorisations suivants :
- Niveau d’accès : accès avancé.
- Fonctionnalité : accès standard au Gestionnaire de publicités.
- Autorisations publiques : ads_management, pages_read_engagement et ads_read.
- Autorisations privées : manage_business_extension : il s’agit d’une autorisation privée qui requiert l’ajout de votre application à la liste d'éléments autorisés par votre représentant Facebook.
- Token d’accès de l’utilisateur système : l’envoi d'événements à l’API Conversions nécessite un token d’accès. Pour générer un token d’accès au nom du client, utilisez le token d’accès renvoyé par FBE et convertissez-le en un token d’accès d’utilisateur système en effectuant un appel d’API supplémentaire.

Configurations requises

Extras

Champ Type Description

Champ	Type	Description
`setup`	configuration	Obligatoire Paramètres de configuration Facebook du vendeur, tels que son identifiant unique (`external_business_id`) ou la devise de son catalogue (`currency`). Voir Détails sur l’objet de configuration.
`business_config`	business_config	Obligatoire Objet de configuration utilisé par Facebook Business Extension pour configurer le flux de travail de Facebook Business Extension. Voir Détails sur l’objet `business_config`.
`repeat`	booléen	Obligatoire Définir cette valeur sur `false`.

setup

configuration

Obligatoire

Paramètres de configuration Facebook du vendeur, tels que son identifiant unique (external_business_id) ou la devise de son catalogue (currency). Voir Détails sur l’objet de configuration.

business_config

business_config

Obligatoire

Objet de configuration utilisé par Facebook Business Extension pour configurer le flux de travail de Facebook Business Extension. Voir Détails sur l’objet business_config.

repeat

booléen

Obligatoire

Définir cette valeur sur false.

Configuration

Utilisez cet objet pour définir les paramètres de présence Facebook de l’utilisateur ou l’utilisatrice final·e.

Champ	Description
`external_business_id` chaîne	Obligatoire ID d’entreprise unique pour représenter l’entreprise de votre client. Nous l’utilisons en tant qu’identifiant unique. Par exemple, si l’entreprise du vendeur s’appelle « Fubar », « fubar-123 » pourrait être son `external_business_id`.
`timezone` chaîne	Facultatif Fuseau horaire dans lequel l’entreprise se trouve. Voir les valeurs de fuseau horaire possibles.
`currency` chaîne	Facultatif Code de devise ISO à trois lettres de la devise par défaut utilisée par les articles de catalogue de l’entreprise. Voir Codes de devise pris en charge.
`business_vertical` énumération	Obligatoire Secteur associé à l’entreprise. Valeur :`ECOMMERCE`
`merchant_settings_id` chaîne	Facultatif Utilisation lors de la mise à niveau de Facebook Business Extension, v1. Veuillez contacter votre représentant·e Facebook si vous effectuez une migration de la version 1 à la version 2.
`domain` chaîne	Obligatoire pour les canaux COMMERCE et COMMERCE_OFFSITE Domaine utilisé pour l’approbation manuelle d’Instagram. Par exemple : `https://exampleshop.partnersite.com`.
`channel` énumération	Obligatoire Permet au partenaire de configurer le flux de l’API Conversions de MBE. Pour le flux de l’API Conversions, cette valeur devrait être `CONVERSIONS_API`. `CONVERSIONS_API` : flux qui permet à l’utilisateur ou l’utilisatrice final·e de créer ou de sélectionner un compte Business Manager, un compte publicitaire et des objets pixel Meta. La création de ces objets permet à l’utilisateur ou l’utilisatrice final·e d’envoyer des évènements à partir de son site web à Facebook à l’aide de l’API Conversions ou du pixel navigateur.
`business_manager_id` chaîne	Facultatif ID Business Manager existant qu’un·e partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.
`ad_account_id` chaîne	Facultatif ID de compte publicitaire existant qu’un partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.
`page_id` chaîne	Facultatif ID de Page Facebook existante qu’un·e partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.
`ig_profile_id` chaîne	Facultatif ID de profil professionnel Instagram existant qu’un partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.
`pixel_id` chaîne	Facultatif ID de pixel existant qu’un·e partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.
`catalog_id` chaîne	Facultatif ID de catalogue existant qu’un partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.

Configuration professionnelle

Utilisez cet objet pour configurer les paramètres professionnels d’un utilisateur ou d’une utilisatrice final·e. Cela inclut, entre autres, les CTA. Chaque champ comprend un « type » lié aux tableaux respectifs ci-dessous.

Champ	Description
`business` Type : FBEBusinessPropertiesConfigData	Obligatoire Information pour l’entreprise de l’utilisateur ou l’utilisatrice final·e.
`messenger_chat` Type : FBEMessengerChatConfigData	Facultatif Fonctionnalités de discussion Messenger sur la Page Facebook du client final, telles que `enabled` et `domains`.
`catalog_feed_scheduled` Type : FBECatalogFeedConfigData	Facultatif Détermine si Facebook Business Extension doit utiliser une approche de flux, qui récupère les articles de catalogue à partir d’une `feed_url`.
`page_cta` Type : FBEPageCtaConfigData	Facultatif Bouton d’appel à l’action (CTA) sur la page de l’utilisateur ou l’utilisatrice final·e, tel que `cta_button_text`, `cta_button_url`, etc.
`ig_cta` Type : FBEIGCtaConfigData	Facultatif Fonctionnalités pour la fonctionnalité Appel à l’action (CTA) Instagram, telles que `enabled`, `cta_button_text`, `cta_button_url`, etc.
`messenger_menu` Type : FBEMessengerMenuConfigData	Facultatif Caractéristiques de la fonctionnalité du menu fixe Messenger, telles que `cta_button-text` et `cta_button_url`.