Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.
Anglais mis à jour : 29 avr.

Gateway API Conversions : Guide de configuration

Suivez les étapes suivantes pour configurer le gateway API Conversions.

Veuillez vous assurer que vous avez examiné et rempli les conditions préalables pour le gateway API Conversions avant de parcourir ce guide de configuration.

Étape 1 : Premier pas et commencer le déploiement

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



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

Sélectionner les préférences

  • Choisissez les paramètres à 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.


  • 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 sont préremplis. Veuillez ne pas modifier le champ ProvisioningData.
  • Cliquez sur Créer une pile pour commencer l’installation.
  • Le processus de création prend environ 30 à 40 minutes, après quoi trois sorties seront écrites dans l’onglet Sorties pour la nouvelle instance AWS. Vous saurez que c’est fait 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.
  • (Recommandé) Créez un domaine personnalisé pour faciliter le routage des données (voir l’étape 4 ci-dessous).
  • 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 (voir l’étape 2). Le lien CapigSetupURL se trouve également dans le Gestionnaire d’évènements Meta.

  • 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 le site de l’UI 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 5 minutes à 2 heures pour être renseignées.
  • Pour vérifier si les données sont collectées, vous pouvez aller sur votre site Web et actualiser la page.
  • Si les évènements ne s’affichent pas après 2 heures, veuillez contacter Meta.
  • Vous devriez voir le gateway API Conversions apparaître dans vos paramètres Pixel.

(Recommandé) Étape 4 : Ajouter un domaine personnalisé

Configurez un domaine personnalisé dans l’UI d’administration du gateway API Conversions. Cette opération est recommandée, car elle peut permettre d’optimiser le routage des données et réduire les coûts.

Remarque : vous aurez besoin d’accéder à votre fournisseur DNS pour ajouter un domaine personnalisé.

  • Connectez-vous à l’UI d’administration du gateway API Conversions.
  • Accédez à Gestion du domaine dans la barre latérale gauche sous Paramètres.
  • Choisissez entre le fournisseur de DNS AWS Certificate Manager (ACM) et Cloudflare.

1. AWS Certificate Manager

Suivez les instructions de configuration d’ACM pour terminer la procédure.

2. Cloudflare

Suivez les instructions de configuration de Cloudflare pour terminer la procédure.

Résolution des problèmes de configuration

Suivez ces étapes pour résoudre les problèmes lorsque vous configurez le portail de l'API Conversions. Pour des informations générales sur la résolution des problèmes, voir Portail de l'API Conversions - Résolution des erreurs et avertissements.

La fonctionnalité de remplissage automatique du navigateur interfère avec la configuration

Si vous ne pouvez pas installer le portail de l’API Conversions en raison de l'expiration des données de provisionnement, bien que vous ayez lancé l'installation à partir du Gestionnaire d'évènements, il se peut que la fonctionnalité de remplissage automatique du navigateur ait renseigné automatiquement les informations précédemment utilisées.

Diagnostics

  1. Lancez l'installation à partir du Gestionnaire d'évènements et enregistrez les données de provisionnement pour un examen ultérieur.
  2. Cliquez sur Copier l'URL et enregistrez l'URL copiée dans n'importe quel éditeur de texte tel que Notepad.
  3. Cliquez sur Commencer le déploiement pour lancer la page de création AWS.
  4. Sur la page de création AWS, repérez ProvisioningData et vérifiez que l'entrée correspond à l'URL que vous avez copiée précédemment. Si elles ne correspondent pas, la fonctionnalité de remplissage automatique est activée ; vous devez la désactiver.

Résolution

Pour les navigateurs FireFox, procédez comme suit :

  1. Cliquez sur l'icône du menu Firefox (trois barres en haut à droite de l'écran).
  2. Cliquez sur Paramètres.
  3. Sélectionnez les paramètres Confidentialité et sécurité.
  4. Faites défiler jusqu'à Historique et pour Firefox doit choisissez Utiliser les paramètres personnalisés pour l'historique.
  5. Décochez Se souvenir de l'historique des recherches et des formulaires.
  6. Vos modifications sont enregistrées automatiquement.

Pour les navigateurs Chrome, procédez comme suit :

  1. Cliquez sur l'icône du menu Chrome (trois points en haut à droite de l'écran).
  2. Cliquez sur Paramètres.
  3. Sélectionnez les paramètres Saisie automatique.
  4. Développez la zone appropriée.
  5. Désactivez le paramètre de saisie automatique.
  6. Vos modifications sont enregistrées automatiquement.

Configurations supplémentaires

Le Gestionnaire d’évènements Meta vous permet d’ajouter de nouvelles connexions, de configurer des domaines supplémentaires et d’ajouter de nouveaux pixels à votre connexion existante au gateway API Conversions. Pour les définir, veuillez suivre les étapes ci-dessous :

Cliquez sur Intégrations de partenaires, sur le côté gauche de la page :



Sélectionnez Gateway API Conversions pour ouvrir le gateway API Conversions.



Cet écran vous permet de consulter les éléments suivants :

  • Évènements du site Web
    1. Les évènements sont des actions de site Web qui sont configurées sur votre site du portail de l’API Conversions, et qui sont envoyées séparément à Meta à l’aide du pixel Meta.
  • Domaines du site Web
    1. Sites Web sur lesquels votre portail de l’API Conversions est configuré pour se connecter via le pixel.


Cliquez sur Paramètres et sélectionnez l’action que vous souhaitez entreprendre.

Ajouter une autre connexion au gateway API Conversions

Cela vous permet de configurer une nouvelle instance du gateway API Conversions avec un autre pixel Meta. Vous pouvez voir ci-dessous la première étape dans la boîte de dialogue, similaire à celle de la page sur les paramètres du pixel Meta. Vous serez ensuite invité à sélectionner un pixel Meta pour l’installation de votre nouvelle connexion au gateway API Conversions.

Ajouter un autre pixel Meta à une connexion existante au gateway API Conversions

Cette option vous permet d’intégrer un autre pixel Meta à une installation existante du portail de l’API Conversions.

Pour commencer le processus d’installation, accédez à l’onglet Paramètres dans le Gestionnaire d’évènements Meta. Sous la section « Gateways API Conversions existants », cliquez sur le bouton Se connecter :