Tracking konwersji w Lightspeed dla sklepów eCom

Tracking konwersji w Lightspeed oznacza zgłaszanie każdego opłaconego zamówienia w twoim sklepie Lightspeed eCom do platform reklamowych, takich jak Meta i TikTok, żeby mogły przypisywać zasługi właściwym reklamom i optymalizować twoje kampanie. Niezawodny sposób to wysyłanie każdego zakupu z danych zamówienia Lightspeed na serwerze i dodanie krótkiego fragmentu kodu na stronie z podziękowaniem, który łączy zamówienie z kliknięciem w reklamę.

Ten poradnik opisuje, do którego produktu Lightspeed się odnosi, jak zamówienia trafiają do ROASaurus, co jest odczytywane z każdego zamówienia, jak zakupy docierają do Meta i TikTok, konfigurację, testowanie i ograniczenia, które warto znać.

Jakiego produktu Lightspeed dotyczy ten poradnik?

Lightspeed sprzedaje więcej niż jeden produkt ecommerce, więc najpierw sprawdź swój. ROASaurus łączy się z Lightspeed eCom (C-Series), platformą sklepów internetowych, której panel administracyjny ma Settings › Website Settings › Web Extras. Jej API działa w dwóch klastrach:

Każdy adres API zawiera też dwuliterowy kod języka, na przykład /nl/ lub /en/. ROASaurus prosi o niego jako o język sklepu i używa nl, gdy zostawisz to pole puste.

Lightspeed oferuje też eCom (E-Series). Lightspeed opisuje przejście na E-Series jako uaktualnienie do osobnego produktu, obecnie oferowane wybranym sprzedawcom z Ameryki Północnej. Konektor ROASaurus dla Lightspeed odczytuje zamówienia wyłącznie przez API C-Series, więc nie obejmuje sklepów E-Series.

Dlaczego zakupy z Lightspeed znikają w Meta i TikToku?

Piksel w przeglądarce zgłasza zakup tylko wtedy, gdy przeglądarka kupującego załaduje stronę z podziękowaniem i uruchomi się skrypt piksela. To zawodzi w kilku częstych sytuacjach:

• Kupujący płaci przez przekierowanie, na przykład iDEAL lub PayPal, i zamyka kartę, zanim załaduje się strona z podziękowaniem.
• Bloker reklam albo ustawienie prywatności w przeglądarce blokuje skrypt piksela.
• Odwiedzający odrzuca marketingowe cookie, więc piksel nie może się załadować.
• Zamówienie jest opłacane później, na przykład przelewem bankowym, gdy żadna przeglądarka nie bierze udziału.
• Safari ogranicza czas życia cookie ustawianych przez skrypty, więc przeglądarka może zapomnieć starsze kliknięcie w reklamę.

Jak zamówienia z Lightspeed trafiają do ROASaurus?

Gdy naciśniesz Create webhook, ROASaurus rejestruje w Lightspeed webhook dla grupy orders i akcji updated, w formacie JSON. Od tej chwili Lightspeed wywołuje ROASaurus, gdy zamówienie się zmienia.

Dlaczego ROASaurus odczytuje zamówienie ponownie

Lightspeed dodaje nagłówek x-signature do webhooka tylko wtedy, gdy utworzyła go aplikacja. Webhook utworzony zwykłym kluczem API, jak tutaj, nie jest podpisany. Dlatego adres webhooka zawiera token unikalny dla twojego sklepu, a ROASaurus nie ufa przesłanej treści. Odczytuje zamówienie i jego produkty z API Lightspeed i sam sprawdza status płatności.

Sprawdzanie co 5 minut

Co 5 minut ROASaurus pyta też Lightspeed o zamówienia zaktualizowane od ostatniej kontroli, z 30-minutowym zakresem nakładania się, i zapisuje opłacone zamówienia, których jeszcze nie ma. Ponieważ ta kontrola używa czasu aktualizacji, zamówienie opłacone kilka dni po złożeniu zostanie wychwycone, nawet jeśli dostarczenie jego webhooka się nie powiodło. Zamówienia, które ROASaurus już ma, są ignorowane, więc webhook i kontrola nigdy nie tworzą dwóch zakupów.

Po stronie Lightspeed webhook musi dostać odpowiedź 2xx w ciągu 5 sekund. Nieudane dostarczenia są ponawiane, łącznie do 10 prób, a webhook, którego wskaźnik błędów przez 50 godzin utrzymuje się powyżej 50%, zostaje wyłączony. Kontrola co 5 minut sprawia, że zamówienia nadal napływają w takiej przerwie.

