Lightspeed konverziókövetés eCom webáruházakhoz

A Lightspeed konverziókövetés azt jelenti, hogy a Lightspeed eCom webáruházad minden kifizetett rendelését jelented a hirdetési platformoknak, például a Metának és a TikToknak, hogy a megfelelő hirdetéseknek írhassák jóvá, és optimalizálhassák a kampányaidat. A megbízható mód az, hogy minden vásárlást a Lightspeed rendelési adataiból küldesz el a szerveren, és egy rövid kódrészletet adsz a köszönőoldalhoz, amely összekapcsolja a rendelést a hirdetési kattintással.

Ez az útmutató bemutatja, melyik Lightspeed termékre vonatkozik, hogyan jutnak el a rendelések a ROASaurushoz, mit olvas ki a rendszer az egyes rendelésekből, hogyan jutnak el a vásárlások a Metához és a TikTokhoz, a beállítást, a tesztelést és a tudnivaló korlátokat.

Melyik Lightspeed termékre vonatkozik ez az útmutató?

A Lightspeed több e-kereskedelmi terméket árul, ezért először ellenőrizd a sajátodat. A ROASaurus a Lightspeed eCom (C-Series) rendszerhez kapcsolódik, ahhoz a webáruház-platformhoz, amelynek adminisztrációs felületén van Settings › Website Settings › Web Extras. Az API-ja két klaszteren fut:

Minden API-cím tartalmaz egy kétbetűs nyelvkódot is, például /nl/ vagy /en/. A ROASaurus webáruház-nyelvként kéri be, és nl értéket használ, ha üresen hagyod.

A Lightspeed kínálja az eCom (E-Series) rendszert is. A Lightspeed az E-Series-re való áttérést egy külön termékre való frissítésként írja le, amelyet jelenleg bizonyos észak-amerikai kereskedőknek kínál. A ROASaurus Lightspeed-összekötője csak a C-Series API-n keresztül olvassa a rendeléseket, ezért az E-Series webáruházakat nem fedi le.

Miért tűnnek el a Lightspeed-vásárlások a Metán és a TikTokon?

A böngészőben lévő pixel csak akkor jelent vásárlást, ha a vásárló böngészője betölti a köszönőoldalt, és a pixelszkript lefut. Ez több gyakori helyzetben nem sikerül:

• A vásárló átirányítással fizet, például iDEAL-lal vagy PayPallal, és bezárja a lapot, mielőtt a köszönőoldal betöltődne.
• Egy reklámblokkoló vagy a böngésző adatvédelmi beállítása blokkolja a pixelszkriptet.
• A látogató elutasítja a marketingsütiket, ezért a pixel nem töltődhet be.
• A rendelést később fizetik ki, például banki átutalással, amikor nincs böngésző a képben.
• A Safari korlátozza, mennyi ideig élnek a szkriptek által beállított sütik, így a böngésző elfelejthet egy régebbi hirdetési kattintást.

Hogyan jutnak el a Lightspeed rendelések a ROASaurushoz?

A Create webhook megnyomásakor a ROASaurus regisztrál egy webhookot a Lightspeedben az orders csoportra és az updated műveletre, JSON formátumban. Ettől kezdve a Lightspeed meghívja a ROASaurust, amikor egy rendelés megváltozik.

Miért olvassa újra a ROASaurus a rendelést

A Lightspeed csak akkor ad x-signature fejlécet egy webhookhoz, ha azt egy app hozta létre. Az egyszerű API-kulccsal létrehozott webhook, mint itt is, aláíratlan. Ezért a webhook címe tartalmaz egy, a webáruházadra egyedi tokent, a ROASaurus pedig nem bízik a payloadban. A rendelést és a termékeit a Lightspeed API-ból olvassa be, és a fizetési állapotot maga ellenőrzi.

Az 5 perces ellenőrzés

A ROASaurus 5 percenként azt is lekérdezi a Lightspeedtől, mely rendelések frissültek az utolsó ellenőrzése óta, 30 perc átfedéssel, és rögzíti azokat a kifizetett rendeléseket, amelyek még nincsenek meg neki. Mivel ez az ellenőrzés a frissítési időt használja, a leadás után napokkal kifizetett rendelés akkor is felkerül, ha a webhook-kézbesítése sikertelen volt. A már meglévő rendeléseket a ROASaurus figyelmen kívül hagyja, így a webhook és az ellenőrzés soha nem hoz létre két vásárlást.

A Lightspeed oldalán a webhooknak 5 másodpercen belül 2xx választ kell kapnia. A sikertelen kézbesítéseket újrapróbálják, összesen legfeljebb 10 kísérletig, és az a webhook, amelynek hibaaránya 50 órán át 50% felett marad, letiltásra kerül. Az 5 perces ellenőrzés egy ilyen kiesés alatt is biztosítja a rendelések érkezését.

