Show Menu
TEMAS×

Migrate to the 4.x SDKs

En esta sección se describe cómo migrar de la versión 3.x de un SDK móvil de Windows anterior al SDK 4.x Universal App Store para Windows 8.1 para Soluciones de Experience Cloud.
Con el paso a la versión 4.x, es posible acceder a todas las funciones con métodos estáticos y ya no es preciso realizar un seguimiento de sus propios objetos.
Las siguientes secciones explican cómo se realiza la migración de la versión 3.x a la 4.x.

Remove unused properties

Habrá notado que la descarga incluye un nuevo archivo ADBMobileConfig.json . Este archivo contiene la configuración global específica de la aplicación y reemplaza a la mayoría de las variables de configuración que se usaban en versiones anteriores. Este es un ejemplo de archivo ADBMobileConfig.json :
{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 300, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 5 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

Las siguientes tablas listan las variables de configuración que debe mover al archivo de configuración. Mueva el conjunto de valores para la variable en la primera columna a la variable en la segunda columna y, a continuación, elimine en su código la variable de configuración antigua.

Migración desde 3.x

Variable de configuración/Método
Variable in the ADBMobileConfig.json file.
offlineTrackingEnabled
"offlineEnabled"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
setOfflineHitLimit
Eliminar, ya no se utiliza.
linkTrackVars
Eliminar, ya no se utiliza.
linkTrackEvents
Eliminar, ya no se utiliza.

Update track calls and tracking variables

En vez de utilizar las llamadas Track y TrackLink , centradas en la web, la versión 4 del SDK emplea dos métodos más apropiados para el mundo móvil:
  • TrackState Los estados son las visualizaciones disponibles en su aplicación, como “tablero de inicio”, “configuración de la aplicación”, “carrito”, etc. Estos estados son similares a las páginas de un sitio web y las llamadas trackState incrementan las visualizaciones de página.
  • TrackAction Las acciones son cosas que suceden en la aplicación y que es interesante medir, por ejemplo, “inicios de sesión”, “toques en banners”, “suscripciones a fuentes” y otras métricas. Estas llamadas no incrementan las visualizaciones de página.
El parámetro contextData para ambos métodos contiene pares de nombre-valor que se envían como datos de contexto.

Events, props y eVars

If you've looked at the SDK methods, you are probably wondering where to set events, eVars, props, heirs, and lists. SDK methods 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.
For more information, see Processing Rules in Analytics .
Cualquier valor que asignara directamente a variables debe agregarse a los datos de contexto. This means that calls to SetProp , SetEvar , and assignments to persistent context data should all be removed and the values added to context data.
AppSection/Server, GeoZip, Transaction ID, Campaign y otras variables estándar
Cualquier otro dato que configurara en el objeto de medición, incluidas las variables arriba indicadas, deben agregarse a los datos de contexto.
Para decirlo llanamente, el único dato que se envía con una llamada TrackState o TrackAction es la carga del parámetro data .

Reemplazar llamadas de seguimiento

En todo su código, sustituya los siguientes métodos con una llamada a trackState o trackAction :

Migración desde 3.x

  • TrackAppState (TrackState)
  • TrackEvents (TrackAction)
  • Track (TrackAction)
  • TrackLinkURL (TrackAction)

Custom visitor ID

Replace the visitorID variable with a call to setUserIdentifier .

Offline tracking

El seguimiento sin conexión está habilitado en el ADBMobileConfig.json archivo. All other offline configuration is done automatically.
En todo su código, elimine las llamadas a los métodos siguientes:

Migración desde 3.x

  • SetOnline
  • SetOffline

Products variable

Como la variable no está disponible en las reglas de procesamiento, puede utilizar la siguiente sintaxis para establecer products products:
// create a processing rule to set the corresponding product event. 
// for example, set the Product Views event when context data a.action = "product view" 
var cdata = new Windows.Foundation.Collections.PropertySet(); 
cdata["&&products"] = ";Cool Shoe"; 
ADB.Analytics.trackAction("product view", cdata);

In this example, the value of "&&products" is ";Cool Shoe " and should follow the products string syntax for the type of event that you are tracking.