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

This guide outlines the steps required to support the US states regulations message as part of the UMP SDK. Pair these instructions with Get started , which details how to get your app running with the UMP SDK and set up your message. The following guidance is specific to the US states regulations message.

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

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

• Обновите UMP SDK до последней версии. Для поддержки обмена сообщениями в соответствии с правилами штатов США мы рекомендуем использовать версию 2.1.0 или выше.
• Настройте IMA SDK . Обязательно реализуйте точку входа для параметров конфиденциальности и отображайте её при необходимости. Выполнив это руководство, вы получите точку входа для передачи пользователям информации о правилах ваших штатов США.
• Создайте сообщение о правилах регулирования приложений на уровне штатов США .
• If you're using the US states regulations message alongside other messages, consult Available user message types to understand when different messages are displayed to your users.

Установите тег для лиц младше возраста согласия.

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

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

// Create a UMPRequestParameters object.
let parameters = RequestParameters()
// Indicate the user is under age of consent.
parameters.isTaggedForUnderAgeOfConsent = true

// Request an update for the consent information.
ConsentInformation.shared.requestConsentInfoUpdate(with: parameters) {
  [weak self] requestConsentError in
  guard let self else { return }

  // ...
}

// Create a UMPRequestParameters object.
UMPRequestParameters *parameters = [[UMPRequestParameters alloc] init];
// Indicate the user is under age of consent.
parameters.tagForUnderAgeOfConsent = YES;

// Request an update for the consent information.
[UMPConsentInformation.sharedInstance
    requestConsentInfoUpdateWithParameters:parameters
        completionHandler:^(NSError *_Nullable requestConsentError) {
          // ...
        }];

Ознакомьтесь с вариантами согласия.

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

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

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