Praćenje konverzija za Lightspeed eCom web-trgovine

Praćenje konverzija za Lightspeed znači prijavljivanje svake plaćene narudžbe u vašoj Lightspeed eCom web-trgovini oglasnim platformama poput Mete i TikToka, kako bi pripisale prave oglase i optimizirale vaše kampanje. Pouzdan način je slati svaku kupnju iz Lightspeedovih podataka o narudžbi na poslužitelju te na stranicu zahvale dodati kratak isječak koji povezuje narudžbu s klikom na oglas.

Ovaj vodič obuhvaća na koji se Lightspeed proizvod odnosi, kako narudžbe stižu u ROASaurus, što se čita iz svake narudžbe, kako kupnje stižu na Metu i TikTok, postavljanje, testiranje i ograničenja koja trebate znati.

Koji Lightspeed proizvod pokriva ovaj vodič?

Lightspeed prodaje više od jednog proizvoda za e-trgovinu, pa najprije provjerite svoj. ROASaurus se povezuje s Lightspeed eCom (C-Series), platformom za web-trgovine čiji back office ima Settings › Website Settings › Web Extras. Njegov API radi na dva klastera:

Svaka adresa API-ja sadrži i dvoslovnu oznaku jezika, primjerice /nl/ ili /en/. ROASaurus je traži kao jezik trgovine i koristi nl ako ostavite prazno.

Lightspeed nudi i eCom (E-Series). Lightspeed opisuje prelazak na E-Series kao nadogradnju na zaseban proizvod koji se trenutačno nudi određenim sjevernoameričkim trgovcima. ROASaurus Lightspeed konektor čita narudžbe samo putem C-Series API-ja, pa ne pokriva E-Series trgovine.

Zašto Lightspeed kupnje nedostaju na Meti i TikToku?

Piksel u pregledniku prijavljuje kupnju samo kada preglednik kupca učita stranicu zahvale i izvrši se skripta piksela. To ne uspijeva u nekoliko uobičajenih situacija:

• Kupac plaća preusmjeravanjem, primjerice putem iDEAL-a ili PayPala, i zatvori karticu prije nego što se učita stranica zahvale.
• Blokator oglasa ili postavka privatnosti preglednika blokira skriptu piksela.
• Posjetitelj odbije marketinške kolačiće, pa se piksel ne smije učitati.
• Narudžba se plaća kasnije, primjerice bankovnim prijenosom, kada preglednik nije uključen.
• Safari ograničava koliko dugo traju kolačići koje postavljaju skripte, pa preglednik može zaboraviti stariji klik na oglas.

Kako Lightspeed narudžbe stižu u ROASaurus?

Kada pritisnete Create webhook, ROASaurus u Lightspeedu registrira webhook za grupu orders i radnju updated, u JSON formatu. Od tada Lightspeed poziva ROASaurus kad god se narudžba promijeni.

Zašto ROASaurus ponovno čita narudžbu

Lightspeed webhooku dodaje zaglavlje x-signature samo ako ga je izradila aplikacija. Webhook izrađen običnim API ključem, kao ovdje, nije potpisan. Zato adresa webhooka sadrži token jedinstven za vašu trgovinu, a ROASaurus ne vjeruje sadržaju zahtjeva. Narudžbu i njezine proizvode čita iz Lightspeed API-ja i sam provjerava status plaćanja.

Provjera svakih 5 minuta

Svakih 5 minuta ROASaurus od Lightspeeda traži i narudžbe ažurirane od zadnje provjere, uz 30 minuta preklapanja, te bilježi plaćene narudžbe koje još nema. Budući da ova provjera koristi vrijeme ažuriranja, narudžba plaćena danima nakon što je napravljena preuzima se čak i ako isporuka njezina webhooka nije uspjela. Narudžbe koje ROASaurus već ima ignoriraju se, pa webhook i provjera nikad ne stvaraju dvije kupnje.

Na strani Lightspeeda webhook mora dobiti odgovor 2xx u roku od 5 sekundi. Neuspjele isporuke ponavljaju se, ukupno do 10 pokušaja, a webhook čiji udio pogrešaka ostane iznad 50% 50 sati isključuje se. Provjera svakih 5 minuta održava dotok narudžbi tijekom takvog prekida.

