Grundlegende Implementierung und Lebenszyklus

Diese Informationen helfen Ihnen beim Implementieren der iOS-Bibliothek und beim Erfassen von Lebenszyklusmetriken wie Starts, Upgrades, Sitzungen, eingebundene Benutzer usw.

SDK herunterladen

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:

1. 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.

1. 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.

SDK und Konfigurationsdatei zum Projekt hinzufügen

1. Starten Sie die XCode IDE und öffnen Sie die App.

2. Ziehen Sie im Projektnavigator den Ordner AdobeMobileLibrary und legen Sie ihn unter Ihrem Projekt ab.

3. Stellen Sie Folgendes sicher:

   • Das Kontrollkästchen Elemente kopieren, sofern erforderlich ist aktiviert.
   • Gruppen erstellen ist ausgewählt.
   • Keines der Kontrollkästchen im Abschnitt Zu Zielen hinzufügen ist aktiviert.

   

4. Klicken Sie auf Fertigstellen.

5. Wählen Sie im Projektnavigator ADBMobileConfig.json aus.

6. Fügen Sie in der Dateikontrolle die JSON-Datei zu den Zielen in Ihrem Projekt hinzu, die das Adobe SDK verwenden.

   

7. Führen Sie im Projektnavigator die folgenden Schritte aus:

   1. Klicken Sie auf Ihre App.
   2. Wählen Sie auf der Registerkarte Allgemein Ihre Ziele aus und verknüpfen Sie die erforderlichen Frameworks und Bibliotheken in den Abschnitten Verknüpfte Frameworks und Bibliotheken.

   • 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
   VORSICHT

   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.

   WICHTIG

   Wenn Sie Version 4.21.0 oder höher verwenden, stellen Sie sicher, dass die Adobe XCFrameworks nicht eingebettet sind.

   

8. Bestätigen Sie, dass Ihre App ohne Fehler erstellt wird.

Lebenszyklusmetriken implementieren

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

Zusätzliche Daten zu Lebenszyklusaufrufen hinzufügen

Verwenden Sie collectLifecycleDataWithAdditionalData, um zusätzliche Daten mit Lebenszyklusmetrikdaten einzubeziehen:

- (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.

Nächste Schritte

Führen Sie die folgenden Aufgaben aus:

• App-Zustände verfolgen
• App-Aktionen verfolgen