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 zu Datenerfassung.
3. Wählen Sie im linken Navigationsbereich die Option Datenspeicher.
4. Wählen Sie Neuer Datenstrom aus.
5. Geben Sie den gewünschten Namen ein und wählen Sie Speichern.
6. Nachdem der Datastream erstellt wurde, wählen Sie Dienst hinzufügen.
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 mithilfe des Web SDK erstellten Datenspeicher verweist. configure Befehl. Die configure muss auf jeder Seite festgelegt sein, damit Sie ihn neben den Bibliotheksinstallationscode einfügen können.

Verwenden Sie die edgeConfigId und orgId Eigenschaften im Web SDK configure command:

• Legen Sie die edgeConfigId zur Datastream-ID hinzu, die aus dem vorherigen Schritt abgerufen wurde.
• Legen Sie die orgId zur IMS-Organisation Ihres Unternehmens hinzufügen.

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

Sie können optional andere Eigenschaften in der configure -Befehl entsprechend den Implementierungsanforderungen Ihres Unternehmens.

Ändern Sie Ihre Analytics-Implementierung so, dass sie sich nicht auf AppMeasurement.js oder s -Objekt. Legen Sie stattdessen Variablen in ein korrekt formatiertes JavaScript-Objekt fest, das beim Senden an Adobe in ein JSON-Objekt konvertiert wird. mit Datenschicht auf Ihrer Site bei der Festlegung von Werten enorm hilfreich sein, da Sie weiterhin auf diese Werte verweisen können.

Um Daten an Adobe Analytics zu senden, muss die Web SDK-Payload data.__adobe.analytics mit allen in diesem Objekt festgelegten Analysevariablen. Variablen in diesem Objekt verwenden identische Namen und Formate wie ihre AppMeasurement-Variablen-Entsprechungen. Wenn Sie beispielsweise die products nicht in einzelne Objekte aufteilen, wie Sie es mit XDM tun würden. Fügen Sie ihn stattdessen als Zeichenfolge ein, wenn Sie die Variable s.products Variable:

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

Letztlich enthält diese Payload alle gewünschten Werte und alle Verweise auf die s -Objekt in Ihrer Implementierung entfernt. Sie können alle von JavaScript bereitgestellten Ressourcen verwenden, um dieses Payload-Objekt festzulegen, einschließlich 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 aufrufen s.t() und s.tl(), ersetzen Sie sie durch das sendEvent Befehl. Es gibt drei Szenarien, die zu berücksichtigen sind:

• Seitenansichtsverfolgung: Ersetzen Sie den Seitenansichts-Tracking-Aufruf durch das Web-SDK. sendEvent command:

  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 clickCollectionEnabled Die Konfigurationseigenschaft ist standardmäßig aktiviert. Es werden automatisch die richtigen Linktracking-Variablen festgelegt, um Daten an Adobe Analytics zu senden. Wenn Sie die automatische Linktracking deaktivieren möchten, setzen Sie diese Eigenschaft auf false innerhalb der configure Befehl.

• 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 die s -Objekt verwenden, 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 AppMeasurement.js ist auf Ihrer Site nicht mehr erforderlich und alle Verweise auf dieses Skript können entfernt werden.