Taboola Pixel + S2S Postback: konfiguracja i pomoc

1. Prześlij i zainstaluj ZIP w Moduły > "Module Manager", a następnie otwórz Taboola Pixel + S2S Postback > "Configure".
2. Wprowadź ID konta Taboola w Ustawienia Taboola Pixel.
3. Sprawdź przełączniki zdarzeń i dopasuj Nazwa zdarzenia zakupu oraz pozostałe pola nazw zdarzeń do konta.
4. Ustaw "Enable Taboola Pixel" na Tak i kliknij Zapisz.
5. Udziel zgody marketingowej w przeglądarce odwiedzającego i otwórz produkt.
6. Potwierdź załadowanie tfa.js i wysłanie skonfigurowanego zdarzenia wyświetlenia produktu.
7. Aby opcjonalnie obsługiwać zakupy po stronie serwera, włącz "Capture purchase consent evidence" i "Enable S2S postback events". Następnie złóż zamówienie testowe po kliknięciu reklamy Taboola (z identyfikatorem kliknięcia tblci), akceptując śledzenie, i sprawdź, czy zamówienie trafia do kolejki i jest wysyłane przez harmonogram.

Otwórz Moduły > "Module Manager" > Taboola Pixel + S2S Postback > "Configure".

• "Enable Taboola Pixel". Główny przełącznik śledzenia w przeglądarce; domyślnie: 0.

• ID konta Taboola. Numeryczny identyfikator konta Taboola z Realize > "Tracking"; domyślnie: "".

• "Exclude employees". Zatrzymuje śledzenie, gdy zalogowany pracownik panelu administracyjnego przegląda sklep; domyślnie: 1.

• "Respect cookie consent". Czeka na zgodę marketingową z mprcookiesrevolution lub mprcookiebanner, gdy jeden z tych modułów jest aktywny; domyślnie: 1.

• "Track PageView". Wysyła standardowe zdarzenie page_view na śledzonych stronach; domyślnie: 1.

• "Track View Content". Wysyła zdarzenie wyświetlenia produktu na stronach produktów; domyślnie: 1.

• "Track View Category". Wysyła zdarzenie wyświetlenia kategorii lub kolekcji po wykryciu bieżącej kategorii; domyślnie: 1.

• "Track Add To Cart". Wysyła przeglądarkowe zdarzenia dodania do koszyka po potwierdzonym udanym dodaniu; domyślnie: 1.

• "Track Checkout". Wysyła zdarzenie rozpoczęcia realizacji zamówienia, gdy moduł wykryje stronę jej rozpoczęcia, a koszyk zawiera produkty; domyślnie: 1.

• "Track Purchase". Wysyła zdarzenia zakupu przy potwierdzeniu i walidacji zamówienia; domyślnie: 1.

• "Track Search". Wysyła zdarzenia wyszukiwania na stronie wyszukiwania, gdy podano szukane hasło; domyślnie: 1.

• "Track Add To Wishlist". Wysyła zdarzenia listy życzeń po potwierdzonym udanym dodaniu; domyślnie: 1.

• "Track Sign Up". Wysyła zdarzenie rejestracji po utworzeniu nowego konta klienta; domyślnie: 1.

• Nazwa zdarzenia zakupu. Nazwa zdarzenia Taboola dla zakupów i postbacków S2S zakupów; domyślnie: make_purchase.

• "Product view event name". Nazwa zdarzenia Taboola dla wyświetleń produktów; domyślnie: product_view.

• "Collection/category view event name". Nazwa zdarzenia Taboola dla wyświetleń kategorii; domyślnie: collection_view.

• "Add to cart event name". Nazwa zdarzenia Taboola dla dodania do koszyka; domyślnie: add_to_cart.

• "Start checkout event name". Nazwa zdarzenia Taboola dla rozpoczęcia realizacji zamówienia; domyślnie: start_checkout.

• "Search submitted event name". Nazwa zdarzenia Taboola dla wyszukiwań; domyślnie: search_submitted.

• "Wishlist event name". Nazwa zdarzenia Taboola dla dodania do listy życzeń; domyślnie: add_to_wish_list.

