InsightsAudience

  • Insights can be requested for a set of users defined by various characteristics in AudienceInsightsService.

  • Audience definitions can include geographic locations at both the country and sub-country levels.

  • The audience can be refined by demographics such as gender, age ranges, parental status, and household income ranges.

  • User lists, YouTube content viewership (lineups), and combinations of entity, category, and user interest attributes can also be used to define the audience.

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

Fields

country_locations[]

LocationInfo

Required. The countries for the audience.

sub_country_locations[]

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 country_locations and no further.

gender

GenderInfo

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

age_ranges[]

AgeRangeInfo

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

parental_status

ParentalStatusInfo

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

income_ranges[]

IncomeRangeInfo

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

lineups[]

AudienceInsightsLineup

Lineups representing the YouTube content viewed by the audience.

user_list

UserListInfo

User list to be targeted by the audience.

topic_audience_combinations[]

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.