考慮事項とトラブルシューティング aem-fragments-limitations

このページ: Journey Optimizer の Adobe Experience Manager コンテンツフラグメントに関する重要な考慮事項とトラブルシューティング手順について説明します。フラグメントタイプ、多言語コンテンツ、リポジトリアクセス、パーソナライズ、一般的なエラーについても説明します。

重要な考慮事項 considerations

Journey Optimizer で Adobe Experience Manager のコンテンツフラグメントを使用する際は、次の点に注意してください。

  • コンテンツフラグメントタイプ

    • シンプルなコンテンツフラグメント、ネストされたコンテンツフラグメント、コンテンツフラグメントのバリエーション​がサポートされています。 Journey Optimizer にフラグメントを挿入する際に、バリエーションを選択します。 バリエーションを選択しない場合、メイン​バリエーション(Adobe Experience Manager のフラグメントのプライマリコンテンツ)が使用されます。
  • 多言語コンテンツ

    • 各バリエーションは、Adobe Experience Manager で作成、タグ付け、公開する必要があります。 Journey Optimizer で、各メッセージ言語またはロケールに一致するフラグメントのバリエーションを選択します。
    • バリエーション間に自動の言語解決やフォールバックはありません。
  • リポジトリアクセス

    • Journey Optimizer は、Adobe Experience Manager パブリッシュ​層のみ(Sites、コンテンツフラグメント)と統合されます。 コンテンツフラグメントは、未認証の公開エンドポイントを通じて使用できます。
    • オーサーリポジトリはリポジトリセレクターに表示される場合がありますが、パブリッシュ​に公開されたフラグメントのみが Journey Optimizer で使用できます。
  • コンテンツフラグメントステータス

    • フラグメントでは、公開済み​または​ 変更済み ​のステータスを表示できます。Journey Optimizer では、常に​ 最新の公開済みバージョン ​が使用されます。
    • 公開後に行われた変更は、フラグメントが Adobe Experience Manager で再公開されるまで Journey Optimizer に反映されません。 2 つの製品間に自動バージョン紐付けはありません。
  • パーソナライゼーション

    • サポートされている:プロファイル属性、コンテキスト属性、静的文字列、事前定義済み変数。
    • サポートされていない:派生属性または計算属性。
  • 更新とバージョン管理

    • 更新するには、Adobe Experience Manager から手動で再公開する必要があります。 自動バージョン紐付けはありません。
    • コンテンツフラグメントが Adobe Experience Manager で公開または再公開されると、Journey Optimizer はそのフラグメントを更新し、アクティブなキャンペーンまたはジャーニーで​ 参照されているそのフラグメントのすべてのバリエーション ​を更新します。
    • Adobe Experience Manager パブリッシュアクションを遅延させることができます。 完了すると、Journey Optimizer はイベントを受信し、コンテンツを更新します。
    • 更新が正常に完了すると、通常、単一ジャーニーの場合は約 5 分以内​に、バッチユースケースの場合は​ 次のバッチ ​に変更を使用できます。
  • キャッシュと本配信前確認

    • フラグメントがキャンペーンまたはジャーニーに最初に追加されると、Journey Optimizer はキャッシュします。 AEM コンテンツアドバイザーを開く​を通じて既に他の場所で使用されているフラグメントを選択した場合、Journey Optimizer キャッシュから読み込まれます。
    • 変更されたフラグメントを Adobe Experience Manager で再公開すると、Journey Optimizer はイベントをリッスンし、キャッシュを更新します。
    • 本配信前確認は、常に​ 最後に公開された ​バージョンを反映します。本配信前確認用に履歴バージョンをロックできません。

トラブルシューティング troubleshooting

Journey Optimizer で Adobe Experience Manager コンテンツフラグメントを操作する際に問題が発生した場合は、次の一般的な問題と解決策を参照してください。

問題
原因
解決策
タグが見つかりません​または​コンテンツフラグメントがセレクターに表示されません
Adobe Experience Manager のタグ構文が、必須の形式 ajo-enabled:{OrgId}/{SandboxName} と一致していません。
タグ ID が正しい​組織 ID と​ サンドボックス名 ​を使用していることを検証します。 スペースや誤った区切り記号がないことを確認します。 タグを修正した後、コンテンツフラグメントを再公開します。
コンテンツフラグメントがリストに表示されません
コンテンツフラグメントがドラフト状態であるか、公開されていません
承認済みおよび公開されたコンテンツフラグメントのみが Journey Optimizer セレクターに表示されます。 Adobe Experience Manager でコンテンツフラグメントを公開し、公開済みステータスであることを確認します。
変数の未定義エラー
パーソナライゼーションプレースホルダーがフラグメントヘルパータグで宣言されていません
必須のすべてのパラメーターをフラグメントヘルパータグに追加します。 コンテンツフラグメントで使用される各プレースホルダーは、そのマッピングで明示的に宣言する必要があります。
本配信前確認に予期しないコンテンツが表示されます
本配信前確認は、Adobe Experience Manager から公開された最新バージョンを使用します
本配信前確認には、常に Adobe Experience Manager でのコンテンツフラグメントの最新の公開が反映されます。 Adobe Experience Manager で最近変更した場合は、フラグメントを再公開して本配信前確認を更新します。
アクセス拒否(CPES)エラー
ユーザーの役割に特定の属性へのアクセス権限がありません
システム管理者に連絡して、パーソナライゼーションで使用されるプロファイルまたはコンテキスト属性に対する適切な権限が役割に付与されていることを確認します。
フラグメントに空白または欠落しているコンテンツが表示されます
必須のパーソナライゼーションパラメーターまたはフォールバック値がありません
必須のすべてのパラメーターが指定されていることを確認し、オプションの属性にフォールバック値を追加することを検討します。
画像がレンダリングされないか、壊れているように見えます
コンテンツフラグメント内の画像 URL が相対パスであるか、チャネルから到達できません
画像フィールドに対して​絶対 URL(https://...)を使用します。 Adobe Experience Manager からの相対パスはサポートされていません。 ブラウザーまたはメッセージのプレビューで URL を確認します。
Experience League AEM リンクが 404 を返します
古いブックマーク、プレビュービルドまたは非公開の AEM ヘルプページ
Experience Manager の公開ドキュメントで Adobe Journey Optimizer でのコンテンツフラグメントのトピックを開き、ページ上の目次から移動するか、セクション名(例:Dispatcher 設定)を検索します。

問題が解決しない場合は、コンテンツフラグメント ID、キャンペーン ID またはジャーニー ID の詳細、表示されるエラーメッセージについて、アドビ担当者にお問い合わせください。

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