توضّح هذه الصفحة الميزات التي يقدّمها "إحصاءات Google" والتي تسمح لك بالتحكّم في جمع بيانات "إحصاءات Google" واستخدامها.
إيقاف جمع البيانات في "إحصاءات Google"
في بعض الحالات، قد تريد إيقاف جمع بيانات "إحصاءات Google" مؤقتًا أو نهائيًا، مثل جمع موافقات المستخدمين النهائيين أو الوفاء بالتزامات قانونية. توفِّر "إحصاءات Google" خيارات متعدّدة لإيقاف ميزة جمع البيانات في "إحصاءات Google" وإيقافها. وعند استخدامها معًا، تدعم العديد من حالات الاستخدام النموذجية.
إيقاف جمع البيانات مؤقتًا
إذا كنت تريد إيقاف جمع البيانات على "إحصاءات Google" مؤقتًا، مثل الحصول على
موافقة المستخدِم النهائي قبل جمع البيانات، يمكنك ضبط قيمة
FIREBASE_ANALYTICS_COLLECTION_ENABLED
على NO
(منطقية) في ملف
Info.plist
الخاص بتطبيقك. على سبيل المثال، يتم عرضه في ملف XML المصدر:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
لإعادة تفعيل عملية الجمع، مثلاً بعد أن يقدّم المستخدم النهائي موافقته، يمكنك طلب طريقة المثيل Analytics
setAnalyticsCollectionEnabled
. على سبيل المثال:
Swift
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
إذا كنت بحاجة إلى تعليق عملية الجمع مرة أخرى لأي سبب، فيمكنك طلب ما يلي، وسيتم تعليق عملية الجمع إلى أن تُعيد تفعيلها.
Swift
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
تظل القيمة التي حدّدتها طريقة setAnalyticsCollectionEnabled
سارية في جميع
عمليات تنفيذ التطبيقات وتلغي قيمة FIREBASE_ANALYTICS_COLLECTION_ENABLED
في ملف Info.plist
لتطبيقك. بعد ضبط قيمة
setAnalyticsCollectionEnabled
، تظل مجموعة "إحصاءات Google" كما هي
إلى أن يتم طلب setAnalyticsCollectionEnabled
مرة أخرى، حتى إذا أغلق المستخدم تطبيقك
وأعاد فتحه.
إيقاف مجموعة المختارات نهائيًا
إذا كنت تريد إيقاف جمع البيانات في "إحصاءات Google" نهائيًا في إصدار من تطبيقك،
عليك ضبط 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" بحساب على "إعلانات Google" أو
إذا كنت قد فعَّلت دمج الإعلانات أو فعَّلت ميزة مشاركة البيانات
قد تكون بياناتك في "إحصاءات Google" مؤهَّلة للاستخدام في الإعلانات المخصّصة.
وهذا يعني على سبيل المثال أنه يمكنك استخدام الأحداث المجمّعة مثل first_open
لإنشاء
قوائم المستخدمين ونشرها لتجديد النشاط التسويقي ما لم تشير إلى أنّ هذه البيانات غير متوفرة للإعلانات المخصّصة.
يمكنك التحكّم آليًا في ما إذا كان يجب استخدام بيانات "إحصاءات Google" للمستخدم لأغراض الإعلانات المخصّصة باستخدام أي من الخيارات التالية:
إجراء مقترَح: يمكنك تفعيل خيار تخصيص الإعلانات أو إيقافه ديناميكيًا من خلال الالتزام بخيار الموافقة الذي اختاره المستخدم. تنفيذ واجهة برمجة تطبيقات ميزة "وضع الموافقة" من Google
تفعيل خيار تخصيص الإعلانات أو إيقافه على مستوى المستخدم: التحكّم في تخصيص الإعلانات كخاصّية مستخدِم
تفعيل تخصيص الإعلانات أو إيقافه على مستوى موقع "إحصاءات Google": إيقاف تخصيص الإعلانات لكل منطقة جغرافية في موقع "إحصاءات Google".
إيقاف الميزات الإعلانية المخصّصة من خلال خاصيّة مستخدِم
واجهة برمجة تطبيقات ميزة "وضع الموافقة" من Google هي الطريقة التي يُنصح بها لتفعيل الإعلانات المخصّصة وإيقافها.ومع ذلك، إذا لم يكن تطبيقك يستخدم "وضع الموافقة" بعد، يمكنك التحكّم في التخصيص باستخدام الخيار التالي.
لإيقاف السلوك الإعلاني المخصّص تلقائيًا، عليك ضبط قيمة
GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
على NO
(منطقية)
في ملف Info.plist
الخاص بتطبيقك.
إعادة تفعيل الميزات الإعلانية المخصّصة عبر خاصيّة مستخدِم
إذا كنت تستخدم المَعلمة AnalyticsUserPropertyAllowAdPersonalizationSignals
للتحكّم في تخصيص الإعلانات، يمكنك إعادة تفعيل تخصيص الإعلانات باستخدام الطريقة
setUserProperty
كما هو موضّح أدناه:
Swift
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
إذا اخترت إيقاف جمع الإحصاءات مؤقتًا (على سبيل المثال، إلى أن يمنح المستخدم النهائي موافقته)، وأردت التحكّم في الميزات الإعلانية المخصّصة عند إعادة تفعيل جمع الإحصاءات لأحد المستخدمين، تأكَّد من أنّ طلبك لتحديد هذا الإعداد يسبق طلبك لإعادة تفعيل جمع الإحصاءات. على سبيل المثال:
Swift
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
تأكيد إعداداتك
عند إيقاف إشارات تخصيص الإعلانات لمستخدم من خلال إحدى الآليات المحدّدة أعلاه، ستحتوي حِزم الأحداث اللاحقة المسجّلة من جهاز ذلك المستخدم على خاصيّة مستخدِم باسم non_personalized_ads
مع القيمة 1 للإشارة إلى أنّ الأحداث في تلك الحزمة غير متاحة للإعلانات المخصّصة. لا يؤثر إيقاف الإعلانات المخصّصة في استخدام
البيانات لأغراض القياس، بما في ذلك إعداد التقارير وتحديد المصدر.
الاطّلاع على تغييرات الضبط
بعد إجراء تغييرات على إعدادات "إحصاءات Google"، تعمل حزمة تطوير البرامج (SDK) على تنزيل التغييرات. هذه العملية سريعة وسلسة، لذا يمكنك اختبار التغييرات بسرعة. عند إجراء تغييرات في "إحصاءات Google"، قد يستغرق نشر التطبيق في تطبيقك بضع دقائق. وإذا كان تطبيقك معروضًا، قد يستغرق اكتمال عملية النشر الكاملة مدة تصل إلى ساعة.