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

يقدم Google 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 (Boolean) إلى إعطاء الأولوية على أي قيم لـ 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 الخاصة بالمستخدم للإعلانات المخصصة باستخدام أي من الخيارات التالية:

قم بتعطيل ميزات الإعلانات المخصصة عبر خاصية المستخدم

واجهة برمجة التطبيقات لوضع الموافقة من Googleهي الطريقة الموصى بها لتمكين الإعلانات المخصصة وتعطيلها.

ومع ذلك، إذا كان تطبيقك لا يستخدم وضع الموافقة حتى الآن، فيمكنك التحكم في التخصيص باستخدام الخيار التالي.

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

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

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