Partager un Pixel Meta avec d’autres entreprises
Plusieurs situations peuvent amener une entreprise à accéder à l’ensemble de données du pixel d’une autre entreprise (typiquement, dans le cas d’une agence), notamment pour gérer des publicités, analyser des performances ou importer des évènements.
Afin de créer un lien entre le pixel et une agence, vous devez réaliser les intégrations d’API suivantes. Si l’agence destinatrice gère également des publicités pour sa clientèle et doit utiliser ce pixel pour des comptes publicitaires, passez à l’étape 3.
Conditions requises : exigences relatives aux applications
Les applications doivent disposer de la fonctionnalité Accès standard pour la gestion des publicités (accès avancé). Elles doivent également avoir les autorisations suivantes :
business_managementads_managementouads_readetmanage_pages
Étape 1 : initier le partage de pixel avec l’agence
Pour ce faire, vous devez disposer d’un token d’accès utilisateur·ice avec les autorisations d’application ci-dessus provenant d’un·e admin de l’entreprise propriétaire du pixel.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
Les options et les paramètres de cette requête comprennent :
| Nom | Description |
|---|---|
type : valeur numérique | Obligatoire. ID de l’agence qui aura accès au pixel |
type : liste de chaînes | Obligatoire. Exemple : ['ANALYZE', 'UPLOAD', 'ADVERTISE'] Tâches que l’agence sera autorisée à effectuer sur le pixel Valeurs acceptées : ANALYZE : consulter, analyser et utiliser dans des publicités. UPLOAD : importer les données de conversion du site Web dans cet ensemble de données. ADVERTISE : lier des comptes publicitaires à cet ensemble de données Facebook. Utiliser cet ensemble de données pour des publicités. EDIT : gérer l’ensemble de données, modifier les paramètres, analyser et utiliser dans des publicités. (L’accès EDIT est actuellement restreint, contactez votre représentant Meta pour ajouter votre application à la liste blanche.) |
Nous traitons chaque requête selon le statut de la relation avec l’autre entreprise :
- Entreprises avec une relation existante approuvée. Nous partageons directement le pixel avec ces entreprises.
- Entreprises avec une relation existante en cours d’approbation. Nous ajoutons le pixel à la requête, de sorte que nous puissions partager le pixel dès que l’autre entreprise aura accepté la requête.
- Entreprises sans relation existante. Nous créons un accord de partage associé au pixel, de sorte que l’autre entreprise puisse accéder au pixel quand la requête est acceptée.
Si l’entreprise parvient à accéder au pixel, la réponse ci-dessous est renvoyée :
{
success: true,
}
Si la requête est en attente, car l’accord n’a pas encore été accepté, l’API renvoie la réponse ci-dessous avec le pending_request_id. Quand l’entreprise accepte la requête, le pixel est automatiquement partagé avec celle-ci. Lisez l’étape 2 pour savoir comment accepter ou refuser la requête.
{
"success": true,
"pending_request_id": "{request_id}"
}
Remarque : un pixel peut être partagé avec un nombre limité d’entreprises.
Étape 2 : accepter une requête en attente (le cas échéant)
Après avoir envoyé une requête de partage de pixel, l’agence peut recevoir une requête d’accord de partage en attente si elle n’a pas encore de relation avec l’entreprise propriétaire du pixel. Les admins de l’entreprise peuvent consulter et accepter cette requête dans leur compte Business Manager.
Pour accepter ou refuser la demande de relation avec l’API, utilisez le request_id obtenu dans la réponse d’erreur à l’étape 1.
L’API a besoin du token d’accès utilisateur·ice de l’admin de l’entreprise destinatrice avec les autorisations d’application business_mangement ou ads_management permission.
POST <request_id>?request_status="approve"
En cas de réussite, l’API renvoie la réponse suivante :
{
success: bool
}
Les options et les paramètres de cette requête comprennent :
| Nom | Description |
|---|---|
type : chaîne | Obligatoire. Indique si l’entreprise qui reçoit la requête de partage de pixel accepte ou refuse cette requête. Valeurs acceptées : |
Étape 3 : partager le pixel avec les comptes publicitaires professionnels d’une agence
Si une agence gère les publicités de sa clientèle et a besoin que les comptes publicitaires de sa clientèle puissent utiliser l’ensemble de données du pixel, utilisez cette API.
Lorsque le pixel est partagé avec une entreprise avec les autorisations d’analyse/publicité, l’entreprise peut autoriser les comptes publicitaires de l’entreprise à utiliser l’ensemble de données du pixel à des fins publicitaires.
L’API a besoin d’un token d’accès utilisateur·ice avec les autorisations business_management, ads_management ou ads_read de l’admin de l’entreprise.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| Nom | Description |
|---|---|
type : valeur numérique | Obligatoire. Entreprise qui gère les publicités et dispose d’un accès au pixel et aux comptes publicitaires. L’utilisateur ou l’utilisatrice dont le token d’accès a été utilisé doit avoir le privilège d’admin pour cette entreprise. |
type : valeur numérique | Obligatoire. Compte publicitaire autorisé à utiliser le pixel. |
Étape 4 : supprimer le lien de partage du pixel
Si le lien de partage entre le pixel et l’agence n’est plus utile, vous pouvez supprimer le lien avec l’API suivante.
Delete <adspixel>/agencies?business=<agency_business_id>
Celle-ci nécessite un token d’accès utilisateur·ice de l’admin de l’entreprise possédant le pixel.
En cas de réussite, l’API renvoie la réponse suivante :
{
success: true
}