Microsoft Advertising, UET y Conversions API

Subida server-side de conversiones a Bing Ads a través del broker OAuth de Beaconry. El broker guarda el Developer Token central de Microsoft, tú conectas tu cuenta en dos minutos por la pantalla de consentimiento estándar de Microsoft.

Por qué un broker

La API de Microsoft Advertising exige un Developer Token en cada subida de conversión. La aprobación tarda dos a cuatro semanas. Beaconry opera un Cloudflare Worker central (el mismo que se encarga de Google Ads OAuth) que guarda un Developer Token aprobado para ti. Tú conectas tu propia cuenta de Microsoft vía OAuth y el broker hace de proxy de las llamadas OfflineConversions. Los refresh tokens viven en el KV del broker, el plugin solo guarda un site-bearer firmado con HMAC.

Requisitos

• Cuenta de Microsoft Advertising con rol Super Admin o Standard User.
• Cuenta Microsoft (laboral, escolar o personal MSA) que pueda iniciar sesión en Microsoft Advertising.
• Aproximadamente 5 minutos.

1. Conectar con Microsoft Advertising

WordPress Admin → Beaconry → Tracking → Microsoft Ads. Haz clic en Conectar cuenta de Microsoft. Te redirige a login.microsoftonline.com.

Inicia sesión con la cuenta Microsoft que tiene acceso a tus datos de Microsoft Advertising. Aprueba el scope solicitado (msads.manage + offline_access). Microsoft te devuelve a la pestaña Tracking y el broker guarda el refresh-token bajo un site-id opaco. Beaconry guarda solo el site-bearer resultante, cifrado en reposo con AES-256-GCM.

El broker usa Microsoft Identity Platform v2.0 en el endpoint multi-tenant /common, así que funcionan tanto cuentas AAD (laboral, escolar) como MSAs personales, el caso más habitual en Bing Ads.

2. Localizar Customer ID y Account ID

Microsoft Advertising direcciona una cuenta con dos IDs numéricos, ambos obligatorios.

• Abre Microsoft Advertising en ads.microsoft.com.
• Arriba a la derecha en el selector de cuenta aparece tu Customer ID (el scope del cliente padre o cuenta manager).
• Debajo, el Account ID de la cuenta de Bing Ads que ejecuta tus campañas.
• Pega ambos en Beaconry → Customer ID y Account ID en la pestaña Tracking. Ambos son números de 6 a 12 dígitos, Beaconry quita los caracteres de formato automáticamente.

3. Crear objetivos de conversión en Microsoft Ads

Microsoft direcciona conversiones por nombre del objetivo, no por ID numérico. Nombras un objetivo una vez en la UI de Microsoft Advertising y lo referencias como string desde Beaconry.

• Microsoft Advertising → Tools → Conversion tracking → Conversion goals → Crear objetivo.
• Tipo de objetivo: Offline conversion. No "Event" — ese cablea solo el tag UET de navegador.
• Elige una categoría que coincida con el evento (Purchase, Add to cart, Begin checkout, Lead, Subscribe, Schedule, Sign up, Contact).
• Define el modelo de valor y las ventanas de atribución según la recomendación de Microsoft.
• Guarda. Anota el nombre del objetivo exactamente como lo escribiste, Beaconry lo referencia case-sensitive.

4. Mapear los objetivos a los slots de Beaconry

Beaconry tiene ocho slots, uno por tipo de conversión. Pega el nombre del objetivo correspondiente en cada slot que quieras trackear. Deja los demás vacíos.

5. Enviar el evento de prueba

Guarda, haz clic en Enviar evento de prueba de Microsoft Ads. Beaconry dispara una conversión sintética por el broker. HTTP 200 sin errores significa que bearer, IDs y al menos un nombre de objetivo son válidos.

Microsoft Advertising no tiene una vista de prueba en tiempo real comparable a Test Events de Meta. Las conversiones reales aparecen en Tools → Conversion tracking en aproximadamente 3 horas.

Sobre el click identifier

Microsoft requiere un msclkid (Microsoft Click ID) en cada conversión offline para atribuirla al anuncio originario. Los anuncios de búsqueda de Bing añaden ?msclkid=... a cada landing URL automáticamente. Beaconry lo captura en la primera carga de página y lo persiste en la cookie nl_ext junto a gclid, fbclid y ttclid. Conversiones sin msclkid capturado se omiten silenciosamente, así está diseñada la API de Microsoft.

Modo híbrido, tag UET

El modo híbrido carga el tag Universal Event Tracking (UET) de Microsoft en el navegador en paralelo al despacho server-side. Beaconry envía el mismo eventId por evento desde ambos lados para que Microsoft pueda deduplicar (UET soporta deduplicación a nivel de evento desde 2024). Mejor match-rate, algo más de bytes para el visitante. Apagado por defecto.

Activar en Beaconry → Tracking → Microsoft Ads → Modo híbrido. Además introduce el UET Tag ID (el valor numérico que Microsoft muestra en Tools → UET tag).

Qué se envía automáticamente

• Funnel WooCommerce: AddToCart, InitiateCheckout, Purchase, con valor de pedido y moneda.
• Leads de formulario: envíos de Kadence Blocks Form y Fluent Forms mapeados al slot Lead.
• Captura de msclkid desde parámetros de URL en landings de clic-de-anuncio Bing, persistido en nl_ext.
• PII hasheado (email, teléfono) server-side según las guidelines de enhanced-conversions de Microsoft.
• event-IDs estables por pedido para deduplicación en modo híbrido con UET.

Troubleshooting

• "AuthenticationTokenExpired": el broker refresca tokens de acceso automáticamente, pero el refresh-token subyacente caduca tras 90 días de inactividad. Pulsa Desconectar y vuelve a Conectar cuenta de Microsoft. Customer ID, Account ID y los slots de objetivos siguen configurados.
• Conversiones subidas pero el contador no se mueve: el nombre del objetivo en Beaconry no coincide exactamente con el de Microsoft Advertising (case-sensitive, espacios incluidos). Revisa ambos lados.
• "MicrosoftClickId required": el visitante llegó sin msclkid. Visitas directas y visitas desde fuentes que no son Bing no lo tienen, es lo esperado. Solo los clics de anuncios Bing atribuyen.
• "Customer not authorized": la cuenta Microsoft que conectaste no tiene rol en el Customer ID introducido. Reconecta con una cuenta que tenga acceso Super Admin o Standard User sobre ese cliente.