Añadir Adobe Analytics a la aplicación móvil

NOTA

Adobe recomienda utilizar el Editor de SPA para proyectos que requieren una representación del lado del cliente basada en el marco de aplicaciones de una sola página (por ejemplo, React). Más información.

¿Quiere crear experiencias atractivas y relevantes para los usuarios de su aplicación móvil? Si no utiliza el SDK de Adobe Mobile Services para supervisar y medir el ciclo de vida y el uso de las aplicaciones, ¿en qué basa sus decisiones? ¿Dónde están sus clientes más fieles? ¿Cómo puede garantizar que sigue siendo relevante y optimizando las conversiones?

¿Los usuarios acceden a todo el contenido? ¿Están abandonando la aplicación y, en caso afirmativo, dónde? ¿Con qué frecuencia permanecen en la aplicación y con qué frecuencia vuelven para usar la aplicación? ¿Qué cambios puede introducir y luego medir ese aumento de la retención? ¿Qué sucede con las tasas de bloqueo, si su aplicación se bloquea para sus usuarios?

Aproveche Análisis de aplicaciones móviles en sus aplicaciones AEM integrando con Adobe Mobile Services.

Instrumente sus aplicaciones AEM para realizar un seguimiento, informar y comprender cómo los usuarios interactúan con su aplicación móvil y contenido, y para medir métricas clave del ciclo vital como inicios, tiempo en la aplicación y tasa de bloqueo.

Esta sección describe cómo AEM Desarrolladores puede:

  • Integrar Mobile Analytics en la aplicación móvil
  • Pruebe el seguimiento de análisis con Bloodhound

Requisitos previos

AEM Mobile requiere una cuenta de Adobe Analytics para recopilar datos de seguimiento y crear informes de ellos en la aplicación. Como parte de la configuración, la AEM Administrador primero tendrá que :

  • Configure una cuenta de Adobe Analytics y cree un grupo de informes para la aplicación en Mobile Services.
  • Configuración de un Cloud Service de AMS en Adobe Experience Manager (AEM).

Para desarrolladores: Integre Mobile Analytics en su aplicación

Configure ContentSync para extraer el archivo de configuración

Una vez configurada la cuenta de Analytics, deberá crear una configuración de sincronización de contenido para extraer el contenido en la aplicación móvil.

Para obtener más información, consulte Configuración del contenido de sincronización de contenido . La configuración deberá indicar a Content Sync que coloque ADBMobileConfig en el directorio /www. Por ejemplo, en la aplicación de Geometrixx Outdoors, la configuración de sincronización de contenido se encuentra en: /content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-config/ams-ADBMobileConfig. También hay una configuración para el desarrollo; sin embargo, es idéntico a la configuración que no es de desarrollo en el caso de los Geometrixx Outdoors.

Para obtener más información sobre cómo descargar ADBMobileConfig desde el panel Aplicaciones AEM móviles, consulte Analytics - Mobile Services - Archivo de configuración del SDK de Adobe Mobile Services.

<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    extension="json"
    path="../../../.."
    selector="ADBMobileConfig"
    targetRootDirectory="www"
    type="mobileADBMobileConfigJSON"/>

Cada plataforma requiere que ADBMobileConfig se copie en una ubicación específica.

Si se crea con la CLI de PhoneGap, esto se puede hacer con un script de enlace de compilación de cordova. Esto se puede ver en la aplicación de Geometrixx Outdoors en:content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js.

Para iOS, el archivo deberá copiarse en el proyecto XCode Recursos directorio (p. ej. "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json"). Si la aplicación está dirigida a Android, la ruta a la que copiar es "platforms/android/assets/ADBMobileConfig.json". Para obtener más información sobre el uso de los enlaces durante la compilación de la CLI de PhoneGap, consulte Tres enlaces a las necesidades del proyecto Cordova/PhoneGap.

