GenerateAudienceCompositionInsightsRequest

  • The request message for AudienceInsightsService.GenerateAudienceCompositionInsights requires a customer_id, an audience of interest, and the dimensions for which composition insights should be returned.

  • An optional baseline_audience can be provided for comparison purposes.

  • The data_month can be specified to use historical data from a particular month, otherwise, the last thirty days of data are used.

  • A customer_insights_group name can be provided as a user-defined value.

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_DYNAMIC_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.