• "Registration event name". Nazwa zdarzenia Taboola dla rejestracji nowych kont; domyślnie: complete_registration.

• "Track custom events". Włącza niestandardowe reguły JSON w przeglądarce; zdarzenia serwerowe przesłane z przeglądarki są wstrzymywane; domyślnie: 0.

• Reguły zdarzeń niestandardowych. Tablica JSON niestandardowych reguł zdarzeń dla wyzwalaczy click, url, controller lub event; domyślnie: "".

• "Enable S2S postback events". Wysyła zakupy z serwera dla kupujących, którzy przyszli z kliknięcia Taboola (tblci) i których zgoda została zapisana przy składaniu zamówienia; domyślnie: 0.

• "Test tblci". Wartość zachowana dla zgodności; bieżąca sonda odmawia wysyłki; domyślnie: "".

• "Queue batch limit". Maksymalna liczba zdarzeń konwersji Taboola z kolejki przetwarzanych w jednym uruchomieniu, dopuszczalny zakres od 1 do 1000; domyślnie: 20.

• "Capture purchase consent evidence". Domyślnie: 0. Włącz tę opcję przed testowaniem zakupów serwerowych. Zapisuje zgodę kupującego w chwili złożenia zamówienia; zakupy serwerowe wymagają też banera zgód, którego zapisany wybór moduł potrafi odczytać, np. Cookies Revolution.

Kliknij Zapisz. Użyj niezerowego numerycznego identyfikatora konta liczącego maksymalnie 32 cyfry. Nazwy zdarzeń muszą dokładnie odpowiadać kontu i zawierać od 1 do 100 liter, cyfr lub podkreśleń. Nieprawidłowe nazwy nie są automatycznie zmieniane. Zmieniaj pola nazw wbudowanych zdarzeń tylko wtedy, gdy konto używa nazwy zastępczej.

Bieżący formularz udostępnia też te ustawienia. Wszystkie przełączniki sygnałów mają domyślną wartość Nie. Włącz tylko działania, które chcesz obserwować.

Wspólne progi to trzy wyświetlenia galerii, jedna zmiana wariantu, jedno kliknięcie szczegółów, 45 sekund przebywania na stronie i minimalny odstęp 1500 ms między interakcjami z opcjami. Liczniki galerii, wariantów i szczegółów mają zakres od 1 do 20. Czas przebywania ma zakres od 5 do 600 sekund. Odstęp ma zakres od 250 do 60000 ms. Na przykład:

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

Możesz też podać gallery_selectors, variant_selectors i detail_selectors. Zachowaj wartości domyślne, chyba że motyw wymaga innych selektorów. Te opcjonalne sygnały wymagają sprawdzenia zgody, zasad dotyczących pracowników i odpowiedzialności za śledzenie, tak jak zdarzenia handlowe.

Podczas pierwszej konfiguracji pozostaw włączone ustawienia zgody i wykluczania pracowników. Testuj w zwykłej przeglądarce odwiedzającego, która nie jest oznaczona jako pracownik. Zalogowana sesja panelu administracyjnego, reguła ruchu wewnętrznego lub rezygnacja odwiedzającego mogą zablokować śledzenie.

Wspólna warstwa zgody obsługuje integracje zgody MPR i dodatkowe adaptery CMP. Musi uzyskać użyteczną decyzję marketingową dla miejsca docelowego. Nieznana, nieaktualna lub odmowna decyzja może wstrzymać zdarzenia. Moduł nie dostarcza banera cookies. Starsze ustawienie zgody nie zastępuje aktualnej odmowy z wykrytej CMP.

Moduł musi odpowiadać za skonfigurowane miejsce docelowe we wspólnym koordynatorze śledzenia. Brak, niejednoznaczność lub konflikt odpowiedzialności mogą wstrzymać wysyłanie z przeglądarki i serwera. Usuń powielone tagi motywu lub rozstrzygnij odpowiedzialność, gdy inny moduł MPR zarządza tym samym kontem.

