Ads
Editar el presupuesto de una campaña o conjunto en Meta Ads con la API
Cambiar el presupuesto es un PATCH con budget en el nivel donde está el presupuesto: en la campaña, si usa presupuesto de campaña (CBO), o en el conjunto, si cada conjunto tiene el suyo (ABO). Los valores van en la moneda de la cuenta del cliente, sin conversión a centavos y sin implementar la API de Meta.
La llamada
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
}
}Qué puedes hacer
- Cambiar el presupuesto de una campaña CBO con PATCH /ads/campaigns/{id}.
- Cambiar el presupuesto de un conjunto ABO con PATCH /ads/adsets/{id}.
- Cambiar el tipo entre daily y lifetime.
- Definir o quitar el límite de gasto de la campaña con facebook_ads.spend_cap.
- Ajustar la agenda del conjunto en el mismo PATCH, con schedule.start y schedule.end.
Reglas y límites
- El presupuesto va en la campaña (CBO) o en cada conjunto (ABO), nunca en los dos. No existe un campo level: el nivel es donde está el budget.
- Budget en una campaña ABO, o en un conjunto de campaña CBO, responde 409 budget_level_mismatch, y budget_level indica el nivel correcto.
- budget.amount va en la moneda de la cuenta, nunca en centavos.
- budget.type lifetime exige schedule.end en el conjunto.
- spend_cap null quita el límite de gasto de la campaña.
- Idempotency-Key es opcional en PATCH. La respuesta es síncrona (200).
Campos principales
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | En la ruta: el id del objeto (o el uuid de Connect). |
| budget.amount | number | Sí | Nuevo valor, en la moneda de la cuenta de anuncios, nunca en centavos. |
| budget.type | string | No | daily o lifetime. lifetime exige schedule.end en el conjunto. |
| facebook_ads.spend_cap | number | No | Solo en la campaña: límite de gasto, en la moneda de la cuenta. null lo quita. |
| schedule.end | string | No | Solo en el conjunto: fecha de fin, obligatoria con presupuesto lifetime. |
Para quién
Control de presupuesto en tu panel
El cliente sube o baja el presupuesto diario de una campaña desde tu producto.
Pacing automático
Baja el presupuesto de conjuntos que superaron la meta del mes y sube los que están por debajo.
Agente de IA que reasigna presupuesto
El agente lee el rendimiento, mueve presupuesto entre conjuntos ABO y registra cada cambio.
Funciona con
Meta Ads
Preguntas frecuentes
¿Cómo sé si mi presupuesto está en la campaña o en el conjunto?
Por el nivel donde se creó el budget. Si lo envías al nivel equivocado, la respuesta es 409 budget_level_mismatch con budget_level indicando el correcto.
¿El valor va en centavos?
No. budget.amount va en la moneda de la cuenta de anuncios, por ejemplo 50 para 50 dólares.
¿Puedo limitar el gasto total de una campaña?
Sí, con facebook_ads.spend_cap en la campaña. Enviar null quita el límite.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
