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

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

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

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

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

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

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

Java 

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 ->
      // ...
    })

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

Проверьте эффективность ваших сообщений, содержащих информацию о правилах штатов США.

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