辅助程序 gs-helpers

默认回退值 default-value

如果属性为空或null，则使用Default Fallback Value帮助程序返回默认回退值。 此机制适用于配置文件属性和历程事件。

语法

Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

在此示例中，如果此配置文件的there属性为空或null，则显示值firstName。

条件 if-function

if帮助程序用于定义条件块。
如果表达式求值返回true，则会呈现块，否则将跳过该块。

语法

{%#if contains(profile.personalEmail.address, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>

在if帮助程序之后，您可以输入else语句以指定要执行的代码块（如果相同条件为false）。
elseif语句将指定一个新条件来测试第一个语句是否返回false。

格式

{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

示例

Unless unless

unless帮助程序用于定义条件块。 通过对if帮助程序的反对，如果表达式求值返回false，则呈现块。

语法

{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

示例

根据电子邮件地址扩展呈现某些内容：

{%#unless endsWith(profile.personalEmail.address, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content
{%/unless%}

每个 each

each辅助函数用于遍历数组。
辅助函数的语法为{{#each ArrayName}} YourContent {{/each}}
我们可以在块中使用关键字​ this ​引用单个数组项。 可以使用{{@index}}呈现数组元素的索引。

语法

{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

示例

{{#each profile.homeAddress.city}}
  {{@index}} : {{this}}<br>
{{/each}}

示例

呈现此用户在其购物车中拥有的产品列表：

{{#each profile.products as |product|}}
    <li>{{product.productName}} {{product.productRating}}</li>
{{/each}}

替换为 with

with帮助程序用于更改模板部分的评估令牌。

语法

{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

with辅助函数也可用于定义快捷键变量。

示例

与一起使用，将长变量名称别名更改为短变量名称：

{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

Let let

let函数允许将表达式存储为变量，以便稍后在查询中使用。

语法

{% let variable = expression %} {{variable}}

示例

以下示例允许您计算购物车中价格在100和1000之间的产品的总价。

{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{sum}}

数据集查找 dataset-lookup

datasetLookup助手在个性化期间从Adobe Experience Platform记录数据集检索数据，以便您可以使用未存储在配置文件或事件有效负载中的字段值。

语法

{{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}

引用检索了具有{{result.fieldId}}的字段，其中result是传递给result参数的值。

有关数据集启用、参数详细信息、示例和测试，请参阅使用Adobe Experience Platform数据进行个性化。

执行元数据 execution-metadata

executionMetadata帮助程序允许动态捕获自定义键值对并将其存储到消息执行上下文中。

语法

{{executionMetadata key="your_key" value="your_value"}}

在此语法中，key引用元数据名称，value是要保留的元数据。

用例

利用此功能，您可以将上下文信息附加到营销活动或历程中的任何本机操作。 这使您能够将实时投放上下文数据导出到外部系统，用于各种目的，例如跟踪、分析、个性化和下游处理。

例如，您可以使用执行元数据帮助程序将特定ID附加到发送到每个用户档案的每个投放中。 此信息在运行时生成，随后可导出扩充的执行元数据以用于与外部报告平台的下游协调。

工作原理

从营销活动或历程中的渠道内容中选择任何元素，并使用个性化编辑器将executionMetadata帮助程序添加到此元素。

在运行时，元数据值被添加到现有​ 消息反馈事件数据集 ​中，并添加了以下架构：

"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}

限制

每个操作的键值对的上限为2kb。 如果超过2Kb限制，则仍会投放消息，但可以截断任何键值对。

对于从操作中排除的用户档案，不会捕获元数据。 当某个用户档案被排除在接收消息范围之外时，不会在该数据集中为该用户档案创建元数据条目。

示例

{{executionMetadata key="firstName" value=profile.person.name.firstName}}

在此示例中，假设profile.person.name.firstName = "Alex"，则生成的实体为：

{
  "key": "firstName",
  "value": "Alex"
}

加密 url-parameter-encryption-helper

Encrypt函数允许您在渲染时加密任何表达式值（通常是配置文件属性、令牌或甚至您在表达式中构建的字符串JSON结构），然后将其写入跟踪链接或登陆页面上的查询参数中。

在检查或转发链接时，无法读取URL中显示为纯文本的值（包括PII或其他敏感数据）。 只有使用此帮助程序括起来的值才会被加密；URL的其余部分保持不变。

用例

此辅助函数允许您在将敏感配置文件数据(PII)包含在渲染的输出中之前对其进行保护。

先决条件

管理员必须在沙盒级密钥注册表中创建至少一个活动密钥。 了解如何创建和管理密钥

语法

{{encrypt dataPath keyName="keyName" version="version" result="variableName"}}

用法

此辅助函数对敏感数据进行加密，并将结果存储在模板变量中。

您可以根据URL设计和长度限制，将帮助程序应用于链接中的一个参数、多个参数或所有参数。

示例

护栏