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 los niveles Adobe Experience Manager Autor y Publicar (Sitios, Fragmentos de contenido). Más información
    • Solo se pueden usar fragmentos con el estado Publicado o Modificado 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 (AJOCBS-1103)
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 no autorizado al recuperar un fragmento (AJOCBS-1101, CJMMAS-8101)
Se rechazó la conexión con Adobe Experience Manager: el token es incorrecto, ha caducado o no es válido
Compruebe la configuración y las credenciales del repositorio de Adobe Experience Manager. Más información
Error prohibido al recuperar un fragmento (AJOCBS-1102, CJMMAS-8102)
No tiene permiso sobre el fragmento o su repositorio
Solicite a su administrador acceso al fragmento y a su repositorio.
Tiempo de espera o solicitud incorrecta al recuperar un fragmento (AJOCBS-1105, AJOCBS-1108)
La solicitud a Adobe Experience Manager agotó el tiempo de espera o se rechazó
Compruebe que el fragmento esté publicado e inténtelo de nuevo.
Error al publicar el fragmento o la publicación no se completó a tiempo (CJMMAS-1161, CJMMAS-1162, CJMMAS-1175)
La publicación de un fragmento utilizado en la campaña o el recorrido falló o tardó demasiado
Vuelva a publicar el fragmento en Adobe Experience Manager, espere a que se sincronice e inténtelo de nuevo.
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 Author and Publish tiers
  • 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 where published Content Fragments are exposed 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 Author and Publish tiers (Sites, Content Fragments). Only fragments in Published or Modified status 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 Author and Publish tiers; only fragments in Published or Modified status can be used.
  • Q: Which errors can occur when Journey Optimizer fetches or publishes an Adobe Experience Manager fragment? — Unauthorized (AJOCBS-1101, CJMMAS-8101), forbidden (AJOCBS-1102, CJMMAS-8102), not found (AJOCBS-1103), timeout or bad request (AJOCBS-1105, AJOCBS-1108), and fragment publication failures (CJMMAS-1161, 1162, 1175); the troubleshooting table gives the resolution of each.
  • 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.

Personas:

  • marketer: Can insert Simple, nested, or variation Content Fragments in Journey Optimizer, and the Main variation is used when none is selected. Can personalize fragments using profile attributes, contextual attributes, static strings, and pre-declared variables. The page states that derived or computed attributes are not supported. Where: “Key considerations”.

Onboarding:

  • Level: Beginner
  • First minimal step: Choose the variation when you insert the fragment in Journey Optimizer.
  • Success check: After a successful update, changes are typically available within about 5 minutes for unitary journeys and in the next batch for batch use cases.
  • Previous: Journey Optimizer integrates with the Adobe Experience Manager Author and Publish tiers: AEM Content Fragments (integrations/aem-fragments-gs.md)
  • Next: Check the Adobe Experience Manager repository configuration and credentials: Configure AEM Repository Settings (integrations/aem-admin-settings.md)
recommendation-more-help
journey-optimizer-help