ضبط جمع البيانات واستخدامها في "إحصاءات Google"

اختيار المنصة: iOS+ Android


تصف هذه الصفحة الميزات التي توفّرها Google Analytics والتي تتيح لك التحكّم في جمع بيانات "إحصاءات Google" واستخدامها.

إيقاف جمع بيانات Analytics

في بعض الحالات، قد تحتاج إلى إيقاف جمع بيانات Analytics مؤقتًا أو نهائيًا، مثلاً لجمع موافقة المستخدم النهائي أو للوفاء بالالتزامات القانونية. يوفّر Google Analytics خيارات متعددة لإيقاف جمع بيانات Analytics. وعند استخدامهما معًا، يتيحان تنفيذ العديد من حالات الاستخدام الشائعة.

إيقاف المجموعة مؤقتًا

إذا أردت إيقاف جمع بيانات Analytics مؤقتًا، مثلاً للحصول على موافقة المستخدم النهائي قبل جمع البيانات، يمكنك ضبط قيمة FIREBASE_ANALYTICS_COLLECTION_ENABLED على NO (قيمة منطقية) في ملف Info.plist الخاص بتطبيقك. على سبيل المثال، عند الاطّلاع على ملف XML المصدر:

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

لإعادة تفعيل عملية جمع البيانات، مثلاً بعد أن يقدّم المستخدم النهائي موافقته، يمكنك استدعاء طريقة مثيل setAnalyticsCollectionEnabled في Analytics. على سبيل المثال:

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

إذا كنت بحاجة إلى تعليق جمع البيانات مرة أخرى لأي سبب، يمكنك استدعاء الدالة التالية وسيتم تعليق جمع البيانات إلى أن تعيد تفعيله.

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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

إيقاف المجموعة نهائيًا

إذا كنت بحاجة إلى إيقاف جمع بيانات "إحصاءات Google" نهائيًا في إصدار من تطبيقك، اضبط FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED على YES (قيمة منطقية) في ملف Info.plist الخاص بتطبيقك. إنّ ضبط FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED على YES (قيمة منطقية) له الأولوية على أي قيم لـ FIREBASE_ANALYTICS_COLLECTION_ENABLED في Info.plist لتطبيقك وأي قيم تم ضبطها باستخدام setAnalyticsCollectionEnabled.

لإعادة تفعيل ميزة جمع البيانات، يجب إزالة "FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED" من "Info.plist". إنّ ضبط FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED على NO (قيمة منطقية) ليس له أي تأثير ويؤدي إلى السلوك نفسه في حال عدم ضبط FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED في ملف Info.plist.

إيقاف جمع معرّف المعلِنين (IDFA)

إذا ثبّتّ وحدة FirebaseAnalytics في تطبيقك من خلال SPM أو CocoaPods وأردت إيقاف جمع معرّف المعلِنين (معرّف الإعلانات الخاص بالجهاز) في تطبيق Apple، تأكَّد من عدم تضمين إطار عمل AdSupport في تطبيقك.

لتثبيت Firebase بدون أي إمكانية لجمع معرّفات المعلِنين، استخدِم ما يلي بدلاً من تبعية FirebaseAnalytics:

Swift Package Manager

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

مزيد من المعلومات حول معرّف المعلِنين (IDFA) في مستندات Apple:

إيقاف جمع معرّفات IDFV

إذا أردت إيقاف جمع معرّف المورّد (IDFV) في تطبيقك على Apple، اضبط قيمة GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED على NO (قيمة منطقية) في ملف Info.plist الخاص بتطبيقك.

التحكّم في جمع البيانات للإعلانات المخصّصة

إذا ربطت مشروعك على "Google Analytics" بحساب إعلانات أو فعّلت عملية دمج مع الإعلانات أو فعّلت ميزة مشاركة البيانات، قد تكون بياناتك على "إحصاءات Google" مؤهَّلة للاستخدام في الإعلانات المخصّصة. يعني ذلك مثلاً أنّه يمكنك استخدام الأحداث التي تم جمعها، مثل first_open، لإنشاء قوائم مستخدمين ونشرها من أجل تجديد النشاط التسويقي، ما لم تشر إلى أنّ هذه البيانات غير متاحة للإعلانات المخصّصة.

يمكنك التحكّم آليًا في ما إذا كان يجب استخدام بيانات "إحصاءات Google" الخاصة بالمستخدم للإعلانات المخصّصة باستخدام أيّ من الخيارات التالية:

إيقاف ميزات الإعلانات المخصّصة من خلال سمة مستخدم

واجهة برمجة التطبيقات لوضع الموافقة من Google هي الطريقة المقترَحة لتفعيل الإعلانات المخصّصة وإيقافها.

ومع ذلك، إذا كان تطبيقك لا يستخدم "وضع الموافقة" بعد، يمكنك التحكّم في التخصيص باستخدام الخيار التالي.

لإيقاف سلوك الإعلانات المخصّصة تلقائيًا، اضبط قيمة GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS على NO (قيمة منطقية) في ملف Info.plist لتطبيقك.

إعادة تفعيل ميزات الإعلانات المخصّصة من خلال خاصية مستخدم

إذا كنت تستخدم المَعلمة AnalyticsUserPropertyAllowAdPersonalizationSignals للتحكّم في تخصيص الإعلانات، يمكنك إعادة تفعيل تخصيص الإعلانات باستخدام الطريقة setUserProperty كما هو موضّح أدناه:

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

إذا اخترت إيقاف جمع الإحصاءات مؤقتًا (على سبيل المثال، إلى أن يقدّم المستخدم النهائي موافقته)، وأردت التحكّم في ميزات الإعلانات المخصّصة عند إعادة تفعيل جمع الإحصاءات لمستخدم معيّن، تأكّد من أنّ طلبك لتحديد هذا الإعداد يسبق طلبك لإعادة تفعيل جمع الإحصاءات. على سبيل المثال:

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل watchOS المستهدَف.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

تأكيد إعداداتك

عند إيقاف إشارات تخصيص الإعلانات لمستخدم معيّن من خلال إحدى الآليات المحدّدة أعلاه، ستحتوي حِزم الأحداث اللاحقة التي تم تسجيلها من جهاز ذلك المستخدم على سمة مستخدم باسم non_personalized_ads بقيمة 1 للإشارة إلى أنّ الأحداث في هذه الحزمة غير متاحة للإعلانات المخصّصة. لا يؤثّر إيقاف الإعلانات المخصّصة في استخدام البيانات لأغراض القياس، بما في ذلك إعداد التقارير وتحديد المصدر.

الاطّلاع على التغييرات في الإعدادات

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