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

自訂目標對象的名稱。客戶建立的所有自訂目標對象均不得重複。如要建立作業，這是必填欄位。
type

enum (CustomAudienceType)

自訂目標對象的類型。(新建的自訂目標對象無法使用「INTEREST」或「PURCHASE_INTENT」，但會保留給現有目標對象)
description

string

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

object (CustomAudienceMember)

這個自訂目標對象的組成自訂目標對象成員清單。您可以在建立 CustomAudience 時加入成員。如果系統在 UPDATE 作業中顯示成員，將覆寫現有成員。

CustomAudienceStatus

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

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 已啟用狀態 - 自訂目標對像已啟用，可以指定。
REMOVED 已移除狀態 - 自訂目標對像已移除，且無法用於指定目標。

CustomAudienceType

列舉包括可能的自訂目標對象類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
AUTO Google Ads 會在廣告放送時自動選取最佳解讀方式。
INTEREST 依使用者興趣比對。
PURCHASE_INTENT 根據使用者正在研究的主題或有意購買的產品，推薦合適的對象。
SEARCH 依使用者在 Google 搜尋上的搜尋內容進行比對。

CustomAudienceMember

自訂目標對象的成員。成員可以是 KEYWORD、URL、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)

自訂目標對象的類型、KEYWORD、網址、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 已安裝行動應用程式的使用者。