Παρακολούθηση μετατροπών στο Lightspeed για ηλεκτρονικά καταστήματα eCom

Η παρακολούθηση μετατροπών στο Lightspeed σημαίνει ότι αναφέρετε κάθε πληρωμένη παραγγελία του ηλεκτρονικού σας καταστήματος Lightspeed eCom σε διαφημιστικές πλατφόρμες όπως η Meta και το TikTok, ώστε να αποδίδουν σωστά τις διαφημίσεις και να βελτιστοποιούν τις καμπάνιες σας. Ο αξιόπιστος τρόπος είναι να στέλνετε κάθε αγορά από τα δεδομένα παραγγελιών του Lightspeed στον server και να προσθέτετε ένα σύντομο snippet στη σελίδα ευχαριστίας που συνδέει την παραγγελία με το κλικ στη διαφήμιση.

Ο οδηγός αυτός καλύπτει σε ποιο προϊόν Lightspeed ισχύει, πώς φτάνουν οι παραγγελίες στο ROASaurus, τι διαβάζεται από κάθε παραγγελία, πώς φτάνουν οι αγορές στη Meta και στο TikTok, τη ρύθμιση, τη δοκιμή και τους περιορισμούς που πρέπει να γνωρίζετε.

Ποιο προϊόν Lightspeed καλύπτει αυτός ο οδηγός;

Το Lightspeed πουλά περισσότερα από ένα προϊόντα ηλεκτρονικού εμπορίου, οπότε ελέγξτε πρώτα το δικό σας. Το ROASaurus συνδέεται με το Lightspeed eCom (C-Series), την πλατφόρμα ηλεκτρονικών καταστημάτων της οποίας το back office έχει Settings › Website Settings › Web Extras. Το API της τρέχει σε δύο clusters:

Κάθε διεύθυνση API περιέχει επίσης έναν κωδικό γλώσσας δύο γραμμάτων, για παράδειγμα /nl/ ή /en/. Το ROASaurus τον ζητά ως γλώσσα του καταστήματος και χρησιμοποιεί nl όταν τον αφήνετε κενό.

Το Lightspeed προσφέρει επίσης eCom (E-Series). Το Lightspeed περιγράφει τη μετάβαση στο E-Series ως αναβάθμιση σε ξεχωριστό προϊόν, που προσφέρεται προς το παρόν σε ορισμένους εμπόρους της Βόρειας Αμερικής. Ο connector Lightspeed του ROASaurus διαβάζει παραγγελίες μόνο μέσω του API του C-Series, οπότε δεν καλύπτει καταστήματα E-Series.

Γιατί χάνονται οι αγορές από το Lightspeed στη Meta και στο TikTok;

Ένα pixel στο πρόγραμμα περιήγησης αναφέρει μια αγορά μόνο όταν το πρόγραμμα περιήγησης του αγοραστή φορτώνει τη σελίδα ευχαριστίας και τρέχει το script του pixel. Αυτό αποτυγχάνει σε αρκετές συνηθισμένες περιπτώσεις:

• Ένας αγοραστής πληρώνει με ανακατεύθυνση, για παράδειγμα με iDEAL ή PayPal, και κλείνει την καρτέλα πριν φορτώσει η σελίδα ευχαριστίας.
• Ένα ad blocker ή μια ρύθμιση απορρήτου του προγράμματος περιήγησης μπλοκάρει το script του pixel.
• Ο επισκέπτης απορρίπτει τα cookies μάρκετινγκ, οπότε το pixel δεν πρέπει να φορτώσει.
• Η παραγγελία πληρώνεται αργότερα, για παράδειγμα με τραπεζική μεταφορά, όταν δεν εμπλέκεται πρόγραμμα περιήγησης.
• Το Safari περιορίζει για πόσο διαρκούν τα cookies που ορίζουν scripts, οπότε το πρόγραμμα περιήγησης μπορεί να ξεχάσει ένα παλαιότερο κλικ σε διαφήμιση.

Πώς φτάνουν οι παραγγελίες του Lightspeed στο ROASaurus;

Όταν πατήσετε Create webhook, το ROASaurus καταχωρίζει στο Lightspeed ένα webhook για την ομάδα orders και την ενέργεια updated, σε μορφή JSON. Από εκεί και πέρα, το Lightspeed καλεί το ROASaurus όταν αλλάζει μια παραγγελία.

Γιατί το ROASaurus διαβάζει ξανά την παραγγελία

