Adobe Experience Manager コンテンツフラグメントの操作 aem-fragments

このページ:​バリエーションの操作やエクスペリエンス決定など、Journey Optimizer のキャンペーンとジャーニーで Adobe Experience Manager コンテンツフラグメントをタグ付け、追加、パーソナライズする方法について説明します。

Adobe Journey Optimizer ワークフローの既存の​ アセットセレクター ​および​ コンテンツフラグメントセレクター ​のエクスペリエンスは、コンテンツアドバイザー​に置き換えられています。 コンテンツアドバイザーは、AJO オーサリングワークフロー内で、Assets、コンテンツフラグメント、Dynamic Media を直接検索して選択するための、AI を活用した統合インターフェイスを提供します。 既存の統合は、移行期間中も引き続き機能します。

NOTE
AEM コンテンツフラグメント​は、Adobe Experience Manager で作成され、Journey Optimizer で使用されます。 これらは、以下とは異なります。
  • フラグメント - Journey Optimizer で作成され、キャンペーンやジャーニーをまたいでメール内で使用される、再利用可能なコンテンツコンポーネント。
  • ジャーニーフラグメント - ジャーニーに挿入されたジャーニーノードの再利用可能なセット。

Adobe Experience Manager と Journey Optimizer の統合は、次のデータフローに従います。

  1. Dispatcher を設定:Journey Optimizer が Content Fragment Management API を介して Adobe Experience Manager コンテンツフラグメントにアクセスできるようにするには、まず Dispatcher を設定する必要があります。 これは統合の前提条件です。

  2. 作成およびオーサー:コンテンツは、Adobe Experience Manager でコンテンツフラグメントとして作成および設定されます。

  3. タグ付け:コンテンツフラグメントには、Journey Optimizer 固有のタグ(ajo-enabled:{OrgId}/{SandboxName})をタグ付けする必要があります。

  4. 公開:コンテンツフラグメントは Adobe Experience Manager で公開され、Journey Optimizer で使用できるようになります。

  5. アクセス:Journey Optimizer は、Adobe Experience Manager パブリッシュインスタンスから使用可能なコンテンツフラグメントをリアルタイムで取得して表示します。

  6. 統合:コンテンツフラグメントが選択され、キャンペーンまたはジャーニーに統合されます。

コンテンツフラグメントが Adobe Experience Manager で公開されると、Journey Optimizer 側のコンテンツを更新するイベントが送信されます。 更新が正常に完了すると、単一ジャーニーの場合は約 5 分以内に、バッチユースケースの場合は次の処理バッチで使用可能になります。 更新が Journey Optimizer で使用可能になると、最新の公開済みコンテンツが、該当するすべてのキャンペーンとジャーニーをまたいで使用されます。

AVAILABILITY
ヘルスケアのお客様の場合、統合は Journey Optimizer Healthcare Shield および Adobe Experience Manager Extended Security for Healthcare アドオン製品のライセンスを取得した場合にのみ有効になります。

Experience Manager でのタグの作成と割り当て create-tag

IMPORTANT
Journey Optimizer が Content Fragment Management API を介して Adobe Experience Manager コンテンツフラグメントにアクセスできるようにするには、まず Dispatcher を設定する必要があります。

Journey Optimizer では、組織​と​ サンドボックス ​のタグが含まれている場合にのみ、コンテンツフラグメントセレクターにコンテンツフラグメントが表示されます。 この要件は意図的なものです。Journey Optimizer から無関係または未承認の Experience Manager コンテンツを保持します。

プレースホルダーの代わりに Journey Optimizer の組織 ID とサンドボックス名を使用して、ID が ajo-enabled:{AJO-OrgId}/{AJO-SandboxName} に続くタグを割り当てます(例:ajo-enabled:123A12A123A123A12A@AdobeOrg/prod)。

Experience Manager でタグを作成するには:

  1. ツールタグ付け​に移動します。

  2. ネストされたタグ構造を作成して、完全なタグ ID が上記の形式と一致するようにします。

    1. ルートレベルで、ajo-enabled という名前のフォルダーを作成します。

    2. ajo-enabled で、組織 ID のタグ(例:123A12A123A123A12A@AdobeOrg)を作成します。

    3. その組織タグの下に、サンドボックスのタグ(例:prod)を作成します。

    結合パスは、ajo-enabled:123A12A123A123A12A@AdobeOrg/prod などのタグ IDを生成します。

  3. コンテンツフラグメントに適用するには、エディターでコンテンツフラグメントを開きます。

  4. プロパティ​で、作成したタグを追加します。

  5. フラグメントを保存します。

