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

CampoTipoObrigatórioDescrição
idstringSimNo caminho: o id do objeto (ou o uuid do Connect).
budget.amountnumberSimNovo valor, na moeda da conta de anúncios, nunca em centavos.
budget.typestringNãodaily ou lifetime. lifetime exige schedule.end no conjunto.
facebook_ads.spend_capnumberNãoSó na campanha: limite de gasto, na moeda da conta. null remove.
schedule.endstringNãoSó 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.

Relacionadas

Ver tudo que dá para fazer em Ads

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.