TikTok Events API για Shopify: ρύθμιση και αφαίρεση διπλοεγγραφών

Το TikTok Events API είναι η σύνδεση server-to-server του TikTok για δεδομένα μετατροπών. Αντί να βασίζεται μόνο στο pixel του TikTok στο πρόγραμμα περιήγησης του αγοραστή, το κατάστημά σας, ή ένα εργαλείο όπως το ROASaurus, στέλνει συμβάντα όπως αγορές απευθείας στο TikTok. Το TikTok συνιστά να τρέχετε το Events API δίπλα στο pixel και να αφαιρείτε τις διπλοεγγραφές των δύο με ένα κοινό event_id.

Ο οδηγός αυτός καλύπτει τι στέλνει το Events API από ένα κατάστημα Shopify, τα ονόματα συμβάντων Purchase και CompletePayment, το click ID και το cookie στα οποία βασίζεται η αντιστοίχιση του TikTok, πώς λειτουργεί η αφαίρεση διπλοεγγραφών, πώς δοκιμάζετε στο TikTok Events Manager και πώς τα ρυθμίζετε όλα στο ROASaurus.

Τι είναι το TikTok Events API;

Το pixel του TikTok είναι ένα script στο κατάστημά σας. Ενεργοποιεί συμβάντα από το πρόγραμμα περιήγησης του αγοραστή, οπότε μετρά μόνο ό,τι συμβαίνει όσο φορτώνει και τρέχει το script. Ένα ad blocker, ένα σφάλμα script ή ένας αγοραστής που κλείνει την καρτέλα πριν φορτώσει η επιβεβαίωση παραγγελίας μπορούν όλα να το σταματήσουν.

Το Events API στέλνει το ίδιο είδος συμβάντος από έναν server. Στο Shopify, η πιο αξιόπιστη καταγραφή μιας αγοράς είναι η ίδια η παραγγελία. Το Shopify αναφέρει κάθε πληρωμένη παραγγελία μέσω webhook, είτε έτρεξε το script του προγράμματος περιήγησης είτε όχι. Αυτή είναι η ιδέα πίσω από την server-side παρακολούθηση στο Shopify.

Τα δύο δεν είναι εναλλακτικές. Η συμβουλή του TikTok είναι να στέλνετε συμβάντα και από τα δύο, να τα διατηρείτε συνεπή σε όλη τη διαδρομή αγοράς και να αφήνετε το TikTok να αφαιρεί τις διπλοεγγραφές.

Ποια συμβάντα στέλνει το ROASaurus στο TikTok;

Τέσσερις στιγμές σε ένα κατάστημα Shopify μετράνε για τη βελτιστοποίηση του TikTok: μια προβολή προϊόντος, μια προσθήκη στο καλάθι, η έναρξη της ολοκλήρωσης αγοράς και η αγορά. Το ROASaurus στέλνει και τα τέσσερα στο Events API και ενεργοποιεί τα ίδια τέσσερα μέσω του pixel του TikTok, με τα ίδια ID συμβάντων. Οι προβολές σελίδων περνούν μόνο μέσω του pixel.

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

Purchase ή CompletePayment;

Το TikTok μετονόμασε το συμβάν αγοράς του. Το τρέχον όνομα είναι Purchase. Το παλιό όνομα, CompletePayment, εξακολουθεί να λειτουργεί: το TikTok μετατρέπει τα παλαιά ονόματα από τη δική του πλευρά, τα εμφανίζει με το νέο όνομα στις αναφορές, στα κοινά και στη βελτιστοποίηση και λέει ότι το CompletePayment θα υποστηρίζεται επ' αόριστον. Το TikTok ζητά από τις νέες ρυθμίσεις pixel να χρησιμοποιούν το Purchase.

Το ROASaurus στέλνει CompletePayment, τόσο στο pixel όσο και στο Events API. Στο TikTok Events Manager και στον Ads Manager, αυτά τα συμβάντα εμφανίζονται ως Purchase. Για την αφαίρεση διπλοεγγραφών, μετράει ότι και τα δύο αντίγραφα μιας αγοράς χρησιμοποιούν το ίδιο όνομα συμβάντος, και το χρησιμοποιούν.

Πώς αντιστοιχίζει το TikTok ένα συμβάν με έναν αγοραστή;

Ένα συμβάν βοηθά τις καμπάνιες σας μόνο αν το TikTok μπορεί να το συνδέσει με το άτομο που είδε ή πάτησε τη διαφήμιση. Το TikTok ονομάζει αυτά τα αναγνωριστικά κλειδιά αντιστοίχισης (match keys) και ο οδηγός του Events API ζητά να στέλνετε πίσω όλα τα σχετικά match keys για να αυξηθούν τα ποσοστά αντιστοίχισης. Ο Events Manager δείχνει το αποτέλεσμα ως βαθμολογία Event Match Quality, έναν σταθμισμένο μέσο όρο της συχνότητας με την οποία υπάρχει κάθε match key.

