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.
En la versión 4, ya no puede asignar variables como eventos, eVars, props, herederos y listas 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 las siguientes 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.
Los valores que asignaba directamente a variables deberían agregarse al HashMap data
.
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"
}
}
Las siguientes tablas listan las variables de configuración que debe mover al archivo de configuración.
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. |
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”, quite el prefijo "https://" . El prefijo de protocolo se agrega automáticamente según la configuración “ssl”. |
trackingServerSecure | Eliminar. Para conexiones seguras, defina "server" y luego habilite "ssl". |
charSet | "charset" |
currencyCode | "currency" |
ssl | "ssl" |
linkTrackVars | Eliminar, ya no se utiliza. |
linkTrackEvents | Eliminar, ya no se utiliza. |
timestamp | Eliminar, ya no se puede configurar. |
dc | Eliminar, ya no se utiliza. |
userAgent | Eliminar, ya no se puede configurar. |
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. |
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.
En la versión 4, ya no puede asignar variables como eventos, eVars, props, herederos y listas en la aplicación. El SDK ahora utiliza datos de contexto y reglas de procesamiento para asignar los datos de la aplicación a variables de Analytics para sistema de informes.
Las reglas de procesamiento ofrecen las siguientes 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. 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
.
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
.
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)
Reemplace la variable visitorID
con una llamada a setUserIdentifier
.
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
Para obtener más información acerca de la variable products, consulte Variable Products.