Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

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

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

سويفت

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

ج موضوعية

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

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

سويفت

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

ج موضوعية

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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

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

إذا كنت بحاجة إلى إيقاف جمع تحليلات بشكل دائم في إصدار التطبيق الخاص بك، تعيين 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 (معرف الإعلان عن الجهاز) في التطبيق أبل الخاص بك، تأكد من أن الإطار AdSupport لم يتم تضمين في التطبيق الخاص بك.

لتثبيت Firebase دون أي قدرة جمع IDFA، استخدم subspec التالية في مكان pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

تعرف على المزيد حول IDFA في وثائق Apple:

تعطيل مجموعة IDFV

إذا كنت ترغب في تعطيل جمع IDFV (معرف للبائع) في التطبيق أبل الخاص بك، قم بتعيين قيمة 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 تحليلات "الملكية.

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

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

سويفت

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

ج موضوعية

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

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

سويفت

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

ج موضوعية

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

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

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