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


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

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

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

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

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

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

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

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