ความยินยอมภายใน iframe ข้ามต้นทาง: รูปแบบ __tcfapiLocator และ __gppLocator

ปัญหา: ความยินยอมอยู่ในหน้าต่างบนสุด

CMP ทำงานบนหน้าเว็บของคุณในหน้าต่างระดับบนสุด แต่โฆษณาส่วนใหญ่ของคุณไม่ได้ทำงานที่นั่น ครีเอทีฟดิสเพลย์ rich media ตัวเรนเดอร์ header bidding และวิดเจ็ตบุคคลที่สามจำนวนมากทำงานภายใน iframe มักอยู่คนละ origin โค้ดใน iframe ข้าม origin เรียกฟังก์ชันของหน้าแม่โดยตรงไม่ได้ จึงเรียก __tcfapi หรือ __gpp เพื่ออ่านตัวเลือกของผู้เข้าชมโดยตรงไม่ได้

กรอบ IAB แก้ปัญหานี้ด้วยข้อตกลงการส่งข้อความที่เล็กและกำหนดไว้ชัดเจน หากคุณสร้างผลิตภัณฑ์โฆษณา embed หรือสคริปต์วัดผลที่ทำงานในเฟรม หรือดีบักสแตกโฆษณาที่ทำเช่นนั้น ควรรู้ว่ามันทำงานอย่างไรแน่ชัด

เฟรม Locator

นอกจาก JavaScript API แล้ว CMP แบบ TCF ยังเพิ่ม iframe เปล่าที่มองไม่เห็นชื่อ __tcfapiLocator ลงในหน้าระดับบนสุด CMP แบบ GPP ทำเช่นเดียวกันด้วยเฟรมชื่อ __gppLocator เฟรมเหล่านี้ไม่มีเนื้อหา หน้าที่เดียวของมันคือให้ค้นพบได้: สคริปต์ใดก็ตามในเฟรมซ้อนใด ๆ สามารถไล่ขึ้นตามลำดับชั้นของหน้าต่างและตรวจสอบในแต่ละระดับว่ามีเฟรมชื่อนั้นอยู่หรือไม่

เนื่องจากชื่อเฟรมมองเห็นได้ข้าม origin ผ่าน window.frames สคริปต์ใน iframe ข้าม origin ที่ซ้อนลึกจึงหาหน้าต่างที่โฮสต์ CMP ได้โดยไม่ต้องเข้าถึงสิ่งอื่นใดบนหน้านั้น

สคริปต์ในเฟรมหา CMP ได้อย่างไร

  1. เริ่มจากหน้าต่างปัจจุบัน หากมี __tcfapi ในเครื่อง ให้ใช้โดยตรง — สคริปต์ไม่ได้อยู่ในเฟรม หรือเฟรมใช้ CMP ร่วมกัน
  2. มิฉะนั้นวนลูปขึ้นไปข้างบน: ตรวจสอบว่าหน้าต่างปัจจุบันมีเฟรมชื่อ __tcfapiLocator หรือไม่ ถ้าไม่ ให้ไปที่ window.parent และตรวจสอบอีกครั้ง หยุดที่หน้าต่างบนสุด
  3. เมื่อพบ locator หน้าต่างที่มีมันอยู่คือหน้าต่างของ CMP การสื่อสารเกิดผ่าน postMessage จากนี้

ครอบการเข้าถึงแต่ละครั้งด้วย try/catch เพราะบางเบราว์เซอร์หรือการตั้งค่า sandbox จะโยนข้อผิดพลาดเมื่อเข้าถึงคุณสมบัติข้าม origin และหยุดลูปเมื่อ window.parent เท่ากับหน้าต่างปัจจุบัน

รูปแบบข้อความ

สำหรับ TCF สคริปต์ในเฟรมโพสต์ข้อความไปยังหน้าต่าง CMP ซึ่งมีออบเจกต์ที่มีคุณสมบัติ __tcfapiCall ภายในมีสี่ฟิลด์:

CMP รับฟังข้อความเหล่านี้ รันคำสั่ง และโพสต์ออบเจกต์ที่มีคุณสมบัติ __tcfapiReturn กลับมา ซึ่งมี returnValue, success และ callId เดียวกัน ผู้เรียกเก็บแผนที่ของ callback ที่รออยู่โดยใช้ callId เป็นคีย์ รับฟังเหตุการณ์ message และส่งแต่ละ return ไปยัง callback ที่ถูกต้อง GPP ใช้รูปแบบเดียวกันด้วย __gppCall และ __gppReturn

การเชื่อมต่อจำนวนมากเขียนพร็อกซีขนาดเล็ก: ฟังก์ชันภายในเครื่องชื่อ __tcfapi ภายในเฟรมที่แปลงการเรียกเป็นข้อความ โค้ดที่เขียนสำหรับหน้าต่างบนสุดจึงทำงานภายในเฟรมได้โดยไม่ต้องแก้ไข

Event listener ข้ามเฟรม

การเรียก addEventListener ที่ส่งผ่าน postMessage ไม่ใช่คำขอครั้งเดียว CMP จะโพสต์ข้อความ return ทุกครั้งที่สถานะความยินยอมเปลี่ยน โดยใช้ callId เดียวกันทั้งหมด dispatcher ของคุณจึงต้องคง callback นั้นไว้ในทะเบียน แทนที่จะลบหลังการตอบกลับครั้งแรก การลืมเรื่องนี้เป็นบั๊กคลาสสิก: สคริปต์ในเฟรมอ่านความยินยอมครั้งเดียวและไม่เคยรู้เลยว่ามีการถอนความยินยอมภายหลัง

ข้อควรพิจารณาด้านความปลอดภัย

ที่ที่รูปแบบนี้ไปไม่ถึง

สภาพแวดล้อมโฆษณาบางแห่งแยกครีเอทีฟอย่างเข้มงวดกว่า คอนเทนเนอร์ SafeFrame, iframe ที่อยู่ใน sandbox โดยไม่มีสิทธิ์ที่เหมาะสม และครีเอทีฟที่เรนเดอร์ในเอกสารแยกอาจไม่สามารถไล่ต้นไม้เฟรมหรือรับข้อความได้ ในกรณีเหล่านั้นมักต้องส่งสัญญาณความยินยอมอย่างชัดเจน เช่น เป็นพารามิเตอร์บนคำขอโฆษณา หรือค่าที่เซิร์ฟเวอร์โฆษณาส่งให้ครีเอทีฟ อย่างพารามิเตอร์ gdpr และ gdpr_consent ที่แท็กโฆษณาจำนวนมากรองรับ

เช็กลิสต์การดีบัก

ประเด็นสำคัญ

← บล็อก อ่านทั้งหมด →