Migration von AppMeasurement zum Web SDK

Erstellen Sie einen Datenspeicher in der Adobe Experience Platform-Datenerfassung. Wenn Sie Daten an diesen Datastream senden, leitet er Daten an Adobe Analytics weiter. Künftig leitet derselbe Datenspeicher Daten an Customer Journey Analytics weiter.

1. Navigieren Sie zu experience.adobe.com und melden Sie sich mit Ihren Anmeldedaten an.
2. Verwenden Sie die Startseite oder die Produktselektor oben rechts, um zur Datenerfassung zu navigieren.
3. Wählen Sie im linken Navigationsbereich Datenspeicher aus.
4. Wählen Sie Neuer Datenstrom aus.
5. Geben Sie den gewünschten Namen ein und wählen Sie dann Speichern aus.
6. Nachdem der Datastream erstellt wurde, wählen Sie Dienst hinzufügen aus.
7. Wählen Sie im Dropdown-Menü "Dienst"die Option Adobe Analytics.
8. Geben Sie dieselbe Report Suite-ID ein wie die Site, an die Sie derzeit Analysedaten senden. Klicken Sie auf Speichern.

Ihr Datastream kann jetzt Daten empfangen und an Adobe Analytics weitergeben. Notieren Sie die Datastream-ID, da diese ID für die Konfiguration des Web SDK im Code erforderlich ist.

Richten Sie Ihre Implementierung so ein, dass sie auf den im vorherigen Schritt erstellten Datastream verweist, indem Sie den Web SDK-Befehl configure verwenden. Der Befehl configure muss auf jeder Seite festgelegt sein, damit Sie ihn neben den Bibliotheksinstallationscode einfügen können.

Verwenden Sie die Eigenschaften datastreamId und orgId im Web SDK configure -Befehl:

• Stellen Sie datastreamId auf die aus dem vorherigen Schritt abgerufene Datastream-ID ein.
• Stellen Sie die orgId auf die IMS-Organisation Ihres Unternehmens ein.

alloy("configure", {
    datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
    orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Sie können optional andere Eigenschaften im Befehl configure entsprechend den Implementierungsanforderungen Ihres Unternehmens festlegen.

Ändern Sie Ihre Analytics-Implementierung so, dass sie nicht auf AppMeasurement.js oder das s -Objekt angewiesen ist. Legen Sie stattdessen Variablen in ein korrekt formatiertes JavaScript-Objekt fest, das beim Senden an Adobe in ein JSON-Objekt konvertiert wird. Die Festlegung einer Datenschicht auf Ihrer Site ist bei der Festlegung von Werten äußerst hilfreich, da Sie weiterhin auf dieselben Werte verweisen können.

Um Daten an Adobe Analytics zu senden, muss die Web SDK-Payload data.__adobe.analytics verwenden, wobei alle Analysevariablen in diesem Objekt festgelegt sind. Variablen in diesem Objekt verwenden identische Namen und Formate wie ihre AppMeasurement-Variablen-Entsprechungen. Wenn Sie beispielsweise die Variable products festlegen, teilen Sie sie nicht wie bei XDM in einzelne Objekte. Fügen Sie ihn stattdessen als Zeichenfolge ein, die genau ist, wenn Sie die Variable s.products festlegen:

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Shoes,Men's sneakers,1,49.99"
      }
    }
  }
}

Letztlich enthält diese Payload alle gewünschten Werte und alle Verweise auf das s -Objekt in Ihrer Implementierung werden entfernt. Sie können alle von JavaScript bereitgestellten Ressourcen verwenden, um dieses Payload-Objekt festzulegen, einschließlich der Punktnotation zum Festlegen einzelner Werte.

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {analytics: {}}}};
dataObj.data.__adobe.analytics.pageName = window.document.title;
dataObj.data.__adobe.analytics.eVar1 = "Example value";

// Alternatively, set values in an object and use a spread operator to achieve identical results
var a = new Object;
a.pageName = window.document.title;
a.eVar1 = "Example value";
var dataObj = {data:{__adobe:{analytics:{...a}}}};

Aktualisieren Sie alle Instanzen, in denen Sie s.t() und s.tl() aufrufen, und ersetzen Sie sie durch den Befehl sendEvent . Es gibt drei Szenarien, die zu berücksichtigen sind:

• Seitenansichts-Tracking: Ersetzen Sie den Seitenansichts-Tracking-Aufruf durch den Web SDK sendEvent -Befehl:

  code language-js
  // If your current implementation has this line of code: s.t(); // Replace it with this line of code. The dataObj object contains the variables to send. alloy("sendEvent", dataObj);

• Automatische Linktracking: Die Konfigurationseigenschaft clickCollectionEnabled ist standardmäßig aktiviert. Es werden automatisch die richtigen Linktracking-Variablen festgelegt, um Daten an Adobe Analytics zu senden. Wenn Sie das automatische Linktracking deaktivieren möchten, legen Sie diese Eigenschaft im Befehl configure auf false fest.

• Manuelles Linktracking: Das Web SDK verfügt nicht über separate Befehle zwischen Seitenansichts- und Nicht-Seitenansichtsaufrufen. Geben Sie diese Unterscheidung im Payload-Objekt an.

  code language-js
  // If your current implementation has this line of code: s.tl(true,"o","Example custom link"); // Replace it with these lines of code. Add the required fields to the dataObj object. dataObj.data.__adobe.analytics.linkName = "Example custom link"; dataObj.data.__adobe.analytics.linkType = "o"; dataObj.data.__adobe.analytics.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

Nachdem Sie alle Verweise auf AppMeasurement und das Objekt s entfernt haben, veröffentlichen Sie Ihre Änderungen in Ihrer Entwicklungsumgebung, um zu überprüfen, ob die neue Implementierung funktioniert. Nachdem Sie überprüft haben, ob alles ordnungsgemäß funktioniert, können Sie Ihre Aktualisierungen in der Produktion veröffentlichen.

Bei richtiger Migration ist AppMeasurement.js nicht mehr auf Ihrer Site erforderlich und alle Verweise auf dieses Skript können entfernt werden.