Ads

Dupliquer une annonce, un ensemble ou une campagne Meta Ads via l'API

Clonez une annonce, un ensemble ou une campagne du compte du client sans tout reconstruire. Vous pouvez ajuster nom, budget, calendrier ou campagne cible dans le même appel. La copie est créée en pause : rien ne dépense avant que vous l'activiez.

L'appel

POST /api/ads/{id}/duplicate?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "name": "Black Friday, copy"
}

Ce que vous pouvez faire

  • Dupliquer une annonce avec POST /ads/{id}/duplicate.
  • Dupliquer un ensemble avec POST /ads/adsets/{id}/duplicate, en choisissant une autre campagne cible avec campaign_id.
  • Dupliquer une campagne avec POST /ads/campaigns/{id}/duplicate.
  • Changer le nom de la copie et, pour ensembles et campagnes, le budget.
  • Changer la date de début d'un ensemble copié.
  • Utiliser l'id numérique de la plateforme ou l'uuid Connect.

Règles et limites

  • Idempotency-Key est obligatoire dans le header ; répéter avec la même clé renvoie 200 avec Idempotent-Replay: true, sans créer une autre copie.
  • La copie d'une annonce est toujours créée en pause, dans le même ensemble. Pour ensembles et campagnes, status vaut paused par défaut.
  • name est obligatoire pour dupliquer un ensemble ou une campagne, et facultatif pour une annonce.
  • Le budget suit la règle CBO/ABO : l'envoyer au mauvais niveau renvoie 409 budget_level_mismatch.
  • L'objet doit exister dans le compte de la connexion ; un id d'un autre compte renvoie 404 ads_object_not_found.
  • La réponse est synchrone (201).

Champs principaux

ChampTypeObligatoireDescription
idstringOuiDans le chemin : l'id de l'annonce, de l'ensemble ou de la campagne à copier (ou l'uuid Connect).
namestringOuiNom de la copie. Facultatif pour une annonce (sans nom, la plateforme en attribue un) ; obligatoire pour un ensemble et une campagne.
statusstringNonEnsembles et campagnes seulement : paused (par défaut) ou active.
campaign_idstringNonEnsembles seulement : la campagne cible. Sans lui, la copie reste dans la campagne d'origine.
budget.amountnumberNonEnsembles et campagnes seulement : nouveau budget, dans la devise du compte.
schedule.startstringNonEnsembles seulement : nouvelle date de début.

Pour qui

  • Passer à l'échelle ce qui marche

    Dupliquez un ensemble gagnant avec un budget plus grand ou une autre campagne cible, et activez-le quand tout est prêt.

  • Tests de visuels

    Copiez une annonce puis modifiez le texte ou le titre de la copie pour comparer des variantes.

  • Modèles par client

    Gardez une campagne modèle et dupliquez-la pour chaque nouveau client, en ne changeant que le nom et le budget.

Fonctionne avec

  • Meta Ads

Questions fréquentes

La copie dépense-t-elle dès le départ ?

La copie d'une annonce est toujours créée en pause. Pour ensembles et campagnes, le défaut est aussi paused, et elle ne s'active que si vous envoyez status active.

Puis-je dupliquer une campagne créée hors de Connect ?

Oui, tant que l'id appartient à un objet du compte connecté. L'id numérique de la plateforme fonctionne pour tout objet du compte.

Et si je répète l'appel par erreur ?

Avec la même Idempotency-Key, la répétition renvoie la première réponse et ne crée pas une autre copie.

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.