Indice

Por que automatizar

Ads Manager funciona perfecto para 1-3 cuentas con pocos creativos. Pero cuando manejas 15+ clientes con 8 creativos por mes cada uno, hacer click en la UI te roba 20 horas semanales que no pagan.

Cuando si conviene

• Multi-cuenta: +5 clientes con campañas similares. Replicar estructuras es repetitivo y proclive a errores.
• Multi-formato: cada video sale en 9:16, 1:1 y 16:9. Subirlos uno por uno por placement es insostenible.
• Auditabilidad: tener log de cada deploy en una DB te permite saber quien, cuando, con que parametros.
• Reproducibilidad: si necesitas relanzar una campaña tal cual fue, en la UI no hay forma. En API si.

Cuando no conviene

• 1-3 clientes pequeños. El setup de la API te lleva 1-2 dias. Para volumen bajo no se amortiza.
• Estrategias muy distintas por cliente. Si cada campaña es a medida, automatizar te da poca palanca.

Setup: token y permisos

Antes de tirar una linea de codigo, esto: la app de Meta Developer, el system user, los permisos del token. 90% de los errores de la API vienen de saltarse este paso.

Test del token

$ curl "https://graph.facebook.com/v21.0/me?access_token=$META_ACCESS_TOKEN"
# Si te devuelve { "name": "...", "id": "..." } estas bien.
# Si te devuelve un error code 190, regenera el token.

Pipeline de 6 fases

Asi corremos un deploy en Instabiz. Cada fase es un step independiente, cada uno se loguea en una tabla ad_deploy_log para auditoria. Si una falla, retomas desde ahi.

Geographic targeting la trampa

El error que mas plata cuesta es targetear la region equivocada. La API de Meta usa keys numericas que parecen aleatorias y no se documentan bien. SIEMPRE validar antes de deployar.

Como validar una region key

$ curl "https://graph.facebook.com/v21.0/search?type=adgeolocation\
&location_types=region&q=Buenos+Aires&access_token=$TOKEN"

La respuesta tiene los campos key, country_code, name. Verifica los 3 antes de usar la key.

Errores tipicos

Patron correcto para AR

# Solo Capital Federal y GBA:
{
  "geo_locations": {
    "regions": [
      { "key": "2407" }   # Buenos Aires
    ]
  }
}

# Toda Argentina:
{
  "geo_locations": {
    "countries": ["AR"]
  }
}

UTMs limpios

UTMs sucios rompen tu analitica para siempre. Una vez que se mete data malformateada, separar reportes despues es manual y caro. Asi los hacemos limpios.

Estructura

Reglas estrictas

• Minusculas. Siempre. Meta y meta son fuentes distintas en GA.
• Hyphens, no underscores. Estandar urls; underscores se interpretan como una sola palabra.
• Sin nombres internos. Nunca claude, remotion, claude-code. Esos nombres no le dicen nada al cliente.
• Sin fechas redundantes. Si el campaign ya tiene mes y año, no lo repitas en content.

Patron URL completa

https://acme.com.ar/landing
  ?utm_source=meta
  &utm_medium=paid_social
  &utm_campaign=acme-marzo-2026-leads
  &utm_content=v1-tof-rate-hikes-news

Troubleshooting

Errores tipicos que vas a ver y como salir de ellos rapido.