Assistenza IAB negli Stati Uniti

Questa guida illustra i passaggi necessari per supportare il messaggio relativo ai regolamenti statali degli Stati Uniti nell'SDK UMP. Abbina queste istruzioni alla guida introduttiva, che spiega in dettaglio come far funzionare la tua app con l'SDK UMP e configurare il messaggio. Le seguenti indicazioni si riferiscono al messaggio relativo ai regolamenti statali degli Stati Uniti.

Prerequisiti

Prima di continuare, assicurati di:

  • Esegui l'aggiornamento alla versione più recente dell'SDK UMP. Per l'assistenza per i messaggi in base ai regolamenti degli stati degli Stati Uniti, ti consigliamo di utilizzare la versione 2.1.0 o successive.
  • Completa la procedura guidata Inizia. Assicurati di implementare un punto di accesso alle opzioni sulla privacy ed eseguine il rendering se necessario. Se completi questa guida, hai un punto di contatto per mostrare ai tuoi utenti il messaggio relativo alle normative statali degli Stati Uniti.
  • Creare un messaggio relativo ai regolamenti statali degli Stati Uniti per le app.
  • Se utilizzi il messaggio relativo ai regolamenti statali degli Stati Uniti insieme ad altri messaggi, consulta la sezione Tipi di messaggi per gli utenti disponibili per capire quando vengono mostrati messaggi diversi agli utenti.

Per indicare se un utente non ha l'età del consenso, imposta setTagForUnderAgeOfConsent (TFUA). Quando imposti TFUA su true, l'SDK UMP non richiede il consenso dell'utente. Se la tua app ha un pubblico misto, imposta questo parametro per gli utenti minorenni per assicurarti che il consenso non venga richiesto. È tua responsabilità impostare questo parametro, se necessario, per rispettare il COPPA e altre normative pertinenti.

Nell'esempio seguente, TFUA viene impostato su true in una richiesta di consenso UMP:

Swift

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

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

  // ...
}

Objective-C

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

Dopo che l'utente ha preso una decisione in base ai regolamenti statali degli Stati Uniti, puoi leggere la sua scelta dallo spazio di archiviazione locale seguendo la specifica della Global Privacy Platform (GPP). Per maggiori dettagli, consulta Dettagli in-app. Tieni presente che l'SDK UMP compila solo le chiavi IABGPP_GppSID e IABGPP_HDR_GppString.

Testare i messaggi relativi ai regolamenti statali degli Stati Uniti

Per testare i messaggi relativi ai regolamenti degli stati degli Stati Uniti, utilizza UMPDebugGeographyRegulatedUSState debugGeography per forzare l'SDK UMP a trattare il dispositivo di test come se si trovasse in uno stato degli Stati Uniti regolamentato. Puoi anche utilizzare UMPDebugGeographyOther per forzare l'eliminazione dei messaggi relativi ai regolamenti statali degli Stati Uniti. Per ulteriori dettagli su debugGeography, consulta Forzare una località.