Το TikTok σημειώνει ότι το pixel μοιράζεται τη διεύθυνση IP και το user agent από προεπιλογή, αλλά το Events API χρειάζεται να προστεθούν με το χέρι. Το ROASaurus τα παίρνει από τη συνεδρία checkout του αγοραστή ή από την παραγγελία αν δεν υπήρχε συνεδρία. Δύο άλλα κλειδιά θέλουν προσοχή στο Shopify.

ttclid: το click ID του TikTok

Όταν ένας αγοραστής πατά μια διαφήμιση στο TikTok, το TikTok προσθέτει το ttclid στο URL της σελίδας προορισμού. Αν το κατάστημά σας δεν το αποθηκεύσει σε εκείνη την πρώτη σελίδα, έχει χαθεί μέχρι να φτάσει η παραγγελία, αρκετές σελίδες αργότερα. Το ROASaurus διαβάζει το ttclid στη σελίδα προορισμού, το αποθηκεύει μαζί με το ID επισκέπτη, το γράφει στο καλάθι του Shopify και το προσθέτει στο server-side συμβάν όταν έρθει η παραγγελία.

_ttp: το cookie του pixel

Το cookie _ttp είναι ένα first-party cookie που χρησιμοποιεί το pixel του TikTok στο domain σας. Το ROASaurus το διαβάζει στο storefront και στο checkout και το στέλνει ως ttp στο server-side συμβάν. Είναι ένας ακόμη λόγος να κρατάτε το pixel ενεργό δίπλα στο Events API.

{
  "event_source": "web",
  "event_source_id": "CXXXXXXXXXXXXXXXXXXX",
  "data": [{
    "event": "CompletePayment",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "user": {
      "email": "a3f1…9c2e",
      "phone": "7b40…11d8",
      "external_id": "e05c…4a7f",
      "ttclid": "E.C.P.v3…",
      "ttp": "2Xb7…",
      "ip": "203.0.113.24",
      "user_agent": "Mozilla/5.0 (iPhone; …)"
    },
    "page": { "url": "https://example-store.com/checkouts/…/thank-you" },
    "properties": {
      "currency": "USD",
      "value": 84,
      "content_type": "product",
      "contents": [{ "content_id": "44123456789", "content_name": "Linen shirt", "quantity": 2, "price": 42 }],
      "order_id": "5512345678901"
    }
  }]
}

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

Όταν το pixel και το Events API αναφέρουν και τα δύο την ίδια αγορά, το TikTok λαμβάνει δύο συμβάντα για μία παραγγελία. Για να κρατήσει μόνο ένα, το TikTok χρειάζεται δύο τιμές να είναι ίδιες και στα δύο αντίγραφα: το όνομα του συμβάντος και το event_id. Το TikTok καταγράφει τότε το πρώτο αντίγραφο που λαμβάνει για μέτρηση και αναφορές, οπότε η παραγγελία μετράει μία φορά. Αυτό λειτουργεί για αντίγραφα που ταιριάζουν και φτάνουν μέσα σε παράθυρο 48 ωρών από το πρώτο.

Το ROASaurus δημιουργεί το ID συμβάντος μιας αγοράς από το ID παραγγελίας του Shopify. Η αγορά από την παραγγελία 5512345678901 έχει ID συμβάντος order-5512345678901, στο pixel ολοκλήρωσης αγοράς και στον server. Τα συμβάντα του storefront, όπως οι προβολές προϊόντων και οι προσθήκες στο καλάθι, παίρνουν ένα τυχαίο ID όταν συμβαίνουν και το αντίγραφο του προγράμματος περιήγησης και το αντίγραφο του server το μοιράζονται.

Να τι σημαίνει αυτό για τα νούμερα. Πάρτε ένα κατάστημα-παράδειγμα με 200 παραγγελίες την εβδομάδα. Το pixel ενεργοποιείται για τις 150. Οι άλλοι 50 αγοραστές χρησιμοποίησαν ad blocker, απέρριψαν τα cookies μάρκετινγκ ή έφυγαν πριν φορτώσει η σελίδα επιβεβαίωσης. Το Events API στέλνει και τις 200.

Το 350 είναι ο αριθμός που πρέπει να σας ανησυχεί. Θα έκανε τον αριθμό αγορών του TikTok, και το ROAS που βασίζεται σε αυτόν, 75% υψηλότερο από την πραγματικότητα, επειδή 350 ÷ 200 = 1.75. Το TikTok χρησιμοποιεί αυτά τα συμβάντα και για βελτιστοποίηση και στόχευση, οπότε η προσφορά του θα μάθαινε από 150 αγορές που δεν έγιναν.

