LinkedIn, Insight Tag y Conversions API

Tracking server-side de conversiones para LinkedIn Ads. Cada tipo de evento necesita su propia Conversion-Rule URN creada en Campaign Manager. El plugin mapea eventos GA4 a cinco slots: Purchase, Lead, SignUp, AddToCart, KeyPageView.

Lo que necesitas

• Una cuenta de LinkedIn con rol Account-Manager, Campaign-Manager o Account-Billing-Admin sobre la Ad Account cuyas conversiones quieres rastrear. El rol Viewer-only es rechazado por la API.
• Unos 5 a 10 minutos.

1. Conectar con LinkedIn

WordPress Admin, Beaconry, Tracking, LinkedIn. Pulsa Conectar con LinkedIn. Te redirige a LinkedIn.

Inicia sesión con la cuenta de LinkedIn que tiene acceso a la Ad Account. LinkedIn muestra una pantalla de consentimiento para "Beaconry" pidiendo los scopes rw_conversions y r_ads. Aprueba. LinkedIn te redirige de vuelta a esta página con el access-token guardado automáticamente.

2. Buscar tu Ad-Account ID

Abre Campaign Manager (linkedin.com/campaignmanager) y elige la Ad Account que quieres rastrear. Mira la URL en el navegador: contiene un trozo como /accounts/512345678. La parte numérica (aquí: 512345678) es tu Ad-Account ID.

Copia el número en Beaconry, Ad-Account ID. El plugin construye el formato URN interno de LinkedIn por su cuenta.

3. Crear una Conversion Rule por tipo de evento

Campaign Manager, Measurement, Conversion tracking, Create conversion, Data source: Direct API. Crea una Conversion Rule por cada tipo de evento que quieras rastrear.

Beaconry mapea eventos GA4 a cinco slots de LinkedIn:

4. Pegar los Rule IDs en Beaconry

Tras guardar cada Conversion Rule en Campaign Manager, el Rule-ID numérico aparece en la URL. Pégalo en el slot correspondiente de Beaconry. Solo necesitas slots para los eventos que de verdad quieres rastrear. Deja los demás vacíos.

5. Enviar el evento de prueba

Guarda el formulario y pulsa Enviar evento de prueba LinkedIn. HTTP 201 significa que las credenciales y el URN son válidos. El contador de conversiones en Campaign Manager se actualiza en unas 3 horas. LinkedIn no tiene una vista de prueba en tiempo real.

6. (Opcional) Insight Tag en modo híbrido

El modo híbrido carga el LinkedIn Insight Tag en el navegador junto con el despacho server-side. Mejor match-rate porque LinkedIn ve la cookie first-party li_fat_id del visitante. Desactivado por defecto, el server-side por sí solo cubre el 100 por ciento de los visitantes con consentimiento.

Renovación del token

El access-token de LinkedIn caduca tras 60 días. La pestaña Logs de Beaconry recibe un heartbeat diario más un aviso cuando quedan 7 días. Vuelve a pulsar Conectar con LinkedIn para renovar. Tus Conversion-Rule-IDs y el Ad-Account-ID se quedan configurados. Solo se vuelve a hacer el handshake OAuth.

Qué se envía automáticamente

• li_fat_id capturado de los parámetros URL en landings desde clic de anuncio, persistido en nl_ext.
• PII hasheada (email, teléfono) enviada server-side según las matching guidelines de LinkedIn.
• Idempotency key por evento para que los reintentos no duplican el conteo.

Modo Plan-B (pegar access-token manual)

Si el flujo OAuth centralizado de Beaconry no está configurado en esta instalación (la constante BCNR_LINKEDIN_OAUTH_CLIENT_ID está vacía), puedes pegar un access-token emitido manualmente desde el Developer Portal de LinkedIn. La pestaña Tracking muestra los campos manuales cuando OAuth no está disponible.

Los tokens manuales también caducan tras 60 días, pero puedes usar un flujo de Refresh-Token dentro del Developer Portal de LinkedIn para extender.

Troubleshooting

• "403 Forbidden". Tu cuenta de LinkedIn no tiene permisos sobre la Ad Account. Usa una cuenta con al menos rol Campaign-Manager.
• "422 Invalid conversion". El Rule ID no existe en esta Ad Account, o la rule está pausada. Vuelve a comprobar Campaign Manager, Conversion tracking.
• Contador parado. La latencia de tres horas es normal. Tras tres horas, comprueba la pestaña Logs en Beaconry para ver HTTP 201s.