Audience

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

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

string

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

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

string (int64 format)

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

enum (AudienceStatus)

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

string

必須。オーディエンスの名前。すべてのオーディエンスに対して一意である必要があります。長さは 1 ～ 255 文字にする必要があります。
description

string

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

object (AudienceDimension)

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

object (AudienceExclusionDimension)

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

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)

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