LinkedIn Insight Tag + Conversions API

LinkedIn Insight Tag + Conversions API collega il suo negozio PrestaShop a LinkedIn Campaign Manager, così può misurare LinkedIn Ads sulla base di azioni reali nel negozio: visualizzazioni prodotto, carrelli, avvii del checkout, registrazioni, ricerche, wishlist e acquisti.

Funzionalità

Inserimento dell’Insight Tag. Il modulo carica l’Insight Tag browser di LinkedIn da displayHeader, senza modificare i template del tema.
Tracciamento degli eventi e-commerce. Traccia PageView, ViewContent, AddToCart, StartCheckout, Purchase, Search, AddToWishlist e SignUp quando i relativi interruttori evento sono abilitati.
Hook di conversione degli ordini. Il tracciamento degli acquisti viene eseguito da displayOrderConfirmation e actionValidateOrder, con valore dell’ordine, valuta e un ID evento stabile.
Copertura Add-to-cart. Gli eventi Add-to-cart vengono rilevati dal bus eventi JavaScript updateCart di PrestaShop e dai classici pulsanti Add-to-cart.
Copertura wishlist. Gli inserimenti in wishlist vengono rilevati dai comuni pulsanti wishlist e da WishlistEventBus quando il tema o il modulo wishlist lo espone.
Regole di conversione per evento. Ogni evento standard può usare il proprio ID regola di conversione LinkedIn Campaign Manager.
Coda Conversions API. Gli eventi lato server vengono salvati nella tabella condivisa mpr_conversion_queue sotto il provider linkedin ed elaborati dall’attività pianificata send_linkedin_conversions.
Deduplicazione browser e server. Vengono usati ID evento corrispondenti, così LinkedIn può deduplicare le versioni browser e Conversions API della stessa conversione.
Regole per eventi personalizzati. Regole su clic, URL, controller/modulo ed evento DOM consentono di misurare pulsanti di richiesta preventivo, form, download, passaggi del configuratore o altri segnali di intenzione specifici del negozio.
Controlli su consenso e personale. Il tracciamento può attendere il consenso marketing dei cookie MPR e può evitare l’inserimento del tracking per i dipendenti connessi al back office mentre navigano nello storefront.
Diagnostica back-office. La pagina di configurazione mostra Partner ID, Purchase conversion rule e stato di preparazione di Conversions API, conteggi della coda, righe recenti della coda, un test API e un’azione per ritentare gli eventi non riusciti.

LinkedIn Insight Tag + Conversions API — Linkedin insight audience

LinkedIn Insight Tag + Conversions API — Admin config events

Opzioni di configurazione

Enable LinkedIn Insight Tag. Interruttore principale per il tracciamento LinkedIn nel browser; predefinito: 0.
Partner ID. LinkedIn Partner ID numerico da Campaign Manager > Account Assets > Insight Tag; predefinito: ``.
Exclude employees. Impedisce l’inserimento del tracking mentre un dipendente connesso al back office naviga nel front office; predefinito: 1.
Respect cookie consent. Attende il consenso marketing da mprcookiesrevolution o mprcookiebanner quando uno dei due moduli è attivo; predefinito: 1.
Track PageView. Invia l’evento base di visita pagina dopo il caricamento dell’Insight Tag; predefinito: 1.
Track ViewContent. Traccia le visualizzazioni delle pagine dettaglio prodotto con ID prodotto, nome, categoria, prezzo e valuta; predefinito: 1.
Track AddToCart. Traccia le azioni Add-to-cart native e AJAX; predefinito: 1.
Track StartCheckout. Traccia l’ingresso nel checkout con valore del carrello, numero articoli, valuta e righe articolo; predefinito: 1.
Track Purchase. Traccia gli ordini completati dagli hook di conferma e validazione ordine; predefinito: 1.
Track Search. Traccia le pagine dei risultati di ricerca quando è presente una query; predefinito: 1.
Track AddToWishlist. Traccia le azioni di aggiunta alla wishlist da pulsanti wishlist comuni e bus eventi; predefinito: 1.
Track SignUp. Segna la creazione di un nuovo account cliente e invia l’evento di registrazione al successivo caricamento della pagina account cliente; predefinito: 1.
ViewContent conversion ID. ID regola di conversione LinkedIn per gli eventi di visualizzazione prodotto; predefinito: ``.
AddToCart conversion ID. ID regola di conversione LinkedIn per gli eventi Add-to-cart; predefinito: ``.
StartCheckout conversion ID. ID regola di conversione LinkedIn per gli eventi di avvio checkout; predefinito: ``.
Purchase conversion ID. ID regola di conversione LinkedIn per gli eventi di acquisto; predefinito: ``.
Search conversion ID. ID regola di conversione LinkedIn per gli eventi di ricerca; predefinito: ``.
AddToWishlist conversion ID. ID regola di conversione LinkedIn per gli eventi wishlist; predefinito: ``.
SignUp conversion ID. ID regola di conversione LinkedIn per gli eventi di creazione account; predefinito: ``.
Track custom events. Abilita il campo JSON per le regole evento personalizzate; predefinito: 0.
Custom event rules. Array JSON di regole personalizzate per clic, URL, controller o eventi DOM; predefinito: ``.
Enable Conversions API events. Mette in coda gli eventi idonei con ID regole di conversione per l’invio lato server a LinkedIn; predefinito: 0.
Conversions API access token. Token LinkedIn Conversions API usato per la consegna lato server; predefinito: ``.
LinkedIn API version. Versione LinkedIn Marketing API nel formato YYYYMM; predefinito: 202605.
Send IP address match key. Invia l’indirizzo IPv4 come chiave di corrispondenza LinkedIn quando vengono creati eventi Conversions API; predefinito: 1.
Queue batch limit. Numero massimo di eventi LinkedIn in coda elaborati per esecuzione, da 1 a 100; predefinito: 20.

