REST Resource: firstPartyAndPartnerAudiences

資源：FirstPartyAndPartnerAudience

說明用於指定目標的第一方或合作夥伴目標對象名單。第一方目標對象是使用客戶資料建立。合作夥伴目標對象由第三方資料供應商提供，且只能授權給客戶。

JSON 表示法 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
欄位
name

string

僅供輸出。第一方和夥伴目標對象的資源名稱。
firstPartyAndPartnerAudienceId

string (int64 format)

ID。第一方和夥伴目標對象的專屬 ID。由系統指派。
displayName

string

(選用步驟) 第一方和夥伴目標對象的顯示名稱。
description

string

(選用步驟) 使用者提供的目標對象說明。

僅適用於第一方目標對象。
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

僅供輸出。目標對象是否為第一方和夥伴目標對象。
audienceType

enum (AudienceType)

不可變動。目標對象類型。
audienceSource

enum (AudienceSource)

僅供輸出。目標對象的來源。
membershipDurationDays

string (int64 format)

(選用步驟) 符合資格的事件發生後，項目在目標對象中保留的天數。設定的值必須大於 0，且小於或等於 540。

僅適用於第一方目標對象。

如果使用下列任一 audienceType，就必須填寫這個欄位：

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

僅供輸出。多媒體廣告聯播網的預估目標對象規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏人數並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅在 GET 要求中傳回。
activeDisplayAudienceSize

string (int64 format)

僅供輸出。過去一個月內，多媒體廣告聯播網的預估目標對象規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏數字並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅在 GET 要求中傳回。
youtubeAudienceSize

string (int64 format)

僅供輸出。YouTube 聯播網的預估目標對象規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏數字並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅適用於第一方目標對象。

僅在 GET 要求中傳回。
gmailAudienceSize

string (int64 format)

僅供輸出。Gmail 聯播網的預估目標對象規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏數字並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅適用於第一方目標對象。

僅在 GET 要求中傳回。
displayMobileAppAudienceSize

string (int64 format)

僅供輸出。多媒體廣告聯播網中，行動應用程式目標對象的預估規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏數字並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅適用於第一方目標對象。

僅在 GET 要求中傳回。
displayMobileWebAudienceSize

string (int64 format)

僅供輸出。多媒體廣告聯播網中，行動版網站的預估目標對象規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏數字並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅適用於第一方目標對象。

僅在 GET 要求中傳回。
displayDesktopAudienceSize

string (int64 format)

僅供輸出。多媒體廣告聯播網的預估電腦目標對象規模。

基於隱私權考量，如果規模小於 1000，系統會隱藏人數並傳回 0。否則，系統會將數字四捨五入至兩位有效數字。

僅適用於第一方目標對象。

僅在 GET 要求中傳回。
appId

string

(選用步驟) appId 與上傳的 mobileDeviceIds 類型相符。

僅適用於audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

第一方和夥伴目標對象資源的可能類型。

列舉
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED 未指定或不明類型時的預設值。
TYPE_FIRST_PARTY 使用客戶資料建立的目標對象。
TYPE_PARTNER 第三方資料供應商提供的目標對象。

AudienceType

可能的目標對象類型。

列舉
AUDIENCE_TYPE_UNSPECIFIED 未指定或不明類型時的預設值。
CUSTOMER_MATCH_CONTACT_INFO 目標對象是透過比對顧客與已知聯絡資訊產生。
CUSTOMER_MATCH_DEVICE_ID 目標對象是透過比對顧客與已知行動裝置 ID 產生。
CUSTOMER_MATCH_USER_ID 目標對象是透過比對顧客與已知使用者 ID 產生。
ACTIVITY_BASED

已淘汰：目標對象是根據廣告活動建立。
FREQUENCY_CAP

已淘汰：目標對象是根據排除放送的曝光次數建立。
TAG_BASED 目標對象是根據附加至像素的自訂變數建立。
YOUTUBE_USERS 根據過去與影片、YouTube 廣告或 YouTube 頻道的互動情形建立目標對象。
THIRD_PARTY 目標對象已獲得第三方授權使用。
COMMERCE 由商務夥伴提供的目標對象，需付費使用。
LINEAR 傳統電視內容的目標對象。
AGENCY 由代理商提供的目標對象。

AudienceSource

可能的目標對象來源。

列舉
AUDIENCE_SOURCE_UNSPECIFIED 未指定或不明目標對象來源時的預設值。
DISPLAY_VIDEO_360 源自 Display & Video 360。
CAMPAIGN_MANAGER 源自 Campaign Manager 360。
AD_MANAGER 源自 Google Ad Manager。
SEARCH_ADS_360 源自 Search Ads 360。
YOUTUBE 源自 YouTube。
ADS_DATA_HUB 源自廣告資料中心。

方法

get

 取得第一方或夥伴目標對象。

list

 列出第一方和夥伴目標對象。