如需将成员上传到目标客户匹配受众群体,请发送
IngestAudienceMembersRequest。
如需配置和发送请求,请完成以下步骤:
将
termsOfService字段设置为TermsOfService消息,并将customerMatchTermsOfServiceStatus设置为ACCEPTED,以 确认operatingAccount接受了 目标客户匹配服务条款。在
AudienceMember列表中的audienceMembers每个上,根据上传内容的数据类型设置数据字段:如果上传内容包含联系信息、 IP 地址数据、 或两者都包含,请将
compositeData字段设置为CompositeData对象。对于 联系信息,请将其userData字段设置为UserData对象,并在 theuserIdentifiers列表中为受众群体成员的每个标识符添加单独的条目。 对于 IP 地址数据,请在ipData列表中为受众群体成员的每个 IP 地址添加一个IpData条目。虽然我们仍支持
userData,但建议您使用compositeData,以确保您的集成能够适应未来的改进。如需了解详情,请参阅复合 数据。如果上传内容包含移动 ID,请将
mobileData字段设置为MobileData消息。 在mobileIds列表中为受众群体成员的每个 Mobile ID 添加单独的条目。如果上传内容包含用户 ID,请将
userIdData字段设置为UserIdData消息, 并将其userId字段设置为受众群体成员的用户 ID。
按照 发送受众群体成员中的步骤发送目标客户匹配数据。
选段受众群体成员
以下示例展示了如何为每种类型的成员
数据构建一个
AudienceMember对象。单个请求中的每个 AudienceMember 都必须具有
相同类型的 ID 数据 集
(compositeData、mobileData 或
userIdData):
联系信息
{
"compositeData": {
"userData": {
"userIdentifiers": [
{
"emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
},
{
"phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
}
]
}
}
}
IP 地址数据
{
"compositeData": {
"ipData": [
{
"ipAddress": "203.0.113.98",
"observeStartTime": "2026-06-10T20:17:52.0-04:00",
"observeEndTime": "2026-06-17T04:02:04.123-04:00"
}
]
}
}
联系信息和 IP 数据
{
"compositeData": {
"userData": {
"userIdentifiers": [
{
"emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
},
{
"phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
}
]
},
"ipData": [
{
"ipAddress": "203.0.113.98",
"observeStartTime": "2026-06-10T20:17:52.0-04:00",
"observeEndTime": "2026-06-17T04:02:04.123-04:00"
}
]
}
}
移动 ID
{
"mobileData": {
"mobileIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}
用户 ID
{
"userIdData": {
"userId": "user_987654321"
}
}