Google UMP SDK: GDPR-hozzájárulás megvalósítása Unity mobiljátékokban
Miért van szükségük a mobiljátékoknak hozzájárulási SDK-ra
Ha a játékod AdMob, Ad Manager vagy közvetített waterfall hirdetéseket jelenít meg az Európai Gazdasági Térségben vagy az Egyesült Királyságban tartózkodó játékosoknak, jogilag köteles vagy érvényes hozzájárulást szerezni, mielőtt bármilyen személyre szabott hirdetést vagy követési azonosítót használnál. Egy webes cookie-sáv ezt nem oldja meg — a natív mobilalkalmazásoknak nincsenek cookie-jaik, és a hozzájárulásnak el kell jutnia a buildedben futó hirdetési SDK-khoz.
A Google válasza a User Messaging Platform (UMP) SDK, az a hozzájárulási réteg, amely a Google Mobile Ads SDK-val érkezik. Egy IAB TCF-kompatibilis hozzájárulási űrlapot jelenít meg, eltárolja a játékos választásait, és olyan hozzájárulási jelet biztosít, amelyet az AdMob és a közvetítő partnerek automatikusan beolvasnak. Egy Unity-stúdió számára ennek a folyamatnak a helyes kialakítása dönti el, hogy egészséges eCPM vagy szabályzati büntetések hulláma lesz a vége.
A hozzájárulási folyamat elejétől a végéig
A műveletek helyes sorrendje fontosabb, mint bármely önálló API-hívás. Minden alkalmazásindításkor a következőket kell tenned:
- Kérj hozzájárulási információ-frissítést. Ez utasítja az UMP-t, hogy ellenőrizze a játékos régióját, és hogy szükséges-e űrlap.
- Töltsd be és jelenítsd meg az űrlapot, ha szükséges. Az UMP a földrajzi hely és a korábbi választások alapján dönti el, hogy megjeleníti-e — soha nem kódolod be fixen, hogy „ez a felhasználó az EU-ban van-e".
- Várj, amíg az űrlap bezárul, mielőtt inicializálnád a Mobile Ads SDK-t.
- A hirdetéseket csak a hozzájárulás összegyűjtése után inicializáld, hogy az első hirdetéskérés már a megfelelő jelet hordozza.
A hirdetési SDK inicializálása azelőtt, hogy a hozzájárulási űrlap visszatérne, a leggyakoribb hiba, amellyel találkozunk. Nem személyre szabott vagy nem megfelelő első megjelenítést eredményez, és automatikus szabályzati ellenőrzéseket válthat ki.
Egy minimális Unity-implementáció
C#-ban a váz így néz ki:
var request = new ConsentRequestParameters();
ConsentInformation.Update(request, (FormError error) => {
ConsentForm.LoadAndShowConsentFormIfRequired((FormError err) => {
if (ConsentInformation.CanRequestAds()) InitializeAds();
});
});
A CanRequestAds() ellenőrzés a kapud. Amíg igazat ad vissza — akár azért, mert a játékos hozzájárult, akár azért, mert szabályozott régión kívül van — inicializálhatsz és kérhetsz hirdetéseket. Magad ne tárolj semmit a régióról; hagyd, hogy az UMP legyen az egyetlen igazságforrás.
Tesztelés a Store-ba való közzététel nélkül
Nem tudsz ellenőrizni egy hozzájárulási folyamatot mondjuk az isztambuli irodádból anélkül, hogy szimulálnál egy EGT-eszközt. Az UMP támogat egy hibakeresési földrajzi beállítást és egy tesztelő eszköz hashelt azonosítóinak listáját:
- Regisztráld a tesztelő eszközöd hashelt azonosítóját a kérés paramétereiben.
- Kényszerítsd a hibakeresési földrajzot
EEAértékre, hogy az űrlap megjelenjen. - Használd az SDK visszaállítási metódusát a futtatások között, hogy minden alkalommal az első indítás élményét lásd.
Mindig távolítsd el a hibakeresési beállításokat egy éles build előtt. Egy kényszerített-EGT hibakeresési jelző kiszállítása minden játékosnak valós és kínos incidens.
Hozzájárulás, közvetítés és a bevételed
Ha a hozzájárulás helyesen terjed, a közvetítési halmazod minden hálózata — AdMob, Meta Audience Network, Unity Ads, AppLovin — megkapja a TCF-stringet, és ott, ahol engedélyezett, ajánlatot tehet személyre szabott készletre. Amikor ez megtörik, ezek a hálózatok az eCPM töredékéért nem személyre szabott hirdetésekre váltanak vissza, és a waterfalled csendben veszít bevételt. Kezeld a hozzájárulási réteget a monetizációs halmazod részeként, ne utólagos megfelelőségi gondolatként.
Hol illeszkedik a FlexyConsent
Az UMP a Google saját felületét fedi le, de a legtöbb komoly kiadó egyszerre kezel hozzájárulást webes felületeken, több alkalmazáson és szerveroldali címkézésen keresztül. A FlexyConsent egyetlen hozzájárulási rekordot, TCF- és Google Consent Mode v2-jeleket, valamint a hozzájárulási arányokra vonatkozó analitikát ad minden platformon át — így a játékos választása a Unity-játékodban és a látogató választása a marketingoldaladon egyetlen auditálható helyen él. A megfelelőség irányítópulttá válik, nem tűzoltássá.
Legfontosabb tanulságok
- Gyűjtsd a hozzájárulást az UMP SDK-n keresztül, mielőtt inicializálnád a Mobile Ads SDK-t.
- Soha ne kódold be fixen a régiólogikát — hagyd, hogy az UMP döntse el, mikor szükséges űrlap.
- Tesztelj hibakeresési földrajzzal és hashelt teszt-azonosítókkal, majd távolítsd el ezeket a kiadás előtt.
- A helyes hozzájárulás-terjesztés megvédi a személyre szabott hirdetések eCPM-jét a teljes közvetítési halmazon át.