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

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

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

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,
   }];
   

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

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

اتبع الخطوات التالية:

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

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

   • ad_storage
   • analytics_storage
   • ad_user_data
   • ad_personalization

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

   ad_storage is granted.