使用Segmentation Service API创建区段
本文档提供了使用Adobe Experience Platform Segmentation Service API开发、测试、预览和保存区段定义的教程。
有关如何使用用户界面构建区段的信息，请参阅区段生成器指南。
入门指南
本教程要求对创建受众段时涉及的各种Adobe Experience Platform服务有一定的了解。 在开始本教程之前，请查阅以下服务的文档：
- Real-time Customer Profile:根据来自多个来源的汇总数据提供统一、实时的消费者用户档案。
- Adobe Experience Platform Segmentation Service:允许您根据实时受众用户档案数据构建客户细分。
- Experience Data Model (XDM):组织客户体验数 Platform 据的标准化框架。
以下各节提供了成功调用Platform API所需了解的其他信息。
读取示例API调用
本教程提供示例API调用，以演示如何设置请求的格式。 这包括路径、必需的标头和格式正确的请求负载。 还提供API响应中返回的示例JSON。 有关示例API调用文档中使用的约定的信息，请参阅Experience Platform疑难解答指南中关于如何读取示例API调用🔗的部分。
收集所需标题的值
要调用Platform API，您必须首先完成身份验证教程。 完成身份验证教程后，将为所有Experience Platform API调用中每个所需标头提供值，如下所示：
- 授权：承载
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{IMS_ORG}
Experience Platform中的所有资源都隔离到特定虚拟沙箱。 对Platform API的所有请求都需要一个头，该头指定操作将在中执行的沙箱的名称：
- x-sandbox-name:
{SANDBOX_NAME}
有关Platform中沙箱的详细信息，请参阅沙箱概述文档。
所有包含有效负荷(POST、PUT、PATCH)的请求都需要额外的标头：
- 内容类型：application/json
制定细分定义
分段的第一步是定义分段，在称为分段定义的构造中表示。 段定义是封装写入Profile Query Language (PQL)中的查询的对象。 此对象也称为PQL谓词。 PQL谓词根据与提供给Real-time Customer Profile的任何记录或时间序列数据相关的条件定义区段规则。 有关编写PQL查询的详细信息，请参阅 PQL指南。
可以通过向Segmentation API中的/segment/definitions端点发出POST请求来创建新的段定义。 下面的示例概述如何设置定义请求的格式，包括成功定义区段所需的信息。
有关如何定义区段的详细说明，请阅读区段定义开发人员指南。
估计和预览受众
在开发区段定义时，您可以使用Real-time Customer Profile中的估计和预览工具来视图摘要级别信息，以帮助确保隔离预期受众。 估计提供关于区段定义的统计信息，如预测受众大小和置信区间。 预览为区段定义提供符合条件的用户档案的分页列表，使您能够将结果与预期结果进行比较。
通过评估和预览受众，您可以测试和优化PQL谓词，直到它们产生可期望的结果，然后在更新的段定义中使用它们。
要预览或获取区段的估计，需执行两个步骤：
估计的生成方式
数据样本用于评估区段和估计合格用户档案数。 每天早晨（12AM-2AM PT之间，即7AM-9AM UTC），新数据将加载到内存中，所有分段查询都使用当天的样本数据进行估计。 因此，所添加的任何新字段或所收集的额外数据都将反映在次日的估计中。
样本大小取决于用户档案存储中的实体总数。 下表显示了这些样本大小：
| 用户档案存储中的实体 | 样本大小 |
|---|---|
| 不到100万 | 完整数据集 |
| 1到2000万 | 100万 |
| 2000多万 | 总共5% |
估计通常在10-15秒之间，从粗略估计开始，随着读取更多记录，会进行优化。
创建预览作业
可以通过向/preview端点发出POST请求来创建新的预览作业。
有关创建预览作业的详细说明，请参阅预览和估计端点指南。
视图估计或预览
评估和预览进程以异步方式运行，因为不同的查询可能需要不同的时间才能完成。 启动查询后，您可以使用API调用来检索(GET)评估或预览的当前状态。
使用Segmentation Service API，可以通过预览作业的ID查找其当前状态。 如果状态为“RESULT_READY”，则可以视图结果。 要查找预览作业的当前状态，请阅读预览和估计端点指南中关于检索预览作业部分的部分。 要查找估计作业的当前状态，请阅读预览和估计终结指南中检索估计作业的部分。
后续步骤
开发、测试和保存区段定义后，即可创建区段作业，以使用Segmentation Service API构建受众。 有关如何完成此操作的详细步骤，请参见有关评估和访问区段结果的教程。
