Preparati per tvOS 14+

Questa guida illustra le modifiche necessarie per preparare la tua app per tvOS 14.

Prerequisiti

• SDK Interactive Media Ads 4.3.2 o versioni successive.

Richiedi l'autorizzazione App Tracking Transparency

Per visualizzare la richiesta di autorizzazione di App Tracking Transparency per l'accesso all'IDFA, aggiorna Info.plist per aggiungere la chiave NSUserTrackingUsageDescription con un messaggio personalizzato che descriva il tuo utilizzo. Ecco un esempio di testo descrittivo:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

La descrizione dell'utilizzo viene visualizzata nella finestra di dialogo App Tracking Transparency:

Per presentare la richiesta di autorizzazione, chiama requestTrackingAuthorizationWithCompletionHandler:. Ti consigliamo di attendere il callback di completamento prima di caricare gli annunci in modo che, se l'utente concede l'autorizzazione App Tracking Transparency, l'SDK Interactive Media Ads possa utilizzare l'IDFA nelle richieste di annunci.

Swift

import AppTrackingTransparency
import AdSupport
...
func requestIDFA() {
  ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in
    // Tracking authorization completed. Start loading ads here.
    // loadAd()
  })
}

Objective-C

#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
...
- (void)requestIDFA {
  [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    // Tracking authorization completed. Start loading ads here.
    // [self loadAd];
  }];
}

Per ulteriori informazioni sui possibili valori di stato, consulta ATTrackingManager.AuthorizationStatus.

Punto chiave: per un'esperienza utente migliore, ti consigliamo di aggiungere un messaggio esplicativo prima della chiamata a requestTrackingAuthorizationWithCompletionHandler: per chiarire l'autorizzazione e l'utilizzo dei dati da parte degli utenti.

ID proprietario del publisher, precedentemente noto come stessa chiave dell'app

Nota: la stessa chiave dell'app è stata rinominata ID proprietario del publisher. La stessa API della chiave dell'app può cambiare per riflettere l'ID proprietario del publisher in una release futura dell'SDK. Questa modifica non influirà sull'attivazione esistente della stessa chiave dell'app sugli SDK IMA 3.14.5 e versioni successive. Tutte le versioni dell'SDK applicabili elaboreranno l'identificatore senza problemi.

Prerequisiti: SDK IMA per iOS 3.14.5 o versioni successive

L'SDK Interactive Media Ads per iOS ha introdotto l'ID proprietario del publisher, precedentemente noto come stessa chiave dell'app, per aiutarti a pubblicare annunci più pertinenti e personalizzati utilizzando i dati raccolti dalle tue app.

L'ID proprietario del publisher è abilitato per impostazione predefinita, ma puoi sempre scegliere di disattivarlo nella tua app impostando IMASettings::SameAppKeyEnabled su false:

Swift

let settings = IMASettings()
// Disables Publisher first-party ID, formerly known as same app key.
settings.SameAppKeyEnabled = false
adsLoader = IMAAdsLoader(settings: settings)

Objective-C

IMASettings *settings = [[IMASettings alloc] init];
// Disables Publisher first-party ID, formerly known as same app key.
settings.SameAppKeyEnabled = false;
IMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];

Indicare l'utilizzo dei dati nell'App Store

Apple richiede agli sviluppatori che pubblicano app sull'App Store di divulgare determinate informazioni relative all'utilizzo dei dati delle loro app. Apple ha annunciato che queste informative saranno necessarie per le nuove app e gli aggiornamenti delle app a partire dall'8 dicembre 2020.

Scopri di più sui requisiti per la divulgazione dei dati.