¿Qué es la herramienta Conversions API de LinkedIn?

LinkedIn Conversions API (CAPI) es un endpoint del lado del servidor que permite a tu sitio web o sistema back-end enviar eventos de conversión directamente a LinkedIn sin depender del navegador. Dado que las llamadas provienen de tu servidor, los datos se ven menos afectados por bloqueadores de anuncios, ITP y limitaciones de cookies. La API conecta tu base de datos con Campaign Manager, ayudando a garantizar que se contabilicen más clientes potenciales cualificados o ventas al reducir la pérdida de datos del lado del navegador.

Por qué es importante LinkedIn Conversions API

Vincula pedidos telefónicos, etapas del CRM o ventas en tienda física a tus campañas para obtener una visión completa.
Señales más ricas ayudan a LinkedIn a reducir el CPA automáticamente. Los anunciantes que usan CAPI reportan +31 % de conversiones atribuidas, −20 % de CPA y −39 % de coste por cliente potencial cualificado en promedio.
Las llamadas del servidor sobreviven a las restricciones del navegador que pueden bloquear el LinkedIn Insight Tag.
Elige exactamente qué campos hasheados se comparten (SHA256_EMAIL, UUID de seguimiento propio o identificadores de identidad de terceros como ACXIOM_ID y ORACLE_MOAT_ID).
El hashing SHA-256 del lado del servidor, la retención de datos de 180 días y los controles de preferencias publicitarias del miembro simplifican el cumplimiento del RGPD, CCPA y leyes de privacidad similares.
Las actualizaciones casi en tiempo real llegan antes a Campaign Manager, permitiendo que las estrategias de puja se adapten antes de que se desperdicie el presupuesto.

Los equipos SaaS usan CAPI para transmitir eventos SQL. Las tiendas de comercio electrónico envían ingresos netos. Los profesionales del marketing B2B sincronizan datos de webinars y ferias comerciales. Para la automatización del embudo de ventas y la optimización de campañas en LinkedIn, consulta la LinkedIn Automated Marketing Funnel: Sales Funnel Automation Guide.

Cómo funciona LinkedIn Conversions API

Lado del cliente vs. lado del servidor:

Píxel: el navegador recopila datos de clics/vistas; susceptible a bloqueadores.
API: tu servidor envía JSON mediante POST al endpoint /rest/conversionEvents de LinkedIn usando un token de acceso OAuth2 (con los alcances rw_conversions y r_ads) y cuatro encabezados obligatorios: Authorization: Bearer {token}, X-Restli-Protocol-Version: 2.0.0, LinkedIn-Version: {yyyymm} y Content-Type: application/json.

Los eventos de conversión deben tener una marca temporal conversionHappenedAt dentro de los últimos 90 días. Las ventanas de atribución retrospectiva pueden configurarse a 1, 7, 30 o 90 días; las ventanas de 365 días están disponibles para los tipos de conversión Lead, Qualified Lead, Purchase, Submit Application y Add to Cart.

Configuración paso a paso

Crear una regla de conversión — en Campaign Manager ve a Measurement → Conversion tracking → Create conversion → Conversions API. Nombra la regla, elige un tipo de conversión (Lead, Purchase, Sign Up, etc.), establece un método de valor (dinámico, fijo o ninguno) y configura las ventanas de atribución.
Elegir una vía de integración — conéctate a través de un partner (Adobe, HubSpot, Google Tag Manager, Zapier, Segment, Tealium y otros) o construye una integración directa contra la REST API de LinkedIn. Las configuraciones con partners suelen ser de una sola vez; las integraciones directas tardan de 2 a 4 semanas en promedio y ofrecen control total sobre el payload.
Generar un token de acceso OAuth2 — tu aplicación necesita los alcances rw_conversions y r_ads. El propietario del token debe tener el rol de Account Manager, Campaign Manager o Billing Admin en la cuenta publicitaria.
Asociar campañas — adjunta la regla de conversión a cada campaña que deba recibir crédito. Usa autoAssociationType=ALL_CAMPAIGNS al crear la regla, o asocia manualmente mediante PUT /rest/campaignConversions.
Transmitir eventos — envía cada conversión mediante POST a /rest/conversionEvents con el URN de conversión, una marca temporal en milisegundos, al menos un identificador de usuario y un eventId opcional para deduplicación.

