Ce produs Lightspeed acceptă ROASaurus?

Lightspeed eCom (C-Series), prin API-ul său de pe api.webshopapp.com (UE) și api.shoplightspeed.com (SUA). Lightspeed eCom E-Series este un produs separat și nu este acoperit de acest conector.

Am nevoie de fragmentul de pe pagina de mulțumire?

Comenzile sunt trimise și fără el, dar fragmentul este cea mai fiabilă metodă de a lega o comandă de vizitator și de click-ul lui pe reclamă. Fără el, ROASaurus poate potrivi doar după un email dat mai devreme pe site sau după o adresă IP și un browser unice.

De ce are nevoie ROASaurus de limba magazinului meu?

Adresele API Lightspeed includ un cod de limbă din două litere, precum /nl/ sau /en/. Introdu una dintre limbile magazinului tău; ROASaurus folosește nl când câmpul este gol.

Sunt urmărite comenzile cu transfer bancar?

Da, după ce Lightspeed setează statusul lor de plată pe paid. Webhook-ul și verificarea la 5 minute văd amândouă actualizarea. Meta respinge evenimentele de pe server la mai mult de 7 zile după crearea comenzii, așa că plățile foarte întârziate nu ajung la Meta.

Valoarea achiziției este trimisă cu sau fără TVA?

Cu TVA. ROASaurus trimite prețul comenzii Lightspeed cu taxe incluse, așa că împarte ROAS-ul din platforma ta de publicitate la 1 plus cota ta de TVA înainte să-l compari cu un ROAS de break-even.

Trimite ROASaurus conversii Google Ads din Lightspeed?

Nu pentru achiziții. Conversiile de achiziție Google Ads sunt trimise doar din checkout-ul Shopify. Din Lightspeed, ROASaurus trimite achiziții către Meta, TikTok, Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn și celelalte platforme de publicitate pe care le conectezi.

Tracking-ul conversiilor Lightspeed pentru magazinele online eCom

Ideile principale

Tracking-ul conversiilor Lightspeed funcționează cel mai bine atunci când fiecare comandă plătită este trimisă din datele comenzii Lightspeed de pe server, cu un fragment pe pagina de mulțumire care leagă comanda de click-ul pe reclamă.
ROASaurus se conectează la Lightspeed eCom (C-Series) prin API-ul acestuia, pe clusterele UE și SUA; E-Series este un produs separat și nu este acoperit.
Un click pe Create webhook înregistrează în Lightspeed un webhook pentru comenzi, iar ROASaurus verifică și la fiecare 5 minute comenzile actualizate, așa că plățile întârziate sunt preluate.
Sunt trimise doar comenzile cu statusul de plată paid, la valoarea prețului comenzii, cu taxe incluse.
Comenzile Lightspeed includ adresa IP și browserul cumpărătorului, așa că ROASaurus poate potrivi totuși unele comenzi atunci când fragmentul de pe pagina de mulțumire nu a rulat.

Tracking-ul conversiilor Lightspeed înseamnă raportarea fiecărei comenzi plătite din magazinul tău online Lightspeed eCom către platforme de publicitate precum Meta și TikTok, ca acestea să atribuie meritul reclamelor potrivite și să îți optimizeze campaniile. Metoda de încredere este să trimiți fiecare achiziție din datele comenzii Lightspeed, de pe server, și să adaugi un fragment scurt pe pagina de mulțumire care leagă comanda de click-ul pe reclamă.

Acest ghid tratează produsul Lightspeed la care se aplică, cum ajung comenzile la ROASaurus, ce se citește din fiecare comandă, cum ajung achizițiile la Meta și TikTok, configurarea, testarea și limitele pe care ar trebui să le cunoști.

Ce produs Lightspeed acoperă acest ghid?

Lightspeed vinde mai mult de un produs de ecommerce, așa că verifică-l mai întâi pe al tău. ROASaurus se conectează la Lightspeed eCom (C-Series), platforma de magazine online al cărei back office conține Settings › Website Settings › Web Extras. API-ul ei rulează pe două clustere:

Cluster	Adresa API	Regiunea în ROASaurus
EU1	`api.webshopapp.com`	`eu`
US1	`api.shoplightspeed.com`	`us`

