Guide d’intégration du SDK MA iOS (avant 5.5.0)

Versions applicables

Ce guide s’applique aux versions du SDK MTMA à partir de v5.0.0 et antérieures à v5.5.0. Le SDK prend actuellement en charge iOS 10 et versions ultérieures.

Pour v5.5.0 et les versions ultérieures, consultez le Guide d’intégration.

Pour utiliser les fonctionnalités MA du SDK EngageLab, vous devez également intégrer le module AppPush. Créez d’abord une application sur la plateforme AppPush afin d’obtenir une AppKey.

Configurer le projet

Configurer AppPush

Lors de la configuration d’une source de données mobile dans la console MA, sélectionnez l’utilisation conjointe d’AppPush et choisissez l’application AppPush effectivement intégrée. Initialisez AppPush avec l’AppKey de cette application.

Importer le SDK

Importation via CocoaPods

• Spécifiez une version antérieure à 5.5.0 (5.0.0 dans cet exemple) :

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

            

Importation manuelle

• Décompressez le package SDK de la version antérieure concernée. Après avoir importé AppPush selon son guide d’intégration, sélectionnez « Add files to 'Your project name'... » dans Xcode et ajoutez MTMA-ios-x.x.x.xcframework provenant du même package SDK au répertoire de votre projet.

Initialiser le SDK

Initialisez le SDK MTMA après avoir appelé la fonction d’initialisation de MTPush. L’ancienne version de MTMA utilise l’AppKey AppPush ; aucune MA AppKey distincte n’est nécessaire.

Ajoutez les fichiers d’en-tête suivants à AppDelegate.m :

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

            

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

    // Initialiser d’abord le SDK Push
    NSString *appKey = @"votre AppPush AppKey";
    NSString *channel = @"App Store";
    BOOL isProduction = NO;
    [MTPushService setupWithOption:launchOptions
                           appKey:appKey
                          channel:channel
                 apsForProduction:isProduction
            advertisingIdentifier:nil];

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

    return YES;
}

            

Description de certains paramètres

• appKey
  • Vérifiez que l’appKey configurée dans l’application correspond à l’AppKey générée lors de la création de l’application sur la plateforme AppPush.
• channel
  • Indique le canal de téléchargement du package de l’application. Définissez vous-même sa valeur, par exemple App Store, pour faciliter les statistiques par canal.
• apsForProduction
  • Identifie l’environnement du certificat APNs utilisé par l’application courante.
  • 0 (valeur par défaut) indique un certificat de développement ; 1 indique un certificat de production pour publier l’application.
  • Remarque : cette valeur doit correspondre à l’environnement du certificat configuré dans Code Signing, sous Build Settings.
• completion
  • Callback du résultat d’initialisation. Un code égal à 0 indique que l’initialisation a réussi.