ความยินยอมภายใน 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 ได้อย่างไร
- เริ่มจากหน้าต่างปัจจุบัน หากมี __tcfapi ในเครื่อง ให้ใช้โดยตรง — สคริปต์ไม่ได้อยู่ในเฟรม หรือเฟรมใช้ CMP ร่วมกัน
- มิฉะนั้นวนลูปขึ้นไปข้างบน: ตรวจสอบว่าหน้าต่างปัจจุบันมีเฟรมชื่อ __tcfapiLocator หรือไม่ ถ้าไม่ ให้ไปที่ window.parent และตรวจสอบอีกครั้ง หยุดที่หน้าต่างบนสุด
- เมื่อพบ locator หน้าต่างที่มีมันอยู่คือหน้าต่างของ CMP การสื่อสารเกิดผ่าน postMessage จากนี้
ครอบการเข้าถึงแต่ละครั้งด้วย try/catch เพราะบางเบราว์เซอร์หรือการตั้งค่า sandbox จะโยนข้อผิดพลาดเมื่อเข้าถึงคุณสมบัติข้าม origin และหยุดลูปเมื่อ window.parent เท่ากับหน้าต่างปัจจุบัน
รูปแบบข้อความ
สำหรับ TCF สคริปต์ในเฟรมโพสต์ข้อความไปยังหน้าต่าง CMP ซึ่งมีออบเจกต์ที่มีคุณสมบัติ __tcfapiCall ภายในมีสี่ฟิลด์:
- command — เช่น getTCData, ping หรือ addEventListener
- parameter — อาร์กิวเมนต์ที่คำสั่งต้องการ หรือ null
- version — เวอร์ชัน API คือ 2 สำหรับ TCF v2
- callId — ค่าเฉพาะที่ผู้เรียกสร้างขึ้น
CMP รับฟังข้อความเหล่านี้ รันคำสั่ง และโพสต์ออบเจกต์ที่มีคุณสมบัติ __tcfapiReturn กลับมา ซึ่งมี returnValue, success และ callId เดียวกัน ผู้เรียกเก็บแผนที่ของ callback ที่รออยู่โดยใช้ callId เป็นคีย์ รับฟังเหตุการณ์ message และส่งแต่ละ return ไปยัง callback ที่ถูกต้อง GPP ใช้รูปแบบเดียวกันด้วย __gppCall และ __gppReturn
การเชื่อมต่อจำนวนมากเขียนพร็อกซีขนาดเล็ก: ฟังก์ชันภายในเครื่องชื่อ __tcfapi ภายในเฟรมที่แปลงการเรียกเป็นข้อความ โค้ดที่เขียนสำหรับหน้าต่างบนสุดจึงทำงานภายในเฟรมได้โดยไม่ต้องแก้ไข
Event listener ข้ามเฟรม
การเรียก addEventListener ที่ส่งผ่าน postMessage ไม่ใช่คำขอครั้งเดียว CMP จะโพสต์ข้อความ return ทุกครั้งที่สถานะความยินยอมเปลี่ยน โดยใช้ callId เดียวกันทั้งหมด dispatcher ของคุณจึงต้องคง callback นั้นไว้ในทะเบียน แทนที่จะลบหลังการตอบกลับครั้งแรก การลืมเรื่องนี้เป็นบั๊กคลาสสิก: สคริปต์ในเฟรมอ่านความยินยอมครั้งเดียวและไม่เคยรู้เลยว่ามีการถอนความยินยอมภายหลัง
ข้อควรพิจารณาด้านความปลอดภัย
- ตรวจสอบรูปแบบข้อความ เพิกเฉยข้อความที่ไม่มีคุณสมบัติที่คาดหวัง และแยกวิเคราะห์ payload แบบสตริงอย่างระมัดระวัง เพราะบางการติดตั้งส่งสตริง JSON แทนออบเจกต์
- อย่าเชื่อถือโดยไม่ตรวจสอบ หน้าใดก็โพสต์ข้อความไปยังเฟรมของคุณได้ ถือว่าการตอบกลับเป็นสัญญาณความยินยอมที่ต้องปฏิบัติตาม ไม่ใช่ข้อมูลที่ผ่านการยืนยันตัวตน และอย่าให้มันกระตุ้นการกระทำที่มีสิทธิพิเศษ
- ระบุ origin เป้าหมายเฉพาะเมื่อทำได้ เมื่อรู้ origin ของ CMP ให้โพสต์ไปยัง origin นั้นแทนทุก origin
ที่ที่รูปแบบนี้ไปไม่ถึง
สภาพแวดล้อมโฆษณาบางแห่งแยกครีเอทีฟอย่างเข้มงวดกว่า คอนเทนเนอร์ SafeFrame, iframe ที่อยู่ใน sandbox โดยไม่มีสิทธิ์ที่เหมาะสม และครีเอทีฟที่เรนเดอร์ในเอกสารแยกอาจไม่สามารถไล่ต้นไม้เฟรมหรือรับข้อความได้ ในกรณีเหล่านั้นมักต้องส่งสัญญาณความยินยอมอย่างชัดเจน เช่น เป็นพารามิเตอร์บนคำขอโฆษณา หรือค่าที่เซิร์ฟเวอร์โฆษณาส่งให้ครีเอทีฟ อย่างพารามิเตอร์ gdpr และ gdpr_consent ที่แท็กโฆษณาจำนวนมากรองรับ
เช็กลิสต์การดีบัก
- ใน DevTools ของหน้าต่างบนสุด ยืนยันในแผง Elements ว่ามีเฟรม locator อยู่
- สลับบริบทคอนโซลไปที่ iframe และตรวจสอบว่าเข้าถึง locator จากที่นั่นได้หรือไม่
- บันทึกเหตุการณ์ message ที่เข้ามาในทั้งสองหน้าต่างเพื่อยืนยันว่าการเรียกและ return ไหลอยู่
- เปลี่ยนความยินยอมในแบนเนอร์และตรวจสอบว่า listener ในเฟรมได้รับการอัปเดต
- ทดสอบเมื่อ CMP โหลดช้า เพื่อให้แน่ใจว่าโค้ดในเฟรมลองใหม่หรือรอ แทนที่จะยอมแพ้ทันที
ประเด็นสำคัญ
- เฟรมข้าม origin เข้าถึง CMP ผ่านเฟรม __tcfapiLocator และ __gppLocator
- การเรียกและ return ใช้ postMessage กับ __tcfapiCall/__tcfapiReturn หรือคู่เทียบของ GPP โดยจับคู่ด้วย callId
- คง listener callback ไว้ในทะเบียนเพื่อให้การเปลี่ยนแปลงความยินยอมภายหลังมาถึง
- ตรวจสอบทุกข้อความและอย่าถือเป็นอินพุตที่เชื่อถือได้
- ที่ที่เฟรมถูกแยกโดยสมบูรณ์ ให้ส่งความยินยอมอย่างชัดเจนบนคำขอโฆษณา