Lightspeed documentează că API-ul funcționează la fel pe ambele clustere. Diferă doar adresa, așa că setarea regiunii trebuie să corespundă magazinului tău.

Fiecare adresă API conține și un cod de limbă din două litere, de exemplu /nl/ sau /en/. ROASaurus îl cere ca limbă a magazinului și folosește nl când îl lași gol.

Lightspeed oferă și eCom (E-Series). Lightspeed descrie trecerea la E-Series ca pe o actualizare către un produs separat, oferit în prezent anumitor comercianți din America de Nord. Conectorul ROASaurus pentru Lightspeed citește comenzile doar prin API-ul C-Series, așa că nu acoperă magazinele E-Series.

De ce lipsesc achizițiile Lightspeed din Meta și TikTok?

Un pixel din browser raportează o achiziție doar atunci când browserul cumpărătorului încarcă pagina de mulțumire și scriptul pixelului rulează. Asta eșuează în mai multe situații frecvente:

Un cumpărător plătește prin redirecționare, de exemplu cu iDEAL sau PayPal, și închide fila înainte să se încarce pagina de mulțumire.
Un blocant de reclame sau o setare de confidențialitate a browserului blochează scriptul pixelului.
Vizitatorul refuză cookie-urile de marketing, deci pixelul nu trebuie să se încarce.
Comanda este plătită mai târziu, de exemplu prin transfer bancar, când nu este implicat niciun browser.
Safari limitează cât timp durează cookie-urile setate de scripturi, așa că browserul poate uita un click mai vechi pe o reclamă.

Doar pixel în browser

Are nevoie ca pagina de mulțumire să se încarce
Blocat de blocantele de reclame și de unele browsere
Nu se întâmplă nimic când un transfer bancar este plătit mai târziu
Valoarea și numărul comenzii doar dacă se ajunge pe pagină

Datele comenzii din Lightspeed

Fiecare comandă cu statusul de plată paid
Trimis de la server la server, nu din browser
Plățile întârziate sosesc cu următoarea actualizare a comenzii
Valoarea, produsele și datele clientului din comandă

Serverul trimite achiziția. Fragmentul din browser contează în continuare, pentru că leagă comanda de vizitatorul care a dat click pe reclamă.

Cum ajung comenzile Lightspeed la ROASaurus?

Comandă actualizatăLightspeed apelează adresa de webhook a magazinului tău

ROASaurusCitește comanda și produsele ei din API

Verificarea plățiiContinuă doar statusul de plată paid

Platforme de publicitateAchiziție cu event id order-ORD01042

Calea datelor pentru fiecare comandă. Verificarea la 5 minute urmează aceeași cale pentru comenzile pe care webhook-ul le-a ratat.

Când apeși Create webhook, ROASaurus înregistrează în Lightspeed un webhook pentru grupul orders și acțiunea updated, în format JSON. De atunci, Lightspeed apelează ROASaurus când o comandă se schimbă.

De ce citește ROASaurus din nou comanda

Lightspeed adaugă un antet x-signature unui webhook doar atunci când l-a creat o aplicație. Un webhook creat cu o simplă cheie API, ca aici, nu este semnat. Așadar adresa webhook-ului conține un token unic pentru magazinul tău, iar ROASaurus nu are încredere în payload. Citește comanda și produsele ei din API-ul Lightspeed și verifică singur statusul plății.

Verificarea la 5 minute

La fiecare 5 minute, ROASaurus cere de asemenea de la Lightspeed comenzile actualizate de la ultima verificare, cu o suprapunere de 30 de minute, și înregistrează comenzile plătite pe care nu le are încă. Pentru că verificarea folosește momentul actualizării, o comandă plătită la câteva zile după plasare este preluată chiar dacă livrarea webhook-ului ei a eșuat. Comenzile pe care ROASaurus le are deja sunt ignorate, așa că webhook-ul și verificarea nu creează niciodată două achiziții.

Din partea Lightspeed, un webhook trebuie să primească un răspuns 2xx în 5 secunde. Livrările eșuate sunt reîncercate, în total până la 10 încercări, iar un webhook al cărui raport de erori rămâne peste 50% timp de 50 de ore este dezactivat. Verificarea la 5 minute menține fluxul de comenzi în timpul unei asemenea întreruperi.

