GenerateAudienceCompositionInsightsRequest

  • This is the request message for the AudienceInsightsService.GenerateAudienceCompositionInsights method.

  • Required fields include customer_id, the audience of interest, and the dimensions for which insights are requested.

  • An optional baseline_audience can be provided for comparison.

  • The data_month field allows specifying a historical month for insights, defaulting to the last thirty days if unset.

  • Supported dimensions for composition insights are listed and include knowledge graph, geo targets, YouTube, user interests, parental status, income range, age range, and gender.

Request message for AudienceInsightsService.GenerateAudienceCompositionInsights.

Fields

customer_id

string

Required. The ID of the customer.

audience

InsightsAudience

Required. The audience of interest for which insights are being requested.

baseline_audience

InsightsAudience

The baseline audience to which the audience of interest is being compared.

data_month

string

The one-month range of historical data to use for insights, in the format "yyyy-mm". If unset, insights will be returned for the last thirty days of data.

dimensions[]

AudienceInsightsDimension

Required. The audience dimensions for which composition insights should be returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, PARENTAL_STATUS, INCOME_RANGE, AGE_RANGE, and GENDER.

customer_insights_group

string

The name of the customer being planned for. This is a user-defined value.

insights_application_info

AdditionalApplicationInfo

Optional. Additional information on the application issuing the request.