Integrationsleitfaden für das iOS MA SDK (vor 5.5.0)

Anwendbare Versionen

Dieser Leitfaden gilt für MTMA SDK-Versionen ab v5.0.0 und vor v5.5.0. Das SDK unterstützt derzeit iOS 10 und höher.

Für v5.5.0 und höher siehe den Integrationsleitfaden.

Um die MA-Funktionen des EngageLab SDK zu nutzen, müssen Sie auch das AppPush-Modul integrieren. Erstellen Sie zuerst eine Anwendung auf der AppPush-Plattform, um einen AppKey zu erhalten.

Projekt konfigurieren

AppPush konfigurieren

Wählen Sie beim Konfigurieren einer mobilen Datenquelle in der MA-Konsole die zusätzliche Nutzung von AppPush sowie die tatsächlich integrierte AppPush-Anwendung aus. Initialisieren Sie AppPush mit dem AppKey dieser Anwendung.

SDK importieren

Import über CocoaPods

• Geben Sie eine Version vor 5.5.0 an (hier 5.0.0):

              
                  pod 'MTPush', '5.0.0'
    pod 'MTMA', '5.0.0'

            

Manueller Import

• Entpacken Sie das SDK-Paket der entsprechenden älteren Version. Importieren Sie AppPush gemäß dessen Integrationsleitfaden, wählen Sie anschließend in Xcode „Add files to 'Your project name'...“ und fügen Sie MTMA-ios-x.x.x.xcframework aus demselben SDK-Paket Ihrem Projektverzeichnis hinzu.

SDK initialisieren

Initialisieren Sie das MTMA SDK nach dem Aufruf der MTPush-Initialisierungsfunktion. Ältere MTMA-Versionen verwenden den AppPush AppKey; ein separater MA AppKey ist nicht erforderlich.

Fügen Sie die folgenden Header-Dateien in AppDelegate.m ein:

              
              #import "MTPushService.h"
#import "MTMAService.h"

            

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

    // Zuerst das Push SDK initialisieren
    NSString *appKey = @"Ihr AppPush AppKey";
    NSString *channel = @"App Store";
    BOOL isProduction = NO;
    [MTPushService setupWithOption:launchOptions
                           appKey:appKey
                          channel:channel
                 apsForProduction:isProduction
            advertisingIdentifier:nil];

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

    return YES;
}

            

Erläuterung ausgewählter Parameter

• appKey
  • Stellen Sie sicher, dass der in der App konfigurierte appKey dem AppKey entspricht, der beim Erstellen der Anwendung auf der AppPush-Plattform erzeugt wurde.
• channel
  • Gibt den Downloadkanal des Anwendungspakets an. Den Wert, etwa App Store, legen Sie selbst fest, um Statistiken nach Kanal zu ermöglichen.
• apsForProduction
  • Kennzeichnet die APNs-Zertifikatsumgebung der aktuellen App.
  • 0 (Standardwert) steht für ein Entwicklungszertifikat, 1 für ein Produktionszertifikat zur Veröffentlichung der App.
  • Hinweis: Der Wert muss mit der unter Code Signing in Build Settings konfigurierten Zertifikatsumgebung übereinstimmen.
• completion
  • Callback für das Initialisierungsergebnis. code 0 bedeutet, dass die Initialisierung erfolgreich war.