Taboola Pixel + S2S Postback — Dokumentacja

Śledź wizyty z Taboola Realize i działania e-commerce w swoim sklepie PrestaShop. Moduł dodaje przeglądarkowy Pixel Taboola, obsługuje opcjonalne postbacki server-to-server i pozwala tworzyć własne zdarzenia konwersji dla interakcji w sklepie, które mają znaczenie dla kampanii.

Kompatybilność

Zgodny z PrestaShop 1.6 do 9.0 (latest) oraz PHP 7.1+. Nadal wspieramy nadchodzące wersje PrestaShop.

Konfiguracja

1. Zainstaluj moduł i otwórz Modules -> Taboola Pixel -> Configure.
2. Wklej numeryczny Taboola Account ID z Taboola Realize.
3. Włącz Taboola Pixel.
4. Wybierz, które zdarzenia e-commerce mają być wysyłane.
5. Opcjonalnie: włącz S2S postback events, jeśli kampanie Taboola przekazują identyfikator kliknięcia.
6. Opcjonalnie: dodaj własne reguły zdarzeń dla kliknięć, adresów URL, kontrolerów lub zdarzeń JavaScript.

Account ID musi być numeryczny:

ACCOUNT_ID=1234567

Moduł instaluje się z następującymi domyślnymi nazwami zdarzeń:

product_view
collection_view
add_to_cart
start_checkout
make_purchase
search_submitted
add_to_wish_list
complete_registration

Główne ustawienia

Strona konfiguracji zawiera następujące ustawienia dla sprzedawcy:

ENABLED=1
ACCOUNT_ID=1234567
EXCLUDE_EMPLOYEES=1
RESPECT_CONSENT=1
TRACK_PAGEVIEW=1
TRACK_VIEWCONTENT=1
TRACK_VIEWCATEGORY=1
TRACK_ADDTOCART=1
TRACK_STARTCHECKOUT=1
TRACK_PURCHASE=1
TRACK_SEARCH=1
TRACK_ADDTOWISHLIST=1
TRACK_SIGNUP=1
S2S_ENABLED=0
S2S_BATCH_LIMIT=20

Przydatne wartości domyślne:

• Wyklucz pracowników: zatrzymuje śledzenie front-office, gdy zalogowany pracownik back-office przegląda sklep.
• Respektuj zgodę na cookies: czeka na zgodę marketingową, gdy aktywny jest mprcookiesrevolution lub mprcookiebanner.
• Limit partii kolejki: domyślnie przetwarza do 20 oczekujących zdarzeń S2S w jednym uruchomieniu. Dozwolony zakres to od 1 do 1000.

Zdarzenia

Wbudowane zdarzenia przeglądarkowe obejmują:

• Wyświetlenie strony: page_view
• Wyświetlenie produktu: product_view
• Wyświetlenie kategorii lub kolekcji: collection_view
• Dodanie do koszyka: add_to_cart
• Rozpoczęcie checkout: start_checkout
• Zakup: make_purchase
• Wyszukiwanie: search_submitted
• Dodanie do listy życzeń: add_to_wish_list
• Rejestracja klienta: complete_registration

Śledzenie zakupów korzysta ze strony potwierdzenia zamówienia i wysyła, gdy są dostępne, wartości zamówienia takie jak przychód, waluta, ilość oraz ID zamówienia.

Server-To-Server Postbacks

Postbacki S2S są opcjonalne. Śledzenie przez przeglądarkowy Pixel może działać bez nich.

Do atrybucji S2S adresy landing page kampanii Taboola muszą zawierać jeden z tych parametrów identyfikatora kliknięcia:

https://www.example.com/product-name?tblci=TABOOLA_CLICK_ID
https://www.example.com/product-name?taboola_click_id=TABOOLA_CLICK_ID

Skrypt frontowy zapisuje identyfikator kliknięcia w tych plikach cookie do późniejszej atrybucji:

mprtbpx_tblci
taboola_click_id

Postbacki S2S są wysyłane do Taboola przez ten endpoint:

https://trc.taboola.com/actions-handler/log/3/s2s-action

Zapytanie postback może zawierać:

click-id=TABOOLA_CLICK_ID
name=make_purchase
revenue=49.90
currency=EUR
quantity=2
orderid=1234

Pole Test tblci akceptuje litery, cyfry, kropki, podkreślenia, dwukropki i myślniki:

S2S_TEST_CLICK_ID=abc.DEF_123-456:789

Własne zdarzenia

Włącz Track custom events, gdy chcesz wysyłać dodatkowe punkty konwersji, takie jak przeglądanie galerii, przyciski leadów, kliknięcia lokalizatora sklepów lub wizyty na landing page.

Reguły własnych zdarzeń używają JSON. Obsługiwane wyzwalacze to:

click
url
controller
event

Przykładowa reguła kliknięcia:

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "s2s": true,
    "once": false
  }
]

Przykładowa reguła URL:

[
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": ["/sale", "utm_campaign=taboola"],
    "params": {
      "property": "taboola_landing"
    },
    "s2s": true
  }
]

Przykładowa reguła kontrolera:

[
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": ["contact"],
    "params": {
      "property": "contact"
    },
    "s2s": true
  }
]

Przykładowa reguła zdarzenia JavaScript:

[
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom",
    "params": {
      "property": "lead_form"
    },
    "s2s": true
  }
]

Motyw lub mały własny skrypt może następnie wywołać zdarzenie DOM:

document.dispatchEvent(new CustomEvent('mprtbpx:custom', {
  detail: {
    params: {
      value: 1,
      currency: 'EUR'
    }
  }
}));

W przypadku reguł kliknięć moduł może też odczytywać parametry z klikniętych elementów:

<a href="/contact"
   class="taboola-lead-button"
   data-taboola-param-property="lead_button"
   data-mprtbpx-param-location="product_page">
  Contact us
</a>

Diagnostyka

Strona konfiguracji pokazuje kontrole gotowości dla:

• Taboola Account ID
• Śledzenie przeglądarkowe
• Nazwa zdarzenia zakupu
• Status postbacków S2S
• Reguły własnych zdarzeń
• Przechwytywanie tblci
• Tabela kolejki

Pokazuje również liczniki kolejki S2S:

pending
sending
sent
failed

Możesz użyć Send S2S probe po dodaniu prawdziwego tblci oraz Retry failed events, aby przywrócić nieudane postbacki do kolejki oczekującej.

Uwagi techniczne dla właścicieli sklepów

Moduł rejestruje następujące hooki PrestaShop:

displayHeader
displayOrderConfirmation
actionValidateOrder
actionCustomerAccountAdd

Zaplanowane zadanie przetwarza zakolejkowane konwersje Taboola:

send_taboola_conversions
schedule: every:300
timeout: 30

Zwykle nie trzeba edytować tych wartości. Są podane tutaj, aby programista lub zespół hostingowy mógł szybko potwierdzić, że moduł jest zainstalowany i działa w oczekiwanych miejscach.