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)

このカスタム オーディエンスが構成されているカスタム オーディエンス メンバーのリスト。メンバーはカスタム オーディエンスの作成時に追加できます。UPDATE オペレーションでメンバーが指定されている場合、既存のメンバーはオーバーライドされます。

CustomAudienceStatus

カスタム オーディエンスのステータスを含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ENABLED 有効なステータス - カスタム オーディエンスが有効で、ターゲットに設定できます。
REMOVED 削除済みステータス - カスタム オーディエンスは削除されており、ターゲティングに使用できません。

CustomAudienceType

使用可能なカスタム オーディエンスのタイプを含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
AUTO Google 広告では、配信時に最適な解釈が自動的に選択されます。
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、URL、PLACE_CATEGORY、APP）。
共用体フィールド value。CustomAudienceMember の値。メンバーの種類に応じて 1 つのフィールドが入力されます。value は次のいずれかになります。
keyword

string

キーワードまたはキーワード フレーズ - 最大 10 単語、80 文字。中国語、日本語、韓国語などの全角文字言語の場合は、ユーザーの関心やアクションを説明する 40 文字まで使用できます。
url

string

プロトコルを含む HTTP URL（最大 2,048 文字）。ユーザーが興味を持っているコンテンツを含めます。
placeCategory

string (int64 format)

ユーザーが訪れる場所のカテゴリで説明される場所のタイプ。
app

string

ユーザーがインストールした Android アプリのパッケージ名（com.google.example など）。

CustomAudienceMemberType

カスタム オーディエンスのメンバーに使用できるタイプを格納する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
KEYWORD キーワードで表される興味 / 関心や行動を持つユーザー。
URL ウェブサイトのコンテンツに関連する興味 / 関心を持つユーザー。
PLACE_CATEGORY 場所のカテゴリで説明されている場所の種類にアクセスしたユーザー。
APP モバイルアプリをインストールしたユーザー。