Show Menu
TÓPICOS×

Migração para a biblioteca do Android 4.x

Essas informações ajudam a migrar das versões 3.x ou 2.x da biblioteca do Android para a versão 4.x.
O SDK usa o SharedPreferences para armazenar dados necessários para calcular usuários únicos, métricas de ciclo de vida e outros dados relacionados à funcionalidade principal do SDK. Se modificar ou remover os valores no SharedPreferences esperados pelo SDK, pode resultar um comportamento inesperado na forma de inconsistência de dados.
Na biblioteca da versão 4.x, os métodos públicos são consolidados em um cabeçalho. Além disso, todas as funcionalidades agora são acessíveis pelos métodos de nível de classe, sendo assim, não é preciso rastrear os ponteiros, instâncias ou singletons.

Eventos, propriedades e eVars

Na versão 4, não é mais possível designar variáveis como events, eVars, props, heirs e lists no aplicativo. Em vez disso, o SDK usa dados de contexto e regras de processamento de forma a mapear os dados do aplicativo para as variáveis do Analytics para relatório.
As regras de processamento fornecem as seguintes vantagens:
  • Você pode alterar seu mapeamento de dados sem enviar uma atualização para a App Store.
  • Como alternativa, use nomes significativos para os dados em vez de configurar variáveis específicas para um conjunto de relatórios.
  • Há pouco impacto no envio de dados adicionais.
    Esses valores não aparecerão nos relatórios até serem mapeados usando regras de processamento.
Os valores atribuídos diretamente às variáveis devem ser adicionados ao data HashMap.

Remover propriedades não usadas

O novo arquivo ADBMobileConfig.json contém configurações globais específicas do aplicativo e substitui a maioria das variáveis de configuração usadas em versões anteriores. Este é um exemplo de um arquivo 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 o arquivo de configuração e migrar para a versão 4

As tabelas a seguir listam as variáveis de configuração que você precisa mover para o arquivo de configuração.

Mover o arquivo de configuração

  1. Mova o valor definido para a variável na primeira coluna para a variável na segunda coluna.
  2. Remova a variável de configuração antiga do seu código.

Migrar da versão 3.x

Para migrar da versão 3.x para a 4, mova o valor da variável/método de configuração para a variável ADBMobileConfig.json .
Variável ou método de configuração
Variável no arquivo ADBMobileConfig.json
setOfflineTrackingEnabled
"offlineEnabled"
setOfflineHitLimit
"batchLimit"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
Remover, não é mais usado.
linkTrackEvents
Remover, não é mais usado.

Migrar da versão 2.x

Para migrar da versão 2.x para a 4, mova o valor da primeira coluna para a variável na segunda coluna.
Variável de configuração
Variável no arquivo ADBMobileConfig.json
trackOffline
"offlineEnabled"
offlineLimit
"batchLimit"
account
"rsids"
trackingServer
"server", remover o prefixo "https://" . O prefixo do protocolo é adicionado automaticamente com base na configuração "ssl".
trackingServerSecure
Remover. Para conexões seguras, defina "server" e ative "ssl".
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
Remover, não é mais usado.
linkTrackEvents
Remover, não é mais usado.
timestamp
Remover, não pode mais ser configurado.
dc
Remover, não é mais usado.
userAgent
Remover, não pode mais ser configurado.
dynamicVariablePrefix
Remover, não é mais usado.
visitorNamespace
Remover, não é mais usado.
usePlugins
Remover, não é mais usado.
useBestPractices todas as chamadas para medição de abandono (getChurnInstance)
Remover, substituído por Métricas de ciclo de vida.

Atualizar chamadas e variáveis de rastreamento

Em vez de usar as chamadas focadas na Web track e trackLink , o SDK versão 4 usa os seguintes métodos:
  • trackState , que são as exibições disponíveis no aplicativo, como home dashboard , app settings , cart e assim por diante.
    Esses estados são semelhantes às páginas em um site, e as chamadas de trackState aumentam as visualizações de página.
  • ações trackAction , como logons , banner taps , feed subscriptions , entre outras, que ocorrem no aplicativo e que você deseja medir.
O parâmetro contextData para os dois métodos é um HashMap<String, Object> , que contém os pares de nome-valor enviados como dados de contexto.

Eventos, propriedades e eVars

Na versão 4, não é mais possível designar variáveis como eventos, eVars, propriedades, herdeiros e listas diretamente no aplicativo. O SDK agora usa dados de contexto e regras de processamento para mapear os dados do seu aplicativo para variáveis do Analytics para gerar relatórios.
As regras de processamento fornecem as seguintes vantagens:
  • Você pode alterar seu mapeamento de dados sem enviar uma atualização para a App Store.
  • Como alternativa, use nomes significativos para os dados em vez de configurar variáveis específicas para um conjunto de relatórios.
  • Há pouco impacto no envio de dados adicionais.
    Esses valores não aparecerão nos relatórios até que sejam mapeados usando as regras de processamento. Para obter mais informações, consulte Regras de processamento e Dados de contexto .
Os valores designados às variáveis devem ser adicionados ao HashMap data . Isso significa que as chamadas para setProp , setEvar e atribuições para dados de contexto persistentes devem ser removidas e os valores devem ser adicionados ao parâmetro data .

AppSection/servidor, GeoZip, ID da transação, campanha e outras variáveis padrão

Os dados que você estava configurando no objeto de medição, incluindo as variáveis listadas acima, devem ser adicionados ao HashMap data . Os únicos dados enviados com uma chamada trackState ou trackAction são a carga no parâmetro data .

Substituir chamadas de rastreamento

Substitua os seguintes métodos com uma chamada para trackState ou trackAction :
  • Migrar da versão 3.x
    • trackAppState (trackState)
    • trackEvents (trackAction)
    • track (trackAction)
    • trackLinkURL (trackAction)
  • Migrar da versão 2.x
    • track (trackState)
    • trackLink (trackAction)

ID de visitante personalizada

Substitua a variável visitorID por uma chamada de setUserIdentifier .

Rastreamento offline

O rastreamento offline está habilitado no arquivo ADBMobileConfig.json e todas as outras configurações offline são feitas automaticamente.
Remova chamadas dos seguintes métodos:
Versão 3.x
  • setOnline
  • setOffline
Versão 2.x
  • forceOffline
  • forceOnline

Variável products

Para obter mais informações sobre a variável products, consulte Variável products .