Što ROASaurus čita iz Lightspeed narudžbe?

Vrijednost kupnje uključuje PDV

Lightspeedov priceIncl je cijena narudžbe s porezom i to je vrijednost koju ROASaurus šalje. Vaše oglasne platforme stoga prijavljuju prihod s uključenim PDV-om. Evo učinka uz PDV od 21%:

ROAS točke pokrića koristi prihod bez PDV-a. Prije usporedbe podijelite ROAS platforme s 1 plus vaša stopa PDV-a.

Kako se Lightspeed narudžba povezuje s klikom na oglas?

Da bi pripisala oglas, platformi su potrebni identifikatori klika posjetitelja koji je naručio: Metin ID klika i ID preglednika (fbc, fbp), TikTokov ID klika (ttclid) i TikTokov kolačić (ttp). ROASaurus skripta sprema ih za svakog posjetitelja kada stigne iz oglasa. ROASaurus taj ID posjetitelja ne dobiva iz Lightspeed narudžbe, pa svaku narudžbu povezuje s posjetiteljem na drugi način. Isprobava tri metode, ovim redoslijedom:

Isječak prosljeđuje i ukupan iznos narudžbe, valutu i adresu e-pošte kupca. ROASaurus sprema hash te adrese e-pošte uz posjetitelja, što pomaže povezati sljedeću narudžbu istog kupca. ROASaurus kratko pričeka prije slanja svake kupnje kako bi događaj sa stranice zahvale mogao stići prvi, a povezivanje ponovno pokuša u trenutku slanja.

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

Stranica Orders prikazuje kako je svaka narudžba povezana, u stupcu Matched by: thank_you, email, ip ili not matched. Nepovezana narudžba i dalje odlazi na vaše oglasne platforme sa svojim podacima o narudžbi, ali bez identifikatora klikova, a ROASaurus atribucija prikazuje je kao direktnu ili nepoznatu.

Slanje Lightspeed kupnji na Meta i TikTok

Svaka plaćena narudžba postaje jedan događaj s poslužitelja po povezanoj platformi: Purchase za Metin Conversions API i CompletePayment za TikTokov Events API, oba s ID-om događaja order-ORD01042. TikTok sada CompletePayment u svojim izvješćima prikazuje kao Purchase. Kada označite opciju za učitavanje i piksela u pregledniku, isječak na stranici zahvale aktivira iste događaje u pregledniku s istim ID-om događaja. Meta i TikTok tada zadržavaju jednu kopiju.

Iste narudžbe idu i na Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboolu, LinkedIn i ostale oglasne platforme kada ih povežete. Konverzije kupnje za Google Ads šalju se samo iz Shopify naplate, pa ih ROASaurus ne šalje iz Lightspeeda. Za dio postavljanja na strani Mete pogledajte vodič za Meta Conversions API.

Kako postaviti praćenje konverzija za Lightspeed

1. Dodajte trgovinu u ROASaurus

   Idite na Add a store, odaberite Lightspeed eCom i unesite adresu svoje trgovine. Kartica Connection tada prikazuje vašu oznaku skripte i isječak za stranicu zahvale.

2. Dodajte skriptu na svaku stranicu

   U Lightspeed back officeu idite na Settings › Website Settings › Web Extras › Custom JavaScript i zalijepite oznaku skripte. Lightspeed taj kod izvršava na svim stranicama.

3. Dodajte isječak za stranicu zahvale

   Na istoj stranici, u području Tracking, uključite Status i zalijepite isječak. Lightspeed ga izvršava na stranici Thank You nakon narudžbe.

4. Izradite API ključ

   Idite na Settings › Store Settings › Developers › New API key. Uključite ključ, označite pristup za čitanje narudžbi, spremite i odaberite Show da biste vidjeli tajni ključ.

5. Povežite API

   Na kartici Connection unesite ključ, tajni ključ, regiju i jezik trgovine. Spremite, pritisnite Test connection, zatim Create webhook.

