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

ChampTypeObligatoireDescription
idstringOuiDans le chemin : l'id de l'objet (ou l'uuid Connect).
budget.amountnumberOuiNouveau montant, dans la devise du compte publicitaire, jamais en centimes.
budget.typestringNondaily ou lifetime. lifetime exige schedule.end sur l'ensemble.
facebook_ads.spend_capnumberNonCampagne seulement : plafond de dépense, dans la devise du compte. null le supprime.
schedule.endstringNonEnsemble 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.

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.