[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-05 (世界標準時間)。"],[],[],null,["# Audience insights\n\n| **Important:** This feature is only available to accounts on an allowlist. Contact your Google representative if you need access to this feature.\n|\n| All requests to\n| [`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService) are\n| rate-limited. However, fewer requests are allowed per day for\n| [`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\n| and\n| [`generateSuggestedTargetingInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateSuggestedTargetingInsights)\n| than for other Audience Insights methods. See documentation on\n| [Quota](/google-ads/api/docs/best-practices/quotas) for more details.\n\n[`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService) allows users\nto integrate Google audience insights data into their proprietary tools. The\ndata allows media agencies and media planners to gain a deeper understanding of\ntheir target audience, including demographics, interests, and online behavior.\n\nAudience insights allow users to quickly understand an audience, a category, a\ntopic or a brand by providing a high-level overview. By analyzing user\nbehaviors on related topics, customers can use these audience insights to\nilluminate the associations and perceptions that consumers have, to arrive at\nnew insights about their audiences.\n\nThe API has three main use cases:\n\n- **Refine and Uncover Audiences:** Understand consumers' unique interests and\n behaviors to identify new audiences for the brand, develop audience personas,\n and refine audience segmentation strategies.\n\n- **Inform Campaign Planning:** Translate data outputs into Youtube target\n audiences to plan against. Allows customers to identify potential reach of their\n targeted audiences to help them plan media campaigns. Enables customers to\n measure the overlap between audience segments to maximize the potential reach of\n their campaigns.\n\n- **Develop Creative Messages:** Tailor creative messages to your target\n audience after learning what they care about most.\n\nEligibility requirements\n------------------------\n\nTo be eligible for\n[`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService), partners\nmust satisfy the following conditions:\n\n- Existing access, or eligible for access, to [Insights Finder](https://ads.google.com/intl/en_us/home/tools/insights-finder/).\n- Have a planning tool or user interface that will integrate the API.\n- Use the API for media planning purposes, or for other relevant use cases.\n- Complete a pre-screen assessment.\n- Follow data usage requirements and be willing to undergo periodic data audits.\n- Sign a data-licensing agreement that legally enforces data usage requirements.\n- Accept the Google Ads API [terms of service](../../terms).\n\nContact your Google representative for more information.\n\nGenerate audience composition insights\n--------------------------------------\n\nThe\n[`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\nmethod returns a\n[`GenerateAudienceCompositionInsightsResponse`](/google-ads/api/reference/rpc/v21/GenerateAudienceCompositionInsightsResponse),\nwhich contains a list of attributes that represent the requested audience of\ninterest, with metrics that compare each attribute's share of the audience with\nits share of a baseline audience.\n\nYou must provide a target country for the audience. The list of supported\ndimensions for retrieving composition insights is enumerated at the `dimensions`\nfield description of the\n[`GenerateAudienceCompositionInsightsRequest`](/google-ads/api/reference/rpc/v21/GenerateAudienceCompositionInsightsRequest).\n\nThis method can help answer questions such as \"What are the top affinities my\ntarget audience is interested in compared to the general population and how\nmuch more likely are they interested in those affinities compared to the general\npopulation?\"\n\nGenerate audience overlap insights\n----------------------------------\n\nThe\n[`generateAudienceOverlapInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/generateAudienceOverlapInsights)\nmethod returns a\n[`GenerateAudienceOverlapInsightsResponse`](/google-ads/api/reference/rpc/v21/GenerateAudienceOverlapInsightsResponse)\nwhich contains a list\nof audience attributes with estimates of the overlap between their potential\nYoutube reach and that of a given primary attribute.\n\nYou must provide a target country and a primary attribute. Age range, gender,\naffinity segments, and in-market segments are supported as audience dimensions.\n\nThis method can help answer questions such as \"How large is the incremental\naudience size when we target both Sports Fans and Music Lovers in the United\nStates?\"\n\nGenerate insights finder report\n-------------------------------\n\nThe\n[`generateInsightsFinderReport`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateInsightsFinderReport)\nmethod creates a saved report in\n[Insights Finder](https://ads.google.com/intl/en_us/home/tools/insights-finder/)\nbased on the given inputs specified in the\n[`GenerateInsightsFinderReportRequest`](/google-ads/api/reference/rpc/v21/GenerateInsightsFinderReportRequest)\nand returns a\n[`GenerateInsightsFinderReportResponse`](/google-ads/api/reference/rpc/v21/GenerateInsightsFinderReportResponse)\ncontaining an externally accessible link to open that report in the Insights\nFinder User Interface.\n\nGenerate suggested targeting insights\n-------------------------------------\n\nThe\n[`generateSuggestedTargetingInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateSuggestedTargetingInsights)\nmethod returns a collection of targeting insights (e.g. targetable audiences)\nthat is relevant to the requested audience.\n\nThe requested audience may be in the form of either a structured format\n[`InsightsAudienceDefinition`](/google-ads/api/reference/rpc/v21/InsightsAudienceDefinition) or as a\ntext description\n[`InsightsAudienceDescription`](/google-ads/api/reference/rpc/v21/InsightsAudienceDescription).\n\nThe\n[`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\nmethod returns insights for relevant individual attribute segments while the\n[`generateSuggestedTargetingInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateSuggestedTargetingInsights)\nreturns suggestions and insights of targetable Google audience segments.\n\nThis method helps answer questions such as \"Give me targetable audience\nsuggestions for fathers in their 30s who enjoy fishing.\"\n\nGenerate targeting suggestion metrics\n-------------------------------------\n\nThe\n[`generateTargetingSuggestionMetrics`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateTargetingSuggestionMetrics)\nmethod returns a\n[`GenerateTargetingSuggestionMetricsResponse`](/google-ads/api/reference/rpc/v21/GenerateTargetingSuggestionMetricsResponse)\n, which contains the potential YouTube population that may be reached for each\naudience definition requested in the\n[`GenerateTargetingSuggestionMetricsRequest`](/google-ads/api/reference/rpc/v21/GenerateTargetingSuggestionMetricsRequest).\n\nThis method can help answer questions such as \"How many Men aged 18+ interested\nin Camping in the United States can be reached on YouTube?\"\n\nList audience insights attributes\n---------------------------------\n\nThe\n[`listAudienceInsightsAttributes`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/ListAudienceInsightsAttributes)\nmethod returns a\n[`ListAudienceInsightsAttributesResponse`](/google-ads/api/reference/rpc/v21/ListAudienceInsightsAttributesResponse)\nthat contains the list of available attributes for the requested dimensions.\n\nFor example, if Affinity User Interest is selected as a dimension in the\nrequest, it will give back a list of supported affinities such as \"Sports Fans\"\nor \"Music Lovers.\" You may set multiple dimensions for a single request.\n\nThe attributes returned by this discoverability feature can be used as inputs\nfor other [`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService)\nfeatures.\n\nList insights eligible dates\n----------------------------\n\nThe\n[`listInsightsEligibleDates`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/ListInsightsEligibleDates)\nmethod returns a\n[`ListInsightsEligibleDatesResponse`](/google-ads/api/reference/rpc/v21/ListInsightsEligibleDatesResponse)\n, which contains a list of months in the form \"YYYY-MM\", for which audience\ninsights data is available.\n\nThe response also contains the actual dates representing the \"last 30 days\"\nthat will be used for the\n[`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\nmethod, when the `date_month` is not set in the request."]]