Zu den 4.x-SDKs migrieren

In diesem Abschnitt wird beschrieben, wie Sie von der Version 3.x des Windows Mobile SDK auf das Universal Windows Platform 4.x SDK for Experience Cloud Solutions migrieren.

Mit der Umstellung auf Version 4.x können jetzt alle Funktionen über statische Methoden aufgerufen werden. Sie müssen keine eigenen Objekte mehr verfolgen.

Die folgenden Abschnitte führen Sie durch die Migration von Version 3.x auf Version 4.x.

Ungenutzte Eigenschaften entfernen

Sie haben wahrscheinlich eine neue ADBMobileConfig.json Datei bemerkt, die im Download enthalten ist. Diese Datei enthält anwendungsspezifische globale Einstellungen und ersetzt die meisten Konfigurationsvariablen, die in früheren Versionen verwendet wurden.

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" : 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" 
 } 
}

Die folgende Tabelle enthält die Konfigurationsvariablen, die Sie in die Konfigurationsdatei verschieben müssen. Verschieben Sie den für die Variable in der ersten Spalte eingestellten Wert in die Variable in der zweiten Spalte und entfernen Sie dann die alte Konfigurationsvariable aus Ihrem Code.

Migration von 3.x

Die folgende Tabelle enthält eine Liste von Variablen in den 3.x-SDKs und den neuen Namen in den 4.x-SDKs:

Konfigurationsvariable/Methode Variable in the ADBMobileConfig.json file.
offlineTrackingEnabled „offlineEnabled“
reportSuiteIDs „rsids“
trackingServer „server“
charSet „charset“
currencyCode „currency“
ssl „ssl“
setOfflineHitLimit Entfernen, wird nicht mehr verwendet.
linkTrackVars Entfernen, wird nicht mehr verwendet.
linkTrackEvents Entfernen, wird nicht mehr verwendet.

Verfolgungsaufruf und -variablen aktualisieren

Anstatt die Web-fokussierten Track und TrackLink -Aufrufe zu verwenden, verwendet das SDK Version 4 zwei Methoden, die in der mobilen Welt etwas sinnvoller sind:

  • TrackState Statusangaben sind die Ansichten, die in Ihrer App verfügbar sind, z. B. "Home Dashboard", "App-Einstellungen", "Warenkorb"usw. Diese Statusangaben sind mit den Seiten in einer Website vergleichbar, und trackState-Aufrufe inkrementieren die Seitenansichten.

  • TrackAction Aktionen sind die Vorgänge, die in Ihrer App stattfinden und die Sie messen möchten, z. B. "Anmeldungen", "Bannerklappen", "Feed-Abonnement"und andere Metriken. Durch diese Aufrufe werden die Ansichten der Seite nicht inkrementiert.

The contextData parameter for both of these methods contains name-value pairs that are sent as context data.

Events, Props und eVars

Wenn Sie sich die SDK-Methodenangesehen haben, fragen Sie sich wahrscheinlich, wo Sie Ereignis, eVars, Props, Erben und Listen einstellen können. In Version 4 können Sie diese Variablentypen nicht mehr direkt in Ihrer App 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.

Weitere Informationen finden Sie im Abschnitt Verarbeitungsregeln in der Analytics-Übersicht.

Alle Werte, die Sie direkt Variablen zuweisen, sollten stattdessen den Kontextdaten hinzugefügt werden. 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, Transaktions-ID, Kampagne und andere Standardvariablen

Alle anderen Daten, die Sie für das Messungsobjekt eingestellt haben, einschließlich der oben aufgeführten Variablen, sollten stattdessen den Kontextdaten hinzugefügt werden. Das heißt, die einzigen Daten, die mit einem TrackState oder einem TrackAction -Aufruf gesendet werden, sind die Nutzdaten im data Parameter.

Verfolgungsaufrufe ersetzen

Throughout your code, replace the following methods with a call to trackState or trackAction:

Migration von 3.x:

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

Benutzerdefinierter ID-Dienst

Ersetzen Sie die Variable visitorID durch einen Aufruf von setUserIdentifier.

Offline-Verfolgung

Offline tracking is enabled in the ADBMobileConfig.json file. All other offline configuration is done automatically.

Entfernen Sie im gesamten Code Aufrufe der folgenden Methoden:

Migration von 3.x:

  • SetOnline
  • SetOffline

Variable „products“

Da die Variable „products“ in Verarbeitungsregeln nicht verfügbar ist, können Sie die folgende Syntax zum Festlegen von products verwenden:

// 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);

Der Wert von "&&products" (in diesem Beispiel lautet der Wert ";Cool Shoe") sollte der Produktzeichenfolgen-Syntax für den Typ des zu verfolgenden Ereignisses folgen.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free