Exportación de fragmentos de experiencias a Adobe Target

PRECAUCIÓN
  • Los fragmentos de experiencias de AEM se exportan al espacio de trabajo predeterminado de Adobe Target.
  • AEM debe integrarse con Adobe Target según las instrucciones de Integración con Adobe Target.

Puede exportar Fragmentos de experiencias, creados en Adobe Experience Manager as a Cloud Service (AEM), en Adobe Target (Target). Luego pueden utilizarse como ofertas en actividades de Target para probar y personalizar experiencias a escala.

Hay tres opciones disponibles para exportar un fragmento de experiencia a Adobe Target:

  • HTML (predeterminado): Compatibilidad con la entrega de contenido web e híbrido
  • JSON: Compatibilidad con entrega de contenido sin encabezado
  • HTML y JSON

Para preparar la instancia para exportar fragmentos de experiencias de AEM a Adobe Target, debe:

Después, puede:

Los fragmentos de experiencias se pueden exportar al espacio de trabajo predeterminado en Adobe Target o a espacios de trabajo definidos por el usuario para Adobe Target.

NOTA

Los espacios de trabajo de Adobe Target no existen en Adobe Target. Se definen y administran en Adobe IMS (Sistema Identity Management) y, a continuación, se seleccionan para su uso en todas las soluciones mediante la consola de Adobe Developer.

NOTA

Los espacios de trabajo de Adobe Target se pueden utilizar para permitir a los miembros de una organización (grupo) crear y administrar ofertas y actividades solo para esta organización; sin dar acceso a otros usuarios. Por ejemplo, las organizaciones específicas de los países dentro de una preocupación mundial.

Requisitos previos

Se requieren varias acciones:

  1. Tiene que integrar AEM con Adobe Target.

  2. Los fragmentos de experiencias se exportan desde la instancia de autor de AEM, por lo que debe Configurar el externalizador de vínculos de AEM en la instancia de autor para garantizar que todas las referencias dentro del fragmento de experiencia se externalicen para la entrega web.

    NOTA

    Para que la reescritura de vínculos no esté cubierta por el valor predeterminado, el Proveedor de reescritura de vínculos de fragmentos de experiencia está disponible. Con esto, se pueden desarrollar reglas personalizadas para su instancia.

Agregar la configuración de nube

Antes de exportar un fragmento, debe agregar la Configuración de nube para Adobe Target al fragmento o carpeta. Esto también le permite:

  • especificar las opciones de formato que se utilizarán para la exportación
  • seleccionar un espacio de trabajo de Target como destino
  • seleccione un dominio externalizador para reescribir referencias en el fragmento de experiencia (opcional)

Las opciones requeridas se pueden seleccionar en Propiedades de página de la carpeta o fragmento necesarios; la especificación se hereda según sea necesario.

  1. Vaya a la consola de fragmentos de experiencias.

  2. Abra Propiedades de página para la carpeta o fragmento correspondiente.

    NOTA

    Si agrega la configuración de nube a la carpeta principal del fragmento de experiencia, la configuración la heredan todos los elementos secundarios.

    Si agrega la configuración de nube al propio fragmento de experiencia, esta se hereda de todas las variaciones.

  3. Seleccione la pestaña Cloud Services.

  4. En Configuración de Cloud Service, seleccione Adobe Target en la lista desplegable.

    NOTA

    El formato JSON de una oferta de fragmento de experiencia se puede personalizar. Para ello, defina un componente de fragmento de experiencia del cliente y, a continuación, anote cómo exportar sus propiedades en el componente Modelo Sling.

    Consulte el componente principal: Componentes principales: fragmentos de experiencias

  5. En Adobe Target seleccione:

    • la configuración adecuada
    • la opción de formato requerido
    • un espacio de trabajo de Adobe Target
    • si es necesario: el dominio externalizador
    PRECAUCIÓN

    El dominio externalizador es opcional.

    Se configura un externalizador de AEM cuando desea que el contenido exportado apunte a un dominio publicar específico. Para obtener más información, consulte Configuración del externalizador de vínculos AEM.

    Tenga en cuenta también que los dominios externalizadores solo son relevantes para el contenido del fragmento de experiencia que se envía a Target y no para los metadatos como Ver contenido de la oferta.

    Por ejemplo, para una carpeta:

    Carpeta: Cloud Services

  6. Guardar y cerrar.

