Intergration Guide

Versiones aplicables

Versión v5.0.0 y posteriores. Actualmente, el SDK admite sistemas operativos móviles iOS 10 o superiores.

Para utilizar la función MA del SDK de EngageLab, es necesario integrar simultáneamente el módulo AppPush. En primer lugar, crear una aplicación en la plataforma de AppPush para obtener el AppKey.

Configurar el proyecto

Importar el SDK

Importar mediante CocoaPods

              
                  pod 'MTMA'

    Note: If you cannot import the latest version, please execute the command pod repo update master to update the local pod repository, and then execute pod 'MTMA' again.

            

• Si necesita instalar una versión específica, utilice el siguiente método (tomando como ejemplo la versión MTMA 5.0.0):

              
                  pod 'MTMA', '5.0.0'

            

Importación manual

• Descomprimir el paquete del SDK. En Xcode, seleccionar «Add files to 'Your project name'...» y añadir MTMA-ios-x.x.x.xcframework al directorio de su proyecto.

Inicializar el SDK

Inicializar el SDK MTMA después de llamar a la función de inicialización de MTPush

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

// Initialize the Push sdk first 
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
[MTPushService setupWithOption:launchOptions appKey:appKey
                      channel:channel
             apsForProduction:isProduction
        advertisingIdentifier:advertisingId];

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

    }

            

Explicación de algunos parámetros

• appKey
  • Para utilizar la función MA del SDK de EngageLab, es necesario integrar simultáneamente el módulo AppPush. Primero, crear una aplicación en la plataforma de AppPush para obtener el AppKey.
• channel
  • Especifica el canal de descarga del paquete de la aplicación. Para facilitar las estadísticas por canal, se puede definir el valor específico, por ejemplo: App Store.
• apsForProduction
  • Se utiliza para identificar el entorno del certificado de APNs que usa la aplicación actual.
  • 0 (valor predeterminado) indica que se utiliza un certificado de desarrollo, y 1 indica que se utiliza un certificado de producción para publicar la aplicación.
  • Se debe tener en cuenta que el valor de este campo debe ser coherente con el entorno del certificado configurado en Code Signing de Build Settings.