Google Ads, Conversion Tracking y CAPI

Subidas de conversión server-side vía la Google Ads API, abstraídas por el broker Phase-2 de Beaconry. Te saltas las cuatro a seis semanas de aprobación del developer-token y vas en vivo el mismo día.

Por qué un broker

Google Ads exige un developer-token en cada llamada API que sube conversiones. Conseguir uno aprobado conlleva una solicitud de basic-access con Google y luego una solicitud para escalar a standard-access. Suele tardar de cuatro a seis semanas de ida y vuelta.

Beaconry corre un Cloudflare Worker central (el "broker Phase-2") que mantiene el developer-token aprobado de Beaconry. Los clientes conectan su cuenta de Ads vía OAuth. El broker proxea las llamadas de upload pero nunca ve tus datos de conversión: reenvía el cuerpo cifrado y rate-limita por cliente. Los refresh-tokens permanecen cifrados en tu base de datos de WordPress.

Resultado: conectas vía OAuth en dos minutos, en vez de esperar la aprobación de Google durante más de un mes.

Requisitos

• Una cuenta de Google Ads sobre la que tengas acceso de Admin o "Edit".
• Aproximadamente 5 a 10 minutos (la mayoría se va en crear las Conversion Actions en Campaign Manager).

1. Conectar con Google

WordPress Admin → Beaconry → Tracking → Google Ads. Haz clic en Conectar con Google. Te redirige a la pantalla de consentimiento OAuth de Google.

Aprueba el scope solicitado (adwords). Google te redirige de vuelta a la pestaña Tracking con el access-token y el refresh-token guardados automáticamente (cifrados en reposo).

2. Encontrar tu Customer ID

• Abre Google Ads en ads.google.com.
• Esquina superior derecha muestra tu Customer ID, como 123-456-7890.
• Pégalo en Beaconry → Customer ID. Beaconry quita los guiones automáticamente.

3. Crear Conversion Actions en Campaign Manager

Necesitas una Conversion Action por cada tipo de evento que quieras trackear. Beaconry mapea los nombres de eventos GA4 a categorías de Google Ads.

Para cada tipo de evento:

• Tools and Settings → Measurement → Conversions → New conversion action.
• Source: Website.
• Categoría: la que corresponda (ver tabla más abajo).
• Define Value, Count, Click-through window según las recomendaciones de Google.
• Guarda. La URL de detalle de la Conversion Action contiene el ID, como ...#?conversionTypeId=1234567890&ocid=98765.
• Pega la URL completa en el slot correspondiente de Beaconry.

Mapeo evento → categoría:

4. (Atajo) Importar desde GA4

Si tu propiedad GA4 ya tiene esos eventos marcados como conversiones, puedes importarlos en Google Ads en lugar de recrear cada uno:

• Tools → Conversions → + New conversion action.
• En la siguiente página (paso 2 del wizard) baja y haz clic en Atrás. Aterrizas en el paso 1 "Select data sources".
• Selecciona Google Analytics 4.
• De vuelta en el paso 2, abajo aparece la sección "Import multiple conversion actions from an existing Google Analytics property". Selecciona la propiedad e importa los eventos (purchase, generate_lead, sign_up, contact).

5. Enviar el evento de prueba

Guarda el formulario, haz clic en Enviar evento de prueba de Google Ads. El broker valida el token OAuth y el Customer ID. HTTP 200 significa que la conexión funciona. La conversión aparece en Campaign Manager en ~3 horas. Google no tiene una vista de prueba en tiempo real para la API.

6. (Opcional) Enhanced Conversions

Beaconry hashea email y teléfono server-side y los envía como datos de Enhanced Conversions junto a cada upload. Sube notablemente el match-rate cuando el visitante no acepta la cookie de Google Ads. No requiere setup adicional, es automático mientras token y Customer ID estén configurados.

Qué se envía automáticamente

• WooCommerce: AddToCart, InitiateCheckout, Purchase. Valor del pedido y moneda incluidos.
• Forms: generate_lead, submit_application, subscribe, book, sign_up, contact (mapeados por form-type).
• gclid / wbraid / gbraid capturados de los parámetros URL y persistidos en nl_ext. Imprescindibles para la atribución click-a-conversión de Google.

Troubleshooting

• "PERMISSION_DENIED": tu cuenta de Google no tiene permisos sobre el Customer ID. Usa una cuenta con rol Admin o "Standard".
• "INVALID_ARGUMENT, conversion_action": la URL de la Conversion Action se pegó mal. La URL debe contener conversionTypeId.
• "Conversión subida pero no visible": hasta 3 horas de latencia es normal. Pasado ese tiempo, en Campaign Manager → Tools → Conversions → columna Status.
• "User-rejected token": el refresh-token fue revocado por el usuario (clic en Disconnect o rotación de password Google). Vuelve a hacer clic en Conectar con Google, el resto de la configuración se mantiene.