Toda la documentación

LinkedIn Insight Tag + Conversions API — Documentación

LinkedIn Insight Tag + Conversions API conecta su tienda PrestaShop con LinkedIn Campaign Manager para que pueda medir LinkedIn Ads a partir de acciones reales en la tienda: visualizaciones de productos, carritos, inicios de checkout, registros, búsquedas, listas de deseos y compras.

Funciones

  • Inyección del Insight Tag. El módulo carga el Insight Tag de LinkedIn en el navegador desde displayHeader, sin editar las plantillas del tema.
  • Seguimiento de eventos de ecommerce. Realiza seguimiento de PageView, ViewContent, AddToCart, StartCheckout, Purchase, Search, AddToWishlist y SignUp cuando los interruptores de evento correspondientes están activados.
  • Hooks de conversión de pedidos. El seguimiento de compras se ejecuta desde displayOrderConfirmation y actionValidateOrder, con valor del pedido, moneda y un ID de evento estable.
  • Cobertura de Add-to-cart. Los eventos Add-to-cart se detectan desde el bus de eventos JavaScript updateCart de PrestaShop y desde los botones clásicos Add-to-cart.
  • Cobertura de listas de deseos. Las acciones de añadir a la lista de deseos se detectan desde botones wishlist comunes y WishlistEventBus cuando el tema o el módulo wishlist lo expone.
  • Reglas de conversión por evento. Cada evento estándar puede usar su propio ID de regla de conversión de LinkedIn Campaign Manager.
  • Cola de Conversions API. Los eventos del lado del servidor se almacenan en la tabla compartida mpr_conversion_queue bajo el proveedor linkedin y se procesan mediante la tarea programada send_linkedin_conversions.
  • Deduplicación en navegador y servidor. Se usan IDs de evento coincidentes para que LinkedIn pueda deduplicar las versiones de navegador y Conversions API de la misma conversión.
  • Reglas de eventos personalizados. Las reglas de clic, URL, controlador/módulo y evento DOM permiten medir botones de solicitud de presupuesto, formularios, descargas, pasos de configurador u otras señales de intención específicas de la tienda.
  • Controles de consentimiento y personal. El seguimiento puede esperar el consentimiento de marketing de cookies MPR y puede evitar inyectar tracking para empleados conectados al back office mientras navegan por el storefront.
  • Diagnósticos de back-office. La página de configuración muestra Partner ID, Purchase conversion rule y preparación de Conversions API, conteos de cola, filas recientes de cola, una prueba API y una acción para reintentar eventos fallidos.
LinkedIn Insight Tag + Conversions API — Linkedin insight audience LinkedIn Insight Tag + Conversions API — Admin config events

