Konverteringstracking for Lightspeed eCom-webshops

Konverteringstracking for Lightspeed betyder, at hver betalt ordre i din Lightspeed eCom-webshop rapporteres til annonceplatforme som Meta og TikTok, så de kan give de rigtige annoncer kredit og optimere dine kampagner. Den pålidelige måde er at sende hvert køb fra Lightspeeds ordredata på serveren og at tilføje et kort snippet til takkesiden, der knytter ordren til annonceklikket.

Denne guide dækker, hvilket Lightspeed-produkt den gælder for, hvordan ordrer når frem til ROASaurus, hvad der læses fra hver ordre, hvordan køb når frem til Meta og TikTok, opsætningen, testen og de begrænsninger, du bør kende.

Hvilket Lightspeed-produkt dækker denne guide?

Lightspeed sælger mere end ét e-handelsprodukt, så tjek først dit eget. ROASaurus forbinder til Lightspeed eCom (C-Series), den webshopplatform, hvis backoffice har Settings › Website Settings › Web Extras. Dens API kører på to clusters:

Hver API-adresse indeholder også en sprogkode på to bogstaver, for eksempel /nl/ eller /en/. ROASaurus spørger efter den som shoppens sprog og bruger nl, hvis du lader den stå tom.

Lightspeed tilbyder også eCom (E-Series). Lightspeed beskriver overgangen til E-Series som en opgradering til et separat produkt, der i øjeblikket tilbydes til visse nordamerikanske forhandlere. Lightspeed-connectoren i ROASaurus læser kun ordrer gennem C-Series API'et, så den dækker ikke E-Series-shops.

Hvorfor forsvinder Lightspeed-køb i Meta og TikTok?

En pixel i browseren rapporterer kun et køb, når shopperens browser indlæser takkesiden, og pixelscriptet kører. Det fejler i flere almindelige situationer:

• En shopper betaler via omdirigering, for eksempel med iDEAL eller PayPal, og lukker fanen, før takkesiden indlæses.
• En adblocker eller en privatlivsindstilling i browseren blokerer pixel-scriptet.
• Den besøgende afviser marketingcookies, så pixelen ikke må indlæses.
• Ordren betales senere, for eksempel ved bankoverførsel, hvor der ikke er nogen browser involveret.
• Safari begrænser, hvor længe cookies sat af scripts varer, så browseren kan glemme et ældre annonceklik.

Hvordan når Lightspeed-ordrer frem til ROASaurus?

Når du trykker på Create webhook, registrerer ROASaurus en webhook i Lightspeed for gruppen orders og handlingen updated i JSON-format. Derefter kalder Lightspeed ROASaurus, når en ordre ændres.

Hvorfor ROASaurus læser ordren igen

Lightspeed tilføjer kun en x-signature-header til en webhook, når en app har oprettet den. En webhook, der er oprettet med en almindelig API-nøgle som her, er usigneret. Derfor indeholder webhook-adressen et token, der er unikt for din shop, og ROASaurus stoler ikke på payloaden. Den læser ordren og dens produkter fra Lightspeed API'et og tjekker selv betalingsstatussen.

Kontrollen hvert 5. minut

Hvert 5. minut spørger ROASaurus også Lightspeed efter ordrer, der er opdateret siden den seneste kontrol, med 30 minutters overlap, og registrerer de betalte ordrer, den endnu ikke har. Fordi kontrollen bruger opdateringstidspunktet, bliver en ordre, der betales dage efter, den blev afgivet, fanget, selv hvis dens webhook-levering mislykkedes. Ordrer, som ROASaurus allerede har, ignoreres, så webhooken og kontrollen aldrig opretter to køb.

Fra Lightspeeds side skal en webhook have et 2xx-svar inden for 5 sekunder. Mislykkede leveringer forsøges igen, op til 10 forsøg i alt, og en webhook, hvis fejlrate holder sig over 50% i 50 timer, deaktiveres. Kontrollen hvert 5. minut sørger for, at ordrerne fortsat kommer ind under sådan et hul.

Hvad læser ROASaurus fra en Lightspeed-ordre?

Købsværdien inkluderer moms

Lightspeeds priceIncl er ordreprisen inklusive moms, og det er den værdi, ROASaurus sender. Dine annonceplatforme rapporterer derfor omsætning inklusive moms. Her er effekten ved 21% moms:

En break-even-ROAS bruger omsætning uden moms. Divider platformens ROAS med 1 plus din momssats, før du sammenligner de to.

Hvordan knyttes en Lightspeed-ordre til annonceklikket?

For at give en annonce kredit har platformen brug for klik-id'erne fra den besøgende, der bestilte: Meta-klik-id'et og browser-id'et (fbc, fbp), TikTok-klik-id'et (ttclid) og TikTok-cookien (ttp). ROASaurus-scriptet gemmer dem for hver besøgende, når de lander fra en annonce. ROASaurus får ikke det besøgs-id fra Lightspeed-ordren, så den knytter hver ordre til en besøgende på en anden måde. Den prøver tre metoder i denne rækkefølge:

Snippetten sender også ordretotalen, valutaen og kundens e-mail. ROASaurus gemmer en hash af den e-mail på den besøgende, hvilket hjælper med at matche den samme shoppers næste ordre. ROASaurus venter kort, før den sender hvert køb, så eventet fra takkesiden kan nå frem først, og den prøver matchingen igen på afsendelsestidspunktet.

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 ordre blev knyttet, i kolonnen Matched by: thank_you, email, ip eller not matched. En ordre, der ikke er matchet, går stadig til dine annonceplatforme med sine ordredata, men uden klik-id'er, og ROASaurus-attribution viser den som direkte eller ukendt.

