文件Journey OptimizerJourney Optimizer 指南

使用Adobe Experience Manager內容片段 aem-fragments

最後更新： 2026年9月13日

建立對象：

  • 初級
  • 使用者

在此頁面上：​瞭解如何在Journey Optimizer行銷活動和歷程中標籤、新增及個人化Adobe Experience Manager內容片段，包括使用變數和體驗決策。

style
shade-box

Adobe Journey Optimizer工作流程中的現有​ 資產選擇器 ​和​ 內容片段選擇器 ​體驗正在由​ 內容顧問 ​取代。 內容警告器提供AI支援的統一介面，以便直接在AJO編寫工作流程中探索和選取Assets、內容片段和Dynamic Media。 在轉換期間，現有的整合功能可繼續運作。

style
shade-box
NOTE
AEM內容片段​是在Adobe Experience Manager中編寫並在Journey Optimizer中使用。 它們與以下不同：
  • 片段 — 在Journey Optimizer中建立並用於跨行銷活動和歷程之電子郵件中的可重複使用內容元件。
  • 歷程片段 — 可重複使用的歷程節點集合已插入歷程中。

Adobe Experience Manager與Journey Optimizer之間的整合會遵循以下資料流程：

  1. 設定Dispatcher：若要讓Journey Optimizer能透過內容片段管理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能夠透過內容片段管理API存取Adobe Experience Manager內容片段，您必須先設定Dispatcher。

Journey Optimizer只有在包含您​ 組織 ​和​ 沙箱 ​的標籤時，才會在「內容片段」選擇器中顯示「內容片段」。 此要求是刻意為之：會將不相關或未經核准的Experience Manager內容擋在Journey Optimizer之外。

使用您的Journey Optimizer組織ID和沙箱名稱來指派識別碼接在ajo-enabled:{AJO-OrgId}/{AJO-SandboxName}之後的標籤，以取代預留位置，例如ajo-enabled:123A12A123A123A12A@AdobeOrg/prod。

若要在Experience Manager中建立標籤：

  1. 移至​工具 > 標籤。

  2. 建立巢狀標籤結構，讓完整標籤ID符合上述格式：

    1. 在根層級，建立名為ajo-enabled的資料夾。

    2. 在ajo-enabled底下，為您的組織識別碼建立標籤，例如123A12A123A123A12A@AdobeOrg。

    3. 在該組織標籤下，為您的沙箱建立標籤，例如，prod。

    合併的路徑會產生標籤ID，例如ajo-enabled:123A12A123A123A12A@AdobeOrg/prod。

  3. 若要將其套用至內容片段，請在編輯器中開啟內容片段。

  4. 在​ 屬性 ​中，新增您建立的標籤。

  5. 儲存片段。

➡️ 在Adobe Experience Manager檔案中進一步瞭解標籤

新增Experience Manager內容片段 aem-add

建立並個人化AEM內容片段後，您現在可以將其匯入您的Journey Optimizer行銷活動或歷程。

  1. 建立您的行銷活動或歷程。

  2. 若要存取您的AEM內容片段，請按一下任何文字欄位中的 Personalization圖示 ，或透過HTML內容元件開啟原始程式碼。

  3. 從左窗格中的​ AEM內容片段 ​功能表，按一下​開啟AEM內容警告器。

  4. 瀏覽清單並選取​內容片段，以匯入您的Journey Optimizer內容。

    note
    NOTE
    如果片段有一或多個​ 已發佈 ​個變數，則選擇器中會出現​ 變數 ​下拉式清單。 如果未選取任何​變數，則會自動使用​ 主要 ​變數。 在使用內容片段變數中瞭解更多。

  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. 選取​Picks： Off，以透過隱藏長屬性路徑來啟用Picks體驗以改善可讀性。

  12. 若要在片段文字中使用在Adobe Experience Manager中編寫的​個人化預留位置，請在Adobe Experience Manager的內容片段中定義如下： {{name}}。

    在Journey Optimizer中，這些代號為預留位置。 在​ Pills ​體驗開啟的情況下，它們會出現在右側邊欄的​ AEM內容片段 ​區段中，旁邊是片段欄位。

  13. 若要啟用即時個人化，內容片段​中使用的所有預留位置，必須由使用者明確宣告為片段協助程式標籤中的引數。 將這些預留位置對應至設定檔屬性、內容屬性、靜態字串或預先定義的變數，如下所示：

    1. 設定檔或內容屬性對應：將預留位置指派給設定檔或內容屬性，例如name = profile.person.name.firstName。

    2. 靜態字串對應：將固定字串值放在雙引號中，例如名稱= “John”，以指派固定字串值。

    3. 變數對應：參照同一HTML中先前宣告的變數，例如name = ‘variableName’。
      在此情況下，請確保在新增片段ID之前使用以下語法宣告​variableName：

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

    在以下範例中，month​預留位置對應至片段中的​ profile.person.birthDate ​屬性。

    {modal="regular"}

  14. 按一下​「儲存」。 您現在可以測試並檢查您的訊息內容，如本節所詳述。

    請注意，您選取的內容片段在此訊息中會維持作用中。 當您在其他欄位或內容區塊中開啟Personalization編輯器時，您可以繼續使用​ AEM內容片段 ​區段的相同片段，並新增更多欄位，而不需要重新開啟​開啟AEM內容警告器。

