Настройка сбора и использования данных Analytics

Google Analytics предлагает функции, которые позволяют вам контролировать сбор и использование данных Analytics.

Отключить сбор данных Analytics

В некоторых случаях вы можете временно или навсегда отключить сбор данных Google Analytics, например, для получения согласия конечного пользователя или для выполнения юридических обязательств. Google Analytics предлагает несколько вариантов отключения и деактивации сбора аналитики. При совместном использовании они поддерживают множество типичных вариантов использования.

Временно отключить сбор

Если вы хотите временно отключить сбор данных Google Analytics, например, чтобы получить согласие конечного пользователя перед сбором данных, вы можете установить для параметра FIREBASE_ANALYTICS_COLLECTION_ENABLED значение NO (логическое значение) в файле Info.plist вашего приложения. Например, просмотр в исходном XML:

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

Чтобы повторно включить сбор, например, после того, как конечный пользователь предоставит согласие, вызовите метод экземпляра setAnalyticsCollectionEnabled Analytics . Например:

Быстрый

Примечание. Этот продукт Firebase недоступен для macOS.
Analytics.setAnalyticsCollectionEnabled(true)

Цель-C

Примечание. Этот продукт Firebase недоступен для macOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Если вам нужно снова приостановить сбор по какой-либо причине, вы можете позвонить

Быстрый

Примечание. Этот продукт Firebase недоступен для macOS.
Analytics.setAnalyticsCollectionEnabled(false)

Цель-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

и сбор приостанавливается до тех пор, пока вы снова не включите его. Значение, установленное методом setAnalyticsCollectionEnabled , сохраняется при выполнении приложения и переопределяет значение для FIREBASE_ANALYTICS_COLLECTION_ENABLED в файле Info.plist вашего приложения. После установки значения для setAnalyticsCollectionEnabled коллекция Analytics остается в этом состоянии до setAnalyticsCollectionEnabled , даже если пользователь закрывает и снова открывает ваше приложение.

Навсегда деактивировать коллекцию

Если вам необходимо навсегда отключить сбор Google Analytics в версии вашего приложения, задайте для FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED значение YES (логическое значение) в Info.plist file вашего приложения. Установка для 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 вашего приложения.

Настройка использования данных Analytics

Отключить персонализированные рекламные функции

Если вы связали свой проект Google Analytics с рекламным аккаунтом или иным образом включили интеграцию рекламы или выбрали обмен данными , ваши данные Analytics могут быть пригодны для использования в персонализированной рекламе. Это означает, например, что вы можете использовать собранные события, такие как first_open , для создания и развертывания списков аудитории для ремаркетинга, если только вы не укажете, что такие данные недоступны для персонализированной рекламы.

Чтобы программно контролировать, следует ли использовать данные Analytics пользователя для персонализированной рекламы, задайте соответствующее поведение по умолчанию в файле AndroidManifest.xml приложения, а затем используйте методы, описанные ниже, для переопределения этого поведения по умолчанию.

Чтобы установить поведение персонализированной рекламы по умолчанию, установите для параметра GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS значение NO (логическое значение) в файле Info.plist вашего приложения.

Вы также можете контролировать, могут ли данные, полученные от конечных пользователей, использоваться для персонализации рекламы, с помощью настройки персонализации рекламы , которую можно найти в настройках ресурсов Google Analytics.

Повторно включить персонализированные рекламные функции

Чтобы повторно включить персонализированные рекламные функции для пользователя во время выполнения, например, после того, как конечный пользователь предоставит согласие, используйте метод setUserProperty , как показано ниже:

Быстрый

Примечание. Этот продукт Firebase недоступен для macOS.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Цель-C

Примечание. Этот продукт Firebase недоступен для macOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Если вы выбрали временное отключение сбора аналитики (например, до тех пор, пока конечный пользователь не предоставит согласие) и хотите контролировать персонализированные рекламные функции после повторного включения сбора аналитики для пользователя, убедитесь, что ваш вызов для указания этого параметра предшествует вашему вызов для повторного включения сбора аналитики. Например:

Быстрый

Примечание. Этот продукт Firebase недоступен для macOS.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Цель-C

Примечание. Этот продукт Firebase недоступен для macOS.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Подтверждение ваших настроек

Когда сигналы персонализации рекламы отключены для пользователя с помощью одного из механизмов, определенных выше, последующие пакеты событий, зарегистрированные с устройства этого пользователя, будут содержать пользовательское свойство с именем «non_personalized_ads» со значением 1, чтобы указать, что события в этом пакете недоступны. для персонализированной рекламы. Отключение персонализированной рекламы не влияет на использование данных для целей измерения, включая отчетность и атрибуцию.