Guía de integración del SDK MA para iOS (anterior a 5.5.0)

Versiones aplicables

Esta guía se aplica a las versiones del SDK MTMA desde v5.0.0 hasta las anteriores a v5.5.0. Actualmente, el SDK solo admite dispositivos con iOS 10 o superior.

Para v5.5.0 y posteriores, consulte la guía de integración.

Para utilizar la función MA del SDK de EngageLab, también debe integrar el módulo AppPush. Primero, cree una aplicación en la plataforma AppPush para obtener una AppKey.

Configurar el proyecto

Configurar AppPush

Al configurar la fuente de datos móvil en la consola de MA, seleccione el uso conjunto con AppPush y la aplicación AppPush que realmente integra. Inicialice AppPush con la AppKey de esa aplicación.

Importar el SDK

Importación mediante CocoaPods

• Especifique una versión anterior a 5.5.0 (el siguiente ejemplo utiliza 5.0.0):

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

            

Importación manual

• Descomprima el paquete de la versión anterior correspondiente. Importe AppPush siguiendo su guía de integración y, en Xcode, seleccione “Add files to 'Your project name'...” para añadir MTMA-ios-x.x.x.xcframework del mismo paquete al directorio del proyecto.

Inicializar el SDK

Inicialice el SDK MTMA después de llamar a la función de inicialización de MTPush. Las versiones anteriores de MTMA utilizan la AppKey de AppPush y no requieren configurar una MA AppKey por separado.

Añada los siguientes archivos de cabecera a AppDelegate.m:

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

            

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

    // Inicializar primero el SDK Push
    NSString *appKey = @"Su AppPush AppKey";
    NSString *channel = @"App Store";
    BOOL isProduction = NO;
    [MTPushService setupWithOption:launchOptions
                           appKey:appKey
                          channel:channel
                 apsForProduction:isProduction
            advertisingIdentifier:nil];

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

    return YES;
}

            

Descripción de algunos parámetros

• appKey
  • Asegúrese de que la appKey configurada en la aplicación coincida con la AppKey generada al crear la aplicación en la plataforma AppPush.
• channel
  • Especifica el canal de descarga del paquete de la aplicación. Defina el valor según sus necesidades para facilitar las estadísticas por canal, por ejemplo: App Store.
• apsForProduction
  • Identifica el entorno del certificado APNs utilizado por la aplicación actual.
  • 0 (predeterminado) indica un certificado de desarrollo; 1 indica un certificado de producción para publicar la aplicación.
  • Nota: El valor de este campo debe coincidir con el entorno del certificado configurado en Code Signing de Build Settings.
• completion
  • Callback del resultado de inicialización; code igual a 0 indica una inicialización correcta.