Mit olvas ki a ROASaurus egy Lightspeed rendelésből?

A vásárlási érték tartalmazza az áfát

A Lightspeed priceIncl mezője a rendelés adóval együtt számított ára, és a ROASaurus ezt az értéket küldi. A hirdetési platformjaid ezért áfával együtt jelentik a bevételt. Íme a hatás 21% áfánál:

A megtérülési ROAS az áfa nélküli bevételt használja. Mielőtt a kettőt összehasonlítod, oszd el a platform ROAS-át 1 plusz az áfakulcsod értékével.

Hogyan kapcsolódik egy Lightspeed rendelés a hirdetési kattintáshoz?

Egy hirdetés jóváírásához a platformnak szüksége van a rendelő látogató kattintásazonosítóira: a Meta kattintásazonosítójára és böngészőazonosítójára (fbc, fbp), a TikTok kattintásazonosítójára (ttclid) és a TikTok sütijére (ttp). A ROASaurus szkript ezeket minden látogatóhoz eltárolja, amikor hirdetésből érkezik. A ROASaurus nem kapja meg ezt a látogatóazonosítót a Lightspeed rendeléséből, ezért más módon köti egy látogatóhoz az egyes rendeléseket. Három módszert próbál ki, ebben a sorrendben:

A kódrészlet a rendelés végösszegét, a pénznemet és a vásárló e-mail-címét is átadja. A ROASaurus a látogatóhoz elmenti ennek az e-mail-címnek a hashét, ami segít ugyanannak a vásárlónak a következő rendelését párosítani. A ROASaurus röviden vár, mielőtt elküldi az egyes vásárlásokat, hogy a köszönőoldali esemény érkezhessen előbb, és a küldéskor újra megpróbálja a párosítást.

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

Az Orders oldal a Matched by oszlopban mutatja, hogyan kötötték össze az egyes rendeléseket: thank_you, email, ip vagy not matched. Egy nem párosított rendelés is eljut a hirdetési platformjaidhoz a rendelési adataival, de kattintásazonosítók nélkül, és a ROASaurus attribúció direktként vagy ismeretlenként mutatja.

Lightspeed-vásárlások küldése a Metának és a TikToknak

Minden kifizetett rendelésből csatlakoztatott platformonként egy szerveresemény lesz: egy Purchase a Meta Conversions API-jához és egy CompletePayment a TikTok Events API-jához, mindkettő az order-ORD01042 eseményazonosítóval. A TikTok a CompletePayment eseményt ma már Purchase-ként mutatja a jelentéseiben. Ha bejelölöd a böngészőpixel egyidejű betöltésének opcióját, a köszönőoldali kódrészlet ugyanezeket az eseményeket a böngészőben is elsüti ugyanazzal az eseményazonosítóval. A Meta és a TikTok ekkor egy példányt tart meg.

Ugyanezek a rendelések a Snapchathez, a Pinteresthez, a Reddithez, az X-hez, a Microsoft Adshez, a Taboolához, a LinkedInhez és a többi hirdetési platformhoz is eljutnak, ha csatlakoztatod őket. A Google Ads vásárlási konverziói csak a Shopify pénztárából mennek el, ezért a ROASaurus a Lightspeedből nem küldi őket. A beállítás Meta oldali részéhez lásd a Meta Conversions API útmutatót.

Hogyan állítsd be a Lightspeed konverziókövetést

1. Add hozzá a webáruházat a ROASaurusban

   Menj az Add a store oldalra, válaszd a Lightspeed eCom opciót, és add meg a webáruházad címét. A Connection fül ekkor megmutatja a szkriptcímkédet és a köszönőoldali kódrészletet.

2. Add hozzá a szkriptet minden oldalhoz

   A Lightspeed adminisztrációs felületén menj ide: Settings › Website Settings › Web Extras › Custom JavaScript, és illeszd be a szkriptcímkét. A Lightspeed ezt a kódot minden oldalon futtatja.

3. Add hozzá a köszönőoldali kódrészletet

   Ugyanazon az oldalon, a Tracking területen kapcsold be a Status opciót, és illeszd be a kódrészletet. A Lightspeed rendelés után a Thank You oldalon futtatja.

4. Hozz létre egy API-kulcsot

   Menj ide: Settings › Store Settings › Developers › New API key. Kapcsold be a kulcsot, jelöld be a rendelések olvasási hozzáférését, mentsd, és válaszd a Show lehetőséget a secret megjelenítéséhez.

5. Csatlakoztasd az API-t

   A Connection fülön add meg a kulcsot, a secretet, a régiót és a webáruház nyelvét. Mentsd, nyomd meg a Test connection gombot, majd a Create webhook gombot.

