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

ChampTypeObligatoireDescription
customer_integrationstringOuiL'uuid de la connexion du client. Il définit le compte publicitaire. Toujours dans la query.
idstringOuiDans /pixels/{id}/events : l'id du pixel, obtenu via GET /ads/facebook_ads/pixels.
refreshbooleanNonIgnore le cache de 600 s et interroge à nouveau la plateforme.
event_namestringNonDans la réponse : le nom de l'événement enregistré par le pixel.
countintegerNonDans la réponse : combien de fois l'événement s'est produit ces 90 derniers jours.
last_fired_atstringNonDans la liste des pixels : quand le pixel s'est déclenché pour la dernière fois.
is_unavailablebooleanNonDans 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.

Voir aussi

Voir tout ce que vous pouvez faire avec Ads

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.