文档Journey OptimizerJourney Optimizer 指南

添加个性化 build-personalization-expressions

Last update: Tue Mar 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 中级
  • 开发人员

个性化编辑器是Journey Optimizer中个性化的核心。 它可在您需要定义个性化的每个上下文中使用，例如电子邮件、推送和选件。

在个性化编辑器界面中，您可以选择、排列、自定义和验证所有数据，为您的内容创建自定义个性化。

可在何处添加个性化

您可以使用 添加个性化图标 图标在每个字段中的​ Journey Optimizer ​中添加个性化。

消息

在邮件中，可以在邮件的不同位置添加个性化，如​ 主题行 ​字段。

还可以在内容的其他部分中添加它。 例如，对于推送通知，可在​ 标题、正文、自定义声音、徽章 ​和​ 自定义数据 ​字段中添加个性化设置。

电子邮件设计工具

在电子邮件Designer中编辑电子邮件内容时，您可以使用上下文工具栏中的图标在文本块和URL中添加个性化设置。

产品建议

在​ 优惠的表示形式 ​中使用文本类型内容时，您可以添加个性化。 了解如何创建个性化优惠

URL

Journey Optimizer还允许您个性化消息中的​ URL。 个性化 URL 可将收件人引导至网站的特定页面，或引导至个性化的微型网站，具体取决于轮廓属性。URL个性化可用于以下类型的链接： 外部链接、退订链接 ​和​ 选择退出。

请参阅个性化URL示例
  • https://www.adobe.com/users/{{profile.person.name.lastName}}
  • https://www.adobe.com/users?uid={{profile.person.name.firstName}}
  • https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}
  • https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}

{width="50%"}

NOTE
在个性化编辑器中编辑个性化URL时，出于安全原因，将禁用帮助程序功能和受众成员资格。
url内使用的个性化令牌不支持空格。

Personalization源 sources

屏幕左侧显示一个域选择器，允许您选择个性化的源。 可用源包括：

  • 配置文件属性 ：列出与Adobe Experience Platform数据模型(XDM)文档中描述的配置文件架构关联的所有引用。
  • 受众 ：列出在Adobe Experience Platform分段服务中创建的所有受众。 有关分段的更多信息，请参阅此处。
  • 优惠决策 ：列出与特定投放位置关联的所有优惠。 选择投放位置，然后在您的内容中插入选件。 有关如何管理优惠的完整文档，请参阅此部分。
  • 上下文属性 ：在历程或营销活动中使用渠道操作活动（电子邮件、推送、短信）时，与事件和属性相关的上下文属性可用于个性化。 此部分中介绍了利用上下文属性的个性化示例。
NOTE
如果您使用使用合成工作流生成的扩充属性定位受众，则可以利用这些扩充属性个性化您的消息。 了解如何使用受众扩充属性

添加个性化 add

中央工作区是您构建个性化语法的位置。 若要使用属性来个性化您的消息，请将其定位到左侧导航窗格中，然后单击+按钮以将其添加到表达式中。

+图标旁边的省略号菜单允许您获取每个属性的更多详细信息，并将最常用的属性添加到收藏夹。 添加到收藏夹的属性可从左侧导航窗格中的​ 收藏夹 ​菜单访问。

此外，您可以定义在字符串类型配置文件属性为空时显示的默认回退文本。 为此，请单击属性旁边的省略号按钮，然后选择​ 插入后备文本。 写入配置文件属性值为空时默认显示的文本，然后单击​ 添加。

在以下示例中，个性化编辑器允许您选择今天生日的用户档案，然后插入对应于今天的特定选件以完成自定义。

表达式编辑工具

中央工作区提供了各种工具来帮助您编写个性化表达式。

