Cross-Origin Iframe-lərdə Razılıq: __tcfapiLocator və __gppLocator Nümunəsi

Problem: Razılıq Üst Pəncərədə Yaşayır

CMP səhifənizdə, üst səviyyəli pəncərədə işləyir. Reklamınızın böyük hissəsi isə yox. Display kreativlər, rich media, header bidding renderer-ləri və bir çox üçüncü tərəf vidjeti iframe-lərdə, çox vaxt fərqli origin-də işləyir. Cross-origin iframe-dəki kod valideyn səhifədəki funksiyanı birbaşa çağıra bilmir, ona görə sadəcə __tcfapi və ya __gpp çağırıb ziyarətçinin seçimini oxuya bilməz.

IAB çərçivələri bunu kiçik, yaxşı müəyyən edilmiş mesajlaşma konvensiyası ilə həll edir. Frame-lərdə işləyən reklam məhsulları, embed-lər və ya ölçmə skriptləri qurursunuzsa, ya da bunu edən reklam steklərini debaq edirsinizsə, onun dəqiq necə işlədiyini bilməyə dəyər.

Locator Frame

JavaScript API ilə yanaşı, TCF CMP üst səviyyəli səhifəyə __tcfapiLocator adlı boş, görünməz iframe əlavə edir. GPP CMP eyni şeyi __gppLocator adlı frame ilə edir. Bu frame-lərin heç bir məzmunu yoxdur. Onların yeganə işi tapıla bilməkdir: iç-içə hər hansı frame-dəki istənilən skript pəncərə iyerarxiyası ilə yuxarı qalxıb hər səviyyədə həmin adlı frame-in olub-olmadığını yoxlaya bilər.

Frame adları window.frames vasitəsilə origin-lər arasında görünən olduğu üçün, dərin iç-içə cross-origin iframe-dəki skript həmin səhifədə başqa heç nəyə girişi olmadan CMP-ni yerləşdirən pəncərəni tapa bilər.

Frame-dəki Skript CMP-ni Necə Tapır

  1. Cari pəncərədən başlayın. __tcfapi lokal olaraq mövcuddursa, birbaşa istifadə edin — skript frame-də deyil və ya frame CMP-ni paylaşır.
  2. Əks halda, yuxarıya doğru dövr edin: cari pəncərənin __tcfapiLocator adlı frame ehtiva edib-etmədiyini yoxlayın; yoxdursa, window.parent-ə keçin və yenidən yoxlayın, üst pəncərədə dayanın.
  3. Locator tapıldıqda, onu ehtiva edən pəncərə CMP-nin pəncərəsidir. Əlaqə indi postMessage vasitəsilə baş verir.

Hər girişi try/catch-ə alın, çünki bəzi brauzerlər və ya sandbox parametrləri cross-origin xassəyə girişdə xəta atır və window.parent cari pəncərəyə bərabər olduqda dövrü dayandırın.

Mesaj Formatı

TCF üçün frame-dəki skript CMP pəncərəsinə __tcfapiCall xassəsi olan obyekt ehtiva edən mesaj göndərir. Onun içində dörd sahə var:

CMP bu mesajları dinləyir, əmri icra edir və returnValue, success və eyni callId-ni ehtiva edən __tcfapiReturn xassəli obyekti geri göndərir. Çağıran tərəf callId-yə görə gözləyən callback-lərin xəritəsini saxlayır, message event-lərini dinləyir və hər qaytarmanı düzgün callback-ə yönləndirir. GPP eyni nümunəyə __gppCall və __gppReturn ilə əməl edir.

Bir çox inteqrasiya kiçik proxy yazır: frame daxilində çağırışları mesajlara çevirən __tcfapi adlı lokal funksiya. Üst pəncərə üçün yazılmış kod bundan sonra frame daxilində dəyişmədən işləyir.

Frame-lər Arası Event Listener-lər

postMessage vasitəsilə göndərilən addEventListener çağırışı birdəfəlik sorğu deyil. CMP razılıq vəziyyəti hər dəyişdikdə, hamısı eyni callId ilə qaytarma mesajı göndərəcək. Buna görə dispatcher-iniz həmin callback-i ilk cavabdan sonra silmək əvəzinə qeydiyyatda saxlamalıdır. Bunu unutmaq klassik xətadır: frame-dəki skript razılığı bir dəfə oxuyur və sonradan geri çəkilməni heç vaxt hiss etmir.

Təhlükəsizlik Mülahizələri

Nümunənin Çatmadığı Yerlər

Bəzi reklam mühitləri kreativləri daha sərt izolyasiya edir. SafeFrame konteynerləri, düzgün icazələri olmayan sandbox-lanmış iframe-lər və ayrı sənədlərdə render olunan kreativlər frame ağacında gəzə və ya mesaj ala bilməyə bilər. Bu hallarda razılıq siqnalı adətən açıq şəkildə ötürülməlidir, məsələn, reklam sorğusunda parametrlər kimi və ya ad server-in kreativə verdiyi dəyərlər kimi, məsələn, bir çox reklam teqinin dəstəklədiyi gdpr və gdpr_consent parametrləri.

Debaq Çek-Siyahısı

Əsas Nəticələr

← Bloq Hamısını Oxu →