5 minCât de des verifică ROASaurus comenzile actualizate

10Încercări de livrare pentru fiecare apel de webhook în Lightspeed

300Cereri API la 5 minute pentru fiecare cheie API (limita Lightspeed)

Ce citește ROASaurus dintr-o comandă Lightspeed?

Câmp Lightspeed	Ce face ROASaurus cu el
`number`	ID-ul comenzii, de exemplu ORD01042. Devine event id-ul `order-ORD01042`, pentru că pagina de mulțumire afișează același număr.
`paymentStatus`	Sunt trimise doar comenzile plătite. Comenzile neplătite, parțial plătite și anulate sunt omise.
`priceIncl`	Valoarea achiziției, cu taxe incluse. Moneda este moneda magazinului pe care ai setat-o în ROASaurus.
`createdAt`	Ora evenimentului
Email, telefon sau mobil, prenume și nume	Transformate în hash cu SHA-256 și trimise ca date de client
Orașul, codul poștal și țara din adresa de facturare	Transformate în hash și trimise ca date de client
`remoteIp`, `userAgent`	Trimise cu evenimentul și folosite pentru potrivirea după IP
Id client	Transformat în hash și trimis ca id extern
Produsele comenzii	ID-ul variantei (sau al produsului), cantitatea, prețul cu taxe incluse, titlul și SKU-ul

Totul provine din API-ul Lightspeed. ROASaurus are nevoie doar de acces de citire la comenzi.

Valoarea achiziției include TVA

priceIncl din Lightspeed este prețul comenzii cu taxe incluse, iar aceasta este valoarea pe care o trimite ROASaurus. Platformele tale de publicitate raportează, așadar, venituri cu TVA inclus. Iată efectul la un TVA de 21%:

Exemplu: 30 de comenzi	Valoare trimisă (cu TVA)	Venituri fără TVA
Cheltuieli cu reclamele	$1,000	$1,000
Valoarea achiziției	$3,630	3,630 ÷ 1.21 = $3,000
ROAS	3.63	3.00

Cifre ilustrative. ROAS-ul raportat este cu 21% mai mare decât ROAS-ul pe venituri fără TVA.

Un ROAS de break-even folosește venituri fără TVA. Împarte ROAS-ul din platformă la 1 plus cota ta de TVA înainte să compari cele două.

Cum este legată o comandă Lightspeed de click-ul pe reclamă?

Pentru a atribui meritul unei reclame, platforma are nevoie de identificatorii de click ai vizitatorului care a comandat: click id-ul Meta și id-ul de browser (fbc, fbp), click id-ul TikTok (ttclid) și cookie-ul TikTok (ttp). Scriptul ROASaurus le salvează pentru fiecare vizitator când acesta ajunge dintr-o reclamă. ROASaurus nu primește acel id de vizitator din comanda Lightspeed, așa că leagă fiecare comandă de un vizitator în alt mod. Încearcă trei metode, în această ordine:

Metodă	Cum funcționează	De ce are nevoie
1. Fragment pe pagina de mulțumire	Fragmentul declanșează o achiziție ROASaurus cu numărul comenzii. ROASaurus găsește acel eveniment după event id-ul lui, `order-ORD01042`.	Fragmentul din caseta Tracking
2. Email anterior	Un email cu hash pe care vizitatorul l-a dat mai devreme pe site-ul tău, într-un formular popup sau printr-un apel Identify	Un formular de înscriere sau un apel Identify
3. Adresa IP și browserul	Aceeași adresă IP și același browser, văzute de la 3 ore înainte până la 15 minute după comandă, doar când se potrivește exact un vizitator	Nimic suplimentar

Fragmentul este cea mai fiabilă metodă. Celelalte două prind o parte din comenzile pe care el le ratează.

Fragmentul transmite și totalul comenzii, moneda și emailul clientului. ROASaurus salvează un hash al acelui email pe vizitator, ceea ce ajută la potrivirea următoarei comenzi a aceluiași cumpărător. ROASaurus așteaptă puțin înainte să trimită fiecare achiziție, ca evenimentul de pe pagina de mulțumire să poată ajunge primul, și încearcă din nou potrivirea în momentul trimiterii.

