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 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.

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, a continuación, seleccione Etiquetas.

2. Seleccione la propiedad de etiquetas que desee.

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

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

5. Busque y seleccione la extensión Adobe Experience Platform Web SDK 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 Agregar 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 - Set 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 Action Configuration por 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 el objeto s, use data.__adobe.analytics. 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. Consulte cada variable correspondiente para determinar cómo lograr su equivalente mediante 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 al objeto s en ninguna parte.

Los pasos anteriores solo se aplican a las reglas que establecen valores. Los pasos siguientes reemplazan todas las acciones que usan la Configuración de la acción Enviar señalización.

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

2. Seleccione la acción Adobe Analytics - Send Beacon.

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

4. Cambie Action Configuration por 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áginas web. Para s.tl(), use Clics en vínculos de interacción web. Si usa s.tl(), también debe incluir los campos siguientes en el objeto de datos. Estos campos se enumeran en Propiedades adicionales al realizar la configuración de la acción Actualizar variable:

     • 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. Seleccione Agregar biblioteca.
3. Asigne un nombre a esta confirmación de etiqueta, como "Actualizar al SDK web".
4. Seleccione Agregar 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 la extensión Adobe Analytics. A la derecha, seleccione Deshabilitar.
3. Siga el mismo flujo de trabajo de publicación anterior para publicar la eliminación de la extensión Adobe Analytics.
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 de 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.