Tracking konverzí v Lightspeed pro e-shopy eCom

Tracking konverzí v Lightspeed znamená hlásit každou zaplacenou objednávku ve vašem e-shopu Lightspeed eCom reklamním platformám, jako jsou Meta a TikTok, aby mohly připsat zásluhu správným reklamám a optimalizovat vaše kampaně. Spolehlivý způsob je odesílat každý nákup z dat objednávek Lightspeed na serveru a na děkovnou stránku přidat krátký fragment kódu, který objednávku propojí s kliknutím na reklamu.

Tento průvodce popisuje, pro který produkt Lightspeed platí, jak se objednávky dostanou do ROASaurus, co se z každé objednávky čte, jak se nákupy dostanou do Meta a TikTok, nastavení, testování a omezení, která byste měli znát.

Který produkt Lightspeed tento průvodce pokrývá?

Lightspeed prodává více než jeden produkt pro e-commerce, proto si nejdřív ověřte ten svůj. ROASaurus se připojuje k Lightspeed eCom (C-Series), platformě pro e-shopy, jejíž administrace obsahuje Settings › Website Settings › Web Extras. Její API běží na dvou klastrech:

Každá adresa API obsahuje také dvoupísmenný kód jazyka, například /nl/ nebo /en/. ROASaurus se na něj ptá jako na jazyk obchodu a když ho necháte prázdný, použije nl.

Lightspeed nabízí také eCom (E-Series). Přechod na E-Series Lightspeed popisuje jako upgrade na samostatný produkt, který se v současnosti nabízí vybraným obchodníkům v Severní Americe. Konektor ROASaurus pro Lightspeed čte objednávky jen přes API C-Series, takže e-shopy s E-Series nepokrývá.

Proč se nákupy z Lightspeed ztrácejí v Meta a TikToku?

Pixel v prohlížeči nahlásí nákup jen tehdy, když prohlížeč nakupujícího načte děkovnou stránku a spustí se skript pixelu. To selže v několika běžných situacích:

• Nakupující platí přes přesměrování, například iDEAL nebo PayPal, a zavře kartu dřív, než se načte děkovná stránka.
• Blokátor reklam nebo nastavení soukromí v prohlížeči zablokuje skript pixelu.
• Návštěvník odmítne marketingové cookies, takže se pixel nesmí načíst.
• Objednávka se zaplatí později, například bankovním převodem, kdy žádný prohlížeč není zapojen.
• Safari omezuje, jak dlouho vydrží cookies nastavené skripty, takže prohlížeč může zapomenout starší kliknutí na reklamu.

Jak se objednávky z Lightspeed dostanou do ROASaurus?

Když stisknete Create webhook, ROASaurus v Lightspeed zaregistruje webhook pro skupinu orders a akci updated ve formátu JSON. Od té chvíle Lightspeed volá ROASaurus, kdykoli se objednávka změní.

Proč ROASaurus objednávku čte znovu

Lightspeed přidává k webhooku hlavičku x-signature jen tehdy, když ho vytvořila aplikace. Webhook vytvořený obyčejným klíčem API, jako zde, je nepodepsaný. Adresa webhooku proto obsahuje token jedinečný pro váš obchod a ROASaurus datům v požadavku nevěří. Objednávku a její produkty načte z API Lightspeed a stav platby si ověří sám.

Kontrola po 5 minutách

Každých 5 minut se ROASaurus také ptá Lightspeed na objednávky aktualizované od poslední kontroly, s 30minutovým překryvem, a zaznamená zaplacené objednávky, které ještě nemá. Protože tato kontrola používá čas aktualizace, zachytí se i objednávka zaplacená dny po vytvoření, i když selhalo doručení jejího webhooku. Objednávky, které ROASaurus už má, se ignorují, takže webhook a kontrola nikdy nevytvoří dva nákupy.

Na straně Lightspeed musí cíl webhooku odpovědět kódem 2xx do 5 sekund. Neúspěšná doručení se opakují, celkem až 10 pokusů, a webhook, jehož míra chyb zůstane 50 hodin nad 50%, se vypne. 5minutová kontrola zajišťuje, že objednávky přicházejí i během takového výpadku.

