Show Menu
ARGOMENTI×

Migrazione alla libreria iOS 4.x

Queste informazioni sono utili per passare dalle versioni 3.x o 2.x della libreria iOS alla versione 4.x.
L’SDK utilizza NSUserDefaults per memorizzare i dati che sono necessari per calcolare gli utenti univoci, le metriche del ciclo di vita e altri dati relativi alle funzionalità SDK di base. Se modifichi o rimuovi i valori di NSUserDefaults che sono attesi dall’SDK, si potrebbe determinare un comportamento imprevisto con conseguente incoerenza dei dati.
Nella versione 4.x della libreria SDK iOS, i metodi pubblici sono consolidati in un’unica intestazione. Inoltre, le funzionalità sono ora accessibili tramite metodi di livello di classe; pertanto, non è più necessario tenere traccia di puntatori, istanze o singleton.

Eventi, prop ed eVar

Nella versione 4, non è più possibile assegnare direttamente nell'app variabili quali eventi, eVar, prop, eredi ed elenchi. 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.
Le regole di elaborazione offrono i seguenti 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 saranno stati mappati utilizzando delle regole di elaborazione.
I valori che venivano assegnati direttamente alle variabili ora dovranno essere aggiunti al dizionario NSDictionary data .

Rimuovere le proprietà non utilizzate

Il nuovo file ADBMobileConfig.json 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" : 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" 
 } 
}

Spostare il file di configurazione

Per spostare il file di configurazione:
  1. Sposta il valore impostato per la variabile della prima colonna alla variabile della seconda colonna.
  2. Rimuovi dal codice la precedente variabile di configurazione.

Informazioni sulla migrazione

Nella tabella seguente sono elencate le variabili di configurazione che devi spostare al file di configurazione.

Migrazione dalla versione 3.x

Sposta il valore riportato nella prima colonna alla variabile della seconda colonna.
Variabile di configurazione
Variabile nel file ADBMobileConfig.json
offlineTrackingEnabled
"offlineEnabled"
offlineHitLimit
"batchLimit"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
Rimuovi, non è più utilizzata.
linkTrackEvents
Rimuovi, non è più utilizzata.

Migrazione dalla versione 2.x

Sposta il valore riportato nella prima colonna alla variabile della seconda colonna.
Variabile di configurazione
Variabile nel file ADBMobileConfig.json
trackOffline
"offlineEnabled"
offlineLimit
"batchLimit"
account
"rsids"
trackingServer
"server", rimuovi il prefisso "https://" . Il prefisso del protocollo viene aggiunto in automatico in base all'impostazione "ssl".
trackingServerSecure
Rimuovi. Per connessioni sicure, definisci "server" e quindi abilita "ssl".
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
Rimuovi, non è più utilizzata.
linkTrackEvents
Rimuovi, non è più utilizzata.
timestamp
Rimuovi, non è più configurabile.
dc
Rimuovi, non è più utilizzata.
userAgent
Rimuovi, non è più configurabile.
dynamicVariablePrefix
Rimuovi, non è più utilizzata.
visitorNamespace
Rimuovi, non è più utilizzata.
usePlugins
Rimuovi, non è più utilizzata.
useBestPractices tutte le chiamate alla misurazione churn (getChurnInstance )
Rimuovi, sostituito dalle metriche del ciclo di vita. Per ulteriori informazioni, vedi Metriche del ciclo di vita .

Aggiornare le chiamate e le variabili di tracciamento

Invece di usare le chiamate track e trackLink incentrate sul web, la versione 4 dell'SDK usa i metodi seguenti:
  • Gli stati trackState:data: sono le visualizzazioni disponibili nell'app, ad esempio home dashboard , app settings , cart e così via.
    Questi stati sono simili alle pagine di un sito Web e le chiamate trackState incrementano le visualizzazioni di pagina.
  • Azioni trackAction:data: , come logons , banner taps , feed subscriptions e altre metriche che si verificano nell'app e che desideri misurare.
Il parametro data di entrambi questi metodi è un dizionario NSDictionary contenente coppie nome-valore che vengono inviate come dati contestuali.

Eventi, prop, eVar

Nella versione 4, non è più possibile assegnare direttamente nell'app variabili quali eventi, eVar, prop, eredi ed elenchi. L'SDK utilizza ora i dati contestuali e le regole di elaborazione per mappare i dati dell'app sulle variabili di Analytics a scopo di reportistica.
Le regole di elaborazione offrono i seguenti 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 saranno stati mappati utilizzando delle regole di elaborazione. Per ulteriori informazioni, consulta Regole di elaborazione e dati contestuali .
Eventuali valori che venivano assegnati direttamente alle variabili ora dovranno essere aggiunti al dizionario data``NSDictionary . È quindi necessario rimuovere tutte le chiamate a setProp , setEvar e le assegnazioni a dati contestuali persistenti; i relativi valori devono essere aggiunti al parametro data .

AppSection/Server, GeoZip, transaction ID, Campaign e altre variabili standard

I dati che precedentemente impostavi sull'oggetto di misurazione, comprese le variabili elencate qui sopra, devono essere aggiunti al dizionario data``NSDictionary . L'unico dato che viene inviato con una chiamata trackState o trackAction è il payload nel parametro data .

Sostituire le chiamate di tracciamento

Nel codice, sostituisci i metodi seguenti con una chiamata a trackState o trackAction :

Migrazione dalla versione 3.x

  • trackAppState (trackState)
  • trackEvents (trackAction)
  • track (trackAction)
  • trackWithContextData (trackAction)
  • trackLinkURL (trackAction)

Migrazione dalla versione 2.x

  • track (trackState)
  • trackLink (trackAction)

ID visitatore personalizzato

Sostituisci la variabile visitorID con una chiamata a setUserIdentifier: .

Tracciamento offline

Il tracciamento offline è abilitato nel file ADBMobileConfig.json e tutte le altre configurazioni offline vengono eseguite in automatico.
Nel codice, devi rimuovere le chiamate ai seguenti metodi:

Versione 3.x

  • setOnline
  • setOffline

Versione 2.x

  • forceOffline
  • forceOnline

Variabile dei prodotti

Poiché la variabile "products" 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 prodView event when context data a.action = "product view" 
[ADBMobile trackAction:@"LikeButtonClicked"  
                  data:@{@"&&products" : @";Cool Shoe"}];