文件 Journey Optimizer Journey Optimizer 指南

在決策原則中善用片段 fragments

最後更新： 2026年5月5日

主題：
{"id":"a4cb03e1-327e-499d-9de8-e0c0db8a63a2"}

建立對象：

Experienced
{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

在此頁面上：在決定原則中運用Journey Optimizer內容片段和AEM內容片段，以便個人化並最佳化跨管道的內容決定傳送。

style

shade-box

決策專案支援兩種型別的片段內容，在決策原則內編寫訊息時可運用這些內容：

Journey Optimizer內容片段 — 在Journey Optimizer中建立且可重複使用的運算式片段，並新增至決定專案的片段區段。進一步瞭解AJO內容片段
AEM內容片段 — 在Adobe Experience Manager中撰寫的內容、對應至決定專案的屬性，以及透過索引鍵名稱在個人化編輯器中選取的內容。瞭解如何將AEM內容片段連結至決定專案

Journey Optimizer內容片段 ajo-fragments

如果您的決策原則包含決策專案，包括AJO內容片段，您可以在決策原則內的所有可用決策管道（程式碼型體驗、電子郵件、推播、簡訊和歷程）中製作訊息時，利用這些片段。

例如，假設您想針對多種行動裝置型號顯示不同的內容。將每個屬於不同電話型號的指定片段新增至您在決定原則中使用的決定專案。瞭解如何新增片段至決定專案。

決策專案的片段區段，顯示片段參考和位置索引鍵。 {width="70%"}

完成後，您可以使用下列其中一種方法：

直接插入代碼

只要將下方的程式碼區塊複製並貼到決定原則程式碼中即可。以片段ID取代variable，並以片段參考索引鍵取代placement：

code language-handlebars
`{% let variable = get(item._experience.decisioning.offeritem.contentReferencesMap, "placement").id %} {{fragment id = variable required=false}}`

遵循詳細步驟

導覽至協助程式函式，並將 Let 函式{% let variable = expression %} {{variable}}新增至程式碼窗格，您可以在其中宣告片段的變數。
使用Map > Get函式{%= get(map, string) %}來建置您的運算式。對應是決定專案中參照的片段。字串可以是您在決定專案中輸入的裝置模型，做為片段參考索引鍵。
您也可以使用包含此裝置型號ID的內容屬性。
新增您為片段選擇的變數作為片段ID。

將會從決定專案的片段區段中選取片段ID和參考索引鍵。

WARNING

如果片段索引鍵不正確或片段內容無效，轉譯可能會失敗並在Edge呼叫中導致錯誤。

為了避免片段暫時無法使用時失敗，請使用required=false標幟，以取代略過片段。進一步瞭解暫時無法使用的片段

使用情況和護欄 fragments-guardrails

以下護欄特別適用於決策專案中使用的AJO內容片段。

類比電子郵件中的內容和運算式片段

對於 電子郵件 頻道，當您 傳送校樣 或促銷活動啟動時，與決定專案相關聯的運算式片段會正確顯示。但是，模擬內容不會顯示決定專案中的運算式片段。

電子郵件中的視覺片段和決定專案

您無法將 視覺化片段 指派給決定專案，此內容中僅支援運算式片段。

決定專案與內容屬性

Journey Optimizer片段預設不支援決定專案屬性和內容屬性。不過，您可以改用全域變數，如下所述。

假設您要在片段中使用 sport 變數。

在片段中參照此變數，例如：

code language-text
`Elevate your practice with new {{sport}} gear!`

在決定原則區塊中使用 Let 函式定義變數。在下列範例中，sport是以決定專案屬性定義：

code language-handlebars

{#each decisionPolicy.13e1d23d-b8a7-4f71-a32e-d833c51361e0.items as |item|}}
{% let sport = item._cjmstage.value %}
{{fragment id = get(item._experience.decisioning.offeritem.contentReferencesMap, "placement1").id }}
{{/each}}

決定專案片段內容驗證

由於這些片段的動態性質，當用於行銷活動時，會針對決策專案中所參考的片段略過行銷活動內容建立期間的訊息驗證。
片段內容的驗證僅在片段建立和發佈期間進行。
對於JSON型別運算式片段，在儲存片段時會語法驗證內容。驗證錯誤會顯示為警示。

在執行階段，會驗證行銷活動內容（包括決策專案中的片段內容）。萬一驗證失敗，行銷活動將不會呈現。

暫時無法使用的片段已略過{#temporary-unavailable-fragments}

當歷程或行銷活動參考附加到決策專案的片段時，可能會有短暫的同步延遲，更新的片段才能在Edge上使用。

為避免片段暫時不可用時失敗，片段現在會將required標幟預設為false，以便略過這些標幟，而非導致歷程或行銷活動失敗。

這表示如果片段在Edge上暫時無法使用，則會忽略該片段。如果片段可用，則會正常轉譯。

範例

如果您的決策原則符合兩個優惠方案的資格，且每個方案都有片段 — 例如「20%優惠」和「30%優惠」 — 而第二個片段暫時無法使用，因為required=false系統會呈現可用的優惠方案（20%優惠）並略過另一個片段（30%優惠），而不是讓歷程或行銷活動失敗。如此可改善內容仍在同步處理時的可靠性。

NOTE

您仍然可以將required標幟設定為true，將片段標示為必要。但是，如果片段暫時遺失，可能會導致歷程或行銷活動轉譯失敗。

AEM內容片段 aem-fragments-decisioning

AVAILABILITY

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

在決定原則中運用AEM內容片段之前，請確定您具備：

已在Adobe Experience Manager中建立您的內容片段，並以ajo-enabled:{OrgId}/{SandboxName}標籤，以便可供Journey Optimizer探索。瞭解如何建立和指派標籤
透過指派唯一的參考名稱，將片段繫結至選件專案的 AEM片段 區段。瞭解如何將AEM內容片段連結至決定專案

在個人化編輯器中，與原則選取的決策專案相關聯的所有AEM內容片段都可供使用。每個片段索引鍵名稱都會顯示一個資料夾。

➡️ 探索如何在影片中搭配Journey Optimizer Decisioning使用AEM內容片段

在此範例中，決定原則包含兩個決定專案，這些決定專案有AEM片段透過其參考名稱繫結至它們。

Personalization編輯器在決定原則中顯示每個片段索引鍵名稱可用的AEM內容片段。

按一下+按鈕，將所需的片段新增至運算式中。

由於單一參考名稱可能具有多個跨不同優惠方案專案繫結至它的片段，Decisioning會根據決定原則的排名條件決定要提供給每個客戶的最佳片段。
選取片段後，您可以利用其屬性（例如影像URL、文字欄位或其他內容），並使用「決策」在適當的時間將適當的內容呈現給適當的客戶。
在啟用您的行銷活動或歷程之前，請使用任一模擬方法來預覽AEM內容片段欄位值將如何呈現。進一步瞭解模擬內容

跨頻道使用AEM內容片段 aem-fragments-channels

如何從決定原則插入AEM內容片段屬性，取決於您使用的管道。

電子郵件

若要使用決定原則將AEM內容片段屬性插入電子郵件：

在電子郵件Designer中開啟您的電子郵件草稿，然後按一下右側邊欄中的決策圖示以開啟決策原則面板。
選取您組裝的選取策略，並指定位置以定義將填入優惠方案的電子郵件區域。
按一下 + 圖示，然後從AEM內容片段中選取應在該區域中呈現的特定欄位，例如主圖影像URL欄位。
發佈之前，請按一下 模擬內容 以預覽結果，並驗證最高優先順序的選件及其內容片段是否如測試設定檔所預期般轉譯。

程式碼型體驗(JSON)

建置JSON型程式碼型體驗時，使用以下結構從決定原則轉譯AEM內容片段屬性。

code language-handlebars

[
{{#each decisionPolicy.YOUR_POLICY_ID.items as |item|}}
{% let frag = get(item._experience.decisioning.offeritem.aemContentReferencesMap, "YOUR_REFERENCE_KEY").id %}
{{fragment id = frag result='YOUR_REFERENCE_KEY' required=false}}
{
  "fieldName": "{{{YOUR_REFERENCE_KEY.fieldName}}}"
},
{{/each}}
]

note
NOTE
AEM內容片段使用`aemContentReferencesMap`透過參考索引鍵查詢片段。這與用於Journey Optimizer內容片段的`contentReferencesMap`不同。

建置JSON裝載時，請記得下列事項：

將JSON陣列括弧[與]放在#each回圈的外部。
對JSON字串內的欄位值使用三大括弧 {{{ }}}可防止HTML逸出特殊字元，並確保有效的JSON輸出。
result='YOUR_REFERENCE_KEY'引數會擷取該名稱下的已解析片段內容，以便您可以使用YOUR_REFERENCE_KEY.fieldName參考其欄位。

程式碼型體驗編輯器顯示從JSON的決定原則轉譯的AEM內容片段屬性。

程式碼型體驗(HTML)

對於以HTML為基礎的程式碼體驗，請使用標準雙大括弧來轉譯欄位：

code language-handlebars

{{#each decisionPolicy.YOUR_POLICY_ID.items as |item|}}
{% let frag = get(item._experience.decisioning.offeritem.aemContentReferencesMap, "YOUR_REFERENCE_KEY").id %}
{{fragment id = frag result='YOUR_REFERENCE_KEY' required=false}}
<div>{{YOUR_REFERENCE_KEY.fieldName}}</div>
{{/each}}