AudienceMember

要操作的受众群体成员。

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
字段
destinationReferences[]

string

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

object (Consent)

可选。用户的意见征求设置。
要处理的身份识别数据的类型。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
userData

object (UserData)

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

object (PairData)

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

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

object (MobileData)

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

object (UserIdData)

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

object (PpidData)

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

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

object (CompositeData)

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

object (GoogleUserIdData)

加密的 Google 用户 ID。
partnerProvidedIdData

object (PartnerProvidedIdData)

合作伙伴提供的标识符。
互斥字段的结束位置。

PairData

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

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

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

string

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

UserIdData

包含用户 ID 的 User-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"。

GoogleUserIdData

包含已加密 Google 用户 ID 的 Google 用户 ID 数据。必须至少提供一个 Google 用户 ID。

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

string

必需。已加密的 Google 用户 ID 列表。

PartnerProvidedIdData

包含合作伙伴提供的标识符的合作伙伴提供的数据。必须提供至少一个合作伙伴提供的标识符。

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

string

必需。合作伙伴提供的标识符列表。