CustomAudience

自訂目標對象。這是按興趣分類的使用者名單。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
欄位
resourceName

string

不可變動。自訂目標對象的資源名稱。自訂目標對象資源名稱的格式如下：

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

僅供輸出。自訂目標對象的 ID。
status

enum (CustomAudienceStatus)

僅供輸出。這個自訂目標對象的狀態。指出自訂目標對象是否已啟用或移除。
name

string

自訂目標對象的名稱。此 ID 應為客戶建立的所有自訂目標對象專屬，不得重複。建立作業時，必須填入這個欄位。
type

enum (CustomAudienceType)

自訂目標對象的類型。(「INTEREST」或「PURCHASE_INTENT」不適用於新建立的自訂目標對象，但可用於現有目標對象)
description

string

這個自訂目標對象的說明。
members[]

object (CustomAudienceMember)

這個自訂目標對象所包含的自訂目標對象成員清單。您可以在建立自訂目標對象時新增成員。如果成員在 UPDATE 作業中顯示，現有成員會遭到覆寫。

CustomAudienceStatus

包含可能的自訂目標對象狀態的列舉。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的值不明。
ENABLED 已啟用狀態：自訂目標對象已啟用，可指定目標對象。
REMOVED 已移除狀態：自訂目標對象已移除，無法用於指定目標。

CustomAudienceType

列舉項目，其中包含可能的自訂目標對象類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的值不明。
AUTO Google Ads 會在放送時自動選取最佳解讀方式。
INTEREST 根據使用者的興趣配對。
PURCHASE_INTENT 根據使用者正在研究的主題或考慮購買的產品，進行配對。
SEARCH 根據使用者在 Google 搜尋上搜尋的內容進行比對。

CustomAudienceMember

自訂目標對象的成員。成員可以是 KEYWORD、網址、PLACE_CATEGORY 或 APP。您只能建立或移除成員，無法變更。

JSON 表示法 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
欄位
memberType

enum (CustomAudienceMemberType)

自訂目標對象成員的類型，包括關鍵字、網址、PLACE_CATEGORY 或 APP。
聯集欄位 value。CustomAudienceMember 值。系統會根據會員類型填入一個欄位。value 只能是下列其中一項：
keyword

string

關鍵字或關鍵字詞組，最多 10 個字詞，長度不得超過 80 個半形字元。中文、日文或韓文等全形字元語言的字元上限為 40 個，可用來描述使用者的興趣或動作。
url

string

包含通訊協定的 HTTP 網址 (最多 2048 個半形字元)，其中包含使用者感興趣的內容。
placeCategory

string (int64 format)

使用者造訪的地點類別所描述的地點類型。
app

string

使用者安裝的 Android 應用程式套件名稱，例如 com.google.example。

CustomAudienceMemberType

列舉項目，其中包含可能的自訂目標對象成員類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的值不明。
KEYWORD 使用者興趣或行動可用關鍵字描述。
URL 對網站內容感興趣的使用者。
PLACE_CATEGORY 造訪由地點類別描述的地點類型的使用者。
APP 已安裝行動應用程式的使用者。