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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

توضّح هذه الصفحة الميزات التي يوفّرها Google Analytics والتي تسمح لك بالتحكّم في جمع بيانات "إحصاءات Google" واستخدامها.

إيقاف جمع بيانات Analytics

في بعض الحالات، قد تحتاج إلى إيقاف جمع بيانات Analytics مؤقتًا أو نهائيًا، مثلاً لجمع موافقة المستخدم النهائي أو للوفاء بالتزامات القانونية. يوفّر Google Analytics خيارات متعددة لإيقاف وإيقاف مجموعة Analytics. وعند استخدامهما معًا، يمكنهما معالجة العديد من حالات الاستخدام الشائعة.

إيقاف المجموعة مؤقتًا

إذا كنت تريد إيقاف جمع Analytics مؤقتًا، مثلاً للحصول على موافقة المستخدم النهائي قبل جمع البيانات، يمكنك ضبط قيمة FIREBASE_ANALYTICS_COLLECTION_ENABLED على NO (قيمة منطقية) في ملف Info.plist الخاص بتطبيقك. على سبيل المثال، عند عرضها في ملف XML المصدر:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

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

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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 (Boolean) إلى أي تأثير ويؤدي إلى السلوك نفسه الذي يحدث في حال عدم ضبط 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 بحساب إعلانات أو فعّلت عملية دمج إعلانات أو فعّلت مشاركة البيانات، قد تكون بياناتك على "إحصاءات Google" مؤهّلة للاستخدام في الإعلانات المخصّصة. يعني ذلك، على سبيل المثال، أنّه يمكنك استخدام الأحداث المجمّعة، مثل first_open لإنشاء قوائم جمهور ونشرها من أجل تجديد النشاط التسويقي ما لم تُشير إلى أنّه لا تتوفّر هذه البيانات للإعلانات المخصّصة.

يمكنك التحكّم آليًا في ما إذا كان يجب استخدام بيانات المستخدِم في "إحصاءات Google" للإعلانات المخصّصة باستخدام أيّ من الخيارات التالية:

• إجراء مقترَح: يمكنك تفعيل تخصيص الإعلانات أو إيقافه ديناميكيًا من خلال احترام اختيار المستخدم بشأن الموافقة. تنفيذ واجهة برمجة التطبيقات لوضع الموافقة من Google

• تفعيل تخصيص الإعلانات أو إيقافه على مستوى المستخدِم: التحكّم في تخصيص الإعلانات كخاصيّة مستخدِم

• تفعيل تخصيص الإعلانات أو إيقافه على مستوى موقع "إحصاءات Google": إيقاف تخصيص الإعلانات حسب المنطقة الجغرافية في موقعك على "إحصاءات Google"

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

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

لإيقاف سلوك الإعلانات المخصّصة تلقائيًا، اضبط قيمة GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS على NO (قيمة منطقية) في ملف Info.plist الخاص بتطبيقك.

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

إذا كنت تستخدِم المَعلمة AnalyticsUserPropertyAllowAdPersonalizationSignals للتحكّم في تخصيص الإعلانات، يمكنك إعادة تفعيل تخصيص الإعلانات باستخدام الأسلوب setUserProperty كما هو موضّح أدناه:

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

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

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

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

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

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

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

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