向受众群体上传成员

如需将成员上传到目标客户匹配受众群体,请发送 IngestAudienceMembersRequest。

如需配置和发送请求,请完成以下步骤:

  1. 将 termsOfService 字段设置为 TermsOfService 消息,并将 customerMatchTermsOfServiceStatus 设置为 ACCEPTED,以 确认 operatingAccount 接受了 目标客户匹配服务条款。

  2. 在 AudienceMember 列表中的 audienceMembers 每个上,根据上传内容的数据类型设置数据字段:

    • 如果上传内容包含联系信息、 IP 地址数据、 或两者都包含,请将 compositeData 字段设置为 CompositeData 对象。对于 联系信息,请将其 userData 字段设置为 UserData 对象,并在 the userIdentifiers 列表中为受众群体成员的每个标识符添加单独的条目。 对于 IP 地址数据,请在ipData 列表中为受众群体成员的每个 IP 地址添加一个 IpData条目。

      虽然我们仍支持 userData ,但建议您使用 compositeData ,以确保您的集成能够适应未来的改进。如需了解详情,请参阅复合 数据。

    • 如果上传内容包含移动 ID,请将 mobileData 字段设置为 MobileData 消息。 在 mobileIds 列表中为受众群体成员的每个 Mobile ID 添加单独的条目。

    • 如果上传内容包含用户 ID,请将 userIdData 字段设置为 UserIdData 消息, 并将其 userId 字段设置为受众群体成员的用户 ID。

  3. 按照 发送受众群体成员中的步骤发送目标客户匹配数据。

选段受众群体成员

以下示例展示了如何为每种类型的成员 数据构建一个 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"
  }
}