InsightsAudience

さまざまな特性によって定義されたユーザーの集合。AudienceInsightsService で分析情報をリクエストできます。

JSON 表現
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
フィールド
countryLocations[]

object (LocationInfo)

必須。オーディエンスの国。

subCountryLocations[]

object (LocationInfo)

国の地理的位置属性。指定する場合は、それぞれがこのオーディエンスのいずれかの国に含まれている必要があります。指定されていない場合、オーディエンスは countryLocations の地理的位置に含まれ、それ以上はありません。

gender

object (GenderInfo)

オーディエンスの性別。指定しない場合、オーディエンスは性別による制限を受けません。

ageRanges[]

object (AgeRangeInfo)

オーディエンスの年齢層。オーディエンスが存在しない場合、オーディエンスは他の属性に一致する 18 歳以上のすべてのユーザーを表します。

parentalStatus

object (ParentalStatusInfo)

オーディエンスの子供の有無。指定されていない場合、オーディエンスは子供の有無による制限を受けません。

incomeRanges[]

object (IncomeRangeInfo)

オーディエンスの世帯収入のパーセンタイル範囲。指定されていない場合、オーディエンスは世帯収入の範囲による制限を受けません。

dynamicLineups[]

object (AudienceInsightsDynamicLineup)

視聴者が視聴した YouTube コンテンツを表す動的ラインナップ。

topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

エンティティ、カテゴリ、興味 / 関心の各属性の組み合わせで、オーディエンスを定義します。その組み合わせは AND 論理演算子(OR)の構造になっています。つまり、各 InsightsAudienceAttributeGroup 内の属性は OR で結合され、組み合わせ自体は AND で結合されます。たとえば、(Entity OR Affinity) AND (In-Market OR Category) の式は、それぞれ 2 つの属性を含む 2 つの InsightsAudienceAttributeGroups を使用して形成できます。

InsightsAudienceAttributeGroup

AudienceInsightsAttributes のリスト。

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

object (AudienceInsightsAttribute)

必須。論理 OR で結合して組み合わせたオーディエンス属性のコレクションです。すべての属性が同じディメンションである必要はありません。ここでは、ナレッジグラフ エンティティ、商品とサービスのカテゴリ、アフィニティと購買意向の強いオーディエンスのみがサポートされます。