Migración del AppMeasurement al SDK web

Cree una secuencia de datos en la recopilación de datos de Adobe Experience Platform. Cuando envía datos a este conjunto de datos, estos se reenvían a Adobe Analytics. En el futuro, este mismo conjunto de datos reenviará datos a Customer Journey Analytics.

1. Vaya a experience.adobe.com e inicie sesión con sus credenciales.
2. Utilice la página de inicio o el selector de producto en la esquina superior derecha para navegar a Recopilación de datos.
3. En el panel de navegación izquierdo, seleccione Datastreams.
4. Seleccione Nueva secuencia de datos.
5. Escriba el nombre que desee y luego seleccione Guardar.
6. Una vez creada la secuencia de datos, seleccione Agregar servicio.
7. En el menú desplegable del servicio, seleccione Adobe Analytics.
8. Introduzca el mismo ID de grupo de informes que el sitio al que envía actualmente los datos de análisis. Haga clic en Guardar.

El conjunto de datos ya está listo para recibir y pasar datos a Adobe Analytics. Tenga en cuenta el ID de la secuencia de datos, ya que este ID es necesario al configurar el SDK web en código.

Configure la implementación para que apunte a la secuencia de datos creada en el paso anterior mediante el comando del SDK web configure. El comando configure debe estar establecido en todas las páginas para que pueda incluirlo junto con el código de instalación de la biblioteca.

Use las propiedades datastreamId y orgId en el comando configure del SDK web:

• Establezca datastreamId en el ID de secuencia de datos recuperado del paso anterior.
• Establezca orgId en la organización de IMS de su organización.

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

Opcionalmente, puede establecer otras propiedades en el comando configure en función de los requisitos de implementación de su organización.

Cambie la implementación de Analytics para que no dependa de AppMeasurement.js ni del objeto s. En su lugar, establezca variables en un objeto JavaScript con formato correcto, que se convierte en un objeto JSON cuando se envía al Adobe. Tener una capa de datos en el sitio ayuda enormemente a la hora de establecer valores, ya que puede seguir haciendo referencia a esos mismos valores.

Para enviar datos a Adobe Analytics, la carga del SDK web debe usar data.__adobe.analytics con todas las variables de análisis establecidas dentro de este objeto. Las variables de este objeto comparten nombres y formatos idénticos a los de sus equivalentes de variables de AppMeasurement. Por ejemplo, si establece la variable products, no la divida en objetos individuales como lo haría con XDM. En su lugar, inclúyala como una cadena exactamente como es si establece la variable s.products:

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

En última instancia, esta carga útil contiene todos los valores deseados y todas las referencias al objeto s en su implementación se eliminan. Puede utilizar cualquiera de los recursos que proporciona JavaScript para establecer este objeto de carga útil, incluida la notación de puntos para establecer valores individuales.

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

Actualice todas las instancias en las que llame a s.t() y a s.tl(), reemplazándolas por el comando sendEvent. Hay tres escenarios a considerar:

• Seguimiento de vista de página: reemplace la llamada de seguimiento de vista de página con el comando sendEvent del SDK web:

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

• Seguimiento automático de vínculos: La propiedad de configuración clickCollectionEnabled está habilitada de manera predeterminada. Establece automáticamente las variables de seguimiento de vínculos correctas para enviar datos a Adobe Analytics. Si desea deshabilitar el seguimiento automático de vínculos, establezca esta propiedad en false dentro del comando configure.

• Seguimiento manual de vínculos: el SDK web no tiene comandos independientes entre las llamadas a pageview y a las que no son a pageview. Proporcione esa distinción dentro del objeto de carga útil.

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

Una vez que haya quitado todas las referencias al AppMeasurement y al objeto s, publique los cambios en su entorno de desarrollo para validar que la nueva implementación funciona. Una vez que haya validado que todo funciona correctamente, puede publicar las actualizaciones en producción.

Si se migra correctamente, AppMeasurement.js ya no será necesario en el sitio y se podrán eliminar todas las referencias a este script.