Actualice la biblioteca de recopilación de datos para el Audience Manager de la extensión de etiqueta de Audience Manager a la extensión de etiqueta del SDK web

Siga las instrucciones siguientes para crear un conjunto de datos en la recopilación de datos de Adobe Experience Platform. Al enviar datos a este conjunto de datos, se reenvían datos al Audience Manager. En el futuro, este mismo conjunto de datos reenviará datos a Real-Time CDP.

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 parte superior derecha para navegar a Data Collection.

3. En el panel de navegación izquierdo, seleccione Datastreams.

4. Seleccione New Datastream.

5. Escriba el nombre que desee y seleccione Save.

6. Una vez creada la secuencia de datos, seleccione Add Service.

7. En el menú desplegable del servicio, seleccione Adobe Audience Manager.

8. Asegúrese de que la opción Enable XDM Flattened Fields esté desmarcada.

   

El conjunto de datos está listo para recibir y pasar datos al Audience Manager.

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

1. Seleccione el ícono de hamburguesa en la parte superior izquierda de la interfaz de Adobe Experience Platform y luego seleccione Tags.

2. Seleccione la propiedad de etiquetas que desee.

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

4. Seleccione Catalog 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, luego seleccione Install a la derecha.

   

6. Aparecerán los ajustes de configuración de la extensión. Busque la sección Datastreams y seleccione la zona protegida que está utilizando y la secuencia de datos que creó en el paso anterior.

   

7. Seleccione Save.

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

2. Seleccionar Add Data Element

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

   • Name: cualquier cosa que desee, como "Capa de datos" u "Objeto de datos"
   • Extension: Adobe Experience Platform Web SDK
   • Data Element Type: Variable
   • Las casillas de verificación pueden permanecer tal cual.

4. En el lado derecho, seleccione la siguiente configuración:

   • Botón de opción Propiedad: Data
   • Solution: Adobe Audience Manager

5. Seleccione Save.

   

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 Audience Manager con la extensión del SDK web.

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

2. Seleccione una regla para editarla.

3. Seleccione la acción Audience Manager - Set Variables

4. Tenga en cuenta todas las variables de Audience Manager 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 a la siguiente configuración:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: actualizar variable

6. Asegúrese de que el objeto de datos que creó en el paso 3 esté seleccionado en la lista desplegable de la derecha, en el campo Data element.

7. Establezca los pares de clave-valor del Audience Manager en sus mismos valores respectivos tal y como se configuraron en la extensión del Audience Manager.

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

9. Repita estos pasos para cada configuración de acción que utilice la extensión de etiqueta Audience Manager para establecer valores.

Los pasos anteriores solo se aplican a las reglas que establecen valores. Los pasos siguientes reemplazan todas las acciones que usan Action Configuration Send Event.

1. Seleccione una regla que envíe un evento de SDK web.

2. Seleccione el tipo de acción Send Event.

3. Cambie Action Configuration a la siguiente configuración:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Send event

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

   • Type: use Web Webpagedetails Page Views.
   • Data: seleccione el objeto de datos que creó en el paso 3.

5. Seleccione Keep Changes.

6. Repita estos pasos para cada configuración de acción que utilice Audience Manager para enviar un evento.

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

2. Seleccione Add Library.

3. Asigne un nombre a esta confirmación de etiqueta, como "Actualizar al SDK web".

4. Seleccione Add All Changed Resources.

5. Seleccione Save.

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 haya migrado completamente al SDK web, puede desactivar la extensión de Audience Manager.

1. En la navegación izquierda de la interfaz de etiquetas, seleccione Extensions.
2. Busque y seleccione la extensión Audience Manager. A la derecha, seleccione Disable.
3. Siga el mismo flujo de trabajo de publicación anterior para publicar la eliminación de la extensión Audience Manager.
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 Uninstall.
5. Siga el mismo flujo de trabajo de publicación anterior para publicar esos cambios en producción.