Co ROASaurus čte z objednávky Lightspeed?

Hodnota nákupu zahrnuje DPH

Pole priceIncl z Lightspeed je cena objednávky včetně daně a právě tuto hodnotu ROASaurus odesílá. Vaše reklamní platformy proto vykazují tržby včetně DPH. Tady je dopad při 21% DPH:

ROAS bodu zvratu vychází z tržeb bez DPH. Než oba porovnáte, vydělte ROAS z platformy číslem 1 plus vaše sazba DPH.

Jak se objednávka Lightspeed propojí s kliknutím na reklamu?

Aby mohla platforma reklamě připsat zásluhu, potřebuje identifikátory kliknutí návštěvníka, který objednal: ID kliknutí a ID prohlížeče Meta (fbc, fbp), ID kliknutí TikTok (ttclid) a cookie TikTok (ttp). Skript ROASaurus je pro každého návštěvníka ukládá, když přijde z reklamy. ID návštěvníka ROASaurus z objednávky Lightspeed nezíská, takže každou objednávku propojí s návštěvníkem jinak. Zkouší tři metody v tomto pořadí:

Fragment kódu předává také celkovou částku objednávky, měnu a e-mail zákazníka. ROASaurus uloží k návštěvníkovi hash tohoto e-mailu, což pomáhá spárovat další objednávku téhož nakupujícího. ROASaurus před odesláním každého nákupu krátce počká, aby mohla jako první dorazit událost z děkovné stránky, a v okamžiku odeslání zkusí párování znovu.

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

Stránka Orders ukazuje, jak se každá objednávka propojila, ve sloupci Matched by: thank_you, email, ip nebo not matched. Nespárovaná objednávka přesto jde do vašich reklamních platforem s daty objednávky, ale bez identifikátorů kliknutí, a atribuce v ROASaurus ji zobrazí jako přímou nebo neznámou.

Odesílání nákupů z Lightspeed do Meta a TikTok

Každá zaplacená objednávka se stává jednou serverovou událostí na každou připojenou platformu: Purchase pro Meta Conversions API a CompletePayment pro TikTok Events API, obě s ID události order-ORD01042. TikTok dnes ve svých reportech zobrazuje CompletePayment jako Purchase. Když zaškrtnete možnost načíst také pixel v prohlížeči, fragment kódu na děkovné stránce spustí stejné události v prohlížeči se stejným ID události. Meta a TikTok si pak ponechají jednu kopii.

Stejné objednávky jdou do Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn a dalších reklamních platforem, když je připojíte. Nákupní konverze Google Ads se odesílají jen z pokladny Shopify, takže je ROASaurus z Lightspeed neodesílá. K nastavení na straně Meta viz průvodce Meta Conversions API.

Jak nastavit tracking konverzí v Lightspeed

1. Přidejte obchod v ROASaurus

   Přejděte na Add a store, vyberte Lightspeed eCom a zadejte adresu svého obchodu. Na kartě Connection se pak zobrazí vaše značka skriptu a fragment kódu pro děkovnou stránku.

2. Přidejte skript na každou stránku

   V administraci Lightspeed přejděte do Settings › Website Settings › Web Extras › Custom JavaScript a vložte značku skriptu. Lightspeed tento kód spouští na všech stránkách.

3. Přidejte fragment kódu pro děkovnou stránku

   Na téže stránce v oblasti Tracking zapněte Status a vložte fragment kódu. Lightspeed ho po objednávce spouští na stránce Thank You.

4. Vytvořte klíč API

   Přejděte do Settings › Store Settings › Developers › New API key. Klíč zapněte, zaškrtněte přístup pro čtení objednávek, uložte a výběrem Show zobrazte tajný klíč (secret).

5. Připojte API

   Na kartě Connection zadejte klíč, tajný klíč (secret), region a jazyk obchodu. Uložte, stiskněte Test connection a poté Create webhook.

