目標對象深入分析
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
AudienceInsightsService
可讓使用者將 Google 目標對象洞察資料整合至專屬工具。媒體代理商和媒體企劃人員可透過這項資料,深入瞭解目標對象的受眾特徵、興趣和線上行為。
目標對象洞察可提供高層級的概覽資訊,讓使用者快速瞭解目標對象、類別、主題或品牌。透過分析相關主題的使用者行為,客戶可以運用這些目標對象洞察資料,描繪出消費者的關聯性及觀點,進而得到有關目標對象的全新洞察。
這項 API 的主要用途有三種:
發掘及調整目標對象:瞭解消費者的獨特興趣和行為,找出品牌的新目標對象、建立目標對象輪廓,並調整目標對象區隔策略。
提供廣告活動規劃資訊:將資料輸出結果轉換為 YouTube 目標對象,以利規劃。讓顧客瞭解目標對象的潛在觸及人數,協助他們規劃媒體廣告活動。協助顧客評估目標對象區隔的重疊程度,盡可能擴大廣告活動的潛在觸及範圍。
開發廣告素材訊息:瞭解目標對象最重視的內容後,為他們量身打造廣告素材訊息。
資格規定
如要符合 AudienceInsightsService
資格,合作夥伴必須符合下列條件:
- 具備或符合資格可存取 Insights Finder。
- 擁有可整合 API 的規劃工具或使用者介面。
- 將 API 用於媒體企劃,或用於其他相關用途。
- 完成前測評估。
- 遵守資料使用規定,並願意接受定期資料稽核。
- 簽署資料授權協議,確保資料使用符合法律規定。
- 接受 Google Ads API 服務條款。
詳情請洽詢您的 Google 代表。
產生目標對象組成洞察
generateAudienceCompositionInsights
方法會傳回 GenerateAudienceCompositionInsightsResponse
,其中包含代表所要求目標對象興趣的屬性清單,以及比較每個屬性在目標對象和基準目標對象中所占比例的指標。
您必須提供目標對象的目標國家/地區。如要擷取組合洞察資料,請參閱 GenerateAudienceCompositionInsightsRequest
的 dimensions
欄位說明,瞭解支援的維度清單。
這個方法有助於解答下列問題:「與一般大眾相比,目標對象最感興趣的興趣相似目標對象有哪些?與一般大眾相比,目標對象對這些興趣相似目標對象感興趣的機率高出多少?」
產生目標對象重疊洞察
generateAudienceOverlapInsights
方法會傳回 GenerateAudienceOverlapInsightsResponse
,其中包含目標對象屬性清單,以及這些屬性在潛在 YouTube 觸及人數方面,與指定主要屬性重疊的預估值。
你必須提供目標國家/地區和主要屬性。系統支援年齡層、性別、興趣相似目標對象區隔和潛在買家區隔,做為目標對象維度。
這個方法可協助解答「在美國同時指定運動迷和樂迷時,目標對象規模的增量有多大?」等問題。
產生洞察搜尋器報表
generateInsightsFinderReport
方法會根據 GenerateInsightsFinderReportRequest
中指定的輸入內容,在 Insights Finder 中建立已儲存的報表,並傳回 GenerateInsightsFinderReportResponse
,其中包含可從外部存取的連結,用於在 Insights Finder 使用者介面中開啟該報表。
生成建議的指定目標洞察資料
generateSuggestedTargetingInsights
方法會傳回與所要求目標對象相關的一系列指定目標洞察資料 (例如可指定目標對象)。
要求的目標對象可以是結構化格式 InsightsAudienceDefinition
,也可以是文字說明 InsightsAudienceDescription
。
generateAudienceCompositionInsights
方法會傳回相關個別屬性區隔的洞察資料,而 generateSuggestedTargetingInsights
則會傳回可指定目標的 Google 目標對象區隔建議和洞察資料。
這個方法有助於回答「請提供可指定目標對象的建議,對象是 30 多歲且喜歡釣魚的父親」等問題。
產生指定目標建議指標
generateTargetingSuggestionMetrics
方法會傳回 GenerateTargetingSuggestionMetricsResponse
,其中包含在 GenerateTargetingSuggestionMetricsRequest
中要求的每個目標對象定義,可能觸及的 YouTube 人口。
這項方法可協助解答「在 YouTube 上,我能觸及多少位年滿 18 歲且對美國露營有興趣的男性?」等問題。
列出目標對象洞察屬性
listAudienceInsightsAttributes
方法會傳回 ListAudienceInsightsAttributesResponse
,其中包含所要求維度的可用屬性清單。
舉例來說,如果在要求中選取「興趣相似使用者興趣」做為維度,系統就會傳回支援的興趣相似目標對象清單,例如「運動迷」或「音樂愛好者」。您可以為單一要求設定多個維度。
這項探索功能傳回的屬性可做為其他 AudienceInsightsService
功能的輸入內容。
列出符合深入分析資格的日期
listInsightsEligibleDates
方法會傳回 ListInsightsEligibleDatesResponse
,其中包含「YYYY-MM」格式的月份清單,列出可用的目標對象洞察資料。
如果要求中未設定 date_month
,回應也會包含代表「過去 30 天」的實際日期,這些日期將用於 generateAudienceCompositionInsights
方法。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-27 (世界標準時間)。
[null,null,["上次更新時間:2025-08-27 (世界標準時間)。"],[],[],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."]]