Ads
Editar orçamento de campanha ou conjunto no Meta Ads pela API
Mudar a verba é um PATCH com budget no nível em que o orçamento está: na campanha, se ela usa orçamento de campanha (CBO), ou no conjunto, se cada conjunto tem o seu (ABO). Valores na moeda da conta do cliente, sem conversão para centavos e sem implementar a API do Meta.
A chamada
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
}
}O que dá para fazer
- Alterar o orçamento de uma campanha CBO com PATCH /ads/campaigns/{id}.
- Alterar o orçamento de um conjunto ABO com PATCH /ads/adsets/{id}.
- Trocar o tipo entre daily e lifetime.
- Definir ou remover o limite de gasto da campanha com facebook_ads.spend_cap.
- Ajustar a agenda do conjunto no mesmo PATCH, com schedule.start e schedule.end.
Regras e limites
- O orçamento fica na campanha (CBO) ou em cada conjunto (ABO), nunca nos dois. Não existe campo level: o nível é onde o budget está.
- Budget numa campanha ABO, ou num conjunto de campanha CBO, responde 409 budget_level_mismatch, e budget_level indica o nível certo.
- budget.amount é na moeda da conta, nunca em centavos.
- budget.type lifetime exige schedule.end no conjunto.
- spend_cap null remove o limite de gasto da campanha.
- Idempotency-Key é opcional em PATCH. A resposta é síncrona (200).
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | No caminho: o id do objeto (ou o uuid do Connect). |
| budget.amount | number | Sim | Novo valor, na moeda da conta de anúncios, nunca em centavos. |
| budget.type | string | Não | daily ou lifetime. lifetime exige schedule.end no conjunto. |
| facebook_ads.spend_cap | number | Não | Só na campanha: limite de gasto, na moeda da conta. null remove. |
| schedule.end | string | Não | Só no conjunto: data de término, obrigatória com orçamento lifetime. |
Para quem
Controle de verba no seu painel
O cliente aumenta ou reduz o orçamento diário de uma campanha direto no seu produto.
Pacing automático
Reduza o orçamento de conjuntos que passaram da meta do mês e aumente os que estão abaixo.
Agente de IA que realoca verba
O agente lê o desempenho, move orçamento entre conjuntos ABO e registra cada mudança.
Funciona com
Meta Ads
Perguntas frequentes
Como sei se meu orçamento fica na campanha ou no conjunto?
Pelo nível em que o budget foi criado. Se você mandar para o nível errado, a resposta é 409 budget_level_mismatch com budget_level indicando o nível certo.
O valor é em centavos?
Não. budget.amount é na moeda da conta de anúncios, por exemplo 50 para 50 reais.
Dá para limitar o gasto total de uma campanha?
Sim, com facebook_ads.spend_cap na campanha. Enviar null remove o limite.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
