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


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

إيقاف جمع البيانات في "إحصاءات Google"

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

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

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

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

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

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 (منطقي) ليس له أي تأثير، وسيؤدّي إلى السلوك نفسه الذي يحدث به عدم ضبط 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" بحساب إعلاني أو فعّلت عملية دمج إعلانات بطريقة أخرى، أو فعَّلت خيار مشاركة البيانات، قد تكون بياناتك على "إحصاءات 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"، يتم تنزيل التغييرات في حزمة تطوير البرامج (SDK). هذه العملية سريعة وسلسة، بحيث يمكنك اختبار التغييرات التي أجريتها بسرعة. عند إجراء تغييرات في "إحصاءات Google"، قد يستغرق النشر في تطبيقك بضع دقائق. وفي حال نشر تطبيقك، قد تستغرق عملية النشر الكاملة ما يصل إلى ساعة واحدة حتى تكتمل.