➡️ Adobe Experience Platform ドキュメントでのタグの詳細情報

Experience Manager コンテンツフラグメントの追加 aem-add

AEM コンテンツフラグメントを作成およびパーソナライズした後、それを Journey Optimizer キャンペーンまたはジャーニーに読み込めるようになりました。

  1. キャンペーンまたはジャーニーを作成します。

  2. AEM コンテンツフラグメントにアクセスするには、任意のテキストフィールド内の パーソナライゼーションアイコン をクリックするか、HTML コンテンツコンポーネントを通じてソースコードを開きます。

  3. 左側のパネルの AEM コンテンツフラグメント​メニューで、「AEM コンテンツアドバイザーを開く」をクリックします。

  4. リストを参照し、Journey Optimizer コンテンツにインポートする​ コンテンツフラグメント ​を選択します。

    note
    NOTE
    フラグメントに 1 つ以上の​ 公開済み ​バリエーションがある場合、バリエーション​ドロップダウンがセレクターに表示されます。 バリエーション​が選択されていない場合、メイン​バリエーションが自動的に使用されます。 詳しくは、コンテンツフラグメントのバリエーションの操作を参照してください。
  5. フィルターを表示」をクリックして、コンテンツフラグメントリストを微調整します。

    デフォルトでは、コンテンツフラグメントフィルターは承認済みコンテンツのみを表示するようにプリセットされています。

  6. コンテンツフラグメント​を選択したら、「選択」をクリックして追加します。

  7. フラグメントを表示」をクリックして、フラグメント情報を表示します。 フラグメント情報​メニューを開くと、エディターは読み取り専用モードになります。

    Adobe Experience Manager でフラグメントを表示するには、右側のメニューから「プレビュー」を選択します。

  8. その他のアクションアイコン をクリックして、フラグメントの詳細メニューにアクセスします。

    • フラグメントをスワップ
    • 参照を探索
    • AEM で開く

  9. フラグメント​から目的のフィールドを選択して、コンテンツに追加します。

  10. コンテンツフラグメント属性に保存されている画像 URL(例:フラグメントモデルのパスまたは URL フィールド)を表示するには、HTMLに <img> タグとフラグメント属性をソースとして挿入します。例:

    code language-html
    <img src="[insert your AEM Content Fragment attribute here]">
    
    note
    NOTE
    Adobe Experience Manager の相対的な画像 URL はサポートされていません。絶対 URLを使用してください。
  11. ピル:オフ」を選択して、ピルのエクスペリエンスを有効にし、長い属性パスを非表示にして読みやすさを向上させます。

  12. Adobe Experience Manager で作成された​ パーソナライゼーションプレースホルダー ​をフラグメントテキスト内で使用するには、Adobe Experience Manager のコンテンツフラグメントで次のように定義します。{{name}}

    Journey Optimizer では、これらのトークンはプレースホルダーです。 ピル​のエクスペリエンスがオンになっている状態で、右側のパネルの「AEM コンテンツフラグメント」セクションにフラグメントフィールドと共に表示されます。

  13. リアルタイムのパーソナライゼーションを有効にするには、コンテンツフラグメント​内で使用されるすべてのプレースホルダーを、フラグメントヘルパータグ内のパラメーターとしてユーザーが明示的に宣言する必要があります。 次のように、これらのプレースホルダーをプロファイル属性、コンテキスト属性、静的文字列、事前定義済み変数にマッピングします。

    1. プロファイルまたはコンテキスト属性のマッピング:プレースホルダーをプロファイルまたはコンテキスト属性に割り当てます(例:name = profile.person.name.firstName)。

    2. 静的文字列マッピング:二重引用符で囲んで固定文字列値を割り当てます(例:name = “John”)。

    3. 変数マッピング:同じ HTML 内で以前に宣言された変数を参照します(例:name = ‘variableName’)。
      この場合、次の構文を使用して、フラグメント ID を追加する前に、variableName が宣言されていることを確認します。

      code language-html
      {% let variableName = attribute name %}
      

    次の例では、​プレースホルダーはフラグメント内の profile.person.birthDate 属性にマッピングされています。

    {modal="regular"}

  14. 保存」をクリックします。 メッセージのコンテンツをテストして確認するには、この節を参照してください。

    選択したコンテンツフラグメントは、このメッセージに対してアクティブなままになります。 別のフィールドまたはコンテンツブロックでパーソナライゼーションエディターを開くと、「AEM コンテンツフラグメント」セクションの同じフラグメントを引き続き操作し、AEM コンテンツアドバイザー​を再度開くことなく、さらにフィールドを追加できます。