Agregar la configuración heredada

IMPORTANTE

Añadir una nueva configuración heredada es un caso especial que solo se admite para la exportación de fragmentos de experiencias.

Después adición de la configuración de nube para utilizar Launch by Adobe, para integrar inicialmente AEM con Adobe Target, también debe integrarlo manualmente con Adobe Target mediante una configuración heredada.

Creación de una configuración de Target Cloud

Para permitir que AEM interactúe con Adobe Target, cree una configuración de nube de Target. Para crear la configuración, proporcione el código de cliente de Adobe Target y las credenciales de usuario.

La configuración de la nube de Target solo se crea una vez porque se puede asociar con varias campañas de AEM. Si tiene varios códigos de cliente de Adobe Target, cree una configuración para cada código de cliente.

Puede configurar la configuración de nube para sincronizar segmentos desde Adobe Target. Si activa la sincronización, los segmentos se importan desde Target en segundo plano en cuanto se guarda la configuración de la nube.

Utilice el siguiente procedimiento para crear una configuración de nube de Target en AEM:

  1. Vaya a Cloud Services heredados a través de la variable Logotipo de AEM > Herramientas > Cloud Services > Cloud Services heredados.
    Por ejemplo: (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    Se abre la página de información general de Adobe Experience Cloud

  2. En la sección Adobe Target, haga clic en Configurar ahora.

  3. En el cuadro de diálogo Crear configuración:

    1. Asigne una configuración a Título.
    2. Seleccione la plantilla Configuración de Adobe Target.
    3. Haga clic en Crear.

Ahora puede seleccionar la nueva configuración para editarla.

  1. Se abre el cuadro de diálogo de edición.

    config-target-settings-dialog

  2. En el cuadro de diálogo Configuración de Adobe Target, proporcione valores para estas propiedades.

    • Autenticación: de forma predeterminada, se usa IMS (las credenciales de usuario están obsoletas)

    • Código de cliente: el código de cliente de la cuenta de Target

    • ID del inquilino: el ID del inquilino

    • Configuración de IMS: seleccione la configuración necesaria en la lista desplegable

    • Tipo de API: el valor predeterminado es REST (XML está obsoleto)

    • Configuración de A4T Analytics Cloud: Seleccione la configuración de Analytics Cloud que se utiliza para las métricas y los objetivos de las actividades de Target. Lo necesita si utiliza Adobe Analytics como fuente de informes al segmentar contenido.

    • Use objetivos precisos: De forma predeterminada, esta casilla de verificación está seleccionada. Si se selecciona, la configuración del servicio en la nube esperará a que el contexto se cargue antes de cargar el contenido. Véase la nota siguiente.

    • Sincronizar segmentos desde Adobe Target: Seleccione esta opción para descargar los segmentos definidos en Target y utilizarlos en AEM. Debe seleccionar esta opción cuando la propiedad Tipo de API sea REST, ya que los segmentos en línea no son compatibles y siempre necesita utilizar segmentos de Target. (Tenga en cuenta que el término de AEM de "segmento" equivale a la "audiencia" de Target).

    • Biblioteca de cliente: de forma predeterminada, AT.js (mbox.js está obsoleto).

      NOTA

      El archivo de la biblioteca de Target, AT.JS, es una nueva biblioteca de implementación para Adobe Target que está diseñada tanto para implementaciones web típicas como para aplicaciones de una sola página.

      mbox.js se ha desaprobado y se eliminará en una etapa posterior.

      Adobe recomienda usar AT.js en lugar de mbox.js como biblioteca de cliente.

      AT.js ofrece varias mejoras con respecto a la biblioteca mbox.js:

      • Se han mejorado los tiempos de carga de las páginas en implementaciones web
      • Seguridad mejorada
      • Mejores opciones de implementación para aplicaciones de una sola página
      • AT.js contiene los componentes que se incluían en target.js, de modo que ya no se llama a target.js

      Puede seleccionar AT.js o mbox.js en el menú desplegable Biblioteca de cliente.

    • Usar el sistema de administración de etiquetas para ofrecer la biblioteca de cliente - Seleccione esta opción para utilizar la biblioteca de cliente desde Adobe Launch u otro sistema de administración de etiquetas (o DTM, que está en desuso).

    • AT.js personalizado: Examine para cargar su AT.js personalizado. Deje en blanco para utilizar la biblioteca predeterminada.

      NOTA

      De forma predeterminada, al entrar en el asistente de configuración de Adobe Target, el direccionamiento preciso está habilitado.

      El direccionamiento preciso significa que la configuración del servicio en la nube espera a que el contexto se cargue antes de cargar el contenido. Como resultado, en términos de rendimiento, un direccionamiento preciso puede provocar un retraso de unos milisegundos antes de cargar el contenido.

      El direccionamiento preciso siempre está habilitado en la instancia de autor. Sin embargo, en la instancia de publicación puede optar por desactivar el direccionamiento preciso globalmente, desactivando la marca de verificación junto al direccionamiento preciso en la configuración del servicio en la nube (http://localhost:4502/etc/cloudservices.html). También puede activar y desactivar el direccionamiento preciso para componentes individuales independientemente de la configuración del servicio en la nube.

      Si ya ha creado componentes de destino y cambia esta configuración, los cambios no afectan a esos componentes. Debe realizar cualquier cambio en esos componentes directamente.

  3. Haga clic en Conectarse a Adobe Target para inicializar la conexión con Target. Si la conexión se realiza correctamente, aparecerá el mensaje Conexión correcta. Haga clic en OK en el mensaje y, a continuación, OK en el cuadro de diálogo.

Adición de un marco de trabajo de destino

Después de configurar la nube de Target, agregue un marco de trabajo de Target. El marco de trabajo identifica los parámetros predeterminados que se envían a Adobe Target desde los componentes ContextHub. Target usa los parámetros para determinar los segmentos que se aplican al contexto actual.

Puede crear varios marcos de trabajo para una sola configuración de Target. Los marcos de trabajo múltiples son útiles cuando necesita enviar un conjunto diferente de parámetros a Target para diferentes secciones del sitio web. Cree un marco de trabajo para cada conjunto de parámetros que necesite enviar. Asocie cada sección del sitio web con el marco de trabajo adecuado. Tenga en cuenta que una página web solo puede utilizar un marco de trabajo a la vez.

  1. En la página de configuración de Target, haga clic en el botón + (signo más) junto a Configuraciones disponibles.

  2. En el cuadro de diálogo Crear marco de trabajo, especifique un Título, seleccione Adobe Target Framework y haga clic en Crear.

    Se abre la página marco de trabajo. La barra de tareas proporciona componentes que representan información de ContextHub que puede asignar.

  3. Arrastre el componente Client Context que representa los datos que desea utilizar para la asignación al destino de colocación. También puede arrastrar el componente Almacenamiento de ContextHub al marco de trabajo.

    NOTA

    Al asignar, los parámetros se pasan a un mbox mediante cadenas simples. No se pueden asignar matrices desde ContextHub.

    Por ejemplo, para usar Datos de perfil acerca de los visitantes del sitio para controlar la campaña de Target, arrastre el componente Datos de perfil a la página. Aparecen las variables de datos de perfil disponibles para su asignación a parámetros de Target.

  4. Seleccione las variables que desea que sean visibles para el sistema de Adobe Target seleccionando la casilla de verificación Compartir en las columnas correspondientes.

    NOTA

    La sincronización de parámetros es solo de una manera, de AEM a Adobe Target.

Se crea el marco de trabajo. Para replicar el marco de trabajo en la instancia de publicación, utilice la opción Activar marco de trabajo de la barra de tareas.

Exportación de un fragmento de experiencia a Adobe Target

PRECAUCIÓN

Para los activos de medios, como las imágenes, solo se exporta una referencia a Target. El recurso en sí permanece almacenado en AEM Assets y se entrega desde la instancia de publicación de AEM.

Debido a esto, el fragmento de experiencia, con todos los activos relacionados, debe publicarse antes de exportarse a Target.

Para exportar un fragmento de experiencia de AEM a Target (después de especificar la Configuración de nube):

  1. Vaya a la consola Fragmento de experiencias.

  2. Seleccione el fragmento de experiencia que desea exportar a target.

    NOTA

    Debe ser una variación web del Fragmento de experiencia.

  3. Toque o haga clic en Exportar a Adobe Target.

    NOTA

    Si el fragmento de experiencia ya se ha exportado, seleccione Actualización del estado en Adobe Target.

  4. Toque o haga clic en Exportación sin publicación o Publicación según sea necesario.

    NOTA

    La selección de Publicación publicará de inmediato el fragmento de experiencia y lo enviará a Target.

  5. Toque o haga clic en Aceptar en el cuadro de diálogo de confirmación.

    El fragmento de experiencia debería estar en Target.

    NOTA

    Varios detalles de la exportación se pueden ver en Vista de lista de la consola y Propiedades.

    NOTA

    Al ver un fragmento de experiencia en Adobe Target, la fecha de última modificación en la que se ve es la fecha en la que se modificó por última vez el fragmento en AEM, no la fecha en la que se exportó por última vez a Adobe Target.

NOTA

También puede realizar la exportación desde el editor de páginas utilizando comandos comparables en el menú Información de la página.

Uso de los fragmentos de experiencias en Adobe Target

Después de realizar las tareas anteriores, el fragmento de experiencia se muestra en la página Ofertas de Target. Consulte la documentación específica de Target para aprender lo que se puede lograr allí.

NOTA

Al ver un fragmento de experiencia en Adobe Target, la fecha de última modificación en la que se ve es la fecha en la que se modificó por última vez el fragmento en AEM, no la fecha en la que se exportó por última vez a Adobe Target.

Eliminación de un fragmento de experiencia ya exportado a Adobe Target

La eliminación de un fragmento de experiencia que ya se ha exportado a Target puede causar problemas si el fragmento ya se está utilizando en una oferta de Target. Si se elimina el fragmento, la oferta quedaría inutilizable, ya que AEM está entregando el contenido del fragmento.

Para evitar estas situaciones, haga lo siguiente:

  • Si el fragmento de experiencia no se está utilizando en una actividad, AEM permite al usuario eliminar el fragmento sin un mensaje de advertencia.

  • Si una actividad de Target está utilizando actualmente el fragmento de experiencia, un mensaje de error advierte al usuario de AEM de las posibles consecuencias que tendrá la eliminación del fragmento en la actividad.

    El mensaje de error de AEM no impide que el usuario elimine (a la fuerza) el fragmento de experiencia. Si se elimina el fragmento de experiencia:

    • La oferta de Target con el fragmento de experiencia de AEM puede mostrar un comportamiento no deseado

      • Es probable que la oferta se siga procesando, ya que el HTML del fragmento de experiencia se insertó en Target
      • Puede que cualquier referencia en el fragmento de experiencia no funcione correctamente si también se eliminaron activos a los que se hace referencia en AEM.
    • Por supuesto, cualquier modificación adicional en el fragmento de experiencia es imposible, ya que el fragmento de experiencia ya no existe en AEM.

En esta página