6. Připojte své reklamní platformy

   V Tracking & platforms použijte pro Meta Connect with Facebook nebo Add pixel a pro TikTok Add pixel s kódem pixelu a přístupovým tokenem Events API. Zaškrtněte možnost načíst také pixel v prohlížeči.

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)

Souhlas

Mimo Shopify čte skript ROASaurus volbu návštěvníka z běžných nástrojů pro správu souhlasů: Cookiebot, OneTrust, lišt IAB TCF a Google consent mode. U jiné cookie lišty zavolejte tlq('consent', true), když návštěvník přijme marketingové cookies, a tlq('consent', false), když je odmítne. Dokud návštěvník nepřijme, nemá žádné ID návštěvníka ani ID kliknutí a nespouštějí se žádné pixely v prohlížeči. Zaplacená objednávka se přesto odesílá ze serveru s hashovanými údaji o zákazníkovi z objednávky a s IP adresou a prohlížečem objednávky. Podrobnosti vysvětluje stránka nápovědy o souhlasu.

Jak otestovat tracking konverzí v Lightspeed?

• Otevřete svůj obchod s ?roasaurus=connected v adrese. Upozornění potvrdí, že skript běží. ?roasaurus=debug zapisuje do konzole prohlížeče, co odesílá.
• V Event log by v části Collected events měla zobrazení stránek ukazovat ID návštěvníka.
• Zadejte objednávku a ujistěte se, že její stav platby je paid. V části Collected events by Event log měl ukázat Purchase s vaším číslem objednávky v datech. Pokud chybí, zkontrolujte, že je Status v oblasti Tracking zapnutý.
• Na kartě Connection ukazuje Last order received objednávku a Last sync poslední 5minutovou kontrolu, včetně případné chyby z Lightspeed.
• V části Server deliveries v Event log dostane každá připojená platforma řádek se stavem sent a odpovědí platformy.

Chcete-li událost vidět v Meta, vložte kód z Events Manager › Test events do pole Test event code u svého pixelu Meta v ROASaurus a po dokončení ho odeberte. Nastavení pixelu TikTok v ROASaurus má stejné pole.

Omezení a hraniční případy

• Pouze C-Series. E-shopy Lightspeed eCom s E-Series tento konektor použít nemohou.
• Pouze zaplacené objednávky. Částečně zaplacená objednávka se odešle, když se její stav platby změní na paid.
• Pozdní platby a 7denní limit Meta. Meta přijímá serverové události až 7 dní po čase události. ROASaurus používá čas vytvoření objednávky, takže objednávku zaplacenou více než 7 dní po jejím vytvoření Meta odmítne.
• Nákupy z prohlížeče před platbou. Fragment kódu na děkovné stránce běží při zadání objednávky, takže pixely v prohlížeči nahlásí objednávku placenou bankovním převodem ještě před zaplacením. Pokud platba přijde o více než 48 hodin později, Meta a TikTok nemohou kopii z prohlížeče a kopii ze serveru sloučit.
• Storna a vratky se neodesílají. Jakmile se nákup odešle, zůstává v reklamní platformě.
• Bez kódu jen zobrazení stránek. Zobrazení produktů a přidání do košíku se automaticky zjišťují jen na Shopify. Na Lightspeed je může odeslat vývojář voláním tlq track.
• Limity API. Lightspeed povoluje na jeden klíč API 300 požadavků za 5 minut, 3,000 za hodinu a 12,000 za den. Pokud stejný klíč používá jiný nástroj, tyto limity sdílejí. Pro druhý klíč vás Lightspeed žádá, abyste je kontaktovali.

Stránka integrace Lightspeed uvádí údaje o připojení na jednom místě a stránka nápovědy pro další e-shopy porovnává Lightspeed s dalšími platformami, ke kterým se ROASaurus připojuje.

Zdroje

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

V ROASaurus

• Integrace Lightspeed
• Nápověda: Wix, Lightspeed a další e-shopy
• Server-side tracking
• Integrace Meta

Čtěte dál