Überlegungen und Fehlerbehebung aem-fragments-limitations

Auf dieser Seite: Lesen Sie wichtige Überlegungen und Schritte zur Fehlerbehebung bezüglich Adobe Experience Manager-Inhaltsfragmenten in Journey Optimizer, die Fragmenttypen, mehrsprachige Inhalte, Repository-Zugriff, Personalisierung und häufige Fehler behandeln.

Wichtige Aspekte considerations

Beachten Sie Folgendes bei der Verwendung von Inhaltsfragmenten aus Adobe Experience Manager in Journey Optimizer:

  • Inhaltsfragmenttypen

    • Einfache Inhaltsfragmente, verschachtelte Inhaltsfragmente und Inhaltsfragmentvarianten werden unterstützt. Wählen Sie die Variante aus, wenn Sie das Fragment in Journey Optimizer einfügen. Wenn Sie keine Variante auswählen, wird die Hauptvariante (der primäre Inhalt des Fragments in Adobe Experience Manager) verwendet.
  • Mehrsprachige Inhalte

    • Jede Variante muss in Adobe Experience Manager erstellt, getaggt und veröffentlicht werden. Wählen Sie in Journey Optimizer für jede Nachrichtensprache oder jedes Gebietsschema die entsprechende Fragmentvariante aus.
    • Es gibt keine automatische Sprachauflösung und kein Fallback zwischen Varianten.
  • Repository-Zugriff

    • Journey Optimizer lässt sich nur mit der Adobe Experience Manager Veröffentlichungsebene integrieren (Sites, Inhaltsfragmente). Inhaltsfragmente sind über einen öffentlichen, nicht authentifizierten Endpunkt verfügbar.
    • Autoren-Repositorys werden möglicherweise im Repository-Selektor angezeigt, aber in Journey Optimizer können nur in der Veröffentlichungsebene veröffentlichte Fragmente verwendet werden.
  • Inhaltsfragmentstatus

    • Fragmente können den Status Veröffentlicht oder Geändert aufweisen. Journey Optimizer verwendet immer die zuletzt veröffentlichte Version.
    • Nach der Veröffentlichung vorgenommene Änderungen werden erst in Journey Optimizer übernommen, wenn das Fragment erneut in Adobe Experience Manager veröffentlicht wird. Eine automatische Versionsabstimmung zwischen den beiden Produkten findet nicht statt.
  • Personalisierung

    • Unterstützt: Profilattribute, kontextuelle Attribute, statische Zeichenfolgen und vordeklarierte Variablen.
    • Nicht unterstützt: abgeleitete oder berechnete Attribute.
  • Aktualisierungen und Versionierung

    • Für Aktualisierungen ist eine manuelle Neuveröffentlichung durch Adobe Experience Manager erforderlich. Eine automatische Versionsabstimmung findet nicht statt.
    • Wenn ein Inhaltsfragment in Adobe Experience Manager veröffentlicht oder erneut veröffentlicht wird, aktualisiert Journey Optimizer dieses Fragment und lädt alle referenzierten Varianten dieses Fragments in aktiven Kampagnen oder Journey neu.
    • Die Veröffentlichungsaktion in Adobe Experience Manager kann verzögert werden. Nach Abschluss des Vorgangs erhält Journey Optimizer ein Ereignis und aktualisiert den Inhalt.
    • Nach einer erfolgreichen Aktualisierung sind Änderungen normalerweise innerhalb von etwa 5 Minuten für unitäre Journeys und im nächsten Batch für Batch-Anwendungsfälle verfügbar.
  • Zwischenspeicherung und Testversand

    • Wenn ein Fragment einer Kampagne oder Journey zum ersten Mal hinzugefügt wird, speichert Journey Optimizer es im Cache. Wenn Sie mit der Option AEM-Content-Beratung öffnen ein Fragment auswählen, das bereits an anderer Stelle verwendet wurde, wird es aus dem Cache von Journey Optimizer geladen.
    • Nachdem Sie ein geändertes Fragment in Adobe Experience Manager erneut veröffentlicht haben, überwacht Journey Optimizer das Ereignis und aktualisiert den Cache.
    • Ein Testversand spiegelt immer die zuletzt veröffentlichte Version wider. Für einen Testversand kann keine historische Version gesperrt werden.

