Method: customers.generateAudienceCompositionInsights

傳回對感興趣目標對象代表的一組屬性，並提供指標，比較每項屬性與基準目標對象的佔比。

擲回錯誤清單：AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 要求

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
欄位
audience

object (InsightsAudience)

必要欄位。要求取得洞察資料的目標對象。
baselineAudience

object (InsightsAudience)

興趣目標對像用來比較的基準目標對象。
dataMonth

string

要用於深入分析的一個月歷來資料範圍，格式為「yyyy-mm」。如未設定，系統會傳回過去三十天內資料的深入分析。
dimensions[]

enum (AudienceInsightsDimension)

必要欄位。應傳回組成洞察資料的目標對象維度。
customerInsightsGroup

string

要投放的客戶名稱。這是使用者定義的值。

回應主體

AudienceInsightsService.GenerateAudienceCompositionInsights 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
欄位
sections[]

object (AudienceCompositionSection)

「洞察」報表的內容，按不同部分分類。每個部分都會與請求中的其中一個 AudienceInsightsDimensions 值建立關聯。每個維度可能會有多個部分。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

AudienceCompositionSection

在目標對象組成洞察報表中，一組同類型的相關屬性。

JSON 表示法 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
欄位
dimension

enum (AudienceInsightsDimension)

這個部分的屬性類型。
topAttributes[]

object (AudienceCompositionAttribute)

與這個目標對象最相關的區隔。如果維度是「GENDER」、「AGE_RANGE」或「PARENTAL_STATUS」，這份屬性清單會列出完整屬性。
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

這個目標對象的其他屬性，分組為叢集。只有在維度為「YOUTUBE_CHANNEL」時，才會填入資料。

AudienceCompositionAttribute

包含中繼資料和指標的目標對象屬性。

JSON 表示法 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
欄位
attributeMetadata

object (AudienceInsightsAttributeMetadata)

屬性及其中繼資料。
metrics

object (AudienceCompositionMetrics)

屬性的共用及索引指標。

AudienceCompositionMetrics

在目標對象組成洞察報表中，與屬性相關聯的比重和指數指標。

JSON 表示法 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
欄位
baselineAudienceShare

number

與屬性相符的基準目標對象分數 (從 0 到 1，含 1)。
audienceShare

number

與屬性相符的特定目標對象分數 (從 0 到 1，含首尾)。
index

number

目標對像比重與基準目標對象共用的比率；如果這個比例未定義或沒有意義，則為零。
score

number

關聯性分數以 0 到 1 (包括 0 和 1)。

AudienceCompositionAttributeCluster

目標對象組成洞察報表中的相關屬性集合 (包含中繼資料和指標)。

JSON 表示法 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
欄位
clusterDisplayName

string

這個屬性叢集的名稱
clusterMetrics

object (AudienceCompositionMetrics)

如果與這個叢集相關聯的維度為 YOUTUBE_CHANNEL，則 clusterMetrics 是與整個叢集相關的指標。在其他維度中，系統不會設定這個欄位。
attributes[]

object (AudienceCompositionAttribute)

組成這個叢集的個別屬性，包含中繼資料和指標。