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



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

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

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

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

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

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

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

Быстрый

Примечание: этот продукт Firebase недоступен на целевой платформе macOS.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Примечание: этот продукт Firebase недоступен на целевой платформе macOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Единство

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Быстрый

Примечание: этот продукт Firebase недоступен на целевой платформе macOS.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Единство

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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

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

Если вам нужно навсегда отключить сбор Analytics в версии вашего приложения, установите 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 'FirebaseAnalytics' в Podfile своего приложения, и хотите отключить сбор IDFA (рекламного идентификатора устройства) в своем приложении Apple, убедитесь, что фреймворк AdSupport не включен в ваше приложение.

Чтобы установить Firebase без возможности сбора IDFA, используйте следующую подспецификацию вместо pod 'FirebaseAnalytics' :

pod 'FirebaseAnalytics/Core'

Подробнее об IDFA читайте в документации Apple:

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

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

Контроль сбора данных для персонализированной рекламы

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

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

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

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

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

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

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

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

Быстрый

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

Objective-C

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

Единство

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

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

Быстрый

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

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

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

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