Google UMP SDK: Melaksanakan Persetujuan GDPR dalam Permainan Mudah Alih Unity
Mengapa Permainan Mudah Alih Memerlukan SDK Persetujuan
Jika permainan anda menunjukkan iklan daripada AdMob, Ad Manager, atau waterfall berpengantara kepada pemain di Kawasan Ekonomi Eropah atau UK, anda diwajibkan secara undang-undang untuk memperoleh persetujuan sah sebelum sebarang pengiklanan diperibadikan atau pengecam penjejakan digunakan. Sepanduk kuki web tidak menyelesaikan ini — aplikasi mudah alih asli tidak mempunyai kuki, dan persetujuan mesti sampai kepada ad SDK yang berjalan di dalam build anda.
Jawapan Google ialah User Messaging Platform (UMP) SDK, lapisan persetujuan yang dihantar bersama Google Mobile Ads SDK. Ia membentangkan borang persetujuan patuh IAB TCF, menyimpan pilihan pemain, dan mendedahkan isyarat persetujuan yang dibaca oleh AdMob dan rakan kongsi pengantaraan secara automatik. Bagi studio Unity, melaksanakan aliran ini dengan betul ialah perbezaan antara eCPM yang sihat dan gelombang amaran polisi.
Aliran Persetujuan, Dari Mula Hingga Akhir
Urutan operasi yang betul lebih penting daripada sebarang panggilan API tunggal. Pada setiap pelancaran aplikasi anda perlu:
- Minta kemas kini maklumat persetujuan. Ini memberitahu UMP untuk menyemak rantau pemain dan sama ada borang diperlukan.
- Muatkan dan tunjukkan borang jika diperlukan. UMP memutuskan sama ada untuk memaparkannya berdasarkan geografi dan pilihan sebelumnya — anda tidak pernah mengekod-keras "adakah pengguna ini di EU".
- Tunggu borang ditutup sebelum memulakan Mobile Ads SDK.
- Mulakan iklan hanya selepas persetujuan dikumpulkan, supaya permintaan iklan pertama sudah membawa isyarat yang betul.
Memulakan ad SDK sebelum borang persetujuan kembali ialah kesilapan paling biasa yang kami lihat. Ia menghasilkan tera tayang pertama yang tidak diperibadikan atau tidak patuh dan boleh mencetuskan semakan polisi automatik.
Pelaksanaan Unity Minimum
Dalam C#, rangka asasnya kelihatan seperti ini:
var request = new ConsentRequestParameters();
ConsentInformation.Update(request, (FormError error) => {
ConsentForm.LoadAndShowConsentFormIfRequired((FormError err) => {
if (ConsentInformation.CanRequestAds()) InitializeAds();
});
});
Semakan CanRequestAds() ialah pintu pagar anda. Selagi ia mengembalikan true — sama ada kerana pemain bersetuju atau kerana mereka berada di luar rantau dikawal selia — anda boleh memulakan dan meminta iklan. Jangan cache apa-apa tentang rantau sendiri; biarkan UMP menjadi satu-satunya sumber kebenaran.
Menguji Tanpa Menghantar ke Gedung
Anda tidak boleh mengesahkan aliran persetujuan dari pejabat anda di, katakan, Istanbul melainkan anda mensimulasikan peranti EEA. UMP menyokong tetapan geografi nyahpepijat dan senarai ID dicincang peranti ujian:
- Daftarkan ID dicincang peranti ujian anda dalam parameter permintaan.
- Paksa geografi nyahpepijat ke
EEAuntuk membuat borang muncul. - Gunakan kaedah set semula SDK antara larian supaya anda melihat pengalaman pelancaran pertama setiap kali.
Sentiasa buang tetapan nyahpepijat sebelum build pengeluaran. Menghantar bendera nyahpepijat EEA-dipaksa kepada setiap pemain ialah insiden sebenar dan memalukan.
Persetujuan, Pengantaraan, dan Hasil Anda
Apabila persetujuan disebarkan dengan betul, setiap rangkaian dalam tindanan pengantaraan anda — AdMob, Meta Audience Network, Unity Ads, AppLovin — menerima rentetan TCF dan boleh membida inventori diperibadikan di mana dibenarkan. Apabila ia rosak, rangkaian tersebut kembali kepada iklan tidak diperibadikan pada sebahagian kecil eCPM, dan waterfall anda secara senyap kehilangan hasil. Anggap lapisan persetujuan sebagai sebahagian daripada tindanan pengewangan anda, bukan renungan pematuhan terkemudian.
Di Mana FlexyConsent Sesuai
UMP meliputi permukaan Google sendiri, tetapi kebanyakan penerbit serius menjalankan persetujuan merentasi hartanah web, berbilang aplikasi, dan penandaan sebelah pelayan serentak. FlexyConsent memberi anda satu rekod persetujuan, isyarat TCF dan Google Consent Mode v2, dan analitik kadar persetujuan merentasi setiap platform — supaya pilihan yang dibuat pemain dalam permainan Unity anda dan pilihan yang dibuat pelawat di tapak pemasaran anda berada di satu tempat boleh diaudit. Pematuhan menjadi papan pemuka, bukan latihan kebakaran.
Pengajaran Utama
- Kumpul persetujuan melalui UMP SDK sebelum memulakan Mobile Ads SDK.
- Jangan sekali-kali mengekod-keras logik rantau — biarkan UMP memutuskan bila borang diperlukan.
- Uji dengan geografi nyahpepijat dan ID ujian dicincang, kemudian buang sebelum keluaran.
- Penyebaran persetujuan yang betul melindungi eCPM iklan diperibadikan anda merentasi keseluruhan tindanan pengantaraan.