Ads
Lister pixels et événements de conversion Meta Ads via l'API
Deux routes montrent les pixels du compte publicitaire du client et les événements enregistrés par chaque pixel, avec le décompte de la période. L'id du pixel va dans l'ensemble d'annonces optimisé pour la conversion, et vous lisez tout via la connexion du client, sans implémenter l'API Meta.
L'appel
GET /api/ads/facebook_ads/pixels/900000000000001/events?customer_integration=<connection uuid> Authorization: Bearer <merchant token> x-customer-token: <customer token>
Ce que vous pouvez faire
- Lister les pixels du compte avec GET /ads/facebook_ads/pixels, avec id, nom, last_fired_at, created_at et is_unavailable.
- Voir les événements enregistrés par un pixel avec GET /ads/facebook_ads/pixels/{id}/events, avec event_name et count.
- Utiliser l'id du pixel dans adset.facebook_ads.promoted_object.pixel_id sur un ensemble optimisé pour la conversion.
- Forcer une nouvelle lecture depuis la plateforme avec refresh=true.
Règles et limites
- Le décompte des événements couvre les 90 derniers jours, la fenêtre utilisée par l'intégration pour que les événements rares ne disparaissent pas.
- Elle n'est pas paginée : 200 éléments maximum par lecture.
- Cache de 600 s par connexion. meta.cached et meta.cached_at indiquent si cela vient du cache, et refresh=true l'ignore.
- Un id de pixel qui n'appartient pas au compte de la connexion répond 404 ads_object_not_found.
- La connexion va toujours dans ?customer_integration= et l'appel exige Authorization et x-customer-token.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| customer_integration | string | Oui | L'uuid de la connexion du client. Il définit le compte publicitaire. Toujours dans la query. |
| id | string | Oui | Dans /pixels/{id}/events : l'id du pixel, obtenu via GET /ads/facebook_ads/pixels. |
| refresh | boolean | Non | Ignore le cache de 600 s et interroge à nouveau la plateforme. |
| event_name | string | Non | Dans la réponse : le nom de l'événement enregistré par le pixel. |
| count | integer | Non | Dans la réponse : combien de fois l'événement s'est produit ces 90 derniers jours. |
| last_fired_at | string | Non | Dans la liste des pixels : quand le pixel s'est déclenché pour la dernière fois. |
| is_unavailable | boolean | Non | Dans la liste des pixels : indique si le pixel est indisponible. |
Pour qui
Vérifier le pixel avant le lancement
Votre SaaS vérifie que le pixel du client a enregistré Purchase ces 90 derniers jours avant d'autoriser l'optimisation sur l'achat.
Diagnostic du suivi dans une agence
Une agence liste les pixels et la date du dernier déclenchement pour trouver ceux qui ont cessé de fonctionner.
Agent IA qui choisit l'événement
Un agent lit les événements du pixel, choisit celui au plus fort volume et configure l'ensemble d'annonces avec lui.
Fonctionne avec
Meta Ads
Questions fréquentes
Quelle période couvre le décompte des événements ?
Les 90 derniers jours, la fenêtre utilisée par l'intégration pour que les événements rares ne disparaissent pas.
Où utiliser l'id du pixel ?
Dans adset.facebook_ads.promoted_object.pixel_id, sur un ensemble d'annonces optimisé pour la conversion.
Comment savoir si le pixel fonctionne ?
GET /ads/facebook_ads/pixels renvoie last_fired_at et is_unavailable, et la route des événements montre quels événements sont arrivés et combien de fois.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
