Consideraciones y resolución de problemas aem-fragments-limitations

En esta página: revise las consideraciones clave y los pasos de solución de problemas de los fragmentos de contenido de Adobe Experience Manager en Journey Optimizer, que abarcan los tipos de fragmentos, el contenido multilingüe, el acceso al repositorio, la personalización y los errores comunes.

Consideraciones clave considerations

Tenga en cuenta lo siguiente al utilizar fragmentos de contenido de Adobe Experience Manager en Journey Optimizer:

  • Tipos de fragmentos de contenido

    • Se admiten fragmentos de contenido simples, fragmentos de contenido anidados y variaciones de fragmentos de contenido. Elija la variación cuando inserte el fragmento en Journey Optimizer. Si no selecciona ninguna variación, se utilizará la variación Principal (el contenido principal del fragmento en Adobe Experience Manager).
  • Contenido multilingüe

    • Cada variación debe ser creada, etiquetada y publicada en Adobe Experience Manager. En Journey Optimizer, seleccione la variación del fragmento que coincida con cada idioma o configuración regional del mensaje.
    • No hay resolución automática de idioma ni alternativa entre las variaciones.
  • Acceso al repositorio

    • Journey Optimizer se integra con el nivel Adobe Experience Manager Publicar solamente (Sitios, Fragmentos de contenido). Los fragmentos de contenido están disponibles a través de un extremo público no autenticado.
    • Los repositorios de creación pueden aparecer en el selector de repositorios, pero solo los fragmentos publicados en Publish se pueden usar en Journey Optimizer.
  • Estado del fragmento de contenido

    • Los fragmentos pueden mostrar el estado Publicado o Modificado; Journey Optimizer siempre usa la última versión publicada.
    • Los cambios realizados después de la publicación no se reflejarán en Journey Optimizer hasta que el fragmento se vuelva a publicar en Adobe Experience Manager. No existe una conciliación automática de versiones entre los dos productos.
  • Personalización

    • Admitido: atributos de perfil, atributos contextuales, cadenas estáticas y variables predeclaradas.
    • No admitido: atributos derivados o calculados.
  • Actualizaciones y versiones

    • Las actualizaciones requieren la republicación manual de Adobe Experience Manager. No hay reconciliación automática de versiones.
    • Cuando se publica o vuelve a publicar un fragmento de contenido en Adobe Experience Manager, Journey Optimizer actualiza ese fragmento y todas las variaciones de ese fragmento a las que se hace referencia en campañas o recorridos activos.
    • La Adobe Experience Manager acción de publicación se puede retrasar. Una vez finalizado, Journey Optimizer recibe un evento y actualiza el contenido.
    • Después de una actualización correcta, los cambios suelen estar disponibles en unos 5 minutos para los recorridos unitarios y en el siguiente lote para los casos de uso por lotes.
  • Almacenamiento en caché y revisión

    • Cuando se agrega un fragmento por primera vez a una campaña o recorrido, Journey Optimizer lo almacena en caché. Si selecciona un fragmento que ya se utilizó en otra parte mediante Abrir el Asesor de contenido de AEM, se cargará desde la caché de Journey Optimizer.
    • Después de volver a publicar un fragmento modificado en Adobe Experience Manager, Journey Optimizer escucha el evento y actualiza la caché.
    • Las revisiones siempre reflejan la última versión publicada; no puede bloquear versiones históricas para revisiones.

Solución de problemas troubleshooting

Si tiene problemas al trabajar con fragmentos de contenido de Adobe Experience Manager en Journey Optimizer, consulte los siguientes problemas y resoluciones comunes:

