Cała dokumentacja

LinkedIn Insight Tag + Conversions API — Dokumentacja

LinkedIn Insight Tag + Conversions API łączy Twój sklep PrestaShop z LinkedIn Campaign Manager, aby mierzyć LinkedIn Ads na podstawie rzeczywistych działań w sklepie: wyświetleń produktów, koszyków, rozpoczęć checkout, rejestracji, wyszukiwań, list życzeń i zakupów.

Funkcje

  • Wstrzykiwanie Insight Tag. Moduł ładuje przeglądarkowy LinkedIn Insight Tag z displayHeader, bez edycji szablonów motywu.
  • Śledzenie zdarzeń e-commerce. Śledzi PageView, ViewContent, AddToCart, StartCheckout, Purchase, Search, AddToWishlist i SignUp, gdy odpowiednie przełączniki zdarzeń są włączone.
  • Hooki konwersji zamówień. Śledzenie zakupów działa z displayOrderConfirmation i actionValidateOrder, z wartością zamówienia, walutą oraz stabilnym ID zdarzenia.
  • Obsługa Add-to-cart. Zdarzenia Add-to-cart są wykrywane z magistrali zdarzeń JavaScript updateCart w PrestaShop oraz z klasycznych przycisków Add-to-cart.
  • Obsługa list życzeń. Dodania do listy życzeń są wykrywane z popularnych przycisków wishlist oraz WishlistEventBus, gdy motyw lub moduł listy życzeń go udostępnia.
  • Reguły konwersji per zdarzenie. Każde standardowe zdarzenie może używać własnego ID reguły konwersji LinkedIn Campaign Manager.
  • Kolejka Conversions API. Zdarzenia po stronie serwera są zapisywane we wspólnej tabeli mpr_conversion_queue pod dostawcą linkedin i przetwarzane przez zaplanowane zadanie send_linkedin_conversions.
  • Deduplikacja w przeglądarce i na serwerze. Używane są zgodne ID zdarzeń, aby LinkedIn mógł deduplikować przeglądarkową i Conversions API-wersję tej samej konwersji.
  • Reguły zdarzeń niestandardowych. Reguły kliknięć, URL, kontrolera/modułu i zdarzeń DOM pozwalają mierzyć przyciski zapytania ofertowego, formularze, pobrania, kroki konfiguratora lub inne sygnały intencji specyficzne dla sklepu.
  • Kontrola zgód i pracowników. Śledzenie może czekać na zgodę marketingową z modułów cookie MPR i może unikać wstrzykiwania trackingu dla zalogowanych pracowników back office przeglądających storefront.
  • Diagnostyka back office. Strona konfiguracji pokazuje Partner ID, Purchase conversion rule i gotowość Conversions API, liczniki kolejki, ostatnie wiersze kolejki, próbę API oraz akcję ponowienia nieudanych zdarzeń.
LinkedIn Insight Tag + Conversions API — Linkedin insight audience LinkedIn Insight Tag + Conversions API — Admin config events

