مزامنة الموافقة على مستوى التطبيقات (إصدار تجريبي)

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

لتقليل رسائل طلب الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) المكرّرة التي تظهر للمستخدمين، يمكنك مزامنة الموافقة على مستوى تطبيقات متعدّدة. عندما يتّخذ المستخدم قرارًا بشأن الموافقة في تطبيق تم تفعيل ميزة "مزامنة خيارات الموافقة" فيه، يتم تخزين هذا الخيار باستخدام معرّف مزامنة الموافقة الذي تقدّمه. ويسري قرار الموافقة هذا تلقائيًا على جميع التطبيقات الأخرى التي تستخدم معرّف مزامنة خيارات الموافقة نفسه. تستخدم Google وحدها هذا المعرّف لتخزين قرار موافقة المستخدم واسترداده.

يتناول هذا الدليل مزامنة الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من حزمة تطوير البرامج (SDK) لمنصّة User Messaging Platform (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 حرفًا.

في ما يلي أمثلة على معرّفات مزامنة الموافقة الصحيحة:

  • 12JD92JD8078S8J29SDOAKC0EF230337
  • 12jd92jd8078s8j29sdoakc0ef230337
  • 12Jd92jD8078s8j29sDoakc0ef230337
  • 123e4567-e89b-12d3-a456-426614174000

سيؤدي عدم استيفاء المتطلبات إلى عدم ضبط معرّف مزامنة الموافقة وتسجيل "حزمة تطوير البرامج لمنصة UMP" تحذيرًا في وحدة التحكّم