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 已安裝行動應用程式的使用者。