| اختيار المنصة: | iOS+ Android |
تصف هذه الصفحة الميزات التي توفّرها Google Analytics والتي تتيح لك التحكّم في جمع بيانات "إحصاءات Google" واستخدامها.
إيقاف جمع بيانات Analytics
في بعض الحالات، قد تحتاج إلى إيقاف جمع بيانات Analytics مؤقتًا أو نهائيًا، مثلاً للحصول على موافقة المستخدِم النهائي أو للوفاء بالالتزامات القانونية. Google Analytics توفّر خيارات متعدّدة لإيقاف جمع البيانات وإلغاء تفعيله Analytics. عند استخدامها معًا، تتيح هذه الخيارات التعامل مع العديد من حالات الاستخدام النموذجية.
إيقاف الجمع مؤقتًا
إذا أردت إيقاف جمع بيانات Analytics مؤقتًا، مثلاً للحصول على
موافقة المستخدِم النهائي قبل جمع البيانات، يمكنك ضبط قيمة
firebase_analytics_collection_enabled على false في ملف
AndroidManifest.xml الخاص بتطبيقك ضمن العلامة application. على سبيل المثال:
<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />
لإعادة تفعيل الجمع، مثلاً بعد أن يقدّم المستخدِم النهائي موافقته، استخدِم الـ
setAnalyticsCollectionEnabled()
لطريقة الفئة FirebaseAnalytics. على سبيل المثال:
Kotlin
setAnalyticsCollectionEnabled(true);
Java
setAnalyticsCollectionEnabled(true);
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
إذا كنت بحاجة إلى تعليق الجمع مرة أخرى لأي سبب، يمكنك استخدام الأمر التالي وسيتم تعليق الجمع إلى أن تعيد تفعيله.
Kotlin
setAnalyticsCollectionEnabled(false);
Java
setAnalyticsCollectionEnabled(false);
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
إيقاف الجمع نهائيًا
إذا كنت بحاجة إلى إيقاف جمع بيانات Analytics نهائيًا في إصدار من
تطبيقك، اضبط firebase_analytics_collection_deactivated على "صحيح" في ملف AndroidManifest.xml الخاص بتطبيقك ضمن العلامة application. على سبيل المثال:
<meta-data android:name="firebase_analytics_collection_deactivated" android:value="true" />
إيقاف جمع "المعرّف الإعلاني"
إذا أردت إيقاف جمع
المعرّف الإعلاني
في تطبيق Android، يمكنك ضبط قيمة
google_analytics_adid_collection_enabled على false في ملف
AndroidManifest.xml الخاص بتطبيقك ضمن العلامة application. على سبيل المثال:
<meta-data android:name="google_analytics_adid_collection_enabled" android:value="false" />
التحكّم في جمع البيانات للإعلانات المخصّصة
إذا ربطت مشروعك على Google Analytics بحساب إعلاني أو
فعّلت عملية دمج إعلاني بطريقة أخرى، أو وافقت على
مشاركة البيانات،
قد تصبح بياناتك في "إحصاءات Google" مؤهّلة للاستخدام في الإعلانات المخصّصة.
يعني ذلك مثلاً أنّه يمكنك استخدام الأحداث التي تم جمعها، مثل first_open، لإنشاء قوائم جمهور ونشرها لأغراض تجديد النشاط التسويقي ما لم تُشِر إلى أنّ هذه البيانات غير متاحة للإعلانات المخصّصة.
يمكنك التحكّم آليًا في ما إذا كان يجب استخدام بيانات المستخدم في "إحصاءات Google" للإعلانات المخصّصة باستخدام أي من الخيارات التالية:
الخيار المقترَح: تفعيل تخصيص الإعلانات أو إيقافه ديناميكيًا من خلال مراعاة خيار موافقة المستخدم. يمكنك تنفيذ واجهة برمجة تطبيقات "وضع الموافقة" من Google.
تفعيل تخصيص الإعلانات أو إيقافه على مستوى المستخدم: يمكنك التحكّم في تخصيص الإعلانات كخاصية مستخدِم.
تفعيل تخصيص الإعلانات أو إيقافه على مستوى موقع "إحصاءات Google": يمكنك إيقاف تخصيص الإعلانات لكل منطقة جغرافية في موقعك على "إحصاءات Google".
إيقاف ميزات الإعلانات المخصّصة باستخدام خاصية مستخدِم
واجهة برمجة تطبيقات "وضع الموافقة" من Google هي الطريقة المقترَحة لتفعيل الإعلانات المخصّصة وإيقافها.
ومع ذلك، إذا كان تطبيقك لا يستخدم "وضع الموافقة" بعد، يمكنك التحكّم في التخصيص باستخدام الخيار التالي.
لإيقاف سلوك الإعلانات المخصّصة تلقائيًا، حدِّد الحقل التالي في ملف AndroidManifest.xml الخاص بتطبيقك ضمن العلامة application:
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="false" />
إعادة تفعيل ميزات الإعلانات المخصّصة من خلال خاصية مستخدِم
إذا كنت تستخدم المَعلمة google_analytics_default_allow_ad_personalization_signals
للتحكّم في تخصيص الإعلانات، يمكنك إعادة تفعيل تخصيص الإعلانات
باستخدام طريقة setUserProperty
كما هو موضّح أدناه:
Kotlin
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );
Java
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
إذا اخترت إيقاف جمع بيانات "إحصاءات Google" مؤقتًا (مثلاً إلى أن يقدّم المستخدِم النهائي موافقته)، وأردت التحكّم في ميزات الإعلانات المخصّصة عند إعادة تفعيل جمع بيانات "إحصاءات Google" لمستخدِم، تأكَّد من أنّ طلبك لتحديد هذا الإعداد يسبق طلبك لإعادة تفعيل جمع بيانات "إحصاءات Google". على سبيل المثال:
Kotlin
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);
Java
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
تأكيد إعداداتك
عند إيقاف إشارات تخصيص الإعلانات لمستخدِم من خلال إحدى الآليات المحدّدة أعلاه، ستحتوي حِزم الأحداث اللاحقة التي يتم تسجيلها من جهاز هذا المستخدِم على خاصية مستخدِم باسم non_personalized_ads بقيمة 1 للإشارة إلى أنّ الأحداث في تلك الحزمة غير متاحة للإعلانات المخصّصة. لا يؤثر إيقاف الإعلانات المخصّصة على استخدام البيانات لأغراض القياس، بما في ذلك إعداد التقارير والإحالة.
الاطّلاع على تغييرات الإعدادات
بعد إجراء تغييرات على إعدادات Google Analytics، تنزِّل حزمة SDK التغييرات. تكون العملية سريعة وسلسة، لذا يمكنك اختبار تغييراتك بسرعة. عند إجراء تغييرات في Analytics، قد يستغرق نشرها في تطبيقك بضع دقائق. وإذا كان تطبيقك متاحًا، قد تستغرق عملية النشر الكاملة ساعة واحدة كحد أقصى.