Exportación de fragmentos de experiencias a Adobe Target exporting-experience-fragments-to-adobe-target
Puede exportar Fragmentos de experiencias, creados en Adobe Experience Manager AEM (), a 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 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. Esto se hace con Adobe Developer Console AEM, para lo cual se debe integrar con Adobe Target mediante IMS.
Requisitos previos prerequisites
Se requieren varias acciones:
-
AEM Tiene que integrar con Adobe Target mediante el uso de IMS.
note note NOTE Las integraciones de IMS ya están configuradas con S2S OAut. Las configuraciones anteriores se realizaron con credenciales de JWT que ahora están sujetas a desaprobación en Adobe Developer Console. -
AEM AEM Los fragmentos de experiencias se exportan desde la instancia de autor de la, por lo que debe Configurar el externalizador de vínculos de la instancia de autor para garantizar que todas las referencias dentro del fragmento de experiencias se externalicen para la entrega web.
note note NOTE 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 add-the-cloud-configuration
Antes de exportar un fragmento, debe agregar Configuración de nube para Adobe Target al fragmento o carpeta. Esto también le permite:
- especifique 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.
-
Vaya a la consola de fragmentos de experiencias.
-
Abra Propiedades de página para la carpeta o fragmento correspondiente.
note note NOTE 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. -
Seleccione la pestaña Cloud Services.
-
En Configuración de Cloud Service, seleccione Adobe Target en la lista desplegable.
note note NOTE El formato JSON de una oferta de fragmento de experiencia se puede personalizar. Para ello, defina un componente 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
note caution CAUTION El dominio externalizador es opcional. AEM Se configura un externalizador de fechas cuando desea que el contenido exportado apunte a un dominio publish específico. AEM Para obtener más información, consulte Configuración del externalizador de vínculos de. 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:
-
Guardar y cerrar.
Exportación de un fragmento de experiencia a Adobe Target exporting-an-experience-fragment-to-adobe-target
AEM Para exportar un fragmento de experiencia de Target a Target (después de especificar la Configuración de nube):
-
Vaya a la consola Fragmento de experiencias.
-
Seleccione el fragmento de experiencia que desea exportar a target.
note note NOTE Debe ser una variación web del Fragmento de experiencia. -
Haga clic en Exportar a Adobe Target.
note note NOTE Si el fragmento de experiencia ya se ha exportado, seleccione Actualización del estado en Adobe Target. -
Haga clic en Exportar sin publicar o Publish según sea necesario.
note note NOTE Al seleccionar Publish, se publica el fragmento de experiencia de inmediato y se envía a Target. -
Haga clic en Aceptar en el cuadro de diálogo de confirmación.
El fragmento de experiencia debería estar en Target.
note note NOTE Varios detalles de la exportación se pueden ver en Vista de lista de la consola y Propiedades. note note NOTE 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.
Uso de los fragmentos de experiencias en Adobe Target using-your-experience-fragments-in-adobe-target
Después de realizar las tareas anteriores, el fragmento de experiencia se muestra en la página Ofertas de Adobe Target. Consulte la documentación específica de Target para saber lo que puede lograr allí.
Eliminación de un fragmento de experiencia ya exportado a Adobe Target deleting-an-experience-fragment-already-exported-to-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 Adobe 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 Adobe Target AEM está utilizando el fragmento de experiencia, un mensaje de error advierte al usuario sobre 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.
-
AEM Es imposible realizar más modificaciones en el Fragmento de experiencia, ya que el Fragmento de experiencia ya no existe en la.
-
Eliminación de ClientLibs de fragmentos de experiencias exportados a Target removing-clientlibs-from-fragments-exported-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 del contenido del fragmento de experiencia. Esto es por diseño.
Cuando se utiliza una oferta de fragmento de experiencia con Adobe Target AEM en una página que está siendo entregada por, la página de destino ya contiene todas las bibliotecas de cliente necesarias. Además, el HTML superfluo en la oferta de Fragmento de experiencia tampoco es necesario (consulte Consideraciones).
El siguiente es un pseudoejemplo del html de una oferta de fragmento de experiencia:
<!DOCTYPE>
<html>
<head>
<title>…</title>
<!-- all the client libraries (css/js) -->
…
</head>
<body>
<!--/* Actual XF Offer content would appear here... */-->
</body>
</html>
AEM En un nivel superior, cuando se 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 podría tener el siguiente aspecto (aviso nocloudconfigs.atoffer):
- http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html
El selector nocloudconfigs se define mediante HTL y se puede superponer copiándolo de:
- /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html
El selector atoffer se aplica después del procesamiento mediante Sling Rewriter. Se puede utilizar para eliminar las bibliotecas de cliente.
Ejemplos example
Para este propósito, vamos a ilustrar cómo hacerlo con nocloudconfigs.
Superposiciones overlays
En este ejemplo en particular, las superposiciones que se están incluyendo quitarán las bibliotecas de cliente y el HTML prescindible. 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/ incluyen:
nocloudconfigs.htmlhead.nocloudconfigs.htmlbody.nocloudconfigs.html
Superposiciones de tipo de plantilla template-type-overlays
A los efectos de este ejemplo, vamos a utilizar la siguiente estructura:
El contenido de estos archivos es el siguiente:
-
body.nocloudconfigs.html
-
head.nocloudconfigs.html
-
nocloudconfigs.html
data-sly-unwrap para quitar la etiqueta body, necesita nocloudconfigs.html.Consideraciones considerations
AEM AEM Si necesita admitir sitios de y sitios que no sean de mediante Ofertas de fragmentos de experiencias en Adobe Target, debe crear dos fragmentos de experiencias (dos tipos de plantillas diferentes):
-
Uno con la superposición para eliminar clientlibs/html extra
-
Uno que no tenga la superposición y que, por lo tanto, incluya los clientlibs necesarios