Το Lightspeed προσθέτει μια κεφαλίδα x-signature σε ένα webhook μόνο όταν το δημιούργησε μια εφαρμογή. Ένα webhook που δημιουργήθηκε με απλό κλειδί API, όπως εδώ, δεν είναι υπογεγραμμένο. Για τον λόγο αυτό η διεύθυνση του webhook περιέχει ένα token μοναδικό για το κατάστημά σας και το ROASaurus δεν εμπιστεύεται το payload. Διαβάζει την παραγγελία και τα προϊόντα της από το API του Lightspeed και ελέγχει μόνο του την κατάσταση πληρωμής.

Ο έλεγχος των 5 λεπτών

Κάθε 5 λεπτά, το ROASaurus ρωτά επίσης το Lightspeed για παραγγελίες που ενημερώθηκαν από τον τελευταίο έλεγχο, με επικάλυψη 30 λεπτών, και καταγράφει τις πληρωμένες παραγγελίες που δεν έχει ακόμη. Επειδή αυτός ο έλεγχος χρησιμοποιεί την ώρα ενημέρωσης, μια παραγγελία που πληρώθηκε μέρες μετά την υποβολή της εντοπίζεται ακόμη κι αν απέτυχε η παράδοση του webhook της. Οι παραγγελίες που το ROASaurus έχει ήδη αγνοούνται, οπότε το webhook και ο έλεγχος δεν δημιουργούν ποτέ δύο αγορές.

Από την πλευρά του Lightspeed, ένα webhook πρέπει να λάβει απάντηση 2xx μέσα σε 5 δευτερόλεπτα. Οι αποτυχημένες παραδόσεις επαναλαμβάνονται, με έως 10 προσπάθειες συνολικά, και ένα webhook του οποίου το ποσοστό σφαλμάτων μένει πάνω από 50% για 50 ώρες απενεργοποιείται. Ο έλεγχος των 5 λεπτών κρατά τις παραγγελίες να έρχονται κατά τη διάρκεια ενός τέτοιου κενού.

Τι διαβάζει το ROASaurus από μια παραγγελία Lightspeed;

Η αξία αγοράς περιλαμβάνει ΦΠΑ

Το priceIncl του Lightspeed είναι η τιμή της παραγγελίας με φόρο και αυτή είναι η αξία που στέλνει το ROASaurus. Οι διαφημιστικές πλατφόρμες σας αναφέρουν επομένως έσοδα με ΦΠΑ. Δείτε το αποτέλεσμα με ΦΠΑ 21%:

Ένα ROAS νεκρού σημείου χρησιμοποιεί έσοδα χωρίς ΦΠΑ. Διαιρέστε το ROAS της πλατφόρμας με το 1 συν τον συντελεστή ΦΠΑ σας πριν συγκρίνετε τα δύο.

Πώς συνδέεται μια παραγγελία Lightspeed με το κλικ στη διαφήμιση;

Για να αποδώσει μια διαφήμιση, η πλατφόρμα χρειάζεται τα αναγνωριστικά κλικ του επισκέπτη που παρήγγειλε: το click ID της Meta και το ID προγράμματος περιήγησης (fbc, fbp), το click ID του TikTok (ttclid) και το cookie του TikTok (ttp). Το script του ROASaurus τα αποθηκεύει για κάθε επισκέπτη όταν φτάνει από μια διαφήμιση. Το ROASaurus δεν λαμβάνει αυτό το ID επισκέπτη από την παραγγελία του Lightspeed, οπότε συνδέει κάθε παραγγελία με έναν επισκέπτη με άλλον τρόπο. Δοκιμάζει τρεις μεθόδους, με αυτή τη σειρά:

Το snippet περνά επίσης το σύνολο της παραγγελίας, το νόμισμα και το email του πελάτη. Το ROASaurus αποθηκεύει ένα hash αυτού του email στον επισκέπτη, κάτι που βοηθά να αντιστοιχιστεί η επόμενη παραγγελία του ίδιου αγοραστή. Το ROASaurus περιμένει λίγο πριν στείλει κάθε αγορά, ώστε το συμβάν της σελίδας ευχαριστίας να προλάβει να φτάσει πρώτο, και ξαναδοκιμάζει την αντιστοίχιση τη στιγμή της αποστολής.

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 δείχνει πώς συνδέθηκε κάθε παραγγελία, στη στήλη Matched by: thank_you, email, ip ή not matched. Μια παραγγελία που δεν έχει αντιστοιχιστεί πηγαίνει παρόλα αυτά στις διαφημιστικές πλατφόρμες σας με τα δεδομένα παραγγελίας της, αλλά χωρίς αναγνωριστικά κλικ, και η απόδοση του ROASaurus τη δείχνει ως άμεση ή άγνωστη.