Wysyłanie produkcyjne podlega też zasadom ruchu wychodzącego. Zdarzenie widoczne w trybie demonstracyjnym lub podglądu nie musi trafić do konta reklamowego. Zakupy i serwerowe zdarzenia formularzy są wysyłane tylko ze zgodą, której kupujący udzielił w danym momencie; późniejsze uruchomienie cron nie może jej zastąpić.

Moduł przygotowuje konfigurację przez displayHeader. Po pomyślnych kontrolach mechanizm wykonawczy ładuje https://cdn.taboola.com/libtrc/unip/ACCOUNT_ID/tfa.js i wysyła włączone zdarzenia przeglądarki. Nie otrzymujesz typowego widżetu sklepu.

Wizyty na stronach używają page_view. Zdarzenia produktów, kategorii, potwierdzonego dodania do koszyka, rozpoczęcia realizacji zamówienia, zakupów, wyszukiwań, potwierdzonego dodania do listy życzeń i rejestracji używają zapisanych nazw. Zakupy mogą zawierać przychód z zamówienia, walutę, ilość, numer referencyjny zamówienia i kontekst produktu. Rejestracja jest oznaczana w actionCustomerAccountAdd i wykorzystywana przy późniejszym kwalifikującym się żądaniu natywnej sesji.

Do atrybucji serwerowej użyj adresów docelowych kampanii zawierających jeden rzeczywisty tblci, na przykład:

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

Bieżące przechwytywanie w przeglądarce akceptuje tblci; nie przechwytuje starego aliasu URL taboola_click_id. Po pozytywnym sprawdzeniu zgody i pozostałych warunków zapisuje mprtbpx_tblci na 30 dni ze skonfigurowaną ścieżką cookie, SameSite=Lax i Secure przy HTTPS. Odmowa zgody usuwa obsługiwane przez mechanizm wykonawczy cookies atrybucji.

Włącz "Track custom events", wprowadź tablicę JSON w Reguły zdarzeń niestandardowych i zapisz. Używaj dokładnych nazw zdarzeń konta zawierających od 1 do 100 liter, cyfr lub podkreśleń. Te przykłady obejmują wyzwalacze kliknięcia, URL, kontrolera i zdarzenia DOM. Reguły kontrolera mogą ograniczać moduł frontowy przez modules.

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "once": false
  },
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": [
      "/sale"
    ]
  },
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "modules": []
  },
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom"
  }
]

Wywołaj regułę DOM po inicjalizacji:

document.dispatchEvent(new CustomEvent('mprtbpx:custom'));

Reguły URL sprawdzają ścieżkę. Fragmenty zapytania takie jak utm_campaign=taboola nie są dopasowaniami ścieżki. once ogranicza powtarzające się wyzwalacze kliknięcia lub DOM w bieżącym środowisku wykonawczym.

Reguły niestandardowe wysyłają skonfigurowaną nazwę zdarzenia. Nie kopiują atrybutów danych kliknięcia ani DOM detail.params. Zdarzenia niestandardowe trafiają do Taboola tylko z przeglądarki: moduł nie przyjmuje zdarzeń przesłanych z przeglądarki do wysyłki serwerowej, więc s2s: true w regule niestandardowej nie wysyła postbacku z serwera.

Włącz "Enable S2S postback events" i "Capture purchase consent evidence", gdy sklep ma baner zgód, który moduł potrafi odczytać, a odwiedzający przychodzą z identyfikatorami kliknięć Taboola. Pozostaw "Track Purchase" włączone i dopasuj Nazwa zdarzenia zakupu do konta Taboola.

Przy walidacji zamówienia moduł zapisuje zgodę i identyfikator kliknięcia kupującego oraz dodaje zakup do kolejki. Zakup serwerowy jest wysyłany tylko wtedy, gdy kupujący wyraził zgodę, nie jest pracownikiem, ten moduł odpowiada za śledzenie Taboola i przechwycono rzeczywisty tblci. Starsze wiersze kolejki przesłane z przeglądarki pozostają wstrzymane.

