ضبط جمع البيانات واستخدامها في "إحصاءات 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 وأردت إيقاف جمع معرّف المعلِنين (IDFA) (معرّف إعلاني للجهاز) في تطبيق Apple، تأكَّد من عدم تضمين إطار عمل AdSupport في تطبيقك.

لتثبيت Firebase بدون أي إمكانية لجمع معرّف المعلِنين (IDFA)، استخدِم ما يلي بدلاً من الاعتمادية 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);

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

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، قد يستغرق نشرها في تطبيقك بضع دقائق. إذا كان تطبيقك متاحًا، قد تستغرق عملية النشر الكاملة ما يصل إلى ساعة واحدة.