إعداد وضع الموافقة للتطبيقات

هذه الصفحة مخصّصة للمطوّرين الذين يستخدمون حزمة تطوير البرامج (SDK) الخاصة بخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقاتهم ويريدون دمج ميزة "وضع الموافقة". للحصول على مقدّمة عن "وضع الموافقة"، اطّلِع على نظرة عامة حول "وضع الموافقة".

توفّر "إحصاءات Google" ميزة "وضع الموافقة" لتعديل سلوك حزمة تطوير البرامج (SDK) استنادًا إلى حالة الموافقة للمستخدمين. يمكنك تنفيذ "وضع الموافقة" بطريقة أساسية أو متقدّمة. إذا لم تكن متأكّدًا من استخدام "وضع الموافقة" الأساسي أو المتقدّم، يمكنك الاطّلاع على مزيد من المعلومات عن الفرق بين "وضع الموافقة" الأساسي والمتقدّم والتحقّق من إرشادات شركتك.

قبل البدء

قبل أن تتمكّن من إدارة موافقة المستخدم، عليك تنفيذ ما يلي:

• حزمة تطوير البرامج (SDK) في "إحصاءات Google لبرنامج Firebase"

• بانر إعدادات الموافقة لتسجيل موافقة المستخدم

إعداد وضع الموافقة

لإعداد "وضع الموافقة"، عليك اتّباع الخطوات التالية:

1. ضبط حالة الموافقة التلقائية

ضبط حالة الموافقة التلقائية

لا يتمّ ضبط أيّ قيم لوضع الموافقة تلقائيًا. لضبط حالة الموافقة التلقائية لتطبيقك، اتّبِع الخطوات التالية:

1. افتح ملف info.plist الخاص بتطبيقك.

2. أضِف أزواج المفتاح/القيمة في "وضع الموافقة". يصف المفتاح نوع الموافقة، وتشير القيمة إلى حالة الموافقة. يمكن أن تكون القيم true، ما يعني أنّه تم منح الموافقة، أو false، ما يعني أنّه تم رفض الموافقة.

   وفقًا للتعديلات على "وضع الموافقة" في ما يتعلّق بالزيارات في المنطقة الاقتصادية الأوروبية، يمكن ضبط القيمة 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

3. احفظ التغييرات. بعد ذلك، نفِّذ الآلية اللازمة لتعديل قيم الموافقة.

على سبيل المثال، لضبط الموافقة على جميع المَعلمات تلقائيًا:

<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"، ستحذف "إحصاءات Google" جميع سمات المستخدم، بما في ذلك الموافقة على ad_personalization. للحفاظ على خيار موافقة المستخدم على تخصيص الإعلانات، عليك استعادة القيمة السابقة لتخصيص الإعلانات باستخدام setConsent (Swift | Obj-C) .

يوضّح المثال التالي طريقة تعديل القيم المختلفة للموافقة إلى granted باستخدام الطريقة setConsent:

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

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

الترقية إلى الإصدار 2 من "وضع الموافقة"

في إطار التزام Google المستمر بتوفير منظومة متكاملة للإعلانات الرقمية تحافظ على الخصوصية، نعمل على تنفيذ سياسة موافقة المستخدم في الاتحاد الأوروبي بشكل أكثر صرامة.

مزيد من المعلومات عن التعديلات التي أجرتها Google على "وضع الموافقة" في ما يتعلّق بعدد الزيارات في المنطقة الاقتصادية الأوروبية

على مستخدمي "وضع الموافقة" إرسال مَعلمتَين جديدتَين بالإضافة إلى مَعلمتَي تخزين الإعلانات وتخزين الإحصاءات:

1. عدِّل ملف info.plist الخاص بتطبيقك ليتضمّن ما يلي:

   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
   

2. عدِّل طلبات الموافقة لتضمين مَعلمتَي بيانات المستخدمين الإعلانية وتخصيص الإعلانات:

   Swift

   Analytics.setConsent([
   .analyticsStorage: .granted,
   .adStorage: .granted,
   .adUserData: .granted,
   .adPersonalization: .granted,
   ])
   

   Objective-C

   [FIRAnalytics setConsent:@{
     FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdUserData : FIRConsentStatusGranted,
     FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
   }];
   

التحقّق من إعدادات الموافقة

يمكنك التأكّد من أنّ إعدادات الموافقة تعمل على النحو المطلوب من خلال عرض وحدة تصحيح Xcode لتطبيقك.

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

1. فعِّل التسجيل المطوَّل على جهازك.

2. في وحدة تصحيح الأخطاء في Xcode، ابحث عن:

   • ad_storage
   • analytics_storage
   • ad_user_data
   • ad_personalization

   على سبيل المثال، إذا كانت ميزة "تخزين الإعلانات" مفعّلة، ستظهر لك الرسالة التالية:

   ad_storage is granted.