Migreren van AppMeasurement naar de Web SDK

Maak een gegevensstroom in de gegevensverzameling van Adobe Experience Platform. Wanneer u gegevens naar deze gegevensstroom verzendt, stuurt het gegevens door naar Adobe Analytics. In de toekomst stuurt dezelfde gegevensstroom gegevens door naar de Customer Journey Analytics.

1. Navigeren naar experience.adobe.com en meld u aan met uw referenties.
2. Gebruik de homepage of productkiezer in de rechterbovenhoek om naar Data Collection.
3. Selecteer in de linkernavigatie de optie Datastreams.
4. Selecteren New Datastream.
5. Voer de gewenste naam in en selecteer Save.
6. Wanneer de gegevensstroom is gemaakt, selecteert u Add Service.
7. Selecteer in het vervolgkeuzemenu Service de optie Adobe Analytics.
8. Voer dezelfde rapportsuite-id in als de site waarnaar u momenteel analysegegevens verzendt. Klik op Save.

Uw gegevensstroom is nu klaar om gegevens te ontvangen en door te geven aan Adobe Analytics. Noteer de gegevensstroom-id, aangezien deze id vereist is voor het configureren van de Web SDK in code.

Opstelling uw implementatie om aan de datastream te richten die in de vorige stap door het Web SDK wordt gecreeerd te gebruiken configure gebruiken. De configure moet op elke pagina worden ingesteld, zodat u deze naast de installatiecode van de bibliotheek kunt plaatsen.

Gebruik de edgeConfigId en orgId eigenschappen binnen de Web SDK configure opdracht:

• Stel de edgeConfigId naar de gegevensstroom-id die u hebt opgehaald uit de vorige stap.
• Stel de orgId op IMS org van uw organisatie.

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

U kunt desgewenst andere eigenschappen instellen in het dialoogvenster configure afhankelijk van de implementatievereisten van uw organisatie.

Wijzig uw analytische implementatie zodat deze niet afhankelijk is van AppMeasurement.js of de s object. In plaats daarvan kunt u variabelen instellen in een JavaScript-object met de juiste indeling. Dit object wordt omgezet in een JSON-object wanneer het naar de Adobe wordt verzonden. Met een Gegevenslaag op uw site helpt u enorm bij het instellen van waarden, aangezien u kunt blijven verwijzen naar dezelfde waarden.

Voor het verzenden van gegevens naar Adobe Analytics moet de Web SDK-payload data.__adobe.analytics met alle analytische variabelen die binnen dit object zijn ingesteld. Variabelen in dit object hebben dezelfde namen en indelingen als de variabele tegenhangers van het AppMeasurement. Als u bijvoorbeeld de opdracht products variabele, niet in individuele voorwerpen verdelen zoals u met XDM zou doen. In plaats daarvan neemt u de eigenschap als tekenreeks op als u de instelling s.products variabele:

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

Uiteindelijk bevat deze lading alle gewenste waarden, en alle verwijzingen naar s -object in uw implementatie wordt verwijderd. U kunt alle bronnen die JavaScript biedt, gebruiken om dit payload-object in te stellen, inclusief puntnotatie voor het instellen van individuele waarden.

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

Werk alle instanties bij waar u roept s.t() en s.tl(), die worden vervangen door de sendEvent gebruiken. Er zijn drie scenario's om te overwegen:

• Paginaweergave bijhouden: Vervang de volgende vraag van de paginamening met het Web SDK sendEvent opdracht:

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

• Automatisch koppelingen bijhouden: De clickCollectionEnabled configuratie-eigenschap is standaard ingeschakeld. De juiste variabelen voor het bijhouden van koppelingen worden automatisch ingesteld om gegevens naar Adobe Analytics te verzenden. Als u automatische koppeling bijhouden wilt uitschakelen, stelt u deze eigenschap in op false binnen de configure gebruiken.

• Handmatige koppeling bijhouden: De SDK van het Web heeft geen afzonderlijke bevelen tussen de vraag van de paginalevening en niet van de paginaleving. Geef dat onderscheid op in het object payload.

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

Als u alle verwijzingen naar het AppMeasurement en de s -objecten, publiceert u uw wijzigingen in uw ontwikkelomgeving om te controleren of de nieuwe implementatie werkt. Nadat u hebt gecontroleerd dat alles correct werkt, kunt u uw updates publiceren voor productie.

Als de migratie correct is, AppMeasurement.js is niet meer vereist op uw site en alle verwijzingen naar dit script kunnen worden verwijderd.