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

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

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

قبل البدء

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

لإعداد "وضع الموافقة"، عليك:

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

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

  1. افتح ملف info.plist الخاص بتطبيقك.
  2. أضِف أزواج المفتاح/القيمة لميزة "وضع الموافقة". يصف المفتاح نوع الموافقة وتشير القيمة إلى حالة الموافقة. يمكن أن تكون القيم 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
  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:

Swift

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

Objective-C

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

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

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

اطّلِع على مزيد من المعلومات عن التعديلات التي تُجريها 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.