API μετατροπών

1. Γιατί στον διακομιστή;

Ένα pixel στο πρόγραμμα περιήγησης πρέπει να ξεπεράσει τρία εμπόδια προτού αναφέρει μια μετατροπή: έναν αποκλειστή διαφημίσεων, μια ρύθμιση αποτροπής παρακολούθησης και το κλείσιμο της καρτέλας από τον επισκέπτη πριν ενεργοποιηθεί το pixel. Μια κλήση από τον διακομιστή ξεπερνά και τα τρία, επειδή δεν πραγματοποιείται καθόλου στο πρόγραμμα περιήγησης.

Το MousePlayer γνωρίζει ήδη πότε επιτεύχθηκε ένας στόχος σας - αυτός είναι ο σκοπός των στόχων. Τα API μετατροπών απλώς προωθούν αυτό το γεγονός στο διαφημιστικό δίκτυο από τον διακομιστή μας.

2. Τι στέλνουμε και τι δεν στέλνουμε ποτέ

Το μόνο στοιχείο που ταυτοποιεί τον επισκέπτη σε αυτές τις κλήσεις είναι το cookie ή αναγνωριστικό κλικ που όρισε το ίδιο το δίκτυο. Τίποτα άλλο σχετικά με το πρόσωπο δεν φεύγει από τον διακομιστή μας.

Δίκτυο	Αναγνωριστικό που χρησιμοποιείται	Από πού προέρχεται
Meta	_fbp, _fbc	Cookies πρώτου μέρους που τοποθετεί το pixel Meta
LinkedIn	li_fat_id	Cookie πρώτου μέρους που τοποθετεί το LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp είναι cookie, το ttclid προέρχεται από το URL του κλικ στη διαφήμιση
Google Ads	gclid, wbraid, gbraid	Από το URL του κλικ στη διαφήμιση ή, στη συνέχεια, από το cookie _gcl_aw στο πρόγραμμα περιήγησης
Microsoft Advertising	msclkid	Από το URL του κλικ στη διαφήμιση ή από το cookie _uetmsclkid που γράφει η ετικέτα UET

Μόνο με συγκατάθεση

Κάθε μία από αυτές τις κλήσεις υπόκειται στον ίδιο έλεγχο συγκατάθεσης με την ίδια την καταγραφή. Μια συνεδρία χωρίς συγκατάθεση δεν παράγει αναφορά μετατροπής, ανεξάρτητα από τον διακόπτη στις ρυθμίσεις του έργου σας.

3. Το Google Ads έχει τρία αναγνωριστικά, όχι ένα

Αυτό εκπλήσσει, γι’ αυτό το δηλώνουμε ξεκάθαρα. Η Google χρησιμοποιεί το gclid για ένα μεμονωμένο κλικ σε διαφήμιση. Όταν η αποτροπή παρακολούθησης της Apple καθιστά αδύνατη την απόδοση ενός μεμονωμένου κλικ, η Google στέλνει wbraid ή gbraid αντί γι’ αυτό, τα οποία αντιπροσωπεύουν μια ομάδα κλικ.

Τα τρία αλληλοαποκλείονται - η Google απορρίπτει μια μετατροπή που περιέχει δύο. Στέλνουμε ακριβώς ένα και το gclid έχει προτεραιότητα όταν υπάρχουν περισσότερα από ένα, επειδή είναι το ακριβέστερο.

Υπάρχουν στο URL μόνο μία φορά

Το αναγνωριστικό εμφανίζεται στη διεύθυνση μόνο στην πρώτη σελίδα μετά το κλικ στη διαφήμιση. Η ετικέτα Google το αποθηκεύει έπειτα στο cookie _gcl_aw. Διαβάζουμε το cookie ως εφεδρική λύση - χωρίς αυτό, μια μετατροπή στην τρίτη σελίδα της επίσκεψης δεν θα έβρισκε κανένα αναγνωριστικό.

4. Ρύθμιση

Meta, LinkedIn και TikTok

Δύο πεδία για το καθένα: το ID του pixel ή του κανόνα μετατροπής και ένα token πρόσβασης που δημιουργείτε στο περιβάλλον του ίδιου του δικτύου. Και τα δύο αποθηκεύονται με κρυπτογράφηση AES-256-GCM και δεν εμφανίζονται ξανά μετά την αποθήκευση.

Το Google Ads χρειάζεται έξι

Η Google είναι η εξαίρεση και αξίζει να γνωρίζετε τον λόγο πριν ξεκινήσετε: σε αντίθεση με τα άλλα τρία, δεν εκδίδει απλό token πρόσβασης. Η πρόσβαση γίνεται μέσω OAuth με token ανανέωσης και το Ads API απαιτεί επιπλέον ένα token προγραμματιστή.

