Server-side tracking w WooCommerce: poradnik konfiguracji

Server-side tracking w WooCommerce wysyła każde opłacone zamówienie z danych zamówień twojego sklepu do Meta, TikTok i innych platform reklamowych, zamiast polegać tylko na pikselu w przeglądarce kupującego. Zakup jest raportowany nawet wtedy, gdy bloker reklam zatrzyma piksel albo kupujący nigdy nie dotrze na stronę z podziękowaniem.

Ten poradnik wyjaśnia, dlaczego sklepy WooCommerce tracą konwersje, jakie dane zamówień daje WooCommerce oraz dwa sposoby połączenia ROASaurus: wtyczkę WordPress lub webhooki. Dalej omawia dopasowanie, zgody, konfigurację i testowanie. Aby poznać ogólną ideę, przeczytaj czym jest server-side tracking.

Dlaczego sklepy WooCommerce tracą konwersje?

Piksel w przeglądarce zgłasza zakup tylko wtedy, gdy skrypt piksela się załaduje, kupujący dotrze na stronę z podziękowaniem, a przeglądarka wyśle zdarzenie. Każdy z tych kroków może zawieść. Samo zamówienie nadal jest w twojej bazie danych, bo WooCommerce zapisuje je na serwerze.

Brakujące zakupy szkodzą na dwa sposoby. Platforma reklamowa optymalizuje na podstawie mniejszej liczby konwersji, a twoje raporty pokazują niższy zwrot, niż naprawdę osiągasz. Oto drugi efekt w liczbach, dla przykładowego sklepu z ROAS progu rentowności równym 2.2:

Co daje WooCommerce: zamówienia, webhooki i REST API

Jakie statusy zamówień liczą się jako opłacone?

WooCommerce opisuje processing jako otrzymaną płatność, przy czym zamówienie czeka na realizację. ROASaurus wysyła zamówienia ze statusem processing lub completed i pomija zamówienia pending payment, on hold, failed, cancelled oraz refunded. Dwie metody płatności wymagają uwagi:

• Płatność za pobraniem. WooCommerce ustawia te zamówienia na processing do czasu odebrania płatności, więc ROASaurus wysyła je w chwili złożenia. Wyjątkiem są zamówienia z produktem do pobrania: trafiają one na on hold. Zobacz tracking zamówień za pobraniem, aby dowiedzieć się, co to oznacza dla zwrotów i odmów odbioru.
• Przelew bankowy. WooCommerce ustawia te zamówienia na on hold, dopóki weryfikujesz płatność. ROASaurus wysyła je, gdy zmienisz status na processing.

Webhooki

Webhook to wiadomość, którą WooCommerce wysyła do innego systemu, gdy coś się zmieni. Tworzysz go w WooCommerce › Settings › Advanced › Webhooks. Dla tematu zamówienia payload to ten sam obiekt zamówienia, który zwraca REST API. Każda dostawa zawiera nagłówek X-WC-Webhook-Signature: hash HMAC-SHA256 payloadu w base64, utworzony z sekretu, który wybierzesz. ROASaurus sprawdza ten podpis, zanim przyjmie zamówienie.

W praktyce liczą się dwa szczegóły. WooCommerce dostarcza webhooki w tle, domyślnie przez WP-Cron, więc dostawa może się opóźnić, gdy ta kolejka działa z opóźnieniem. WooCommerce wyłącza też webhook po więcej niż pięciu nieudanych dostawach z rzędu.

REST API

REST API pozwala ROASaurus samodzielnie pytać o zamówienia. Z kluczem API tylko do odczytu ROASaurus co 5 minut pyta o zamówienia processing i completed zmienione od ostatniego sprawdzenia, z 30 minutami nakładania się okresów. Zamówienia, które już ma, są ignorowane. Dzięki temu łapie każde zamówienie, które pominął webhook.

Wtyczka czy webhooki: dwa sposoby połączenia

Oba połączenia wysyłają każde opłacone zamówienie. Różnią się tym, jak dobrze każde zamówienie jest powiązane z kliknięciem w reklamę, które przyprowadziło kupującego.

Możesz używać obu naraz. Wtyczka zapisuje visitor id w zamówieniu jako metadane zamówienia, a payload webhooka je przenosi. ROASaurus zapisuje każde zamówienie raz, według jego id zamówienia w WooCommerce, więc wtyczka i webhook nigdy nie tworzą dwóch zakupów. Wtyczka deklaruje też obsługę High-Performance Order Storage w WooCommerce.

Jak zamówienie z WooCommerce jest dopasowywane do kliknięcia w reklamę?