テストを実行してコンテンツを検証したら、キャンペーンを送信したり、オーディエンスにジャーニーを公開したりできます。

Adobe Experience Manager を使用すると、コンテンツフラグメントが使用されている Journey Optimizer キャンペーンまたはジャーニーを識別できます。 詳しくは、Adobe Experience Manager ドキュメントを参照してください。

エクスペリエンス決定を含む AEM コンテンツフラグメントの使用 aem-decisioning

AVAILABILITY
この機能は、決定をサポートするチャネルで使用できます。

また、AEM コンテンツフラグメントは、エクスペリエンス決定​のオファー項目属性としても使用できます。 コンテンツフラグメントフィールドを決定項目属性にマッピングすることで、Journey Optimizer の決定モデル、数式、ランキング条件を使用して、各プロファイルに提供するフラグメントを最適化できます。

前提条件とガードレール

  • コンテンツフラグメントは、決定セレクターに表示される前に、Adobe Experience Manager で ajo-enabled:{OrgId}/{SandboxName} タグをタグ付けする必要があります。 タグの作成と割り当ての方法の詳細情報
  • 公開済み​状態のコンテンツフラグメントのみが使用できます。
  • 1 つの決定項目に最大 5 個の AEM コンテンツフラグメントを追加できます。

決定での AEM コンテンツフラグメントの活用

AEM コンテンツフラグメントを作成して公開したら、次の操作を実行する必要があります。

  1. 決定項目の属性で選択して、決定項目に関連付けます。
  2. 決定ポリシーに活用し、適切なコンテンツを適切な顧客に表示します。

➡️ AEM コンテンツフラグメントを決定項目に関連付ける

➡️ 決定ポリシーで AEM コンテンツフラグメントを活用する

コンテンツフラグメントのバリエーションの操作 aem-variations

Adobe Experience Manager では、各コンテンツフラグメントは次の項目で構成されています。

  • メイン:常に存在するフラグメントのコアコンテンツは削除できず、すべてのバリエーションの基礎となります。
  • バリエーション:オーサーが特定のチャネルまたはシナリオ用に作成する​ メイン ​の 1 つ以上の置換。 バリエーションはフラグメント内に存在し、個別のアセットとしてではなく、メイン​と比較して同期できます。

バリエーションユースケースの例:

  • プッシュ通知のコピーの短いバージョンとメールの長いバージョン。
  • 別のフラグメントを作成することなく、地域のトーンの調整。
  • チャネル固有のメッセージ(例:web とモバイルの比較)。

➡️ Adobe Experience Manager ドキュメントの詳細情報

Journey Optimizer では、フラグメントを挿入する際に使用するバリエーションを選択できるので、フラグメントを複製することなく、異なるキャンペーンやジャーニーで、Adobe Experience Manager の同じソースコンテンツの異なるレンディションに依存できます。

バリエーションを選択するには:

  1. キャンペーンまたはジャーニーを開きます。

  2. 任意のテキストフィールドで パーソナライゼーションアイコン をクリックするか、HTML コンテンツコンポーネントから HTML ソースを開きます。

  3. AEM コンテンツフラグメント​から、「AEM コンテンツアドバイザーを開く」をクリックします。

  4. テーブル表示でロケール固有の Adobe Experience Manager コンテンツフラグメントを選択するには、テーブルをカスタマイズ​を使用して​ 言語 ​列を追加します。 ロケール値がテーブルに表示され、適切なフラグメントを特定して選択できます。

  5. コンテンツフラグメント​を選択します。

  6. 情報アイコン をクリックして、詳細​メニューを開きます。 フラグメントに 1 つ以上の公開済みバリエーションがある場合、フラグメントの詳細の横に​ バリエーション ​ドロップダウンが表示されます。

  7. クイックの詳細​メニューから「参照を探索」をクリックすると、Adobe Experience Manager で、バリエーションの詳細、プレビューおよび(使用可能な場合は)本配信前確認に対する関連オプションが開きます。

  8. バリエーションを選択し、「選択」をクリックします。

    note
    NOTE
    バリエーションを選択しない場合や、バリエーションのサポートが使用可能になる前にフラグメントが追加された場合、Journey Optimizer は配信時に​ メイン ​バリエーションを自動的に使用します。

