CustomInterest

自訂興趣。這是按興趣劃分的使用者清單,

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

string

不可變動。自訂興趣的資源名稱。自訂興趣資源名稱的格式如下:

customers/{customerId}/customInterests/{custom_interest_id}

status

enum (CustomInterestStatus)

這項自訂興趣的狀態。用於指出是否已啟用或移除自訂興趣。

type

enum (CustomInterestType)

自訂興趣類型,CUSTOM_AFFINITY 或 CUSTOM_INTENT。類型預設為 CUSTOM_AFFINITY。

members[]

object (CustomInterestMember)

自訂興趣成員清單,由此自訂興趣組成。您可以在建立 CustomInterest 時加入成員。如果系統在 UPDATE 作業中顯示成員,將覆寫現有成員。

id

string (int64 format)

僅供輸出。自訂興趣的 ID。

name

string

自訂興趣的名稱。相同的自訂興趣相似目標對像不得重複。這是建立作業時的必填欄位。

description

string

這個自訂興趣目標對象的說明。

CustomInterestStatus

列舉包含可能的自訂興趣類型。

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

CustomInterestType

列舉包含可能的自訂興趣類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
CUSTOM_AFFINITY 允許品牌廣告客戶定義自訂興趣相似目標對象名單。
CUSTOM_INTENT 可讓廣告主定義自訂意願目標對象名單。

CustomInterestMember

自訂興趣目標對象的成員。成員可以是關鍵字或網址。設定無法變更,也就是只能建立或移除。

JSON 表示法
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
欄位
memberType

enum (CustomInterestMemberType)

自訂興趣成員的類型,KEYWORD 或網址。

parameter

string

當 memberType 為 KEYWORD 或網址字串時,出現關鍵字文字。

CustomInterestMemberType

列舉包含可能的自訂興趣成員類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
KEYWORD 自訂興趣成員類型 KEYWORD。
URL 自訂興趣成員類型網址。