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
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| id | string | Oui | Dans le chemin : l'id de l'annonce, de l'ensemble ou de la campagne à copier (ou l'uuid Connect). |
| name | string | Oui | Nom de la copie. Facultatif pour une annonce (sans nom, la plateforme en attribue un) ; obligatoire pour un ensemble et une campagne. |
| status | string | Non | Ensembles et campagnes seulement : paused (par défaut) ou active. |
| campaign_id | string | Non | Ensembles seulement : la campagne cible. Sans lui, la copie reste dans la campagne d'origine. |
| budget.amount | number | Non | Ensembles et campagnes seulement : nouveau budget, dans la devise du compte. |
| schedule.start | string | Non | Ensembles 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
