Préparer les versions tvOS

Ce guide décrit les modifications nécessaires pour préparer votre application pour tvOS 14.

Prérequis

• SDK IMA (Interactive Media Ads) 4.3.2 ou version ultérieure.

Demander l'autorisation App Tracking Transparency

Pour afficher la demande d'autorisation App Tracking Transparency permettant d'accéder à l'IDFA, mettez à jour votre fichier Info.plist afin d'ajouter la clé NSUserTrackingUsageDescription avec un message personnalisé décrivant votre utilisation. Voici un exemple de texte de description :

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

La description de l'utilisation s'affiche dans la boîte de dialogue App Tracking Transparency :

Pour présenter la demande d'autorisation, appelez requestTrackingAuthorizationWithCompletionHandler:. Nous vous recommandons d'attendre le rappel de fin avant de charger les annonces. Ainsi, si l'utilisateur accorde l'autorisation App Tracking Transparency, le SDK IMA (Interactive Media Ads) peut utiliser l'IDFA dans les demandes d'annonces.

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];
  }];
}

Pour en savoir plus sur les valeurs d'état possibles, consultez ATTrackingManager.AuthorizationStatus.

Important : Pour améliorer l'expérience utilisateur, nous vous recommandons d'ajouter une explication avant l'appel à requestTrackingAuthorizationWithCompletionHandler: afin de clarifier l'autorisation et l'utilisation des données pour les utilisateurs.

ID first party de l'éditeur (anciennement "clé d'application identique")

Remarque : La clé d'application identique a été renommée "ID first party de l'éditeur". L'API de la clé d'application identique peut être modifiée pour refléter l'ID first party de l'éditeur dans une prochaine version du SDK. Cette modification n'aura pas d'incidence sur l'activation existante de la clé d'application identique sur les SDK IMA 3.14.5 et versions ultérieures. Toutes les versions applicables du SDK traiteront l'identifiant de manière transparente.

Prérequis : SDK IMA pour iOS 3.14.5 ou version ultérieure

Le SDK IMA (Interactive Media Ads) pour iOS a introduit l'ID first party de l'éditeur (anciennement "clé d'application identique") pour vous aider à diffuser des annonces plus pertinentes et personnalisées en utilisant les données collectées dans vos applications.

L'ID first party de l'éditeur est activé par défaut, mais vous pouvez choisir de le désactiver dans votre application en définissant IMASettings::SameAppKeyEnabled sur 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];

Divulguer l'utilisation des données dans l'App Store

Apple demande aux développeurs qui publient des applications sur l'App Store de divulguer certaines informations sur l'utilisation des données de leurs applications. Apple a annoncé que ces informations seraient nécessaires pour les applications nouvelles et mises à jour à compter du 8 décembre 2020.

En savoir plus sur les exigences concernant le communiqué sur les données requirements.