LinkedIn Insight Tag + Conversions API — Linkedin insight purchase path

LinkedIn Insight Tag + Conversions API — Admin integrity page

Esempi di personalizzazione

Gli ID delle regole di conversione LinkedIn possono essere inseriti come semplice ID numerico o come URN LinkedIn completa. Il modulo memorizza internamente la parte numerica.

12345678
urn:lla:llaPartnerConversion:12345678

Regola di clic personalizzata per un pulsante di richiesta preventivo:

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

Parametri aggiuntivi possono essere inseriti direttamente sull’elemento cliccato:

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

Regola personalizzata basata su URL per il download di un catalogo o una pagina preventivo:

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

Regola controller/modulo per una pagina modulo di checkout:

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

Regola evento DOM per integrazioni 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'
    }
  }
}));

Può anche chiamare l’helper storefront dopo il caricamento del modulo. Per un nome evento personalizzato, includa conversion_id, a meno che il nome evento corrisponda a una delle mappature ID conversione integrate.

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

Se esegue manualmente il sistema cron condiviso, l’attività della coda LinkedIn è registrata come:

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

Installazione

Scarichi il file ZIP del modulo dal suo account mypresta.rocks.
Nel back office PrestaShop, vada su Modules > Module Manager.
Clicchi su Upload a module e selezioni il file ZIP.
Dopo l’installazione, apra la pagina di configurazione del modulo.
Aggiunga il suo LinkedIn Partner ID, abiliti il tracciamento, salvi, quindi aggiunga gli ID delle regole di conversione che vuole far conteggiare a LinkedIn Campaign Manager.
Se usa Conversions API, aggiunga il token di accesso, salvi, invii il test API e verifichi che il pannello diagnostico riporti lo stato previsto.

LinkedIn Insight Tag + Conversions API — Linkedin conversion endpoint

Come funziona nel suo negozio

Dopo la configurazione, i visitatori non vedono un nuovo widget nello storefront. Il modulo aggiunge LinkedIn Insight Tag e listener evento nell’header della pagina, acquisisce il parametro di clic li_fat_id quando LinkedIn lo invia e mappa l’attività PrestaShop sugli eventi LinkedIn.

Nel back office vede gli interruttori di tracciamento, i campi delle regole di conversione, il campo JSON degli eventi personalizzati e la diagnostica Conversions API. Gli stati della coda sono mostrati come pending, sending, sent e failed; gli eventi non riusciti possono essere rimessi nella coda pending dalla pagina del modulo.

LinkedIn Insight Tag + Conversions API — Admin config consent

Limiti dichiarati

Il reporting LinkedIn dipende dai dati di LinkedIn Campaign Manager. Il modulo può inviare eventi solo dopo che sono stati forniti il Partner ID corretto, gli ID delle regole di conversione e, per la consegna lato server, un token Conversions API valido.

Le impostazioni di consenso vengono rispettate per i moduli cookie MPR supportati. Se un altro strumento di consenso blocca gli script in modo diverso, potrebbe essere necessaria un’integrazione di consenso o un evento personalizzato.

Conversions API migliora la consegna degli eventi, ma LinkedIn richiede comunque dati di corrispondenza utilizzabili, come click ID, dettagli cliente sottoposti a hashing o indirizzo IPv4 dove la sua policy lo consente. Gli eventi server senza identificatori di corrispondenza utilizzabili possono essere rifiutati o non migliorare l’attribuzione.

Gli eventi personalizzati richiedono selettori, URL, nomi controller o eventi DOM stabili. Se un tema cambia le classi dei pulsanti o un modulo di terze parti sostituisce il markup del checkout, aggiorni la regola personalizzata in modo che corrisponda alla nuova pagina.

LinkedIn Insight Tag + Conversions API — Admin config conversions api

Domande frequenti

Mi serve Conversions API?
L’Insight Tag nel browser è sufficiente per dati demografici del sito e retargeting di base. Conversions API è consigliata quando l’attribuzione LinkedIn Ads è importante, soprattutto per il reporting degli acquisti.

Gli eventi browser e server possono essere conteggiati due volte?
Il modulo usa ID evento corrispondenti, così LinkedIn può deduplicare le versioni browser e server della stessa conversione.

Può tracciare la navigazione nelle gallerie o i pulsanti preventivo?
Sì. Usi eventi personalizzati con trigger su selettore, URL, controller/modulo o evento JavaScript.

Funziona con Checkout Revolution?
Sì. Gli eventi nativi di avvio checkout e acquisto vengono tracciati, e le interazioni aggiuntive del modulo checkout possono essere mappate come eventi personalizzati.

Cosa succede se LinkedIn rifiuta un evento server?
L’evento rimane in coda con il relativo codice HTTP e l’ultimo errore. Gli eventi non riusciti possono essere ritentati dalla pagina di configurazione del modulo.

Compatibilità: PrestaShop da 1.6 a 9.0 (ultima versione), PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.