Afsendelse af Lightspeed-køb til Meta og TikTok

Hver betalt ordre bliver til ét server-event pr. forbundet platform: et Purchase til Metas Conversions API og et CompletePayment til TikToks Events API, begge med event-id'et order-ORD01042. TikTok viser nu CompletePayment som Purchase i sine rapporter. Når du markerer muligheden for også at indlæse browserpixelen, udløser snippetten på takkesiden de samme events i browseren med det samme event-id. Meta og TikTok beholder så én kopi.

De samme ordrer går til Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn og de andre annonceplatforme, når du forbinder dem. Google Ads-købskonverteringer sendes kun fra Shopify checkout, så ROASaurus sender dem ikke fra Lightspeed. Til Metas del af opsætningen, se guiden til Meta Conversions API.

Sådan sætter du konverteringstracking op for Lightspeed

1. Tilføj shoppen i ROASaurus

   Gå til Add a store, vælg Lightspeed eCom, og indtast din shopadresse. Fanen Connection viser derefter dit script-tag og snippetten til takkesiden.

2. Tilføj scriptet til alle sider

   Gå til Settings › Website Settings › Web Extras › Custom JavaScript i Lightspeeds backoffice, og indsæt script-tagget. Lightspeed kører denne kode på alle sider.

3. Tilføj snippetten til takkesiden

   På den samme side skal du i området Tracking slå Status til og indsætte snippetten. Lightspeed kører den på siden Thank You efter en ordre.

4. Opret en API-nøgle

   Gå til Settings › Store Settings › Developers › New API key. Slå nøglen til, markér læseadgang til ordrer, gem, og vælg Show for at se din secret.

5. Forbind API'et

   Indtast nøglen, secret, regionen og shoppens sprog på fanen Connection. Gem, tryk på Test connection, og derefter på Create webhook.

6. Forbind dine annonceplatforme

   På Tracking & platforms skal du bruge Connect with Facebook eller Add pixel til Meta og Add pixel til TikTok med pixelkoden og et adgangstoken til Events API. Markér muligheden for også at indlæse browserpixelen.

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

Uden for Shopify læser ROASaurus-scriptet den besøgendes valg fra almindelige samtykkeværktøjer: Cookiebot, OneTrust, IAB TCF-bannere og Google consent mode. Med et andet cookiebanner kalder du tlq('consent', true), når den besøgende accepterer marketingcookies, og tlq('consent', false), når vedkommende afviser. Indtil den besøgende accepterer, har vedkommende intet besøgs-id eller klik-id'er, og ingen browserpixels udløses. Den betalte ordre sendes stadig fra serveren med hashede kundedata fra ordren og ordrens IP-adresse og browser. Hjælpesiden om samtykke forklarer detaljerne.

Hvordan tester du konverteringstracking for Lightspeed?

• Åbn din shop med ?roasaurus=connected i adressen. En meddelelse bekræfter, at scriptet kører. ?roasaurus=debug logger det, det sender, i browserkonsollen.
• I Event log skal sidevisninger under Collected events vise et besøgs-id.
• Læg en ordre, og sørg for, at dens betalingsstatus er paid. Under Collected events bør Event log derefter vise et Purchase med dit ordrenummer i dataene. Hvis det mangler, så tjek, at Status er slået til i området Tracking.
• På fanen Connection viser Last order received ordren, og Last sync viser den seneste 5-minutterskontrol med eventuelle fejl fra Lightspeed.
• Under Server deliveries i Event log får hver forbundet platform en linje med status sent og platformens svar.

For at se eventet i Meta skal du indsætte koden fra Events Manager › Test events i feltet Test event code på din Meta-pixel i ROASaurus og fjerne den, når du er færdig. TikToks pixelindstillinger i ROASaurus har det samme felt.

Begrænsninger og grænsetilfælde

• Kun C-Series. Lightspeed eCom E-Series-shops kan ikke bruge denne connector.
• Kun betalte ordrer. En delvist betalt ordre sendes, når dens betalingsstatus ændres til paid.
• Sene betalinger og Metas grænse på 7 dage. Meta accepterer server-events op til 7 dage efter eventtidspunktet. ROASaurus bruger ordrens oprettelsestidspunkt, så en ordre, der betales mere end 7 dage efter, den blev afgivet, afvises af Meta.
• Browserkøb før betaling. Snippetten på takkesiden kører, når ordren afgives, så browserpixels rapporterer en bankoverførselsordre, før den er betalt. Hvis betalingen kommer mere end 48 timer senere, kan Meta og TikTok ikke slå browser- og serverkopien sammen.
• Annulleringer og refunderinger sendes ikke. Når et køb først er sendt, bliver det stående i annonceplatformen.
• Kun sidevisninger, uden kode. Produktvisninger og tilføjelser til kurven registreres automatisk kun på Shopify. På Lightspeed kan en udvikler sende dem med et tlq-track-kald.
• API-grænser. Lightspeed tillader 300 forespørgsler pr. 5 minutter, 3,000 pr. time og 12,000 pr. dag pr. API-nøgle. Hvis et andet værktøj bruger den samme nøgle, deler de disse grænser. Lightspeed beder dig kontakte dem for at få en anden nøgle.

Siden om Lightspeed-integrationen opregner fakta om forbindelsen ét sted, og hjælpesiden for andre webshops sammenligner Lightspeed med de andre platforme, ROASaurus forbinder 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-integration
• Hjælp: Wix, Lightspeed og andre webshops
• Server-side tracking
• Meta-integration

Læs videre