InsightsAudience

A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService.

JSON representation
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
Fields
countryLocations[]

object (LocationInfo)

Required. The countries for the audience.

subCountryLocations[]

object (LocationInfo)

Sub-country geographic location attributes. If present, each of these must be contained in one of the countries in this audience. If absent, the audience is geographically to the countryLocations and no further.

gender

object (GenderInfo)

Gender for the audience. If absent, the audience does not restrict by gender.

ageRanges[]

object (AgeRangeInfo)

Age ranges for the audience. If absent, the audience represents all people over 18 that match the other attributes.

parentalStatus

object (ParentalStatusInfo)

Parental status for the audience. If absent, the audience does not restrict by parental status.

incomeRanges[]

object (IncomeRangeInfo)

Household income percentile ranges for the audience. If absent, the audience does not restrict by household income range.

dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Dynamic lineups representing the YouTube content viewed by the audience.

topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

A combination of entity, category and user interest attributes defining the audience. The combination has a logical AND-of-ORs structure: Attributes within each InsightsAudienceAttributeGroup are combined with OR, and the combinations themselves are combined together with AND. For example, the expression (Entity OR Affinity) AND (In-Market OR Category) can be formed using two InsightsAudienceAttributeGroups with two Attributes each.

InsightsAudienceAttributeGroup

A list of AudienceInsightsAttributes.

JSON representation
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Fields
attributes[]

object (AudienceInsightsAttribute)

Required. A collection of audience attributes to be combined with logical OR. Attributes need not all be the same dimension. Only Knowledge Graph entities, Product & Service Categories, and Affinity and In-Market audiences are supported in this context.