Ads
Mettre en pause et activer campagnes, ensembles et annonces via l'API
Allumer et éteindre des annonces, c'est un PATCH avec status active ou paused, au niveau que vous voulez contrôler : campagne, ensemble ou annonce. Cela fonctionne pour tout objet du compte connecté, y compris ceux créés directement dans le Gestionnaire de publicités. Sans implémenter l'API Meta.
L'appel
PATCH /api/ads/campaigns/{id}?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"status": "active"
}Ce que vous pouvez faire
- Mettre en pause ou activer une campagne avec PATCH /ads/campaigns/{id}.
- Mettre en pause ou activer un ensemble avec PATCH /ads/adsets/{id}.
- Mettre en pause ou activer une annonce avec PATCH /ads/{id}.
- Changer le nom dans le même PATCH.
- Identifier l'objet par l'id de la plateforme ou par l'uuid Connect.
Règles et limites
- Valeurs de status acceptées : active et paused.
- Fonctionne pour tout objet du compte, y compris ceux créés hors de Connect : il est enregistré à la première écriture.
- Idempotency-Key est facultatif sur PATCH.
- L'id est vérifié par rapport au compte de la connexion ; d'un autre compte, la réponse est 404 ads_object_not_found.
- La connexion de customer_integration doit appartenir au client (403 sinon) et être valide (422 ads_connection_expired si le token a expiré).
- La réponse est synchrone (200).
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| id | string | Oui | Dans le chemin : l'id de l'objet (ou l'uuid Connect). |
| status | string | Non | active ou paused. |
| name | string | Non | Nouveau nom, si vous voulez le changer en même temps. |
| customer_integration | string | Oui | Dans la query : la connexion du client au compte publicitaire. |
| Idempotency-Key | string | Non | Dans le header. Facultatif sur PATCH, recommandé pour pouvoir rejouer sans risque. |
Pour qui
Interrupteur dans le tableau de bord
Votre client met une campagne en pause depuis votre produit, sans ouvrir le Gestionnaire de publicités.
Règle de sécurité automatique
Mettez des annonces en pause quand une métrique dépasse un seuil que vous définissez, comme un coût par résultat élevé.
Agent IA qui gère le budget
L'agent met en pause ce qui sous-performe et active ce qui a été approuvé, par de simples appels.
Fonctionne avec
Meta Ads
Questions fréquentes
Faut-il avoir créé l'annonce via Connect pour la mettre en pause ?
Non. Tout objet du compte connecté peut être mis en pause ou activé ; il entre dans les enregistrements de Connect à la première écriture.
Quelles valeurs de status sont acceptées ?
active et paused.
Puis-je rejouer l'appel sans risque ?
Oui. Envoyez une Idempotency-Key (facultative sur PATCH) et une répétition avec la même clé renvoie la première réponse.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
