Συναίνεση μέσα σε 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
- Ξεκινήστε από το τρέχον παράθυρο. Αν το __tcfapi υπάρχει τοπικά, χρησιμοποιήστε το απευθείας — το script δεν βρίσκεται σε frame ή το frame μοιράζεται το CMP.
- Διαφορετικά, κάντε βρόχο προς τα πάνω: ελέγξτε αν το τρέχον παράθυρο περιέχει frame με όνομα __tcfapiLocator· αν όχι, μετακινηθείτε στο window.parent και ελέγξτε ξανά, σταματώντας στο ανώτατο παράθυρο.
- Όταν βρεθεί το locator, το παράθυρο που το περιέχει είναι το παράθυρο του CMP. Η επικοινωνία γίνεται πλέον μέσω postMessage.
Τυλίξτε κάθε πρόσβαση σε try/catch, επειδή ορισμένα προγράμματα περιήγησης ή ρυθμίσεις sandboxing πετούν σφάλμα στην cross-origin πρόσβαση ιδιοτήτων, και σταματήστε τον βρόχο όταν το window.parent ισούται με το τρέχον παράθυρο.
Η μορφή του μηνύματος
Για το TCF, το script στο frame στέλνει ένα μήνυμα στο παράθυρο του CMP που περιέχει ένα αντικείμενο με ιδιότητα __tcfapiCall. Μέσα σε αυτό υπάρχουν τέσσερα πεδία:
- command — για παράδειγμα getTCData, ping ή addEventListener·
- parameter — οποιοδήποτε όρισμα χρειάζεται η εντολή, ή null·
- version — η έκδοση του API, 2 για το TCF v2·
- callId — μια μοναδική τιμή που παράγει ο καλών.
Το 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 διαβάζει τη συναίνεση μία φορά και δεν αντιλαμβάνεται ποτέ μεταγενέστερη ανάκληση.
Ζητήματα ασφάλειας
- Επικυρώστε το σχήμα του μηνύματος. Αγνοήστε κάθε μήνυμα που δεν περιέχει την αναμενόμενη ιδιότητα και αναλύστε τα string payloads με προσοχή, καθώς ορισμένες υλοποιήσεις στέλνουν JSON strings αντί για αντικείμενα.
- Μην εμπιστεύεστε τυφλά. Οποιαδήποτε σελίδα μπορεί να στείλει μηνύματα στο frame σας. Αντιμετωπίστε τις απαντήσεις ως σήματα συναίνεσης που πρέπει να τιμηθούν, όχι ως πιστοποιημένα δεδομένα, και μην αφήσετε ποτέ να ενεργοποιούν προνομιακές ενέργειες.
- Χρησιμοποιείτε συγκεκριμένα target origins όπου μπορείτε. Όταν το origin του CMP είναι γνωστό, στείλτε σε αυτό αντί για όλα τα origins.
Όπου το μοτίβο δεν φτάνει
Ορισμένα διαφημιστικά περιβάλλοντα απομονώνουν τα creatives αυστηρότερα. Τα containers SafeFrame, τα sandboxed iframes χωρίς τις σωστές άδειες και τα creatives που αποδίδονται σε ξεχωριστά έγγραφα ενδέχεται να μην μπορούν να διασχίσουν το δέντρο των frames ή να λάβουν μηνύματα. Σε αυτές τις περιπτώσεις, το σήμα συναίνεσης συνήθως πρέπει να περαστεί ρητά, για παράδειγμα ως παράμετροι στο αίτημα διαφήμισης ή ως τιμές που παραδίδει στο creative ο ad server, όπως οι παράμετροι gdpr και gdpr_consent που υποστηρίζουν πολλά διαφημιστικά tags.
Λίστα ελέγχου αποσφαλμάτωσης
- Στα DevTools του ανώτατου παραθύρου, επιβεβαιώστε ότι τα locator frames υπάρχουν στον πίνακα Elements.
- Αλλάξτε το πλαίσιο της κονσόλας στο iframe και ελέγξτε αν το locator είναι προσβάσιμο από εκεί.
- Καταγράψτε τα εισερχόμενα events message και στα δύο παράθυρα για να επιβεβαιώσετε ότι οι κλήσεις και οι επιστροφές ρέουν.
- Αλλάξτε τη συναίνεση στο banner και επαληθεύστε ότι οι listeners στα frames λαμβάνουν ενημέρωση.
- Δοκιμάστε με το CMP να φορτώνει αργά, ώστε να βεβαιωθείτε ότι ο κώδικας στο frame ξαναδοκιμάζει ή περιμένει αντί να τα παρατά αμέσως.
Βασικά συμπεράσματα
- Τα cross-origin frames φτάνουν στο CMP μέσω των frames __tcfapiLocator και __gppLocator.
- Οι κλήσεις και οι επιστροφές χρησιμοποιούν postMessage με __tcfapiCall/__tcfapiReturn ή τα αντίστοιχα του GPP, ταιριαγμένα με το callId.
- Κρατήστε τα callbacks των listeners καταχωρισμένα ώστε να φτάνουν οι μεταγενέστερες αλλαγές συναίνεσης.
- Επικυρώστε κάθε μήνυμα και μην το αντιμετωπίζετε ως αξιόπιστη είσοδο.
- Όπου τα frames είναι πλήρως απομονωμένα, περάστε ρητά τη συναίνεση στο αίτημα διαφήμισης.