Instalación del SDK de Adobe Experience Platform Mobile

En esta lección, debe implementar el SDK móvil con las extensiones y la configuración correspondientes al entorno de desarrollo de la propiedad de etiquetas.

NOTA

Adobe Experience Platform Launch se está integrando en Adobe Experience Platform como un conjunto de tecnologías de recopilación de datos. Se han implementado varios cambios terminológicos en la interfaz que debe tener en cuenta al usar este contenido:

  • El platform launch (lado del cliente) ahora es tags
  • El lado del servidor de platform launch es ahora event forwarding
  • Las configuraciones de Edge ahora son datastreams

Requisitos previos

En esta lección empezaremos a agregar código a la aplicación Bus Booking, por lo que si aún no lo ha hecho:

  1. Descargar e instalar Android™ Studio
  2. Descargue la aplicación Bus Booking.

Objetivos de aprendizaje

Al final de esta lección, debe poder:

  • Obtener las instrucciones de instalación de la propiedad de la etiqueta móvil
  • Comprender la diferencia entre los entornos de desarrollo, de ensayo y de producción.
  • Actualizar el archivo build.gradle para agregar el SDK móvil.
  • Importar el SDK móvil en la aplicación.
  • Verificar que el SDK se haya implementado correctamente.
  • Habilitar métricas del ciclo vital en la aplicación.

Obtener las instrucciones de instalación

Las Instrucciones de instalación para las propiedades de etiquetas móviles son una colección de fragmentos de código que se agregan a ubicaciones específicas de la aplicación móvil.

Haga clic en la pestaña Environments en la navegación superior para ir a la página de entornos. Tenga en cuenta que los entornos de desarrollo, de estado y de producción ya se han creado. Estos se corresponden con las etapas habituales del proceso de programación y lanzamiento del código. Los desarrolladores escriben un código primero en un entorno de desarrollo (Development). Cuando han completado su trabajo, lo envían a un entorno de ensayo (Staging) para que el control de calidad y otros equipos lo revisen. Una vez estén conformes los equipos de control de calidad y otros equipos, el código se publica en el entorno de producción (Production), que es el entorno del público que los visitantes ven cuando descargan la aplicación.

Las etiquetas permiten entornos de desarrollo adicionales, lo que resulta útil en organizaciones grandes en las que varios desarrolladores trabajan en distintos proyectos al mismo tiempo.

Desarrollo, ensayo y producción son los únicos entornos que necesitamos para completar el tutorial.

Haga clic en Entornos en la barra de navegación superior

En la fila Desarrollo (Development), haga clic en el icono Instalar para abrir el modal del código de incrustación.

Haga clic en el icono para abrir el modal del código de incrustación

Veamos las instrucciones paso a paso.

Actualizar el archivo build.gradle

Si ya ha utilizado propiedades de etiquetas en sitios web, una de las primeras cosas de las que se dará cuenta es que hay muchas más instrucciones de instalación para aplicaciones móviles que para sitios web.

El SDK de Adobe Mobile para Android utiliza Gradle para administrar las dependencias entre sus distintos componentes. Una de las primeras cosas que haremos es añadir las dependencias del SDK de Adobe Mobile al archivo build.gradle de la aplicación Bus Booking.

Para actualizar el archivo build.gradle

  1. Abra Android™ Studio.

  2. Seleccione "Abrir un proyecto existente de Android™ Studio".

    Seleccione "Abrir un proyecto existente de Android™ Studio".

  3. Abra el archivo build.gradle en la carpeta principal de Android Booking:

    Abra el archivo build.gradle en la raíz de la carpeta Bus Booking Android™ .

  4. Abra la lista desplegable y cambie a la vista de proyecto.

    Seleccione “Proyecto” en la lista desplegable

  5. Abra el archivo Android > bus > build.gradle.

    Abra Android > bus > build.gradle

  6. En la interfaz de recopilación de datos, asegúrese de que el sistema operativo está configurado en Android

  7. Copie las dependencias en el portapapeles haciendo clic en el icono Copiar.

    Copiar dependencias al portapapeles en la interfaz de recopilación de datos

  8. En Android™ Studio, pegue las dependencias del portapapeles justo después de las dependencias existentes (pero antes de cerrar })

  9. Haga clic en el vínculo “Sincronizar ahora” para sincronizar el proyecto.

    Pegar dependencias en build.gradle

