- Η παρακολούθηση μετατροπών στο CCV Shop είναι πληρέστερη όταν κάθε πληρωμένη παραγγελία στέλνεται από τα δεδομένα παραγγελιών του CCV στον server, με ένα snippet στη σελίδα επιτυχίας της παραγγελίας που συνδέει την παραγγελία με το κλικ στη διαφήμιση.
- Ένα κλικ στο Create webhook κάνει το CCV Shop να αναφέρει κάθε παραγγελία τη στιγμή που σημειώνεται ως πληρωμένη, και κάθε παράδοση πρέπει να φέρει το ιδιωτικό token του καταστήματός σας.
- Οι παραγγελίες του CCV Shop δεν περιλαμβάνουν τη διεύθυνση IP του αγοραστή, οπότε το snippet στη σελίδα επιτυχίας της παραγγελίας έχει μεγαλύτερη σημασία στο CCV Shop από ό,τι στις περισσότερες πλατφόρμες.
- Ο έλεγχος των 5 λεπτών εξετάζει μόνο πρόσφατα δημιουργημένες παραγγελίες, οπότε οι παραγγελίες που πληρώνονται ημέρες αργότερα εξαρτώνται από το webhook: κρατήστε το ενεργό.
- Η Meta απορρίπτει συμβάντα server πάνω από 7 ημέρες μετά τη δημιουργία της παραγγελίας, οπότε μια πολύ καθυστερημένη τραπεζική μεταφορά δεν φτάνει στη Meta.
Η παρακολούθηση μετατροπών στο CCV Shop σημαίνει ότι αναφέρετε κάθε πληρωμένη παραγγελία του ηλεκτρονικού σας καταστήματος CCV Shop σε διαφημιστικές πλατφόρμες όπως η Meta και το TikTok, ώστε να αποδίδουν σωστά τις διαφημίσεις και να βελτιστοποιούν με βάση πραγματικές πωλήσεις. Ο πιο πλήρης τρόπος είναι να στέλνετε κάθε αγορά από τα δεδομένα παραγγελιών του CCV στον server και να προσθέτετε ένα σύντομο snippet στη σελίδα επιτυχίας της παραγγελίας που συνδέει την παραγγελία με το κλικ στη διαφήμιση.
Το CCV Shop είναι μια φιλοξενούμενη πλατφόρμα ηλεκτρονικών καταστημάτων της ολλανδικής εταιρείας CCV, η οποία λέει ότι τροφοδοτεί 17,000 καταστήματα. Αυτός ο οδηγός εξηγεί πώς συνδέεται το ROASaurus μαζί του, πώς συνδέονται οι παραγγελίες με τα κλικ σε διαφημίσεις, τι φτάνει στη Meta και στο TikTok, τη ρύθμιση, τη δοκιμή και πώς λειτουργούν οι καθυστερημένες πληρωμές. Για τη γενική ιδέα, διαβάστε τι είναι η server-side παρακολούθηση.
Πώς συνδέεται το ROASaurus με το CCV Shop;
Το ROASaurus χρησιμοποιεί τρία μέρη του CCV Shop, όλα περιγράφονται στην τεκμηρίωση του API του CCV:
| Μέρος του CCV Shop | Σε τι το χρησιμοποιεί το ROASaurus |
|---|---|
| REST API, με δημόσιο και μυστικό κλειδί | Διαβάζει κάθε πληρωμένη παραγγελία και τις γραμμές της |
Webhook για το συμβάν orders.updated.ispaid | Το CCV αναφέρει μια παραγγελία τη στιγμή που αλλάζει η κατάσταση πληρωμής της |
Η σελίδα επιτυχίας της παραγγελίας, με το Vertoshop.js | Το snippet διαβάζει εκεί το ID της παραγγελίας και συνδέει την παραγγελία με τον επισκέπτη |
Γιατί τα pixel του προγράμματος περιήγησης χάνουν αγορές του CCV Shop;
Ένα pixel του προγράμματος περιήγησης αναφέρει μια αγορά μόνο όταν το πρόγραμμα περιήγησης του αγοραστή φορτώνει τη σελίδα επιτυχίας της παραγγελίας και εκτελείται το script του pixel. Αρκετές συνηθισμένες καταστάσεις το χαλούν αυτό:
- Ο αγοραστής πληρώνει με ανακατεύθυνση, για παράδειγμα με iDEAL, και κλείνει την καρτέλα πριν φορτώσει η σελίδα επιτυχίας.
- Ένα ad blocker ή μια ρύθμιση απορρήτου του προγράμματος περιήγησης μπλοκάρει το script του pixel.
- Ο επισκέπτης απορρίπτει τα cookies μάρκετινγκ, οπότε το pixel δεν πρέπει να φορτώσει.
- Η παραγγελία πληρώνεται αργότερα, με τραπεζική μεταφορά ή κατά την παράδοση, όταν δεν εμπλέκεται κανένα πρόγραμμα περιήγησης.
Σε κάθε περίπτωση το CCV Shop εξακολουθεί να σημειώνει την παραγγελία ως πληρωμένη. Το ROASaurus στέλνει αυτή την παραγγελία από τον server, οπότε η αγορά αναφέρεται ό,τι και αν συνέβη στο πρόγραμμα περιήγησης. Το snippet στη σελίδα επιτυχίας έχει διαφορετική δουλειά: λέει στο ROASaurus σε ποιον επισκέπτη, και άρα σε ποιο κλικ στη διαφήμιση, ανήκει η παραγγελία.
Το webhook πληρωμένης παραγγελίας και ο έλεγχος των 5 λεπτών
Τι κάνει το Create webhook
Όταν πατάτε Create webhook, το ROASaurus καταχωρίζει ένα webhook του CCV για το συμβάν orders.updated.ispaid, το οποίο το CCV ενεργοποιεί όταν αλλάζει η ιδιότητα πληρωμής μιας παραγγελίας. Η διεύθυνση είναι το webhook URL του καταστήματός σας στο ROASaurus, που περιέχει το store key σας και ένα ιδιωτικό token. Το CCV δεν προσθέτει στο webhook τίποτα που να αναγνωρίζει το κατάστημα, και η τεκμηρίωσή του συνιστά να μπει ένα αναγνωριστικό στη διεύθυνση. Το store key το κάνει αυτό.
Το CCV δίνει σε κάθε webhook το δικό του μυστικό κλειδί 32 χαρακτήρων. Όταν το CCV επιστρέφει αυτό το κλειδί, το ROASaurus το αποθηκεύει και από τότε κάθε παράδοση πρέπει να φέρει έγκυρη κεφαλίδα x-hash. Κάθε παράδοση πρέπει επίσης να φέρει το token του καταστήματός σας. Όταν το ROASaurus λαμβάνει μια παράδοση, αγνοεί τις παραγγελίες που δεν είναι πληρωμένες, διαβάζει την πλήρη παραγγελία και τις γραμμές της από το API, και στέλνει την παραγγελία μόνο όταν το CCV λέει ότι είναι πληρωμένη.
Υπογεγραμμένες κλήσεις API
Το CCV απαιτεί να υπογράφεται κάθε κλήση API. Το ROASaurus στέλνει τρεις κεφαλίδες: x-public με το δημόσιο κλειδί σας, x-date με την τρέχουσα ώρα, και x-hash. Το CCV απορρίπτει μια χρονική σήμανση που διαφέρει πάνω από 5 λεπτά από την ώρα του server του. Το μυστικό κλειδί σας δεν στέλνεται ποτέ.
API call (ROASaurus → CCV) x-hash = HMAC-SHA512( public_key|METHOD|uri|body|timestamp , secret_key ) Webhook (CCV → ROASaurus) x-hash = HMAC-SHA512( address|payload , webhook_key )
Ο έλεγχος των 5 λεπτών
Κάθε 5 λεπτά, το ROASaurus ρωτά επίσης το CCV για πληρωμένες παραγγελίες που δημιουργήθηκαν από τον τελευταίο του έλεγχο, με 30 λεπτά επικάλυψης, και καταγράφει όσες δεν έχει ακόμη. Το CCV φιλτράρει τις παραγγελίες μόνο με βάση την ημερομηνία δημιουργίας. Έτσι ο έλεγχος βρίσκει παραγγελίες που πληρώνονται λίγο μετά την καταχώρισή τους, ενώ μια παραγγελία που πληρώνεται ημέρες αργότερα φτάνει στο ROASaurus μόνο μέσω του webhook.
Το CCV θεωρεί επιτυχία μια απάντηση 200, 201, 202 ή 204. Κρατά μια παράδοση ανοιχτή και την ξαναδοκιμάζει στην επόμενη εμφάνιση μετά από απάντηση 307, 408, 503 ή 504, και σημειώνει κάθε άλλη απάντηση ως αποτυχημένη. Περιμένει 2 δευτερόλεπτα για σύνδεση και 5 δευτερόλεπτα για την απάντηση.
Πώς συνδέεται μια παραγγελία του CCV Shop με το κλικ στη διαφήμιση;
Για να αποδώσει μια διαφήμιση, η πλατφόρμα χρειάζεται τα αναγνωριστικά κλικ του επισκέπτη που παρήγγειλε, όπως το click ID της Meta (fbc) και το click ID του TikTok (ttclid). Το script του ROASaurus τα αποθηκεύει για κάθε επισκέπτη όταν φτάνει από μια διαφήμιση. Το ROASaurus δεν παίρνει αυτό το ID επισκέπτη από την παραγγελία του CCV, οπότε συνδέει τις παραγγελίες με επισκέπτες με άλλους τρόπους:
| Μέθοδος | Στο CCV Shop | Πώς λειτουργεί |
|---|---|---|
| 1. Snippet σελίδας επιτυχίας παραγγελίας | Ναι | Διαβάζει το ID της παραγγελίας με το Vertoshop.getOrder().getId(), μαζί με το σύνολο και το νόμισμα της παραγγελίας, και ενεργοποιεί μια αγορά ROASaurus με ID συμβάντος order-58213 |
| 2. Προηγούμενο email | Ναι | Ένα email με hash που έδωσε ο επισκέπτης νωρίτερα στο site σας, σε μια φόρμα popup ή μέσω κλήσης Identify |
| 3. Διεύθυνση IP και πρόγραμμα περιήγησης | Όχι | Οι παραγγελίες του CCV Shop δεν περιλαμβάνουν τη διεύθυνση IP ή το πρόγραμμα περιήγησης του αγοραστή, οπότε αυτή η εναλλακτική δεν έχει τίποτα να συγκρίνει |
Το ROASaurus περιμένει σύντομα πριν στείλει κάθε αγορά, ώστε το συμβάν της σελίδας επιτυχίας να προλάβει να φτάσει πρώτο, και ξαναδοκιμάζει την αντιστοίχιση τη στιγμή της αποστολής. Η σελίδα Orders δείχνει το αποτέλεσμα ανά παραγγελία στη στήλη Matched by: thank_you, email ή not matched.
Μια παραγγελία που δεν αντιστοιχίζεται πηγαίνει και πάλι στις διαφημιστικές σας πλατφόρμες με δεδομένα πελάτη με hash από την παραγγελία. Δεν έχει αναγνωριστικά κλικ, και επειδή οι παραγγελίες του CCV δεν φέρουν διεύθυνση IP ή πρόγραμμα περιήγησης, δεν έχει ούτε αυτά. Αυτό μειώνει το ποσοστό των συμβάντων που η Meta μπορεί να αντιστοιχίσει σε άτομο· το Event Match Quality εξηγεί πώς η Meta βαθμολογεί αυτό. Στην απόδοση του ROASaurus, μια μη αντιστοιχισμένη παραγγελία εμφανίζεται ως άμεση ή άγνωστη.
Τι φτάνει στη Meta και στο TikTok από μια παραγγελία CCV;
| Δεδομένα παραγγελίας CCV | Αποστέλλεται ως |
|---|---|
id | Το ID συμβάντος order-58213 και το ID παραγγελίας |
total_price, currency | Αξία και νόμισμα (EUR όταν το CCV δεν δίνει νόμισμα) |
create_date | Ο χρόνος του συμβάντος |
| Email πελάτη, κινητό ή τηλέφωνο, όνομα και επώνυμο | Με hash SHA-256 |
| Πόλη, ταχυδρομικός κώδικας και κωδικός χώρας χρέωσης | Με hash SHA-256 |
| ID πελάτη | Εξωτερικό ID με hash |
| Γραμμές παραγγελίας: αριθμός προϊόντος, ID προϊόντος, ποσότητα, τιμή και όνομα | Προϊόντα με ID, ποσότητα και τιμή |
| Διεύθυνση IP και πρόγραμμα περιήγησης | Δεν υπάρχουν στις παραγγελίες του CCV: λαμβάνονται από το συμβάν της σελίδας επιτυχίας ή τον αντιστοιχισμένο επισκέπτη |
Η Meta λαμβάνει ένα Purchase μέσω του Conversions API της, και το TikTok ένα CompletePayment μέσω του Events API του, και τα δύο με ID συμβάντος order-58213. Το TikTok δείχνει πλέον το CompletePayment ως Purchase στις αναφορές του. Όταν ενεργοποιήσετε την επιλογή να φορτώνεται και το pixel του προγράμματος περιήγησης, το snippet της σελίδας επιτυχίας ενεργοποιεί τα ίδια συμβάντα στο πρόγραμμα περιήγησης με το ίδιο ID συμβάντος, και η Meta και το TikTok κρατούν ένα αντίγραφο. Οι ίδιες παραγγελίες πηγαίνουν στο Snapchat, στο Pinterest, στο Reddit, στο X, στο Microsoft Ads, στο Taboola, στο LinkedIn και στις άλλες διαφημιστικές πλατφόρμες όταν τις συνδέσετε. Οι μετατροπές αγοράς του Google Ads στέλνονται μόνο από την ολοκλήρωση αγοράς του Shopify, οπότε το ROASaurus δεν τις στέλνει από το CCV Shop.
Πώς ρυθμίζετε την παρακολούθηση μετατροπών στο CCV Shop
- Προσθέστε το κατάστημα στο ROASaurus
Πηγαίνετε στο Add a store, επιλέξτε CCV Shop και εισαγάγετε τη διεύθυνση του καταστήματός σας. Η καρτέλα Connection δείχνει τότε το script tag και το snippet της σελίδας επιτυχίας.
- Βρείτε τα κλειδιά API σας
Στο CCV Shop, πηγαίνετε στο My webshop › Settings › General › API settings και πατήστε New API key. Αν δεν το βλέπετε, εγκαταστήστε πρώτα την εφαρμογή API από το CCV App Store.
- Προσθέστε το script σε κάθε σελίδα
Επικολλήστε το script tag στο Header HTML του καταστήματός σας. Το κέντρο βοήθειας του CCV το τοποθετεί στο Mijn webshop › Instellingen › Lay-out › Layout, στο κάτω μέρος της σελίδας. Λειτουργεί και ένα μπλοκ κώδικα εφαρμογής στην κεφαλίδα.
- Προσθέστε το snippet στη σελίδα επιτυχίας
Πηγαίνετε στο Mijn webshop › Instellingen › Algemeen › Teksten, ανοίξτε το κείμενο που εμφανίζεται μετά την ολοκλήρωση μιας παραγγελίας, μεταβείτε στο Source και επικολλήστε εκεί το snippet. Το CCV Shop το εκτελεί τότε στη σελίδα επιτυχίας παραγγελίας.
- Συνδέστε το API
Στην καρτέλα Connection, εισαγάγετε το δημόσιο και το μυστικό κλειδί. Συμπληρώστε το Shop URL μόνο όταν το API σας τρέχει σε άλλο domain από το κατάστημά σας. Αποθηκεύστε, πατήστε Test connection και μετά Create webhook.
- Συνδέστε τις διαφημιστικές σας πλατφόρμες
Στο Tracking & platforms, χρησιμοποιήστε το Connect with Facebook ή το Add pixel για τη Meta, και το Add pixel για το TikTok. Ενεργοποιήστε την επιλογή να φορτώνεται και το pixel του προγράμματος περιήγησης.
Συγκατάθεση
Εκτός 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 από την παραγγελία. Η σελίδα βοήθειας για τη συγκατάθεση έχει τις λεπτομέρειες.
Πώς δοκιμάζετε την παρακολούθηση μετατροπών στο CCV Shop;
- Ανοίξτε το κατάστημά σας με το
?roasaurus=connectedστη διεύθυνση. Μια ειδοποίηση επιβεβαιώνει ότι το script τρέχει. Το?roasaurus=debugκαταγράφει στην κονσόλα του προγράμματος περιήγησης τι στέλνει. - Στο Event log, κάτω από τα Collected events, οι προβολές σελίδας θα πρέπει να δείχνουν ID επισκέπτη.
- Κάντε μια παραγγελία και πληρώστε την, ή σημειώστε την ως πληρωμένη. Κάτω από τα Collected events, το Event log θα πρέπει να δείχνει ένα Purchase με το ID παραγγελίας του CCV στα δεδομένα του. Αν λείπει, το snippet της σελίδας επιτυχίας δεν εκτελέστηκε.
- Στην καρτέλα Connection, το Last order received δείχνει την παραγγελία και το Last sync τον τελευταίο έλεγχο των 5 λεπτών, με οποιοδήποτε σφάλμα από το CCV.
- Κάτω από τα Server deliveries στο Event log, κάθε συνδεδεμένη πλατφόρμα έχει μια γραμμή με την κατάσταση sent και την απάντηση της πλατφόρμας.
PageView visitor 51c0e9a7Script σε κάθε σελίδαPurchase order-58213Snippet σελίδας επιτυχίας παραγγελίαςwebhook orders.updated.ispaidΗ υπογραφή ελέγχθηκε, η παραγγελία είναι πληρωμένηMeta Purchase sentMatched by thank_youTikTok CompletePayment sentΊδιο ID συμβάντος, χωρίς διπλοεγγραφέςΓια να δείτε το συμβάν στη Meta, επικολλήστε τον κωδικό από το Events Manager › Test events στο πεδίο Test event code του pixel Meta σας στο ROASaurus, και αφαιρέστε τον όταν τελειώσετε.
Καθυστερημένες πληρωμές και άλλα όρια
Οι τραπεζικές μεταφορές και η αντικαταβολή πληρώνονται αφού γίνει η παραγγελία. Δείτε τι συμβαίνει σε μια παραγγελία με τραπεζική μεταφορά, ως παράδειγμα, από την ημέρα που γίνεται:
| Πότε | Τι συμβαίνει | Αποτέλεσμα |
|---|---|---|
| Ημέρα 0, στην ολοκλήρωση αγοράς | Η παραγγελία δημιουργείται, δεν πληρώνεται | Δεν στέλνεται: ο έλεγχος των 5 λεπτών ζητά μόνο πληρωμένες παραγγελίες |
| Ημέρα 0, περίπου 35 λεπτά αργότερα | Ο χρόνος δημιουργίας της παραγγελίας βγαίνει από το παράθυρο του ελέγχου | Από εδώ και πέρα, μόνο το webhook μπορεί να την αναφέρει |
| Ημέρα 3 | Σημειώνετε την παραγγελία ως πληρωμένη | Το webhook φτάνει, το ROASaurus την στέλνει. Ο χρόνος συμβάντος της Ημέρας 0 είναι 3 ημερών: η Meta τη δέχεται |
| Ημέρα 9, αντίθετα | Σημειώνετε την παραγγελία ως πληρωμένη | Το webhook φτάνει, το ROASaurus την στέλνει. Οι 9 ημέρες είναι πάνω από 7: η Meta την απορρίπτει |
- Αντικαταβολή. Το ROASaurus στέλνει αυτές τις παραγγελίες όταν το CCV τις σημειώνει ως πληρωμένες, συνήθως μετά την παράδοση. Δείτε την παρακολούθηση αντικαταβολής για το πότε να μετράτε τέτοιες παραγγελίες.
- Αγορές του προγράμματος περιήγησης πριν από την πληρωμή. Το snippet της σελίδας επιτυχίας εκτελείται όταν γίνεται η παραγγελία, οπότε τα pixel του προγράμματος περιήγησης αναφέρουν μια παραγγελία τραπεζικής μεταφοράς πριν πληρωθεί. Αν η πληρωμή έρθει πάνω από 48 ώρες αργότερα, η Meta και το TikTok δεν μπορούν να συγχωνεύσουν τα αντίγραφα του προγράμματος περιήγησης και του server.
- Καμία εναλλακτική με IP. Προσθέστε το snippet της σελίδας επιτυχίας και καταγράψτε emails νωρίτερα στο site σας όπου μπορείτε.
- Οι ακυρώσεις και οι επιστροφές χρημάτων δεν στέλνονται. Μόλις σταλεί μια αγορά, μένει στη διαφημιστική πλατφόρμα.
- Μόνο προβολές σελίδας, χωρίς κώδικα. Οι προβολές προϊόντων και οι προσθήκες στο καλάθι ανιχνεύονται αυτόματα μόνο στο Shopify. Στο CCV Shop, ένας προγραμματιστής μπορεί να τα στέλνει με μια κλήση track
tlq.
Η σελίδα ενσωμάτωσης του CCV Shop παραθέτει τα στοιχεία σύνδεσης σε ένα σημείο, και η σελίδα βοήθειας για άλλα ηλεκτρονικά καταστήματα συγκρίνει το CCV Shop με τις άλλες πλατφόρμες στις οποίες συνδέεται το ROASaurus, όπως το Lightspeed.
Πηγές
- CCV Shop: API Documentatie
- CCV: Webshop API
- Meta for Developers: Server Event Parameters
- Meta for Developers: Handling Duplicate Pixel and Conversions API Events
- TikTok Ads Manager: About Event Deduplication
Στο ROASaurus
- Ενσωμάτωση CCV Shop
- Βοήθεια: Wix, Lightspeed και άλλα ηλεκτρονικά καταστήματα
- Server-side παρακολούθηση
- Ενσωμάτωση με τη Meta