Analytics

Después de agregar la biblioteca al proyecto, puede realizar cualquiera de las llamadas de método de Analytics en cualquier parte de la aplicación.

SUGERENCIA

Asegúrese de importar ADBMobile.h a su clase.

Habilitar los informes de aplicaciones móviles en Analytics

Antes de agregar código, pida a su administrador de Analytics que complete lo siguiente para habilitar el seguimiento de ciclo vital de las aplicaciones de Mobile. Esto garantiza que el grupo de informes esté listo para capturar métricas a medida que comience el desarrollo.

  1. Apertura Herramientas de administración > Grupos de informes y seleccione sus grupos de informes móviles.

  2. Haga clic en Editar configuración > Administración de Mobile > Informes de aplicaciones de Mobile.

    Configuración de Mobile

  3. Haga clic en Habilitar los informes de aplicaciones más recientes.

    Opcionalmente, también puede hacer clic en Habilitar el seguimiento de ubicación de Mobile o Habilitar la atribución y los informes heredados para las visitas individuales en segundo plano.

    Habilitar ciclo vital

Las métricas del ciclo vital ya están listas para capturarse, y los informes de aplicaciones de Mobile aparecen en la sección Informes en la interfaz de informes de marketing.

Nuevas versiones

Periódicamente, se publican nuevas versiones de informes de aplicaciones móviles. Las versiones nuevas no se aplican automáticamente al grupo de informes, debe repetir estos pasos para realizar la actualización. Cada vez que agregue nuevas funciones de Experience Cloud a su aplicación, le recomendamos que repita estos pasos para asegurarse de que tiene la configuración más reciente.

Métricas del ciclo vital

Para recopilar métricas del ciclo vital en la aplicación, agregue llamadas a cuando la aplicación esté activada, como se muestra en los ejemplos siguientes.

WinJS en default.js

app.onactivated = function (args) {
  if (args.detail.kind === activation.ActivationKind.launch) {
   ...
   // launched and resumed stuff
   ADBMobile.Config.collectLifecycleData();
  }
};
app.oncheckpoint = function (args) {
  ADBMobile.Config.pauseCollectingLifecycleData();
};

C# en App.xaml.cs

public App()
{
    this.InitializeComponent();
    this.Resuming += OnResuming;
    this.Suspending += OnSuspending;
}
protected override void OnLaunched(LaunchActivatedEventArgs e)
{   ...
    ADBMobile.Config.CollectLifecycleData();
    ...
}
private void OnResuming(object sender, object e)
{
    ...
    ADBMobile.Config.CollectLifecycleData();
    ...
}
private void OnSuspending(object sender, SuspendingEventArgs e)
{
    ...
    ADBMobile.Config.PauseCollectingLifecycleData();
    ...
}

C++/CX en App.xaml.cpp

App::App()
{
 InitializeComponent();
 Resuming += ref new EventHandler<Object ^>(this, &App::OnResuming);
 Suspending += ref new SuspendingEventHandler(this, &App::OnSuspending);
}
void App::OnResuming(Object ^sender, Object ^args)
{
 ...
 ADBMobile::Config::CollectLifecycleData();
 ...
}
void App::OnSuspending(Object^ sender, SuspendingEventArgs^ e)
{
 ...
 ADBMobile::Config::PauseCollectingLifecycleData();
 ...
}
void App::OnLaunched(Windows::ApplicationModel::Activation::LaunchActivatedEventArgs^ e)
{
 ...
 ADBMobile::Config::CollectLifecycleData();
 ...
}

If CollectLifecycleData() se llama dos veces en la misma sesión, la aplicación informa de un bloqueo en cada llamada posterior a la primera. El SDK establece un indicador cuando la aplicación se cierra, que indica una salida correcta. Si no se establece este indicador, CollectLifecyleData() informa de un bloqueo.

Eventos, props y eVars

Si ha visto Métodos SDK, probablemente se esté preguntando dónde se configuran los eventos, las eVars, las props, los herederos y las listas. En la versión 4, ya no puede asignar estos tipos de variables directamente en la aplicación. En su lugar, el SDK utiliza datos de contexto y reglas de procesamiento para asignar los datos de la aplicación a variables de Analytics para el sistema de informes.

Las reglas de procesamiento ofrecen varias ventajas:

  • Puede cambiar la asignación de datos sin enviar una actualización a la tienda de aplicaciones.
  • Puede utilizar nombres significativos para los datos en lugar de establecer variables específicas de un grupo de informes.
  • El envío de datos adicionales tiene poco impacto. Estos valores no aparecerán en los informes hasta que se asignen mediante reglas de procesamiento.

Cualquier valor que asignara directamente a variables debe agregarse a los datos de contexto.

Reglas de procesamiento

Las reglas de procesamiento se utilizan para copiar los datos que envía en variables de datos de contexto a eVars, props y otras variables con el fin de realizar informes.

Ayuda de las reglas de procesamiento

Adobe recomienda agrupar las variables de datos de contexto mediante "áreas de nombres", ya que ayuda a mantener el orden lógico. Por ejemplo, si desea recopilar información sobre un producto, puede definir las siguientes variables:

"product.type":"hat";
"product.team":"mariners";
"product.color":"blue";

Las variables de datos de contexto se ordenan alfabéticamente en la interfaz de reglas de procesamiento, por lo que los espacios de nombres permiten ver rápidamente las variables que están en el mismo espacio de nombres.

Además, hemos oído que algunos de ustedes están nombrando claves de datos de contexto usando el número de eVar o propiedad:

"eVar1":"jimbo";

Esto podría hacer que ligeramente es más fácil cuando se realiza la asignación de una sola vez en las reglas de procesamiento, pero se pierde la legibilidad durante la depuración y las futuras actualizaciones de código pueden ser más difíciles. En su lugar, se recomienda encarecidamente utilizar nombres descriptivos para claves y valores:

"username":"jimbo";

Establezca variables de contexto que definan eventos de contador con el valor "1":

"logon":"1";

Las variables de datos de contexto que definen eventos de aumento pueden tener el valor que aumentar:

"levels completed":"6";
SUGERENCIA

Adobe reserva el espacio de nombres a.. Aparte de esta restricción, las variables de datos de contexto solo deben ser exclusivas en su empresa de inicio de sesión para evitar conflictos.

Variable products

Para configurar products en el SDK móvil, debe utilizar una sintaxis especial. Para obtener más información, consulte Variable products.

(Opcional) Habilitar el seguimiento sin conexión

Para almacenar visitas cuando el dispositivo está sin conexión, puede habilitar el seguimiento sin conexión en la Métodos SDK archivo. Preste mucha atención a los requisitos de marca de tiempo descritos en la referencia del archivo de configuración antes de habilitar el seguimiento sin conexión.

Geolocalización y puntos de interés

La geolocalización le permite medir datos de ubicación (latitud/longitud) y puntos de interés predefinidos. Cada TrackLocation envía llamadas:

  • Latitud/longitud y puntos de interés (si se encuentra dentro de un punto de interés definido en la variable ADBMobileConfig.json archivo de configuración).

    Se pasan a variables de soluciones móviles para el sistema de informes automático.

  • Distancia desde el centro y precisión que pasan como datos de contexto.

    Captura mediante una regla de procesamiento.

Para realizar el seguimiento de una ubicación:

var ADB = ADBMobile;
ADB.Analytics.trackLocation(37.75345, -122.33207, null);

Si el siguiente punto de interés está definido en la variable ADBMobileConfig.json Archivo de configuración:

"poi" : [
            ["San Francisco",37.757144,-122.44812,7000],
        ]

Cuando se determina que la ubicación del dispositivo se encuentra dentro de un radio de 7000 metros del punto definido, se a.loc.poi variable de datos de contexto con el valor San Francisco se envía con la variable TrackLocation visita individual. Un a.loc.dist la variable de contexto se envía con la distancia en metros desde las coordenadas definidas.

Valor de duración

El valor de duración le permite medir y tomar como destino un valor de duración para cada usuario. Cada vez que envía un valor con TrackLifetimeValueIncrease, el valor se agrega al valor existente. El valor de duración se almacena en el dispositivo y se puede recuperar en cualquier momento realizando una llamada a GetLifetimeValue. Esto puede utilizarse para almacenar compras acumuladas en el tiempo, visualizaciones de anuncios, visualizaciones de vídeo completas, usos compartidos en medios sociales, cargas de fotografías, etc.

// Lifetime Value Example
var ADB = ADBMobile;
var purchasePrice = 39.95;
var cdata = new Windows.Foundation.Collections.PropertySet();
cdata["ItemPurchaseEvent"] = "ItemPurchaseEvent";
cdata["PurchaseItem"] = "Item453";
cdata["PurchasePrice"] = purchasePrice;
ADB.Analytics.trackLifetimeValueIncrease(purchasePrice, cdata);

Acciones temporizadas

Las acciones temporizadas le permiten medir el tiempo dentro de la aplicación y el tiempo total entre el inicio y el final de una acción. El SDK calcula la cantidad de tiempo de sesión y el tiempo total (entre sesiones) que tarda la acción en completarse. Esto se puede usar para definir segmentos con los que comparar el tiempo de compra, el nivel de paso, el flujo de cierre de compra, etc.

  • Total de segundos en la aplicación entre inicio y final: entre sesiones
  • Total de segundos entre el inicio y el final (hora del reloj)
// Timed Action Start Example
var ADB = ADBMobile;
var cdata = new Windows.Foundation.Collections.PropertySet();
cdata["ExperienceName"] = experience;
ADB.Analytics.trackTimedActionStart("TimeUntilPurchase", cdata);
// Timed Action Update Example
var ADB = ADBMobile;
var cdataUpdate = new Windows.Foundation.Collections.PropertySet();
cdataUpdate["ImageLiked"] = imageName;
ADB.Analytics.trackTimedActionStart("TimeUntilPurchase", cdata);
// Timed Action End Example
var ADB = ADBMobile;
ADB.Analytics.trackTimedActionEnd("TimeUntilPurchase");

En esta página