Claves de coincidencia de usuarios

LinkedIn resuelve eventos a miembros utilizando los identificadores que envías en el array userIds:

SHA256_EMAIL — email en minúsculas, sin espacios, hasheado con SHA-256.
LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — el parámetro de clic li_fat_id capturado cuando el seguimiento de conversiones mejorado está habilitado.
ACXIOM_ID — grafo de identidad de LiveRamp.
ORACLE_MOAT_ID — grafo de identidad de Oracle MOAT.
Si ninguno de los anteriores está disponible, envía firstName + lastName (y opcionalmente companyName, title, countryCode) en el objeto userInfo.

Enviar múltiples identificadores por evento aumenta las tasas de coincidencia. Solo los eventos coincidentes cuentan para la atribución y la optimización.

Tipos de conversión admitidos

LinkedIn acepta más de 30 tipos de conversión, incluyendo Add to Cart, Download, Install, Key Page View, Lead, Purchase, Sign Up, Start Checkout, Subscribe, Qualified Lead, Submit Application, Phone Call, Book Appointment, Request Quote y otros. La lista completa está documentada en la referencia de la Marketing API.

Deduplicación

Si ejecutas tanto el Insight Tag como CAPI, LinkedIn puede deduplicar automáticamente. Envía la misma cadena eventId tanto con el evento del lado del cliente como con el del lado del servidor para que LinkedIn reconozca el duplicado y lo cuente una sola vez.

Límites de frecuencia

600 solicitudes por minuto por token.
300.000 solicitudes por día por token.
El endpoint de lotes acepta hasta 5.000 eventos en un solo POST (usa el encabezado X-RestLi-Method: BATCH_CREATE).

Mejores prácticas

Envía eventos en tiempo real. Los datos retrasados pueden quedar fuera de la ventana de atribución o perder el ciclo de optimización.
Incluye tantos parámetros de coincidencia como sea posible. Más identificadores significan tasas de coincidencia más altas y mejor calidad de señal.
Habilita el seguimiento mejorado de primera parte en Campaign Manager para que LinkedIn añada li_fat_id a las URLs de las páginas de destino. Captura y reenvía este UUID con cada evento de conversión.
Configura ventanas de atribución amplias. LinkedIn recomienda 90 días de clic / 90 días de vista para conversiones de generación de leads y de parte inferior del embudo. Para ciclos de venta B2B largos, usa la ventana de 365 días en los tipos Lead, Qualified Lead, Purchase, Submit Application y Add to Cart.
Asigna valores de conversión. Incluso valores estáticos de referencia permiten a Campaign Manager calcular el ROAS y destacar audiencias de alto valor.
Asocia las conversiones con todas las campañas relevantes. Las campañas no vinculadas no pueden recibir crédito de atribución.
Usa solicitudes por lotes para cargas masivas. Migrar datos históricos del CRM o sincronizar exportaciones nocturnas es más rápido y fiable en lotes de hasta 5.000 eventos.
Supervisa la página de Conversion Tracking en Campaign Manager para alertas de estado y verifica que los eventos estén llegando y coincidiendo.

Consejos adicionales

Combina CAPI con el Insight Tag en lugar de reemplazarlo. Las señales redundantes llenan los vacíos cuando un canal pierde eventos, y LinkedIn deduplica automáticamente.
Usa el contenedor del lado del servidor de Google Tag Manager para reenviar eventos web a CAPI sin escribir código personalizado; LinkedIn proporciona una plantilla oficial de GTM.
Comparte reglas de conversión probadas entre cuentas publicitarias a través de Business Manager para que cada equipo use el mismo marco de medición.
Hashea los emails en tu servidor antes de que salgan de tu red. El pre-hashing mantiene los datos personales sin procesar fuera de los registros y del tránsito.
Renueva tu token OAuth antes de que expire. Un token caducado descarta eventos de forma silenciosa hasta que alguien nota el vacío en Campaign Manager.
Prueba tu payload con la herramienta Payload Builder de LinkedIn en linkedin.com/developers/payload-builder antes de pasar a producción.