Konverteringstracking for Lightspeed i eCom-nettbutikker

Konverteringstracking for Lightspeed betyr å rapportere hver betalte bestilling i Lightspeed eCom-nettbutikken din til annonseplattformer som Meta og TikTok, slik at de kan kreditere de riktige annonsene og optimalisere kampanjene dine. Den pålitelige måten er å sende hvert kjøp fra Lightspeeds bestillingsdata på serveren, og å legge til en kort snutt på takkesiden som kobler bestillingen til annonseklikket.

Denne guiden tar for seg hvilket Lightspeed-produkt den gjelder for, hvordan bestillinger når ROASaurus, hva som leses fra hver bestilling, hvordan kjøp når Meta og TikTok, oppsettet, testing og begrensningene du bør kjenne til.

Hvilket Lightspeed-produkt dekker denne guiden?

Lightspeed selger mer enn ett e-handelsprodukt, så sjekk ditt først. ROASaurus kobler til Lightspeed eCom (C-Series), nettbutikkplattformen der administrasjonen har Settings › Website Settings › Web Extras. API-et kjører på to clustere:

Hver API-adresse inneholder også en språkkode på to bokstaver, for eksempel /nl/ eller /en/. ROASaurus ber om den som butikkspråk og bruker nl når du lar den stå tom.

Lightspeed tilbyr også eCom (E-Series). Lightspeed beskriver overgangen til E-Series som en oppgradering til et eget produkt, som for tiden tilbys enkelte nordamerikanske forhandlere. ROASaurus-koblingen til Lightspeed leser bestillinger bare gjennom C-Series-API-et, så den dekker ikke E-Series-butikker.

Hvorfor forsvinner Lightspeed-kjøp i Meta og TikTok?

En pixel i nettleseren rapporterer et kjøp bare når kjøperens nettleser laster takkesiden og pixelskriptet kjører. Det svikter i flere vanlige situasjoner:

• En kjøper betaler via omdirigering, for eksempel med iDEAL eller PayPal, og lukker fanen før takkesiden er lastet.
• En annonseblokkerer eller en personverninnstilling i nettleseren blokkerer pixelskriptet.
• Den besøkende avslår markedsføringscookies, så pixelen må ikke lastes.
• Bestillingen betales senere, for eksempel med bankoverføring, når ingen nettleser er involvert.
• Safari begrenser hvor lenge cookies satt av skript varer, så nettleseren kan glemme et eldre annonseklikk.

Hvordan når Lightspeed-bestillinger fram til ROASaurus?

Når du trykker på Create webhook, registrerer ROASaurus en webhook i Lightspeed for gruppen orders og handlingen updated, i JSON-format. Fra da av kaller Lightspeed ROASaurus når en bestilling endres.

Hvorfor ROASaurus leser bestillingen på nytt

Lightspeed legger til en x-signature-header på en webhook bare når en app opprettet den. En webhook opprettet med en vanlig API-nøkkel, som her, er usignert. Derfor inneholder webhook-adressen et token som er unikt for butikken din, og ROASaurus stoler ikke på payloaden. Den leser bestillingen og produktene fra Lightspeed-API-et og sjekker betalingsstatusen selv.

5-minuttersjekken

Hvert 5. minutt ber ROASaurus også Lightspeed om bestillinger oppdatert siden forrige sjekk, med 30 minutters overlapping, og registrerer de betalte bestillingene den ikke har ennå. Fordi sjekken bruker oppdateringstidspunktet, fanges en bestilling som er betalt dager etter at den ble lagt inn, opp selv om webhook-leveringen mislyktes. Bestillinger ROASaurus allerede har, ignoreres, så webhooken og sjekken aldri oppretter to kjøp.

På Lightspeeds side må en webhook få et 2xx-svar innen 5 sekunder. Mislykkede leveringer prøves på nytt, opptil 10 forsøk totalt, og en webhook der feilraten holder seg over 50% i 50 timer, deaktiveres. Sjekken hvert 5. minutt holder bestillingene i gang under et slikt opphold.

Hva leser ROASaurus fra en Lightspeed-bestilling?

Kjøpsverdien inkluderer mva.

Lightspeeds priceIncl er bestillingsprisen inkludert skatt, og det er verdien ROASaurus sender. Annonseplattformene dine rapporterer derfor omsetning med mva. inkludert. Her er effekten ved 21% mva.:

En break-even-ROAS bruker omsetning uten mva. Del plattformens ROAS på 1 pluss mva.-satsen din før du sammenligner de to.

Hvordan kobles en Lightspeed-bestilling til annonseklikket?

For å kreditere en annonse trenger plattformen klikkidentifikatorene til den besøkende som bestilte: Meta click id og nettleser-ID (fbc, fbp), TikTok click id (ttclid) og TikTok-cookien (ttp). ROASaurus-skriptet lagrer dem for hver besøkende når de lander fra en annonse. ROASaurus får ikke denne besøks-ID-en fra Lightspeed-bestillingen, så den kobler hver bestilling til en besøkende på en annen måte. Den prøver tre metoder, i denne rekkefølgen:

Snutten sender også med bestillingens totalbeløp, valuta og kundens e-post. ROASaurus lagrer en hash av den e-posten på den besøkende, noe som hjelper til med å koble den samme kjøperens neste bestilling. ROASaurus venter en kort stund før den sender hvert kjøp, så takkeeventen kan komme først, og den prøver koblingen på nytt når kjøpet sendes.

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

Siden Orders viser hvordan hver bestilling ble koblet, i kolonnen Matched by: thank_you, email, ip eller not matched. En bestilling som ikke er koblet, går fortsatt til annonseplattformene dine med bestillingsdataene sine, men uten klikkidentifikatorer, og ROASaurus-attribusjonen viser den som direkte eller ukjent.

