Поддержка IAB США

В этом руководстве описаны шаги, необходимые для поддержки сообщений о правилах штатов США в рамках UMP SDK. Соедините эти инструкции с разделом «Начало работы» , в котором подробно описано, как запустить ваше приложение с помощью UMP SDK и настроить сообщение. Следующие рекомендации относятся только к сообщениям о правилах штатов США.

Предварительные условия

Прежде чем продолжить, убедитесь, что вы выполнили следующее:

  • Обновите UMP SDK до последней версии. Для поддержки обмена сообщениями в соответствии с правилами штатов США мы рекомендуем использовать версию 2.1.0 или выше.
  • Полное начало работы . Обязательно реализуйте точку входа параметров конфиденциальности и визуализируйте ее, если необходимо. Выполнив это руководство, вы получите точку входа для передачи пользователям сообщений о правилах штата США.
  • Создайте сообщение о правилах штата США для приложений.
  • Если вы используете сообщение о правилах штата США вместе с другими сообщениями, ознакомьтесь с разделом «Доступные типы сообщений пользователя», чтобы понять, когда вашим пользователям отображаются разные сообщения.

Чтобы указать, не достиг ли пользователь возраста согласия, установите setTagForUnderAgeOfConsent (TFUA). Если для TFUA установлено значение true , UMP SDK не запрашивает согласие пользователя. Если у вашего приложения смешанная аудитория, установите этот параметр для детей-пользователей, чтобы гарантировать, что согласие не запрашивается. Вы несете ответственность за настройку этого параметра там, где это необходимо для соответствия COPPA и другим соответствующим нормам.

В следующем примере для TFUA устанавливается значение true в запросе согласия UMP:

Ява 

ConsentRequestParameters params = new ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build();

consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    (OnConsentInfoUpdateSuccessListener) () -> {
      // ...
    },
    (OnConsentInfoUpdateFailureListener) requestConsentError -> {
      // ...
    });

Котлин 

val params = ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build()

consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    ConsentInformation.OnConsentInfoUpdateSuccessListener {
      // ...
    },
    ConsentInformation.OnConsentInfoUpdateFailureListener {
      requestConsentError ->
      // ...
    })

После того, как пользователь принял решение в соответствии с правилами штата США, вы можете прочитать его выбор из локального хранилища в соответствии со спецификацией Глобальной платформы конфиденциальности (GPP). Более подробную информацию см. в разделе «Информация в приложении» . Обратите внимание, что UMP SDK заполняет только ключи IABGPP_GppSID и IABGPP_HDR_GppString .

Проверьте свои сообщения о правилах штатов США

Чтобы протестировать обмен сообщениями о правилах штата США, используйте UMPDebugGeographyRegulatedUSState debugGeography , чтобы заставить UMP SDK обрабатывать ваше тестовое устройство так, как если бы оно находилось в регулируемом штате США. Вы также можете использовать UMPDebugGeographyOther для принудительного подавления сообщений о правилах штатов США. Дополнительные сведения о debugGeography см. в разделе Принудительное использование географии .