للحدّ من تكرار رسائل طلب الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) للمستخدمين، يمكنك مزامنة الموافقة على مستوى تطبيقات متعدّدة. عندما يتّخذ المستخدم قرارًا بشأن الموافقة في تطبيق مفعَّلة فيه ميزة مزامنة الموافقة، يتم تخزين هذا الخيار باستخدام معرّف مزامنة الموافقة الذي تقدّمه. ويتم تلقائيًا تطبيق قرار الموافقة هذا على جميع التطبيقات الأخرى التي تشارك معرّف مزامنة الموافقة نفسه. تستخدم Google هذا المعرّف فقط لتخزين قرار موافقة المستخدم واسترجاعه.
يتناول هذا الدليل مزامنة موافقة بموجب اللائحة العامة لحماية البيانات (GDPR) من حزمة تطوير البرامج (SDK) لمنصّة User Messaging Platform (UMP) في تطبيقك على الأجهزة الجوّالة.
المتطلبات الأساسية
قبل البدء، يُرجى اتّباع الخطوات التالية:
- إعداد "حزمة تطوير البرامج لمنصة UMP"
- فعِّل مزامنة الموافقة للتطبيقات المؤهّلة في علامة التبويب الخصوصية والمراسلة ضمن واجهة مستخدم AdMob.
ضبط معرّف مزامنة الموافقة
في التطبيقات التي يمكنك فيها تحديد هوية المستخدم، قدِّم معرّف مزامنة الموافقة إلى حزمة تطوير البرامج (SDK) لمنصّة UMP. إذا لم يكن لتطبيقك معرّف مستخدم، استخدِم معرّفات أخرى لتحديد هوية المستخدم في جميع التطبيقات، مثل واجهات برمجة التطبيقات لمعرّف مجموعة التطبيقات.
اضبط معرّف مزامنة الموافقة على الكائن
ConsentRequestParameters
على النحو التالي:
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(this)
client.appSetIdInfo.addOnSuccessListener { info: AppSetIdInfo ->
val appSetId = info.id
val params = ConsentRequestParameters.Builder().setConsentSyncId(appSetId).build()
}
جافا
import com.google.android.gms.appset.AppSet;
import com.google.android.gms.appset.AppSetIdClient;
// Example fetching App Set ID to identify the user across apps.
AppSetIdClient client = AppSet.getClient(this);
client.getAppSetIdInfo().addOnSuccessListener(
info -> {
String appSetId = info.getId();
ConsentRequestParameters params =
new ConsentRequestParameters.Builder().setConsentSyncId(appSetId).build();
}
);
تنسيق معرّف مزامنة الموافقة
يجب أن يحدّد المعرّف الذي تقدّمه المستخدم بشكلٍ فريد في جميع تطبيقاتك التي تتم فيها مزامنة الموافقة. تجزئة المعرّف أو تشفيره لمنع إرسال معلومات تكشف الهوية الشخصية إلى Google
يجب أن يستوفي المعرّف المقدَّم المتطلبات التالية:
- يتم إنشاؤه كسلسلة معرّف فريد عالمي (UUID) أو يتطابق مع التعبير العادي
^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$. - الحد الأدنى هو 22 حرفًا.
- الحدّ الأقصى هو 150 حرفًا.
في ما يلي أمثلة على معرّفات مزامنة الموافقة الصحيحة:
12JD92JD8078S8J29SDOAKC0EF23033712jd92jd8078s8j29sdoakc0ef23033712Jd92jD8078s8j29sDoakc0ef230337123e4567-e89b-12d3-a456-426614174000
سيؤدي عدم استيفاء المتطلبات إلى عدم ضبط معرّف مزامنة الموافقة وتسجيل "حزمة تطوير البرامج لمنصة UMP" تحذيرًا في وحدة التحكّم.