Pinterest Conversions API για Shopify: οδηγός ρύθμισης

Το Pinterest Conversions API είναι ο τρόπος της Pinterest για να στέλνετε συμβάντα μετατροπής από server σε server. Το κατάστημά σας, ή ένα εργαλείο όπως το ROASaurus, στέλνει συμβάντα όπως αγορές απευθείας στον διαφημιστικό σας λογαριασμό στην Pinterest, αντί να βασίζεται μόνο στο Pinterest Tag στο πρόγραμμα περιήγησης του αγοραστή. Η Pinterest χρησιμοποιεί τα δεδομένα για αναφορές μετατροπών, βελτιστοποίηση καμπανιών και στόχευση.

Ο οδηγός αυτός καλύπτει το API v5 και τα συμβάντα που δέχεται, το click ID epik, πώς γίνεται hash στα δεδομένα πελάτη, πώς λειτουργεί η αφαίρεση διπλοεγγραφών με το Pinterest Tag, πώς γίνεται η δοκιμή και πώς τα ρυθμίζετε όλα στο Shopify.

Τι είναι το Pinterest Conversions API;

Το Pinterest Tag είναι ένα script στο πρόγραμμα περιήγησης του αγοραστή. Το Conversions API κάνει την ίδια δουλειά από έναν server. Στην έκδοση 5 του API, στέλνετε συμβάντα στο endpoint συμβάντων του διαφημιστικού σας λογαριασμού, με εξουσιοδότηση μέσω ενός token πρόσβασης μετατροπών που δημιουργείτε στον Pinterest Ads Manager. Κάθε συμβάν δηλώνει πού συνέβη: για ένα ηλεκτρονικό κατάστημα, η πηγή ενέργειας (action source) είναι web.

Η Pinterest ζητά από τους διαφημιστές που χρησιμοποιούν και το Tag να αποφεύγουν να μετρούν μια μετατροπή δύο φορές, περνώντας ένα event_id με κάθε συμβάν. Ζητά επίσης τα συμβάντα σε πραγματικό χρόνο, ή το πολύ μία ώρα μετά τη στιγμή που συμβαίνουν.

Στο Shopify, μια σύνδεση server έχει ένα σαφές πλεονέκτημα: οι αγορές προέρχονται από την ίδια την παραγγελία. Το Shopify αναφέρει κάθε πληρωμένη παραγγελία στο ROASaurus μέσω webhook και το ROASaurus την στέλνει στην Pinterest λίγο μετά την πληρωμή, είτε ενεργοποιήθηκε το Tag στο πρόγραμμα περιήγησης είτε όχι. Ο οδηγός για την server-side παρακολούθηση στο Shopify εξηγεί την ιδέα σε μεγαλύτερο βάθος.

Ποια συμβάντα δέχεται το Pinterest Conversions API;

Η Pinterest έχει μια σταθερή λίστα τυπικών ονομάτων συμβάντων, γραμμένα με πεζά και κάτω παύλες, όπως page_visit, add_to_cart και checkout. Μπορείτε επίσης να ορίσετε έως 15 προσαρμοσμένους τύπους συμβάντων ανά διαφημιστή. Το ROASaurus αντιστοιχίζει τα πέντε συμβάντα αγορών του Shopify ως εξής:

Το όνομα μπορεί να μπερδέψει. Το checkout της Pinterest είναι η ολοκληρωμένη αγορά, όχι η έναρξη της ολοκλήρωσης αγοράς. Η έναρξη της ολοκλήρωσης αγοράς είναι ξεχωριστό συμβάν, το initiate_checkout.

Για το συμβάν checkout, η Pinterest συνιστά να στέλνονται η αξία, το νόμισμα, το ID παραγγελίας, τα content ID και ο αριθμός των προϊόντων. Το ROASaurus στέλνει και τα πέντε, μαζί με την ποσότητα και την τιμή κάθε προϊόντος. Η Pinterest ζητά την αξία πριν από τον φόρο και τα μεταφορικά. Στο Shopify, το ROASaurus στέλνει ακριβώς αυτό: το σύνολο της παραγγελίας μείον φόρο και μεταφορικά, από τον server και από το tag του προγράμματος περιήγησης. Όταν μια πλατφόρμα ηλεκτρονικού καταστήματος δεν αναφέρει ξεχωριστά τον φόρο και τα μεταφορικά, το ROASaurus στέλνει το σύνολο της παραγγελίας.

