Guide de configuration du gateway API Conversions : AWS App Runner

Suivez les étapes ci-après pour configurer le gateway API Conversions.

Conditions requises

Avant de pouvoir déployer le gateway API Conversions, vous devez disposer des éléments suivants :

  • ID du Pixel Meta
  • Accès admin au Gestionnaire d’évènements (un accès partiel ne fonctionnera pas)
  • Tous les domaines du site Web
  • Accès au fournisseur DNS (nécessaire pour configurer votre sous-domaine)
  • Accès admin au fournisseur de cloud (par exemple, AWS)

Recommandation : activer la correspondance avancée sur votre pixel Meta afin d’optimiser les performances de votre intégration du gateway API Conversions. Grâce à la correspondance avancée, vous pouvez envoyer des informations de contact clientèle hachées avec vos évènements de pixel, ce qui vous aide à attribuer davantage de conversions et à toucher plus de personnes. Plus de détails ici.

La version actuelle du gateway API Conversions ne prend en charge qu’Amazon Web Services (AWS) en tant que fournisseur cloud tiers :

  • Si vous n’avez pas de compte AWS, vous pouvez en créer un en suivant ce guide.

Étape 1 : démarrer et commencer le déploiement

Pour commencer le processus de configuration, accédez à l’onglet Paramètres dans le Gestionnaire d’évènements Meta. Sous Configuration avec le gateway API Conversions, cliquez sur Démarrer.


  • Sélectionnez l’option d’hébergement S’héberger soi-même.


  • Prenez connaissance des conditions préalables relatives au gateway API Conversions, puis sélectionnez Suivant.


  • À l’étape Sélection des préférences, choisissez les paramètres que vous souhaitez activer, puis cliquez sur Continuer.

    • L’option Améliorer les évènements permet d’améliorer l’attribution des conversions et de maximiser les performances des évènements que vous partagez avec Meta.
    • L’option Activer la surveillance de l’état du gateway API Conversions permet à Meta de dépanner plus efficacement les problèmes éventuels.


  • À l’étape de sélection d’un fournisseur dans le cloud, sélectionnez l’option de configuration AWS App Runner.


  • Déployez-vous sur AWS via App Runner.
    • Ensuite, sous Sélectionnez votre région d’hébergement, choisissez la région souhaitée. Vous ne pouvez configurer le gateway API Conversions que dans une seule région.
    • Cliquez sur Suivant pour ouvrir Amazon Web Services (AWS) ou sur Copier l’URL pour l’envoyer à l’admin du compte AWS de votre organisation.


Étape 2 : configurer et installer AWS

Si ce n’est pas déjà fait, connectez-vous à AWS.

  • Un flux de création rapide pour la pile du gateway API Conversions s’ouvre.


  • Tous les champs seront préremplis. Veuillez ne pas modifier les champs ProvisioningData et BootstrapInformation.
  • Cliquez sur Créer une pile pour commencer l’installation.
  • Le processus de création prend environ 15 à 20 minutes, après quoi une sortie sera écrite dans l’onglet Sorties pour la nouvelle instance AWS. Vous saurez que c’est terminé lorsque le statut indiquera CREATE_COMPLETE dans l’onglet Infos sur la pile.
  • Une fois l’opération terminée, accédez à l’onglet Sorties.
  • Notez l’URL CapigSetupURL, car vous en aurez besoin pour provisionner l’UI du gateway API Conversions.


Étape 3 : vérifier la collecte des données

Pour accéder à l’UI d’administration du gateway API Conversions, utilisez le lien CapigSetupURL de l’onglet Sorties.

  • Vous devrez aussi créer un compte admin lors de votre première connexion à l’UI d’administration.
  • Sélectionnez Se connecter après avoir créé un compte admin.
  • Vous verrez l’UI d’administration du gateway API Conversions.
  • Lorsque vous consultez ce site pour la première fois, les données du serveur et du navigateur peuvent être définies sur 0. Ces informations peuvent prendre de dix minutes à deux heures pour être renseignées.
  • Pour vérifier si les données sont collectées, vous pouvez accéder à votre site Web et actualiser la Page. Si les évènements ne s’affichent pas après deux heures, contactez Meta pour obtenir un dépannage.
  • Si les évènements ne s’affichent pas après deux heures, veuillez contacter Meta.
  • Vous devriez voir le gateway API Conversions apparaître dans vos paramètres Pixel.
  • Recommandé : créez un domaine personnalisé pour optimiser le routage des données (voir cette page de référence pour obtenir des instructions).