Kevel连接 kevel
概述 overview
Kevel提供支持人工智能的技术和专家指导，帮助创新的商业领袖在零售媒体中启动、扩展和取得成功。 Kevel的Retail Media Cloud功能支持针对网站内和网站外广告采用可归因的可自定义广告格式。
Adobe Experience Platform的Kevel流目标允许客户将Adobe受众直接激活到Kevel的UserDB和区段管理API中，以支持在广告决策时进行实时定位。
用例 use-cases
您可以在零售媒体体验中激活丰富的第一方行为受众，以提供更相关的广告和更强大的性能。 在Experience Platform中，您可以构建高价值、基于意图的受众（例如经常访问类别的购物者或最近对产品感兴趣的用户），并将这些成员资格实时同步到Kevel。 Kevel立即使这些区段可用于ad decisioning，从而在搜索、浏览和应用程序体验间为赞助的产品和其他格式实现准确定位。 一旦用户符合条件，您就可以按照这些信号采取行动，提高相关的展示次数、改善定位效果，并改进测量和ROAS。
先决条件 prerequisites
要准备使用Kevel目标，请确保满足以下先决条件：
- 您必须具有活动的 Kevel网络 和API访问权限。
- 您需要具有创建区段和更新UserDB记录权限的KevelAPI密钥。
- 您必须在Experience Platform中配置标识命名空间，以将其映射到您的网站或应用程序在Kevel广告请求期间发送的标识（例如，ECID、GAID、IDFA、忠诚度ID等）。
- Adobe客户应仅映射在实时广告请求中使用的身份，因为每个身份都将生成UserDB记录。
支持的身份 supported-identities
Kevel目标支持激活应用程序在向Kevel发送广告请求时可能使用的任何标识。 最多可以映射三个标识命名空间来生成相应的UserDB记录。
Kevel支持以下Experience Platform标识命名空间：
支持自定义身份命名空间
Kevel目标还接受在Experience Platform实现中定义的自定义命名空间。
这意味着：
- 您可以映射特定于客户的标识命名空间（例如：
loyalty_id、gigya_id或您在Identity Service中定义的任何自定义标识）。 - 这些命名空间可以像全局命名空间一样分配给
kevel_user_key1、kevel_user_key2或kevel_user_key3。 - Kevel将为每个映射的标识 的每个实例生成 一个UserDB记录，从而允许您在广告决策时实时匹配系统发送的每个标识。
身份映射行为
- 您最多可以将 个三个 个Experience Platform标识命名空间映射到Kevel的三个标识插槽。
- 对于每个激活的配置文件，Kevel将接收每个映射标识 的每个实例的 一个UserDB记录。
- 客户应仅将其实际发送的广告请求标识映射到Kevel，以避免不必要的UserDB存储。
Kevel目标
支持的受众 supported-audiences
导出类型和频率 export-type-frequency
连接到目标 connect
按照标准Experience Platform 连接目标工作流。
验证目标 authenticate
连接到Kevel时，请提供以下字段：
- 持有者令牌 — 您的Kevel API密钥。
Kevel目标的
填写目标详细信息 destination-details
身份验证后，配置：
- 名称 — 用于标识此目标实例的标签。
- 描述 — 描述此目标实例的可选文本。
- Kevel网络ID — 您的Kevel网络标识符。
Kevel目标的
将区段激活到此目标 activate
要将受众发送到Kevel，请遵循中的工作流
将配置文件和区段激活到流式区段导出目标。
停用受众 deactivate
当在Experience Platform中停用受众或从Kevel目标中删除受众时，Experience Platform停止为该受众发送进一步的配置文件资格更新。 在Kevel中创建的任何现有区段仍然可用，不会自动删除。
如果Kevel区段当前正用于活动的营销活动中，则Kevel可阻止删除以避免中断实时投放。 在这种情况下，Experience Platform中的停用会导致以下情况：
- Experience Platform数据流停止
- Kevel区段继续存在，并且可能一直附加到营销活动，直到手动移除或更新营销活动为止
要完全停止Kevel中的定位，请确保从Kevel的营销活动管理系统中的任何活动营销活动中移除该区段。
映射属性和身份 map
Kevel需要：
- 身份命名空间 — 最多三个映射到Kevel身份插槽的身份命名空间。
- 区段成员资格 — 无需手动映射；Experience Platform会自动传递区段成员资格标识符和别名。
在激活期间，选择已为Kevel配置的身份命名空间。 每个标识将生成自己的UserDB更新调用。
导出的数据/验证数据导出 exported-data
当配置文件符合或退出受众时，Experience Platform会向Kevel发送流式更新。
Kevel UserDB收到的样本有效负载
PUT /udb/{networkId}/segments?userKey=ECID-12345
{
"segments": [1723, 3344, 9988]
}
导出期间使用的Experience Platform配置文件示例 sample-profile
将受众激活到Kevel目标时，Experience Platform将包含 区段资格 和客户 映射的 身份的配置文件片段发送到Kevel的标识插槽。
以下是导出的配置文件的示例：
- 多个标识命名空间映射到
kevel_user_key1、kevel_user_key2和kevel_user_key3 ups命名空间中的单个激活区段
{
"segmentMembership": {
"ups": {
"9d161bbb-c785-474a-965b-7d7bc2adf879": {
"status": "realized",
"lastQualificationTime": "2025-12-10T21:43:38.541076Z"
}
}
},
"identityMap": {
"kevel_user_key1": [
{
"id": "ECID-fN1zo"
},
{
"id": "ECID-9Xr2p"
}
],
"kevel_user_key2": [
{
"id": "GAID-4oic4"
}
],
"kevel_user_key3": [
{
"id": "IDFA-nB5fU"
}
]
}
}
Kevel如何解释此配置文件
使用Kevel目标配置，每个映射的标识都会生成一个不同的UserDB记录，这意味着Kevel将接收：
ECID-fN1zo的一次更新ECID-9Xr2p的一次更新GAID-4oic4的一次更新IDFA-nB5fU的一次更新
这允许使用任意可用身份在广告决策时识别同一人员，每个身份具有一组相同的区段成员资格。
数据使用和治理 data-usage-governance
在处理您的数据时，所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息，请阅读数据治理概述。