文件 Journey Optimizer Journey Optimizer 指南

利用運算式片段 use-expression-fragments

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
個人化

建立對象：

中繼
開發人員

使用 個人化編輯器 時，您可以利用所有已建立或已儲存至目前沙箱的運算式片段。

片段是可重複使用的元件，可跨Journey Optimizer個行銷活動和歷程參照。此功能允許預先建置多個自訂內容區塊，可供行銷使用者在改良的設計流程中快速組合內容。進一步瞭解片段

➡️ 在此影片中瞭解如何管理、編寫和使用片段

使用運算式片段 use-expression-fragment

若要將運算式片段新增至您的內容，請遵循下列步驟。

NOTE

您最多可以在給定傳送中新增30個片段。片段最多只能巢狀1個層級。

開啟個人化編輯器並在左窗格上選取片段按鈕。

清單會顯示目前沙箱上已建立或儲存為片段的所有運算式片段。瞭解如何建立片段
它們會依建立日期排序：最近新增的運算式片段會先顯示在清單中。

您也可以重新整理此清單。

note note
NOTE
如果您在編輯內容時修改或新增了某些片段，清單會以最新變更更新。

按一下運算式片段旁的+圖示，將對應的片段ID插入編輯器中。

note caution
CAUTION
您可以將任何草稿或即時片段新增至您的內容。但是，如果歷程或行銷活動中使用了具有草稿狀態的片段，則您將無法啟用該歷程或行銷活動。在歷程或行銷活動發佈中，草稿片段將顯示錯誤，您需要核准它們才能發佈。

在新增片段ID後，如果您開啟對應的運算式片段並從介面編輯它，變更便會同步。它們會自動傳播到包含該片段ID的所有草稿或即時歷程/行銷活動。
按一下片段旁的 更多動作 按鈕。從開啟的關聯功能表中，選取 檢視片段 以取得有關該片段的詳細資訊。也會顯示片段ID，可從此處複製。
您可以在另一個視窗中開啟運算式片段，以編輯其內容和屬性 — 使用內容功能表中的 開啟片段 選項或從 片段資訊 窗格。瞭解如何編輯片段
然後您就可以照常使用個人化編輯器的所有個人化和編寫功能，自訂及驗證您的內容。

某些情況下，您只需要計算變數，因此您可能想要隱藏運算式片段的內容。若要這麼做，請使用render屬性並將其設定為false。例如：

code language-none
`Hi {{profile.person.name.firstName\|fragment id='ajo:fragmentId/variantId' mode ='inline' render=false}}`

NOTE

如果您建立包含多個分行符號的運算式片段，並將其用於簡訊或推播內容，則會保留分行符號。因此，在傳送您的簡訊或推播訊息之前，請務必先測試該訊息。

使用隱含變數 implicit-variables

隱含變數可增強現有片段功能，以提升內容重複使用性及指令碼使用案例的效率。片段可以使用輸入變數並建立可用於行銷活動和歷程內容的輸出變數。

例如，此功能可用於根據目前的行銷活動或歷程，初始化電子郵件的追蹤引數，並將這些引數用於新增至電子郵件內容的個人化連結。

可以使用的使用案例如下：

在片段中使用輸入變數。

當片段用於行銷活動/歷程動作內容時，它有能力運用在片段外部宣告的變數。範例如下：

我們可以看見以上在行銷活動內容中宣告utm_content變數。使用片段 Hero區塊 時，將顯示要附加utm_content引數值的連結。最終結果為： https://luma.enablementadobe.com?utm_campaign= Product_launch&utm_content= start_shopping。
使用來自片段的輸出變數。

在片段中計算或定義的變數可用於您的內容。在以下範例中，片段 F1 宣告了一組變數：

在電子郵件內容中，您可以進行下列個人化：

片段F1初始化下列變數： utm_campaign和utm_content。然後，訊息內容中的連結會附加這些引數。最終結果為： https://luma.enablementadobe.com?utm_campaign= Product_launch&utm_content= start_shopping。

NOTE

在執行階段，系統會展開片段內的內容，然後從上到下解譯個人化程式碼。請記住，完成更複雜的使用案例。例如，您可以有片段F1將變數傳遞至下方的另一個片段F2。您也可以讓視覺化片段F1將變數傳遞至巢狀運算式片段F2。

在回圈中使用運算式片段 fragments-in-loops

在{{#each}}回圈中使用運算式片段時，請務必瞭解變數範圍的運作方式。運算式片段可以存取訊息內容中定義的全域變數，但是這些片段無法接收回圈特定的變數做為引數。

支援的模式：使用全域變數 global-variables-in-loops

運算式片段可參考在片段外部定義的全域變數，即使從回圈內呼叫片段亦然。當您需要使用反複內容中的片段時，這是建議的方法。

範例：在回圈內使用具有全域變數的片段

在您的訊息內容中，定義全域變數並使用參考它的片段：

{% let globalDiscount = 15 %}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
    {{fragment id='ajo:fragment123/variant456' mode='inline'}}
  </div>
{{/each}}

在運算式片段(fragment123)中，您可以參考globalDiscount變數：

<p class="discount-info">Save {{globalDiscount}}% on all items!</p>

此模式之所以能運作，是因為無論回圈內容為何，整個訊息（包括片段內）皆可存取全域變數。

不支援：傳遞回圈變數做為片段引數 loop-variables-limitations

您無法將目前反複專案（例如上述範例中的product）以引數形式傳遞至運算式片段。片段無法從周圍的{{#each}}區塊直接存取回圈範圍的變數。

範例：什麼不運作

{{#each context.journey.actions.GetProducts.items as |product|}}
  <!-- This will NOT work as expected -->
  {{fragment id='ajo:fragment123/variant456' mode='inline' currentProduct=product}}
{{/each}}

片段無法接收product做為引數，並在內部使用，因為目前的實作不支援為回圈特定變數傳遞引數。

建議的因應措施 fragments-in-loops-workarounds

當您需要將運算式片段用於回圈中的資料時，請考慮以下方法：

直接在訊息中包含邏輯：不要將片段用於回圈特定的邏輯，而是直接在您的{{#each}}區塊中新增個人化程式碼。

code language-handlebars

code language-handlebars
`{{#each context.journey.actions.GetProducts.items as \|product\|}} <div class="product"> <h3>{{product.name}}</h3> <p>Price: ${{product.price}}</p> {{#if product.price > 100}} <span class="premium-badge">Premium Product</span> {{/if}} </div> {{/each}}`

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
    {{#if product.price > 100}}
      <span class="premium-badge">Premium Product</span>
    {{/if}}
  </div>
{{/each}}

使用回圈以外的片段：如果片段內容不是回圈相依的，請在反複專案區塊之前或之後呼叫片段。

code language-handlebars

code language-handlebars
`{{fragment id='ajo:fragment123/variant456' mode='inline'}} {{#each context.journey.actions.GetProducts.items as \|product\|}} <div class="product"> <h3>{{product.name}}</h3> <p>Price: ${{product.price}}</p> </div> {{/each}}`

{{fragment id='ajo:fragment123/variant456' mode='inline'}}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
  </div>
{{/each}}