Show Menu
TEMAS×

Migración a la biblioteca Android 4.x

Esta información le ayuda a migrar de las versiones 3.x o 2.x a la versión 4.x de la biblioteca Android.
El SDK utiliza SharedPreferences a fin de almacenar los datos necesarios para calcular los usuarios únicos, las métricas del ciclo vital y otros datos relacionados con la función principal del SDK. Si modifica o elimina los valores en SharedPreferences que el SDK espera, el comportamiento inesperado podría provocar incongruencias en los datos.
En la biblioteca de la versión 4.x, los métodos públicos se consolidan en un encabezado. Además, ahora se puede acceder a toda la funcionalidad a partir de métodos en el nivel de clase, por lo que no tiene que seguir la pista de punteros, instancias e instancias únicas.

Eventos, props y eVars

En la versión 4 ya no puede asignar en su aplicación variables como events, eVars, props, heirs y lists. En lugar de ello, el SDK utiliza datos de contexto y reglas de procesamiento para asignar los datos de su aplicación a variables de Analytics para la realización de informes.
Las reglas de procesamiento ofrecen las siguientes 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 muy pequeño.
    Estos valores no aparecen en los informes hasta que se los asigna mediante reglas de procesamiento.
Los valores que asignaba directamente a variables deberían agregarse al HashMap data .

Eliminación de propiedades no utilizadas

El nuevo archivo ADBMobileConfig.json contiene ajustes globales y específicos de la aplicación, y reemplaza la mayoría de las variables de configuración utilizadas 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" : 5,
        "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"
 }
}

Mover el archivo de configuración y migración a la versión 4

Las siguientes tablas listan las variables de configuración que debe mover al archivo de configuración.

Mover el archivo de configuración

  1. Mueva el valor establecido para la variable de la primera columna a la variable de la segunda columna.
  2. Elimine la antigua variable de configuración de su código.

Migración desde la versión 3.x

Para migrar de la versión 3.x a la 4, mueva el valor de método/variable de configuración a la variable ADBMobileConfig.json .
Variable de configuración o método
Variable en el archivo ADBMobileConfig.json
setOfflineTrackingEnabled
"offlineEnabled"
setOfflineHitLimit
"batchLimit"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
Eliminar, ya no se utiliza.
linkTrackEvents
Eliminar, ya no se utiliza.

Migración desde la versión 2.x

Para migrar de la versión 2.x a la versión 4, mueva el valor de la primera columna a la variable de la segunda columna.
Variable de configuración
Variable en el archivo ADBMobileConfig.json
trackOffline
"offlineEnabled"
offlineLimit
"batchLimit"
account
"rsids"
trackingServer
"server", elimine el prefijo "https://" . El prefijo de protocolo se agrega automáticamente en función del ajuste “ssl”.
trackingServerSecure
Eliminar. Para conexiones seguras, defina “server” y después habilite “ssl”.
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
Eliminar, ya no se utiliza.
linkTrackEvents
Eliminar, ya no se utiliza.
timestamp
Eliminar, ya no es configurable.
dc
Eliminar, ya no se utiliza.
userAgent
Eliminar, ya no es configurable.
dynamicVariablePrefix
Eliminar, ya no se utiliza.
visitorNamespace
Eliminar, ya no se utiliza.
usePlugins
Eliminar, ya no se utiliza.
useBestPractices todas las llamadas para producir mediciones (getChurnInstance)
Eliminar, sustituido por métricas del ciclo vital.

Actualización de llamadas y variables de seguimiento

En vez de utilizar las llamadas track y trackLink , centradas en la web, la versión 4 del SDK emplea los siguientes métodos:
  • trackState , que son las vistas que están disponibles en la aplicación, como home dashboard , app settings o cart , entre otros.
    Estos estados son similares a las páginas de un sitio web y las llamadas trackState incrementan las visualizaciones de página.
  • Las acciones trackAction , como logons , banner taps , feed subscriptions y otras que se producen en la aplicación y que desea medir.
El parámetro contextData para ambos métodos es un HashMap<String, Object> , que contiene los pares de nombre-valor que se envían como datos de contexto.

Eventos, props y eVars

En la versión 4 ya no puede asignar directamente en su aplicación variables como events, eVars, props, heirs y lists. Ahora el SDK utiliza datos de contexto y reglas de procesamiento para asignar los datos de su aplicación a variables de Analytics para la realización de informes.
Las reglas de procesamiento ofrecen las siguientes 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 muy pequeño.
    Estos valores no aparecen en los informes hasta que se los asigna mediante reglas de procesamiento. Para obtener más información, consulte Reglas de procesamiento y datos de contexto .
Los valores que asignaba directamente a variables deberían agregarse al HashMap data . Esto significa que las llamadas a setEvar y setProp , así como las asignaciones a datos de contexto persistentes, deberían eliminarse para agregar sus valores al parámetro data .

AppSection/Server, GeoZip, Transaction ID, Campaign y otras variables estándar

Los datos que configuraba en el objeto de medición, incluidas las variables arriba indicadas, deberían agregarse al HashMap data . Los únicos datos que se envían con una llamada a trackState o trackAction son la carga útil del parámetro data .

Reemplazo de las llamadas de seguimiento

Sustituya los siguientes métodos por una llamada a trackState o trackAction :
  • Migración desde la versión 3.x
    • trackAppState (trackState)
    • trackEvents (trackAction)
    • track (trackAction)
    • trackLinkURL (trackAction)
  • Migración desde la versión 2.x
    • track (trackState)
    • trackLink (trackAction)

ID de visitante personalizado

Reemplace la variable visitorID con una llamada a setUserIdentifier .

Seguimiento sin conexión

El seguimiento sin conexión se habilita en el archivo ADBMobileConfig.json y el resto de la configuración sin conexión se realiza automáticamente.
Elimine las llamadas a los siguientes métodos:
Versión 3.x
  • setOnline
  • setOffline
Versión 2.x
  • forceOffline
  • forceOnline

Variable Products

Para obtener más información acerca de la variable products, consulte Variable Products .