Actualizar la aplicación

Ahora es el momento de actualizar la aplicación para importar el SDK.

Para importar el SDK

  1. Abra el archivo Aplicación principal en la aplicación Bus Booking, que se encuentra en Android > bus > src > main > java > com.adobe.busbooking > DemoApplication.

    Abrir DemoApplication

  2. En la interfaz de recopilación de datos, desplácese hasta la sección Agregar código de inicialización .

  3. Copie las instrucciones de importación haciendo clic en el primer icono Copiar de la sección Añadir código de inicialización:

    Copiar las instrucciones de importación en el portapapeles

  4. En Android™ Studio, pegue estas instrucciones de importación antes las importaciones existentes en el archivo DemoApplication. Tenga en cuenta que la extensión principal incluye bibliotecas para admitir devoluciones de llamadas, el servicio de ID, las métricas del ciclo vital y el registro de consola, entre otras funciones.

    Pegar las instrucciones de importación en el archivo DemoApplication

  5. En la interfaz de recopilación de datos, copie las dos líneas relacionadas con la extensión principal haciendo clic en el segundo icono Copy de la sección Add Initialization Code. La segunda línea activa las instrucciones de registro de la consola (las opciones disponibles son “DEBUG”, “VERBOSE”, “WARNING” y “ERROR”).

    Copiar las instrucciones principales en el portapapeles

  6. En Android™ Studio, pegue estas instrucciones principales en el archivo DemoApplication justo después de super.onCreate()

  7. Elimine los comentarios de // antes de las líneas try y catch.

    Pegar las instrucciones principales en el archivo DemoApplication

  8. En la interfaz de recopilación de datos, copie las instrucciones de extensión haciendo clic en el tercer icono Copy de la sección Add Initialization Code.

    Copiar las instrucciones de extensión en el portapapeles

  9. En Android™ Studio, pegue estas instrucciones de extensión en la sección try . Tenga en cuenta que MobileCore.configureWithAppID contiene el identificador del entorno de desarrollo de etiquetas de su propiedad. Esto es importante, ya que tendrá que actualizar este valor cuando todo esté listo para implementar la aplicación en el entorno de producción.

    Pegar las instrucciones de extensión en el archivo DemoApplication

NOTA

Las instrucciones de instalación de Mobile que se proporcionan en la interfaz de recopilación de datos incluyen las instrucciones de importación y registro para las extensiones de ID, ciclo vital y señal, así como la inicialización de las métricas de ciclo vital. Estas extensiones se consideran parte de la extensión principal de Mobile. Si no desea utilizar estas extensiones en la aplicación, no es necesario importar, registrar ni implementar otro código asociado con estas extensiones.

Además, hay opciones de implementación adicionales que deben tenerse en cuenta al usar estas extensiones (por ejemplo, puede poner en pausa o reiniciar la colección de ciclo vital cuando el usuario esté en segundo plano o en primer plano de la aplicación). Puede obtener más información sobre esto en la documentación de la extensión principal de Mobile.

Verificar la implementación

  1. Guarde el proyecto de Android™ Studio.

  2. Ejecute la aplicación e iníciela en el emulador. Si no tiene ningún dispositivo emulador configurado, hágalo con uno ahora, asegurándose de configurar un dispositivo que ejecute Android 4.1 (API 16) o posterior.

    Ejecute la aplicación e iníciela en el emulador

  3. Espere a que se inicie el emulador y abra completamente la aplicación en la pantalla de reserva (puede tardar unos minutos).

    Espere a que la aplicación se abra completamente

  4. Confirme que se realizan llamadas a los servidores de Adobe en el Logcat de Android™ Studio.

    Espere a que la aplicación se abra completamente