Opciones de configuración

  • Enable LinkedIn Insight Tag. Interruptor principal para el seguimiento de LinkedIn en el navegador; valor predeterminado: 0.
  • Partner ID. LinkedIn Partner ID numérico desde Campaign Manager > Account Assets > Insight Tag; valor predeterminado: ``.
  • Exclude employees. Evita la inyección de tracking mientras un empleado conectado al back office navega por el front office; valor predeterminado: 1.
  • Respect cookie consent. Espera el consentimiento de marketing de mprcookiesrevolution o mprcookiebanner cuando cualquiera de los módulos está activo; valor predeterminado: 1.
  • Track PageView. Envía el evento básico de visita de página después de que se cargue el Insight Tag; valor predeterminado: 1.
  • Track ViewContent. Realiza seguimiento de vistas de página de detalle de producto con ID de producto, nombre, categoría, precio y moneda; valor predeterminado: 1.
  • Track AddToCart. Realiza seguimiento de acciones Add-to-cart nativas y AJAX; valor predeterminado: 1.
  • Track StartCheckout. Realiza seguimiento de la entrada al checkout con valor del carrito, número de artículos, moneda y líneas de artículos; valor predeterminado: 1.
  • Track Purchase. Realiza seguimiento de pedidos completados desde hooks de confirmación y validación de pedido; valor predeterminado: 1.
  • Track Search. Realiza seguimiento de páginas de resultados de búsqueda cuando hay una consulta presente; valor predeterminado: 1.
  • Track AddToWishlist. Realiza seguimiento de acciones de añadir a wishlist desde botones wishlist comunes y buses de eventos; valor predeterminado: 1.
  • Track SignUp. Marca la creación de una nueva cuenta de cliente y envía el evento de registro en la siguiente carga de la página de cuenta de cliente; valor predeterminado: 1.
  • ViewContent conversion ID. ID de regla de conversión de LinkedIn para eventos de vista de producto; valor predeterminado: ``.
  • AddToCart conversion ID. ID de regla de conversión de LinkedIn para eventos Add-to-cart; valor predeterminado: ``.
  • StartCheckout conversion ID. ID de regla de conversión de LinkedIn para eventos de inicio de checkout; valor predeterminado: ``.
  • Purchase conversion ID. ID de regla de conversión de LinkedIn para eventos de compra; valor predeterminado: ``.
  • Search conversion ID. ID de regla de conversión de LinkedIn para eventos de búsqueda; valor predeterminado: ``.
  • AddToWishlist conversion ID. ID de regla de conversión de LinkedIn para eventos wishlist; valor predeterminado: ``.
  • SignUp conversion ID. ID de regla de conversión de LinkedIn para eventos de creación de cuenta; valor predeterminado: ``.
  • Track custom events. Activa el campo JSON de reglas de eventos personalizados; valor predeterminado: 0.
  • Custom event rules. Array JSON de reglas personalizadas de clic, URL, controlador o evento DOM; valor predeterminado: ``.
  • Enable Conversions API events. Pone en cola eventos elegibles con IDs de reglas de conversión para envío del lado del servidor a LinkedIn; valor predeterminado: 0.
  • Conversions API access token. Token de LinkedIn Conversions API usado para la entrega del lado del servidor; valor predeterminado: ``.
  • LinkedIn API version. Versión de LinkedIn Marketing API en formato YYYYMM; valor predeterminado: 202605.
  • Send IP address match key. Envía la dirección IPv4 como clave de coincidencia de LinkedIn cuando se crean eventos Conversions API; valor predeterminado: 1.
  • Queue batch limit. Máximo de eventos de LinkedIn en cola procesados por ejecución, de 1 a 100; valor predeterminado: 20.
LinkedIn Insight Tag + Conversions API — Linkedin insight purchase path LinkedIn Insight Tag + Conversions API — Admin integrity page

Ejemplos de personalización

Los IDs de reglas de conversión de LinkedIn pueden introducirse como un ID numérico simple o como la URN completa de LinkedIn. El módulo almacena internamente la parte numérica.

12345678
urn:lla:llaPartnerConversion:12345678

Regla de clic personalizada para un botón de solicitud de presupuesto:

[
  {
    "event": "QuoteRequest",
    "conversion_id": "12345678",
    "trigger": "click",
    "selector": ".quote-request-button",
    "params": {
      "location": "product_page"
    },
    "capi": true
  }
]

Los parámetros adicionales pueden colocarse directamente en el elemento clicado:

<a class="quote-request-button"
   data-linkedin-param-location="product"
   data-mprlnin-param-product_id="123">
  Request a quote
</a>

Regla personalizada basada en URL para una descarga de catálogo o página de presupuesto:

[
  {
    "event": "QuotePageView",
    "conversion_id": "12345678",
    "trigger": "url",
    "contains": ["/request-a-quote"],
    "once": true,
    "capi": true
  }
]

Regla de controlador/módulo para una página de módulo de checkout:

[
  {
    "event": "CustomCheckoutStep",
    "conversion_id": "12345678",
    "trigger": "controller",
    "controllers": ["checkout"],
    "modules": ["mprcheckoutrevolution"],
    "params": {
      "step": "checkout"
    },
    "once": true,
    "capi": true
  }
]

Regla de evento DOM para integraciones JavaScript:

[
  {
    "event": "GalleryView",
    "conversion_id": "12345678",
    "trigger": "event",
    "dom_event": "mpr:gallery:view",
    "capi": true
  }
]

document.dispatchEvent(new CustomEvent('mpr:gallery:view', {
  detail: {
    params: {
      gallery: 'main',
      product_id: '123'
    }
  }
}));

También puede llamar al helper del storefront después de que el módulo se haya cargado. Para un nombre de evento personalizado, incluya conversion_id, salvo que el nombre del evento coincida con una de las asignaciones integradas de Conversion ID.

window.mprlninTrackCustom('DemoRequest', {
  conversion_id: '12345678',
  product_id: '123',
  currency: 'USD'
}, {
  capi: true
});