Αποστολή αγορών Lightspeed στη Meta και στο TikTok

Κάθε πληρωμένη παραγγελία γίνεται ένα συμβάν server ανά συνδεδεμένη πλατφόρμα: ένα Purchase για το Conversions API της Meta και ένα CompletePayment για το Events API του TikTok, και τα δύο με ID συμβάντος order-ORD01042. Το TikTok δείχνει πλέον το CompletePayment ως Purchase στις αναφορές του. Όταν επιλέξετε την επιλογή να φορτώνεται και το pixel του προγράμματος περιήγησης, το snippet της σελίδας ευχαριστίας ενεργοποιεί τα ίδια συμβάντα στο πρόγραμμα περιήγησης με το ίδιο ID συμβάντος. Η Meta και το TikTok κρατούν τότε ένα αντίγραφο.

Οι ίδιες παραγγελίες πηγαίνουν στο Snapchat, στο Pinterest, στο Reddit, στο X, στο Microsoft Ads, στο Taboola, στο LinkedIn και στις άλλες διαφημιστικές πλατφόρμες όταν τις συνδέσετε. Οι μετατροπές αγοράς του Google Ads στέλνονται μόνο από την ολοκλήρωση αγοράς του Shopify, οπότε το ROASaurus δεν τις στέλνει από το Lightspeed. Για τη ρύθμιση από την πλευρά της Meta, δείτε τον οδηγό Meta Conversions API.

Πώς να ρυθμίσετε την παρακολούθηση μετατροπών στο Lightspeed

1. Προσθέστε το κατάστημα στο ROASaurus

   Μεταβείτε στο Add a store, διαλέξτε Lightspeed eCom και εισαγάγετε τη διεύθυνση του καταστήματός σας. Η καρτέλα Connection δείχνει τότε το script tag και το snippet της σελίδας ευχαριστίας.

2. Προσθέστε το script σε κάθε σελίδα

   Στο back office του Lightspeed, μεταβείτε στο Settings › Website Settings › Web Extras › Custom JavaScript και επικολλήστε το script tag. Το Lightspeed τρέχει αυτόν τον κώδικα σε όλες τις σελίδες.

3. Προσθέστε το snippet της σελίδας ευχαριστίας

   Στην ίδια σελίδα, στην περιοχή Tracking, ενεργοποιήστε το Status και επικολλήστε το snippet. Το Lightspeed το τρέχει στη σελίδα Thank You μετά από μια παραγγελία.

4. Δημιουργήστε ένα κλειδί API

   Μεταβείτε στο Settings › Store Settings › Developers › New API key. Ενεργοποιήστε το κλειδί, επιλέξτε πρόσβαση ανάγνωσης στις παραγγελίες, αποθηκεύστε και επιλέξτε Show για να δείτε το secret.

5. Συνδέστε το API

   Στην καρτέλα Connection, εισαγάγετε το κλειδί, το secret, την περιοχή και τη γλώσσα του καταστήματος. Αποθηκεύστε, πατήστε Test connection και μετά Create webhook.

6. Συνδέστε τις διαφημιστικές σας πλατφόρμες

   Στο Tracking & platforms, χρησιμοποιήστε το Connect with Facebook ή το Add pixel για τη Meta και το Add pixel για το TikTok με τον κωδικό pixel και ένα access token του Events API. Επιλέξτε την επιλογή να φορτώνεται και το pixel του προγράμματος περιήγησης.

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)

Συγκατάθεση

Εκτός Shopify, το script του ROASaurus διαβάζει την επιλογή του επισκέπτη από συνηθισμένα εργαλεία συγκατάθεσης: Cookiebot, OneTrust, banner IAB TCF και Google consent mode. Με άλλο banner cookies, καλέστε το tlq('consent', true) όταν ο επισκέπτης αποδέχεται cookies μάρκετινγκ και το tlq('consent', false) όταν τα απορρίπτει. Μέχρι ο επισκέπτης να αποδεχτεί, δεν έχει ID επισκέπτη ούτε click ID και δεν ενεργοποιείται κανένα pixel προγράμματος περιήγησης. Η πληρωμένη παραγγελία εξακολουθεί να στέλνεται από τον server με δεδομένα πελάτη με hash από την παραγγελία και με τη διεύθυνση IP και το πρόγραμμα περιήγησης της παραγγελίας. Η σελίδα βοήθειας για τη συγκατάθεση έχει τις λεπτομέρειες.

Πώς δοκιμάζετε την παρακολούθηση μετατροπών στο Lightspeed;

