Diese Informationen helfen Ihnen bei der Migration von Version 3.x bzw. 2.x der Android-Bibliothek zu Version 4.x.
Das SDK verwendet SharedPreferences
zum Speichern von Daten, die zur Berechnung von Unique Users und Lebenszyklusmetriken benötigt werden, und anderen mit SDK-Hauptfunktionen verbundenen Daten. Wenn Sie in SharedPreferences
die Werte, die vom SDK erwartet werden, ändern oder entfernen, kann dies zu unerwartetem Verhalten in Form von Dateninkonsistenzen führen.
In Version 4.x der Bibliothek sind alle öffentlichen Methoden in einem Header vereinigt. Außerdem steht die gesamte Funktionalität jetzt auch über Methoden auf Klassenebenen zur Verfügung, damit Sie Pointer, Instanzen und Singletons nicht verfolgen müssen.
In Version 4 können Sie in Ihrer App keine Variablen, wie z. B. Ereignisse, eVars, Props, Erben und Listen, mehr zuweisen. Stattdessen verwendet das SDK Kontextdaten und Verarbeitungsregeln, um Ihre App-Daten Analytics-Variablen für die Berichterstellung zuzuordnen.
Verarbeitungsregeln bieten folgende Vorteile:
Sie können Ihre Datenzuordnung ändern, ohne eine Aktualisierung an den Appstore zu senden.
Sie können aussagekräftige Namen für Daten verwenden, anstatt Variablen festzulegen, die für eine Report Suite spezifisch sind.
Das Senden zusätzlicher Daten hat geringe Auswirkungen.
Diese Werte werden erst dann in Berichten angezeigt, wenn sie mithilfe von Verarbeitungsregeln zugeordnet werden.
Die Werte, die Sie Variablen direkt zugewiesen haben, müssen zur HashMap data
hinzugefügt werden.
Die neue Datei ADBMobileConfig.json
enthält anwendungsspezifische, globale Einstellungen und ersetzt die meisten Konfigurationsvariablen, die in vorherigen Versionen zum Einsatz kamen. Im Folgenden finden Sie ein Beispiel für eine ADBMobileConfig.json
-Datei:
{
"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"
}
}
Die folgende Tabelle enthält die Konfigurationsvariablen, die Sie in die Konfigurationsdatei verschieben müssen.
Um von Version 3.x auf Version 4 zu migrieren, verschieben Sie den Wert der Konfigurationsvariablen/Methode in die Variable ADBMobileConfig.json
.
Konfigurationsvariable oder -methode | Variable in der Datei ADBMobileConfig.json |
---|---|
setOfflineTrackingEnabled | „offlineEnabled“ |
setOfflineHitLimit | „batchLimit“ |
reportSuiteIDs | „rsids“ |
trackingServer | „server“ |
charSet | „charset“ |
currencyCode | „currency“ |
ssl | „ssl“ |
linkTrackVars | Entfernen, wird nicht mehr verwendet. |
linkTrackEvents | Entfernen, wird nicht mehr verwendet. |
Um von Version 2.x auf Version 4 zu migrieren, verschieben Sie den Wert aus der ersten Spalte in die Variable in der zweiten Spalte.
Konfigurationsvariable | Variable in der Datei ADBMobileConfig.json |
---|---|
trackOffline | „offlineEnabled“ |
offlineLimit | „batchLimit“ |
account | „rsids“ |
trackingServer | „server“, Präfix "https://" entfernen. Das Protokollpräfix wird basierend auf der Einstellung „ssl“ automatisch hinzugefügt. |
trackingServerSecure | Entfernen. Definieren Sie für sichere Verbindungen „Server“ und aktivieren Sie dann „ssl“. |
charSet | „charset“ |
currencyCode | „currency“ |
ssl | „ssl“ |
linkTrackVars | Entfernen, wird nicht mehr verwendet. |
linkTrackEvents | Entfernen, wird nicht mehr verwendet. |
timestamp | Entfernen, ist nicht mehr konfigurierbar. |
dc | Entfernen, wird nicht mehr verwendet. |
userAgent | Entfernen, ist nicht mehr konfigurierbar. |
dynamicVariablePrefix | Entfernen, wird nicht mehr verwendet. |
visitorNamespace | Entfernen, wird nicht mehr verwendet. |
usePlugins | Entfernen, wird nicht mehr verwendet. |
useBestPractices Alle Aufrufe für massenhafte Messung (getChurnInstance) | Entfernen: Durch Lebenszyklusmetriken ersetzt. |
Anstelle der auf das Web ausgelegten Aufrufe track
und trackLink
verwendet Version 4 des SDK folgende Methoden:
trackState
, die den verfügbaren Ansichten in der App entsprechen, z. B. home dashboard
, app settings
und cart
.
Diese Statusangaben sind mit den Seiten in einer Website vergleichbar, und trackState
-Aufrufe inkrementieren die Seitenansichten.
trackAction
-Aktionen, wie z. B. logons
, banner taps
, feed subscriptions
und andere, die in Ihrer App auftreten und die Sie messen möchten.
Der Parameter contextData
für die beiden Methoden besteht aus einer HashMap<String, Object>
, die Name/Wert-Paare enthält, die als Kontextdaten gesendet werden.
In Version 4 können Sie in Ihrer App keine Variablen, wie z. B. Ereignisse, eVars, Props, Erben und Listen, mehr direkt zuweisen. Das SDK verwendet jetzt Kontextdaten und Verarbeitungsregeln, um Ihre App-Daten Analytics-Variablen für die Berichterstellung zuzuordnen.
Verarbeitungsregeln bieten folgende Vorteile:
Sie können Ihre Datenzuordnung ändern, ohne eine Aktualisierung an den Appstore zu senden.
Sie können aussagekräftige Namen für Daten verwenden, anstatt Variablen festzulegen, die für eine Report Suite spezifisch sind.
Das Senden zusätzlicher Daten hat geringe Auswirkungen.
Diese Werte werden erst dann in Berichten angezeigt, wenn sie mithilfe von Verarbeitungsregeln zugeordnet werden. Weitere Informationen finden Sie unter Verarbeitungsregeln und Kontextdaten.
Werte, die Sie Variablen direkt zugewiesen haben, müssen zur HashMap data
hinzugefügt werden. Das bedeutet, dass Aufrufe von setProp
, setEvar
sowie Zuweisungen zu persistenten Kontextdaten entfernt und die Werte zum Parameter data
hinzugefügt werden müssen.
Daten, die Sie für das Messobjekt festgelegt haben, einschließlich der oben aufgeführten Variablen, müssen zur HashMap data
hinzugefügt werden. Die einzigen Daten, die mit dem Aufruf trackState
oder trackAction
gesendet werden, beinhalten die Nutzlast des Parameters data
.
Ersetzen Sie folgende Methoden durch einen Aufruf von trackState
oder trackAction
:
Migration von Version 3.x
trackAppState (trackState)
trackEvents (trackAction)
track (trackAction)
trackLinkURL (trackAction)
Migration von Version 2.x
track (trackState)
trackLink (trackAction)
Ersetzen Sie die Variable visitorID
durch einen Aufruf von setUserIdentifier
.
Die Offline-Verfolgung wird in der Datei ADBMobileConfig.json
aktiviert. Alle anderen Offline-Konfigurationen erfolgen automatisch.
Entfernen Sie Aufrufe der folgenden Methoden:
Version 3.x
setOnline
setOffline
Version 2.x
forceOffline
forceOnline
Weitere Informationen zur Variablen „products“ finden Sie unter Variable „products“.