Gdy zakup zostanie przyjęty do kolejki serwerowej, moduł blokuje też jego zdarzenie w przeglądarce, aby nie wysłać tego samego zakupu dwa razy. Jeśli zakup nie trafi do kolejki serwerowej, zdarzenie w przeglądarce nadal może zostać wysłane, gdy pozwalają na to zgoda i pozostałe warunki śledzenia.

Zadanie send_taboola_conversions jest zarejestrowane z harmonogramem every:300. Staje się gotowe do wykonania co pięć minut. Wspólny wykonawca cron MPR musi wykonywać zadania, których termin nadszedł; sama deklaracja harmonogramu nie uruchamia procesu roboczego. Limit partii ogranicza liczbę wierszy kolejki na uruchomienie do zakresu od 1 do 1000, domyślnie 20.

Moduł nie ma osobnego pliku uruchomieniowego cron.php. Używaj wspólnego harmonogramu skonfigurowanego dla sklepu. Sprawdź w nim wykonanie zadania oraz znaczniki czasu i stan kolejki na stronie konfiguracji tego modułu.

Diagnostyka obejmuje kontrole gotowości, liczniki kolejki, ostatnie wiersze, Wyślij test S2S i Ponów nieudane zdarzenia. Przed ponowieniem usuń przyczynę błędu. Przywrócenie nieudanych wierszy do oczekujących nie omija bieżących kontroli zgody, zasad dotyczących pracowników, odpowiedzialności za konto ani miejsca docelowego.

Wyślij test S2S niczego nie wysyła, ponieważ Taboola nie oferuje trybu testowego, który trzymałby konwersje testowe poza raportami. "Test tblci" pozostaje dla zgodności i nie wywołuje konwersji testowej. Aby sprawdzić dostarczenie, zobacz odpowiedź kolejki dla prawdziwego zakupu z kliknięcia Taboola.

1. Sprawdź wymaganą konfigurację, integralność, gotowość, odpowiedzialność i wspólny harmonogram.
2. W zwykłej przeglądarce odwiedzającego udziel zgody marketingowej i otwórz produkt. Potwierdź tfa.js i skonfigurowane zdarzenie wyświetlenia produktu.
3. Dodaj produkt pomyślnie do koszyka i potwierdź zdarzenie dodania. Samo kliknięcie przycisku nie wystarcza.
4. Dla S2S włącz zapisywanie zgody, a następnie złóż zamówienie po kliknięciu reklamy Taboola. Sprawdź pierwotny tblci, zapisaną zgodę i wiersz zamówienia w kolejce.
5. Pozwól harmonogramowi przetworzyć wiersz. Sprawdź wynik końcowy i zdarzenie w raportach Taboola. Sprawdź, czy to samo zamówienie nie zostało wysłane oboma kanałami.

Jeśli nie pojawia się skrypt przeglądarki, sprawdź włączenie, ID konta, zgodę, oznaczenia pracowników, odpowiedzialność, powielone tagi i blokowanie w przeglądarce. Jeśli zakup serwerowy jest wstrzymany, sprawdź "Capture purchase consent evidence", baner zgód, ID kliknięcia, tożsamość kupującego i zapisany powód. Jeśli reguły niestandardowe nie działają, sprawdź dokładne nazwy, selektory i dopasowanie ścieżki. Stara funkcja globalna window.mprtbpxTrack nie jest dostępna.

Wyłącz przełączniki przeglądarki i serwera oraz zapisz, jeśli chcesz zatrzymać śledzenie z zachowaniem konfiguracji. Odinstaluj moduł w "Module Manager", aby usunąć ustawienia modułu, pozycje menu i zarejestrowane zadania.

Odinstalowanie wywołuje wspólne czyszczenie kolejki konwersji. Wspólna tabela kolejki pozostaje, dopóki korzysta z niej inny moduł konwersji, i może zostać usunięta po usunięciu ostatniego użytkownika. Przed odinstalowaniem wyeksportuj potrzebne dane diagnostyczne. Nie zakładaj, że odinstalowanie usuwa zdarzenia już wysłane do platformy reklamowej lub wszystkie dane atrybucji w przeglądarce.

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.