iOS-Versionen vorbereiten

eigene Kennung und Offenlegung der Datennutzung im App Store für das Google Interactive Media Ads (IMA) SDK für iOS.

In diesem Leitfaden werden die Änderungen beschrieben, die erforderlich sind, um Ihre App auf iOS 14 vorzubereiten.

Vorbereitung

• Interactive Media Ads SDK 3.12.1 oder höher

App Tracking Transparency-Autorisierung anfordern

Wichtiger Hinweis:Wenn Sie App Tracking Transparency (ATT) in Ihre App einbinden möchten, können Sie das User Messaging Platform (UMP) SDK verwenden, um eine IDFA-Erklärung auszulösen, in der Nutzern erläutert wird, warum Sie diese Berechtigung anfordern. Beachten Sie, dass die Verwendung des UMP SDK alle Nutzer Ihrer App betrifft.

Wenn Sie das UMP SDK nicht verwenden, erfahren Sie auf dieser Seite, wie Sie die ATT-Autorisierungsanfrage auf Betriebssystemebene manuell implementieren.

Wenn Sie die App Tracking Transparency-Autorisierungsanfrage für den Zugriff auf die IDFA anzeigen möchten, aktualisieren Sie Ihre Info.plist-Datei und fügen Sie den Schlüssel NSUserTrackingUsageDescription mit einer benutzerdefinierten Nachricht hinzu, in der Ihre Nutzung beschrieben wird. Hier ein Beispiel für einen Beschreibungstext:

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

Die Nutzungsbeschreibung wird im Dialogfeld „App Tracking Transparency“ angezeigt:

Rufen Sie requestTrackingAuthorizationWithCompletionHandler: auf, um die Autorisierungsanfrage zu präsentieren. Wir empfehlen, auf den Abschluss-Callback zu warten, bevor Sie Anzeigen laden. Wenn der Nutzer die App Tracking Transparency-Berechtigung erteilt, kann das Interactive Media Ads SDK die IDFA in Anzeigenanfragen verwenden.

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

Weitere Informationen zu den möglichen Statuswerten finden Sie unter ATTrackingManager.AuthorizationStatus.

Wichtiger Hinweis: Für eine bessere Nutzererfahrung empfehlen wir, vor dem Aufruf von requestTrackingAuthorizationWithCompletionHandler: eine Erklärung hinzuzufügen, um die Berechtigung und die Datennutzung für Nutzer zu verdeutlichen.

Eigene Kennung des Publishers (früher „App-interner Schlüssel“)

Hinweis: Der App-interne Schlüssel wurde in Eigene ID des Publishers umbenannt. Die API für den App-internen Schlüssel wird möglicherweise in einer zukünftigen SDK-Version aktualisiert, um die eigene Kennung des Publishers widerzuspiegeln. Diese Änderung hat keine Auswirkungen auf die bestehende Aktivierung des App-internen Schlüssels in IMA SDKs ab Version 3.14.5. Alle entsprechenden SDK-Versionen verarbeiten die Kennung nahtlos.

Voraussetzungen: IMA SDK für iOS 3.14.5 oder höher

Mit dem Interactive Media Ads SDK für iOS wurde die eigene ID des Publishers (früher „App-interner Schlüssel“) eingeführt, damit Sie mithilfe von Daten aus Ihren Apps relevantere und personalisierte Anzeigen schalten können.

Die eigene Kennung des Publishers ist standardmäßig aktiviert. Sie können sie aber jederzeit in Ihrer App deaktivieren, indem Sie IMASettings::SameAppKeyEnabled auf false setzen:

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

Datennutzung im App Store offenlegen

Bei Apple müssen Entwickler, die Apps im App Store veröffentlichen, bestimmte Informationen zur Nutzung der App-Daten offenlegen. Laut dieser Mitteilung, sind diese Offenlegungen seit dem 8. Dezember 2020 für neue Apps und App-Updates erforderlich.

Weitere Informationen zu den Anforderungen an die Offenlegung von Daten finden Sie hier.