Check out what’s new from Firebase at Google I/O 2022. Learn more

تكوين جمع البيانات التحليلية واستخدامها

يقدم Google Analytics ميزات تسمح لك بالتحكم في جمع واستخدام بيانات Analytics.

تعطيل جمع بيانات Analytics

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

قم بتعطيل المجموعة مؤقتًا

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

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

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

سويفت

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

ج موضوعية

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

إذا كنت بحاجة إلى تعليق المجموعة مرة أخرى لأي سبب ، يمكنك الاتصال

سويفت

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

ج موضوعية

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

ويتم تعليق المجموعة حتى تقوم بإعادة تمكينها. تستمر القيمة التي تم تعيينها بواسطة طريقة setAnalyticsCollectionEnabled عبر عمليات تنفيذ التطبيق وتتجاوز قيمة FIREBASE_ANALYTICS_COLLECTION_ENABLED في ملف Info.plist لتطبيقك. بمجرد تعيين قيمة لـ setAnalyticsCollectionEnabled ، تظل مجموعة Analytics في تلك الحالة حتى يتم استدعاء setAnalyticsCollectionEnabled مرة أخرى ، حتى إذا أغلق المستخدم تطبيقك وأعاد فتحه.

قم بإلغاء تنشيط المجموعة بشكل دائم

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

للتحكم برمجيًا في ما إذا كان يجب استخدام بيانات Analytics للمستخدم للإعلان المخصص ، عيّن السلوك الافتراضي المناسب في ملف AndroidManifest.xml للتطبيق ، ثم استخدم الطرق الموضحة أدناه لتجاوز هذا السلوك الافتراضي.

لتعيين سلوك الإعلان المخصص الافتراضي ، عيّن قيمة GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS على NO (منطقي) في ملف Info.plist لتطبيقك.

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

أعد تمكين الميزات الإعلانية المخصصة

لإعادة تمكين ميزات الإعلان المخصصة للمستخدم في وقت التشغيل ، مثل بعد أن يقدم المستخدم النهائي الموافقة ، استخدم طريقة setUserProperty كما هو موضح أدناه:

سويفت

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

ج موضوعية

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

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

سويفت

ملاحظة: لا يتوفر منتج Firebase هذا على هدف macOS.
Analytics.setUserProperty (...، forName: AnalyticsUserPropertyAllowAdPersonalizationSignals) Analytics.setAnalyticsCollectionEnabled (صحيح)

ج موضوعية

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

تأكيد الإعدادات الخاصة بك

عندما يتم تعطيل إشارات تخصيص الإعلانات للمستخدم عبر إحدى الآليات المحددة أعلاه ، ستحتوي حزم الأحداث اللاحقة التي تم تسجيلها من جهاز هذا المستخدم على خاصية مستخدم تسمى "non_personalized_ads" بقيمة 1 للإشارة إلى أن الأحداث في تلك الحزمة غير متاحة للإعلان المخصص. لا يؤثر تعطيل الإعلانات المخصصة على استخدام البيانات لأغراض القياس ، بما في ذلك إعداد التقارير والإسناد.