במדריך הזה מוסבר איך לסנכרן את ההסכמה בהתאם ל-GDPR מ-User Messaging Platform (UMP) SDK באפליקציה לנייד.
דרישות מוקדמות
לפני שמתחילים, צריך לבצע את הפעולות הבאות:
- הגדרת IMA SDK ל-Android
- מפעילים את סנכרון ההסכמה באפליקציות שעומדות בדרישות בכרטיסייה פרטיות והודעות בממשק המשתמש של Ad Manager.
הגדרת מזהה לסנכרון ההסכמה
באפליקציות שבהן יש לכם אפשרות לזהות את המשתמש, צריך לספק את מזהה סנכרון ההסכמה ל-UMP SDK. אם באפליקציה שלכם אין מזהה משתמש, תוכלו להשתמש במזהים אחרים כדי לזהות את המשתמש באפליקציות, כמו ממשקי ה-API של מזהה חבילת האפליקציות.
מגדירים את מזהה סנכרון ההסכמה באובייקט 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()
}
הפורמט של מזהה סנכרון ההסכמה
המזהה שאתם מספקים צריך לזהות את המשתמש באופן ייחודי בכל האפליקציות שלכם שבהן מתבצע סנכרון של ההסכמה. מבצעים גיבוב או הצפנה של המזהה כדי למנוע שליחה של פרטים אישיים מזהים (PII) ל-Google.
המזהה שצריך לספק חייב לעמוד בדרישות הבאות:
- הערך בנוי כמחרוזת UUID או שהוא תואם לביטוי הרגולרי
^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$. - לפחות 22 תווים.
- עד 150 תווים.
דוגמאות למזהי סנכרון תקינים של הסכמה:
12JD92JD8078S8J29SDOAKC0EF23033712jd92jd8078s8j29sdoakc0ef23033712Jd92jD8078s8j29sDoakc0ef230337123e4567-e89b-12d3-a456-426614174000
אם לא תעמדו בדרישות, מזהה סנכרון ההסכמה לא יוגדר, ו-UMP SDK ירשום אזהרה במסוף