ضبط جمع البيانات واستخدامها في "إحصاءات Google"

اختيار النظام الأساسي: 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 على true في ملف 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 هي الطريقة المقترَحة لتفعيل الإعلانات المخصّصة وإيقافها.

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

لإيقاف سلوك الإعلانات المخصّصة تلقائيًا، حدِّد الحقل التالي في 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);

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

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