Exportación de fragmentos de experiencias a Adobe Target

PRECAUCIÓN

Algunas funciones de esta página requieren la aplicación de AEM 6.5.3.0 (o posterior).

6.5.3.0:

  • Dominios externalizadores ahora se puede seleccionar.
    Nota: 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.

6.5.2.0:

  • Los fragmentos de experiencias se pueden exportar a:

    • el espacio de trabajo predeterminado.
    • un espacio de trabajo con nombre, especificado en Cloud Configuration.
    • Nota: La exportación a espacios de trabajo específicos requiere Adobe Target Premium.
  • AEM debe integrado con Adobe Target mediante IMS.

AEM 6.5.0.0 y 6.5.1.0:

  • 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, creado en Adobe Experience Manager (AEM), en Adobe Target (Target). Luego pueden utilizarse como ofertas en actividades de Target para probar y personalizar experiencias a escala.

Hay tres opciones de formato 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

AEM 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. Esto se realiza mediante la consola de Adobe Developer, para la cual AEM debe integrado con Adobe Target mediante IMS.

NOTA

Los espacios de trabajo de Adobe Target no existen en Adobe Target. Se definen y administran en Adobe IMS (Identity Management System) y, a continuación, se seleccionan para su uso en todas las soluciones mediante integraciones de 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

PRECAUCIÓN

Algunas funciones de esta página requieren la aplicación de AEM 6.5.3.0.

Se requieren varias acciones:

  1. Tiene que integrar AEM con Adobe Target mediante IMS.

  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

    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
  5. Guardar y cerrar.

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.

Eliminación de bibliotecas de cliente de fragmentos de experiencias exportados a Target

Los fragmentos de experiencias contienen etiquetas html completas y todas las bibliotecas de cliente (CSS/JS) necesarias para procesar el fragmento exactamente como lo creó el autor de contenido del fragmento de experiencia. Esto es diseño secundario.

Cuando se utiliza una oferta de fragmento de experiencia con Adobe Target en una página que AEM está enviando, la página de destino ya contiene todas las bibliotecas de cliente necesarias. Además, tampoco es necesario el html superfluo de la oferta de fragmentos de experiencias (consulte Consideraciones).

El siguiente es un seudoejemplo del html en una oferta de fragmento de experiencia:

<!DOCTYPE>
<html>
   <head>
      <title>…</title>
      <!-- all of the client libraries (css/js) -->
      …
   </head>
   <body>
        <!--/* Actual XF Offer content would appear here... */-->
   </body>
</html>

En un nivel superior, cuando AEM exporta un fragmento de experiencia a Adobe Target, lo hace utilizando varios selectores de Sling adicionales. Por ejemplo, la dirección URL del fragmento de experiencia exportado puede tener el siguiente aspecto (observe que nocloudconfigs.atoffer):

  • http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html

La variable nocloudconfigs se define mediante HTL y se puede superponer copiándolo de:

  • /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html

La variable atoffer el selector se aplica después del procesamiento mediante Reescritura de Sling. Puede utilizarse para eliminar las bibliotecas de cliente.

Ejemplo

A tal efecto, ilustraremos cómo hacerlo con nocloudconfigs.

NOTA

Consulte Plantillas editables para obtener más información.

Superposiciones

En este ejemplo particular, la variable superposiciones si se incluye, se quitarán las bibliotecas de cliente y el html superfluo. Se da por hecho que ya ha creado el tipo de plantilla de fragmento de experiencia. Los archivos necesarios que deben copiarse de /libs/cq/experience-fragments/components/xfpage/ incluir:

  • nocloudconfigs.html
  • head.nocloudconfigs.html
  • body.nocloudconfigs.html

Superposiciones de tipo plantilla

Para este ejemplo se utiliza la siguiente estructura:

Superposiciones de tipo plantilla

El contenido de estos archivos es el siguiente:

  • body.nocloudconfigs.html

    body.nocloudconfigs.html
  • head.nocloudconfigs.html

    head.nocloudconfigs.html
  • nocloudconfigs.html

    nocloudconfigs.html
NOTA

Para usar data-sly-unwrap para quitar la etiqueta de cuerpo que necesita nocloudconfigs.html.

Consideraciones

Si necesita admitir sitios AEM y sitios que no sean de AEM que utilicen Ofertas de fragmentos de experiencia en Adobe Target, deberá crear dos fragmentos de experiencias (dos tipos de plantillas diferentes):

  • Uno con la superposición para eliminar clientlibs/html extra

  • Uno que no tiene la superposición y, por lo tanto, incluye el clientlibs requerido

En esta página