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



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

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

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

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

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

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

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

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على نظام التشغيل macOS. 
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 (Boolean) إلى أي تأثير ويؤدي إلى السلوك نفسه الذي يحدث في حال عدم ضبط FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED في ملف Info.plist.

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

إذا ثبّتْت Firebase من خلال CocoaPods عن طريق إضافة pod 'Firebase/Analytics' إلى Podfile في تطبيقك وأردت إيقاف جمع معرّف IDFA (معرّف الإعلان للجهاز) في تطبيقك على Apple، تأكّد من عدم تضمين إطار عمل AdSupport في تطبيقك.

لتثبيت Firebase بدون أي إمكانية لجمع معرّف المعلِنين (IDFA)، استخدِم الإصدار الفرعي التالي بدلاً من pod 'Firebase/Analytics':

pod 'Firebase/AnalyticsWithoutAdIdSupport'

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

إيقاف جمع معرّف الجهاز الفريد

إذا أردت إيقاف جمع معرّف 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 هذا على نظام التشغيل macOS. 
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

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

Unity

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

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

Swift

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

Objective-C

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