バリエーションを含むフラグメントを挿入した後、Adobe Experience Manager でフラグメントを再公開すると、アクティブなキャンペーンまたはジャーニー内の​ 参照バリエーション ​ごとに自動的に更新されます。 プレビューと本配信前確認では、選択したバリエーションと、そのバリエーションの最新の公開コンテンツが引き続き使用されます。

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 explains how to tag, add, and personalize Adobe Experience Manager Content Fragments in Journey Optimizer campaigns and journeys, how to work with variations, and how to use Content Fragments as offer item attributes in Experience Decisioning.

Intents:

  • Understand the Experience Manager to Journey Optimizer data flow (configure Dispatcher, create and author, tag, publish, access, integrate)
  • Create and assign the Journey Optimizer tag in Experience Manager so a Content Fragment appears in the selector
  • Add and personalize an AEM Content Fragment in a campaign or journey using the AEM Content Advisor
  • Declare placeholders as parameters and map them to profile attributes, contextual attributes, static strings, or variables
  • Use AEM Content Fragments as offer item attributes in Experience Decisioning
  • Choose and work with Content Fragment variations

Glossary:

  • AEM Content Advisor: AI-powered, unified interface for discovering and selecting Assets, Content Fragments, and Dynamic Media directly within AJO authoring workflows; replaces the existing Asset Selector and Content Fragment selector experiences (product-specific)
  • Main: The core content of a Content Fragment that always exists, cannot be deleted, and is the basis for all variations (product-specific)
  • Variations: One or more permutations of Main that authors create for specific channels or scenarios, living inside the fragment rather than as separate assets (product-specific)
  • Pills experience: An option that improves readability by hiding long attribute paths (product-specific)
  • ajo-enabled tag: Tag with the ID format ajo-enabled:{OrgId}/{SandboxName} that a Content Fragment must carry to appear in Journey Optimizer for your organization and sandbox (product-specific)

Guardrails:

  • Configuring the Dispatcher is a prerequisite for Journey Optimizer to access Content Fragments via the Content Fragment Management API.
  • A Content Fragment appears in the Content Fragment selector only when it carries a tag matching ajo-enabled:{AJO-OrgId}/{AJO-SandboxName} for your organization and sandbox.
  • When a Content Fragment is published in Experience Manager, if the update is successful it becomes available in Journey Optimizer within approximately 5 minutes for Unitary journeys, and in the next processing batch for batch use cases.
  • For Healthcare customers, the integration is enabled only upon licensing the Journey Optimizer Healthcare Shield and Adobe Experience Manager Extended Security for Healthcare add-on offerings.
  • Relative image URLs from Experience Manager are not supported; use absolute URLs.
  • All placeholders used within a Content Fragment must be explicitly declared by the user as parameters in the fragment helper tag.
  • In Experience Decisioning, only Content Fragments in a published state are available, they must be tagged with ajo-enabled:{OrgId}/{SandboxName}, and you can add up to five AEM Content Fragments to a single decision item.
  • Using AEM Content Fragments in Experience Decisioning is available for channels with Decisioning support.

Terminology:

  • Canonical name: AEM Content Fragments — Acronym: n/a — variants: Content Fragment, AEM content fragment
  • Synonyms: “AEM Content Advisor” = “Open AEM Content Advisor”
  • Do not confuse: “AEM Content Fragments” (authored in Experience Manager, used in Journey Optimizer) ≠ “Fragments” (reusable content components created in Journey Optimizer) ≠ “Journey Fragments” (reusable sets of journey nodes inserted into journeys)
  • Do not confuse: “Main” (core content, cannot be deleted) ≠ “Variations” (permutations of Main for specific channels or scenarios)

FAQ:

  • Q: Why does my Content Fragment not appear in Journey Optimizer? — It must be tagged in Experience Manager with a tag matching ajo-enabled:{OrgId}/{SandboxName} for your organization and sandbox, and the Dispatcher must be configured.
  • Q: What happens if I do not select a variation? — The Main variation is used automatically at delivery time.
  • Q: How many AEM Content Fragments can I add to a single decision item? — Up to five, and only Content Fragments in a published state are available.
  • Q: What happens when I republish a fragment used in active campaigns or journeys? — Republishing it in Experience Manager updates every referenced variation in active campaigns or journeys automatically.
  • Q: How do I enable real-time personalization in a fragment? — Declare all placeholders as parameters in the fragment helper tag and map them to profile attributes, contextual attributes, static strings, or predefined variables.
recommendation-more-help
journey-optimizer-help