執行測試並驗證內容後，您可以傳送行銷活動或發佈您的歷程給您的對象。

Adobe Experience Manager可讓您識別使用內容片段的Journey Optimizer行銷活動或歷程。 進一步瞭解Adobe Experience Manager檔案。

透過Experience Decisioning使用AEM內容片段 aem-decisioning

AVAILABILITY
此功能適用於支援決策的管道。

AEM內容片段也可在​ 體驗決策 ​中作為選件專案屬性使用。 透過將內容片段欄位對應到決定專案屬性，您可以使用Journey Optimizer決定模型、公式和排名條件來最佳化為每個設定檔提供哪些片段。

先決條件和護欄

  • 內容片段必須先在Adobe Experience Manager中使用ajo-enabled:{OrgId}/{SandboxName}標籤進行標籤，才會在決策選擇器中顯示。 瞭解如何建立和指派標籤
  • 只有​ 已發佈 ​狀態的內容片段才可使用。
  • 您最多可以新增​ 5個 ​個AEM內容片段至單一決定專案。

在Decisioning中利用AEM內容片段

建立及發佈AEM內容片段後，您需要：

  1. 在決策專案的屬性中選取決策專案，將其連結至決策專案。
  2. 在決定政策中善用它，將適當的內容呈現給適當的客戶。

➡️ 將AEM內容片段繫結至決定專案

➡️ 在決定原則中利用AEM內容片段

使用內容片段變數 aem-variations

在Adobe Experience Manager中，每個內容片段都由下列專案組成：

  • 主要：片段的核心內容永遠存在、無法刪除，且是所有變數的基礎。
  • 變數：作者為特定管道或情境建立的一或多個​ 主要 ​排列。 片段中的變數不是以個別資產形式存在，而且可以與​ 主要 ​進行比較和同步。

變數使用案例的範例：

  • 推播通知的短版復本，以及電子郵件的較新版本。
  • 區域色調調整，而不建立單獨的片段。
  • 通道特定訊息（例如網頁與行動裝置的比較）。

➡️ 在Adobe Experience Manager檔案中進一步瞭解

Journey Optimizer可讓您選擇在插入片段時使用的變數，如此一來，在Adobe Experience Manager中，不同的促銷活動或歷程可依賴相同來源內容的不同轉譯，而不會復製片段。

若要選取變數，請執行下列步驟：

  1. 開啟行銷活動或歷程。

  2. 在任何文字欄位中按一下 Personalization圖示 ，或從HTML內容元件開啟HTML來源。

  3. 從​AEM內容片段，按一下​開啟AEM內容警告器。

  4. 若要在表格檢視中選取地區設定特定的Adobe Experience Manager內容片段，請使用​ 自訂表格 ​新增​ 語言 ​欄。 地區設定值會顯示在表格中，讓您識別和選取適當的片段。

  5. 選取您的​內容片段。

  6. 按一下 資訊圖示 以開啟​ 詳細資料 ​功能表。 如果片段有一或多個已發佈的變數，則片段詳細資料旁會出現​ 變數 ​下拉式清單。

  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