TikTok Pixel: konfiguracja i pomoc

Wykonaj kroki opisane w sekcji Szybki start.

Otwórz "Configure" w menedżerze modułów. Potrzebujesz istniejącego Piksela na koncie TikTok. Strona konfiguracji pokazuje wymagane komunikaty konfiguracji, gotowość śledzenia i diagnostykę Events API.

Śledzenie w przeglądarce wymaga uprawnienia marketingowego/usługi oraz uprawnienia do wysyłania danych dopasowania. Sama zgoda na przechowywanie nie wystarcza. Moduł obsługuje decyzje zgody z Cookies Revolution, Cookie Banner, Cookiebot, OneTrust i TCF; skonfiguruj i przetestuj decyzje dostarczane przez sklep. Nieznane uprawnienie wstrzymuje śledzenie. Wykryta obsługiwana CMP obowiązuje również po wyłączeniu przełącznika zgody modułu.

Moduł sprawdza też bezpieczny kontekst strony/strony odsyłającej, status pracownika, własność i reguły ruchu wychodzącego. Używa zweryfikowanej instancji ttq właściwej dla Piksela. Przed testowaniem usuń zduplikowane lub niejednoznacznie zainicjowane skrypty TikTok.

Standardowe przełączniki zdarzeń

Wszystkie standardowe przełączniki zdarzeń mają domyślnie wartość Tak. Wyłącz niepotrzebne zdarzenia.

Moduł ładuje https://analytics.tiktok.com/i18n/pixel/events.js dla Piksela. Zdarzenia koszyka wymagają potwierdzonego udanego zwiększenia ilości; samo kliknięcie dodania lub powiadomienie updateCart nie wystarcza. Zdarzenia zawierają identyfikatory produktów i ilość. Bieżące ceny i wartość koszyka są dołączane tylko po potwierdzeniu.

Dane zakupu używają Purchase; CompletePayment to wewnętrzny alias. Zawierają stabilny identyfikator zdarzenia oparty na zamówieniu, numer referencyjny zamówienia, gdy jest dostępny, wartość, walutę i zakupioną zawartość. Domyślna polityka wartości zakupu uwzględnia podatek i wysyłkę oraz odejmuje rabaty. Są to wartości domyślne dostawcy w tym module, a nie oddzielne pola ustawień.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" i "Track product engagement" mają domyślnie wartość Nie. Kliknięcia telefoniczne i obsługiwane rzeczywiste rozpoczęcia czatu Tawk są mapowane na Contact z ogólnymi metadanymi sygnału. Formularze wymagają potwierdzonego przez serwer dowodu powodzenia.

"Confirmed form event" ma domyślnie wartość Lead. Wybierz SubmitForm tylko wtedy, gdy potrzebujesz tego starszego mapowania. "Send confirmed forms through the server API" ma domyślnie wartość Nie; włącz tylko razem z sygnałem formularza i danymi API. Formularz jest wysyłany z serwera tylko wtedy, gdy przy jego przesłaniu zapisano potwierdzenie, zgodę odwiedzającego i atrybucję kliknięcia; w przeciwnym razie jest wstrzymywany. Wartości formularza nie są kopiowane do zdarzenia.

Użyj "Product engagement thresholds" do obiektu JSON. Puste zapisane pole używa wartości domyślnych pakietu: 3 interakcje z galerią, 1 zmiana wariantu, 1 interakcja ze szczegółami lub 45 sekund, z odstępem obsługi opcji 1500 ms. Liczniki przyjmują 1 do 20, czas 5 do 600 sekund, a odstęp 250 do 60000 ms. Domyślne zachowanie high_intent_product_engagement to raz na produkt/sesję, gdy przechowywanie jest dozwolone.

"Track custom events" ma domyślnie wartość Nie. "Custom event rules" jest początkowo puste. Dodaj reguły przed włączeniem przełącznika. Nazwy zaczynają się literą i zawierają litery, cyfry, podkreślenia lub łączniki, z limitem 50 znaków. Przetwarzanych jest do 50 reguł i 50 różnych nazw. Zdarzenia standardowe, w tym PageView, Purchase, Contact, SubmitForm, Download i Subscribe, są zastrzeżone.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-cover img","params":{"content_type":"product"},"once":false},
  {"event":"SizeGuideView","trigger":"url","contains":["/size-guide"],"params":{"content_type":"page"}},
  {"event":"ContactIntent","trigger":"controller","controllers":["contact"],"modules":["contactform"]},
  {"event":"ConfiguratorChanged","trigger":"event","dom_event":"product:configured","params":{"configurator_step":"finish"},"once":false}
]

document.dispatchEvent(new CustomEvent('product:configured'));

