API Conversions

Premiers pas

Cette page décrit le processus de mise en œuvre de l’API Conversions, ainsi que les conditions requises. Si vous êtes un partenaire tiers qui propose les fonctionnalités de l’API Conversions aux annonceurs, vous devez respecter différentes conditions avant de commencer.

Si votre entreprise possède un pare-feu pour les requêtes sortantes, consultez IP de robot d’indexation et agents d’utilisateur pour obtenir les adresses IP de Facebook. Gardez à l’esprit que la liste d’adresses change régulièrement.

Les évènements web, d’application et physiques partagés via l’API Conversions requièrent des paramètres spécifiques. La liste des paramètres obligatoires est disponible ici.

Présentation du processus

L’intégration de l’API Conversions se décompose en plusieurs étapes :

  1. Choisir la méthode d’intégration adaptée.
  2. Respecter les conditions requises pour cette méthode d’intégration.
  3. Procéder à la mise en œuvre avec cette méthode d’intégration.
  4. Vérifier la configuration et appliquer les recommandations pour améliorer les performances publicitaires.

Méthodes d’intégration

Il existe plusieurs moyens d’intégrer l’API Conversions, chacun associé à des efforts, des coûts et des fonctionnalités différents. Consultez cet article pour obtenir un aperçu des options de configuration de l’API Conversions.

Cette documentation pour les développeur·ses se concentre principalement sur les intégrations directes.

Conditions requises

ID de pixel

Pour utiliser l’API Conversions, vous devez acquérir un ID de pixel. Si vous avez déjà configuré un pixel pour votre site web, nous vous recommandons d’utiliser le même ID de pixel pour les évènements du serveur et du navigateur.

Business Manager

Vous devez également disposer de Business Manager pour utiliser l’API. Business Manager permet aux annonceurs d’intégrer leurs initiatives marketing Facebook à l’ensemble de leur entreprise, mais aussi à leurs partenaires externes. Si vous n’avez pas encore Business Manager, consultez l’article repris dans les pages d’aide indiquant comment créer un Business Manager.

Token d’accès

Pour utiliser l’API Conversions, vous avez besoin d’un token d’accès. Vous pouvez récupérer votre token d’accès de deux manières :

  • En utilisant le Gestionnaire d’évènements (recommandé)
  • En utilisant votre propre application

En utilisant le Gestionnaire d’évènements (recommandé)

Pour utiliser l’API Conversions, vous devez générer un token d’accès, qui sera transmis en tant que paramètre dans chaque appel d’API. Dans le Gestionnaire d’évènements, procédez comme suit :

Étape 1 : choisissez le pixel à mettre en œuvre.

Étape 2 : sélectionnez l’onglet Paramètres.


Étape 3 : repérez la section API Conversions, cliquez sur le lien Générer un token d’accès sous Configurer manuellement, puis suivez les instructions qui s’affichent :

Remarque : le lien Générer un token d’accès n’est visible que par les utilisateurs et utilisatrices doté·es des droits de développement pour l’entreprise. Il est masqué pour tous les autres.


Une fois que vous avez généré votre token, cliquez sur le bouton Gérer les intégrations dans l’onglet Vue d’ensemble du Gestionnaire d’évènements. Dans l’écran qui s’affiche, cliquez sur le bouton Gérer situé à côté de l’API Conversions. Une application et un utilisateur système associés à l’API Conversions sont alors automatiquement créés. Nul besoin de passer par le Contrôle app ni de demander des autorisations.



En utilisant votre propre application

Si vous possédez déjà votre propre application et votre propre utilisateur système, vous pouvez générer le token dans Business Manager. Pour ce faire :

Étape 1 : accédez aux paramètres de Business Manager.

Étape 2 : attribuez un pixel à votre utilisateur système (à ce stade, vous avez également la possibilité de créer un utilisateur système).

Étape 3 : sélectionnez l’utilisateur système attribué et cliquez sur Générer un token.

Nul besoin de passer par le Contrôle app, ni de demander des autorisations.

Il n’est plus nécessaire d’utiliser la version de l’API Graph la plus récente disponible au moment de la génération des tokens pour pouvoir utiliser les tokens d’accès générés dans l’onglet des paramètres de l’API Conversions du Gestionnaire d’évènements. À partir de la version 12.0, les tokens d’accès nouvellement créés peuvent être utilisés avec toutes les versions disponibles de l’API Graph.

Ressources