Añadir Adobe Analytics

En esta lección, debe habilitar el seguimiento de Adobe Analytics en su aplicación.

Adobe Analytics es una solución líder del sector que le permite comprender a sus clientes como personas y dirigir su negocio con inteligencia de clientes.

En las lecciones de Añadir extensiones e Instalar el SDK móvil, ha añadido la extensión de Adobe Analytics a la propiedad de etiqueta y la ha importado en la aplicación de ejemplo. Ahora, todo lo que tiene que hacer es agregar código para hacer un seguimiento de los estados y las acciones en la aplicación.

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

Objetivos de aprendizaje

Al final de esta lección, debe poder:

  • Verificar que las métricas del ciclo vital se envíen a Adobe Analytics.
  • Añadir un código para hacer un seguimiento de estados en la aplicación con datos adicionales.
  • Añadir un código para hacer un seguimiento de acciones en la aplicación con datos adicionales.

Se pueden implementar muchas cosas para Analytics en etiquetas. Este tutorial no está completo, pero le ofrece una visión general fiable de las principales técnicas que necesita para implementarlo todo en su propia aplicación.

Requisitos previos

Ya debería haber completado las lecciones en la sección Configurar etiquetas. En esa sección, agregó la extensión de Analytics y configuró el servidor de seguimiento y los ID del grupo de informes.

Métricas del ciclo vital y Adobe Analytics

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.

Ya habilitó las métricas del ciclo vital cuando agregó la extensión principal a su propiedad y siguió las instrucciones de instalación móvil que aparecen en la interfaz. Estas métricas y dimensiones, incluidas las métricas específicas del entorno y la aplicación, como la versión de la aplicación, el número de usuarios comprometidos, la versión del sistema operativo, la partición de tiempo, los días transcurridos desde el último uso, etc. pueden ser muy útiles en el análisis de la aplicación, sobre todo cuando se crean segmentos de Analytics a partir de ellos para aplicarlos a todos los informes. La lista completa de métricas está disponible en la documentación.

Importación de la biblioteca ACPCore

En la lección anterior, titulada “Instalar el SDK móvil”, ha añadido una instrucción de importación para que la biblioteca principal de Adobe esté disponible en el archivo BusBookingActivity. Esta misma biblioteca se utilizará para llamadas de API adicionales en las actividades de esta lección. En los próximos ejercicios, usará las API para rastrear estados (“trackState”) y acciones (“trackAction”) en su aplicación, que se definen en la biblioteca principal de Adobe. En el nuevo SDK de Experience Cloud Platform Mobile, las API trackState y trackAction se han trasladado de la biblioteca de Analytics a la biblioteca principal, lo que permite utilizar estas API para otros fines que no sean solo el seguimiento de Adobe Analytics.

Seguimiento de estados

En la aplicación, es posible que tenga muchas pantallas de contenido diferentes que proporcionar a los usuarios. Son equivalentes a las páginas de un sitio web. Adobe Analytics proporciona un método para enviar estas “visitas de vista de página” y verlas en los mismos informes a los que está acostumbrado para sus propiedades web. Este método se denomina “trackState”.

En este tutorial, solo colocará el código de una llamada a trackState en una pantalla (página) de la aplicación. En la vida real, lo replicará en todas las demás pantallas o estados de la aplicación.

A continuación, encontrará una sintaxis y un ejemplo de código de la documentación que puede copiar y pegar en este tutorial o en su propia aplicación.

Sintaxis:

public static void trackState(final String state, final Map<String, String> contextData)

Ejemplo:

HashMap cData = new HashMap<String, String>();
contextData.put("key", "value");
MobileCore.trackState("state name",contextData);

Seguimiento de un estado sin datos

  1. Con la aplicación de ejemplo abierta en Android™ Studio, vaya a BusBookingActivity y desplácese hacia abajo, cerca de la parte inferior, hasta la función onResume .

  2. Agregar una llamada de método trackState.

  3. Configure state name en “Pantalla de reserva”.

  4. En lugar de agregar datos adicionales, agregue null como marcador de posición en la llamada de API.

  5. O bien, copie y pegue lo siguiente:

    MobileCore.trackState("Booking Screen", null);
    

Llamada trackState básica

Para validar trackState

  1. Guarde, cree y ejecute el proyecto.

  2. Cuando se ejecute el simulador y se abra la pantalla principal de la aplicación, consulte la consola de depuración de Logcat de Android™ Studio.

  3. Buscar pageName=Booking%20Screen en la consola.

  4. Tenga en cuenta que la variable nombre de página (pageName) está configurada en Booking Screen (con %20 como espacio codificado) y no hay otros pares de datos personalizados. Aunque técnicamente está configurando un “nombre de estado” (State Name) y no un “nombre de página” (Page Name), el nombre de parámetro utilizado es pageName para proporcionar coherencia con las implementaciones de sitios web.

    Resultado trackState básico

