Show Menu
ARGOMENTI×

Migrazione agli SDK 4.x

Questa sezione spiega come passare dalla versione 3.x di un precedente SDK Windows Mobile all’SDK Windows 8.1 Universal App Store 4.x per soluzioni Experience Cloud.
Con il passaggio alla versione 4.x, tutte le funzionalità sono ora accessibili mediante metodi statici, quindi non è più necessario tenere traccia dei propri oggetti.
Le sezioni seguenti illustrano la procedura per migrare dalla versione 3.x alla versione 4.x.

Remove unused properties

Avrai probabilmente notato il nuovo file ADBMobileConfig.json incluso nel download. Questo file contiene impostazioni globali specifiche per le applicazioni e sostituisce la maggior parte delle variabili di configurazione utilizzate nelle versioni precedenti. Ecco un esempio di file 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" 
 } 
}
Nella tabella seguente sono elencate le variabili di configurazione che devi spostare al file di configurazione. Sposta il set di valori della variabile nella prima colonna alla variabile nella seconda colonna, quindi elimina la variabile di configurazione precedente dal codice.

Migrazione da 3.x

Variabile/Metodo di configurazione
Variable in the ADBMobileConfig.json file.
offlineTrackingEnabled
"offlineEnabled"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
setOfflineHitLimit
Rimuovi, non è più utilizzata.
linkTrackVars
Rimuovi, non è più utilizzata.
linkTrackEvents
Rimuovi, non è più utilizzata.

Update track calls and tracking variables

Invece di utilizzare le chiamate Track e TrackLink , l’SDK della versione 4 utilizza due metodi che hanno più senso nel mondo dei dispositivi mobili:
  • TrackState Gli stati sono le visualizzazioni disponibili nell'app, ad esempio “dashboard iniziale”, “impostazioni dell'app”, “carrello” e così via. Questi stati sono simili alle pagine di un sito Web e le chiamate trackState incrementano le visualizzazioni di pagina.
  • TrackAction Le azioni sono gli eventi che avvengono nell’applicazione e che desideri misurare, come “accessi”, “tap sui banner”, “abbonamenti ai feed” e altre metriche. Tali chiamate non incrementano le visualizzazioni di pagina.
Il parametro contextData di entrambi questi metodi contiene coppie nome-valore che vengono inviate come dati contestuali.

Eventi, prop, eVar

Se hai esaminato i metodi SDK methods SDK, probabilmente ti chiederai dove impostare eventi, eVar, prop, eredi ed elenchi. Nella versione 4, non è più possibile assegnare direttamente nell'app questi tipi di variabili. L’SDK utilizza invece i dati contestuali e le regole di elaborazione per mappare i dati dell’app sulle variabili di Analytics a scopo di reportistica.
L’elaborazione di regole offre diversi vantaggi:
  • È possibile cambiare la mappatura dei dati senza dover inviare un aggiornamento all’App Store.
  • Invece di impostare variabili specifiche per una suite di rapporti, è possibile assegnare ai dati dei nomi significativi.
  • L’impatto dell’invio di dati aggiuntivi è limitato. Questi valori compariranno nei rapporti solo dopo che questi saranno stati mappati utilizzando delle regole di elaborazione.
For more information, see Processing Rules in Analytics .
Eventuali valori che venivano assegnati direttamente alle variabili ora dovranno essere aggiunti ai dati contestuali. 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 e altre variabili standard
Tutti gli altri dati che precedentemente impostavi sull’oggetto di misurazione, comprese le variabili elencate qui sopra, devono essere aggiunti invece ai dati contestuali.
Per dirla semplicemente, gli unici dati inviati con una chiamata TrackState o TrackAction sono il payload del parametro data .

Sostituire le chiamate di tracciamento

Nell’intero codice, sostituisci i metodi seguenti con una chiamata a trackState o trackAction :

Migrazione da 3.x

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

Custom visitor ID

Replace the visitorID variable with a call to setUserIdentifier .

Offline tracking

Il tracciamento offline è abilitato nel ADBMobileConfig.json file. Tutte le altre configurazioni offline vengono eseguite automaticamente.
Nell’intero codice, devi rimuovere le chiamate ai seguenti metodi:

Migrazione da 3.x

  • SetOnline
  • SetOffline

Products variable

Poiché la variabile "" non è disponibile nelle regole di elaborazione, puoi usare la sintassi seguente per impostare 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.