Problema
Causa
Resolución
No se encontró la etiqueta o El fragmento de contenido no está visible en el selector
La sintaxis de etiquetas de Adobe Experience Manager no coincide con el formato requerido ajo-enabled:{OrgId}/{SandboxName}
Valide que el identificador de etiqueta use identificador de organización y nombre de espacio aislado correctos. Asegúrese de que no haya espacios ni separadores incorrectos. Vuelva a publicar el fragmento de contenido después de corregir la etiqueta.
El fragmento de contenido no aparece en la lista
El fragmento de contenido está en estado de borrador o no se ha publicado
En el selector de Journey Optimizer solo se muestran los fragmentos de contenido aprobados y publicados. Publique el fragmento de contenido en Adobe Experience Manager y asegúrese de que tiene el estado publicado.
Error variable sin definir
Marcador de posición de Personalization no declarado en la etiqueta de ayuda del fragmento
Añada todos los parámetros necesarios en la etiqueta de ayuda del fragmento. Cada marcador de posición utilizado en el fragmento de contenido debe declararse explícitamente con su asignación.
La prueba muestra contenido inesperado
La revisión utiliza la última versión publicada de Adobe Experience Manager
Las pruebas siempre reflejan la publicación más reciente del fragmento de contenido en Adobe Experience Manager. Si ha realizado cambios recientes en Adobe Experience Manager, vuelva a publicar el fragmento y actualice la revisión.
Error de acceso denegado (CPES)
Función de usuario no autorizada para acceder a determinados atributos
Póngase en contacto con el administrador del sistema para comprobar que su función tiene los permisos adecuados para el perfil o los atributos contextuales utilizados en la personalización.
El fragmento muestra contenido vacío o ausente
Faltan parámetros de personalización obligatorios o valores de reserva
Asegúrese de que se proporcionan todos los parámetros necesarios y considere la posibilidad de agregar valores de reserva para atributos opcionales.
La imagen no se representa o parece dañada
La URL de imagen en el fragmento de contenido es una ruta relativa o no accesible desde el canal
Use direcciones URL absolutas (https://...) para los campos de imagen. No se admiten rutas relativas de Adobe Experience Manager. Confirme la URL en un navegador o en la vista previa del mensaje.
El vínculo de Experience League AEM devuelve el valor 404
Marcador antiguo, versión de vista previa o página de ayuda de AEM sin publicar
Abra el tema Fragmentos de contenido con Adobe Journey Optimizer de la documentación activa de Experience Manager y navegue desde la tabla de contenido en la página o busque el nombre de la sección (por ejemplo Configuración de Dispatcher).

Si el problema persiste, póngase en contacto con su representante de Adobe con detalles sobre el ID del fragmento de contenido, el ID de campaña o recorrido y cualquier mensaje de error que se muestre.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page lists the key considerations and troubleshooting steps for Adobe Experience Manager Content Fragments in Journey Optimizer, covering fragment types, multilingual content, repository access, personalization, updates, caching, and common errors.

Intents:

  • Understand which Content Fragment types and variations are supported
  • Plan multilingual content when there is no automatic language fallback
  • Know that Journey Optimizer integrates with the Publish tier only
  • Identify which personalization inputs are supported
  • Understand update, versioning, caching, and proofing behavior
  • Diagnose common errors such as missing tags, undefined variables, and broken images

Glossary:

  • Content Fragment variation: An alternative version of a fragment selected when inserting it; if none is selected, the Main variation is used (product-specific)
  • Main variation: The fragment’s primary content in Adobe Experience Manager, used when no variation is selected (product-specific)
  • Publish tier: The Adobe Experience Manager tier Journey Optimizer integrates with, exposing Content Fragments through a public, unauthenticated endpoint (product-specific)
  • Access denied (CPES) error: An error indicating the user role is not authorized to access certain profile or contextual attributes used in personalization (product-specific)
  • Proof: A preview that always reflects the most recently published version of the Content Fragment (product-specific)

Guardrails:

  • Journey Optimizer integrates with the Adobe Experience Manager Publish tier only; Content Fragments are available through a public, unauthenticated endpoint. Author repositories may appear in the selector, but only fragments published to Publish can be used.
  • Personalization supports profile attributes, contextual attributes, static strings, and pre-declared variables; derived or computed attributes are not supported.
  • There is no automatic language resolution or fallback between variations; each variation must be authored, tagged, and published in Adobe Experience Manager.
  • Updates require manual republication from Adobe Experience Manager; there is no automatic version reconciliation.
  • After a successful update, changes are typically available within about 5 minutes for unitary journeys and in the next batch for batch use cases.
  • Proofs always reflect the most recently published version; you cannot lock a historical version for proofing.
  • Only approved and published Content Fragments are displayed in the Journey Optimizer selector.
  • The Adobe Experience Manager tag must use the format ajo-enabled:{OrgId}/{SandboxName} with the correct Organization ID and Sandbox Name and no spaces or incorrect separators.
  • Image fields must use absolute URLs (https://...); relative paths from Adobe Experience Manager are not supported.

Terminology:

  • Canonical name: Content Fragment — Acronym: n/a — variants: AEM Content Fragment, fragment
  • Synonyms: “Main” = “Main variation”
  • Do not confuse: “Published” (a Content Fragment status Journey Optimizer surfaces) ≠ “Modified” (a status Journey Optimizer also surfaces, still using the latest published version)

FAQ:

  • Q: Which Adobe Experience Manager tier does Journey Optimizer use for Content Fragments? — The Publish tier only; fragments are available through a public, unauthenticated endpoint, and only fragments published to Publish can be used.
  • Q: What personalization is not supported in Content Fragments? — Derived or computed attributes; supported inputs are profile attributes, contextual attributes, static strings, and pre-declared variables.
  • Q: How long after publishing are changes available? — Typically within about 5 minutes for unitary journeys and in the next batch for batch use cases, after manual republication in Adobe Experience Manager.
  • Q: Why is my Content Fragment not visible in the selector? — The tag syntax may not match ajo-enabled:{OrgId}/{SandboxName}, or the fragment may be in draft or unpublished state; correct the tag and republish, and ensure the fragment is approved and published.
  • Q: Why does an image in my Content Fragment not render? — The image URL may be a relative path; use absolute URLs (https://...), since relative paths from Adobe Experience Manager are not supported.
  • Q: Can I proof a specific historical version of a fragment? — No; proofs always reflect the most recently published version and you cannot lock a historical version for proofing.
recommendation-more-help
journey-optimizer-help