Diese Informationen helfen Ihnen beim Implementieren der iOS-Bibliothek und beim Erfassen von Lebenszyklusmetriken wie Starts, Upgrades, Sitzungen, eingebundene Benutzer usw.
Das SDK erfordert iOS 8 oder höher.
Voraussetzung
Bevor Sie das SDK herunterladen, führen Sie die Schritte unter Report Suite erstellen in Grundlegende Implementierung und Lebenszyklus aus, um eine Entwicklungs-Report Suite einzurichten und eine vorab ausgefüllte Version der Konfigurationsdatei herunterzuladen.
So laden Sie das SDK herunter:
Ab Version 4.21.0 wird das SDK über XCFrameworks verteilt. Gehen Sie wie folgt vor, wenn Sie Version 4.21.0 oder höher verwenden.
Für Version 4.21.0 des SDK ist Xcode 12.0 oder höher und, falls verwendet, Cocoapods 1.10.0 oder höher erforderlich.
Laden Sie die Datei [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip
herunter, entpacken Sie sie und stellen Sie sicher, dass Sie über folgende Software-Komponenten im Verzeichnis AdobeMobileLibrary
verfügen:
ADBMobile.h
: die Objective-C-Header-Datei, die für das iOS SDK verwendet wird.
ADBMobileConfig.json
: die SDK-Konfigurationsdatei, die für Ihre Applikation angepasst ist.
AdobeMobile.xcframework
: enthält zwei umfangreiche Binärdateien, jeweils eine für iOS-Geräte (armv7, armv7s, arm64) und für Simulatoren (i386, x86_64, arm64).
Dieses XCFramework sollte beim Targeting einer iOS-Applikation verknüpft werden.
AdobeMobileExtension.xcframework
: enthält zwei umfangreiche Binärdateien, jeweils eine für iOS-Geräte (armv7, armv7s, arm64) und für Simulatoren (i386, x86_64, arm64).
Dieses XCFramework sollte beim Targeting einer iOS-Erweiterung verknüpft werden.
AdobeMobileWatch.xcframework
: enthält zwei Fat-Binärdateien, jeweils eine für watchOS-Geräte (arm64_32, armv7k) und für Simulatoren (i386, x86_64, arm64).
Dieses XCFramework sollte beim Targeting einer Apple Watch-Applikation (watchOS) verknüpft werden.
AdobeMobileTV.xcframework
: enthält zwei Fat-Binärdateien, jeweils eine für tvOS-Geräte (arm64) und für Simulatoren (x86_64, arm64).
Dieses XCFramework sollte beim Targeting einer Apple TV-Applikation (tvOS) verknüpft werden.
In älteren Versionen als 4.21.0 wird das SDK über Binärdateien verteilt. Gehen Sie wie folgt vor, wenn Sie eine Version verwenden, die älter als 4.21.0 ist.
Laden Sie [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip
herunter, entpacken Sie sie und stellen Sie sicher, dass Sie über folgende Software-Komponenten verfügen:
ADBMobile.h
: Hierbei handelt es sich um die Objective-C-Header-Datei, die für iOS AppMeasurement verwendet wird.
ADBMobileConfig.json
: die SDK-Konfigurationsdatei, die für Ihre App angepasst ist.
AdobeMobileLibrary.a
: Hierbei handelt es sich um eine Bitcode-fähige Fat Binary, die die Bibliotheks-Builds für iOS-Geräte (armv7, armv7s, arm64) und Simulatoren (i386, x86_64) enthält.
Diese Fat Binary sollte verknüpft werden, wenn das Ziel für eine iOS-App vorgesehen ist.
AdobeMobileLibrary_Extension.a
: Hierbei handelt es sich um eine Bitcode-fähige Fat Binary, die die Bibliotheks-Builds für iOS-Geräte (armv7, armv7s, arm64) und Simulatoren (i386, x86_64) enthält.
Diese Fat Binary sollte verknüpft werden, wenn das Ziel für eine iOS-Erweiterung vorgesehen ist.
AdobeMobileLibrary_Watch.a
: Hierbei handelt es sich um eine Bitcode-fähige Fat Binary, die die Bibliotheks-Builds für Apple Watch-Geräte (armv7k) und Simulatoren (i386, x86_64) enthält.
Diese Fat Binary sollte verknüpft werden, wenn das Ziel für eine App mit Apple Watch-Erweiterung (watchOS 2) vorgesehen ist.
AdobeMobileLibrary_TV.a
: Hierbei handelt es sich um eine Bitcode-fähige Fat Binary, die die Bibliotheks-Builds für neue Apple TV-Geräte (arm64) und für den Simulator (x86_64) enthält.
Diese Fat Binary sollte verknüpft werden, wenn das Ziel für eine Apple TV-App (tvOS) vorgesehen ist.
Wenn Sie das SDK außerhalb der Adobe Mobile Services-Benutzeroberfläche herunterladen, muss die Datei ADBMobileConfig.json
manuell konfiguriert werden. Wenn Sie mit Analytics und dem Mobile SDK noch nicht vertraut sind, lesen Sie den Abschnitt Vorbereitung, um eine Entwicklungs-Report Suite einzurichten und eine vorinstallierte Version der Konfigurationsdatei herunterzuladen.
Starten Sie die XCode IDE und öffnen Sie die App.
Ziehen Sie im Projektnavigator den Ordner AdobeMobileLibrary
und legen Sie ihn unter Ihrem Projekt ab.
Stellen Sie Folgendes sicher:
Klicken Sie auf Fertigstellen.
Wählen Sie im Projektnavigator ADBMobileConfig.json
aus.
Fügen Sie in der Dateikontrolle die JSON-Datei zu den Zielen in Ihrem Projekt hinzu, die das Adobe SDK verwenden.
Führen Sie im Projektnavigator die folgenden Schritte aus:
iOS-App-Ziele
SystemConfiguration.framework
WebKit.framework
libsqlite3.0.tbd
AdobeMobileLibrary.a
CoreLocation.framework
(optional, aber für Geo-Tracking-Funktionen erforderlich)iOS-Erweiterungsziel
SystemConfiguration.framework
libsqlite3.0.tbd
AdobeMobileLibrary\_Extension.a
Apple Watch-Ziel (watchOS 2)
libsqlite3.0.tbd
AdobeMobileLibrary\_Watch.a
Apple TV-(tvOS)-Ziel
SystemConfiguration.framework
libsqlite3.0.tbd
AdobeMobileLibrary\_TV.a
Das Verknüpfen von mehr als einer Datei AdobeMobileLibrary*.a
im selben Ziel führt zu einem unerwarteten Verhalten oder dazu, dass das Erstellen nicht möglich wird.
Wenn Sie Version 4.21.0 oder höher verwenden, stellen Sie sicher, dass die Adobe XCFrameworks nicht eingebettet sind.
Bestätigen Sie, dass Ihre App ohne Fehler erstellt wird.
iOS sendet Lebenszyklusinformationen sowohl mit als auch ohne den Aufruf von collectlifecycledata
. collectlifecycledata
ist zudem die einzige Möglichkeit, den Lebenszyklus zu einem früheren Zeitpunkt in der Startsequenz der App zu initiieren.
Nachdem Sie den Lebenszyklus aktiviert haben, wird bei jedem Start Ihrer App ein Treffer gesendet, um Starts, Upgrades, Sitzungen, erreichte Benutzer und viele andere Lebenszyklusmetriken zu messen.
Fügen Sie einen collectLifecycleData
-/collectLifecycleDataWithAdditionalData
-Aufruf in application:didFinishLaunchingWithOptions
hinzu:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[ADBMobile collectLifecycleData];
return YES;
}
Verwenden Sie collectLifecycleDataWithAdditionalData
, um zusätzliche Daten mit Lebenszyklusmetrikdaten einzubeziehen:
Daten, die über collectLifecycleDataWithAdditionalData:
an das SDK weitergegeben werden, verbleiben durch das SDK dauerhaft in NSUserDefaults
. Das SDK entfernt die Werte im Parameter NSDictionary
, die nicht vom Typ NSString
oder NSNumber
sind.
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
NSMutableDictionary *contextData = [NSMutableDictionary dictionary];
[contextData setObject:@"Game" forKey:@"myapp.category"];
[ADBMobile collectLifecycleDataWithAdditionalData:contextData];
return YES;
}
Zusätzliche Kontextdatenwerte, die mit collectLifecycleDataWithAdditionalData
gesendet werden, müssen benutzerdefinierten Variablen in Adobe Mobile Services zugeordnet sein:
Andere Lebenszyklusmetriken werden automatisch erfasst. Weitere Informationen finden Sie unter Lebenszyklusmetriken.
Führen Sie die folgenden Aufgaben aus: