Ads
Modifier le budget d'une campagne ou d'un ensemble Meta Ads via l'API
Changer le budget, c'est un PATCH avec budget au niveau où se trouve le budget : sur la campagne si elle utilise un budget de campagne (CBO), ou sur l'ensemble si chacun a le sien (ABO). Les valeurs sont dans la devise du compte du client, sans conversion en centimes et 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>
{
"budget": {
"amount": 80,
"type": "daily"
},
"facebook_ads": {
"spend_cap": 2000
}
}Ce que vous pouvez faire
- Modifier le budget d'une campagne CBO avec PATCH /ads/campaigns/{id}.
- Modifier le budget d'un ensemble ABO avec PATCH /ads/adsets/{id}.
- Passer le type de daily à lifetime et inversement.
- Définir ou supprimer le plafond de dépense de la campagne avec facebook_ads.spend_cap.
- Ajuster le calendrier de l'ensemble dans le même PATCH, avec schedule.start et schedule.end.
Règles et limites
- Le budget est sur la campagne (CBO) ou sur chaque ensemble (ABO), jamais sur les deux. Il n'y a pas de champ level : le niveau est l'endroit où se trouve le budget.
- Un budget sur une campagne ABO, ou sur un ensemble d'une campagne CBO, renvoie 409 budget_level_mismatch, et budget_level indique le bon niveau.
- budget.amount est dans la devise du compte, jamais en centimes.
- budget.type lifetime exige schedule.end sur l'ensemble.
- spend_cap null supprime le plafond de dépense de la campagne.
- Idempotency-Key est facultatif sur PATCH. 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). |
| budget.amount | number | Oui | Nouveau montant, dans la devise du compte publicitaire, jamais en centimes. |
| budget.type | string | Non | daily ou lifetime. lifetime exige schedule.end sur l'ensemble. |
| facebook_ads.spend_cap | number | Non | Campagne seulement : plafond de dépense, dans la devise du compte. null le supprime. |
| schedule.end | string | Non | Ensemble seulement : date de fin, obligatoire avec un budget lifetime. |
Pour qui
Contrôle du budget dans votre tableau de bord
Le client augmente ou réduit le budget quotidien d'une campagne directement dans votre produit.
Pacing automatique
Réduisez le budget des ensembles qui ont dépassé l'objectif du mois et augmentez ceux qui sont en dessous.
Agent IA qui réalloue le budget
L'agent lit les performances, déplace du budget entre ensembles ABO et enregistre chaque changement.
Fonctionne avec
Meta Ads
Questions fréquentes
Comment savoir si mon budget est sur la campagne ou sur l'ensemble ?
Par le niveau où le budget a été créé. Si vous l'envoyez au mauvais niveau, la réponse est 409 budget_level_mismatch avec budget_level indiquant le bon.
La valeur est-elle en centimes ?
Non. budget.amount est dans la devise du compte publicitaire, par exemple 50 pour 50 euros.
Puis-je plafonner la dépense totale d'une campagne ?
Oui, avec facebook_ads.spend_cap sur la campagne. Envoyer null supprime le plafond.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
