هذه الصفحة مخصّصة للمطوّرين الذين يستخدِمون حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقاتهم ويريدون دمج "وضع الموافقة". للاطّلاع على مقدمة عن "وضع الموافقة"، يُرجى الاطّلاع على نظرة عامة على "وضع الموافقة".
توفّر "إحصاءات Google" ميزة "وضع الموافقة" لتعديل سلوك حزمة تطوير البرامج (SDK) استنادًا إلى حالة الموافقة للمستخدمين. يمكنك تنفيذ "وضع الموافقة" بطريقة أساسية أو متقدّمة إذا لم تكن متأكّدًا من تطبيق "وضع الموافقة" الأساسي أو المتقدّم، اطّلِع على مزيد من المعلومات حول وضع الموافقة الأساسي مقارنةً بوضع الموافقة المتقدّم وراجع إرشادات شركتك.
قبل البدء
قبل أن تتمكّن من إدارة موافقة المستخدمين، عليك تنفيذ ما يلي:
- حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase"
بانر إعدادات الموافقة للحصول على موافقة المستخدم
إعداد وضع الموافقة
لإعداد "وضع الموافقة"، عليك:
ضبط حالة الموافقة التلقائية
لا يتم ضبط قيم "وضع الموافقة" تلقائيًا. لضبط حالة الموافقة التلقائية لتطبيقك:
- افتح ملف AndroidManifest.xml الخاص بتطبيقك.
أضِف أزواج المفتاح/القيمة لميزة "وضع الموافقة". يصف المفتاح نوع الموافقة وتشير القيمة إلى حالة الموافقة. يمكن أن تكون القيم
true
، ما يعني أنّه تم منح الموافقة، أوfalse
، ما يعني أنّه تم رفض الموافقة.وفقًا للتعديلات التي أُجريت على وضع الموافقة في ما يتعلّق بزيارات المنطقة الاقتصادية الأوروبية (EEA)، يمكن ضبط قيمة
eu_consent_policy
للسمةad_user_data
وad_personalization
، ما يعني أنّه لا يتم رفض الموافقة إلا للمستخدمين في المناطق الخاضعة لـ "سياسة موافقة المستخدم في الاتحاد الأوروبي".اضبط ما يلي:
google_analytics_default_allow_analytics_storage
google_analytics_default_allow_ad_storage
google_analytics_default_allow_ad_user_data
google_analytics_default_allow_ad_personalization_signals
احفظ التغييرات. بعد ذلك، يجب تنفيذ آلية تعديل قيم الموافقة.
على سبيل المثال، لضبط كل موافقات المنح على جميع المَعلمات تلقائيًا:
<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />
تعديل الموافقة
لتعديل قيم الموافقة بعد إطلاق التطبيق، يمكنك طلب الطريقة setConsent
.
تلغي القيمة التي تحدّدها طريقة setConsent
الإعداد التلقائي وتستمر في جميع عمليات تنفيذ التطبيقات. وتظل القيمة كما هي حتى
يتم طلب setConsent
مرة أخرى، حتى إذا أغلق المستخدم التطبيق وأعاد فتحه.
لا يعدّل setConsent
سوى المَعلمات التي تحدِّدها.
إذا سحب أحد المستخدمين موافقته السابقة التي قدّمها بشأن "إحصاءات Google" أو "مساحة تخزين الإعلانات"، ستحذف "إحصاءات Google" جميع خصائص المستخدمين، بما في ذلك الموافقة على
ad_personalization
. للحفاظ على خيار موافقة المستخدم المتعلّق بتخصيص الإعلانات، عليك استعادة القيمة السابقة لتخصيص الإعلانات باستخدامsetConsent
(Kotlin+KTX | Java) .
يوضّح المثال التالي طريقة setConsent
التي تعدّل قيم الموافقة المختلفة إلى granted
:
Java
// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);
mFirebaseAnalytics.setConsent(consentMap);
Kotlin
Firebase.analytics.setConsent {
analyticsStorage(ConsentStatus.GRANTED)
adStorage(ConsentStatus.GRANTED)
adUserData(ConsentStatus.GRANTED)
adPersonalization(ConsentStatus.GRANTED)
}