Persetujuan dalam Iframe Silang Origin: Corak __tcfapiLocator dan __gppLocator

Masalahnya: Persetujuan Berada dalam Tetingkap Teratas

CMP berjalan pada halaman anda, dalam tetingkap peringkat atas. Kebanyakan iklan anda tidak. Kreatif paparan, rich media, renderer header bidding dan banyak widget pihak ketiga berjalan di dalam iframe, selalunya pada origin berbeza. Kod dalam iframe silang origin tidak boleh memanggil fungsi pada halaman induk secara langsung, jadi ia tidak boleh sekadar memanggil __tcfapi atau __gpp dan membaca pilihan pelawat.

Rangka kerja IAB menyelesaikannya dengan konvensyen pemesejan yang kecil dan tertakrif dengan baik. Jika anda membina produk iklan, embed atau skrip pengukuran yang berjalan dalam frame, atau menyahpepijat ad stack yang berbuat demikian, elok anda tahu bagaimana ia berfungsi dengan tepat.

Frame Locator

Di samping API JavaScript, CMP TCF menambah iframe kosong yang tidak kelihatan bernama __tcfapiLocator pada halaman peringkat atas. CMP GPP melakukan perkara sama dengan frame bernama __gppLocator. Frame ini tidak membawa kandungan. Satu-satunya tugasnya ialah boleh ditemui: mana-mana skrip dalam mana-mana frame bersarang boleh menyusuri hierarki tetingkap ke atas dan menyemak sama ada frame dengan nama itu wujud pada setiap peringkat.

Oleh sebab nama frame kelihatan merentas origin melalui window.frames, skrip dalam iframe silang origin yang bersarang dalam boleh mencari tetingkap yang menempatkan CMP tanpa mempunyai akses kepada apa-apa lagi pada halaman itu.

Bagaimana Skrip dalam Frame Menemui CMP

  1. Mulakan dengan tetingkap semasa. Jika __tcfapi wujud secara setempat, gunakannya terus — skrip tidak berada dalam frame, atau frame itu berkongsi CMP.
  2. Jika tidak, ulang ke atas: semak sama ada tetingkap semasa mengandungi frame bernama __tcfapiLocator; jika tidak, beralih ke window.parent dan semak lagi, berhenti pada tetingkap teratas.
  3. Apabila locator ditemui, tetingkap yang mengandunginya ialah tetingkap CMP. Komunikasi kini berlaku melalui postMessage.

Bungkus setiap akses dalam try/catch, kerana sesetengah pelayar atau tetapan sandboxing melontarkan ralat pada akses sifat silang origin, dan hentikan gelung apabila window.parent sama dengan tetingkap semasa.

Format Mesej

Bagi TCF, skrip dalam frame menghantar mesej kepada tetingkap CMP yang mengandungi objek dengan sifat __tcfapiCall. Di dalamnya ada empat medan:

CMP mendengar mesej ini, menjalankan arahan dan menghantar balik objek dengan sifat __tcfapiReturn yang mengandungi returnValue, success dan callId yang sama. Pemanggil menyimpan peta callback tertunda berkunci callId, mendengar peristiwa message dan menghantar setiap pulangan kepada callback yang betul. GPP mengikut corak sama dengan __gppCall dan __gppReturn.

Banyak integrasi menulis proksi kecil: fungsi setempat bernama __tcfapi di dalam frame yang menterjemahkan panggilan kepada mesej. Kod yang ditulis untuk tetingkap teratas kemudian berfungsi tanpa perubahan di dalam frame.

Event Listener Merentas Frame

Panggilan addEventListener yang dihantar melalui postMessage bukan permintaan sekali sahaja. CMP akan menghantar mesej pulangan setiap kali keadaan persetujuan berubah, semuanya dengan callId yang sama. Dispatcher anda oleh itu mesti mengekalkan callback itu didaftarkan dan bukannya memadamnya selepas respons pertama. Terlupa perkara ini ialah pepijat klasik: skrip dalam frame membaca persetujuan sekali dan tidak pernah menyedari penarikan balik kemudian.

Pertimbangan Keselamatan

Di Mana Corak Ini Tidak Sampai

Sesetengah persekitaran iklan mengasingkan kreatif dengan lebih ketat. Bekas SafeFrame, iframe sandbox tanpa kebenaran yang betul dan kreatif yang dirender dalam dokumen berasingan mungkin tidak dapat menyusuri pepohon frame atau menerima mesej. Dalam kes itu, isyarat persetujuan lazimnya mesti dihantar secara eksplisit, contohnya sebagai parameter pada permintaan iklan atau nilai yang diberikan ad server kepada kreatif, seperti parameter gdpr dan gdpr_consent yang disokong banyak tag iklan.

Senarai Semak Penyahpepijatan

Perkara Utama

← Blog Baca Semua →