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


تصف هذه الصفحة الميزات التي يقدمها Google Analytics والتي تتيح بالتحكّم في جمع بيانات "إحصاءات 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)

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