Prebid.js Beleegyezéskezelés: Header Bidding Beállítási Útmutató Kiadóknak

A header bidding növeli a kiadói CPM-eket azáltal, hogy a keresletpartnereknek párhuzamos versenyeztetést tesz lehetővé – de minden egyes partnernek érvényes beleegyezési jelre van szüksége, mielőtt cookie-t helyezhetne el, ujjlenyomatot vehetne, vagy pixelt tüzelhetne. A Prebid.js, a de facto nyílt forráskódú header bidding wrapper, amelyet tízezer számra használnak webhelyek, tartalmaz egy Beleegyezéskezelési modult, amely összeköti az Ön CMP-jét minden aukcióval. Ha rosszul konfigurálja, akkor vagy beleegyezés nélkül szivárogtát adatokat (szabályozási kockázat), vagy megfosztja a licitálókat a szükséges jeltől (bevételi kockázat). Ez az útmutató végigvezeti a kiadókat egy gyártásra kész beállításon.

Miért van szüksége a Prebid.js-nek Beleegyezéskezelési Modulra?

Amikor a Prebid.js aukció fut, a wrapper párhuzamos kéréseket küld minden konfigurált licitáló adapternek. Minden adapternek bele kell foglalnia a felhasználó beleegyezési karakterláncát az ajánlati kérésbe – tcfeu (TCF v2.2 az EU/UK számára), usp (CCPA/CPRA), és egyre inkább gpp (az IAB Global Privacy Platform karakterlánca, amely több US államot fed le). E jelek nélkül a downstream SSP-k és DSP-k kénytelenek vagy kikapcsolt állapotban kezelni a felhasználót, teljesen elejteni az ajánlatot, vagy – legrosszabb esetben – jogszerűtlenül feldolgozni az adatokat.

A Prebid Beleegyezéskezelési modul az Ön CMP-je és az ajánlati kérés folyamat között helyezkedik el. Meghívja a szabványos CMP API-t (__tcfapi, __uspapi, __gppapi), megvárja a beleegyezési karakterláncot, majd automatikusan beinjektálja azt minden adapter ajánlati kérés hasznos adatába. Emellett célalapú kapuzást érvényesít, amikor engedélyezi a GDPR érvényesítést, blokkolva a tárhelyhozzáférést és a licitáló végrehajtást azoknak a felhasználóknak, akik nem adták meg a releváns TCF célokhoz szükséges engedélyt.

Az Alapmodul Telepítése és Konfigurálása

A Prebid.js kiadónként épül fel a docs.prebid.org/download.html oldalról. Amikor létrehozza az egyéni buildet, három modul fontos a „Beleegyezéskezelés" alatt:

Ha globális forgalmat szolgál ki, mindhárom modult foglalja bele. Amint a build felkerül a CDN-re, konfigurálja a modulokat a Prebid beállítási szkriptjében:

TCF v2.2 konfiguráció

A TCF blokk megmondja a Prebidnek, melyik CMP API-t hívja meg, mennyi ideig várjon a karakterláncra, és mit tegyen időtúllépés esetén. Egy tipikus gyártási konfiguráció cmpApi: 'iab'-t, timeout: 8000-t (8 másodpercet – elég hosszú egy lassú CMP banner betöltéséhez), és defaultGdprScope: true-t állít be, így az ismeretlen joghatóságú felhasználókat hatáskörön belülinek tekintik, amíg az ellenkezője be nem bizonyosodik. Az actionTimeout külön beállítása vezérli, mennyi ideig vár a Prebid, amikor a felhasználó még nem lépett kapcsolatba a bannerrel – mérsékelt értéken tartva elkerüli az üres hirdetési helyet, ha a látogató figyelmen kívül hagyja a bannert.

US Adatvédelem és GPP

Az USP egyszerű: engedélyezze a modult, és a Prebid beolvassa a négykarakteres karakterláncot a __uspapi-ból. A GPP árnyaltabb, mert a GPP karakterlánc több szakasz-azonosítót is hordozhat (TCF EU, US Nemzeti, US Kaliforniai, US Coloradói, US Virginiai stb.). A Prebid automatikusan továbbítja a teljes karakterláncot, de a licitálók konkrét szakaszokat vizsgálnak. Győződjön meg arról, hogy a CMP a megfelelő GPP szakaszokat bocsátja ki minden felhasználó joghatóságához – egy rosszul konfigurált CMP, amely csak az US Nemzeti szakaszt bocsátja ki egy kaliforniai felhasználónak, azt eredményezi, hogy a CPRA-kompatibilis DSP-k eldobják az ajánlatot.

GDPR Érvényesítés Engedélyezése (Célalapú Kapuzás)

Alapértelmezés szerint a beleegyezési modul átengedi a TCF karakterláncot, de nem blokkol semmit. Ahhoz, hogy a Prebid valóban érvényesítse a TCF célokat, engedélyezze a gdprEnforcement szabálykészletet. Ez az a pont, ahol a legtöbb beállítási hiba történik – és ahol a megfelelő és nem megfelelő header bidding stack közötti különbség rejlik.

