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 広告では、配信時に最適な解釈が自動的に選択されます。
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 モバイルアプリをインストールしたユーザー