هذه الصفحة مخصّصة للمطوّرين الذين يستخدِمون حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقاتهم ويريدون دمج "وضع الموافقة". للاطّلاع على مقدمة عن "وضع الموافقة"، يُرجى الاطّلاع على نظرة عامة على "وضع الموافقة".
توفّر "إحصاءات Google" ميزة "وضع الموافقة" لتعديل سلوك حزمة تطوير البرامج (SDK) استنادًا إلى حالة الموافقة للمستخدمين. يمكنك تنفيذ "وضع الموافقة" بطريقة أساسية أو متقدّمة إذا لم تكن متأكّدًا من تطبيق "وضع الموافقة" الأساسي أو المتقدّم، اطّلِع على مزيد من المعلومات حول وضع الموافقة الأساسي مقارنةً بوضع الموافقة المتقدّم وراجع إرشادات شركتك.
قبل البدء
قبل أن تتمكّن من إدارة موافقة المستخدمين، عليك تنفيذ ما يلي:
- حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase"
بانر إعدادات الموافقة للحصول على موافقة المستخدم
إعداد وضع الموافقة
لإعداد "وضع الموافقة"، عليك:
ضبط حالة الموافقة التلقائية
لا يتم ضبط قيم "وضع الموافقة" تلقائيًا. لضبط حالة الموافقة التلقائية لتطبيقك:
- افتح ملف info.plist الخاص بتطبيقك.
أضِف أزواج المفتاح/القيمة لميزة "وضع الموافقة". يصف المفتاح نوع الموافقة وتشير القيمة إلى حالة الموافقة. يمكن أن تكون القيم
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
احفظ التغييرات. بعد ذلك، يجب تنفيذ آلية تعديل قيم الموافقة.
على سبيل المثال، لضبط كل موافقات المنح على جميع المَعلمات تلقائيًا:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
تعديل الموافقة
لتعديل قيم الموافقة بعد إطلاق التطبيق، يمكنك طلب الطريقة setConsent
.
تلغي القيمة التي تحدّدها طريقة setConsent
الإعداد التلقائي وتستمر في جميع عمليات تنفيذ التطبيقات. وتظل القيمة كما هي حتى
يتم طلب setConsent
مرة أخرى، حتى إذا أغلق المستخدم التطبيق وأعاد فتحه.
لا يعدّل setConsent
سوى المَعلمات التي تحدِّدها.
إذا سحب أحد المستخدمين موافقته السابقة التي قدّمها بشأن "إحصاءات Google" أو "مساحة تخزين الإعلانات"، ستحذف "إحصاءات Google" جميع خصائص المستخدمين، بما في ذلك الموافقة على
ad_personalization
. للحفاظ على خيار موافقة المستخدم المتعلّق بتخصيص الإعلانات، عليك استعادة القيمة السابقة لتخصيص الإعلانات باستخدامsetConsent
(Swift | Obj-C) .
يوضّح المثال التالي طريقة setConsent
التي تعدّل قيم الموافقة المختلفة إلى granted
:
Swift
Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])
Objective-C
[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];
إذا قرّر أحد المستخدمين إبطال موافقته، احرص على تعديل حالات الموافقة وفقًا لذلك
الترقية إلى الإصدار 2 من "وضع الموافقة"
في إطار التزام Google المستمرّ بتوفير منظومة متكاملة للإعلانات الرقمية مصمّمة بالتوافق مع معايير الخصوصية، نعمل على تنفيذ سياسة موافقة المستخدم في الاتحاد الأوروبي بشكل أكثر صرامة.
اطّلِع على مزيد من المعلومات عن التعديلات التي تُجريها Google على وضع الموافقة في ما يتعلّق بالزيارات في المنطقة الاقتصادية الأوروبية.
على مستخدمي "وضع الموافقة" إرسال مَعلمتَين جديدتَين بالإضافة إلى مساحة تخزين الإعلانات ومساحة التخزين في "إحصاءات Google":
عدِّل ملف Info.plist لتطبيقك لتضمين ما يلي:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
يمكنك تعديل طلبات الموافقة لتشمل المَعلمات لبيانات مستخدمي الإعلانات وتخصيص الإعلانات:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
التحقّق من إعدادات الموافقة
يمكنك التحقّق من عمل إعدادات الموافقة على النحو المنشود من خلال عرض وحدة تصحيح أخطاء Xcode الخاصة بتطبيقك.
يُرجى اتّباع الخطوات التالية:
- فعِّل التسجيل المطوَّل على جهازك.
في وحدة تحكم تصحيح الأخطاء في Xcode، ابحث عن:
ad_storage
analytics_storage
ad_user_data
ad_personalization
على سبيل المثال، إذا كانت مساحة تخزين الإعلانات مفعّلة، ستظهر لك الرسالة التالية:
ad_storage is granted.