Platforma reklamowa może przypisać zakup do reklamy tylko wtedy, gdy potrafi połączyć jedno z drugim. ROASaurus robi to, łącząc zamówienie z odwiedzającym, który kliknął reklamę, a ten odwiedzający niesie click id (takie jak fbclid i ttclid) oraz parametry UTM ze strony docelowej. Próbuje poniższych metod po kolei i zatrzymuje się na pierwszej, która zadziała:

1. Visitor id zapisane w zamówieniu. Tylko z wtyczką. To dokładne powiązanie.
2. Zakup z przeglądarki na stronie z podziękowaniem, który niesie to samo id zamówienia. Tylko z wtyczką.
3. Zahashowany e-mail, który odwiedzający podał wcześniej na twojej stronie, na przykład w formularzu popupu Klaviyo, Attentive lub Wisepops albo przez wywołanie Identify.
4. Ten sam adres IP i ta sama przeglądarka, widziane od 3 godzin przed zamówieniem do 15 minut po nim, ale tylko wtedy, gdy pasuje dokładnie jeden odwiedzający. W sieciach współdzielonych, takich jak biura i operatorzy komórkowi, kilku odwiedzających często dzieli jeden adres IP i wtedy ROASaurus nie zgaduje.

ROASaurus chwilę czeka, zanim wyśle każdy zakup, żeby zdarzenie ze strony z podziękowaniem mogło dotrzeć pierwsze. Jeśli zamówienie nadal nie jest dopasowane, próbuje jeszcze raz w momencie wysyłki. Strona Orders pokazuje wynik dla każdego zamówienia w kolumnie Matched by. Zamówienia powiązane przez visitor id z wtyczki pokazują cart, czyli tę samą etykietę, którą dostają zamówienia ze Shopify.

Te identyfikatory kliknięcia podnoszą odsetek dopasowań zdarzenia w Meta. Event Match Quality wyjaśnia, jak Meta je ocenia.

Zgody w WooCommerce

Każdy sklep w ROASaurus ma ustawienie Respect visitor consent, które jest domyślnie włączone. W WooCommerce skrypt ROASaurus odczytuje wybór odwiedzającego z WP Consent API, które wypełniają wtyczki zgód, takie jak Complianz i CookieYes. Odczytuje też Cookiebot, OneTrust, banery IAB TCF i Google consent mode. Dopóki odwiedzający nie zaakceptuje marketingowych cookie, skrypt nie ustawia visitor id i nie ładuje pikseli w przeglądarce.

Gdy odwiedzający odrzuci zgodę, skrypt nie ustawia visitor id, nie zachowuje click id i nie uruchamia pikseli w przeglądarce, a wtyczka nie zapisuje przy zamówieniu cookie trackingowych. Opłacone zamówienie nadal jest wysyłane z serwera do połączonych platform reklamowych, z zahashowanymi danymi klienta z zamówienia oraz adresem IP i przeglądarką z zamówienia. Jeśli twoja opinia prawna mówi, że zdarzenia zakupu też wymagają wcześniejszej zgody, skontaktuj się z ROASaurus, zanim włączysz zakupy server-side. Szczegóły są na stronie pomocy o zgodach, a tło prawne omawia wpis o Consent Mode v2 i RODO.

Jak skonfigurować server-side tracking w WooCommerce

Oto kroki dla wariantu z wtyczką:

1. Dodaj sklep

   W ROASaurus przejdź do Add a store, wybierz WooCommerce i wpisz domenę, na którą wchodzą twoi klienci.

2. Utwórz klucz API

   Otwórz Store settings i w sekcji Orders API kliknij Create API key. Skopiuj klucz od razu: jest pokazywany tylko raz, obok klucza sklepu. Endpoint to adres przed /api/v1/orders na tej stronie.

3. Zainstaluj wtyczkę

   Pobierz wtyczkę i wgraj plik zip w WordPressie w Plugins › Add New Plugin › Upload Plugin, a potem ją aktywuj.

4. Wpisz klucze

   W WooCommerce › ROASaurus wpisz endpoint, klucz sklepu i klucz API, a potem zapisz.

5. Połącz swoje platformy reklamowe

   W Tracking & platforms użyj Connect with Facebook albo Add pixel dla Meta, TikTok i pozostałych. Zaznacz opcję ładowania także piksela w przeglądarce, aby zakup ze strony z podziękowaniem był deduplikowany ze zdarzeniem z serwera.

6. Skonfiguruj zgody i przetestuj

   Zablokuj skrypt w narzędziu do zgód, dopóki odwiedzający nie zaakceptuje marketingowych cookie, a potem złóż testowe zamówienie.

Bez wtyczki dodaj tag skryptu z Tracking & platforms na każdą stronę, a potem utwórz webhook. Karta Connection twojego sklepu pokazuje adres URL webhooka. Zachowaj go w tajemnicy: każdy, kto ma ten adres, może wysyłać zamówienia do twojego sklepu.

