Ads
Lister les audiences Meta Ads et les listes d'utilisateurs Google Ads via l'API
Une route liste les audiences personnalisées du compte publicitaire du client, avec id, nom, type et taille approximative. L'id va dans le ciblage de l'ensemble d'annonces, et vous lisez tout via la connexion du client, sans OAuth à développer ni app review Meta.
L'appel
GET /api/ads/audiences?customer_integration=<connection uuid> Authorization: Bearer <merchant token> x-customer-token: <customer token>
Ce que vous pouvez faire
- Lister les audiences personnalisées du compte avec GET /ads/audiences.
- Utiliser l'id de chaque audience dans targeting.custom_audiences à la création d'un ensemble d'annonces.
- Voir le nom, le subtype et la taille approximative (approximate_size, de lower à upper) de chaque audience.
- Forcer une nouvelle lecture depuis la plateforme avec refresh=true.
- Sur Google Ads, lister les listes d'utilisateurs ouvertes du compte (remarketing et customer match) avec la même route.
Règles et limites
- La route est en lecture seule. Créer des audiences et envoyer des listes d'utilisateurs ne font pas partie de cette version.
- 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.
- La connexion va toujours dans ?customer_integration= et l'appel exige Authorization et x-customer-token.
- Sur Google Ads, Google donne une seule taille approximative, renvoyée dans lower et dans upper.
- Sur Google Ads, les résultats n'alimentent pas encore la création : campagne et groupe sont créés sans ciblage de lieu, de langue ni d'audience.
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. |
| refresh | boolean | Non | Ignore le cache de 600 s et interroge à nouveau la plateforme. |
| id | string | Non | Dans la réponse : l'id de l'audience. C'est ce qui va dans targeting.custom_audiences. |
| name | string | Non | Dans la réponse : le nom de l'audience dans le compte. |
| subtype | string | Non | Dans la réponse : le type d'audience sur la plateforme. |
| approximate_size | object | Non | Dans la réponse : la taille approximative, sous forme de fourchette avec lower et upper. |
Pour qui
Sélecteur d'audience dans votre SaaS
Montrez au client les audiences qu'il a déjà dans le compte et laissez-le choisir lesquelles utiliser dans l'ensemble d'annonces.
Remarketing d'agence
Une agence liste les audiences de visiteurs du client et crée un ensemble d'annonces qui les cible.
Agent IA qui construit des campagnes
Un agent lit les audiences du compte, choisit celle des clients actuels et l'utilise dans le ciblage du nouvel ensemble.
Fonctionne avec
Meta Ads
Google Ads
Questions fréquentes
Puis-je créer une audience personnalisée via l'API ?
Pas encore. La route est en lecture seule : créer des audiences et envoyer des listes d'utilisateurs ne font pas partie de cette version.
Où utiliser l'id de l'audience ?
Dans targeting.custom_audiences, dans le ciblage de l'ensemble d'annonces.
Une nouvelle audience apparaît-elle tout de suite ?
La lecture est mise en cache 600 s par connexion. Utilisez refresh=true pour interroger à nouveau la plateforme.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
