Aktualisieren Sie Ihre Datenerfassungsbibliothek für den Audience Manager von der AppMeasurement JavaScript-Bibliothek in die Web SDK JavaScript-Bibliothek.

Erstellen Sie einen Datenspeicher in der Adobe Experience Platform-Datenerfassung. Wenn Sie Daten an diesen Datastream senden, leitet er Daten an Audience Manager weiter. Künftig leitet derselbe Datenspeicher Daten an Real-Time CDP 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 Data Collection zu navigieren.

3. Wählen Sie im linken Navigationsbereich Datastreams aus.

4. Wählen Sie New Datastream aus.

5. Geben Sie den gewünschten Namen ein und wählen Sie dann Save aus.

6. Nachdem der Datastream erstellt wurde, wählen Sie Add Service aus.

7. Wählen Sie im Dropdown-Menü Dienst die Option Audience Manager aus.

   

Ihr Datastream kann jetzt Daten empfangen und an Audience Manager 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 in Schritt 1 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 edgeConfigId und orgId im Web SDK configure -Befehl:

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

alloy("configure", {
    "edgeConfigId": "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 die Implementierung Ihres Audience Managers 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 Audience Manager zu senden, muss die Web SDK-Payload data.__adobe.audiencemanager 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": {
      "audiencemanager": {
        "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: {audiencemanager: {}}}};
dataObj.data.__adobe.audiencemanager.pageName = window.document.title;
dataObj.data.__adobe.audiencemanager.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:{audiencemanager:{...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 den Audience Manager 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.audiencemanager.linkName = "Example custom link"; dataObj.data.__adobe.audiencemanager.linkType = "o"; dataObj.data.__adobe.audiencemanager.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.