Variabilele paginii de mulțumire

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

Pagina Orders arată cum a fost legată fiecare comandă, în coloana Matched by: thank_you, email, ip sau not matched. O comandă nepotrivită ajunge totuși la platformele tale de publicitate cu datele ei, dar fără identificatori de click, iar atribuirea ROASaurus o arată ca directă sau necunoscută.

Trimiterea achizițiilor Lightspeed către Meta și TikTok

Fiecare comandă plătită devine un eveniment pe server pentru fiecare platformă conectată: un Purchase pentru Conversions API de la Meta și un CompletePayment pentru Events API de la TikTok, ambele cu event id-ul order-ORD01042. TikTok afișează acum CompletePayment ca Purchase în rapoartele sale. Când bifezi opțiunea de a încărca și pixelul din browser, fragmentul de pe pagina de mulțumire declanșează aceleași evenimente în browser, cu același event id. Meta și TikTok păstrează atunci o singură copie.

Meta: Purchase

Event id, momentul evenimentului, valoarea și moneda
ID-uri de produs, cantități și prețuri
Email, telefon, nume, oraș, cod poștal și țară, cu hash
Adresa IP și browserul
fbc și fbp când comanda este potrivită

TikTok: CompletePayment

Event id, momentul evenimentului, valoarea și moneda
Produse cu id, nume, cantitate și preț
Email și telefon cu hash
Adresa IP și browserul
ttclid și ttp când comanda este potrivită

Ce trimite o comandă Lightspeed. Ambele evenimente conțin și un id extern cu hash, din id-ul clientului sau din id-ul vizitatorului.

Aceleași comenzi ajung la Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn și la celelalte platforme de publicitate când le conectezi. Conversiile de achiziție Google Ads sunt trimise doar din checkout-ul Shopify, așa că ROASaurus nu le trimite din Lightspeed. Pentru partea Meta a configurării, vezi ghidul Meta Conversions API.

Cum configurezi tracking-ul conversiilor Lightspeed

Adaugă magazinul în ROASaurus
Mergi la Add a store, alege Lightspeed eCom și introdu adresa magazinului tău. Fila Connection îți arată apoi tag-ul de script și fragmentul pentru pagina de mulțumire.
Adaugă scriptul pe fiecare pagină
În back office-ul Lightspeed, mergi la Settings › Website Settings › Web Extras › Custom JavaScript și lipește tag-ul de script. Lightspeed rulează acest cod pe toate paginile.
Adaugă fragmentul pentru pagina de mulțumire
Pe aceeași pagină, în zona Tracking, activează Status și lipește fragmentul. Lightspeed îl rulează pe pagina Thank You după o comandă.
Creează o cheie API
Mergi la Settings › Store Settings › Developers › New API key. Activează cheia, bifează accesul de citire la comenzi, salvează și selectează Show ca să vezi secretul.
Conectează API-ul
În fila Connection, introdu cheia, secretul, regiunea și limba magazinului. Salvează, apasă Test connection, apoi Create webhook.
Conectează-ți platformele de publicitate
În Tracking & platforms, folosește Connect with Facebook sau Add pixel pentru Meta și Add pixel pentru TikTok, cu codul pixelului și un token de acces Events API. Bifează opțiunea de a încărca și pixelul din browser.

Câmpurile din fila Connection

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)

Consimțământ

În afara Shopify, scriptul ROASaurus citește alegerea vizitatorului din instrumentele de consimțământ uzuale: Cookiebot, OneTrust, bannere IAB TCF și Google consent mode. Cu un alt banner de cookie-uri, apelează tlq('consent', true) când vizitatorul acceptă cookie-urile de marketing și tlq('consent', false) când le refuză. Până când vizitatorul acceptă, nu are id de vizitator sau click id și nu se declanșează niciun pixel din browser. Comanda plătită este în continuare trimisă de pe server, cu datele clientului cu hash din comandă și cu adresa IP și browserul comenzii. Pagina de ajutor despre consimțământ explică detaliile.