Użyj selector, contains, controllers/modules lub dom_event dla odpowiedniego wyzwalacza. once ma domyślnie wartość true dla wszystkich typów reguł w tym module. Aktywny mechanizm używa skonfigurowanych parametrów i nie scala dowolnych szczegółów zdarzeń DOM. Używaj skonfigurowanych reguł zamiast starego pomocnika window.mprtkpxTrack.

actionValidateOrder zapisuje zgodę i identyfikatory z sesji kupującego i dodaje kwalifikujące się Purchase do kolejki. Callback, webhook ani żądanie bez sesji kupującego nie mogą ich dostarczyć. Proces ponownie sprawdza pierwotną i bieżącą zgodę, uprawnienie do dopasowania, politykę personelu, miejsce docelowe i reguły ruchu wychodzącego. Zakup bez identyfikatorów dopasowania jest wstrzymywany. Sam token API nie wystarcza do wysyłania zakupów.

Wysyłanie przez serwer obejmuje zakupy i opcjonalne formularze potwierdzone przez serwer. Standardowe zdarzenia przeglądania i niestandardowe reguły JSON są wysyłane przez przeglądarkę. Innych wywołań frontendowych nie można wysyłać przez Events API.

Upewnij się, że wspólny mechanizm cron MPR wykonuje:

task: send_tiktok_events_api_conversions
callable: mprtiktokpixel::cronProcessTikTokConversions
schedule: every:300
context: any
timeout: 30

Zakupy używają dostawcy kolejki tiktok_events_api. Ten sam proces obsługuje oddzielny kanał potwierdzonych formularzy z partią 20 dla tego kanału. Zakupy przeglądarki i serwera współdzielą identyfikator zdarzenia modułu oparty na zamówieniu; sprawdź raporty dostawcy zamiast zakładać, że każde zdarzenie kolejki zostanie przyjęte lub przypisane.

Moduł wysyła zakup przy walidacji zamówienia, która może nastąpić przed rozliczeniem płatności. Nie ma ustawienia oczekiwania na status opłacenia ani ponownej wysyłki, gdy zamówienie zostanie opłacone.

Sprawdź gotowość, liczniki kolejki i ostatnie wiersze HTTP/błędów na stronie konfiguracji. Użyj przeglądarki klienta i narzędzi testowych dostawcy, aby sprawdzić wyświetlenie strony, produktu, udaną zmianę koszyka, proces zamówienia, rejestrację i zamówienie testowe. Testuj odmowę i wycofanie zgody jako oddzielne ścieżki.

Wyślij próbę API wymaga zapisanego "Test event code", danych dostępowych, odpowiedzialności za śledzenie i uprawnienia do ruchu wychodzącego. Wysyła PageView oznaczony kodem testowym, z pustym obiektem użytkownika i głównym adresem URL sklepu, a nie zmyślony zakup. Udana próba pokazuje, że połączenie działa; nie testuje rzeczywistych zakupów ani atrybucji. Usuń kod po teście.

Ponów nieudane zdarzenia przywraca kwalifikujące się nieudane wiersze zakupów i formularzy do oczekiwania. Wiersze bez zgody lub zapisanych danych, wiersze trwale odrzucone przez TikTok i wiersze o niepewnym dostarczeniu pozostają bez zmian. Sprawdź zapisany powód przed ponowieniem.

Jeśli Piksel się nie ładuje, sprawdź włączenie, "Pixel ID", uprawnienia marketingowe/usługi i dopasowania, politykę personelu, bezpieczne URL, zduplikowane SDK i zablokowane żądania. Jeśli brakuje zdarzeń koszyka lub listy życzeń, potwierdź oczekiwane sygnały powodzenia w motywie.

Jeśli brakuje zakupów w kolejce serwerowej, sprawdź, czy zgoda i identyfikatory kupującego zostały zapisane przy walidacji zamówienia; strona potwierdzenia nie może ich dodać później. Sprawdź dane API, uruchomienia procesu i identyfikatory dopasowania. Jeśli niestandardowy JSON nie zapisuje się, sprawdź nazwy, zastrzeżone zdarzenia, pola wyzwalaczy i limity reguł.

Moduł nie tworzy pliku produktowego, katalogu ani kampanii reklamowej. Skonfiguruj je oddzielnie, jeśli ich używasz.

Ustaw "Enable TikTok Pixel" na Nie i zapisz, aby wstrzymać integrację. Odinstaluj przez menedżer modułów, aby usunąć menu, rejestrację cron i konfigurację modułu. Wspólna tabela kolejki pozostaje, jeśli inny moduł używa pakietu konwersji; w przeciwnym razie pomocnik odinstalowania usuwa ją. Wspólne dane zgód i wysyłek są zarządzane oddzielnie. Zarządzaj Pikselem i raportami historycznymi w TikTok.

Jeśli zrzut referencyjny różni się od zainstalowanej wersji, używaj powyższych nazw ustawień.