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)

與廣告主定義的使用者專屬 ID 相關的資料。
ppidData

object (PpidData)

與發布商提供的 ID 相關的資料。

這項功能僅適用於資料合作夥伴。
compositeData

object (CompositeData)

多個 ID 類型組成的群組。
googleUserIdData

object (GoogleUserIdData)

加密的 Google 使用者 ID。
partnerProvidedIdData

object (PartnerProvidedIdData)

合作夥伴提供的 ID。
互斥欄位的結尾。

PairData

目標對象的 PAIR ID。至少須提供一組 PAIR ID。

這項功能僅適用於資料合作夥伴。

JSON 表示法 
{
  "pairIds": [
    string
  ]
}
欄位
pairIds[]

string

必填。無塵室提供的 PII 資料 (以 SHA256 雜湊處理，並使用發布商金鑰透過 EC 可交換密碼加密)，用於 PAIR 使用者名單。單一 AudienceMember 最多可提供 10 個 pairIds。

MobileData

目標對象的行動 ID。至少需要一個行動 ID。

JSON 表示法 
{
  "mobileIds": [
    string
  ]
}
欄位
mobileIds[]

string

必填。行動裝置 ID 清單 (Android 廣告 ID、iOS 廣告識別碼，適用於目標顧客比對使用者名單；Android 廣告 ID、iOS 廣告識別碼、Xbox 或 Microsoft ID、Amazon Fire TV ID、Roku ID、一般裝置 ID，適用於基本使用者名單)。單一 AudienceMember 最多可提供 10 個 mobileIds。

UserIdData

包含使用者 ID 的使用者 ID 資料。

JSON 表示法 
{
  "userId": string
}
欄位
userId

string

必填。廣告主定義的使用者專屬 ID。

PpidData

發布商提供的 ID 資料，其中包含 PPID。至少須提供一個 ppid。

這項功能僅適用於資料合作夥伴。

JSON 表示法 
{
  "ppids": [
    string
  ]
}
欄位
ppids[]

string

必填。使用者的發布商提供 ID 清單。

CompositeData

複合資料，內含使用者的 ID 和相關資料。至少必須有一個 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 正規化，並使用 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 正規化，並使用 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

合作夥伴提供的資料，內含合作夥伴提供的 ID。至少需要一個合作夥伴提供的 ID。

JSON 表示法 
{
  "partnerProvidedIds": [
    string
  ]
}
欄位
partnerProvidedIds[]

string

必填。合作夥伴提供的 ID 清單。