Intergration Guide

Anwendbare Versionen

Gültig ab Version v5.0.0. Das EngageLab SDK unterstützt derzeit mobile Betriebssysteme ab iOS 10.

Um die EngageLab SDK MA-Funktion nutzen zu können, müssen Sie gleichzeitig das AppPush-Modul integrieren. Erstellen Sie zunächst eine Anwendung auf der AppPush-Plattform, um den AppKey zu erhalten.

Projekt einrichten und konfigurieren

SDK importieren

Import über Cocoapods

              
                  pod 'MTMA'

    Hinweis: Falls Sie die neueste Version nicht importieren können, aktualisieren Sie Ihre lokale Pod-Bibliothek mit dem Befehl pod repo update master. Führen Sie anschließend erneut pod 'MTMA' aus.

            

• Wenn Sie eine spezifische Version installieren möchten, verwenden Sie folgende Methode (hier am Beispiel der Version MTMA 5.0.0):

              
                  pod 'MTMA', '5.0.0'

            

SDK manuell importieren

• Entpacken Sie das SDK-Paket. Wählen Sie in Xcode „Dateien zu ‚Ihr Projektname‘ hinzufügen...“ und fügen Sie die MTMA-ios-x.x.x.xcframework zu Ihrem Projektverzeichnis hinzu.

MTMA SDK initialisieren

Initialisieren Sie das MTMA SDK, nachdem Sie die Initialisierungsfunktion von MTPush aufgerufen haben:

              
              - (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

// Zuerst das Push-SDK initialisieren
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
[MTPushService setupWithOption:launchOptions appKey:appKey
                      channel:channel
             apsForProduction:isProduction
        advertisingIdentifier:advertisingId];

// Anschließend das MTMA SDK initialisieren
MTMAConfig *config = [[MTMAConfig alloc] init];
  config.completion = ^(NSInteger code, NSString * _Nonnull message) {
    NSLog(@"Ergebnis: %ld - %@", code, message);
  };
  [MTMAService start:config];

    }

            

Erläuterung einiger Parameter

• appKey
  • Um die MA-Funktion des EngageLab SDK zu nutzen, müssen Sie gleichzeitig das AppPush-Modul integrieren. Bitte erstellen Sie zuerst eine Anwendung auf der AppPush-Plattform, um den AppKey zu erhalten.
• channel
  • Gibt den Download-Kanal des Anwendungspakets an. Für eine kanalbasierte Statistik können Sie den Wert selbst definieren, z. B.: App Store.
• apsForProduction
  • Dient zur Kennzeichnung der APNs-Zertifikatsumgebung, die von der aktuellen Anwendung verwendet wird.
  • 0 (Standardwert) bedeutet, dass ein Entwicklungszertifikat verwendet wird, 1 steht für ein Produktionszertifikat zur Veröffentlichung der Anwendung.
  • Beachten Sie, dass der Wert dieses Feldes mit der in den Code Signing-Einstellungen (Build Settings) konfigurierten Zertifikatsumgebung übereinstimmen muss.