Servicio · LinkedIn

LinkedIn Conversions API con Beaconry: OAuth en 30 segundos, 5 slots de regla de conversión

LinkedIn Conversions API necesita cinco cosas: un token OAuth, una Ad-Account ID, y una URN de regla de conversión por cada tipo de evento que quieras trackear. Beaconry maneja el handshake OAuth; el resto es pegar y guardar.

Tiempo de lectura: ~5 minPublicado: 2026-05-02

OAuth en 30 segundos

Haz clic en "Connect with LinkedIn" en Beaconry → Tracking → LinkedIn. LinkedIn muestra una pantalla de consentimiento scoped a rw_conversions + r_ads, apruebas, vuelves a Beaconry con el token guardado cifrado. Tiempo total: unos 30 segundos, sin app del Developer Portal de LinkedIn.

La cuenta que ejecuta el OAuth necesita rol Account-Manager, Campaign-Manager o Account-Billing-Admin sobre la Ad Account. Solo Viewer la API lo rechaza. Si eres una agencia gestionando tracking para clientes, el cliente debe darle el rol a tu cuenta primero.

Ad-Account ID

Abre Campaign Manager, mira la URL en tu navegador. Contiene una pieza como /accounts/512345678. La parte numérica es tu Ad-Account ID. Pégala en Beaconry. El plugin construye el formato URN interno de LinkedIn por sí mismo.

5 slots de regla de conversión

Beaconry mapea los tipos de evento GA4 a cinco slots de LinkedIn. Por cada slot que quieras usar:

  1. Abre Campaign Manager → Measurement → Conversion tracking → Create conversion → Data source: Direct API.
  2. Configura la conversión (nombre, valor, ventana de atribución).
  3. Guarda. La Rule-ID numérica está en la URL.
  4. Pégala en el slot correspondiente en Beaconry.

Los cinco slots, con qué los dispara:

  • Purchase: evento purchase de WooCommerce.
  • Lead: envíos de formulario (Kadence, Fluent). El slot más usado para B2B SaaS.
  • SignUp: hook user-register de WP (activaciones de free trial, registro de cuenta).
  • AddToCart: add_to_cart de WooCommerce, señal de mid-funnel.
  • KeyPageView: 50 % scroll + 10 s engagement en una vista de página, para páginas de alta intención como pricing o comparativa.

Solo configuras los slots que realmente usas. Deja vacíos los demás.

Renovación de token, ciclo 60 días

Los access-tokens de LinkedIn caducan cada 60 días. El heartbeat diario de Beaconry avisa 7 días antes en la pestaña Logs, además envía email al operador si un heartbeat detecta token caducado. Reconectar haciendo clic en "Connect with LinkedIn" otra vez, el handshake OAuth se repite, la configuración se mantiene. Sin re-pegar Conversion-Rule-IDs.

Si estás de vacaciones y el token caduca, el peor caso son 7-30 días de conversiones sin trackear. Beaconry las encola con un marcador "needs-retry"; si reconectas dentro de 30 días, los eventos en cola se reintentan automáticamente. Pasados 30 días la cola caduca y los eventos perdidos se pierden.

Qué se envía

En cada evento que Beaconry envía a LinkedIn:

  • URN de Conversion-Rule que coincide con el tipo de evento.
  • Timestamp de conversión (Unix epoch, UTC).
  • PII hasheada: email SHA-256 + hash de identificador específico LinkedIn (LIPA).
  • li_fat_id de los parámetros URL cuando esté disponible.
  • Idempotency-key por evento, evita doble conteo en reintentos.

El matching de LinkedIn es más sensible al email, tanto identificador específico LinkedIn como SHA-256 estándar. Beaconry envía ambos. La match-rate en audiencias B2B suele estabilizarse en 60-75 % en LinkedIn, materialmente más alta que setups solo de tag de navegador.

Modo híbrido, opcional

El LinkedIn Insight Tag en modo híbrido añade soporte para cookie first-party li_fat_id, lo que puede subir la match-rate otro 10-15 % en prospects engaged-but-not-yet-converting. Para LinkedIn específicamente, el modo híbrido está en la lista de "considéralo" en lugar de "sáltalo" porque las ventanas de funnel B2B son largas y cada punto de match-rate cuenta.

Para llevar

LinkedIn con Beaconry es el más relevante para B2B de los cinco canales. OAuth es rápido, las reglas de conversión mapean limpio, el ciclo de token de 60 días es el único mantenimiento continuo y Beaconry avisa con tiempo. Para B2B SaaS este es a menudo el canal donde el trabajo de match-rate de Beaconry tiene mayor impacto en dólares.