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)

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

object (PpidData)

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

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

object (CompositeData)

多個 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 (廣告 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"。