Show Menu
TÓPICOS×

Migrate to the 4.x SDKs

Esta seção descreve como migrar da versão 3.x de um Windows SDK para dispositivos móveis anterior para o SDK 4.x da loja de aplicativos universal do Windows 8.1 para as soluções da Experience Cloud.
Com a atualização para a versão 4.x, toda a funcionalidade agora é acessível por meio de métodos estáticos, por isso não há mais a necessidade de rastrear seus próprios objetos.
As seguintes seções o orientarão no processo de migração da versão 3.x para a 4.x.

Remove unused properties

Você provavelmente notou um novo arquivo ADBMobileConfig.json incluído no seu download. Este arquivo 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" : 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" 
 } 
}

As tabelas a seguir listam as variáveis de configuração que você precisa mover para o arquivo de configuração. Mova o conjunto de valores para a variável na primeira coluna para a variável na segunda coluna e depois remova a variável configuração antiga do código.

Migrar da versão 3.x

Variável/método de configuração
Variable in the ADBMobileConfig.json file.
offlineTrackingEnabled
"offlineEnabled"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
setOfflineHitLimit
Remover, não é mais usado.
linkTrackVars
Remover, não é mais usado.
linkTrackEvents
Remover, não é mais usado.

Update track calls and tracking variables

Em vez de usar as chamadas com foco na Web Track e TrackLink , a versão 4 do SDK usa dois métodos que fazem mais sentido no mundo dos dispositivos móveis:
  • TrackState Os estados são as visualizações que estão disponíveis no seu aplicativo, como “painel inicial”, “configurações do aplicativo”, “carrinho” e assim por diante. Esses estados são semelhantes às páginas em um site e as chamadas de trackState aumentam as exibições de página.
  • TrackAction As ações são coisas que ocorrem no seu aplicativo e que deseja avaliar, como “logons”, “toques em banners”, “assinaturas de feed” e outras métricas. Estas chamadas não incrementam as exibições da página.
O parâmetro contextData para estes dois métodos contém os pares de nome e valor enviados como dados de contexto.

Eventos, Props, eVars

If you've looked at the SDK methods, you are probably wondering where to set events, eVars, props, heirs, and lists. SDK methods Na versão 4, não é possível atribuir esses tipos de variáveis diretamente 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 criação de relatórios.
As regras de processamento oferecem diversas 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 regras de processamento.
For more information, see Processing Rules in Analytics .
Quaisquer valores atribuídos a variáveis devem ser, em vez disso, adicionados aos dados 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/servidor, GeoZip, ID da transação, campanha e outras variáveis padrão
Quaisquer outros dados configurados no objeto de medição, inclusive as variáveis listadas acima, devem ser adicionados aos dados de contexto em vez disso.
To put it simply, the only data sent in with a TrackState or TrackAction call is the payload in the data parameter.

Replace tracking calls

Em todo o código, substitua os seguintes métodos por uma chamada a trackState ou trackAction :

Migrar da versão 3.x

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

Custom visitor ID

Replace the visitorID variable with a call to setUserIdentifier .

Offline tracking

Offline tracking is enabled in the file. ADBMobileConfig.json All other offline configuration is done automatically.
Em todo o código, remova as chamadas aos métodos a seguir:

Migrar da versão 3.x

  • SetOnline
  • SetOffline

Products variable

Como a variável não está disponível nas regras de processamento, você pode usar a seguinte sintaxe para definir products produtos:
// 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.