Migración de la extensión de etiqueta de Adobe Analytics a la extensión de etiqueta del 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.

Esta sección prepara la etiqueta para el grueso del esfuerzo de migración que se produce en el siguiente paso.

1. Haga clic en el icono de hamburguesa en la parte superior izquierda de la interfaz de Adobe Experience Platform y seleccione Etiquetas.

2. Seleccione la propiedad de etiquetas que desee.

3. En el panel de navegación izquierdo de la propiedad de etiqueta, seleccione Extensiones.

4. Seleccionar Catálogo cerca de la parte superior para ver una lista de todas las extensiones disponibles.

5. Busque y seleccione el SDK web de Adobe Experience Platform y, a continuación, haga clic en Instalar a la derecha.

   

6. Aparecerán los ajustes de configuración de la extensión. Busque la sección Flujos de datos y seleccione el flujo de datos que creó en el paso anterior.

   

7. Seleccione Guardar.

La propiedad de etiquetas ahora tiene instalado el SDK web.

El elemento de datos del objeto de datos proporciona un marco de trabajo intuitivo para configurar una carga útil que el SDK web utiliza para enviar a un conjunto de datos. La mayoría de las reglas que actualiza en el siguiente paso interactúan con este elemento de datos.

1. En la navegación izquierda de la interfaz de etiquetas, seleccione Elementos de datos.

2. Seleccionar Añadir elemento de datos

3. Asigne al elemento de datos la siguiente configuración:

   • Nombre: cualquier cosa que desee, como "Capa de datos" u "Objeto de datos"
   • Extensión: SDK web de Adobe Experience Platform
   • Tipo de elemento de datos: Variable
   • Las casillas de verificación pueden permanecer tal cual

4. A la derecha, seleccione la siguiente configuración:

   • Botón de opción Propiedad: Datos
   • Solución: Adobe Analytics

5. Seleccione Guardar.

La propiedad de etiquetas ahora tiene todo lo necesario para actualizar cada regla.

Este paso supone la mayor parte del esfuerzo necesario para migrar al SDK web y requiere conocer cómo funciona la implementación. A continuación se proporciona un ejemplo de cómo editar una regla de etiqueta típica. Actualice todas las reglas de etiquetas de la implementación para reemplazar todas las referencias a la extensión de Adobe Analytics con la extensión del SDK web.

1. En la navegación izquierda de la interfaz de etiquetas, seleccione Reglas.

2. Seleccione una regla para editarla.

3. Seleccione la acción Adobe Analytics: Establecer variables

4. Tenga en cuenta todas las variables de Analytics configuradas dentro de esta regla. Incluya ambas variables establecidas en los menús desplegables y las variables establecidas dentro del código personalizado.

5. Cambie el Configuración de acción a la siguiente configuración:

   • Extensión: SDK web de Adobe Experience Platform
   • Tipo de acción: Actualizar variable

6. Asegúrese de que el objeto de datos esté seleccionado en la lista desplegable de la derecha.

7. Establezca las variables de Analytics en sus mismos valores respectivos, ya que se configuraron en la extensión de Analytics.

   • Las variables configuradas dentro de la interfaz de etiquetas pueden traducirse directamente a los mismos valores.
   • Las variables de cadena configuradas en el código personalizado requieren ajustes mínimos. En lugar de usar la variable s objeto, uso data.__adobe.analytics en su lugar. Por ejemplo, s.eVar1 se traduciría a data.__adobe.analytics.eVar1.
   • Las variables de configuración de Analytics y las llamadas a métodos en el código personalizado pueden requerir la modificación de la lógica de implementación. Ver cada respectivo variable para determinar cómo conseguir su equivalente utilizando el SDK web.

8. Una vez replicada toda la lógica de reglas mediante la extensión del SDK web, seleccione Conservar cambios.

9. Repita estos pasos para cada configuración de acción que utilice la extensión de Adobe Analytics para establecer valores. Este paso incluye ambas variables configuradas mediante la interfaz de etiquetas y las variables configuradas mediante código personalizado. Los bloques de código personalizado no pueden hacer referencia a s objeto en cualquier lugar.

Los pasos anteriores solo se aplican a las reglas que establecen valores. Los pasos siguientes reemplazan todas las acciones que utilizan el Configuración de acción Send Beacon.

1. Seleccione una regla que envíe una señalización.

2. Seleccione la acción Adobe Analytics - Enviar señalización.

3. Observe el valor actual de Seguimiento botón de opción de la derecha (s.t() o s.tl()).

4. Cambie el Configuración de acción a la siguiente configuración:

   • Extensión: SDK web de Adobe Experience Platform
   • Tipo de acción: Enviar evento

5. A la derecha, cambie la configuración de la acción a lo siguiente:

   • Tipo: para s.t(), use Vistas de página de detalles de página web. Para s.tl(), use Clics en vínculos de Web Webinteraction. Si utiliza s.tl()Además, también debe incluir los campos siguientes en el objeto de datos. Estos campos se enumeran en Propiedades adicionales al realizar el Actualizar variable configuración de acción:

     • Nombre de la vinculación
     • Tipo de vínculo
     • URL de vínculo

6. Seleccione Conservar cambios.

7. Repita estos pasos para cada configuración de acción que utilice Adobe Analytics para enviar una señalización.

La publicación de reglas actualizadas sigue el mismo flujo de trabajo que cualquier otro cambio en la configuración de las etiquetas.

1. En la navegación izquierda de la interfaz de etiquetas, seleccione Flujo de publicación.
2. Seleccionar Añadir biblioteca.
3. Asigne un nombre a esta confirmación de etiqueta, como "Actualizar al SDK web".
4. Seleccionar Añadir todos los recursos modificados.
5. Seleccione Guardar.
6. El flujo de trabajo de publicación muestra un punto naranja que indica que se está generando. Una vez que el punto se vuelva verde, los cambios estarán disponibles en el entorno de desarrollo.
7. Pruebe los cambios en el entorno de desarrollo para asegurarse de que todas las reglas se activan correctamente y de que el objeto de datos se rellena con los valores esperados.
8. Cuando esté listo, envíe la biblioteca para su aprobación, créela al entorno de ensayo y, finalmente, apruebe y publique en producción.

Una vez que la implementación de etiquetas esté completamente en el SDK web, puede desactivar la extensión de Adobe Analytics.

1. En la navegación izquierda de la interfaz de etiquetas, seleccione Extensiones.
2. Busque y seleccione el Adobe Analytics extensión. A la derecha, seleccione Deshabilitar.
3. Siga el mismo flujo de trabajo de publicación anterior para publicar la eliminación del Adobe Analytics extensión.
4. Una vez que la extensión esté desactivada en producción, puede desinstalarla por completo. Seleccione la extensión, seleccione el menú de tres puntos a la derecha y, a continuación, seleccione Desinstalar.
5. Siga el mismo flujo de trabajo de publicación anterior para publicar esos cambios en producción.