可用选项包括：

  1. 查找 / 查找并替换：搜索表达式并自动替换部分代码。

  2. 撤消 / 重做：撤消/重做上一个操作。

  3. 自动完成：在您键入时自动建议并完成代码。 此功能仅适用于HTML和文本格式，并且支持配置文件和上下文属性。 如果通过切换禁用，则编辑器将提供本机HTML代码自动完成。

    {align="center" width="70%" modal="regular"}

  4. HTML / JSON / 文本：标识代码格式。 这使系统能够根据所选语言调整验证和自动完成功能。

  5. 验证：检查表达式的语法。 有关详细信息，请参阅此部分。

  6. 另存为片段：将表达式另存为表达式片段。 在本节中了解详情

  7. 字体大小：调整编辑器内内容的字体大小，以提高可读性。

  8. 自动换行：启用或禁用自动换行，从而允许在编辑器中单行显示或自动换行的长表达式。 选项包括：

    • 关（默认） — 无自动换行。 长线延伸到编辑器视图之外，需要水平滚动。
    • On — 以编辑器的宽度换行。
    • 自动换行列 — 当行字符达到80个字符时换行。
    • 绑定 — 以编辑器宽度或80个字符（以较小者为准）换行。

在导航窗格中，提供其他功能以帮助您构建个性化表达式。

  • 辅助函数 — 辅助函数允许您对数据执行操作，例如计算、数据格式或转换、条件，并在个性化上下文中处理这些操作。 了解有关可用辅助函数的更多信息

  • 收藏夹 — 已添加到收藏夹的属性将显示在此列表中。 这允许您快速访问最常使用的项目。 若要向收藏夹添加属性，请单击省略号菜单，然后选择​ 添加到收藏夹。

  • 条件 — 利用在库中创建的条件规则将动态内容添加到消息中。 这允许您根据条件创建消息的多个变体。 了解如何创建动态内容

  • 片段 — 利用已创建或已保存到当前沙盒的表达式片段。 片段是可重复使用的组件，可以在Journey Optimizer营销活动和历程中引用。 此功能允许预先构建多个自定义内容块，营销用户可以使用这些内容块在改进的设计过程中快速组合内容。 了解如何使用表达式片段进行个性化

在个性化表达式准备就绪后，需要由个性化编辑器验证该表达式。 有关详细信息，请参阅此部分。

验证机制 validation-mechanisms

单击​ 添加 ​按钮关闭编辑器窗口时，将自动执行表达式验证。 您还可以使用​ 验证 ​按钮检查个性化语法。

展开以下部分可查看验证个性化设置时可能发生的常见错误。

常见错误
  • 找不到“XYZ”路径

尝试引用架构中未定义的字段时。

在这种情况下，firstName1 ​未定义为配置文件架构中的特性：

code language-none 
{{profile.person.name.firstName1}}
  • 变量“XYZ”的类型不匹配。 应为数组。 找到字符串。

当尝试对字符串而不是数组进行迭代时。

在这种情况下，product ​不是数组：

code language-none 
{{each profile.person.name.firstName as |product|}}
 {{product.productName}}
{{/each}}
  • 无效的Handlebars语法。 找到‘[XYZ}}’

当使用了无效的Handlebars语法时。

Handlebars表达式用​ {{expression}} ​括起来

code language-none 
   {{[profile.person.name.firstName}}
  • 区段定义无效
code language-none 
No segment definition found for 988afe9f0-d4ae-42c8-a0be-8d90e66e151

对于选件，可能会发生特定错误。 有关更多详细信息，请展开以下部分：

与优惠相关的特定错误

与电子邮件或推送消息中的优惠集成相关的错误具有以下模式：

code language-none 
Offer.<offerType>.[PlacementID].[ActivityID].<offer-attribute>

验证是在验证个性化编辑器中的个性化内容期间执行的。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
错误标题 验证/解析
未找到ID为placementID且类型为OfferPlacement的资源
未找到id为activityID且类型为OfferActivity的资源		 检查ActivityID和/或PlacementID是否可用
无法验证资源。 投放位置中的componentType应与offerType选件匹配
offerId中不存在公共URL。 图像选件（所有与决策和投放对关联的个性化和回退）应填充公共URL（deliveryURL不应为空）。
决策包含非配置文件属性。 选件模型用法应仅包含配置文件属性。
获取决策用法时出错。 当API尝试获取选件模型时，可能会发生此错误。
选件属性offer-attribute无效。 检查选件drp中引用的选件属性是否有效。 以下是有效属性：
图像： deliveryURL， linkURL
文本： content
HTML：内容
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76