Show Menu
TEMAS×

Implementación principal y ciclo vital

Esta información le ayuda a implementar la biblioteca iOS y a recopilar métricas del ciclo vital como lanzamientos, actualizaciones, sesiones, usuarios comprometidos, etcétera.

Descargar el SDK

Para descargar los SDK, debe utilizar iOS 6 o posterior.
Requisitos previos
Antes de descargar el SDK, complete los pasos en Crear un grupo de informes en Implementación principal y ciclo vital para configurar un grupo de informes de desarrollo y descargar una versión previamente rellenada del archivo de configuración.
Para descargar el SDK:
  1. Descargue y descomprima el archivo [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip y compruebe que dispone de los siguientes componentes de software:
    • ADBMobile.h , el archivo de encabezado Objective-C empleado para llamadas iOS AppMeasurement.
    • ADBMobileConfig.json , que es el archivo de configuración del SDK personalizado para su aplicación.
    • AdobeMobileLibrary.a , un binario multiarquitectura habilitado para código de bits que contiene las compilaciones de biblioteca para los simuladores (i386, x86_64) y dispositivos iOS (armv7, armv7s, arm64).
      Este binario multiarquitectura se debe vincular cuando el destino se dirija a una aplicación iOS.
    • AdobeMobileLibrary_Extension.a , un binario multiarquitectura habilitado para código de bits que contiene las compilaciones de biblioteca para los simuladores (i386, x86_64) y dispositivos iOS (armv7, armv7s, arm64).
      Este binario multiarquitectura se debe vincular cuando el destino se dirija a una extensión iOS.
    • AdobeMobileLibrary_Watch.a , un binario multiarquitectura habilitado para código de bits que contiene las compilaciones de biblioteca para los simuladores (i386, x86_64) y dispositivos Apple Watch (armv7k).
      Este binario multiarquitectura se debe vincular cuando el destino se dirija a una aplicación de extensión Apple Watch (watchOS 2).
    • AdobeMobileLibrary_TV.a , un binario multiarquitectura habilitado para código de bits que contiene las compilaciones de biblioteca para el simulador (x86_64) y los dispositivos Apple TV (arm64) nuevos.
      Este binario multiarquitectura se debe vincular cuando el destino se dirija a una aplicación Apple TV (tvOS).
Si descarga el SDK fuera de la interfaz de usuario de Adobe Mobile Services, el archivo ADBMobileConfig.json deberá configurarse de forma manual. Si no tiene experiencia previa con Analytics ni con el SDK de Mobile y desea configurar un grupo de informes de desarrollo y descargar una versión previamente rellenada del archivo de configuración, consulte Antes de empezar .

Añadir el SDK y el archivo de configuración a su proyecto

  1. Inicie el IDE de Xcode y abra la aplicación.
  2. En Navegador de proyectos, arrastre el directorio AdobeMobileLibrary y suéltelo debajo de su proyecto.
  3. Compruebe lo siguiente:
    • La casilla de verificación Copiar elementos si es necesario está seleccionada.
    • Crear grupos está seleccionado.
    • Ninguna de las casillas de verificación en la sección Agregar a destinos está seleccionada.
  4. Haga clic en Finalizar .
  5. En el Navegador de proyectos , seleccione ADBMobileConfig.json .
  6. En el Inspector de archivos , agregue el archivo JSON a cualquier destino de su proyecto que vaya a utilizar el SDK de Adobe.
  7. En el Navegador de proyectos, complete los pasos siguientes:
    1. Haga clic en su aplicación.
    2. En la ficha General , seleccione sus destinos y vincule los marcos y bibliotecas necesarios en las secciones Marcos vinculados y bibliotecas .
    • Destinos de aplicaciones iOS
      • SystemConfiguration.framework
      • WebKit.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary.a
      • CoreLocation.framework (opcional, pero necesaria para las funcionalidades de seguimiento geográfico)
    • Extensión iOS Target
      • SystemConfiguration.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_Extension.a
    • Apple Watch (watchOS 2) Target
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_Watch.a
    • Apple TV (tvOS) Target
      • SystemConfiguration.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_TV.a
    Vincular más de un archivo AdobeMobileLibrary*.a en el mismo destino resultará en un comportamiento inesperado o en la imposibilidad de compilar.
  8. Confirme que la aplicación se compila sin errores.

Implementar métricas del ciclo vital

iOS enviará la información del ciclo de vida con o sin llamar collectlifecycledata ; y collectlifecycledata es solo una forma de iniciar el ciclo de vida antes en la secuencia de lanzamiento de la aplicación.
Después de habilitar el ciclo vital, cada vez que inicie la aplicación se enviará una visita para medir inicios, actualizaciones, sesiones, usuarios comprometidos y otras Métricas del ciclo vital .
Añada una llamada collectLifecycleData / collectLifecycleDataWithAdditionalData en application:didFinishLaunchingWithOptions :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
 [ADBMobile collectLifecycleData]; 
    return YES; 
}

Incluir datos adicionales en las llamadas al ciclo vital

Para incluir datos adicionales en las llamadas al ciclo vital, utilice collectLifecycleDataWithAdditionalData :
Cualquier dato pasado al SDK mediante collectLifecycleDataWithAdditionalData: será persistente en NSUserDefaults por acción del SDK. El SDK elimina del parámetro NSDictionary los valores que no pertenezcan a los tipos NSString o NSNumber .
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
    NSMutableDictionary *contextData = [NSMutableDictionary dictionary]; 
    [contextData setObject:@"Game" forKey:@"myapp.category"]; 
    [ADBMobile collectLifecycleDataWithAdditionalData:contextData]; 
    return YES; 
}

El valor de los datos de contexto adicionales que se envían con collectLifecycleDataWithAdditionalData debe asignarse a variables personalizadas en Adobe Mobile Services:
Otras métricas del ciclo vital se recopilan automáticamente. Para obtener más información, consulte Métricas del ciclo vital .

Qué hacer a continuación

Complete las siguientes tareas: