← Volver al catálogo

🔌 Google Ads — conexión API (PROYECTO EN PAUSA)

Estado: ⏸️ EN PAUSA — retomar cuando Google apruebe el Developer Token.

Dónde nos quedamos (2026-06-05)

Objetivo: conectar Google Ads al panel para leer/controlar/crear campañas (igual que Meta).

Bloqueo: para usar la API hace falta un Developer Token, que solo se pide desde el API Center, y el API Center solo existe en una cuenta Administrador (MCC).

Hallazgos de la cuenta del usuario (login [email protected]):

  • 997-962-1366 — cuenta normal, "Configuración en curso". Tiene 1 campaña: Performance Max-1 (en pausa, 14 €/día, desde 2021).
  • 309-773-7925 — "Everest" (cancelada).
  • 272-434-3291 — cuenta ADMINISTRADOR (MCC), "Config. en curso" ← desde aquí se saca el Developer Token.
  • No se puede crear una MCC nueva: "límite de creación de cuentas de administrador" alcanzado.

Pasos para retomar

1. Entrar en la cuenta Administrador 272-434-3291.

2. Herramientas 🔧 → Configuración → API Center → solicitar/copiar el Developer Token (Google aprueba en ~1 día; con acceso de test ya se leen las propias campañas).

3. Conseguir Customer ID de la cuenta con campañas (997-962-1366).

4. OAuth con scope adwords: el Google OAuth actual del panel es SOLO calendar (verificado) → hay que reautorizar con scope adwords y guardar un refresh token nuevo.

5. Guardar en ~/rifkings-control-center/.env.local: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CUSTOMER_ID, GOOGLE_ADS_LOGIN_CUSTOMER_ID (= la MCC 272-434-3291), + OAuth.

6. Construir el panel Google igual que Meta (lib + rutas + panel; la pestaña ya existe como stub).

✅ TURNKEY — cuando me digas "Google listo", se crea SIN reempezar nada

Toda la estrategia está convertida en datos + script ejecutable. Solo falta enchufar credenciales y correr 1 comando:

1. Pegar en ~/rifkings-control-center/.env.local: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CUSTOMER_ID (997-962-1366), GOOGLE_ADS_LOGIN_CUSTOMER_ID (272-434-3291), y OAuth GOOGLE_ADS_CLIENT_ID/CLIENT_SECRET/REFRESH_TOKEN (scope adwords).

2. cd ~/rifai-agents && npm i google-ads-api

3. npx tsx tools/google-ads-launch.ts → crea las 4 campañas (Search+PMax de autoradios y patinetes) EN PAUSA. (--activar para encender, solo con tu OK.)

  • Estrategia como datos: proyectos/campanas/google-ads-config.json (campañas, keywords, RSAs, negativas, presupuestos, pujas). Editar AHÍ si se quiere cambiar algo — nunca se reescribe la estrategia.
  • Script: tools/google-ads-launch.ts (lee la config y crea todo).
  • Creatividades/ángulos: campanas/autoradios.md, campanas/patinetes.md, campanas/creatividades-guiones.md, campanas/calidad-cliente-cod.md.

Falta solo el OAuth con scope adwords (el actual es solo Calendar) — al obtener el Developer Token montamos ese refresh token y el script ya tiene todo lo demás.