Audience

オーディエンスは効果的なターゲティング オプションです。詳しいユーザー属性やアフィニティなどのさまざまなセグメント属性を組み合わせて、ターゲット セグメントの各セクションを表すオーディエンスを作成できます。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
フィールド
resourceName

string

変更不可。オーディエンスのリソース名。オーディエンス名の形式は次のとおりです。

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

出力のみ。オーディエンスの ID。
status

enum (AudienceStatus)

出力のみ。このオーディエンスのステータスです。オーディエンスが有効か削除されているかを示します。
description

string

このオーディエンスの説明。
dimensions[]

object (AudienceDimension)

オーディエンスの構成を指定する正のディメンション。
exclusionDimension

object (AudienceExclusionDimension)

オーディエンスの構成を指定する除外ディメンション。
scope

enum (AudienceScope)

このオーディエンスを使用できる範囲を定義します。デフォルトでは、スコープは CUSTOMER です。スコープ ASSET_GROUP を指定してオーディエンスを作成し、1 つの assetGroup のみで使用できます。スコープは ASSET_GROUP から CUSTOMER に変更できますが、CUSTOMER から ASSET_GROUP には変更できません。
assetGroup

string

変更不可。このオーディエンスの対象となっているアセット グループ。スコープが ASSET_GROUP の場合にのみ設定する必要があります。作成後は変更できません。ASSET_GROUP スコープのオーディエンスを CUSTOMER スコープにアップグレードすると、このフィールドは自動的に消去されます。
name

string

オーディエンスの名前。アカウント内のすべてのオーディエンスで一意である必要があります。長さは 1 ～ 255 にする必要があります。スコープが設定されていないか、CUSTOMER に設定されている場合は必須です。スコープが ASSET_GROUP の場合、設定や更新はできません。

AudienceStatus

オーディエンスのステータスのタイプを含む列挙型です。

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

AudienceDimension

ユーザーのオーディエンスを指定する正のディメンション。

JSON 表現 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
フィールド
共用体フィールド dimension。オーディエンスに属するユーザーを指定するディメンション。dimension は次のいずれかになります。
age

object (AgeDimension)

年齢でユーザーを指定するディメンション。
gender

object (GenderDimension)

性別でユーザーを指定するディメンション。
householdIncome

object (HouseholdIncomeDimension)

世帯収入でユーザーを指定するディメンション。
parentalStatus

object (ParentalStatusDimension)

子供の有無によってユーザーを指定するディメンション。
audienceSegments

object (AudienceSegmentDimension)

他のオーディエンス セグメントのメンバーシップによってユーザーを指定するディメンション。

AgeDimension

年齢でユーザーを指定するディメンション。

JSON 表現 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
フィールド
ageRanges[]

object (AgeSegment)

ディメンションに含める、連続する年齢層です。
includeUndetermined

boolean

年齢が特定されていないユーザーを含めます。

AgeSegment

連続する年齢層。

JSON 表現 
{
  "minAge": integer,
  "maxAge": integer
}
フィールド
minAge

integer

含める必要がある年齢の下限。18 歳以上の最低年齢を指定する必要があります。指定できる値は 18、25、35、45、55、65 です。
maxAge

integer

含める最高年齢。最長年齢を指定する必要はありません。指定する場合、maxAge は minAge より大きくする必要があります。指定できる値は 24、34、44、54、64 です。

GenderDimension

性別でユーザーを指定するディメンション。

JSON 表現 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
フィールド
genders[]

enum (GenderType)

性別のユーザー属性セグメントを追加しました。
includeUndetermined

boolean

性別が不明なユーザーを含めます。

HouseholdIncomeDimension

世帯収入でユーザーを指定するディメンション。

JSON 表現 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
フィールド
incomeRanges[]

enum (IncomeRangeType)

世帯収入のユーザー属性セグメントを含めました。
includeUndetermined

boolean

世帯収入が不明なユーザーを含めます。

ParentalStatusDimension

子供の有無によってユーザーを指定するディメンション。

JSON 表現 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
フィールド
parentalStatuses[]

enum (ParentalStatusType)

子供の有無のユーザー属性セグメントを追加しました。
includeUndetermined

boolean

子供の有無が不明なユーザーを含める。

AudienceSegmentDimension

他のオーディエンス セグメントのメンバーシップによってユーザーを指定するディメンション。

JSON 表現 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
フィールド
segments[]

object (AudienceSegment)

オーディエンス セグメントを追加しました。1 つ以上のセグメントに属しているユーザーは含められます。

AudienceSegment

良好なオーディエンス セグメントです。

JSON 表現 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
フィールド
共用体フィールド segment。陽性セグメント。segment は次のいずれかになります。
userList

object (UserListSegment)

ユーザーリストのセグメント。
userInterest

object (UserInterestSegment)

アフィニティ セグメントまたは購買意向の強いセグメント
lifeEvent

object (LifeEventSegment)

ライブイベントのオーディエンス セグメント。
detailedDemographic

object (DetailedDemographicSegment)

詳しいユーザー属性セグメントです。
customAudience

object (CustomAudienceSegment)

カスタム オーディエンス セグメントです。

UserListSegment

ユーザーリストのセグメント。類似ユーザー機能のサポートは 2023 年 5 月より終了します。その他のオプションについては、https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html をご覧ください。

JSON 表現 
{
  "userList": string
}
フィールド
userList

string

ユーザーリストのリソース。

UserInterestSegment

ユーザーの興味や関心のセグメントです。

JSON 表現 
{
  "userInterestCategory": string
}
フィールド
userInterestCategory

string

ユーザーの興味や関心に関するリソース。

LifeEventSegment

ライブイベントのセグメント。

JSON 表現 
{
  "lifeEvent": string
}
フィールド
lifeEvent

string

ライフイベント リソース。

DetailedDemographicSegment

詳しいユーザー属性セグメントです。

JSON 表現 
{
  "detailedDemographic": string
}
フィールド
detailedDemographic

string

詳しいユーザー属性リソース。

CustomAudienceSegment

カスタム オーディエンス セグメントです。

JSON 表現 
{
  "customAudience": string
}
フィールド
customAudience

string

カスタム オーディエンス リソース。

AudienceExclusionDimension

オーディエンスから除外するユーザーを指定する除外ディメンション。

JSON 表現 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
フィールド
exclusions[]

object (ExclusionSegment)

除外するオーディエンス セグメント。

ExclusionSegment

オーディエンスから除外するオーディエンス セグメント。

JSON 表現 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
フィールド
共用体フィールド segment。除外するセグメント。segment は次のいずれかになります。
userList

object (UserListSegment)

除外するユーザーリスト セグメントです。

AudienceScope

オーディエンス スコープの有効な値を含む列挙型。

列挙型
UNSPECIFIED 範囲が指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。
CUSTOMER オーディエンスの対象範囲はお客様単位です。
ASSET_GROUP オーディエンスは、特定のアセット グループに属しています。