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

iOS+ Android

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

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

Быстрый

Примечание: Данный продукт 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 не будет вызван снова, даже если пользователь закроет и снова откроет ваше приложение.

Полностью деактивировать коллекцию

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

Swift Package Manager

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

CocoaPods

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 .

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

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)

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

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

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

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