了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

تكوين جمع بيانات Analytics واستخدامها

يقدم 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 file لتطبيقك. تعيين 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(true)

ج موضوعية

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

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

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

انظر تغييرات التكوين الخاصة بك

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