AudienceMember

要操作的观众成员。

JSON 表示法 
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  }
  // End of list of possible types for union field data.
}
字段
destinationReferences[]

string

可选。定义将观众成员发送到哪个 Destination。
consent

object (Consent)

可选。用户的意见征求设置。
联合字段 data。要处理的身份识别数据的类型。data 只能是下列其中一项：
userData

object (UserData)

用于识别用户的用户提供的数据。
pairData

object (PairData)

发布商与广告客户间用户身份匹配 (PAIR) ID。

此功能仅适用于数据合作伙伴。
mobileData

object (MobileData)

用于标识用户移动设备的数据。
userIdData

object (UserIdData)

与广告客户定义的用户唯一标识符相关的数据。
ppidData

object (PpidData)

与发布商提供的标识符相关的数据。

此功能仅适用于数据合作伙伴。
compositeData

object (CompositeData)

包含多种标识符类型的群组。

PairData

相应受众群体的 PAIR ID。必须提供至少一个 PAIR ID。

此功能仅适用于数据合作伙伴。

JSON 表示法 
{
  "pairIds": [
    string
  ]
}
字段
pairIds[]

string

必需。由 Cleanroom 提供的 PII 数据，使用 SHA256 进行哈希处理，并使用发布商密钥通过 EC 可交换密码进行加密，以用于 PAIR 用户名单。单个 AudienceMember 中最多可提供 10 个 pairIds。

MobileData

相应受众群体的移动 ID。至少需要一个移动设备 ID。

JSON 表示法 
{
  "mobileIds": [
    string
  ]
}
字段
mobileIds[]

string

必需。移动设备 ID（广告 ID/IDFA）的列表。单个 AudienceMember 中最多可提供 10 个 mobileIds。

UserIdData

包含用户 ID 的用户 ID 数据。

JSON 表示法 
{
  "userId": string
}
字段
userId

string

必需。广告客户定义的用户唯一标识符。

PpidData

发布商提供的标识符数据，用于保存 PPID。必须至少有一个 ppid。

此功能仅适用于数据合作伙伴。

JSON 表示法 
{
  "ppids": [
    string
  ]
}
字段
ppids[]

string

必需。用户的一组由发布商提供的标识符。

CompositeData

用于存储用户的标识符和关联数据的复合数据。至少需要 userData 和 ipData 其中之一。

JSON 表示法 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
字段
userData

object (UserData)

可选。用于识别用户的用户提供的数据。
ipData[]

object (IpData)

可选。用于构建受众群体的客户互动 IP 地址数据。

IpData

用户的 IP 地址信息。我们建议您添加 observeStartTime 和 observeEndTime，以帮助提高目标客户匹配的匹配率。

JSON 表示法 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
字段
ipAddress

string

必需。客户互动时捕获的 IP 地址。接受 IPv4 和 IPv6 的标准字符串格式。
observeStartTime

string (Timestamp format)

可选。相应 IP 地址在会话中的首次记录互动时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
observeEndTime

string (Timestamp format)

可选。会话中来自相应 IP 地址的最后一次记录的互动时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。