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.

Richiedere l'autorizzazione per la trasparenza del monitoraggio delle app

Per visualizzare la richiesta di autorizzazione App Tracking Transparency per accedere 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 di trasparenza del monitoraggio delle app, 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 dello stato, consulta ATTrackingManager.AuthorizationStatus.

Punto chiave: per un'esperienza utente migliore, ti consigliamo di aggiungere una spiegazione prima della chiamata a requestTrackingAuthorizationWithCompletionHandler: per chiarire agli utenti l'utilizzo delle autorizzazioni e dei dati.

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

Nota: la stessa chiave dell'app è stata rinominata in ID proprietario del publisher. L'API stessa chiave dell'app potrebbe cambiare per riflettere l'ID proprietario del publisher in una prossima release dell'SDK. Questa modifica non influisce sull'attivazione esistente della stessa chiave dell'app negli 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 è attivo 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];

Comunicare l'utilizzo dei dati nell'App Store

Apple richiede agli sviluppatori che pubblicano app nell'App Store di fornire alcune informazioni relative all'utilizzo dei dati da parte delle loro app. Apple ha annunciato che queste comunicazioni saranno obbligatorie per le nuove app e gli aggiornamenti delle app a partire dall'8 dicembre 2020.

Scopri di più sui requisiti relativi alle informative dei dati.