3.5创建区段 — API

在本练习中,您将使用Postman和Adobe I/O通过使用Adobe Experience Platform的API创建一个区段,并将该区段的结果存储为数据集。

Story

在“实时客户资料”中,所有资料数据都与事件数据和现有区段成员资格一起显示。 显示的数据可以从任何位置(从Adobe应用程序和外部解决方案)获取。 这是Adobe Experience Platform最有力的观点,是记录体验系统。

练习3.5.1 — 通过Platform API创建区段

去邮递员。

找到收藏集:_Adobe Experience Platform启用。 在此集合中,您将看到文件夹​2。 区段. 我们将在本练习中使用这些请求。

区段

我们接下来将执行所有必需的步骤以通过API创建区段。 我们将构建一个简单的区段:"ldap — 所有女性客户"。

步骤1 — 创建区段定义

单击名为​Step 1 - Profile的请求:创建区段定义

区段

转到此请求的​Body​部分。

区段

在此请求的​Body​中,您将看到以下内容:

区段

此请求所使用的语言称为“配置文件查询语言”,即​PQL

您可以在此处🔗找到有关PQL 的更多信息和文档。

注意:请将​ldap​替换为您的特定​ldap,以更新以下请求中的变量​name

{
    "name" : "ldap - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "ldap",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

添加特定的​ldap​后,主体应类似于以下内容:

{
    "name" : "vangeluw - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "vangeluw",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

您还应验证请求的​Header — 字段。 转到​Headers。 然后您将看到:

邮递员

x-sandbox-name --aepSandboxId--
注意

您需要指定所使用的Adobe Experience Platform沙盒的名称。 您的x-sandbox-name应为--aepSandboxId--

现在,单击蓝色的​发送​按钮以创建区段并查看该区段的结果。

区段

完成此步骤后,您可以在平台UI中查看区段定义。 要选中此选项,请登录Adobe Experience Platform,然后转到​Segments

区段

第2步 — 创建区段POST作业

在上一个练习中,您创建了一个​​区段。 流区段会持续实时评估资格。 您在此处所做的是创建​​区段。 批处理客户细分可让您预览客户细分在资格方面的外观,但​并不意味着客户细分已实际运行。 目前,没有人符合此区段的条件。 要使人员符合条件,需要运行批处理客户细分,这正是我们在此将要执行的操作。

现在,让我们POST区段作业。

去邮递员。

区段

在您的Postman集合中,单击名为​Step 2 -POST区段作业​的请求以将其打开。

区段

您还应验证请求的​Header — 字段。 转到​Headers。 然后您将看到:

邮递员

x-sandbox-name --aepSandboxId--
注意

您需要指定所使用的Adobe Experience Platform沙盒的名称。 您的x-sandbox-name应为--aepSandboxId--

单击蓝色的​Send​按钮。

您应会看到类似的结果:

区段

此区段作业当前正在运行,这可能需要一些时间。 在步骤3中,您将能够检查此作业的状态。

步骤3 -GET区段作业状态

去邮递员。

区段

在您的Postman集合中,单击名为​Step 3 -GET区段作业状态​的请求。

区段

您还应验证请求的​Header — 字段。 转到​Headers。 然后您将看到:

邮递员

x-sandbox-name --aepSandboxId--
注意

您需要指定所使用的Adobe Experience Platform沙盒的名称。 您的x-sandbox-name应为--aepSandboxId--

单击蓝色的​Send​按钮。

您应会看到类似的结果:

区段

在此示例中,作业的​状态​被设置为​QUEUED

单击蓝色的​Send​按钮,每隔几分钟重复一次此请求,直到​status​设置为​SUCCEEDED​为止。

区段

状态为​SUCCEEDED​后,您的区段作业即已运行,客户现在符合该区段的资格条件。

恭喜,您已成功完成分段练习。 现在,让我们看一看如何在整个企业中激活实时客户资料。

下一步:3.6请在呼叫中心查看“Real-time Customer Profile(您的实时客户资料)”操作情况

返回到模块3

返回到所有模块

在此页面上