文档 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变量。当使用片段 主页块 时，将显示一个链接，其中将附加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}}