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 productos en la parte superior derecha para desplazarse a Recopilación de datos.
3. En el panel de navegación izquierdo, seleccione Datastreams.
4. Seleccione Nueva secuencia de datos.
5. Introduzca el nombre que desee y seleccione Guardar.
6. Una vez creada la secuencia de datos, seleccione Añadir 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 al conjunto de datos creado en el paso anterior mediante el SDK web configure comando. El configure El comando debe configurarse en cada página para que pueda incluirse junto con el código de instalación de la biblioteca.

Utilice el edgeConfigId y orgId propiedades dentro del SDK web configure comando:

• Configure las variables edgeConfigId al ID de la secuencia de datos recuperado del paso anterior.
• Configure las variables orgId a la organización de IMS de su organización.

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

Si lo desea, puede definir otras propiedades en la variable 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 lo siguiente AppMeasurement.js o el s objeto. 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 un Capa de datos en su sitio ayuda enormemente a la hora de configurar valores, ya que puede seguir haciendo referencia a esos mismos valores.

Para enviar datos a Adobe Analytics, la carga útil del SDK web debe utilizar data.__adobe.analytics con todas las variables de analytics 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 lo divida en objetos individuales como lo haría con XDM. En su lugar, inclúyala como una cadena exactamente como es si establece el valor s.products variable:

{
  "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 a s en la implementación se han eliminado. 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 s.tl(), sustituyéndolos por el sendEvent comando. Hay tres escenarios a considerar:

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

  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 clickCollectionEnabled La propiedad de configuración de está habilitada de forma 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 como false dentro de configure comando.

• Seguimiento manual de vínculos: el SDK web no tiene comandos independientes entre las llamadas a la vista de página y a las que no son de vista de página. 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 eliminado todas las referencias a AppMeasurement y a s , publique los cambios en el 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 es necesaria en el sitio y se pueden eliminar todas las referencias a esta secuencia de comandos.