Co ROASaurus odczytuje z zamówienia Lightspeed?

Wartość zakupu zawiera VAT

priceIncl z Lightspeed to cena zamówienia z podatkiem i właśnie tę wartość wysyła ROASaurus. Twoje platformy reklamowe raportują więc przychód z VAT. Oto efekt przy 21% VAT:

ROAS progu rentowności opiera się na przychodzie bez VAT. Podziel ROAS platformy przez 1 plus twoja stawka VAT, zanim porównasz oba.

Jak zamówienie z Lightspeed jest powiązane z kliknięciem w reklamę?

Aby przypisać zasługę reklamie, platforma potrzebuje identyfikatorów kliknięcia odwiedzającego, który złożył zamówienie: click id Meta i browser id (fbc, fbp), click id TikTok (ttclid) i cookie TikTok (ttp). Skrypt ROASaurus zapisuje je dla każdego odwiedzającego, gdy trafia z reklamy. ROASaurus nie dostaje visitor id z zamówienia Lightspeed, więc łączy każde zamówienie z odwiedzającym w inny sposób. Próbuje trzech metod, w tej kolejności:

Fragment kodu przekazuje też sumę zamówienia, walutę i e-mail klienta. ROASaurus zapisuje przy odwiedzającym hash tego e-maila, co pomaga dopasować następne zamówienie tego samego kupującego. ROASaurus czeka krótko przed wysłaniem każdego zakupu, żeby zdarzenie ze strony podziękowania mogło dotrzeć pierwsze, i próbuje dopasowania ponownie w chwili wysyłki.

Lightspeed variables used by the ROASaurus snippet (Tracking box)

order.information.number      order id and event id order-<number>
order.information.price_incl  value
order.information.currency    currency
order.customer.email          email, hashed on the visitor

Strona Orders pokazuje, jak każde zamówienie zostało powiązane, w kolumnie Matched by: thank_you, email, ip lub not matched. Niedopasowane zamówienie nadal trafia do twoich platform reklamowych z danymi zamówienia, ale bez identyfikatorów kliknięcia, a atrybucja ROASaurus pokazuje je jako bezpośrednie lub nieznane.

Wysyłanie zakupów z Lightspeed do Meta i TikTok

Każde opłacone zamówienie staje się jednym zdarzeniem server-side dla każdej połączonej platformy: Purchase dla Conversions API Meta i CompletePayment dla Events API TikToka, oba z event id order-ORD01042. TikTok pokazuje teraz CompletePayment w raportach jako Purchase. Gdy zaznaczysz opcję ładowania także piksela w przeglądarce, fragment kodu na stronie z podziękowaniem uruchamia te same zdarzenia w przeglądarce z tym samym event id. Meta i TikTok zachowują wtedy jedną kopię.

Te same zamówienia trafiają do Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn i innych platform reklamowych, gdy je połączysz. Konwersje zakupu Google Ads są wysyłane wyłącznie z checkoutu Shopify, więc ROASaurus nie wysyła ich z Lightspeed. Konfigurację po stronie Meta opisuje poradnik Meta Conversions API.

Jak skonfigurować tracking konwersji w Lightspeed

1. Dodaj sklep w ROASaurus

   Przejdź do Add a store, wybierz Lightspeed eCom i wpisz adres swojego sklepu. Karta Connection pokaże wtedy twój tag skryptu i fragment kodu na stronę z podziękowaniem.

2. Dodaj skrypt na każdej stronie

   W panelu administracyjnym Lightspeed przejdź do Settings › Website Settings › Web Extras › Custom JavaScript i wklej tag skryptu. Lightspeed uruchamia ten kod na wszystkich stronach.

3. Dodaj fragment kodu na stronę z podziękowaniem

   Na tej samej stronie w obszarze Tracking włącz Status i wklej fragment kodu. Lightspeed uruchamia go na stronie Thank You po zamówieniu.

4. Utwórz klucz API

   Przejdź do Settings › Store Settings › Developers › New API key. Włącz klucz, zaznacz dostęp do odczytu zamówień, zapisz i wybierz Show, aby zobaczyć secret.

5. Połącz API

   Na karcie Connection wpisz klucz, secret, region i język sklepu. Zapisz, naciśnij Test connection, a potem Create webhook.

6. Połącz swoje platformy reklamowe

   W Tracking & platforms użyj Connect with Facebook lub Add pixel dla Meta oraz Add pixel dla TikToka z kodem piksela i tokenem dostępu do Events API. Zaznacz opcję ładowania także piksela w przeglądarce.