Πεδίο	Πού θα το βρείτε
ID πελάτη	Επάνω δεξιά στο Google Ads. Μόνο ψηφία, χωρίς παύλες.
ID ενέργειας μετατροπής	Στόχοι και μετατροπές και έπειτα η ενέργεια στην οποία θέλετε να καταχωρίζεται.
Token προγραμματιστή	Στον λογαριασμό υπευθύνου Google Ads, στο Κέντρο API.
ID και μυστικό πελάτη OAuth	Google Cloud Console, Διαπιστευτήρια, πελάτης OAuth τύπου «εφαρμογή υπολογιστή».
Token ανανέωσης	Το δημιουργείτε εσείς μία φορά για την εμβέλεια adwords.

Το LinkedIn έχει δύο διαδρομές και χρειάζεστε τη σύντομη

Στο Campaign Manager: Δεδομένα, Διαχείριση σημάτων, Άμεσο API, Δημιουργία token πρόσβασης. Αυτή είναι η διαδρομή για διαφημιζόμενους που στέλνουν δικά τους δεδομένα - χωρίς εφαρμογή προγραμματιστή, χωρίς έλεγχο. Το token δεν λήγει και το Campaign Manager δεν θα το εμφανίσει δεύτερη φορά, οπότε αντιγράψτε το αμέσως.

Η άλλη διαδρομή, μια εφαρμογή προγραμματιστή που ζητείται μέσω του LinkedIn Developer Portal, προορίζεται για πλατφόρμες που στέλνουν για λογαριασμό πολλών διαφημιζόμενων. Απαιτεί επαλήθευση εταιρικής σελίδας και εγκεκριμένη περίπτωση χρήσης και εδώ δεν χρειάζεστε τίποτα από αυτά.

Το Microsoft Advertising είναι το εύκολο

Μετά το Google Ads περιμένετε αντίστοιχη πολυπλοκότητα - OAuth, token προγραμματιστή, βήμα έγκρισης. Ισχύει το αντίθετο: δύο πεδία. Το ID ετικέτας UET που ήδη χρησιμοποιείτε στο πρόγραμμα περιήγησης και ένα token που αντιγράφετε από το Microsoft Advertising στην ετικέτα UET, «Χρήση Conversions API», «Αντιγραφή token». Δεν χρειάζεται καμία αίτηση.

Χρησιμοποιήστε το ίδιο ID ετικέτας με την ετικέτα του προγράμματος περιήγησής σας. Έτσι η Microsoft αναγνωρίζει το συμβάν του διακομιστή και εκείνο του προγράμματος περιήγησης ως μία μετατροπή αντί για δύο.

5. Πότε αναφέρεται μια μετατροπή

Ακριβώς μία φορά ανά στόχο και συνεδρία. Το MousePlayer αποτρέπει τις διπλές αναφορές πριν αποσταλεί η κλήση και το φορτίο δεδομένων περιέχει επιπλέον ένα ID ώστε το δίκτυο να μπορεί να κάνει δεύτερο έλεγχο στη δική του πλευρά. Ένας επισκέπτης που προσθέτει πέντε είδη στο καλάθι παράγει μία μετατροπή, όχι πέντε.

Τι θα δείτε στον διαφημιστικό λογαριασμό σας

Η μετατροπή περιέχει το όνομα του στόχου σας, την αξία και το νόμισμά του αν τα έχετε ορίσει, καθώς και την ώρα που συνέβη. Σε κανονική λειτουργία φτάνει μέσα σε ένα λεπτό.

Αν δεν φτάνει τίποτα

• Δεν υπάρχει αναγνωριστικό κλικ. Ο επισκέπτης δεν ήρθε μέσω διαφήμισης αυτού του δικτύου ή έφτασε πριν το pixel τοποθετήσει το cookie του. Δεν αποστέλλεται τίποτα - είναι αναμενόμενο, όχι σφάλμα.
• Δεν υπάρχει συγκατάθεση. Ο έλεγχος προηγήθηκε.
• Το δίκτυο δέχτηκε την κλήση αλλά απέρριψε τη μετατροπή. Η Google, το TikTok και αρκετοί άλλοι απαντούν με HTTP 200 και ένα σφάλμα στο σώμα της απόκρισης. Διαβάζουμε το σώμα, όχι μόνο την κατάσταση, και ο λόγος εμφανίζεται στο αρχείο παραδόσεων.