Seguimiento de un estado con datos

  1. Vuelva a BusBookingActivity y agregue una importación a la parte superior del archivo import java.util.HashMap; debajo de las importaciones existentes.

  2. En la función onResume(), comente (o elimine) la llamada trackState básica del último ejercicio.

  3. Añada una nueva llamada de método trackState, esta vez con datos, creando y nombrando un HashMap, utilizando el comando “put” para incluir algunos pares clave/valor y luego llamar a ese HashMap en la llamada trackState.

  4. Deje state name como “Pantalla de reserva”.

  5. O bien, copie y pegue en:

    HashMap cData = new HashMap<String, String>();
    cData.put("cd.section", "Bus Booking");
    cData.put("cd.subSection", "Booking");
    cData.put("cd.conversionType", "Landing");
    MobileCore.trackState("Booking Screen", cData);
    

    Llamada trackState con datos

Para validar trackState con datos

  1. Guarde, cree y ejecute de nuevo el proyecto.

  2. Cuando se ejecute el simulador y se abra la pantalla principal de la aplicación, consulte la consola de depuración de Logcat de Android™ Studio.

  3. Busque subSection (o cualquiera de las claves o valores introducidos en el código).

  4. Ahora observe que además de nombre de página (pageName) que se está configurando, también tiene los pares clave/valor que se enviaron en la visita individual.

    trackState con resultado de datos

NOTA

Si está familiarizado con las “props y eVars” en Analytics, verá que estos nombres de variables no están en el SDK. Todos los datos de clave y valor procedentes del SDK se envían como variables contextData y, como tales, deben asignarse a props o eVars (u otras variables) mediante reglas de procesamiento en la interfaz de usuario de Analytics.

Seguimiento de acciones

De forma similar a rastrear las acciones que no son de carga de página en un sitio web, con frecuencia desea hacerle el seguimiento a una acción que un usuario realiza en la aplicación, por ejemplo, hacer clic en cosas que no cargan otra pantalla. Esto se gestiona de forma similar a trackState, que se ha utilizado anteriormente, excepto que este método se denomina trackAction.

A continuación se muestra una sintaxis y un ejemplo de código de la documentación.

Sintaxis:

public static void trackAction(final String action, final Map<String, String> contextData) data;

Ejemplo:

HashMap<String, String> contextData = new HashMap<String, String>();
contextData.put("key", "value");
MobileCore.trackAction("action taken", contextData);

Seguimiento de la interacción con el conmutador de destino

En esta aplicación de Bus Booking de ejemplo, puede cambiar la ciudad de origen por la ciudad de destino haciendo clic en la flecha entre estos dos valores. Ha decidido que desea rastrear la interacción con esta función en Adobe Analytics.

Cambio de destino

Este conmutador se controla en el archivo BusBookingActivity del proyecto de ejemplo. En este ejercicio, debe enviar una visita individual de trackAction cada vez que las personas hagan clic en ella.

Para añadir el código trackAction

  1. Con el proyecto de ejemplo abierto en Android™ Studio, vaya a BusBookingActivity.

  2. Busque la función “mBtnFlip.setOnClickListener” en la línea 57 o alrededor de ella.

  3. Expanda la función si es necesario, para que pueda ver todo el código.

  4. En la función onClick, en la llamada a flipSourceDesti(), agregue una llamada trackAction().

  5. Establezca el nombre de la acción en “Flip Destination” y añada “null” para el parámetro contextData (ya que esta vez no hace falta enviar información adicional).

  6. Puede copiar y pegar el siguiente código

    MobileCore.trackAction("Flip Destination", null);
    

Así aparece ahora la función:

Código de cambio de destino

Para validar el código trackAction

  1. Después de agregar el código, guarde el proyecto, ejecútelo y genérelo.

  2. Haga clic en el icono de la papelera para eliminar datos de la consola de Logcat.

  3. Haga clic en la flecha del cambio de destino en el simulador y observe que aparece una nueva solicitud (o más) en la consola.

  4. Busque Flip%20Destination en Logcat.

  5. Localice tanto los parámetros action como pev2 y Flip%20Destination (con espacio codificado).

  6. Localice el par clave/valor pe=lnk_o en la misma línea, que muestra que se trata de una visita de “vínculo personalizado”, desencadenada por trackAction.

¡Buen trabajo! Ha completado la lección de Analytics. Por supuesto, hay muchas otras cosas que puede hacer para mejorar nuestra implementación de Analytics, pero esperamos que esto le haya dado algunas de las habilidades básicas para satisfacer el resto de sus necesidades.

Beneficios adicionales de trackState y trackAction

En estos últimos ejercicios, pudo enviar datos de la aplicación a Adobe Analytics mediante las API trackState y trackAction. Dado que el SDK de Experience Platform Mobile está basado en etiquetas, hay muchas más cosas que puede hacer en la interfaz de recopilación de datos con el código que acaba de añadir.

En las etiquetas, puede crear reglas activadas por las API trackState y trackAction y hacer que ejecuten acciones adicionales, como realizar solicitudes a otras soluciones de Adobe o socios externos.

Siguiente: “Añadir Adobe Audience Manager” >

En esta página