Η Εισαγωγή μετατροπής εκτός σύνδεσης (OCI) παρακολουθεί τις μετατροπές εκτός σύνδεσης από εισαγωγές, χρησιμοποιώντας την παράμετρο GCLID. Σε σενάρια όπου η παράμετρος GCLID δεν είναι διαθέσιμη, οι χρήστες της OCI μπορούν να βασίζονται σε άλλα αναγνωριστικά, όπως κατακερματισμένα δεδομένα που παρέχονται από τους χρήστες, wbraid/gbraid ή session_attributes.
Σε αυτή τη σελίδα
- Σχετικά με το αναγνωριστικό session_attributes
- Πώς να καταγράψετε το αναγνωριστικό session_attributes
- Πώς να στείλετε τα δεδομένα στο Google Ads
Σχετικά με το αναγνωριστικό session_attributes
Το session_attributes είναι ένα πεδίο που παρέχει περαιτέρω ευρύτερο πλαίσιο και χαρακτηριστικά ταυτοποίησης σχετικά με την αλληλεπίδραση του χρήστη με τον ιστότοπό σας, τα οποία μπορούν να βελτιώσουν την παρακολούθηση μετατροπών, τη δημιουργία αναφορών (συμπεριλαμβανομένης της ανάλυσης ίδιας/διαφορετικής συσκευής) και την ακρίβεια υποβολής προσφορών. Μπορείτε να χρησιμοποιήσετε το παρακάτω σενάριο διεπαφής, για να δημιουργήσετε τη συμβολοσειρά με κωδικοποίηση base64 του αναγνωριστικού session_attributes, να τη διαβιβάσετε στη βάση δεδομένων/στο CRM και να τη στείλετε στην Google στο πλαίσιο των εισαγωγών API. Αν δεν μπορείτε να χρησιμοποιήσετε το σενάριο διεπαφής, χρησιμοποιήστε το πεδίο session_attributes_key_value_pairs, για να στείλετε κάθε ζεύγος κλειδιού/τιμής μεμονωμένα.
Προτείνουμε να στείλετε όλα τα δευτερεύοντα πεδία, αλλά μπορείτε να επιλέξετε να στείλετε όσα από αυτά θέλετε. Όλα τα δευτερεύοντα πεδία είναι προαιρετικά. Το προτεινόμενο μέγεθος αποθηκευτικού χώρου για το πεδίο session_attributes είναι 5 KB. Στην πλειοψηφία των περιπτώσεων χρήσης δεν θα σημειώνεται υπέρβαση αυτού του μεγέθους. Αν το πεδίο session_attributes είναι μεγαλύτερο, συνεργαστείτε με τον πάροχο CRM για να τροποποιήσετε το μέγεθος του πεδίου (συνιστάται ανεπιφύλακτα) ή καταργήστε τις παραμέτρους landing_page_url και landing_page_referrer από τη λειτουργία βοήθειας JavaScript.
Ακολουθούν τα δευτερεύοντα πεδία εντός του πεδίου session_attributes:
gad_source: Μια συγκεντρωτική παράμετρος που προβάλλεται στο URL, για τον προσδιορισμό της πηγής επισκεψιμότητας που προέρχεται από διαφημίσεις. Μάθετε περισσότερα σχετικά με τις παραμέτρους URL gad_*.gad_campaignid: Το αναγνωριστικό της συγκεκριμένης καμπάνιας διαφήμισης που εξασφάλισε το κλικ σε διαφήμιση. Μάθετε περισσότερα σχετικά με τις παραμέτρους URL gad_*.landing_page_url: Το πλήρες URL της σελίδας προορισμού στον ιστότοπό σας. Δηλώνει τη συγκεκριμένη σελίδα την οποία επισκέφτηκε για πρώτη φορά ο χρήστης.session_start_time_usec: Η χρονική σήμανση για την ώρα κατά την οποία ξεκίνησε η περίοδος σύνδεσης του χρήστη στον ιστότοπό σας. Σας βοηθά να παρακολουθείτε τη διάρκεια των επισκέψεων των χρηστών. Είναι σημαντικό να χρησιμοποιείτε μια σταθερή μορφή ώρας σε μικροδευτερόλεπτα epoch χρονικής σήμανσης UNIX.landing_page_referrer: Το URL της ιστοσελίδας που συνέδεσε τον χρήστη με τον ιστότοπό σας. Σας βοηθά να κατανοήσετε τις πηγές επισκεψιμότητας που οδηγούν στον ιστότοπό σας. Για περισσότερες πληροφορίες σχετικά με τους συνδέσμους παραπομπής, ανατρέξτε σε αυτό το άρθρο. Παρόλο που το άρθρο εστιάζει στο Analytics, η έννοια του συνδέσμου παραπομπής είναι καθολική στον ιστό.landing_page_user_agent: Μια συμβολοσειρά που προσδιορίζει το πρόγραμμα περιήγησης και το λειτουργικό σύστημα του χρήστη. Αυτές οι πληροφορίες μπορούν να είναι χρήσιμες για την κατανόηση του τεχνικού περιβάλλοντος των χρηστών σας.
Πώς να καταγράψετε το αναγνωριστικό session_attributes
Μπορείτε να χρησιμοποιήσετε τη λειτουργία βοήθειας JavaScript και τη φόρμα HTML παρακάτω στη σελίδα προορισμού, για να καταγράψετε και να διατηρήσετε το αναγνωριστικό session_attributes.
Αυτό το παράδειγμα κώδικα διατηρεί δεδομένα στο localStorage. Πριν από την υλοποίηση στον ιστότοπό σας, βεβαιωθείτε επιπλέον ότι τηρούνται τυχόν απαραίτητες απαιτήσεις συναίνεσης και διατήρησης δεδομένων που αφορούν συγκεκριμένα τον ιστότοπό σας, όπως χρειάζεται.
Φόρμα HTML
- Πρέπει να τροποποιήσετε κάθε σελίδα υποβολής φόρμας, προκειμένου να προσθέσετε ένα κρυφό πεδίο για το αναγνωριστικό
session_attributes. Με αυτόν τον τρόπο, θα διαβιβάζεται το αναγνωριστικόsession_attributesστο σύστημα backend. Ακολουθεί ένα δείγμα κώδικα που παρουσιάζει τη διαδικασία.<form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form> - Δείγμα σεναρίου για την καταγραφή του αναγνωριστικού
session_attributes_encodedκαι τον ορισμό του στο πεδίο φόρμας. Αυτό το παράδειγμα κώδικα διατηρεί δεδομένα στο localStorage.<script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}
function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>
Πώς να στείλετε τα δεδομένα στο Google Ads
1. Πεδίο session_attributes_encoded στο Google Ads API
Για τους υπάρχοντες χρήστες της Εισαγωγής μετατροπής εκτός σύνδεσης (OCI) που χρησιμοποιούν JavaScript, στείλτε αυτά τα δεδομένα ορίζοντας τα κωδικοποιημένα αναγνωριστικά session_attributes που καταγράφονται από την παρεχόμενη JavaScript σε ένα νέο πεδίο που ονομάζεται ClickConversion.session_attributes_encoded εντός του υπάρχοντος σχήματος μεταφόρτωσης. Συνεχίστε να χρησιμοποιείτε την τρέχουσα διαδικασία OCI, αλλά ορίστε αυτό το νέο πεδίο κατά την πραγματοποίηση εισαγωγών. Το Google Ads θα χρησιμοποιεί το αναγνωριστικό session_attributes, όταν δεν υπάρχουν τα άλλα αναγνωριστικά σας.
Όλοι οι νέοι χρήστες πρέπει να χρησιμοποιούν το Data Manager API. Αν ένας λογαριασμός δεν είναι στη λίστα επιτρεπομένων για τη μετάδοση διευθύνσεων IP ή χαρακτηριστικών περιόδου σύνδεσης μέσω του Google Ads API, θα λάβετε ένα μήνυμα σφάλματος για αυτές τις μετατροπές.
Για προχωρημένους
Αν δεν μπορείτε να χρησιμοποιήσετε JavaScript, μπορείτε να καταγράψετε τα μεμονωμένα ζεύγη κλειδιών/τιμών και να τα στείλετε με τις εισαγωγές μετατροπών εκτός σύνδεσης.
Για τους υπάρχοντες χρήστες της Εισαγωγής μετατροπής εκτός σύνδεσης (OCI) που δεν χρησιμοποιούν JavaScript, μπορείτε επίσης να ορίσετε το πεδίο ζεύγους κλειδιού-τιμής που ονομάζεται ClickConversion.session_attributes_key_value_pairs εντός του υπάρχοντος σχήματος μεταφόρτωσης. Προτείνουμε να στέλνετε ζεύγη κλειδιών/τιμών με αυτά τα πεδία κατά την κλήση του API. Δείτε την τεκμηρίωση για προγραμματιστές που εξηγεί πώς μπορείτε να προσθέσετε μεμονωμένα ζεύγη κλειδιών-τιμών σε μια μετατροπή κλικ (ClickConversion).
2. Πεδίο session_attributes με χρήση της Διαχείρισης δεδομένων
Μπορείτε επίσης να στείλετε το πεδίο session_attributes χρησιμοποιώντας τη Διαχείριση δεδομένων.
- Διεπαφή χρήστη Διαχείρισης δεδομένων: Χρησιμοποιήστε την παρεχόμενη JavaScript για να δημιουργήσετε το πεδίο
session_attributesκαι να το ανεβάσετε μέσω της διεπαφής χρήστη της Διαχείρισης δεδομένων. - Data Manager API: Μπορείτε να πραγματοποιήσετε ενσωμάτωση στο Data Manager API, για να ανεβάζετε τα δεδομένα σας μέσω προγραμματισμού. Ανατρέξτε στην τεκμηρίωση της Διαχείρισης δεδομένων για συγκεκριμένες οδηγίες και λεπτομέρειες σχήματος.
Με την αποστολή των κατάλληλων δεδομένων, δίνετε τη δυνατότητα στο Google Ads να χρησιμοποιεί αυτές τις πληροφορίες, για να αποδίδει μετατροπές στις σωστές καμπάνιες και να σας παρέχει πιο ολοκληρωμένες αναφορές μετατροπών.