Slik sender du Lightspeed-kjøp til Meta og TikTok

Hver betalte bestilling blir én server-event per tilkoblede plattform: en Purchase for Metas Conversions API og en CompletePayment for TikToks Events API, begge med event-ID-en order-ORD01042. TikTok viser nå CompletePayment som Purchase i rapportene sine. Når du huker av for å også laste nettleserpixelen, utløser snutten på takkesiden de samme eventene i nettleseren med samme event-ID. Meta og TikTok beholder da én kopi.

De samme bestillingene går til Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn og de andre annonseplattformene når du kobler dem til. Kjøpskonverteringer i Google Ads sendes bare fra Shopify checkout, så ROASaurus sender dem ikke fra Lightspeed. For Metas del av oppsettet, se guiden til Meta Conversions API.

Slik setter du opp konverteringstracking for Lightspeed

1. Legg til butikken i ROASaurus

   Gå til Add a store, velg Lightspeed eCom og skriv inn butikkadressen din. Fanen Connection viser deretter script-taggen og snutten for takkesiden.

2. Legg skriptet til på hver side

   I Lightspeed-administrasjonen går du til Settings › Website Settings › Web Extras › Custom JavaScript og limer inn script-taggen. Lightspeed kjører denne koden på alle sider.

3. Legg til snutten for takkesiden

   På den samme siden, i området Tracking, slår du på Status og limer inn snutten. Lightspeed kjører den på Thank You-siden etter en bestilling.

4. Opprett en API-nøkkel

   Gå til Settings › Store Settings › Developers › New API key. Slå på nøkkelen, huk av for lesetilgang til bestillinger, lagre, og velg Show for å se hemmeligheten.

5. Koble til API-et

   På fanen Connection skriver du inn nøkkelen, hemmeligheten, regionen og butikkspråket. Lagre, trykk Test connection, og deretter Create webhook.

6. Koble til annonseplattformene dine

   Under Tracking & platforms bruker du Connect with Facebook eller Add pixel for Meta, og Add pixel for TikTok med pixelkoden og et tilgangstoken for Events API. Huk av for å også laste nettleserpixelen.

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)

Samtykke

Utenfor Shopify leser ROASaurus-skriptet valget til den besøkende fra vanlige samtykkeverktøy: Cookiebot, OneTrust, IAB TCF-bannere og Google consent mode. Med et annet cookie-banner kaller du tlq('consent', true) når den besøkende godtar markedsføringscookies, og tlq('consent', false) når de avslår. Inntil den besøkende godtar, har de ingen besøks-ID eller click id-er, og ingen nettleserpixler utløses. Den betalte bestillingen sendes likevel fra serveren med hashede kundedata fra bestillingen og bestillingens IP-adresse og nettleser. Hjelpesiden om samtykke forklarer detaljene.

Hvordan tester du konverteringstracking for Lightspeed?

• Åpne butikken din med ?roasaurus=connected i adressen. Et varsel bekrefter at skriptet kjører. ?roasaurus=debug logger det det sender til nettleserkonsollen.
• I Event log, under Collected events, skal sidevisninger vise en besøks-ID.
• Legg inn en bestilling og sørg for at betalingsstatusen er paid. Under Collected events bør Event log da vise en Purchase med bestillingsnummeret ditt i dataene. Hvis den mangler, sjekker du at Status er slått på i området Tracking.
• På fanen Connection viser Last order received bestillingen og Last sync viser den siste 5-minuttssjekken, med eventuelle feil fra Lightspeed.
• Under Server deliveries i Event log får hver tilkoblede plattform en linje med statusen sent og plattformens svar.

For å se eventen i Meta limer du inn koden fra Events Manager › Test events i feltet Test event code for Meta-pixelen din i ROASaurus, og fjerner den når du er ferdig. TikToks pixelinnstillinger i ROASaurus har det samme feltet.

Begrensninger og spesialtilfeller

• Bare C-Series. Lightspeed eCom E-Series-butikker kan ikke bruke denne koblingen.
• Bare betalte bestillinger. En delvis betalt bestilling sendes når betalingsstatusen endres til paid.
• Sene betalinger og Metas grense på 7 dager. Meta godtar server-events opptil 7 dager etter eventtidspunktet. ROASaurus bruker bestillingens opprettelsestidspunkt, så en bestilling som er betalt mer enn 7 dager etter at den ble lagt inn, avvises av Meta.
• Nettleserkjøp før betaling. Snutten på takkesiden kjører når bestillingen legges inn, så nettleserpixlene rapporterer en bestilling med bankoverføring før den er betalt. Hvis betalingen kommer mer enn 48 timer senere, kan ikke Meta og TikTok slå sammen nettleserkopien og serverkopien.
• Kanselleringer og refusjoner sendes ikke. Når et kjøp først er sendt, blir det stående i annonseplattformen.
• Bare sidevisninger, uten kode. Produktvisninger og handlekurvtillegg registreres automatisk bare på Shopify. På Lightspeed kan en utvikler sende dem med et tlq track-kall.
• API-grenser. Lightspeed tillater 300 forespørsler per 5 minutter, 3,000 per time og 12,000 per dag per API-nøkkel. Hvis et annet verktøy bruker den samme nøkkelen, deler de disse grensene. Lightspeed ber deg kontakte dem for en andre nøkkel.

Integrasjonssiden for Lightspeed lister opp fakta om tilkoblingen på ett sted, og hjelpesiden for andre nettbutikker sammenligner Lightspeed med de andre plattformene ROASaurus kobler til.

Kilder

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

I ROASaurus

• Lightspeed-integrasjon
• Hjelp: Wix, Lightspeed og andre nettbutikker
• Server-side tracking
• Meta-integrasjon

Les videre