ضبط جمع البيانات واستخدامها في "إحصاءات 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/>

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

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

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

إذا كنت بحاجة إلى إيقاف عملية جمع البيانات في &quot;إحصاءات Google&quot; نهائيًا في إصدار من تطبيقك، اضبط قيمة 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 'FirebaseAnalytics' إلى ملف Podfile الخاص بتطبيقك وكنت تريد إيقاف جمع بيانات معرّف المعلِن (IDFA) (وهو معرّف إعلاني خاص بالجهاز) في تطبيق Apple، تأكَّد من عدم تضمين إطار عمل AdSupport في تطبيقك.

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

pod 'FirebaseAnalytics/Core'

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