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

iOS+ Андроид

Примечание. Если вы используете Unity SDK, выберите вариант платформы выше (iOS+ или Android) для цели сборки.

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

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

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

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

Если вы хотите временно отключить сбор 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.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Быстрый

Примечание. Этот продукт Firebase недоступен в целевой системе macOS.

Analytics.setAnalyticsCollectionEnabled(false)

Цель-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Единство

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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

Навсегда деактивировать сбор

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

Отключить сбор IDFA

Если вы установили Firebase через CocoaPods, добавив pod 'Firebase/Analytics' в подфайл вашего приложения, и хотите отключить сбор 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 с рекламным аккаунтом или иным образом включили интеграцию рекламы или согласились на обмен данными , ваши данные Analytics могут иметь право на использование в персонализированной рекламе. Это означает, например, что вы можете использовать собранные события, такие как first_open для создания и развертывания списков аудитории для ремаркетинга, если вы не укажете, что такие данные недоступны для персонализированной рекламы.

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

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

• Включите или отключите персонализацию рекламы на уровне пользователя. Управляйте персонализацией рекламы как свойством пользователя .

• Включите или отключите персонализацию рекламы на уровне ресурса Analytics. Отключите персонализацию рекламы для каждого географического региона в своем ресурсе Analytics .

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

API режима согласия Google— рекомендуемый способ включения и отключения персонализированной рекламы.

Однако если ваше приложение еще не использует режим согласия, вы можете управлять персонализацией с помощью следующей опции.

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

Примечание. В определенных обстоятельствах Google может отключить персонализированную рекламу для данных Analytics, собранных от конечного пользователя, даже если вы этого не сделали, если у Google есть информация о том, что соответствующий конечный пользователь не имеет права на персонализированную рекламу (например, конечный пользователь на устройстве Android не достиг возраста, установленного нашей политикой в ​​отношении рекламы ).

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

Если вы используете параметр AnalyticsUserPropertyAllowAdPersonalizationSignals для управления персонализацией рекламы, вы можете повторно включить персонализацию рекламы с помощью метода setUserProperty , как показано ниже:

Быстрый

Примечание. Этот продукт Firebase недоступен в целевой системе macOS.

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

Цель-C

Примечание. Этот продукт Firebase недоступен в целевой системе macOS.

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

Единство

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

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

Быстрый

Примечание. Этот продукт Firebase недоступен в целевой системе macOS.

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

Цель-C

Примечание. Этот продукт Firebase недоступен в целевой системе macOS.

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

Единство

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

Подтвердите свои настройки

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

Примечание. Если пользователь отзывает ранее данное согласие на использование Analytics или хранение рекламы, Google Analytics удаляет все свойства пользователя, включая согласие на ad personalization . Чтобы сохранить выбор согласия пользователя на персонализацию рекламы, восстановите предыдущее значение для персонализации рекламы с помощью setConsent( Свифт | Объект-C ).

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

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