Fehlerbehebung troubleshooting

Wenn beim Arbeiten mit Adobe Experience Manager-Inhaltsfragmenten in Journey Optimizer Probleme auftreten, lesen Sie die folgenden Informationen zu häufigen Problemen und Lösungen:

Problem
Ursache
Lösung
Tag nicht gefunden oder Inhaltsfragment nicht im Selektor sichtbar
Adobe Experience Manager-Tag-Syntax stimmt nicht mit dem erforderlichen Format ajo-enabled:{OrgId}/{SandboxName} überein
Prüfen Sie, ob die Tag-ID die richtige Organisations-ID und den richtigen Sandbox-Namen verwendet. Stellen Sie sicher, dass keine Leerzeichen oder falschen Trennzeichen vorhanden sind. Veröffentlichen Sie das Inhaltsfragment nach der Korrektur des Tags erneut.
Inhaltsfragment wird nicht in der Liste angezeigt
Inhaltsfragment befindet sich im Entwurfsstatus oder ist nicht veröffentlicht
In der Journey Optimizer-Auswahl werden nur genehmigte und veröffentlichte Inhaltsfragmente angezeigt. Veröffentlichen Sie das Inhaltsfragment in Adobe Experience Manager und stellen Sie sicher, dass es den Status „Veröffentlicht“ hat.
Undefinierter Variablenfehler
Personalisierungsplatzhalter nicht im Helper-Tag des Fragments deklariert
Fügen Sie alle erforderlichen Parameter zum Helper-Tag des Fragments hinzu. Jeder im Inhaltsfragment verwendete Platzhalter muss explizit mit der zugehörigen Zuordnung deklariert werden.
Testversand zeigt unerwartete Inhalte an
Für den Testversand wird die neueste veröffentlichte Version von Adobe Experience Manager verwendet
Ein Testversand spiegelt immer die neueste Veröffentlichung des Inhaltsfragments in Adobe Experience Manager wider. Wenn Sie kürzlich Änderungen in Adobe Experience Manager vorgenommen haben, veröffentlichen Sie das Inhaltsfragment erneut und aktualisieren Sie Ihren Testversand.
Zugriff verweigert (CPES-Fehler)
Benutzerrolle nicht zum Zugriff auf bestimmte Attribute berechtigt
Wenden Sie sich an Ihre Systemadministration, um sicherzustellen, dass Ihre Rolle über die entsprechenden Berechtigungen für die bei der Personalisierung verwendeten Profil- oder Kontextattribute verfügt.
Fragment zeigt leere oder fehlende Inhalte an
Fehlende erforderliche Personalisierungsparameter oder Fallback-Werte
Stellen Sie sicher, dass alle erforderlichen Parameter angegeben sind, und ziehen Sie in Erwägung, Fallback-Werte für optionale Attribute hinzuzufügen.
Bild wird nicht gerendert oder wird beschädigt angezeigt
Bild-URL im Inhaltsfragment ist ein relativer Pfad oder über den Kanal nicht erreichbar
Verwenden Sie absolute URLs (https://...) für Bildfelder. Relative Pfade aus Adobe Experience Manager werden nicht unterstützt. Bestätigen Sie die URL in einem Browser oder in der Nachrichtenvorschau.
Experience League-AEM-Link gibt 404 zurück
Veraltetes Lesezeichen, Vorschau-Build oder nicht veröffentlichte AEM-Hilfeseite
Öffnen Sie das Thema Inhaltsfragmente mit Adobe Journey Optimizer in der Live-Dokumentation zu Experience Manager und navigieren Sie über das Inhaltsverzeichnis auf der Seite oder suchen Sie nach dem Namen des Abschnitts (z. B. Dispatcher-Konfiguration).

Wenn das Problem weiterhin besteht, wenden Sie sich mit Informationen zu Ihrer Inhaltsfragment-ID, Ihrer Kampagnen- oder Journey-ID sowie den angezeigten Fehlermeldungen an den Adobe-Support.

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