///////////////////////////
//          iOS
///////////////////////////
    ios : [
        {
            "www/ADBMobileConfig.json": "platforms/ios/<YOUR_APP_NAME>/Resources/ADBMobileConfig.json"
        }
    ],
///////////////////////////
//          ANDROID
///////////////////////////
    android: [
        {
            "www/ADBMobileConfig.json": "platforms/android/assets/ADBMobileConfig.json"
        }
    ]

Añadir el complemento de AMS en la aplicación

Para que la aplicación recopile los datos, el complemento de Adobe Mobile Services (AMS) debe incluirse como parte de la aplicación. Al incluir el complemento como una función en el archivo config.xml de la aplicación, se puede utilizar otro vínculo de Cordova para agregar automáticamente el complemento durante el proceso de compilación de PhoneGap.

<feature name="ADBMobile">
    <param name="id" value="https://github.com/Adobe-Marketing-Cloud/mobile-services#0482f9cedf90c98a8d4b07219ece1933b2e46a60"/>
</feature>

El archivo Geometrixx Outdoors App config.xml se encuentra en /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. El ejemplo anterior solicita una versión específica del complemento para utilizarlo añadiendo un '#' y, a continuación, un valor de etiqueta después de la dirección URL del complemento. Esta es una buena práctica a seguir para garantizar que no aparezcan problemas no previstos debido a que los complementos no probados se agregan durante una compilación.

Después de realizar estos pasos, su aplicación estará habilitada para informar de todas las métricas del ciclo vital proporcionadas por Adobe Analytics. Esto incluye datos como inicios, bloqueos e instalaciones. Si esos son los únicos datos que les importan, entonces ya están hechos. Si desea recopilar datos personalizados, deberá instrumentar el código.

Instrumente su código para el seguimiento completo de la aplicación

Hay varias API de seguimiento proporcionadas en la variable API del complemento AMS Phonegap.

Esto le permitirá realizar el seguimiento de estados y acciones, como por ejemplo hacia dónde navegan los usuarios en la aplicación, a qué controles se utilizan más. La forma más sencilla de instrumentar su aplicación para el seguimiento es utilizar las API de Analytics proporcionadas por el complemento de AMS.

  • ADB.trackState()
  • ADB.trackAction()

Como referencia, puede consultar el código en la aplicación de Geometrixx Outdoors. En la aplicación de Geometrixx Outdoors, se realiza un seguimiento de todas las navegaciones de página mediante el método ADB.trackState() . Para obtener más información, consulte el código fuente de /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js

Al instrumentar el código fuente con estas llamadas de método, puede recopilar métricas completas para su aplicación.

Prueba del seguimiento de Analytics con Bloodhound

De forma opcional, antes de implementar en producción puede utilizar la herramienta de Adobe Bloodhound para probar la configuración de análisis. Para probar la configuración de análisis, deberá editar el archivo ADBMobileConfig.json para que apunte al servidor en el que se está ejecutando Bloodhound en lugar del servidor de Analytics real. Para realizar este cambio, desde ADBMobileConfig.json cambie la siguiente entrada.

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "YOUR_TRACKING_SERVER:YOUR_TRACKING_PORT",
...

Cambie para que coincida con esta entrada:

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

Esto redireccionará a Bloodhound todos los datos recopilados por el complemento de AMS para que pueda ver los resultados.

Propiedades para conectarse a AMS

com.adobe.cq.mobile.mobileserservices.impl.service.MobileServicesHttpClientImp l expone las siguientes propiedades para conectarse a AMS:

Etiqueta Descripción Predeterminado
Punto final de API La URL base de las API HTTP de Adobe Mobile Services https://api.omniture.com
Punto final de configuración La URL utilizada para recuperar la configuración móvil de ADB para el ID del grupo de informes determinado /ams/1.0/app/config/
Aplicaciones de Mobile Services Obtener una lista de aplicaciones dentro de la empresa de usuarios /ams/1.0/apps

En esta página