Piekrišana starpizcelsmes iframe: __tcfapiLocator un __gppLocator modelis

Problēma: piekrišana dzīvo augšējā logā

CMP darbojas jūsu lapā, augšējā līmeņa logā. Liela daļa jūsu reklāmu ne. Displeja kreatīvi, rich media, header bidding renderētāji un daudzi trešo pušu logrīki darbojas iframe, bieži citā izcelsmē. Kods starpizcelsmes iframe nevar tieši izsaukt funkciju vecāklapā, tāpēc tas nevar vienkārši izsaukt __tcfapi vai __gpp un nolasīt apmeklētāja izvēli.

IAB ietvari to atrisina ar nelielu, labi definētu ziņojumapmaiņas konvenciju. Ja veidojat reklāmas produktus, iegultos elementus vai mērīšanas skriptus, kas darbojas kadros, vai atkļūdojat reklāmu stekus, kas to dara, ir vērts precīzi zināt, kā tas strādā.

Locator frame

Līdzās JavaScript API TCF CMP augšējā līmeņa lapai pievieno tukšu, neredzamu iframe ar nosaukumu __tcfapiLocator. GPP CMP dara to pašu ar kadru, kura nosaukums ir __gppLocator. Šajos kadros nav satura. Viņu vienīgais uzdevums ir būt atrodamiem: jebkurš skripts jebkurā ligzdotā kadrā var iet augšup pa logu hierarhiju un pārbaudīt, vai katrā līmenī pastāv kadrs ar šādu nosaukumu.

Tā kā kadru nosaukumi ir redzami starp izcelsmēm caur window.frames, skripts dziļi ligzdotā starpizcelsmes iframe var atrast logu, kas mitina CMP, bez piekļuves jebkam citam šajā lapā.

Kā kadrā esošs skripts atrod CMP

  1. Sāciet ar pašreizējo logu. Ja __tcfapi pastāv lokāli, izmantojiet to tieši — skripts nav kadrā vai kadrs koplieto CMP.
  2. Citādi ejiet ciklā augšup: pārbaudiet, vai pašreizējais logs satur kadru ar nosaukumu __tcfapiLocator; ja nē, pārejiet uz window.parent un pārbaudiet vēlreiz, apstājoties augšējā logā.
  3. Kad locator ir atrasts, logs, kas to satur, ir CMP logs. Komunikācija tagad notiek caur postMessage.

Ietiniet katru piekļuvi try/catch, jo daži pārlūki vai smilškastes iestatījumi izmet kļūdu pie starpizcelsmes īpašību piekļuves, un apturiet ciklu, kad window.parent ir vienāds ar pašreizējo logu.

Ziņojuma formāts

TCF gadījumā kadrā esošais skripts nosūta CMP logam ziņojumu, kas satur objektu ar īpašību __tcfapiCall. Tajā ir četri lauki:

CMP klausās šos ziņojumus, izpilda komandu un nosūta atpakaļ objektu ar īpašību __tcfapiReturn, kas satur returnValue, success un to pašu callId. Izsaucējs uztur gaidošo callback karti ar atslēgu callId, klausās message notikumus un katru atbildi nodod pareizajam callback. GPP seko tam pašam modelim ar __gppCall un __gppReturn.

Daudzas integrācijas raksta nelielu starpniekfunkciju: lokālu funkciju ar nosaukumu __tcfapi kadra iekšpusē, kas tulko izsaukumus ziņojumos. Augšējam logam rakstītais kods tad kadrā darbojas bez izmaiņām.

Event listener starp kadriem

Izsaukums addEventListener, kas nosūtīts caur postMessage, nav vienreizējs pieprasījums. CMP nosūtīs atbildes ziņojumu ikreiz, kad mainās piekrišanas stāvoklis, visus ar to pašu callId. Tāpēc jūsu dispečeram šis callback jāatstāj reģistrēts, nevis jādzēš pēc pirmās atbildes. Tā aizmiršana ir klasiska kļūda: kadrā esošais skripts nolasa piekrišanu vienreiz un nekad nepamana vēlāku atsaukšanu.

Drošības apsvērumi

Kur modelis nesniedzas

Dažas reklāmu vides kreatīvus izolē stingrāk. SafeFrame konteineri, smilškastes iframe bez pareizajām atļaujām un kreatīvi, kas renderēti atsevišķos dokumentos, var nespēt pāriet pa kadru koku vai saņemt ziņojumus. Šādos gadījumos piekrišanas signāls parasti jānodod skaidri, piemēram, kā parametri reklāmas pieprasījumā vai vērtības, ko reklāmu serveris nodod kreatīvam, piemēram, gdpr un gdpr_consent parametri, ko atbalsta daudzi reklāmu tagi.

Atkļūdošanas kontrolsaraksts

Galvenie secinājumi

← Blogs Lasīt visu →