A szabványos szabálykészlet négy tevékenységet blokkol, amikor a releváns célból hiányzik a beleegyezés:

Minden szabályhoz enforcePurpose: true-t, enforceVendor: true-t, és egy vendorExceptions listát állít be. A szállítói kivételek listája kritikus: minden licitáló, amelyet felsorol, engedélyt kap a részvételre még az explicit TCF szállítói beleegyezés nélkül is, azon az alapon, hogy Önnek külön jogalapja van (pl. jogos érdek és szerződéses folyamat kombinációja). Ezt kíméletesen használja – a túl széles kivételek pontosan azok a minták, amelyek miatt a szabályozók már bírságolni kezdték a kiadókat.

Bevételbe vagy Megfelelőségbe Kerülő Gyakori Csapdák

Túl alacsony időtúllépési beállítás

Ha a timeout rövidebb, mint a CMP banner megjelenítési ideje, a Prebid beleegyezési karakterlánc nélkül halad tovább. A licitálók ezt beleegyezés hiányaként kezelik és ejtik az ajánlatot. Mérje meg a CMP tcfapi('addEventListener') első hívásának késleltetését a 95. percentilisnél, és állítsa be a Prebid időtúllépést e fölé. A 8000 ms biztonságos alapértelmezés; a 3000 ms kockázatos, ha olyan piacokon szolgál ki felhasználókat, ahol a bannerek lokalizálása időt vesz igénybe.

Hiányzó GPP integráció az US forgalomhoz

A nagy SSP-k és DSP-k (Google AdX, TTD, Magnite, PubMatic) most megkövetelik a GPP karakterláncot az US opt-out érvényesítéséhez. Ha csak a régi USP karakterláncot bocsátja ki, ezek a DSP-k egyre inkább csökkentik vagy kihagyják a leltárát. Ellenőrizze az ajánlati válaszokat: az US forgalom éles CPM-csökkenése 2026-ban gyakran hiányzó GPP-jel.

Elavult beleegyezési karakterláncok SPA navigációnál

Az egyoldalas alkalmazások, amelyek route-változáskor újra aktiválják a Prebid aukciókat, meg kell hívniuk a pbjs.refreshUserIds() funkciót, és biztosítaniuk kell a legfrissebb TCF karakterlánc lekérését. Egy 30 perces gyorsítótárazott karakterlánc hordozhatja az előző felhasználó preferenciáit, ha az oldal megosztott munkameneteket használ.

Hiányzó vendorExceptions az analitikához

A kiadók gyakran elfelejtik, hogy a Prebid Analytics adapterek (Google Analytics, szerver oldali jelentések) szintén a TCF 7. cél alatti measurement kapuzás hatálya alá esnek. Ha ezekre támaszkodik a bevételi jelentésekhez, sorolja fel őket kifejezetten a mérési szabály szállítói kivételei alatt, vagy fogadja el az adathiányt a beleegyezés nélküli forgalmon.

Beállítás Tesztelése Éles Üzembe Helyezés Előtt

A Prebid.js elérhetővé teszi a pbjs.getConfig('consentManagement') parancsot a böngésző konzolban. Ellenőrizze, hogy az aktív konfiguráció megfelel-e a szándékainak. Ezután használja a Chrome Prebid.js Professor bővítményt vagy a pbjs.getEvents() funkciót az egyes ajánlati kérésekhez csatolt beleegyezési karakterlánc vizsgálatához. Ellenőrizzen három forgatókönyvet: teljesen beleegyező felhasználót, „Mindent elutasítok" feliratot megnyomó felhasználót, és bannert interakció nélkül elutasító felhasználót. Mindegyiknek különböző megfigyelhető viselkedést kell produkálnia az ajánlati kérés hasznos adataiban.

Ugyanezeket az ellenőrzéseket futtassa különböző földrajzi területeken VPN vagy a CMP geolokáció felülírási zászlójának segítségével. Az EU forgalomnak TCF karakterláncot kell produkálnia és aktiválnia kell a gdprEnforcement-et; a kaliforniai forgalomnak USP és GPP karakterláncot kell produkálnia; a joghatóság szempontjából ismeretlen forgalomnak tiszteletben kell tartania a defaultGdprScope beállítást.

Összefoglalás

Egy helyesen konfigurált Prebid Beleegyezéskezelési stack egyszerre három dolgot tesz: érvényes beleegyezési jelekkel látja el a licitálókat (megőrizve a CPM-eket), érvényesíti a TCF és az US opt-out szabályokat a wrapper szintjén (csökkentve a szabályozási kitettséget), és egyetlen audit pontot biztosít, amikor egy szabályozó megkérdezi, hogyan tiszteli a header bidding beállítása a felhasználói döntést. Szánjon időt az időtúllépések szándékos beállítására, engedélyezze a GPP-t az USP mellett az US forgalomhoz, és negyedévente tekintse át a vendorExceptions listát – a hibázás ára mind bírságokban, mind elvesztett programatikus bevételekben mérhető.

← Blog Összes olvasása →