Lightspeed-konversioseuranta eCom-verkkokaupoille

Lightspeed-konversioseuranta tarkoittaa, että jokainen Lightspeed eCom -verkkokauppasi maksettu tilaus raportoidaan mainosalustoille, kuten Metalle ja TikTokille, jotta ne voivat hyvittää oikeat mainokset ja optimoida kampanjasi. Luotettava tapa on lähettää jokainen osto Lightspeedin tilausdatasta palvelimelta ja lisätä kiitossivulle lyhyt koodinpätkä, joka yhdistää tilauksen mainosklikkaukseen.

Tämä opas käsittelee, mihin Lightspeed-tuotteeseen se soveltuu, miten tilaukset päätyvät ROASaurukseen, mitä kustakin tilauksesta luetaan, miten ostot päätyvät Metalle ja TikTokille, käyttöönoton, testauksen ja rajoitukset, jotka kannattaa tietää.

Mitä Lightspeed-tuotetta tämä opas käsittelee?

Lightspeed myy useampaa kuin yhtä verkkokauppatuotetta, joten tarkista ensin omasi. ROASaurus yhdistää Lightspeed eCom (C-Series) -alustaan, jonka hallintapaneelissa on kohta Settings › Website Settings › Web Extras. Sen API toimii kahdessa klusterissa:

Jokainen API-osoite sisältää myös kaksikirjaimisen kielikoodin, esimerkiksi /nl/ tai /en/. ROASaurus kysyy sitä kaupan kielenä ja käyttää arvoa nl, kun jätät kentän tyhjäksi.

Lightspeed tarjoaa myös eCom (E-Series) -tuotetta. Lightspeed kuvaa siirtymistä E-Seriesiin päivityksenä erilliseen tuotteeseen, jota tarjotaan tällä hetkellä tietyille pohjoisamerikkalaisille kauppiaille. ROASaurusin Lightspeed-liitin lukee tilaukset vain C-Series API:n kautta, joten se ei kata E-Series-kauppoja.

Miksi Lightspeed-ostot katoavat Metassa ja TikTokissa?

Selaimen pikseli raportoi oston vain, kun ostajan selain lataa kiitossivun ja pikselin skripti toimii. Se epäonnistuu useissa yleisissä tilanteissa:

• Ostaja maksaa uudelleenohjauksella, esimerkiksi iDEALilla tai PayPalilla, ja sulkee välilehden ennen kuin kiitossivu latautuu.
• Mainosesto tai selaimen tietosuoja-asetus estää pikseliskriptin.
• Kävijä kieltäytyy markkinointievästeistä, joten pikseli ei saa latautua.
• Tilaus maksetaan myöhemmin, esimerkiksi tilisiirrolla, jolloin selainta ei ole mukana.
• Safari rajoittaa skriptien asettamien evästeiden kestoa, joten selain voi unohtaa vanhemman mainosklikkauksen.

Miten Lightspeed-tilaukset päätyvät ROASaurukseen?

Kun painat Create webhook, ROASaurus rekisteröi Lightspeedissa webhookin ryhmälle orders ja toiminnolle updated JSON-muodossa. Siitä lähtien Lightspeed kutsuu ROASaurusta, kun tilaus muuttuu.

Miksi ROASaurus lukee tilauksen uudelleen

Lightspeed lisää webhookiin x-signature-otsikon vain, kun sovellus loi sen. Tavallisella API-avaimella luotu webhook, kuten tässä, on allekirjoittamaton. Siksi webhook-osoite sisältää kauppasi yksilöllisen tunnisteen, eikä ROASaurus luota lähetettyyn sisältöön. Se lukee tilauksen ja sen tuotteet Lightspeed API:sta ja tarkistaa maksutilan itse.

5 minuutin tarkistus

Joka 5. minuutti ROASaurus pyytää Lightspeedilta myös tilaukset, jotka on päivitetty edellisen tarkistuksen jälkeen, 30 minuutin päällekkäisyydellä, ja tallentaa maksetut tilaukset, joita sillä ei vielä ole. Koska tämä tarkistus käyttää päivitysaikaa, tilaus, joka maksetaan päiviä tekemisen jälkeen, tulee mukaan, vaikka sen webhook-lähetys epäonnistuisi. Tilaukset, jotka ROASaurus on jo tallentanut, ohitetaan, joten webhook ja tarkistus eivät koskaan luo kahta ostoa.

Lightspeedin puolella webhookin on saatava 2xx-vastaus 5 sekunnin sisällä. Epäonnistuneet lähetykset yritetään uudelleen, yhteensä enintään 10 yritystä, ja webhook, jonka virhesuhde pysyy yli 50%:n 50 tunnin ajan, poistetaan käytöstä. 5 minuutin tarkistus pitää tilaukset tulossa tällaisen katkon aikana.

