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

Previsto audiencia

Este Página está destinado a Audience Manager clientes que utilizan la extensión Audience Manageretiqueta para poner en Audience Manager datos de colección web. Para los clientes que utilicen el biblioteca de JavaScript AppMeasurement, lea la guía sobre cómo actualizar su biblioteca de recopilación de datos para Audience Manager desde el biblioteca de JavaScript de AppMeasurement al biblioteca de JavaScript del SDK web.

Ventajas y desventajas de esta ruta de implementación

El uso de este enfoque de migración tiene ventajas y desventajas. Sopese cuidadosamente cada opción para decidir qué enfoque es mejor para su organización.

Ventajas
Desventajas
  • No hay cambios de código en el sitio: Dado que su implementación ya tiene etiquetas instaladas, todas las actualizaciones de migración se pueden realizar en la interfaz de etiquetas.
  • Utiliza sus implementación existentes: Este enfoque no requiere un nuevo implementación neto. Aunque requiere nuevas acciones regla, puede reutilizar los elementos de datos existentes y regla condiciones con cambios mínimos.
  • No necesita un esquema: para este fase de migración al SDK web, no necesita un esquema XDM. En su lugar, puede rellenar el data objeto, que envía los datos directamente a Adobe Audience Manager. Una vez completada la migración al SDK web, puede crear un esquema para su organización y utilizar la asignación de secuencias de datos para rellenar los campos XDM aplicables. Si se necesitara un esquema en este fase del proceso de migración, su organización se vería obligada a utilizar un esquema XDM Adobe Audience Manager. El uso de este esquema hace que sea más difícil para su organización utilizar sus propios esquema en el futuro.
  • Deuda técnica de implementación: Dado que este enfoque utiliza una forma modificada de su implementación existente, puede ser más difícil rastrear implementación lógica y realizar cambios cuando sea necesario. El código personalizado puede ser particularmente difícil de depurar.
  • Requiere asignación para enviar datos a Platform: Cuando su organización esté lista para usar CDP en tiempo real, debe enviar datos a un conjunto de datos en Adobe Experience Platform. Esta acción requiere que cada campo del data objeto sea una entrada en el herramienta de asignación del flujo de datos que lo asigna a un campo de esquema XDM. Para este flujo de trabajo, el mapeo solo debe realizarse una vez, y no implica realizar cambios implementación. Sin embargo, es un paso adicional que no es necesario al enviar datos en un objeto XDM.

Adobe Systems recomienda seguir esta ruta de implementación cuando tenga un implementación existente que use la extensión Adobe Audience Manager etiqueta.

Pasos necesarios para migrar al SDK web

Los siguientes pasos contienen objetivos concretos hacia los que trabajar. Seleccione cada paso para obtener instrucciones detalladas sobre cómo realizarlo.

1. Crear y configurar un flujo de datos

Siga las instrucciones a continuación para crear un flujo de datos en Adobe Experience Platform recopilación de datos. Cuando envía datos a este flujo de datos, este reenvía datos a Audience Manager. En el futuro, este mismo flujo de datos reenvía datos a CDP en tiempo real.

  1. Navegue hasta experience.adobe.com e inicie sesión con sus credenciales.

  2. Utilice el selector página de inicio o producto de la parte superior derecha para desplazarse hasta Data Collection.

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

  4. Seleccione New Datastream.

  5. Introduzca el nombre que desee y, a continuación, seleccione Save.

  6. Una vez creado el flujo de datos, seleccione Add Service.

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

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

    añadir servicio Audience Manager

El flujo de datos ya está listo para recibir y pasar datos a Audience Manager.

2. añadir la extensión del SDK web a su Propiedad de etiqueta

Esta sección prepara su etiqueta para la mayor parte del esfuerzo de migración que tiene lugar en el siguiente paso.

  1. Seleccione el icono de hamburguesa en la parte superior izquierda de la interfaz de Adobe Experience Platform y, a continuación, seleccione Tags.

  2. Seleccione el Propiedad de etiqueta que desee.

  3. En la navegación izquierda del Propiedad etiqueta, seleccione Extensions.

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

  5. Search extensión y selecciónela Adobe Experience Platform Web SDK y, a continuación, seleccione Install en el lado derecho.

    Catálogo

  6. Aparecen los ajustes de configuración de la extensión. Busque la Datastreams sección y seleccione el entorno de pruebas que está utilizando y el flujo de datos que creó en el paso anterior.

    Selección de flujo de datos

  7. Seleccione Save.

El etiqueta Propiedad ya tiene instalado el SDK web.

3. Crear un elemento de datos de objeto de datos

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

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

  2. Escoger Add Data Element

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

    • Name: cualquier cosa que pueda gustar, 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 como están.
  4. En el lado derecho, seleccione la siguiente configuración:

    • botón de radio de la propiedad: Data
    • Solution: Adobe Audience Manager
  5. Seleccione Save.

    Crear elemento de datos

Ahora su Propiedad etiqueta tiene todo lo necesario para actualizar cada regla.

4. Actualizar reglas para utilizar la extensión del SDK web en lugar de la extensión de Audience Manager

Este paso contiene la mayor parte del esfuerzo necesario para migrar al SDK web y requiere conocimiento de cómo funciona su implementación. A continuación se ofrece un ejemplo de cómo editar un regla de etiqueta típico. Actualizar todo etiqueta reglas del implementación reemplazar todas las referencias a la extensión Audience Manager por la extensión del SDK web.

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

  2. Seleccione el regla que desea editar.

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

  4. Tenga en cuenta todas las variables Audience Manager establecidas en este regla. Incluya tanto las variables configuradas en los menús desplegables como las variables configuradas en el código personalizado.

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

    • Extension: Adobe Experience Platform Web SDK
    • Action type: Actualización variable
  6. Asegúrese de que el objeto de datos que creó en el paso 3 está seleccionado en el menú desplegable de la derecha, en el Data element campo.

  7. Establezca los pares clave-valor Audience Manager en sus mismos valores respectivos que se configuraron en la extensión Audience Manager.

  8. Una vez que toda la lógica regla se haya replicado 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 etiqueta de 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 utilizan el Action Configuration Send Event.

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

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

  3. Cambie a Action Configuration 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: Uso 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 una evento.

5. Publish reglas actualizadas

Publicación reglas actualizadas siguen la misma flujo de trabajo que cualquier otro cambio en la configuración de etiquetas.

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

  2. Seleccione Add Library.

  3. Asigne a este etiqueta confirmación un nombre, como "Actualizar a 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 vuelve verde, los cambios estarán disponibles en su 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 el biblioteca para su aprobación, versión al ensayo y, finalmente, apruebe y publicar a producción.

    Publicación flujo

6. Deshabilitar Audience Manager extensión

Una vez que el implementación de etiqueta se haya migrado completamente al SDK web, puede desactivar la extensión Audience Manager.

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

En este punto, su implementación Audience Manager se ha migrado completamente al SDK web y está preparado para pasar a CDP en tiempo real en el futuro.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695