WooCommerce › Settings › Advanced › Webhooks › Add webhook

Status        Active
Topic         Order updated
Delivery URL  (your webhook URL from the Connection tab)
Secret        (a secret of your choice; paste the same one in ROASaurus)
API version   WP REST API Integration v3

Dla kopii zapasowej utwórz klucz w WooCommerce › Settings › Advanced › REST API z dostępem do odczytu. Wklej consumer key i secret na karcie Connection, zapisz i naciśnij Test connection. Fetch orders now od razu pobiera ostatnie opłacone zamówienia. Wszystkie opcje w jednym miejscu wymienia strona integracji z WooCommerce.

Jak przetestować server-side tracking w WooCommerce?

Najpierw przetestuj stronę przeglądarki, potem złóż zamówienie i śledź je aż do platform reklamowych.

• Otwórz swój sklep z ?roasaurus=connected w adresie. Alert potwierdzi, że skrypt działa. Z ?roasaurus=debug skrypt zapisuje w konsoli przeglądarki to, co wysyła.
• W Event log, w sekcji Collected events, wyświetlenia stron powinny pokazywać visitor id.
• Złóż testowe zamówienie. Najszybsza jest płatność za pobraniem, bo zamówienie od razu ma status processing.
• Na karcie Connection pole Last order received pokazuje czas ostatniego zamówienia.
• W Event log, w sekcji Server deliveries, każda połączona platforma ma wiersz ze statusem sent i odpowiedzią platformy.

Aby zobaczyć zdarzenie w Meta, wklej kod z Events Manager › Test events w pole Test event code swojego piksela Meta w ROASaurus. Usuń go, gdy skończysz, bo kod jest przeznaczony tylko do testów. Jeśli wtyczka nie może dostarczyć zamówienia, dodaje w WooCommerce notatkę do zamówienia zaczynającą się od „ROASaurus: order not sent”, po której następuje błąd.

Błędy, których warto unikać

• Użycie tematu Order created. Zamówienia opłacane przez przekierowanie są tworzone jako pending payment. ROASaurus ignoruje nieopłacone zamówienia i po nadejściu płatności nie następuje drugi komunikat „created”. Użyj Order updated.
• Sekret, który się nie zgadza. ROASaurus odrzuca dostawę, której podpis nie pasuje do sekretu, który ma. Po więcej niż pięciu niepowodzeniach z rzędu WooCommerce wyłącza webhook. Popraw sekret, ustaw webhook z powrotem na Active i dodaj klucz REST API, żeby zamówienia z tej luki zostały pobrane.
• Dwa narzędzia wysyłające ten sam piksel. Jeśli inna wtyczka także wysyła twój piksel Meta lub TikTok, używa własnych event id, a platforma liczy każdą sprzedaż dwa razy. Wyłącz ją dla tego piksela. Zobacz zapobieganie podwójnemu liczeniu i zduplikowane zdarzenia zakupu.
• Oczekiwanie zdarzeń dodania do koszyka. W WooCommerce skrypt sam śledzi wyświetlenia stron. Wyświetlenia produktów i dodania do koszyka są wykrywane automatycznie tylko w Shopify. Programista może je wysłać wywołaniem track tlq.
• Oczekiwanie konwersji Google Ads. ROASaurus wysyła konwersje zakupu Google Ads tylko z checkoutu Shopify. Z WooCommerce wysyła zakupy do Meta, TikTok, Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn i innych połączonych platform reklamowych.
• Spóźnione przelewy bankowe. Meta przyjmuje zdarzenia server-side do 7 dni po czasie zdarzenia. Wtyczka wysyła zamówienie z datą jego utworzenia, więc Meta odrzuca przelew potwierdzony po więcej niż 7 dniach od checkoutu. Zamówienia docierające przez webhook lub REST API używają zamiast tego daty płatności. Zwróć też uwagę, że strona z podziękowaniem uruchamia zakup z przeglądarki w momencie checkoutu, zanim przelew zostanie opłacony. Jeśli płatność zostanie potwierdzona po więcej niż 48 godzinach, Meta i TikTok nie mogą scalić kopii z przeglądarki i z serwera, a przelew, który nigdy nie zostanie opłacony, zachowuje swój zakup z przeglądarki.

Gdy zamówienia zaczną płynąć, raporty atrybucji pokażą, z jakich kampanii i reklam pochodzą.

Źródła

1. WooCommerce: Webhooks Documentation
2. WooCommerce REST API Documentation - WP REST API v3
3. WooCommerce: Order Statuses Documentation
4. WooCommerce: Cash on Delivery Documentation
5. Meta for Developers: Server Event Parameters

W ROASaurus

• Integracja z WooCommerce
• Pomoc: WooCommerce i własne witryny
• Server-side tracking

Czytaj dalej