Mitä ROASaurus lukee Lightspeed-tilauksesta?

Oston arvo sisältää ALV:n

Lightspeedin priceIncl on tilauksen hinta veroineen, ja se on arvo, jonka ROASaurus lähettää. Mainosalustasi raportoivat siksi liikevaihdon ALV:n kanssa. Tässä vaikutus 21%:n ALV:llä:

Kannattavuusrajan ROAS käyttää liikevaihtoa ilman ALV:tä. Jaa alustan ROAS luvulla 1 plus ALV-kantasi, ennen kuin vertaat näitä kahta.

Miten Lightspeed-tilaus yhdistetään mainosklikkaukseen?

Mainoksen hyvittämiseksi alusta tarvitsee tilanneen kävijän klikkaustunnisteet: Metan klikkaus-ID:n ja selain-ID:n (fbc, fbp), TikTokin klikkaus-ID:n (ttclid) ja TikTokin evästeen (ttp). ROASaurus-skripti tallentaa ne jokaiselle kävijälle, kun tämä saapuu mainoksesta. ROASaurus ei saa tuota kävijätunnusta Lightspeed-tilauksesta, joten se yhdistää jokaisen tilauksen kävijään toisella tavalla. Se kokeilee kolmea menetelmää tässä järjestyksessä:

Koodinpätkä välittää myös tilauksen loppusumman, valuutan ja asiakkaan sähköpostin. ROASaurus tallentaa kävijälle kyseisen sähköpostin hashin, mikä auttaa yhdistämään saman ostajan seuraavan tilauksen. ROASaurus odottaa hetken ennen kunkin oston lähettämistä, jotta kiitossivun tapahtuma ehtii saapua ensin, ja yrittää yhdistämistä uudelleen lähetyshetkellä.

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

Orders-sivu näyttää, miten kukin tilaus yhdistettiin, Matched by-sarakkeessa: thank_you, email, ip tai not matched. Tilaus, jota ei ole yhdistetty, menee silti mainosalustoillesi tilausdatan kanssa, mutta ilman klikkaustunnisteita, ja ROASaurus-attribuutio näyttää sen suorana tai tuntemattomana.

Lightspeed-ostojen lähettäminen Metalle ja TikTokille

Jokaisesta maksetusta tilauksesta tulee yksi palvelintapahtuma kutakin yhdistettyä alustaa kohden: Purchase Metan Conversions API:lle ja CompletePayment TikTokin Events API:lle, molemmat tapahtuma-ID:llä order-ORD01042. TikTok näyttää nykyään CompletePayment-tapahtuman raporteissaan nimellä Purchase. Kun rastitat vaihtoehdon ladata myös selainpikselin, kiitossivun koodinpätkä laukaisee samat tapahtumat selaimessa samalla tapahtuma-ID:llä. Meta ja TikTok säilyttävät silloin yhden kopion.

Samat tilaukset menevät Snapchatille, Pinterestille, Redditille, X:lle, Microsoft Adsille, Taboolalle, LinkedInille ja muille mainosalustoille, kun yhdistät ne. Google Adsin ostokonversiot lähetetään vain Shopifyn kassalta, joten ROASaurus ei lähetä niitä Lightspeedistä. Metan puolen käyttöönottoa varten katso Meta Conversions API -opas.

Näin otat Lightspeed-konversioseurannan käyttöön

1. Lisää kauppa ROASaurukseen

   Siirry kohtaan Add a store, valitse Lightspeed eCom ja syötä kauppasi osoite. Connection-välilehti näyttää sitten skriptitunnisteesi ja kiitossivun koodinpätkän.

2. Lisää skripti jokaiselle sivulle

   Siirry Lightspeedin hallintapaneelissa kohtaan Settings › Website Settings › Web Extras › Custom JavaScript ja liitä skriptitunniste. Lightspeed ajaa tämän koodin kaikilla sivuilla.

3. Lisää kiitossivun koodinpätkä

   Ota samalla sivulla Tracking-alueella Status käyttöön ja liitä koodinpätkä. Lightspeed ajaa sen Thank You -sivulla tilauksen jälkeen.

4. Luo API-avain

   Siirry kohtaan Settings › Store Settings › Developers › New API key. Kytke avain päälle, rastita lukuoikeus tilauksiin, tallenna ja valitse Show nähdäksesi salaisuuden.

5. Yhdistä API

   Syötä Connection-välilehdellä avain, salaisuus, alue ja kaupan kieli. Tallenna, paina Test connection ja sitten Create webhook.