Γιατί οι αγορές μετριούνται δύο φορές στο Shopify;

Η διπλομέτρηση συμβαίνει όταν το TikTok λαμβάνει δύο αντίγραφα μιας αγοράς που δεν μπορεί να αντιστοιχίσει. Ελέγξτε αυτές τις αιτίες πριν εμπιστευτείτε μια απότομη αύξηση των αγορών στο TikTok:

• Δύο εργαλεία στέλνουν το ίδιο pixel. Η εφαρμογή καναλιού πωλήσεων TikTok στο Shopify μπορεί επίσης να στέλνει συμβάντα για το pixel σας. Τα ID συμβάντων της δεν ταιριάζουν με τα ID που χρησιμοποιεί το ROASaurus, οπότε το TikTok μετρά κάθε παραγγελία δύο φορές. Αποσυνδέστε το pixel σε εκείνη την εφαρμογή.
• Το pixel υπάρχει και στον κώδικα του θέματός σας. Ένα snippet pixel που έχει επικολληθεί στο θέμα ενεργοποιεί δικά του συμβάντα χωρίς τα ID συμβάντων σας. Αφαιρέστε το και αφήστε ένα εργαλείο να φορτώνει το pixel.
• Η μία πλευρά δεν έχει event_id. Μια αγορά από τον server χωρίς event_id, ή με νέο τυχαίο ID, δεν μπορεί να αντιστοιχιστεί με το αντίγραφο του pixel.
• Τα ονόματα των συμβάντων διαφέρουν. Το TikTok αφαιρεί διπλοεγγραφές μόνο για πανομοιότυπα συμβάντα. Και τα δύο αντίγραφα μιας αγοράς πρέπει να χρησιμοποιούν το ίδιο όνομα συμβάντος.

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

Πώς δοκιμάζετε το Events API στο TikTok Events Manager;

Το TikTok Events Manager έχει μια καρτέλα Test events για συμβάντα του προγράμματος περιήγησης και του server. Χρησιμοποιήστε την πριν βασιστείτε στα δεδομένα:

1. Αντιγράψτε έναν κωδικό test event

   Στο TikTok Events Manager, ανοίξτε το pixel σας και πηγαίνετε στο Test events. Αντιγράψτε τον κωδικό test event.

2. Επικολλήστε τον στο ROASaurus

   Ανοίξτε το Tracking & platforms, επεξεργαστείτε το pixel του TikTok και επικολλήστε τον κωδικό στο πεδίο Test event code. Τα server-side συμβάντα τον φέρουν πλέον.

3. Κάντε μια δοκιμαστική παραγγελία

   Επισκεφθείτε το κατάστημά σας, δείτε ένα προϊόν, προσθέστε το στο καλάθι και ολοκληρώστε μια παραγγελία.

4. Ελέγξτε και τις δύο πλευρές

   Στο Test events, φιλτράρετε ανά συμβάντα του προγράμματος περιήγησης και του server. Πρέπει να δείτε την αγορά και από τις δύο. Στο ROASaurus, το Event log δείχνει κάθε παράδοση server ως απεσταλμένη ή αποτυχημένη.

5. Αφαιρέστε τον κωδικό δοκιμής

   Διαγράψτε τον κωδικό test event όταν τελειώσετε, ώστε τα ζωντανά server-side συμβάντα σας να μη στέλνονται πια ως συμβάντα δοκιμής.

Το TikTok μπορεί να απαντήσει σε ένα αίτημα με HTTP 200 και να απορρίψει παρ' όλα αυτά το συμβάν, με έναν κωδικό σφάλματος στο σώμα της απάντησης. Το ROASaurus διαβάζει αυτόν τον κωδικό, οπότε ένα συμβάν που απορρίφθηκε εμφανίζεται ως αποτυχημένο στο Event log αντί να περνά σιωπηλά.

Μετά από μία ημέρα ζωντανής επισκεψιμότητας, ανοίξτε την επισκόπηση του pixel στον Events Manager. Παραθέτει κάθε συμβάν με τη μέθοδο σύνδεσής του, τη βαθμολογία Event Match Quality και πότε λήφθηκε τελευταία φορά. Οι λεπτομέρειες του συμβάντος περιλαμβάνουν πληροφορίες αντιστοίχισης και αφαίρεσης διπλοεγγραφών και το Diagnostics παραθέτει ζητήματα ποιότητας με οδηγίες για τη διόρθωσή τους.

Πώς θα ρυθμίσετε το TikTok Events API στο Shopify με το ROASaurus

