يقدم 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
. على سبيل المثال:
سويفت
Analytics.setAnalyticsCollectionEnabled(true)
ج موضوعية
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
إذا كنت بحاجة إلى تعليق التحصيل مرة أخرى لأي سبب من الأسباب، يمكنك الاتصال
سويفت
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
(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 الخاصة بالمستخدم للإعلانات المخصصة، قم بتعيين السلوك الافتراضي المناسب في ملف AndroidManifest.xml الخاص بالتطبيق، ثم استخدم الطرق الموضحة أدناه لتجاوز هذا السلوك الافتراضي.
لتعيين السلوك الإعلاني المخصص الافتراضي، قم بتعيين قيمة GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
على NO
(منطقية) في ملف Info.plist
الخاص بتطبيقك.
يمكنك أيضًا التحكم في إمكانية استخدام البيانات التي تم جمعها من المستخدمين النهائيين لتخصيص الإعلانات عبر إعداد تخصيص الإعلانات ، الموجود في إعدادات خاصية Google Analytics.
أعد تمكين ميزات الإعلانات المخصصة
لإعادة تمكين ميزات الإعلان المخصصة لمستخدم في وقت التشغيل، مثل بعد تقديم المستخدم النهائي للموافقة، استخدم طريقة setUserProperty
كما هو موضح أدناه:
سويفت
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
ج موضوعية
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
إذا اخترت تعطيل جمع التحليلات مؤقتًا (على سبيل المثال، حتى يقدم المستخدم النهائي الموافقة)، وتريد التحكم في ميزات الإعلانات المخصصة عند إعادة تمكين جمع التحليلات لمستخدم ما، فتأكد من أن مكالمتك لتحديد هذا الإعداد تسبق اتصالك دعوة لإعادة تمكين جمع التحليلات. على سبيل المثال:
سويفت
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
ج موضوعية
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
قم بتأكيد إعداداتك
عندما يتم تعطيل إشارات تخصيص الإعلانات لمستخدم عبر إحدى الآليات المحددة أعلاه، فإن حزم الأحداث اللاحقة المسجلة من جهاز ذلك المستخدم ستحتوي على خاصية مستخدم تسمى non_personalized_ads
بقيمة 1 للإشارة إلى أن الأحداث في تلك الحزمة غير متاحة للتخصيص دعاية. لا يؤثر تعطيل الإعلانات المخصصة على استخدام البيانات لأغراض القياس، بما في ذلك إعداد التقارير والإسناد.
انظر تغييرات التكوين الخاصة بك
بمجرد إجراء تغييرات على إعدادات Google Analytics، تقوم حزمة SDK بتنزيل التغييرات. العملية سريعة وسلسة، لذا يمكنك اختبار تغييراتك بسرعة. عند إجراء تغييرات في Analytics، قد يستغرق نشرها في تطبيقك بضع دقائق. إذا كان تطبيقك نشطًا، فقد تستغرق عملية النشر الكاملة ما يصل إلى ساعة واحدة حتى تكتمل.