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

اختيار النظام الأساسي: Android iOS

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

يتناول هذا الدليل مزامنة الموافقة بموجب "اللائحة العامة لحماية البيانات" من حزمة تطوير البرامج (SDK) لمنصّة User Messaging Platform (UMP) في تطبيقك على الأجهزة الجوّالة.

المتطلبات الأساسية

قبل البدء، يُرجى اتّباع الخطوات التالية:

• أكمِل دليل البدء.
• فعِّل مزامنة الموافقة للتطبيقات المؤهّلة في علامة التبويب الخصوصية والمراسلة ضمن واجهة مستخدم "مدير الإعلانات".

ضبط معرّف مزامنة الموافقة

في التطبيقات التي يمكنك فيها التعرّف على المستخدم، قدِّم رقم تعريف مزامنة الموافقة إلى حزمة تطوير البرامج لمنصة UMP. إذا لم يكن لتطبيقك معرّف مستخدم، استخدِم معرّفات أخرى لتحديد هوية المستخدم في جميع التطبيقات، مثل واجهات برمجة التطبيقات لمعرّف مجموعة التطبيقات.

اضبط معرّف مزامنة الموافقة على الكائن ConsentRequestParameters على النحو التالي:

Java

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();
  }
);

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()
}

تنسيق معرّف مزامنة الموافقة

يجب أن يحدّد المعرّف الذي تقدّمه المستخدم بشكلٍ فريد في جميع تطبيقاتك التي تتم فيها مزامنة الموافقة. يجب تجزئة المعرّف أو تشفيره لمنع إرسال معلومات تحديد الهوية الشخصية إلى Google.

يجب أن تستوفي بطاقة التعريف المقدَّمة المتطلبات التالية:

• يتم إنشاؤه كسلسلة UUID أو يتطابق مع التعبير العادي ^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$.
• يجب أن تتضمّن 22 حرفًا على الأقل.
• الحدّ الأقصى هو 150 حرفًا.

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

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

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