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

ChampTypeObligatoireDescription
idstringOuiDans le chemin : l'id de l'objet (ou l'uuid Connect).
statusstringNonactive ou paused.
namestringNonNouveau nom, si vous voulez le changer en même temps.
customer_integrationstringOuiDans la query : la connexion du client au compte publicitaire.
Idempotency-KeystringNonDans 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.

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.