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

На этой странице описаны функции Google 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 определяет статус сбора данных Аналитики до повторного вызова 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

Если вы установили модуль FirebaseAnalytics в свое приложение через SPM или CocoaPods и хотите отключить сбор IDFA (рекламного идентификатора устройства) в приложении Apple, убедитесь, что в приложении отсутствует фреймворк AdSupport.

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

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

pod 'FirebaseAnalytics/Core'

Подробные сведения об идентификаторе IDFA вы найдете в документации Apple:

• User Privacy and Data Use (Конфиденциальность пользователей и использование данных)
• App Tracking Transparency (Прозрачность отслеживания приложений)

Как отключить сбор идентификатора IDFV

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

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

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

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

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

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

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

Как отключить персонализированную рекламу с помощью свойства пользователя

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

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

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