• Ανοίξτε το κατάστημά σας με το ?roasaurus=connected στη διεύθυνση. Μια ειδοποίηση επιβεβαιώνει ότι το script τρέχει. Το ?roasaurus=debug καταγράφει στην κονσόλα του προγράμματος περιήγησης τι στέλνει.
• Στο Event log, κάτω από τα Collected events, οι προβολές σελίδας θα πρέπει να δείχνουν ID επισκέπτη.
• Κάντε μια παραγγελία και βεβαιωθείτε ότι η κατάσταση πληρωμής της είναι paid. Στο Collected events, το Event log θα πρέπει τότε να δείχνει ένα Purchase με τον αριθμό της παραγγελίας σας στα δεδομένα του. Αν λείπει, ελέγξτε ότι το Status είναι ενεργό στην περιοχή Tracking.
• Στην καρτέλα Connection, το Last order received δείχνει την παραγγελία και το Last sync δείχνει τον τελευταίο έλεγχο των 5 λεπτών, με οποιοδήποτε σφάλμα από το Lightspeed.
• Κάτω από τα Server deliveries στο Event log, κάθε συνδεδεμένη πλατφόρμα έχει μια γραμμή με την κατάσταση sent και την απάντηση της πλατφόρμας.

Για να δείτε το συμβάν στη Meta, επικολλήστε τον κωδικό από το Events Manager › Test events στο πεδίο Test event code του pixel Meta σας στο ROASaurus και αφαιρέστε τον όταν τελειώσετε. Οι ρυθμίσεις pixel του TikTok στο ROASaurus έχουν το ίδιο πεδίο.

Περιορισμοί και οριακές περιπτώσεις

• Μόνο C-Series. Τα καταστήματα Lightspeed eCom E-Series δεν μπορούν να χρησιμοποιήσουν αυτόν τον connector.
• Μόνο πληρωμένες παραγγελίες. Μια μερικώς πληρωμένη παραγγελία στέλνεται όταν η κατάσταση πληρωμής της αλλάξει σε paid.
• Καθυστερημένες πληρωμές και το όριο 7 ημερών της Meta. Η Meta δέχεται συμβάντα server έως 7 ημέρες μετά την ώρα του συμβάντος. Το ROASaurus χρησιμοποιεί την ώρα δημιουργίας της παραγγελίας, οπότε μια παραγγελία που πληρώθηκε περισσότερες από 7 ημέρες αφού υποβλήθηκε απορρίπτεται από τη Meta.
• Αγορές στο πρόγραμμα περιήγησης πριν από την πληρωμή. Το snippet της σελίδας ευχαριστίας τρέχει όταν υποβάλλεται η παραγγελία, οπότε τα pixel του προγράμματος περιήγησης αναφέρουν μια παραγγελία με τραπεζική μεταφορά πριν πληρωθεί. Αν η πληρωμή έρθει περισσότερες από 48 ώρες αργότερα, η Meta και το TikTok δεν μπορούν να συγχωνεύσουν τα αντίγραφα του προγράμματος περιήγησης και του server.
• Οι ακυρώσεις και οι επιστροφές χρημάτων δεν στέλνονται. Μόλις σταλεί μια αγορά, μένει στη διαφημιστική πλατφόρμα.
• Μόνο προβολές σελίδων, χωρίς κώδικα. Οι προβολές προϊόντων και οι προσθήκες στο καλάθι ανιχνεύονται αυτόματα μόνο στο Shopify. Στο Lightspeed, ένας προγραμματιστής μπορεί να τα στείλει με μια κλήση παρακολούθησης tlq.
• Όρια API. Το Lightspeed επιτρέπει 300 αιτήματα ανά 5 λεπτά, 3,000 ανά ώρα και 12,000 ανά ημέρα για κάθε κλειδί API. Αν ένα άλλο εργαλείο χρησιμοποιεί το ίδιο κλειδί, μοιράζονται αυτά τα όρια. Το Lightspeed ζητά να επικοινωνήσετε μαζί τους για δεύτερο κλειδί.

Η σελίδα ενσωμάτωσης Lightspeed παραθέτει τα στοιχεία της σύνδεσης σε ένα σημείο και η σελίδα βοήθειας για άλλα ηλεκτρονικά καταστήματα συγκρίνει το Lightspeed με τις άλλες πλατφόρμες στις οποίες συνδέεται το ROASaurus.

Πηγές

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

Στο ROASaurus

• Ενσωμάτωση Lightspeed
• Βοήθεια: Wix, Lightspeed και άλλα ηλεκτρονικά καταστήματα
• Server-side παρακολούθηση
• Ενσωμάτωση με τη Meta

Συνεχίστε την ανάγνωση