6. Povežite svoje oglasne platforme

   Na Tracking & platforms koristite Connect with Facebook ili Add pixel za Metu, a Add pixel za TikTok uz kod piksela i pristupni token za Events API. Označite opciju za učitavanje i piksela u pregledniku.

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)

Privola

Izvan Shopifyja ROASaurus skripta čita izbor posjetitelja iz uobičajenih alata za privolu: Cookiebot, OneTrust, bannera IAB TCF i signala Google consent mode. S drugim bannerom za kolačiće pozovite tlq('consent', true) kada posjetitelj prihvati marketinške kolačiće i tlq('consent', false) kada ih odbije. Dok posjetitelj ne prihvati, nema ID-ja posjetitelja ni ID-ova klika i ne pokreće se nijedan piksel u pregledniku. Plaćena narudžba i dalje se s poslužitelja šalje s hashiranim podacima o kupcu iz narudžbe te IP adresom i preglednikom narudžbe. Pojedinosti su na stranici pomoći o privoli.

Kako testirati praćenje konverzija za Lightspeed?

• Otvorite svoju trgovinu s ?roasaurus=connected u adresi. Upozorenje potvrđuje da skripta radi. ?roasaurus=debug bilježi u konzolu preglednika što šalje.
• U Event log, pod Collected events, prikazi stranica trebali bi prikazivati ID posjetitelja.
• Napravite narudžbu i provjerite je li njezin status plaćanja paid. Pod Collected events Event log tada treba prikazati Purchase s vašim brojem narudžbe u podacima. Ako ga nema, provjerite je li Status uključen u području Tracking.
• Na kartici Connection Last order received prikazuje narudžbu, a Last sync zadnju provjeru od 5 minuta, uz eventualnu pogrešku iz Lightspeeda.
• Pod Server deliveries u Event log, svaka povezana platforma dobiva redak sa statusom sent i odgovorom platforme.

Da biste događaj vidjeli na Meti, zalijepite kod iz Events Manager › Test events u polje Test event code svog Meta piksela u ROASaurusu i uklonite ga kada završite. Postavke TikTokova piksela u ROASaurusu imaju isto polje.

Ograničenja i rubni slučajevi

• Samo C-Series. Lightspeed eCom E-Series trgovine ne mogu koristiti ovaj konektor.
• Samo plaćene narudžbe. Djelomično plaćena narudžba šalje se kada se njezin status plaćanja promijeni u paid.
• Kasna plaćanja i Metino ograničenje od 7 dana. Meta prihvaća događaje s poslužitelja do 7 dana nakon vremena događaja. ROASaurus koristi vrijeme izrade narudžbe, pa Meta odbija narudžbu plaćenu više od 7 dana nakon što je napravljena.
• Kupnje u pregledniku prije plaćanja. Isječak na stranici zahvale izvršava se kada se narudžba napravi, pa pikseli u pregledniku prijavljuju narudžbu bankovnim prijenosom prije nego što je plaćena. Ako plaćanje stigne više od 48 sati kasnije, Meta i TikTok ne mogu spojiti kopije iz preglednika i s poslužitelja.
• Otkazivanja i povrati se ne šalju. Nakon što se kupnja pošalje, ostaje na oglasnoj platformi.
• Bez koda samo prikazi stranica. Pregledi proizvoda i dodavanja u košaricu automatski se otkrivaju samo na Shopifyju. Na Lightspeedu ih programer može poslati pozivom tlq track.
• Ograničenja API-ja. Lightspeed dopušta 300 zahtjeva na 5 minuta, 3,000 na sat i 12,000 na dan po API ključu. Ako isti ključ koristi drugi alat, dijele ta ograničenja. Lightspeed traži da ih kontaktirate za drugi ključ.

Stranica integracije Lightspeed na jednom mjestu navodi činjenice o povezivanju, a stranica pomoći za druge web-trgovine uspoređuje Lightspeed s ostalim platformama s kojima se ROASaurus povezuje.

Izvori

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

U ROASaurusu

• Lightspeed integracija
• Pomoć: Wix, Lightspeed i druge web-trgovine
• Praćenje na strani poslužitelja
• Integracija s Metom

Nastavite čitati