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

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

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

ملاحظة مهمة: في حال ضبط مَعلمة الموافقة على ad_storage أو analytics_storage على "مرفوضة"، إمّا من خلال حالة الموافقة التلقائية أو طريقة setConsent، ستتم إعادة ضبط بيانات الإحصاءات المرتبطة بمثيل تطبيق معيّن نهائيًا من الآن فصاعدًا. على سبيل المثال، إذا تمت إعادة ضبط بيانات الإحصاءات لجميع مثيلات التطبيق، قد يتضخم عدد المستخدمين.

• iOS: يمكنك منع هذه المشكلة من خلال تثبيت الإصدار 10.23.0 أو إصدار أحدث.
• أجهزة Android: تم تحديث الأجهزة التي تتضمّن "خدمات Google Play" تلقائيًا، ولم تعُد هذه الأجهزة عرضة لهذه المشكلة. ما مِن إجراء آخر مطلوب من جانبك.

وإذا كان تطبيقك يعمل على أجهزة لا تتضمن "خدمات Google Play"، ستتمكن من تحديث حزمة تطوير البرامج (SDK) لنظام التشغيل Android في الإصدار 22.0.1 القادم لمنع حدوث هذا السلوك. وحتى ذلك الحين، يمكنك منع حدوث المشكلة على هذه الأجهزة باتّباع الخطوات التالية:

1. لا تضبط قيمًا تلقائية لكلٍّ من ad_storage وanalytics_storage في ملف بيان التطبيق.
2. أوقِف جمع البيانات في "إحصاءات Google" قبل ضبط حالة الموافقة على ad_storage وanalytics_storage في النسخة الافتراضية للتطبيق.
3. بعد الحصول على الموافقة المؤكدة، أعِد تفعيل ميزة جمع البيانات في "إحصاءات Google" لأنّ ذلك لن يؤدي إلى إعادة ضبط بيانات الإحصاءات.

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

وضع الموافقة المتقدّم وضع الموافقة الأساسي

iOS Android

ملاحظة مهمة: تم تعديل "وضع الموافقة" للتطبيقات في 30 تشرين الأول (أكتوبر) 2023، ويحتوي الآن على مَعلمتَين إضافيتَين. إذا سبق لك استخدام "وضع الموافقة"، عليك الترقية إلى الإصدار 2 من "وضع الموافقة". يمكنك الاطّلاع على مزيد من المعلومات عن التعديلات على وضع الموافقة في ما يتعلّق بالزيارات في المنطقة الاقتصادية الأوروبية من Google.

قبل البدء

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

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

• بانر إعدادات الموافقة للحصول على موافقة المستخدم

  ملاحظة: إذا لم تكن تريد تنفيذ إعدادات الموافقة بنفسك، ننصحك باستخدام إحدى "منصّات إدارة الموافقة" (CMP).

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

لإعداد وضع الموافقة، عليك إجراء ما يلي:

1. قبل أن يمنح المستخدم موافقته: أوقِف مجموعة "إحصاءات Google" مؤقتًا.
2. ضبط حالة الموافقة التلقائية
3. عدِّل حالة الموافقة استنادًا إلى تفاعل المستخدم مع إعدادات الموافقة.
4. أعِد تفعيل مجموعة "إحصاءات Google".

إيقاف جمع البيانات في "إحصاءات Google" مؤقتًا

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

لإيقاف جمع البيانات في "إحصاءات Google" مؤقتًا، يجب ضبط القيمة FIREBASE_ANALYTICS_COLLECTION_ENABLED على false (منطقية) في ملف Info.plist لتطبيقك. على سبيل المثال، يتم عرض البيانات في ملف XML المصدر:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

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

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

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

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

   • 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/>

إعادة تفعيل مجموعة "إحصاءات Google"

بعد أن يمنح المستخدم الموافقة، فعِّل جمع البيانات في "إحصاءات Google" مرة أخرى باستخدام طريقة المثيل setAnalyticsCollectionEnabled().

تظل القيمة التي تحدّدها الطريقة setAnalyticsCollectionEnabled في جميع عمليات تنفيذ التطبيق وتلغي قيمة firebase_analytics_collection_enabled في ملف Info.plist الخاص بتطبيقك. بعد ضبط قيمة setAnalyticsCollectionEnabled، تظل مجموعة "إحصاءات Google" على هذه الحالة إلى أن يتم استدعاء setAnalyticsCollectionEnabled مرة أخرى، حتى إذا أغلق المستخدِم تطبيقك وأعاد فتحه.

لتعديل مجموعة "إحصاءات Google":

Swift

swift Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

obj-c [FIRAnalytics setAnalyticsCollectionEnabled:YES];

تعديل الموافقة

لتعديل قيم الموافقة بعد إطلاق تطبيق، عليك طلب طريقة 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,
}];

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

الترقية إلى الإصدار 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.