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

توضّح هذه الصفحة الميزات التي يوفّرها 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. على سبيل المثال:

KotlinJavaUnity

setAnalyticsCollectionEnabled(true);

setAnalyticsCollectionEnabled(true);

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

إذا كنت بحاجة إلى تعليق المجموعة مرة أخرى لأي سبب، يمكنك الاتصال بالرقم التالي: وسيتم تعليق المجموعة إلى أن تعيد تفعيلها.

KotlinJavaUnity

setAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled(false);

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
تفعيل تخصيص الإعلانات أو إيقافه على مستوى المستخدِم: التحكّم في تخصيص الإعلانات كخاصيّة مستخدِم
تفعيل تخصيص الإعلانات أو إيقافه على مستوى موقع "إحصاءات Google": إيقاف تخصيص الإعلانات حسب المنطقة الجغرافية في موقعك على "إحصاءات Google"

إيقاف ميزات الإعلانات المخصّصة من خلال خاصيّة مستخدِم

Consent API من 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 على النحو الموضّح أدناه:

KotlinJavaUnity

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

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

KotlinJavaUnity

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

تأكيد إعداداتك

عند إيقاف إشارات تخصيص الإعلانات لمستخدم من خلال إحدى الخطوات التالية: الآليات المحدّدة أعلاه، ستتضمّن حِزم الأحداث اللاحقة التي يتم تسجيلها من جهاز هذا المستخدِم خاصيّة مستخدِم باسم non_personalized_ads وقيمة 1 للإشارة إلى أنّ الأحداث في هذه الحزمة غير متاحة لإعلانات مخصّصة. لا يؤثّر إيقاف الإعلانات المخصّصة في استخدام البيانات لأغراض القياس، بما في ذلك إعداد التقارير والإحالة.

الاطّلاع على تغييرات الإعدادات

بعد إجراء تغييرات على إعدادات Google Analytics، تنزِّل حزمة SDK هذه التغييرات. تتم هذه العملية بسرعة وسلاسة، ما يتيح لك اختبار تعديلاتك بسرعة. عند إجراء تغييرات في Analytics، قد يستغرق نشرها في تطبيقك بضع دقائق. وإذا كان تطبيقك متوفّرًا، قد تستغرق عملية النشر الكاملة ما يصل إلى ساعة.