GenerateAudienceCompositionInsightsRequest

  • The GenerateAudienceCompositionInsights request message is used to obtain insights about an audience.

  • This request requires specifying the customer ID, the audience of interest, and the dimensions for which insights are desired.

  • An optional baseline audience can be provided for comparison.

  • The timeframe for the historical data used for insights can be specified with the data_month field.

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.