API key          (Settings › Store Settings › Developers)
API secret       (select Show next to the key)
Region           eu  →  api.webshopapp.com
                 us  →  api.shoplightspeed.com
Shop language    nl, en, de ...  (the code in your API addresses)

Zgoda

Poza Shopify skrypt ROASaurus odczytuje wybór odwiedzającego z popularnych narzędzi do zgód: Cookiebot, OneTrust, banerów IAB TCF i Google consent mode. W przypadku innego banera cookie wywołaj tlq('consent', true), gdy odwiedzający zaakceptuje marketingowe cookie, i tlq('consent', false), gdy je odrzuci. Dopóki odwiedzający nie zaakceptuje, nie ma visitor id ani click id, a piksele w przeglądarce się nie uruchamiają. Opłacone zamówienie nadal jest wysyłane z serwera z zahashowanymi danymi klienta z zamówienia oraz adresem IP i przeglądarką z zamówienia. Szczegóły wyjaśnia strona pomocy o zgodach.

Jak przetestować tracking konwersji w Lightspeed?

• Otwórz swój sklep z ?roasaurus=connected w adresie. Alert potwierdza, że skrypt działa. ?roasaurus=debug zapisuje w konsoli przeglądarki to, co skrypt wysyła.
• W Event log, w sekcji Collected events, wyświetlenia stron powinny pokazywać visitor id.
• Złóż zamówienie i upewnij się, że jego status płatności to paid. W Collected events Event log powinien wtedy pokazać Purchase z numerem twojego zamówienia w danych. Jeśli go brakuje, sprawdź, czy Status jest włączony w obszarze Tracking.
• Na karcie Connection Last order received pokazuje zamówienie, a Last sync ostatnią kontrolę co 5 minut, z ewentualnym błędem z Lightspeed.
• W Server deliveries w Event log każda podłączona platforma dostaje wiersz ze statusem sent i odpowiedzią platformy.

Aby zobaczyć zdarzenie w Meta, wklej kod z Events Manager › Test events do pola Test event code swojego piksela Meta w ROASaurus i usuń go, gdy skończysz. Ustawienia piksela TikToka w ROASaurus mają to samo pole.

Ograniczenia i przypadki brzegowe

• Tylko C-Series. Sklepy Lightspeed eCom E-Series nie mogą używać tego konektora.
• Tylko opłacone zamówienia. Częściowo opłacone zamówienie jest wysyłane, gdy jego status płatności zmieni się na paid.
• Opóźnione płatności i 7-dniowy limit Meta. Meta przyjmuje zdarzenia server-side do 7 dni po czasie zdarzenia. ROASaurus używa czasu utworzenia zamówienia, więc zamówienie opłacone ponad 7 dni po złożeniu zostaje odrzucone przez Meta.
• Zakupy w przeglądarce przed płatnością. Fragment kodu na stronie z podziękowaniem uruchamia się w chwili złożenia zamówienia, więc piksele w przeglądarce zgłaszają zamówienie z przelewem bankowym, zanim zostanie opłacone. Jeśli płatność nadejdzie ponad 48 godzin później, Meta i TikTok nie mogą scalić kopii z przeglądarki i server-side.
• Anulowania i zwroty nie są wysyłane. Gdy zakup zostanie wysłany, zostaje w platformie reklamowej.
• Bez dodatkowego kodu tylko odsłony stron. Wyświetlenia produktów i dodania do koszyka są wykrywane automatycznie tylko w Shopify. W Lightspeed programista może je wysłać wywołaniem tlq track.
• Limity API. Lightspeed dopuszcza 300 żądań na 5 minut, 3,000 na godzinę i 12,000 na dobę na klucz API. Jeśli inne narzędzie używa tego samego klucza, dzielą te limity. Lightspeed prosi o kontakt w sprawie drugiego klucza.

Strona integracji Lightspeed zbiera fakty o połączeniu w jednym miejscu, a strona pomocy o innych sklepach internetowych porównuje Lightspeed z pozostałymi platformami, z którymi łączy się ROASaurus.

Źródła

1. Lightspeed eCom (C-Series) Help Center: Adding a web tracking code
2. Lightspeed eCom (C-Series) Help Center: Creating API keys
3. Lightspeed eCom developers: Webhooks
4. Lightspeed eCom developers: Order
5. Lightspeed eCom developers: Rate limiting

W ROASaurus

• Integracja z Lightspeed
• Pomoc: Wix, Lightspeed i inne sklepy internetowe
• Server-side tracking
• Integracja z Meta

Czytaj dalej