Opcje konfiguracji

  • Enable LinkedIn Insight Tag. Główny przełącznik przeglądarkowego śledzenia LinkedIn; domyślnie: 0.
  • Partner ID. Numeryczne LinkedIn Partner ID z Campaign Manager > Account Assets > Insight Tag; domyślnie: ``.
  • Exclude employees. Zapobiega wstrzykiwaniu trackingu, gdy zalogowany pracownik back office przegląda front office; domyślnie: 1.
  • Respect cookie consent. Czeka na zgodę marketingową z mprcookiesrevolution lub mprcookiebanner, gdy którykolwiek z modułów jest aktywny; domyślnie: 1.
  • Track PageView. Wysyła podstawowe zdarzenie wizyty na stronie po załadowaniu Insight Tag; domyślnie: 1.
  • Track ViewContent. Śledzi wyświetlenia stron szczegółów produktu z ID produktu, nazwą, kategorią, ceną i walutą; domyślnie: 1.
  • Track AddToCart. Śledzi natywne i AJAX-owe akcje Add-to-cart; domyślnie: 1.
  • Track StartCheckout. Śledzi wejście do checkout z wartością koszyka, liczbą produktów, walutą i pozycjami; domyślnie: 1.
  • Track Purchase. Śledzi zakończone zamówienia z hooków potwierdzenia i walidacji zamówienia; domyślnie: 1.
  • Track Search. Śledzi strony wyników wyszukiwania, gdy zapytanie jest obecne; domyślnie: 1.
  • Track AddToWishlist. Śledzi akcje dodania do listy życzeń z popularnych przycisków wishlist i magistral zdarzeń; domyślnie: 1.
  • Track SignUp. Oznacza utworzenie nowego konta klienta i wysyła zdarzenie rejestracji przy następnym załadowaniu strony konta klienta; domyślnie: 1.
  • ViewContent conversion ID. ID reguły konwersji LinkedIn dla zdarzeń wyświetlenia produktu; domyślnie: ``.
  • AddToCart conversion ID. ID reguły konwersji LinkedIn dla zdarzeń Add-to-cart; domyślnie: ``.
  • StartCheckout conversion ID. ID reguły konwersji LinkedIn dla zdarzeń rozpoczęcia checkout; domyślnie: ``.
  • Purchase conversion ID. ID reguły konwersji LinkedIn dla zdarzeń zakupu; domyślnie: ``.
  • Search conversion ID. ID reguły konwersji LinkedIn dla zdarzeń wyszukiwania; domyślnie: ``.
  • AddToWishlist conversion ID. ID reguły konwersji LinkedIn dla zdarzeń wishlist; domyślnie: ``.
  • SignUp conversion ID. ID reguły konwersji LinkedIn dla zdarzeń utworzenia konta; domyślnie: ``.
  • Track custom events. Włącza pole JSON z regułami zdarzeń niestandardowych; domyślnie: 0.
  • Custom event rules. Tablica JSON niestandardowych reguł kliknięć, URL, kontrolera lub zdarzeń DOM; domyślnie: ``.
  • Enable Conversions API events. Kolejkuje kwalifikujące się zdarzenia z ID reguł konwersji do wysyłki po stronie serwera do LinkedIn; domyślnie: 0.
  • Conversions API access token. Token LinkedIn Conversions API używany do dostarczania po stronie serwera; domyślnie: ``.
  • LinkedIn API version. Wersja LinkedIn Marketing API w formacie YYYYMM; domyślnie: 202605.
  • Send IP address match key. Wysyła adres IPv4 jako klucz dopasowania LinkedIn podczas budowania zdarzeń Conversions API; domyślnie: 1.
  • Queue batch limit. Maksymalna liczba zakolejkowanych zdarzeń LinkedIn przetwarzanych w jednym uruchomieniu, od 1 do 100; domyślnie: 20.
LinkedIn Insight Tag + Conversions API — Linkedin insight purchase path LinkedIn Insight Tag + Conversions API — Admin integrity page

Przykłady dostosowania

ID reguły konwersji LinkedIn można wpisać jako zwykłe numeryczne ID albo pełny LinkedIn URN. Moduł przechowuje wewnętrznie część numeryczną.

12345678
urn:lla:llaPartnerConversion:12345678

Niestandardowa reguła kliknięcia dla przycisku zapytania ofertowego:

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

Dodatkowe parametry można umieścić bezpośrednio na klikanym elemencie:

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

Niestandardowa reguła oparta na URL dla pobrania katalogu lub strony zapytania ofertowego:

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

Reguła kontrolera/modułu dla strony modułu checkout:

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

Reguła zdarzenia DOM dla integracji 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'
    }
  }
}));

Możesz też wywołać helper storefront po załadowaniu modułu. Dla niestandardowej nazwy zdarzenia dodaj conversion_id, chyba że nazwa zdarzenia odpowiada jednemu z wbudowanych mapowań Conversion ID.

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

Jeśli uruchamiasz ręcznie współdzielony system cron, zadanie kolejki LinkedIn jest zarejestrowane jako:

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

