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. ¡De hecho, ya están agregadas!

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.

Visualización de la visita al ciclo vital de Analytics

Aunque puede ver las visitas del ciclo vital en cualquier programa de depuración o detector de paquetes, solo las mostraremos en la consola de depuración de Xcode.

  1. Cree y ejecute el proyecto en Xcode para que se inicie el simulador.

  2. En la consola de depuración de Xcode, escriba lifecycle en el filtro de la parte inferior para limitar lo que aparece y, a continuación, desplácese hasta la parte inferior de las entradas.

  3. Observe la sección Analytics request was sent with body.

  4. Las métricas del ciclo vital incluyen elementos como AppID, CarrierName, DayOfWeek, DaysSinceFirstUse y otras métricas y dimensiones que se enumeran en la documentación.

    Depuración de visitas en el ciclo vital

Importación de la biblioteca ACPCore

En los próximos ejercicios, usará las API para rastrear estados (“trackState”) y acciones (“trackAction”) en su aplicación. Para utilizar estas API, debe importar la biblioteca que las contiene. 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.

En este tutorial, solo realizará el seguimiento de un estado, pero en la aplicación real, podrá rastrear varios.

Para importar la biblioteca ACPCore

  1. Abra el archivo BookingViewController.m en Xcode.

  2. En la parte superior del archivo (normalmente junto con otras instrucciones de importación), agregue #import "ACPCore.h".

  3. Guarde.

  4. Ya está listo para usar las API “trackState” o “trackAction” en este archivo.

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. También puede explorar distintas formas de enviar datos (pares clave/valor) con la visita.

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:

+ (void) trackState: (nullable NSString*) state data: (nullable NSDictionary*) data;

Ejemplo:

[ACPCore trackState:@"state name" data:@{@"key":@"value"}];

Seguimiento de un estado sin datos

  1. Con la aplicación de ejemplo abierta en Xcode, vaya a BookingViewController.m y, en la función viewDidLoad(), agregue una llamada de método trackState.

  2. Defina state name en “Pantalla principal”.

  3. En lugar de agregar datos adicionales, añada null como marcador de posición en la llamada de método.

  4. O bien, copie y pegue lo siguiente:

    [ACPCore trackState:@"Home Screen" data:nil];
    

    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, vea la consola de Xcode.

  3. Filtre la consola a las entradas con “principal” y observe la entrada inferior que muestra que la variable Analytics request was sent with body.

  4. Tenga en cuenta que la variable pageName está configurada en Home Screen 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 BookingViewController.m y, en la función viewDidLoad(), comente (o elimine) la llamada trackState básica (sin datos agregados) desde el último ejercicio.

  2. Añada una nueva llamada de método trackState, esta vez con datos, usando key1 como clave y value1 como valor.

  3. Deje state name como “Pantalla principal”.

  4. O bien, copie y pegue en:

    [ACPCore trackState:@"Home Screen" data:@{@"key1":@"value1"}];
    

    Llamada trackState básica

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, vea la consola de Xcode.

  3. Deje el filtro como “principal” y observe la entrada inferior que muestra que Analytics request was sent with body.

  4. Ahora verá que, además del nombre de página (pageName) configurado, también incluye el par clave/valor que se envió en la visita.

    Resultado trackState básico

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.

Opciones adicionales de envío de datos

En los dos ejercicios anteriores ha hecho dos solicitudes, una con datos adicionales y otra sin datos. Sin embargo, ¿qué sucede si desea enviar varios puntos de datos a Analytics con una pantalla o una carga de estado? Debajo hay dos opciones.

Opción 1: varios pares clave/valor

En la llamada trackState, tiene la opción de enviar varios pares de clave/valor, basta con separarlos mediante comas en el conjunto de datos. Por ejemplo:

[ACPCore trackState:@"Home Screen" data:@{@"key1":@"value1",@"key2":@"value2",@"key3":@"value3"}];

Opción 2: objeto de diccionario

También puede definir un diccionario en código y enviarlo después con trackState. Por supuesto, si ya ha definido algunos objetos de diccionario en el código y desea enviarlos a Analytics, esta es la opción que buscaba. Por ejemplo:

NSDictionary *theStuff = @{@"key1": @"value1",@"key2": @"value2"};
[ACPCore trackState:@"Home Screen" data:theStuff];

Crédito adicional
Pruebe estas dos opciones en su código y compruebe los resultados en la consola de depuración de Xcode. Puede utilizar el mismo filtro que antes y comprobar los resultados para asegurarse de que las variables y los valores se transmiten correctamente.

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. Se gestiona de forma muy similar a trackState, que se ha utilizado anteriormente, excepto que dicho método se denomina trackAction.

A continuación se muestra 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:

+ (void) trackAction: (nullable NSString*) action data: (nullable NSDictionary*) data;

Ejemplo:

[ACPCore trackAction:@"action name" data:@{@"key":@"value"}];

Rastrear interacción con la casilla de verificación “Sin interrupciones”

En esta aplicación de Bus Booking de ejemplo, hay una casilla de verificación que permite a los usuarios decidir si desean limitar los resultados de búsqueda a determinadas opciones. Ha decidido que desea rastrear la interacción con esa casilla de verificación en Adobe Analytics.

Casilla de verificación “Sin interrupciones” (NonStop)

Esta casilla de verificación está controlada en el archivo BookingViewController.m del proyecto de ejemplo. En este ejercicio, debe enviar una visita de trackAction cada vez que las personas marquen o desmarquen la casilla.

Configuración del código trackAction

  1. Con el proyecto de ejemplo abierto en Xcode, vaya a BookingViewController.m y busque la función “nonStopButtonToggled”.

  2. En la condición if, la primera sección anula la selección del cuadro si ya está seleccionado. En este caso, quiere enviar una visita con el valor “off”, utilizando el siguiente código:

    [ACPCore trackAction:@"NonStop Button Interaction" data:@{@"NonStop":@"off"}];
    
  3. En la siguiente sección (la sección “else”), marca la casilla si no lo está ya. En este caso, quiere enviar una visita con el valor “on”, utilizando el siguiente código:

    [ACPCore trackAction:@"NonStop Button Interaction" data:@{@"NonStop":@"on"}];
    

Observe las demás personalizaciones del código:

  • Está configurando action name en “Interacción de botón sin interrupciones”. Este valor rellenará el parámetro “action” de la solicitud y el informe o la dimensión del vínculo personalizado en Adobe Analytics.
  • El nombre del key que se está utilizando es “Sin interrupciones”. Este es el nombre clave que puede buscar en Reglas de procesamiento en la Admin Console de Analytics, para poder asignar estos valores a una prop o eVar.

Así aparece ahora la función:

Casilla de verificación “Sin interrupciones” (NonStop)

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.

  3. Marque la casilla en el simulador y observe que aparecen dos solicitudes en la consola. El último es el envío de datos a Adobe Analytics desde el código que acaba de agregar.

  4. Observe que tanto los parámetros action como pev2 están configurados en “Interacción de botón NonStop” (con espacios codificados).

  5. Observe que el par clave/valor “NonStop=on” está presente y se puede asignar a una prop/eVar en las reglas de procesamiento.

  6. Observe la clave o el valor “pe=lnk_o”, que muestra que se trata de una visita de “vínculo personalizado”, desencadenada por trackAction.

    Resultado de trackAction en Debugger

¡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