Panduan ini membahas sinkronisasi izin GDPR dari User Messaging Platform (UMP) SDK di aplikasi seluler Anda.
Prasyarat
Sebelum memulai, lakukan hal berikut:
- Siapkan IMA SDK untuk Android.
- Aktifkan sinkronisasi izin untuk aplikasi yang memenuhi syarat di tab Privasi & Pesan di UI Ad Manager.
Menetapkan ID sinkronisasi izin
Di seluruh aplikasi tempat Anda dapat mengidentifikasi pengguna, berikan ID sinkronisasi izin ke UMP SDK. Jika aplikasi Anda tidak memiliki ID pengguna, gunakan ID lain untuk mengidentifikasi pengguna di seluruh aplikasi, seperti API ID Set Aplikasi.
Tetapkan ID sinkronisasi izin pada
objek ConsentRequestParameters:
Java
// Example fetching App Set ID to identify the user across apps.
AppSetIdClient client = AppSet.getClient(activity);
client
.getAppSetIdInfo()
.addOnSuccessListener(
info -> {
String appSetId = info.getId();
ConsentRequestParameters params =
new ConsentRequestParameters.Builder().setConsentSyncId(appSetId).build();
});
Kotlin
import com.google.android.gms.appset.AppSet
import com.google.android.gms.appset.AppSetIdInfo
// Example fetching App Set ID to identify the user across apps.
val client = AppSet.getClient(activity)
client.appSetIdInfo.addOnSuccessListener { info: AppSetIdInfo ->
val appSetId = info.id
val params = ConsentRequestParameters.Builder().setConsentSyncId(appSetId).build()
}
Format ID sinkronisasi izin
ID yang Anda berikan harus mengidentifikasi pengguna secara unik di semua aplikasi Anda tempat izin disinkronkan. Hash atau enkripsi ID untuk mencegah pengiriman informasi identitas pribadi (PII) ke Google.
Tanda pengenal yang diberikan harus memenuhi persyaratan berikut:
- Dibuat sebagai string UUID atau cocok dengan ekspresi reguler
^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$. - Minimum 22 karakter.
- Maksimum 150 karakter.
Berikut adalah contoh ID sinkronisasi izin yang benar:
12JD92JD8078S8J29SDOAKC0EF23033712jd92jd8078s8j29sdoakc0ef23033712Jd92jD8078s8j29sDoakc0ef230337123e4567-e89b-12d3-a456-426614174000
Jika persyaratan tidak terpenuhi, ID sinkronisasi izin tidak akan ditetapkan dan UMP SDK akan mencatat peringatan ke konsol