6. Csatlakoztasd a hirdetési platformjaidat

   A Tracking & platforms oldalon használd a Connect with Facebook vagy az Add pixel gombot a Metához, a TikTokhoz pedig az Add pixel gombot a pixelkóddal és egy Events API hozzáférési tokennel. Jelöld be a böngészőpixel egyidejű betöltésének opcióját.

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)

Hozzájárulás

A Shopifyon kívül a ROASaurus script a látogató döntését a gyakori hozzájárulás-kezelő eszközökből olvassa ki: Cookiebot, OneTrust, IAB TCF bannerek és Google consent mode. Más sütibanner esetén hívd meg a tlq('consent', true) függvényt, amikor a látogató elfogadja a marketingsütiket, és a tlq('consent', false) függvényt, amikor elutasítja. Amíg a látogató nem fogadja el, nincs látogatóazonosítója vagy kattintásazonosítója, és nem fut böngészőpixel. A kifizetett rendelést ettől még elküldi a szerver a rendelés hashelt ügyféladataival, valamint a rendelés IP-címével és böngészőjével. A részleteket a hozzájárulásról szóló súgóoldal tartalmazza.

Hogyan teszteled a Lightspeed konverziókövetést?

• Nyisd meg a webáruházadat úgy, hogy a címhez hozzáadod a ?roasaurus=connected paramétert. Egy felugró üzenet megerősíti, hogy a szkript fut. A ?roasaurus=debug a böngészőkonzolba naplózza, mit küld el.
• Az Event log Collected events részében az oldalmegtekintéseknél látnod kell egy látogatóazonosítót.
• Adj le egy rendelést, és győződj meg róla, hogy a fizetési állapota paid. A Collected events alatt az Event log-nak ekkor egy Purchase eseményt kell mutatnia a rendelésszámoddal az adatai között. Ha hiányzik, ellenőrizd, hogy a Status be van kapcsolva a Tracking területen.
• A Connection fülön a Last order received mutatja a rendelést, a Last sync pedig az utolsó 5 perces ellenőrzést, a Lightspeedtől származó esetleges hibával együtt.
• Az Event log Server deliveries részében minden csatlakoztatott platform kap egy sort a sent státusszal és a platform válaszával.

Az esemény Metában való megtekintéséhez illeszd be az Events Manager › Test events alatti kódot a ROASaurusban a Meta pixeled Test event code mezőjébe, és ha végeztél, távolítsd el. A TikTok pixelbeállításaiban a ROASaurusban ugyanez a mező megvan.

Korlátok és szélsőséges esetek

• Csak C-Series. A Lightspeed eCom E-Series webáruházak nem használhatják ezt az összekötőt.
• Csak kifizetett rendelések. A részben fizetett rendelés akkor kerül elküldésre, amikor a fizetési állapota paid-re változik.
• Késői fizetések és a Meta 7 napos korlátja. A Meta az eseményidőt követő legfeljebb 7 napig fogad szervereseményeket. A ROASaurus a rendelés létrehozási idejét használja, ezért a leadás után több mint 7 nappal kifizetett rendelést a Meta elutasítja.
• Böngészős vásárlások fizetés előtt. A köszönőoldali kódrészlet a rendelés leadásakor fut le, így a böngészőpixelek a banki átutalásos rendelést a kifizetése előtt jelentik. Ha a fizetés több mint 48 órával később érkezik, a Meta és a TikTok nem tudja összevonni a böngészős és a szerveres példányt.
• A lemondásokat és visszatérítéseket nem küldjük el. Ha egy vásárlást egyszer elküldtek, az a hirdetési platformon marad.
• Csak oldalmegtekintések, kód nélkül. A termékmegtekintéseket és a kosárba tételeket csak Shopifyon észleli automatikusan. Lightspeedben egy fejlesztő elküldheti őket egy tlq track hívással.
• API-korlátok. A Lightspeed API-kulcsonként 5 percenként 300, óránként 3,000 és naponta 12,000 kérést enged. Ha egy másik eszköz ugyanazt a kulcsot használja, osztoznak ezeken a korlátokon. A Lightspeed azt kéri, hogy második kulcsért fordulj hozzájuk.

A Lightspeed-integráció oldala egy helyen felsorolja a kapcsolat tudnivalóit, a más webáruházakhoz tartozó súgóoldal pedig összehasonlítja a Lightspeedet a többi platformmal, amelyekhez a ROASaurus csatlakozik.

Források

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

A ROASaurusban

• Lightspeed-integráció
• Súgó: Wix, Lightspeed és más webáruházak
• Szerveroldali követés
• Meta integráció

Olvass tovább