Χρειάζεστε ένα κατάστημα Shopify με την εφαρμογή ROASaurus και πρόσβαση στο TikTok Events Manager. Η σελίδα ενσωμάτωσης του TikTok παραθέτει κάθε πεδίο που στέλνει το ROASaurus.

1. Συνδέστε το κατάστημά σας στο Shopify

   Μεταβείτε στο Add a store › Shopify, κάντε κλικ στο Install app και ενεργοποιήστε το app embed του ROASaurus στον επεξεργαστή θέματος. Το embed καταγράφει το ttclid και το cookie _ttp σε κάθε σελίδα. Ο οδηγός ρύθμισης για το Shopify δείχνει κάθε βήμα.

2. Προσθέστε το pixel ολοκλήρωσης αγοράς

   Στο Shopify admin › Settings › Customer events, προσθέστε ένα custom pixel με όνομα ROASaurus και επικολλήστε το snippet από τη σελίδα Tracking & platforms. Ενεργοποιεί το pixel του TikTok στο checkout, συμπεριλαμβανομένου του αντιγράφου της αγοράς από το πρόγραμμα περιήγησης.

3. Δημιουργήστε ένα access token

   Στο TikTok Events Manager, ανοίξτε το pixel σας και δημιουργήστε ένα access token του Events API στις ρυθμίσεις του. Αντιγράψτε το token και τον κωδικό του pixel.

4. Προσθέστε το pixel του TikTok στο ROASaurus

   Μεταβείτε στο Tracking & platforms, κάντε κλικ στο Add pixel στην κάρτα του TikTok και συμπληρώστε τα Pixel code και Events API access token. Αφήστε επιλεγμένο το Also load the browser pixel (recommended, deduplicated), ώστε τα συμβάντα του προγράμματος περιήγησης και του server να μοιράζονται ID.

5. Προσθέστε δαπάνη (προαιρετικό)

   Συμπληρώστε τα Advertiser ID for spend και Marketing API token. Το ROASaurus εισάγει τότε τη δαπάνη του TikTok, ώστε οι καμπάνιες του TikTok να δείχνουν ROAS και CPA δίπλα στα άλλα κανάλια σας.

6. Δοκιμάστε και μετά ξεκινήστε

   Στείλτε μια δοκιμαστική παραγγελία με κωδικό test event όπως περιγράφεται παραπάνω και μετά αφαιρέστε τον κωδικό.

Με το Respect visitor consent ενεργό, που είναι η προεπιλογή, το ROASaurus ακολουθεί την επιλογή του αγοραστή στο banner cookies του Shopify. Όταν ένας αγοραστής απορρίπτει τα cookies μάρκετινγκ, το ROASaurus δεν φορτώνει το pixel του TikTok γι' αυτόν, δεν ορίζει ID επισκέπτη, ώστε τα κλικ του να μη συνδέονται μαζί του, και δεν στέλνει τα συμβάντα περιήγησής του στο TikTok. Η πληρωμένη παραγγελία του στέλνεται παρ' όλα αυτά στο Events API από τον server, με δεδομένα παραγγελίας με hash και με τη διεύθυνση IP και το user agent της παραγγελίας, αλλά χωρίς ttclid ή _ttp. Ο οδηγός συγκατάθεσης και απορρήτου εξηγεί τι αποθηκεύεται και τι στέλνεται.

Με τη δαπάνη συγχρονισμένη, οι καμπάνιες του TikTok εμφανίζονται στις αναφορές απόδοσης δίπλα στη Meta και η ανάλυση creative προσθέτει τα στατιστικά βίντεο του TikTok ανά διαφήμιση. Το ROASaurus αποδίδει τις παραγγελίες στα κλικ σε διαφημίσεις και στα UTM που κατέγραψε και μετρά μετατροπές view-through μόνο ως μοντελοποιημένη εκτίμηση στο μοντέλο Clicks & views, οπότε τα σύνολά του συνήθως διαφέρουν από τον TikTok Ads Manager. Για τις άλλες server-side πλατφόρμες, δείτε τον οδηγό για το Pinterest Conversions API και τον οδηγό για το Meta Conversions API.

Πηγές

1. TikTok For Business: About Events API
2. TikTok Ads Manager: About Event Deduplication
3. TikTok Ads Manager: How to Adopt TikTok's Updated Standard Events
4. TikTok Ads Manager: How to set up matching events with Events API
5. TikTok Ads Manager: About diagnostic and monitoring tools in TikTok Events Manager

Στο ROASaurus

• Ενσωμάτωση TikTok
• Server-side παρακολούθηση στο ROASaurus
• Βοήθεια: αποφυγή διπλής καταμέτρησης
• Βοήθεια: ρύθμιση του ROASaurus στο Shopify

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