Πώς αντιστοιχίζει η Pinterest ένα συμβάν με ένα άτομο;

Κάθε συμβάν φέρει δεδομένα χρήστη. Η Pinterest απαιτεί τουλάχιστον ένα από τρία πράγματα: μια διεύθυνση email με hash, ένα διαφημιστικό αναγνωριστικό κινητού με hash ή τη διεύθυνση IP μαζί με το user agent. Ένα ηλεκτρονικό κατάστημα δεν έχει διαφημιστικό αναγνωριστικό, οπότε χρειάζεται το email ή τη διεύθυνση IP και το user agent. Το ROASaurus παραλείπει ένα συμβάν που δεν έχει κανένα από τα δύο, αντί να στείλει ένα που η Pinterest δεν μπορεί να χρησιμοποιήσει.

Το click ID epik

Το click ID της Pinterest μπορεί να προέρχεται από δύο σημεία: μια παράμετρο epik στο URL της σελίδας προορισμού ή το cookie _epik στο domain σας. Ο οδηγός API της Pinterest συνιστά να περνάτε την τιμή του cookie _epik, επειδή λειτουργεί ακόμη και όταν η παράμετρος του URL λείπει ή έχει αφαιρεθεί, κάτι που δίνει καλύτερη κάλυψη.

Το ROASaurus διαβάζει και τα δύο στο storefront σας, χρησιμοποιώντας την παράμετρο του URL όταν ένα νέο κλικ φέρνει μία και το cookie διαφορετικά. Αποθηκεύει το click ID μαζί με τον επισκέπτη και το στέλνει στο πεδίο click_id κάθε server-side συμβάντος, συμπεριλαμβανομένης της αγοράς. Οι επισκέψεις με epik μετράνε ως επισκέψεις από την Pinterest στις αναφορές απόδοσης του ROASaurus.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

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

Αν το Tag και το API αναφέρουν και τα δύο μια αγορά, η Pinterest λαμβάνει δύο συμβάντα για μία παραγγελία. Για να τα αντιμετωπίσει ως ένα, χρειάζεται το ίδιο ID και στις δύο πλευρές: το ID συμβάντος στο Tag πρέπει να ταιριάζει με το event_id στο server-side συμβάν. Η Pinterest κρατά το πρώτο συμβάν που λαμβάνει και αφαιρεί τα διπλά που φτάνουν μέσα σε 48 ώρες.

Το ROASaurus δημιουργεί το ID αγοράς από το ID παραγγελίας του Shopify. Η αγορά από την παραγγελία 5512345678901 έχει ID συμβάντος order-5512345678901, τόσο στο Tag που ενεργοποιείται στο checkout όσο και στο server-side συμβάν.

Και τα πέντε συμβάντα υφίστανται αφαίρεση διπλοεγγραφών

Κάθε συμβάν της διαδικασίας αγοράς στο ROASaurus έχει ένα ID συμβάντος, που χρησιμοποιείται από το Tag στο πρόγραμμα περιήγησης και από το συμβάν του server. Το Tag χρησιμοποιεί τα ονόματα της ίδιας της Pinterest για τα ίδια συμβάντα: pagevisit, viewcontent, addtocart, initiatecheckout και checkout, τα οποία αντιστοιχούν στα page_visit, view_content, add_to_cart, initiate_checkout και checkout στο API. Έτσι, όταν τρέχουν και τα δύο, η Pinterest κρατά ένα αντίγραφο από κάθε επίσκεψη σελίδας, προβολή προϊόντος, προσθήκη στο καλάθι, έναρξη checkout και αγορά.

