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. Navigeer aan experience.adobe.comen login gebruikend uw geloofsbrieven.
2. Gebruik de startpagina of de productkiezer rechtsboven om naar Data Collection te navigeren.
3. Selecteer Datastreams in de linkernavigatie.
4. Selecteer New Datastream .
5. Voer de gewenste naam in en selecteer vervolgens Save .
6. Wanneer de gegevensstroom is gemaakt, selecteert u Add Service .
7. Selecteer Adobe Analytics in het vervolgkeuzemenu voor de service.
8. Voer dezelfde rapportsuite-id in als de site waarnaar u momenteel analysegegevens verzendt. Klik op Save.

toe

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 wordt gecreeerd door het Web SDK configure te gebruikenbevel. De opdracht configure moet op elke pagina worden ingesteld, zodat u deze naast de installatiecode van de bibliotheek kunt plaatsen.

Gebruik de eigenschappen datastreamIden orgIdbinnen het bevel van SDK van het Web configure:

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

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

U kunt naar keuze andere eigenschappen in het configure plaatsenbevel afhankelijk van de implementatievereisten van uw organisatie.

Wijzig de analytische implementatie zodat deze niet afhankelijk is van AppMeasurement.js of het s -object. Stel in plaats daarvan variabelen in in een JavaScript-object met de juiste indeling, dat wordt omgezet in een JSON-object wanneer het naar de Adobe wordt verzonden. Het hebben van de laag van a Gegevensop uw plaats helpt enorm wanneer het plaatsen van waarden, aangezien u die zelfde waarden kunt blijven van verwijzingen voorzien.

Voor het verzenden van gegevens naar Adobe Analytics moet de Web SDK-payload data.__adobe.analytics gebruiken 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 variabele products instelt, moet u deze niet splitsen in afzonderlijke objecten, zoals bij XDM. Neem de variabele in plaats daarvan op als een tekenreeks, precies wanneer u de variabele s.products instelt:

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

Uiteindelijk bevat deze payload alle gewenste waarden en worden alle verwijzingen naar het s -object in de implementatie 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 s.t() en s.tl() roept, die hen met het sendEventbevel vervangen. Er zijn drie scenario's om te overwegen:

• het volgen van de mening van de Pagina: Vervang de het volgen vraag van de paginamening met het bevel van SDK van het Web sendEvent:

  // 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 verbinding het volgen: Het clickCollectionEnabledconfiguratiebezit wordt toegelaten door gebrek. De juiste variabelen voor het bijhouden van koppelingen worden automatisch ingesteld om gegevens naar Adobe Analytics te verzenden. Als u automatische verbinding het volgen wilt onbruikbaar maken, plaats dit bezit aan false binnen het configurebevel.

• Handmatig verbinding het volgen: Het Web SDK heeft geen afzonderlijke bevelen tussen de voorproef en niet-voorproefvraag. Geef dat onderscheid op in het object payload.

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

Nadat u alle verwijzingen naar het AppMeasurement en het s -object hebt verwijderd, publiceert u uw wijzigingen in de 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, is AppMeasurement.js niet meer vereist op uw site en kunnen alle verwijzingen naar dit script worden verwijderd.