Catch up on highlights from Firebase at Google I/O 2023. Learn more

Настройка сбора и использования данных 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, чтобы указать, что события в этом пакете недоступны. для персонализированной рекламы. Отключение персонализированной рекламы не влияет на использование данных для целей измерения, включая отчетность и атрибуцию.

Просмотр изменений конфигурации

После внесения изменений в настройки Google Analytics SDK загружает изменения. Процесс быстрый и бесшовный, поэтому вы можете быстро протестировать свои изменения. Когда вы вносите изменения в Google Analytics, их развертывание в вашем приложении может занять несколько минут. Если ваше приложение работает, полный процесс развертывания может занять до одного часа.