Configurer l’API Conversions en tant que plateforme

Si vous proposez la configuration du pixel Meta dans le cadre de vos services de gestion des balises, vous pouvez envisager d’ajouter des fonctionnalités de l’API Conversions. L’intégration à l’aide de l’API Conversions permet à votre clientèle d’envoyer des évènements Web directement à Meta, sans utiliser des évènements de pixel de navigateur.

Différences entre les évènements de serveur et les évènements de navigateur

Avant toute chose, il est important de comprendre le lien entre les évènements de serveur et le pixel Meta. Les évènements de serveur sont envoyés via l’API Conversions, et utilisés pour les mesures, les rapports et l’optimisation de la même manière que les évènements de pixel d’un navigateur.

Envoyer un évènement de pixel de navigateur revient à distribuer un courrier par avion, alors qu’envoyer un évènement de serveur équivaut à envoyer un courrier par cargo. Ces deux mécanismes permettent d’acheminer le colis (les données sur un évènement) à une adresse de destination (un ID de pixel). Nous conseillons vivement d’intégrer l’API Conversions sur votre plateforme en tant qu’extension de votre offre de pixel Meta actuelle (plutôt qu’en tant que plugin ou service distinct) pour les raisons suivantes :

• Les évènements de serveur utilisent l’ID de pixel comme destination.
• Une fois envoyés à Facebook, les évènements de serveur sont traités de la même manière que les évènements de pixel de navigateur.
• La déduplication sera plus facile à mettre en œuvre.
• Cette procédure est plus simple pour la clientèle. Par exemple, les évènements de serveur peuvent être envoyés parallèlement aux évènements de navigateur, par défaut.

Une fois que la plateforme est intégrée à l’API Conversions, nous recommandons d’envoyer les mêmes évènements Web via le navigateur et le serveur. Cette redondance aide à garantir la fiabilité du signal. Les évènements qui pouvaient être perdus côté navigateur (pour diverses raisons liées au réseau) sont maintenant capturés via l’API Conversions.

Pour envoyer des évènements via le navigateur et le serveur, vous devez leur attribuer le même event_id. Cela permet à Facebook de dédupliquer correctement les évènements.

Conditions requises

1. Une plateforme Web capable de partager des évènements sur Facebook : éditeur de sites Web, gestionnaire de balises, plateforme AdTech, etc.
2. Avertissement approprié et consentement de vos utilisateur·ices pour le partage des données d’évènement avec Facebook, conformément aux Conditions d’utilisation des outils Facebook Business
3. Un représentant Facebook
4. Conditions standard relatives à l’intégration de l’API Conversions :
   • Business Manager
   • Une application Meta
   • Pixel Meta
   • Un token d’accès

Premiers pas

Si vous utilisez pour la première fois l’API Conversions, suivez ces étapes pour créer un compte Business, une application Meta, un pixel Meta et un·e utilisateur·ice système. Vous pourrez ensuite utiliser le token d’accès de l’utilisateur·ice système pour envoyer des évènements de serveur via l’API Conversions.

Étape 1 : Créer un compte Business

Étape 2 : Créer une application Meta dans le nouveau compte Business

Étape 3 : Créer un pixel Meta dans le nouveau compte Business :

• Accédez au Gestionnaire d’évènements.
• Sélectionnez Ajouter une source de données.

Étape 4 : Générer un token d’accès d’utilisateur·ice système

Étape 5 : Envoyer un évènement de serveur au pixel Meta

Envoyer des évènements au nom de votre clientèle

Une fois que vous avez envoyé un évènement de serveur à votre pixel Meta, vous avez le choix entre plusieurs options pour envoyer des évènements au nom de votre clientèle.

Pour les pixels Meta détenus ou gérés par le Business Manager du partenaire

1. Dans Business Manager, accédez à la section Utilisateurs et sélectionnez l’onglet Utilisateur système. Cliquez sur l’utilisateur·ice système que vous utilisez pour l’API Conversions.
2. Accédez à la boîte de dialogue Affecter des ressources et choisissez Pixels. Sélectionnez les pixels pour lesquels vous souhaitez envoyer des évènements au nom de votre client·e.
3. Pour chaque pixel, sélectionnez l’autorisation Manage Pixel (Gérer le pixel), puis cliquez sur Enregistrer les modifications.
4. Revenez à la page d’informations de l’utilisateur·ice système. Vérifiez que les pixels sélectionnés apparaissent.

Pour les pixels Meta non gérés par le partenaire

Vous devez d’abord demander l’autorisation d’envoyer des évènements au nom de votre clientèle. Vous disposez des options d’authentification suivantes :

Extension Facebook Business (recommandé)

Avec cette option, l’extension Facebook Business (FBE) renvoie toutes les informations nécessaires pour envoyer des évènements au nom de votre client·e selon le processus suivant. FBE fournit un point de terminaison pour récupérer les tokens d’accès d’utilisateur·ice système créés dans le Business Manager de votre client·e. Ce processus comprend des autorisations pour envoyer automatiquement et de manière sécurisée des évènements de serveur.

Le point de terminaison nécessite un token d’accès utilisateur·ice comme paramètre d’entrée. Si vous utilisez pour la première fois l’extension Facebook Business, appelez le point de terminaison pour récupérer le token d’accès de l’utilisateur·ice système lorsque vous avez fini de configurer FBE. Les utilisateur·ices existant·es doivent demander une nouvelle authentification avant d’appeler le nouveau point de terminaison de l’API.

Génération d’un token d’accès d’utilisateur·ice système par le client

Avec cette option, vous devez demander à votre client·e de créer manuellement un token d’accès d’utilisateur·ice système via l’API Conversions depuis les paramètres du pixel. Vous pouvez ensuite envoyer les évènements au pixel de l’annonceur avec ce token.

Une personne utilisatrice système ou utilisatrice système admin doit installer l’application qui sera utilisée pour générer le token d’accès. Avec cette configuration, votre application est autorisée à appeler des API au nom de cet·te utilisateur·ice système (admin ou standard).

Suivez les instructions de notre documentation Premiers pas et demandez un token d’utilisateur·ice système à votre annonceur. Pensez à utiliser votre pixel Meta et votre token d’accès pour les tests.

Partage d’un pixel Meta avec le Business Manager du partenaire par le client

Avec cette option, le ou la client·e partage son pixel Meta avec le partenaire depuis les paramètres Business Manager ou via l’API. Vous pouvez ensuite affecter l’utilisateur·ice système du partenaire au pixel de votre client·e et générer un token d’accès pour envoyer des évènements de serveur.

Attribuer les évènements à votre plateforme en utilisant le champ partner_agent

Pour attribuer les évènements de l’API Conversions à votre plateforme, utilisez le champ partner_agent. Cela vous permet de définir votre propre identifiant de plateforme lorsque vous envoyez des évènements au nom d’un·e client·e. Choisissez un identifiant pour votre plateforme avec votre représentant Facebook. Envoyez-le ensuite avec chaque évènement de serveur.

Exemple de charge utile d’évènement

Si votre identifiant de plateforme est datapartner, voici à quoi ressemblera la charge utile d’un évènement d’achat envoyé au nom de votre client·e :

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

Questions/réponses