Migrera från AppMeasurement till Web SDK

Skapa ett datastream i Adobe Experience Platform Data Collection. När du skickar data till den här dataströmmen vidarebefordrar den data till Adobe Analytics. I framtiden vidarebefordrar samma datastream data till Customer Journey Analytics.

1. Navigera till experience.adobe.com och logga in med dina autentiseringsuppgifter.
2. Använd hemsidan eller produktväljaren i det övre högra hörnet för att navigera till Data Collection.
3. Välj Datastreams i den vänstra navigeringen.
4. Välj New Datastream.
5. Ange önskat namn och välj sedan Save.
6. Välj Add Service när dataströmmen har skapats.
7. Välj Adobe Analytics på den nedrullningsbara menyn för tjänster.
8. Ange samma rapportsviter-ID som den webbplats du för närvarande skickar analysdata till. Klicka på Save.

Din datastream är nu redo att ta emot och skicka data till Adobe Analytics. Observera dataStream ID, eftersom detta ID krävs när du konfigurerar Web SDK i koden.

Konfigurera implementeringen så att den pekar på det datastöd som skapades i föregående steg med hjälp av Web SDK-kommandot configure. Kommandot configure måste anges på alla sidor, så du kan inkludera det bredvid bibliotekets installationskod.

Använd egenskaperna datastreamId och orgId i Web SDK configure-kommandot:

• Ange datastreamId till det datastream-ID som hämtats från föregående steg.
• Ange orgId till din organisations IMS-organisation.

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

Du kan ange andra egenskaper i kommandot configure beroende på organisationens implementeringskrav.

Ändra din Analytics-implementering så att den inte är beroende av AppMeasurement.js eller s-objektet. I stället anger du variabler till ett korrekt formaterat JavaScript-objekt, som konverteras till ett JSON-objekt när det skickas till Adobe. Att ha ett datalager på din webbplats är till stor hjälp när du anger värden, eftersom du kan fortsätta att referera till samma värden.

Om du vill skicka data till Adobe Analytics måste Web SDK-nyttolasten använda data.__adobe.analytics med alla analysvariabler som anges i det här objektet. Variabler i det här objektet delar identiska namn och format som deras AppMeasurement-variabelmotsvarigheter. Om du till exempel anger variabeln products ska du inte dela upp den i enskilda objekt som du skulle göra med XDM. Ta i stället med den som en sträng exakt om du anger variabeln s.products:

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

I slutändan innehåller den här nyttolasten alla önskade värden och alla referenser till objektet s i implementeringen tas bort. Du kan använda vilken som helst av de resurser som JavaScript tillhandahåller för att ställa in det här nyttolastobjektet, inklusive punktnotation för att ställa in enskilda värden.

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

Uppdatera alla instanser där du anropar s.t() och s.tl() och ersätt dem med kommandot sendEvent. Det finns tre scenarier:

• Spårning av sidvy: Ersätt spårningsanropet för sidvyn med kommandot Web SDK sendEvent:

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

• Automatisk länkspårning: Konfigurationsegenskapen clickCollectionEnabled är aktiverad som standard. Den ställer automatiskt in rätt länkspårningsvariabler för att skicka data till Adobe Analytics. Om du vill inaktivera automatisk länkspårning anger du den här egenskapen till false i kommandot configure.

• Manuell länkspårning: Web SDK har inte olika kommandon mellan sidvyanrop och icke-sidvisningsanrop. Ange den skillnaden i nyttolastobjektet.

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

När du har tagit bort alla referenser till AppMeasurementet och objektet s publicerar du ändringarna i utvecklingsmiljön för att validera att den nya implementeringen fungerar. När du har kontrollerat att allt fungerar som det ska kan du publicera dina uppdateringar i produktionen.

Om det migreras korrekt krävs inte längre AppMeasurement.js på din plats och alla referenser till det här skriptet kan tas bort.