所有傳送至 AudienceInsightsService 的要求都有頻率限制。相較於其他目標對象洞察方法，generateAudienceCompositionInsights 和 generateSuggestedTargetingInsights 每天允許的要求次數較少。詳情請參閱「API 配額」。
AudienceInsightsService 可讓您將 Google 目標對象洞察資料整合至規劃工具。這項資料有助於媒體代理商和媒體企劃人員深入瞭解目標對象，包括客層、興趣和線上行為。
目標對象洞察提供概略總覽，協助您瞭解目標對象、類別、主題或品牌。分析相關主題的使用者行為，可運用這些目標對象洞察資料，找出消費者的關聯性及觀點，並發掘新的目標對象區隔。
這個 API 支援三種主要用途：
- 精細劃分並發掘目標對象：瞭解消費者的獨特興趣和行為，為品牌找出新的目標對象、建立目標對象輪廓，以及精細劃分目標對象區隔策略。
- 提供廣告活動規劃資訊：將資料輸出內容轉換為 YouTube 目標對象，以便規劃廣告活動、預估指定目標對象的潛在觸及率，以及評估目標對象區隔之間的重疊情形，盡可能提高廣告活動觸及率。
- 開發廣告素材訊息：根據目標對象最常互動的主題和興趣，量身打造廣告素材訊息。
資格規定
如要符合 AudienceInsightsService 的資格，合作夥伴必須符合下列條件：
- 目前有權使用 Insights Finder，或符合使用資格。
- 具備整合 API 的規劃工具或使用者介面。
- 將 API 用於媒體企劃或其他相關用途。
- 完成預先篩選評估。
- 遵守資料使用規定，並定期接受資料稽核。
- 接受 Google Ads API 服務條款和相關資料使用政策。
詳情請洽詢您的 Google 代表。
列出洞察資訊符合資格的日期
一般工作流程會先檢查哪些日曆月份和日期範圍可供分析。listInsightsEligibleDates 方法會傳回 ListInsightsEligibleDatesResponse，其 data_months 欄位會列出可取得目標對象洞察資料的月份 (格式為 YYYY-MM)。
如果要求中未設定 data_month，回應的 last_thirty_days 欄位會包含 generateAudienceCompositionInsights 使用的確切日期範圍。
列出目標對象洞察屬性
查詢目標對象組成或重疊指標前，請先使用 listAudienceInsightsAttributes 找出有效的屬性 ID。這個方法會傳回 ListAudienceInsightsAttributesResponse，其中包含所要求維度的可用屬性。
舉例來說，如果在要求中選取 AFFINITY_USER_INTEREST 做為維度，這個方法會傳回支援的興趣相似目標對象，例如「運動迷」或「音樂愛好者」。其他支援的使用者興趣維度包括 IN_MARKET_USER_INTEREST 和 LIFE_EVENT_USER_INTEREST。您可以在單一要求中設定多個維度。如需支援維度的完整清單，請參閱 dimensions 欄位參考資料。
使用 KNOWLEDGE_GRAPH 維度搜尋知識圖譜實體 (主題) 時，您必須在 query_text 欄位中提供字串查詢 (例如 "football and the World Cup")。
您可以視需要加入 knowledge_graph_entity_search_options，自訂主題搜尋：
- 依功能篩選：使用
search_filter，將擷取的實體縮小至僅支援特定功能的實體。舉例來說，您可以在entity_capability_filters欄位中提供CREATOR_ATTRIBUTE，篩選支援做為創作者屬性的主題。您可以提供多項功能，並以OR邏輯結合。 - 擷取所有創作者屬性：將
get_all_creator_attributes設為true，即可擷取所有標記為創作者屬性的可用知識圖譜實體。使用這個選項時，必須選取KNOWLEDGE_GRAPH維度，query_text必須留空，且無法與search_filter結合。
這個探索方法傳回的屬性，可做為其他 AudienceInsightsService 方法的輸入內容。
ListAudienceInsightsAttributesResponse 中的每個 AudienceInsightsAttributeMetadata 物件，都會提供目標對象屬性的結構化表示法，以及描述性屬性和參與度指標。包括屬性的主要定義、顯示名稱、維度類型和預估目標對象觸及數。如需欄位定義，請參閱 AudienceInsightsAttributeMetadata 參考資料。
生成目標對象定義
generateAudienceDefinition 方法會將目標對象的自由格式文字說明，轉譯為結構化目標對象屬性建議，您可以將這些建議傳遞至下游洞察方法。
生成建議指定目標洞察
generateSuggestedTargetingInsights 方法會傳回與所要求目標對象相關的指定目標洞察資料 (例如可指定的目標對象區隔) 集合。
您可以將要求的目標對象指定為結構化 InsightsAudienceDefinition，或 InsightsAudienceDescription 中的文字說明。
generateAudienceCompositionInsights 會傳回個別屬性區隔的洞察資料，generateSuggestedTargetingInsights 則會傳回可指定 Google Ads 目標對象區隔的組合建議。這個方法有助於回答「請提供可指定目標對象的建議，例如 30 多歲、喜歡釣魚的父親」等問題。
產生指定目標建議指標
generateTargetingSuggestionMetrics 方法會傳回 GenerateTargetingSuggestionMetricsResponse，其中包含 GenerateTargetingSuggestionMetricsRequest 中要求的每個目標對象定義，可能觸及的 YouTube 使用人口。
這個方法有助於回答以下問題：「在美國，YouTube 可觸及多少年滿 18 歲且對露營感興趣的男性？」
產生目標對象組成洞察
generateAudienceCompositionInsights 方法會傳回 GenerateAudienceCompositionInsightsResponse，其中包含代表所要求目標對象興趣的屬性清單，以及將每個屬性的目標對象比例與基準人口進行比較的指數和比例指標。
您必須為目標對象提供指定國家/地區。如要查看擷取組成洞察資料時支援的維度清單，請參閱 GenerateAudienceCompositionInsightsRequest 的 dimensions 欄位。
這個方法有助於回答以下問題：「與一般客群相比，我的目標對象最感興趣的興趣相似類別有哪些？他們與這些興趣相似類別互動的可能性有多高？」
生成目標對象重疊洞察
generateAudienceOverlapInsights 方法會傳回 GenerateAudienceOverlapInsightsResponse，其中包含目標對象屬性清單，以及這些屬性的潛在 YouTube 觸及與主要屬性重疊的估計值。
你必須提供指定國家/地區和主要屬性。年齡層、性別、興趣相似目標對象區隔和潛在買家區隔，都可做為目標對象維度。
這個方法有助於回答「如果我們同時指定美國的運動迷和音樂愛好者，目標對象規模會增加多少？」等問題。
產生 Insights Finder 報表
generateInsightsFinderReport 方法會根據 GenerateInsightsFinderReportRequest 中指定的輸入內容，在 Insights Finder 中建立已儲存的報表，並傳回 GenerateInsightsFinderReportResponse，其中包含可從外部存取的連結，用於在 Insights Finder UI 中開啟該報表。
Google Issue Tracker
您可以使用 Google Issue Tracker 提出支援問題、回報錯誤或提交功能要求。Google 會直接在 Issue Tracker 中追蹤、排定優先順序及發布要求更新。詳情請參閱「在 Google Issue Tracker 中建立問題」。
使用下列其中一個 Issue Tracker 範本建立問題：
請在範本的所有欄位中填寫詳細資訊，以便 Google 重現問題並優先處理您的要求。Google 可能會關閉不完整的報告，並要求您提交新問題，補上缺少的詳細資料。