GenerateAudienceCompositionInsightsRequest

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

  • The request requires the customer_id, the audience of interest, and the dimensions for which insights are desired.

  • An optional baseline_audience can be provided for comparison.

  • You can specify a historical data_month or get insights for the last thirty days.

  • Supported insight dimensions include KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, and various demographic and interest categories.

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.