A continuación, se muestran algunos ejemplos de llamadas específicas que puede buscar:

  1. Llamadas para recuperar la configuración de etiquetas (filtre Logcat a adobedtm.com). Tenga en cuenta las configuraciones de extensión que se han visto en la lección anterior. Aunque añadir la extensión requiere una actualización de la aplicación, esta configuración se puede administrar externamente con etiquetas y cambiar en cualquier momento:

    03-14 16:30:29.484 24869-24930/com.adobe.busbooking D/ADBMobile: ConfigurationExtension - Cached configuration loaded.
     {"target.propertyToken":"","target.timeout":5,"global.privacy":"optedin","analytics.backdatePreviousSessionInfo":true,"analytics.offlineEnabled":true,"build.environment":"dev","rules.url":"https://assets.adobedtm.com/launch-EN360aefc739b04410816f751a95861744-development-rules.zip","experienceCloud.org":"7ABB3E6A5A7491460A495D61@AdobeOrg","target.clientCode":"techmarketingdemos","target.autoFetch":true,"target.fetchBackground":false,"lifecycle.sessionTimeout":300,"target.environmentId":"busbookingapp","analytics.server":"tmd.sc.omtrdc.net","analytics.rsids":"tmd-mobile-dev1","analytics.batchLimit":0,"property.id":"PRb4881271498b4f2cbaf67d38a8f3891a","global.ssl":true,"analytics.aamForwardingEnabled":true}
    
  2. Solicitud al servicio de ID (filtre Logcat a IdentityExtension). En este ejemplo, el ID (d_mid) ya se ha establecido y se vuelve a registrar.

    03-14 17:01:18.526 7743-7803/com.adobe.busbooking D/ADBMobile: IdentityExtension - Sending request (https://dpm.demdex.net/id?d_mid=59651426340521082405908216148091920022&d_ver=2&d_orgid=7ABB3E6A5A7491460A495D61%40AdobeOrg)
    
  3. Solicitud de Analytics (filtre Logcat a AnalyticsExtension).

    03-14 17:01:18.509 7743-7777/com.adobe.busbooking D/ADBMobile: AnalyticsExtension - Sending Analytics ID call (https://tmd.sc.omtrdc.net/id?mcorgid=7ABB3E6A5A7491460A495D61%40AdobeOrg&mid=59651426340521082405908216148091920022)
    

¡Felicidades, ha agregado el SDK a una aplicación móvil!

Habilitar métricas del ciclo vital en la aplicación

Las métricas del ciclo vital son métricas y dimensiones basadas en el entorno que se pueden activar fácilmente en una aplicación mediante el SDK de Experience Platform Mobile. Dado que pueden utilizarse en varias soluciones de Experience Cloud, las habilitaremos aquí antes de profundizar en las soluciones individuales. Esto es tan sencillo como agregar un par de líneas de código a nuestra aplicación en el lugar adecuado.

Importar la biblioteca principal al archivo BusBookingActivity

Para realizar llamadas de API mediante el SDK de Adobe Experience Platform Mobile, debe importar las bibliotecas en los archivos correspondientes. En este caso, para utilizar la llamada a la API de ciclo vital, debemos importar la biblioteca principal.

  1. Con la aplicación abierta en Android™ Studio, abra el archivo BusBookingActivity, que se encuentra en el mismo directorio que el archivo DemoApplication en el que ha estado trabajando.
  2. En la parte superior del archivo, añada la siguiente instrucción de importación de la extensión principal de Mobile para que pueda utilizar las llamadas de API asociadas.
    import com.adobe.marketing.mobile.MobileCore;

Importación de la biblioteca principal de Mobile

Añadir el código de ciclo vital.

Ahora se agrega el código de ciclo vital a la función onResume() principal de la aplicación para activar las funciones de ciclo vital.

  1. Abra el archivo BusBookingActivity.

  2. Desplácese hacia abajo cerca de la parte inferior del archivo y busque la función onResume().

  3. Agregue las dos líneas de código siguientes debajo de la línea super.onResume():

     MobileCore.setApplication(getApplication());
     MobileCore.lifecycleStart(null);
    

Insertar código de ciclo vital

Validar la visita individual al ciclo vital

Al ejecutar la aplicación, ahora debe obtener uno o más mensajes del ciclo vital en la sección de depuración de Android™ Studio.

  1. Ejecute una compilación y elija un simulador para iniciar la aplicación.
  2. Una vez que el simulador esté en funcionamiento, haga clic en la sección "Ejecutar" del depurador en Android™ Studio.
  3. Realice una búsqueda para internalaction=Lifecycle.
  4. Observe que hay líneas que incluyen este par clave/valor, así como otras métricas del ciclo vital.

Tenga en cuenta que las líneas que verá serán en realidad llamadas de Analytics con métricas del ciclo vital.

Validar ciclo vital

Siguiente: “Añadir el servicio de ID de Adobe Experience Platform” >

En esta página