Gateway API Conversions pour plusieurs comptes

Gateway API Conversions pour plusieurs comptes est un mode de configuration du gateway API Conversions qui permet d’associer les sources de données gérées par différents comptes business Meta à la même instance du gateway. La solution exige l’implémentation de la plateforme cloud Amazon Web Services (AWS) ou Google Cloud Platform (GCP), et repose sur une architecture qui assure une disponibilité et une évolutivité élevées. Les données relatives à chaque compte business sont logiquement isolées et séparées. De plus, elles ne sont pas accessibles par les autres comptes business connectés à l’instance ni par l’instance détenant l’entité, à moins que l’accès soit accordé. Cette configuration assure l’utilisation sécurisée et efficace des ressources de la plateforme cloud.

Le gateway API Conversions pour plusieurs comptes permet aux agences, aux partenaires, aux revendeurs ou aux annonceurs mondiaux décentralisés de créer une instance du gateway, puis d’associer et de gérer les sources de données avec lesquels ils travaillent sur l’API Conversions.

Le gateway API Conversions est une méthode d’implémentation en libre-service de l’API Conversions. Il permet aux entreprises de mettre en miroir leurs données marketing envoyées par le pixel Meta à l’API Conversions. Dans une configuration redondante avec le pixel Meta, cela aide le système de diffusion à réduire votre coût par action.

La version actuelle du gateway API Conversions pour plusieurs comptes fonctionne avec la plateforme Amazon Web Services (AWS) et Google Cloud Platform (GCP).

Intégration

Si vous êtes prêt·e à démarrer l’implémentation, cliquez sur le bouton pour être guidé·e à travers les étapes d’intégration de l’hôte.

Architecture de haut niveau

Le schéma ci-dessous représente une situation avec plusieurs comptes, où une instance unique du gateway peut fonctionner avec plusieurs pixels Meta, gérés par différents comptes business et déclenchés par différents domaines.

Le schéma ci-dessous explique l’association du pixel et du gateway, valide pour chacune des nombreuses connexions au sein d’un gateway API Conversions pour plusieurs comptes.

• Le pixel Meta, qui se déclenche sur les pages web de l’annonceur, permet à ce dernier d’envoyer des actions et informations concernant les visiteur·ses au point de terminaison du pixel Meta et au gateway API Conversions.
• Le gateway API Conversions reçoit les actions et informations des visiteur·ses envoyées au moyen du pixel Meta, les formate en fonction des spécifications de l’API Conversions et les envoie au point de terminaison de l’API Conversion.
• Le paramètre de déduplication (event_id) est automatiquement généré et envoyé avec les données transférées au pixel Meta et aux points de terminaison de l’API Conversions.

À qui est-ce destiné ?

Le gateway API Conversions pour plusieurs comptes peut être une solution pour les utilisateur·ices suivant·es :

• Les agences, partenaires et revendeurs qui souhaitent offrir un service permettant de connecter les sources de données des annonceurs au gateway API Conversions.
• Les annonceurs ayant plusieurs pixels qui se déclenchent sur différents domaines et sont gérés via différents comptes business et qui souhaitent disposer d’une solution centralisée basée sur le gateway API Conversions pour associer le trafic de leur pixel à l’API Conversions de Meta.

Hôtes et comptes

Hôte : les agences, les partenaires, les revendeurs ou les annonceurs qui créent et gèrent l’instance du gateway. L’hôte est responsable de la configuration, du contrôle et du dépannage de l’instance, ainsi que de la gestion et de la facturation du compte AWS ou GCP. L’hôte définit les conditions du service proposé aux entreprises qui se connectent à l’instance.

Compte : une entreprise (annonceur) qui associe son pixel à l’instance du gateway de l’hôte. Il est recommandé de créer un compte pour un ou plusieurs pixels qui sont :

• gérés par le même groupe de personnes (c’est-à-dire les utilisateur·ices du compte ayant accès au pixel via le compte business), ou
• déclenchés sur le même domaine d’annonceur.

Compte géré : un compte dont les implémentations du pixel Meta et de l’API Conversions sont (également) gérées par une agence, un partenaire ou un revendeur (l’hôte). En particulier, l’hôte reçoit un accès admin au(x) pixel(s) Meta spécifique(s) sur la plateforme du Gestionnaire d’évènements. Le processus typique implique la création par l’hôte du compte dans le gateway et l’association des pixels à l’instance de gateway, selon les conditions fixées par l’hôte. En outre, l’hôte peut créer des comptes d’utilisateur·ices avec des autorisations spécifiques pour les employé·es de l’annonceur qui seront en mesure d’administrer, de gérer ou simplement de voir la configuration du compte. L’hôte et l’annonceur contrôlent les paramètres spécifiques du pixel et l’association du pixel à l’instance du gateway. À tout moment, l’entreprise peut passer à un compte non géré.

Compte non géré : un compte dont les implémentations du pixel Meta et de l’API Conversions ne sont pas gérées par une agence, un partenaire ni un revendeur. Le processus type implique la création par l’hôte du compte et l’envoi d’une invitation à l’entreprise (un admin de compte) à rejoindre l’instance et à s’y connecter, selon les conditions fixées par l’hôte. L’entreprise contrôle les paramètres spécifiques du pixel et l’association du pixel à l’instance. À tout moment, l’entreprise peut passer à un compte géré.

Utilisateur·ices et autorisations

Les hôtes et comptes peuvent créer des utilisateur·ices avec une des autorisations suivantes :

Composants techniques

Amazon Web Services et Google Cloud Platform

Le gateway API Conversions pour plusieurs comptes nécessite l’implémentation de la plateforme Amazon Web Services (AWS) ou Google Cloud Platform (GCP), une plateforme cloud à la demande. Le compte AWS ou GCP est détenu et géré par l’agence, le partenaire, le revendeur ou l’annonceur qui implémente le gateway API Conversions pour plusieurs comptes, c’est-à-dire l’hôte (et donc pas par Meta). L’hôte peut déployer automatiquement l’instance sans avoir besoin d’un·e développeur·se. L’architecture du gateway pour plusieurs comptes repose sur Elastic Kubernetes Service (EKS) d’AWS.

Composants logiciels

Pixel Meta

La bibliothèque JavaScript standard de Meta chargée sur les pages web de l’annonceur qui envoie à Meta les actions et informations de la clientèle, appelées données des outils Business dans les Conditions générales des outils Meta Business. Pour les annonceurs ayant intégré le gateway API Conversions pour plusieurs comptes, le pixel Meta donne lieu aux actions suivantes lorsqu’il se déclenche :

• Téléchargement et lancement du code client du WebSocket de l’API Conversions utilisé pour communiquer avec le gateway API Conversions pour plusieurs comptes.
• Envoi des données d’évènement au point de terminaison du pixel Meta et au gateway API Conversions pour plusieurs comptes via une connexion HTTP sécurisée.

Gateway API Conversions pour plusieurs comptes

Le gateway API Conversions pour plusieurs comptes est hébergé par l’agence, le partenaire, le revendeur ou l’annonceur sur son compte Amazon Web Services (AWS) ou Google Cloud Platform (GCP). Il est provisionné sur son compte AWS ou GCP. Il se compose des éléments suivants :

• Un module qui reçoit les évènements entrants (actions des visiteur·ses du site Web) du pixel Meta, et les formate en fonction des spécifications de l’API Conversions avant de les envoyer au point de terminaison de l’API Conversions de Meta.
• Une interface d’utilisation où les hôtes peuvent administrer l’instance de l’hôte (utilisateur·ices, comptes, mises à jour, etc.).
• Une interface d’utilisation où les comptes administrent leur compte (utilisateur·ices, sources de données, routage des données, etc.).

Extension Meta Business

L’extension Meta Business (MBE) est utilisée dans le gateway API Conversions pour plusieurs comptes afin de faciliter l’intégration des hôtes et comptes et d’associer en toute sécurité les sources de données à l’instance.

Configuration DNS

Les hôtes doivent configurer un enregistrement CNAME sur leur fournisseur DNS afin d’associer un sous-domaine à l’instance du gateway API Conversions pour plusieurs comptes (plus précisément, à l’équilibreur de charge de l’instance) et le rendre accessible depuis le Web.

Il est recommandé aux comptes de configurer un enregistrement CNAME sur leur fournisseur DNS en associant un sous-domaine de leur domaine au sous-domaine de leur hôte, ce qui permet d’activer une association interne entre le pixel Meta sur leur site Web et l’instance du gateway API Conversions pour plusieurs comptes.

Cloudflare utilisé comme service DNS intégré par défaut

Un équilibreur de charge est un composant de l’infrastructure du gateway API Conversions qui répartit le trafic réseau entrant sur plusieurs serveurs. Grâce à lui, nous pouvons garantir la disponibilité et la réactivité de notre application même pendant les périodes de fort trafic.

En plus de l’équilibrage de charge, nous utilisons les certificats SSL/TLS pour chiffrer les données en transit entre les clients et le gateway API Conversions. Ces certificats sont délivrés dès qu’un annonceur configure un domaine interne. Si le domaine interne n’est pas configuré, l’annonceur doit utiliser le domaine de l’agence par défaut. La configuration d’un domaine interne présente l’avantage d’acheminer les évènements de pixel vers ce domaine que l’annonceur détient et contrôle. À défaut, les évènements de pixel passent de l’annonceur à Meta via le domaine de l’agence. Actuellement, le gateway API Conversions n’accepte d’associer qu’un seul certificat à l’équilibreur de charge.

En utilisant Cloudflare, nous pouvons contourner cette limitation. L’un des principaux avantages de l’utilisation de Cloudflare est sa capacité à émettre jusqu’à 5 000 certificats SSL/TLS pour les domaines annonceurs qui pointent vers un domaine d’agence géré ou détenu par Cloudflare. Ainsi, jusqu’à 5 000 annonceurs par instance du gateway API Conversions peuvent utiliser un domaine interne. De plus, si votre instance du gateway API Conversions est basée sur AWS EKS, elle coûte moins cher avec Cloudflare qu’en utilisant le domaine AWS Cloudfront par défaut généré aléatoirement par le gateway API Conversions, car le coût de la terminaison SSL est moins élevé.

Partage de données

Grâce au gateway API Conversions pour plusieurs comptes, les entreprises peuvent partager les mêmes données que celles qui sont partagées lors de l’utilisation du pixel Meta, à l’exception de la liste ci-dessous. Veuillez consulter le guide des solutions Meta Business pour plus d’informations.

Les données suivantes ne sont pas prises en charge par le gateway API Conversions :

• Actions de la clientèle configurées à l’aide de l’outil de configuration d’évènements
• Cookie tiers Meta

Démarrer votre implémentation

Si vous êtes prêt·e à démarrer l’implémentation, cliquez sur le bouton pour être guidé·e à travers les étapes d’intégration et de gestion de l’hôte.

Si vous êtes prêt·e à démarrer l’implémentation, cliquez sur le bouton pour être guidé·e à travers les étapes d’intégration de l’hôte.

Voir aussi

• Gateway API Conversions
• Questions/réponses des agences qui cherchent à intégrer le gateway API Conversions pour plusieurs comptes
• Pixel Meta
• Glossaire
• Utilisation de l’API Conversions
• Extension Meta Business (MBE)