Συναίνεση μέσα σε cross-origin iframes: Το μοτίβο __tcfapiLocator και __gppLocator

Το πρόβλημα: Η συναίνεση ζει στο ανώτατο παράθυρο

Ένα CMP τρέχει στη σελίδα σας, στο παράθυρο ανωτάτου επιπέδου. Μεγάλο μέρος της διαφήμισής σας όχι. Τα display creatives, τα rich media, οι renderers του header bidding και πολλά widgets τρίτων τρέχουν μέσα σε iframes, συχνά σε διαφορετικό origin. Ο κώδικας σε ένα cross-origin iframe δεν μπορεί να καλέσει απευθείας μια συνάρτηση της γονικής σελίδας, επομένως δεν μπορεί απλώς να καλέσει το __tcfapi ή το __gpp και να διαβάσει την επιλογή του επισκέπτη.

Τα πλαίσια του IAB λύνουν το πρόβλημα με μια μικρή, σαφώς ορισμένη σύμβαση μηνυμάτων. Αν φτιάχνετε διαφημιστικά προϊόντα, embeds ή scripts μέτρησης που τρέχουν σε frames, ή αν κάνετε αποσφαλμάτωση σε διαφημιστικές στοίβες που το κάνουν, αξίζει να ξέρετε ακριβώς πώς λειτουργεί.

Το locator frame

Παράλληλα με το JavaScript API, ένα CMP του TCF προσθέτει στη σελίδα ανωτάτου επιπέδου ένα κενό, αόρατο iframe με όνομα __tcfapiLocator. Ένα CMP του GPP κάνει το ίδιο με ένα frame με όνομα __gppLocator. Τα frames δεν έχουν περιεχόμενο. Η μόνη τους δουλειά είναι να μπορούν να βρεθούν: οποιοδήποτε script σε οποιοδήποτε εμφωλευμένο frame μπορεί να ανεβαίνει στην ιεραρχία των παραθύρων και να ελέγχει αν σε κάθε επίπεδο υπάρχει frame με αυτό το όνομα.

Επειδή τα ονόματα των frames είναι ορατά ανάμεσα σε διαφορετικά origins μέσω του window.frames, ένα script σε βαθιά εμφωλευμένο cross-origin iframe μπορεί να εντοπίσει το παράθυρο που φιλοξενεί το CMP χωρίς να έχει πρόσβαση σε οτιδήποτε άλλο σε εκείνη τη σελίδα.

Πώς ένα script σε frame βρίσκει το CMP

  1. Ξεκινήστε από το τρέχον παράθυρο. Αν το __tcfapi υπάρχει τοπικά, χρησιμοποιήστε το απευθείας — το script δεν βρίσκεται σε frame ή το frame μοιράζεται το CMP.
  2. Διαφορετικά, κάντε βρόχο προς τα πάνω: ελέγξτε αν το τρέχον παράθυρο περιέχει frame με όνομα __tcfapiLocator· αν όχι, μετακινηθείτε στο window.parent και ελέγξτε ξανά, σταματώντας στο ανώτατο παράθυρο.
  3. Όταν βρεθεί το locator, το παράθυρο που το περιέχει είναι το παράθυρο του CMP. Η επικοινωνία γίνεται πλέον μέσω postMessage.

Τυλίξτε κάθε πρόσβαση σε try/catch, επειδή ορισμένα προγράμματα περιήγησης ή ρυθμίσεις sandboxing πετούν σφάλμα στην cross-origin πρόσβαση ιδιοτήτων, και σταματήστε τον βρόχο όταν το window.parent ισούται με το τρέχον παράθυρο.

Η μορφή του μηνύματος

Για το TCF, το script στο frame στέλνει ένα μήνυμα στο παράθυρο του CMP που περιέχει ένα αντικείμενο με ιδιότητα __tcfapiCall. Μέσα σε αυτό υπάρχουν τέσσερα πεδία:

Το CMP ακούει αυτά τα μηνύματα, εκτελεί την εντολή και στέλνει πίσω ένα αντικείμενο με ιδιότητα __tcfapiReturn που περιέχει returnValue, success και το ίδιο callId. Ο καλών κρατά έναν χάρτη εκκρεμών callbacks με κλειδί το callId, ακούει events message και διανέμει κάθε επιστροφή στο σωστό callback. Το GPP ακολουθεί το ίδιο μοτίβο με τα __gppCall και __gppReturn.

Πολλές ενσωματώσεις γράφουν έναν μικρό proxy: μια τοπική συνάρτηση με όνομα __tcfapi μέσα στο frame που μεταφράζει τις κλήσεις σε μηνύματα. Ο κώδικας που γράφτηκε για το ανώτατο παράθυρο λειτουργεί τότε αμετάβλητος μέσα στο frame.

Event listeners ανάμεσα σε frames

Μια κλήση addEventListener που στέλνεται μέσω postMessage δεν είναι εφάπαξ αίτημα. Το CMP θα στέλνει μήνυμα επιστροφής κάθε φορά που αλλάζει η κατάσταση συναίνεσης, όλα με το ίδιο callId. Ο dispatcher σας πρέπει επομένως να κρατά αυτό το callback καταχωρισμένο αντί να το διαγράφει μετά την πρώτη απάντηση. Η παράλειψη αυτού είναι κλασικό σφάλμα: το script στο frame διαβάζει τη συναίνεση μία φορά και δεν αντιλαμβάνεται ποτέ μεταγενέστερη ανάκληση.

Ζητήματα ασφάλειας

Όπου το μοτίβο δεν φτάνει

Ορισμένα διαφημιστικά περιβάλλοντα απομονώνουν τα creatives αυστηρότερα. Τα containers SafeFrame, τα sandboxed iframes χωρίς τις σωστές άδειες και τα creatives που αποδίδονται σε ξεχωριστά έγγραφα ενδέχεται να μην μπορούν να διασχίσουν το δέντρο των frames ή να λάβουν μηνύματα. Σε αυτές τις περιπτώσεις, το σήμα συναίνεσης συνήθως πρέπει να περαστεί ρητά, για παράδειγμα ως παράμετροι στο αίτημα διαφήμισης ή ως τιμές που παραδίδει στο creative ο ad server, όπως οι παράμετροι gdpr και gdpr_consent που υποστηρίζουν πολλά διαφημιστικά tags.

Λίστα ελέγχου αποσφαλμάτωσης

Βασικά συμπεράσματα

← Ιστολόγιο Διαβάστε όλα →