- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- 試試看!
傳回代表感興趣目標對象的一系列屬性,並提供相關指標,比較各屬性在目標對象與基準目標對像中的佔比。
擲回錯誤清單:AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。客戶的 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "audience": { object ( |
欄位 | |
---|---|
audience |
必要欄位。要求取得其洞察資料的目標對象。 |
baselineAudience |
比較感興趣的目標對象的基準目標對象。 |
dataMonth |
用於深入分析的一個月歷來資料範圍,格式為「yyyy-mm」。如未設定,系統會傳回最近三十天的洞察資料。 |
dimensions[] |
必要欄位。要傳回樂曲洞察資料的目標對象維度。 |
customerInsightsGroup |
預定進行遷移的客戶名稱。這是使用者定義的值, |
回應主體
「AudienceInsightsService.GenerateAudienceCompositionInsights
」的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"sections": [
{
object ( |
欄位 | |
---|---|
sections[] |
深入分析報表的內容,已分門別類。每個區段都與要求的其中一個 AudienceInsightsDimensions 值相關聯。每個維度可能有多個區塊。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
AudienceCompositionSection
目標對象組成洞察報表中一系列相同類型的相關屬性。
JSON 表示法 |
---|
{ "dimension": enum ( |
欄位 | |
---|---|
dimension |
這個部分的屬性類型。 |
topAttributes[] |
與這個目標對象最相關的區隔。如果維度為 GENDER、AGE_RANGE 或 PARENTAL_STATUS,請參閱這份完整屬性清單。 |
clusteredAttributes[] |
這個目標對象的其他屬性 (分組為多個叢集)。只有在維度為「YOUTUBE_CHANNEL」時才會填入資料。 |
AudienceCompositionAttribute
包含中繼資料和指標的目標對象屬性。
JSON 表示法 |
---|
{ "attributeMetadata": { object ( |
欄位 | |
---|---|
attributeMetadata |
屬性和中繼資料。 |
metrics |
屬性的共用指標及建立索引。 |
AudienceCompositionMetrics
在目標對象組成深入分析報表中,與屬性相關聯的比重和索引指標。
JSON 表示法 |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
欄位 | |
---|---|
baselineAudienceShare |
符合屬性的基準目標對像比例 (含 0 到 1)。 |
audienceShare |
符合屬性的特定目標對像比例 (含 0 到 1)。 |
index |
AudienceShare 與 baselineAudienceShare 的比率。如果這個比率未定義或不具意義,則為 0。 |
score |
關聯性分數,從 0 到 1 (含 0 和 1)。 |
AudienceCompositionAttributeCluster
目標對象組成深入分析報表中的一組相關屬性,包括中繼資料和指標。
JSON 表示法 |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
欄位 | |
---|---|
clusterDisplayName |
這個屬性叢集的名稱 |
clusterMetrics |
如果與這個叢集相關聯的維度是 YOUTUBE_CHANNEL,則 clusterMetrics 是指與整個叢集相關聯的指標。其他維度則會設定這個欄位。 |
attributes[] |
構成這個叢集的個別屬性,包含中繼資料和指標。 |