Μπορείτε να το τρέξετε με δύο τρόπους:

• Tag και Conversions API μαζί. Το Tag προσθέτει σήματα του προγράμματος περιήγησης, ο server συμπληρώνει όσα χάνει το Tag και η Pinterest συγχωνεύει τα αντίγραφα.
• Τρέξτε το API χωρίς το Tag. Αφήστε κενό το Tag ID ή απενεργοποιήστε το Also load the browser tag. Κάθε συμβάν στέλνεται τότε μία φορά, μόνο από τον server.

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

Πώς δοκιμάζετε το Pinterest Conversions API;

Το API έχει μια σημαία δοκιμής. Τα αιτήματα που στέλνονται με test=true πηγαίνουν σε sandbox: η Pinterest τα χειρίζεται ως δεδομένα δοκιμής και δεν τα χρησιμοποιεί για αναφορές ή βελτιστοποίηση.

1. Ενεργοποιήστε το test mode

   Στο ROASaurus, επεξεργαστείτε το pixel της Pinterest στο Tracking & platforms και επιλέξτε το Test mode (events show under Test events, max 20). Κάθε server-side συμβάν στέλνεται τότε με test=true. Η Pinterest επεξεργάζεται το πολύ 20 συμβάντα δοκιμής ανά παρτίδα.

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

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

3. Διαβάστε το αποτέλεσμα

   Ανοίξτε το Event log. Η Pinterest μπορεί να απαντήσει με HTTP 200 ενώ ένα συμβάν του αιτήματος απέτυχε, οπότε το ROASaurus ελέγχει την κατάσταση κάθε συμβάντος και εμφανίζει εκεί τις αποτυχίες.

4. Απενεργοποιήστε το test mode

   Αποεπιλέξτε το test mode, ώστε τα συμβάντα να μετράνε στις αναφορές και τη βελτιστοποίηση.

5. Ελέγξτε το Events Overview

   Στον Pinterest Ads Manager, ανοίξτε τη σελίδα Events Overview. Δείχνει τα συμβάντα που φτάνουν και τις μετατροπές μετά την αφαίρεση διπλοεγγραφών. Η Pinterest συνιστά να στοχεύετε σε Good Event Quality Score.

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

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

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

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

2. Δημιουργήστε ένα token πρόσβασης μετατροπών

   Στον Pinterest Ads Manager, μεταβείτε στο Conversions και δημιουργήστε ένα token πρόσβασης μετατροπών (conversion access token). Σημειώστε το ID του διαφημιστικού σας λογαριασμού.

3. Προσθέστε το pixel της Pinterest στο ROASaurus

   Μεταβείτε στο Tracking & platforms, κάντε κλικ στο Add pixel στην κάρτα της Pinterest και συμπληρώστε τα Ad account ID και Conversion access token.

4. Προσθέστε το Tag ID σας

   Για την αφαίρεση διπλοεγγραφών με το Tag, συμπληρώστε το Pinterest Tag ID και αφήστε επιλεγμένο το Also load the browser tag. Χωρίς Tag ID, το ROASaurus στέλνει μόνο server-side συμβάντα και δεν φορτώνει το Tag.

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

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

6. Επιλέξτε server-side συμβάντα και δοκιμάστε

   Διαλέξτε τα server-side συμβάντα που θέλετε και δοκιμάστε με test mode πριν ξεκινήσετε.

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

Συνδέστε τον διαφημιστικό σας λογαριασμό Pinterest στο Setup › Ad spend και το ROASaurus αντλεί τη δαπάνη καμπανιών κάθε ώρα, ώστε να βλέπετε το ROAS της Pinterest και το κέρδος μετά τις διαφημίσεις στην ανάλυση κέρδους. Ο οδηγός για το TikTok Events API καλύπτει την ίδια ρύθμιση για το TikTok, όπου αφαιρούνται οι διπλοεγγραφές για κάθε συμβάν που στέλνεται και από τις δύο διαδρομές.

Πηγές

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

Στο ROASaurus

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

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