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。必须至少提供一个 PAIR ID。

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

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

string

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

MobileData

受众群体的移动设备 ID。必须至少提供一个移动设备 ID。

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

string

必需。移动设备 ID 列表（Android 广告 ID、iOS IDFA（适用于目标客户匹配用户列表）以及 Android 广告 ID、iOS IDFA、Xbox 或 Microsoft ID、Amazon Fire TV ID、Roku ID、通用设备 ID（适用于基本用户列表））。在单个 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"。

GoogleUserIdData

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

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

string

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

PartnerProvidedIdData

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

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

string

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