Cum testezi tracking-ul conversiilor Lightspeed?

Deschide magazinul tău cu ?roasaurus=connected în adresă. O alertă confirmă că scriptul rulează. ?roasaurus=debug înregistrează în consola browserului ce trimite.
În Event log, la Collected events, vizualizările de pagină ar trebui să afișeze un id de vizitator.
Plasează o comandă și asigură-te că statusul ei de plată este paid. La Collected events, Event log ar trebui să afișeze apoi un Purchase cu numărul comenzii tale în date. Dacă lipsește, verifică dacă Status este activat în zona Tracking.
În fila Connection, Last order received arată comanda, iar Last sync arată ultima verificare la 5 minute, împreună cu orice eroare de la Lightspeed.
În Server deliveries din Event log, fiecare platformă conectată primește o linie cu statusul sent și răspunsul platformei.

PageView visitor 7d1e04b2Script pe fiecare pagină

Purchase order-ORD01042Fragment pe pagina de mulțumire, pixeli din browser declanșați

webhook orders updatedComanda ORD01042, statusul de plată paid

Meta Purchase sentMatched by thank_you

TikTok CompletePayment sentAcelași event id, deduplicat

Exemplu de comandă de test în regulă. Fetch orders now din fila Connection rulează imediat verificarea la 5 minute.

Ca să vezi evenimentul în Meta, lipește codul din Events Manager › Test events în câmpul Test event code al pixelului tău Meta din ROASaurus și elimină-l când ai terminat. Setările pixelului TikTok din ROASaurus au același câmp.

Limite și cazuri speciale

Doar C-Series. Magazinele Lightspeed eCom E-Series nu pot folosi acest conector.
Doar comenzi plătite. O comandă parțial plătită este trimisă când statusul ei de plată devine paid.
Plățile întârziate și limita de 7 zile a Meta. Meta acceptă evenimente de pe server până la 7 zile după momentul evenimentului. ROASaurus folosește momentul creării comenzii, așa că o comandă plătită la mai mult de 7 zile după plasare este respinsă de Meta.
Achiziții din browser înainte de plată. Fragmentul de pe pagina de mulțumire rulează când comanda este plasată, așa că pixelii din browser raportează o comandă cu transfer bancar înainte să fie plătită. Dacă plata vine la mai mult de 48 de ore după, Meta și TikTok nu pot îmbina copiile din browser și de pe server.
Anulările și rambursările nu sunt trimise. Odată trimisă, o achiziție rămâne în platforma de publicitate.
Doar vizualizări de pagină, fără cod. Vizualizările de produs și adăugările în coș sunt detectate automat doar pe Shopify. Pe Lightspeed, un dezvoltator le poate trimite cu un apel de tracking tlq.
Limite API. Lightspeed permite 300 de cereri la 5 minute, 3,000 pe oră și 12,000 pe zi pentru fiecare cheie API. Dacă un alt instrument folosește aceeași cheie, ele împart aceste limite. Lightspeed îți cere să îi contactezi pentru o a doua cheie.

Pagina integrării Lightspeed listează faptele despre conexiune într-un singur loc, iar pagina de ajutor pentru alte magazine online compară Lightspeed cu celelalte platforme la care se conectează ROASaurus.

Surse

În ROASaurus

Continuă lectura

Platforme de publicitate și magazine onlineTracking-ul conversiilor pentru plata ramburs și checkout-urile externeTracking-ul conversiilor pentru plata ramburs: de ce pixelii pierd comenzile ramburs și pe cele din checkout-uri externe, când să trimiți achiziția și cum gestionezi comenzile refuzate.Platforme de publicitate și magazine onlineTracking-ul conversiilor în CCV Shop: ghid de configurareTracking-ul conversiilor în CCV Shop: trimite comenzile plătite către Meta și TikTok printr-un webhook semnat, leagă-le de click-urile pe reclame, configurează, testează și gestionează plățile întârziate.Platforme de publicitate și magazine onlineEnhanced conversions în Google Ads pe ShopifyEnhanced conversions adaugă date de client cu hash la achizițiile din Google Ads pe Shopify. Cum funcționează, prin ce diferă de importurile offline și cum se configurează.