Si ejecuta manualmente el sistema cron compartido, la tarea de cola de LinkedIn se registra como:

send_linkedin_conversions
schedule: every:300
provider: linkedin
table: _DB_PREFIX_ + mpr_conversion_queue
LinkedIn Insight Tag + Conversions API — Linkedin consent attribution LinkedIn Insight Tag + Conversions API — Storefront source insight tag

Instalación

  1. Descargue el ZIP del módulo desde su cuenta de mypresta.rocks.
  2. En el back office de PrestaShop, vaya a Modules > Module Manager.
  3. Haga clic en Upload a module y seleccione el archivo ZIP.
  4. Después de la instalación, abra la página de configuración del módulo.
  5. Añada su LinkedIn Partner ID, active el seguimiento, guarde y luego añada los IDs de reglas de conversión que quiere que LinkedIn Campaign Manager contabilice.
  6. Si utiliza Conversions API, añada el token de acceso, guarde, envíe la prueba API y compruebe que el panel de diagnóstico informa del estado esperado.
LinkedIn Insight Tag + Conversions API — Linkedin conversion endpoint

Cómo funciona en su tienda

Después de la configuración, los visitantes no ven ningún widget nuevo en el storefront. El módulo añade LinkedIn Insight Tag y listeners de eventos en la cabecera de la página, captura el parámetro de clic li_fat_id cuando LinkedIn lo envía y asigna la actividad de PrestaShop a eventos de LinkedIn.

En el back office verá los interruptores de seguimiento, los campos de reglas de conversión, el campo JSON de eventos personalizados y los diagnósticos de Conversions API. Los estados de cola se muestran como pending, sending, sent y failed; los eventos fallidos pueden devolverse a la cola pending desde la página del módulo.

LinkedIn Insight Tag + Conversions API — Admin config consent

Límites claros

Los informes de LinkedIn dependen de los datos de LinkedIn Campaign Manager. El módulo solo puede enviar eventos después de que proporcione el Partner ID correcto, los IDs de reglas de conversión y, para la entrega del lado del servidor, un token válido de Conversions API.

Los ajustes de consentimiento se respetan para los módulos de cookies MPR compatibles. Si otra herramienta de consentimiento bloquea scripts de una forma diferente, puede necesitar un evento personalizado o una integración de consentimiento.

Conversions API mejora la entrega de eventos, pero LinkedIn sigue necesitando datos de coincidencia utilizables, como click ID, datos de cliente con hash o dirección IPv4 cuando su política lo permita. Los eventos de servidor sin identificadores de coincidencia utilizables pueden ser rechazados o no mejorar la atribución.

Los eventos personalizados necesitan selectores, URLs, nombres de controlador o eventos DOM estables. Si un tema cambia las clases de los botones o un módulo de terceros sustituye el marcado del checkout, actualice la regla personalizada para que coincida con la nueva página.

LinkedIn Insight Tag + Conversions API — Admin config conversions api

Preguntas frecuentes

¿Necesito Conversions API?
El Insight Tag del navegador es suficiente para datos demográficos del sitio web y retargeting básico. Conversions API se recomienda cuando la atribución de LinkedIn Ads es importante, especialmente para informes de compras.

¿Los eventos de navegador y servidor pueden contarse por duplicado?
El módulo usa IDs de evento coincidentes para que LinkedIn pueda deduplicar las versiones de navegador y servidor de la misma conversión.

¿Puede seguir la navegación por galerías o botones de presupuesto?
Sí. Use eventos personalizados con disparadores de selector, URL, controlador/módulo o evento JavaScript.

¿Funciona con Checkout Revolution?
Sí. Se realiza seguimiento de los eventos nativos de inicio de checkout y compra, y las interacciones adicionales del módulo de checkout pueden mapearse como eventos personalizados.

¿Qué ocurre si LinkedIn rechaza un evento de servidor?
El evento permanece en la cola con su código HTTP y el último error. Los eventos fallidos pueden reintentarse desde la página de configuración del módulo.

Compatibilidad: PrestaShop 1.6 a 9.0 (última versión), PHP 7.1+. Seguimos dando soporte a las próximas versiones de PrestaShop.

LinkedIn Insight Tag + Conversions API — Admin config credentials
Volver arriba