- Το Meta Conversions API στέλνει συμβάντα όπως το Purchase από τον server σας, ώστε να φτάνουν στη Meta ακόμη κι όταν το pixel του προγράμματος περιήγησης είναι μπλοκαρισμένο.
- Τρέξτε το παράλληλα με το pixel και δώστε και στα δύο αντίγραφα το ίδιο όνομα συμβάντος και event_id· τότε η Meta μετρά το συμβάν μία φορά αν και τα δύο φτάσουν μέσα σε 48 ώρες.
- Τα συμβάντα ιστοτόπου χρειάζονται action_source, event_source_url και το user agent του αγοραστή· το email και το τηλέφωνο με hash, η διεύθυνση IP, το fbp και το fbc καθορίζουν πόσο καλά μπορεί να τα αντιστοιχίσει η Meta.
- Δοκιμάστε με την καρτέλα Test events στον Events Manager και μετά αφαιρέστε τον κωδικό δοκιμής, επειδή τα δοκιμαστικά συμβάντα δεν απορρίπτονται.
- Τα περισσότερα προβλήματα προέρχονται από ασύμβατα event id, από τη δική του διεύθυνση IP του server, από ένα χαμένο fbclid ή από στοιχεία επικοινωνίας που πέρασαν από hash χωρίς κανονικοποίηση.
Το Meta Conversions API (CAPI) επιτρέπει στον server σας να στέλνει συμβάντα όπως το Purchase απευθείας στη Meta. Το pixel της Meta στέλνει τα ίδια συμβάντα από το πρόγραμμα περιήγησης του αγοραστή. Το CAPI τα στέλνει από τον server σας, οπότε εξακολουθούν να φτάνουν όταν ένας ad blocker σταματά το pixel, ένα cookie έχει χαθεί ή η σελίδα ευχαριστίας δεν φορτώνει ποτέ.
Ο οδηγός αυτός καλύπτει τι περιέχει ένα συμβάν του Conversions API, πώς να το τρέχετε παράλληλα με το pixel με ένα κοινό event_id, ποιες παραμέτρους απαιτεί και ποιες συνιστά η Meta, πώς να δοκιμάζετε με το Test events και τα σφάλματα που εμφανίζονται συχνότερα.
Τι είναι το Meta Conversions API;
Το Conversions API αποτελεί μέρος του Graph API της Meta. Ο server σας στέλνει ένα αίτημα HTTPS POST στο graph.facebook.com/VERSION/PIXEL_ID/events με ένα access token και μια λίστα data με έως 1,000 συμβάντα. Κάθε συμβάν περιγράφει μία ενέργεια, όπως μια αγορά, σε τρία μέρη: τι συνέβη, ποιος το έκανε και τις λεπτομέρειες.
| Πεδίο | Τι περιέχει |
|---|---|
event_name | Η ενέργεια, για παράδειγμα Purchase, AddToCart ή InitiateCheckout |
event_time | Πότε συνέβη, ως Unix timestamp σε δευτερόλεπτα |
event_id | Ένα μοναδικό ID για αυτό το συμβάν, που χρησιμοποιείται για αφαίρεση διπλοεγγραφών σε σχέση με το pixel |
action_source | Πού συνέβη: website για αγορές στο κατάστημα |
event_source_url | Το URL της σελίδας όπου συνέβη το συμβάν |
user_data | Στοιχεία πελάτη για αντιστοίχιση: email και τηλέφωνο με hash, διεύθυνση IP, user agent, fbp, fbc |
custom_data | Λεπτομέρειες όπως τα value, currency και content_ids |
Ένα συνοπτικό συμβάν Purchase μοιάζει κάπως έτσι:
{
"data": [{
"event_name": "Purchase",
"event_time": 1792929600,
"event_id": "order-1042",
"action_source": "website",
"event_source_url": "https://yourstore.com/checkouts/thank-you",
"user_data": {
"em": ["<SHA-256 of the normalized email>"],
"ph": ["<SHA-256 of the normalized phone>"],
"client_ip_address": "203.0.113.24",
"client_user_agent": "Mozilla/5.0 (iPhone; ...)",
"fbp": "fb.1.1792928400000.1234567890",
"fbc": "fb.1.1792928400000.AbCdEf123"
},
"custom_data": { "value": 74.00, "currency": "USD" }
}]
}Τα πεδία επικοινωνίας, όπως το email και το τηλέφωνο, κανονικοποιούνται και υφίστανται hash με SHA-256 πριν φύγουν από τον server σας. Η διεύθυνση IP, το user agent, το fbp και το fbc στέλνονται ως έχουν.
Γιατί να τρέχει το Conversions API παράλληλα με το pixel;
Η Meta συνιστά να τρέχετε το Conversions API παράλληλα με το pixel και να στέλνετε τα ίδια συμβάντα και από τα δύο. Κάθε πλευρά βλέπει κάτι που δεν βλέπει η άλλη, και μαζί δίνουν στη Meta πληρέστερα δεδομένα.
- Ορίζει το cookie _fbp και αποθηκεύει το fbclid ενός κλικ σε διαφήμιση στο cookie _fbc
- Βλέπει τη σελίδα και το πρόγραμμα περιήγησης κατά τη διάρκεια της επίσκεψης
- Χάνεται όταν το πρόγραμμα περιήγησης το μπλοκάρει ή η σελίδα δεν φορτώνει
- Στέλνει την πληρωμένη παραγγελία από τα δεδομένα του καταστήματός σας
- Μπορεί να προσθέσει email, τηλέφωνο και διεύθυνση με hash από την παραγγελία
- Δεν εξαρτάται από το πρόγραμμα περιήγησης, οπότε οι ad blockers δεν το σταματούν
Το τίμημα του να τρέχουν και τα δύο είναι ότι η Meta λαμβάνει πλέον δύο αντίγραφα κάθε συμβάντος. Η επόμενη ενότητα δείχνει πώς η Meta κρατά μόνο ένα.
Πώς λειτουργεί η αφαίρεση διπλοεγγραφών με ένα event_id;
Η Meta θεωρεί ένα συμβάν του προγράμματος περιήγησης και ένα συμβάν του server το ίδιο συμβάν όταν ταιριάζουν δύο πράγματα: το όνομα του συμβάντος και το event id. Στο pixel, το ID μπαίνει στην επιλογή eventID. Στο Conversions API, η ίδια τιμή μπαίνει στο event_id.
fbq('track', 'Purchase', { value: 74.00, currency: 'USD' }, { eventID: 'order-1042' });Η Meta αφαιρεί τις διπλοεγγραφές ενός ζεύγους που ταιριάζει μόνο όταν τα δύο αντίγραφα φτάνουν μέσα σε 48 ώρες το ένα από το άλλο. Μερικοί κανόνες το κάνουν να λειτουργεί στην πράξη:
- Δημιουργήστε το ID μία φορά. Φτιάξτε το από κάτι που γνωρίζουν και οι δύο πλευρές, όπως ο αριθμός παραγγελίας, και περάστε το και στο πρόγραμμα περιήγησης και στον server. Δύο συστήματα που φτιάχνουν το καθένα το δικό τους ID δεν θα ταιριάζουν.
- Χρησιμοποιήστε μία μορφή. Τα
order-1042και1042είναι διαφορετικά ID. - Ταιριάξτε ακριβώς το όνομα του συμβάντος. Το
Purchaseκαι τοpurchaseείναι διαφορετικά συμβάντα. - Στείλτε το συμβάν του server άμεσα. Ένα συμβάν του server που φτάνει περισσότερες από 48 ώρες μετά το συμβάν του προγράμματος περιήγησης μετριέται για δεύτερη φορά.
Η Meta περιγράφει επίσης μια δεύτερη μέθοδο που ζευγαρώνει συμβάντα με βάση το fbp ή το external_id. Η Meta λέει ότι γενικά λειτουργεί μόνο όταν το συμβάν του προγράμματος περιήγησης φτάνει πριν από το συμβάν του server, γι' αυτό ένα κοινό event_id είναι η πιο αξιόπιστη επιλογή. Αν η Meta εξακολουθεί να αναφέρει περισσότερες αγορές από όσες είχε το κατάστημά σας, ο οδηγός μας για τα διπλά συμβάντα αγοράς παραθέτει τις συνηθισμένες αιτίες.
Ποιες παράμετροι είναι υποχρεωτικές και ποιες συνιστώνται;
Τα υποχρεωτικά πεδία κάνουν ένα συμβάν έγκυρο. Τα συνιστώμενα πεδία καθορίζουν πόσα από τα συμβάντα σας μπορεί η Meta να αντιστοιχίσει σε ένα άτομο, και μόνο τα συμβάντα που έχουν αντιστοιχιστεί μπορούν να χρησιμοποιηθούν για απόδοση και για τη διανομή διαφημίσεων.
| Παράμετρος | Συμβάντα ιστοτόπου | Τι να στείλετε |
|---|---|---|
event_name | Υποχρεωτικό | Ένα τυπικό συμβάν, όπως το Purchase, ή ένα όνομα προσαρμοσμένου συμβάντος |
event_time | Υποχρεωτικό | Unix time σε δευτερόλεπτα, το πολύ 7 ημέρες στο παρελθόν |
action_source | Υποχρεωτικό | website για συμβάντα στο κατάστημά σας |
event_source_url | Υποχρεωτικό | Το URL της σελίδας όπου συνέβη το συμβάν |
client_user_agent | Υποχρεωτικό | Η συμβολοσειρά του προγράμματος περιήγησης του αγοραστή, όχι αυτή του server σας |
user_data | Υποχρεωτικό | Τουλάχιστον μία παράμετρος πληροφοριών πελάτη |
event_id | Συνιστάται | Το ίδιο ID που χρησιμοποιεί το pixel, για αφαίρεση διπλοεγγραφών |
em, ph | Συνιστάται | Email και τηλέφωνο, κανονικοποιημένα και με hash SHA-256 |
client_ip_address | Συνιστάται | Η διεύθυνση IP του αγοραστή, χωρίς hash |
fbp, fbc | Συνιστάται | Τα cookies του ID προγράμματος περιήγησης και του click ID, χωρίς hash |
external_id | Συνιστάται | Το δικό σας ID πελάτη, ίδιο στα συμβάντα του προγράμματος περιήγησης και του server |
value, currency | Στέλνεται με το Purchase | Η αξία της παραγγελίας και ένας κωδικός νομίσματος τριών γραμμάτων |
Τρεις λεπτομέρειες προκαλούν τα περισσότερα προβλήματα:
- Κανονικοποιήστε πριν κάνετε hash. Η Meta περιμένει το email χωρίς κενά στην αρχή και στο τέλος και με πεζά, και τους αριθμούς τηλεφώνου ως ψηφία με τον κωδικό χώρας. Τα
Anna@Example.comκαιanna@example.comδίνουν διαφορετικά hash, και μόνο το δεύτερο μπορεί να ταιριάξει. - Μην κάνετε hash στα αναγνωριστικά του προγράμματος περιήγησης. Τα
fbp,fbc, η διεύθυνση IP και το user agent μπαίνουν ως απλές τιμές. - Κρατήστε το click ID ακριβώς όπως είναι. Η τιμή
fbcείναιfb.1., η ώρα δημιουργίας σε χιλιοστά του δευτερολέπτου, μια τελεία και τοfbclidαπό το URL της σελίδας προορισμού. Τοfbclidκάνει διάκριση πεζών και κεφαλαίων. Αποθηκεύστε το όταν φτάνει ο επισκέπτης, επειδή δεν υπάρχει πια στο URL στο checkout.
Το πόσο καλά ταιριάζουν αυτά τα πεδία είναι αυτό που μετρά η βαθμολογία Event Match Quality της Meta. Ο οδηγός μας για το Event Match Quality καλύπτει κάθε παράμετρο, τους κανόνες του hashing και τη βαθμολογία που πρέπει να στοχεύετε.
Πώς δοκιμάζετε συμβάντα με το Test events;
Ο Events Manager έχει μια καρτέλα Test events που δείχνει τα συμβάντα καθώς φτάνουν. Χρησιμοποιήστε την πριν βασιστείτε σε μια νέα ρύθμιση.
- Ανοίξτε το Test events
Στον Events Manager, επιλέξτε το dataset (pixel) σας και ανοίξτε την καρτέλα Test events. Αντιγράψτε τον δοκιμαστικό κωδικό που εμφανίζει.
- Προσθέστε τον κωδικό στα συμβάντα server σας
Στείλτε τον ως
test_event_codeστο αίτημα. Στο ROASaurus, επικολλήστε τον στο πεδίο Test event code του pixel Meta. - Κάντε μια δοκιμαστική παραγγελία
Επισκεφθείτε το κατάστημα, προσθέστε ένα προϊόν και πληρώστε, ώστε να στείλουν Purchase και το pixel και ο server.
- Συγκρίνετε τα δύο αντίγραφα
Και τα δύο αντίγραφα πρέπει να δείχνουν το ίδιο όνομα συμβάντος, event id, αξία και νόμισμα.
- Ελέγξτε τα στοιχεία πελάτη
Το συμβάν του server πρέπει να φέρει email και τηλέφωνο με hash, τη διεύθυνση IP, το user agent και το fbp, καθώς και το fbc αν η επίσκεψη ξεκίνησε από κλικ σε διαφήμιση.
- Αφαιρέστε τον κωδικό δοκιμής
Η Meta λέει ότι το πεδίο προορίζεται μόνο για δοκιμές, οπότε αφαιρέστε το πριν βασιστείτε στα συμβάντα.
Purchase browser order-1042 74.00 USDΑπό το pixelPurchase server order-1042 74.00 USDΑπό το Conversions APIevent_name + event_id matchΜετρήθηκαν ως μία αγοράem ph fbp fbc client_ip_address client_user_agentΣτοιχεία πελάτη στο συμβάν του serverΣυνηθισμένα σφάλματα του Conversions API και πώς να τα διορθώσετε
| Τι βλέπετε | Πιθανή αιτία | Διόρθωση |
|---|---|---|
| Ολόκληρο το αίτημα αποτυγχάνει και δεν επεξεργάζεται κανένα συμβάν | Ένα συμβάν στην παρτίδα έχει event_time παλαιότερο από 7 ημέρες | Στείλτε τα συμβάντα όταν συμβαίνουν. Διορθώστε ή αφαιρέστε τα παλιά συμβάντα πριν δοκιμάσετε ξανά. |
| Η Meta αναφέρει περισσότερες αγορές από όσες είχε το κατάστημά σας | Διαφορετικά event id, ένα συμβάν pixel χωρίς eventID ή μια δεύτερη εφαρμογή που στέλνει το ίδιο pixel | Χρησιμοποιήστε ένα ID και για τα δύο αντίγραφα και έναν αποστολέα server ανά pixel. |
| Χαμηλή ποιότητα αντιστοίχισης στα συμβάντα server | Ο server σας στέλνει τη δική του διεύθυνση IP και το δικό του user agent | Προωθήστε τη διεύθυνση IP και το user agent που καταγράφηκαν από το πρόγραμμα περιήγησης ή την παραγγελία του αγοραστή. |
| Λίγα συμβάντα με fbc | Το fbclid δεν αποθηκεύτηκε στη σελίδα προορισμού ή άλλαξε | Αποθηκεύστε το fbclid ακριβώς όπως φτάνει και δημιουργήστε το fbc από αυτό. |
| Το email και το τηλέφωνο δεν ταιριάζουν | Τιμές με hash χωρίς κανονικοποίηση, ή που στάλθηκαν χωρίς hash | Αφαιρέστε τα κενά και γράψτε το email με πεζά, κρατήστε τα ψηφία και τον κωδικό χώρας του τηλεφώνου και μετά κάντε hash με SHA-256. |
| Τα αιτήματα αποτυγχάνουν με σφάλμα ληγμένου token | Το access token προήλθε από σύνδεση μέσω Facebook και τα token σύνδεσης λήγουν | Συνδεθείτε ξανά ή χρησιμοποιήστε ένα token System User από το Business Manager, που μπορείτε να δημιουργήσετε χωρίς ημερομηνία λήξης. |
Μετά από λίγες ημέρες ζωντανής κίνησης, ανοίξτε την καρτέλα Diagnostics στον Events Manager. Η Meta παραθέτει εκεί ζητήματα με συστάσεις για τη διόρθωσή τους. Έπειτα συγκρίνετε την ημερήσια καταμέτρηση Purchase στον Events Manager με τις πληρωμένες παραγγελίες του καταστήματός σας για τις ίδιες ημέρες. Αν η Meta είναι σαφώς υψηλότερη, η σελίδα βοήθειάς μας για την αποφυγή διπλής καταμέτρησης παραθέτει τις ρυθμίσεις που πρέπει να ελέγξετε.
Πώς να ρυθμίσετε το Conversions API με το ROASaurus
Το ROASaurus στέλνει συμβάντα Conversions API από τα δεδομένα παραγγελιών του καταστήματός σας, οπότε δεν χρειάζεται να φτιάξετε μόνοι σας την πλευρά του server. Στο Tracking & platforms, κάντε κλικ στο Connect with Facebook και επιλέξτε τον διαφημιστικό λογαριασμό και το pixel σας, ή επικολλήστε το ID του pixel (dataset) και ένα token του Conversions API. Ο οδηγός ρύθμισης της Meta καλύπτει και τις δύο επιλογές, και η σελίδα ενσωμάτωσης της Meta παραθέτει κάθε πεδίο που στέλνεται.
- Ένα ID και στις δύο πλευρές. Τα συμβάντα του προγράμματος περιήγησης και του server μοιράζονται ένα event id. Για μια αγορά είναι το
order-ακολουθούμενο από το ID παραγγελίας. - Μια σύντομη αναμονή πριν από την αγορά. Το Purchase του server περιμένει λίγο αφού φτάσει η παραγγελία, ώστε να προλάβει να συνδεθεί πρώτα το συμβάν αγοράς του προγράμματος περιήγησης. Η διεύθυνση IP, το user agent και το URL σελίδας του φεύγουν τότε μαζί με το συμβάν του server, μαζί με τα
fbpκαιfbcπου αποθηκεύτηκαν για τον επισκέπτη. - Στοιχεία πελάτη από την παραγγελία. Το email, το τηλέφωνο, το όνομα και η διεύθυνση κανονικοποιούνται και περνούν από hash SHA-256. Το ID πελάτη του καταστήματος και το ID επισκέπτη του ROASaurus μπαίνουν με hash ως
external_id. - Τα συμβάντα που η Meta δεν μπορεί να αντιστοιχίσει παραλείπονται. Ένα συμβάν χωρίς
fbc,fbp, email, τηλέφωνο ή διεύθυνση IP δεν στέλνεται.
Το Event log δείχνει κάθε παράδοση server με το αίτημα και την απάντηση της Meta. Αν τα περιθώρια κέρδους διαφέρουν πολύ ανάμεσα στα προϊόντα, μπορείτε να στέλνετε και μια τιμή κέρδους δίπλα σε κάθε αγορά: ο οδηγός μας για το Meta value optimization για κέρδος εξηγεί πώς. Για ολόκληρη τη διαδρομή των δεδομένων από το κλικ έως την παραγγελία, δείτε τη server-side παρακολούθηση.
Πηγές
- Meta for Developers: Handling Duplicate Pixel and Conversions API Events
- Meta for Developers: Server Event Parameters
- Meta for Developers: Customer Information Parameters
- Meta for Developers: Using the API - Conversions API
- Meta for Developers: ClickID and the fbp and fbc Parameters
Στο ROASaurus
- Ενσωμάτωση με τη Meta
- Βοήθεια: σύνδεση της Meta
- Βοήθεια: αποφυγή διπλής καταμέτρησης
- Server-side παρακολούθηση