6. Yhdistä mainosalustasi

   Käytä kohdassa Tracking & platforms vaihtoehtoa Connect with Facebook tai Add pixel Metalle ja Add pixel TikTokille pikselikoodilla ja Events API access tokenilla. Rastita vaihtoehto ladata myös selainpikseli.

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)

Suostumus

Shopifyn ulkopuolella ROASaurus-skripti lukee kävijän valinnan yleisistä suostumustyökaluista: Cookiebot, OneTrust, IAB TCF -bannerit ja Google consent mode. Jos käytössä on jokin muu evästebanneri, kutsu tlq('consent', true), kun kävijä hyväksyy markkinointievästeet, ja tlq('consent', false), kun hän kieltäytyy. Kunnes kävijä hyväksyy, hänellä ei ole kävijätunnusta eikä klikkaus-ID:itä, eikä selainpikseleitä laukea. Maksettu tilaus lähetetään silti palvelimelta tilauksen hashatun asiakasdatan sekä tilauksen IP-osoitteen ja selaimen kanssa. Suostumusta käsittelevä ohjesivu kertoo yksityiskohdat.

Miten Lightspeed-konversioseuranta testataan?

• Avaa kauppasi lisäämällä osoitteeseen ?roasaurus=connected. Ilmoitus vahvistaa, että skripti toimii. ?roasaurus=debug kirjaa selaimen konsoliin sen, mitä skripti lähettää.
• Kohdassa Collected events (Event log) sivunäytöillä pitäisi näkyä kävijätunnus.
• Tee tilaus ja varmista, että sen maksutila on paid. Event log -näkymän Collected events -kohdassa pitäisi silloin näkyä Purchase, jonka datassa on tilausnumerosi. Jos se puuttuu, tarkista, että Status on päällä Tracking-alueella.
• Connection-välilehdellä Last order received näyttää tilauksen ja Last sync viimeisen 5 minuutin tarkistuksen sekä mahdollisen Lightspeedin virheen.
• Kohdassa Server deliveries (Event log) jokaiselle yhdistetylle alustalle tulee rivi, jonka tila on sent, sekä alustan vastaus.

Nähdäksesi tapahtuman Metassa liitä koodi kohdasta Events Manager › Test events ROASaurusissa olevan Meta-pikselisi Test event code -kenttään ja poista se, kun olet valmis. TikTokin pikseliasetuksissa ROASaurusissa on sama kenttä.

Rajoitukset ja reunatapaukset

• Vain C-Series. Lightspeed eCom E-Series -kaupat eivät voi käyttää tätä liitintä.
• Vain maksetut tilaukset. Osittain maksettu tilaus lähetetään, kun sen maksutila muuttuu tilaan paid.
• Myöhästyneet maksut ja Metan 7 päivän raja. Meta hyväksyy palvelintapahtumat enintään 7 päivää tapahtuma-ajan jälkeen. ROASaurus käyttää tilauksen luontiaikaa, joten tilauksen, joka maksetaan yli 7 päivää sen tekemisen jälkeen, Meta hylkää.
• Selainostot ennen maksua. Kiitossivun koodinpätkä toimii, kun tilaus tehdään, joten selainpikselit raportoivat tilisiirtotilauksen ennen kuin se on maksettu. Jos maksu tulee yli 48 tuntia myöhemmin, Meta ja TikTok eivät voi yhdistää selain- ja palvelinkopioita.
• Peruutuksia ja hyvityksiä ei lähetetä. Kun osto on lähetetty, se pysyy mainosalustalla.
• Ilman koodia vain sivunäytöt. Tuotenäytöt ja ostoskoriin lisäykset havaitaan automaattisesti vain Shopifyssa. Lightspeedissa kehittäjä voi lähettää ne tlq-track-kutsulla.
• API-rajat. Lightspeed sallii 300 pyyntöä 5 minuutissa, 3,000 tunnissa ja 12,000 päivässä API-avainta kohden. Jos jokin toinen työkalu käyttää samaa avainta, ne jakavat nämä rajat. Toista avainta varten Lightspeed pyytää ottamaan yhteyttä sen tukeen.

Lightspeed-integraatiosivu listaa yhteyden tiedot yhteen paikkaan, ja muiden verkkokauppojen ohjesivu vertailee Lightspeedia muihin alustoihin, joihin ROASaurus yhdistyy.

Lähteet

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

ROASaurusissa

• Lightspeed-integraatio
• Ohje: Wix, Lightspeed ja muut verkkokaupat
• Palvelinpuolen seuranta
• Meta-integraatio

Lue lisää