Show Menu
TEMAS×

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.
Ensure that you import to your class. ADBMobile.h

Enable mobile application reports in Analytics

Antes de añadir código, pida a su administrador de Analytics que complete los siguientes pasos para habilitar el seguimiento de ciclo vital de aplicaciones móviles. Esto garantiza que su grupo de informes esté listo para capturar métricas cuando comience el desarrollo.
  1. Open Admin Tools > Report Suites and select your mobile report suite(s).
  2. Click Edit Settings > Mobile Management > Mobile Application Reporting .
  3. Haga clic en Habilitar los informes de aplicaciones más recientes .
    Optionally, you can also click Enable Mobile Location Tracking or Enable Legacy Reporting and Attribution for background hits .
Ya se pueden capturar las métricas del ciclo vital, e Informes de aplicaciones móviles aparece en el menú Informes de la interfaz de informes de marketing.

Nuevas versiones

Se lanzan nuevas versiones de los informes de aplicaciones móviles de forma periódica. Estas versiones no se aplican automáticamente a su grupo de informes, debe repetir estos pasos para realizar la actualización. Recomendamos repetir estos pasos cada vez que añada nuevas funciones de Experience Cloud a la aplicación para garantizar que dispone de la configuración más reciente.

Lifecycle metrics

Para recopilar métricas del ciclo vital en la aplicación, añada llamadas que se activen cuando lo haga la aplicación, como se muestra en los ejemplos siguientes.

WinJS in 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# in 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() is called twice in the same session, your application reports a crash on every call after the first. Cuando la aplicación se cierra, el SDK establece un indicador que especifica una salida correcta. If this flag is not set, CollectLifecyleData() reports a crash.

Events, props, and eVars

If you've looked at SDK methods , you are probably wondering where to set events, eVars, props, heirs, and lists. En la versión 4, ya no puede asignar estos tipos de variables directamente en la aplicación. Ahora el SDK utiliza datos de contexto y reglas de procesamiento para asignar los datos de su aplicación a variables de Analytics de cara a la realización de informes.
Las reglas de procesamiento ofrecen varias ventajas:
  • Puede cambiar la asignación de datos sin tener que enviar una actualización al App Store.
  • Puede utilizar nombres significativos para los datos, en vez de establecer variables específicas para un grupo de informes.
  • El impacto de enviar los datos extra es ínfimo. Estos valores no aparecen en los informes hasta que se los asigna mediante reglas de procesamiento.
Cualquier valor que asignara directamente a variables debe agregarse a los datos de contexto.

Reglas de procesamiento

Se utilizan reglas de procesamiento 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.
Se recomienda agrupar las variables de datos de contexto mediante “espacios de nombres”, ya que esto ayuda a mantener una ordenación lógica. Por ejemplo, si quiere recopilar información acerca de un producto, podría 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, de modo que los espacios de nombres le permiten ver rápidamente qué variables hay en el mismo espacio de nombres.
Además, hay quien asigna nombres a las claves de datos de contexto empleando el número de eVar o prop:
"eVar1":"jimbo"

Esto podría ayudarle un poco a la hora de llevar a cabo la asignación que hay que realizar una única vez en las reglas de procesamiento, a costa de perder legibilidad durante la depuración y las futuras actualizaciones de código, que pueden resultarle más difíciles. Lo que se recomienda encarecidamente es utilizar nombres descriptivos para las claves y valores:
"username":"jimbo"

Establezca variables de contexto que definan para los eventos de contador un valor de “1”:
"logon":"1"

Las variables de datos de contexto que definen eventos incrementadores pueden tener el valor a incrementar:
"levels completed":"6"

Adobe reserves the namespace . a. Aparte de esta restricción, las variables de datos de contexto solo deben ser únicas en su empresa de inicio de sesión para evitar conflictos.

Products variable

Para establecer products en el SDK móvil, debe utilizar una sintaxis especial. For more information, see Products variable. Products variable

(Optional) Enable offline tracking

To store hits when the device is offline, you can enable offline tracking in the SDK methods file. Antes de habilitar el seguimiento sin conexión, preste especial atención a los requisitos de marca de hora descritos en la referencia del archivo de configuración.

Geo-location and points of interest

La geolocalización le permite medir datos de ubicación (latitud/longitud) y puntos de interés predefinidos. Each TrackLocation call sends:
  • Latitud/Longitud y puntos de interés (o POI, si es que se encuentra en un POI definido en el archivo de configuración ADBMobileConfig.json ).
    Estos valores se pasan a variables de soluciones móviles para la realización automática de informes.
  • Distancia al centro y precisión, pasados 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 POI está definido en el archivo de configuración ADBMobileConfig.json :
"poi" : [ 
            ["San Francisco",37.757144,-122.44812,7000], 
        ]

When the device location is determined to be within a 7000 meter radius of the defined point, an a.loc.poi context data variable with the value San Francisco is sent in with the TrackLocation hit. Se envía una variable de contexto a.loc.dist con la distancia en metros desde las coordenadas definidas.

Lifetime value

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);

Timed actions

Las acciones temporizadas le permiten medir el tiempo dentro de la aplicación y el tiempo total entre el comienzo y el final de una acción. El SDK calcula la cantidad de tiempo de sesión y el tiempo total (entre sesiones) que la acción tarda en completarse. Esto sirve para definir segmentos donde comparar tiempo de compra, nivel de paso, flujo de verificación, etc.
  • Total de segundos en la aplicación entre inicio y final (entre sesiones)
  • Total de segundos entre inicio y final (tiempo de 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");