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.