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

На этой странице описываются функции 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 . Например:

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 коллекция 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 .

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

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

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

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

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