Instalacja

  1. Pobierz plik ZIP modułu ze swojego konta mypresta.rocks.
  2. W PrestaShop Back Office przejdź do Modules > Module Manager.
  3. Kliknij Upload a module i wybierz plik ZIP.
  4. Po instalacji otwórz stronę konfiguracji modułu.
  5. Dodaj swoje LinkedIn Partner ID, włącz śledzenie, zapisz, a następnie dodaj ID reguł konwersji, które LinkedIn Campaign Manager ma zliczać.
  6. Jeśli używasz Conversions API, dodaj token dostępu, zapisz, wyślij próbę API i sprawdź, czy panel diagnostyczny pokazuje oczekiwany status.
LinkedIn Insight Tag + Conversions API — Linkedin conversion endpoint

Jak to działa w Twoim sklepie

Po konfiguracji odwiedzający nie widzą nowego widgetu w sklepie. Moduł dodaje LinkedIn Insight Tag i nasłuchiwacze zdarzeń w nagłówku strony, przechwytuje parametr kliknięcia li_fat_id, gdy LinkedIn go wysyła, i mapuje aktywność PrestaShop na zdarzenia LinkedIn.

W back office widzisz przełączniki śledzenia, pola reguł konwersji, pole JSON zdarzeń niestandardowych i diagnostykę Conversions API. Statusy kolejki są pokazywane jako pending, sending, sent i failed; nieudane zdarzenia można przywrócić do kolejki pending ze strony modułu.

LinkedIn Insight Tag + Conversions API — Admin config consent

Uczciwe ograniczenia

Raportowanie LinkedIn zależy od danych z LinkedIn Campaign Manager. Moduł może wysyłać zdarzenia dopiero po podaniu prawidłowego Partner ID, ID reguł konwersji oraz, dla dostarczania po stronie serwera, ważnego tokena Conversions API.

Ustawienia zgód są respektowane dla obsługiwanych modułów cookie MPR. Jeśli inne narzędzie do zgód blokuje skrypty w inny sposób, może być potrzebne zdarzenie niestandardowe lub integracja zgody.

Conversions API poprawia dostarczanie zdarzeń, ale LinkedIn nadal potrzebuje użytecznych danych dopasowania, takich jak click ID, zahashowane dane klienta albo adres IPv4, jeśli Twoja polityka na to pozwala. Zdarzenia serwerowe bez użytecznych identyfikatorów dopasowania mogą zostać odrzucone albo nie poprawić atrybucji.

Zdarzenia niestandardowe potrzebują stabilnych selektorów, URL-i, nazw kontrolerów lub zdarzeń DOM. Jeśli motyw zmieni klasy przycisków albo moduł zewnętrzny zastąpi markup checkout, zaktualizuj regułę niestandardową tak, aby pasowała do nowej strony.

LinkedIn Insight Tag + Conversions API — Admin config conversions api

Najczęściej zadawane pytania

Czy potrzebuję Conversions API?
Przeglądarkowy Insight Tag wystarcza do demografii witryny i podstawowego retargetingu. Conversions API jest zalecane, gdy atrybucja LinkedIn Ads ma znaczenie, szczególnie przy raportowaniu zakupów.

Czy zdarzenia z przeglądarki i serwera mogą zostać policzone podwójnie?
Moduł używa zgodnych ID zdarzeń, aby LinkedIn mógł deduplikować przeglądarkową i serwerową wersję tej samej konwersji.

Czy moduł może śledzić przeglądanie galerii albo przyciski zapytania ofertowego?
Tak. Użyj zdarzeń niestandardowych z wyzwalaczami selektora, URL, kontrolera/modułu albo zdarzenia JavaScript.

Czy działa z Checkout Revolution?
Tak. Natywne zdarzenia rozpoczęcia checkout i zakupu są śledzone, a dodatkowe interakcje modułu checkout można zmapować jako zdarzenia niestandardowe.

Co się stanie, jeśli LinkedIn odrzuci zdarzenie serwerowe?
Zdarzenie pozostaje w kolejce z kodem HTTP i ostatnim błędem. Nieudane zdarzenia można ponowić ze strony konfiguracji modułu.

Kompatybilność: PrestaShop 1.6 do 9.0 (najnowsza wersja), PHP 7.1+. Nadal wspieramy nadchodzące wersje PrestaShop.

LinkedIn Insight Tag + Conversions API — Admin config credentials
Do góry