Method: customers.generateAudienceOverlapInsights

傳回目標對象屬性集合，以及預估 YouTube 潛在觸及數與指定輸入屬性之間的重疊部分。

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

HTTP 要求

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

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

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

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

JSON 表示法 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
欄位
countryLocation

object (LocationInfo)

必要欄位。計算目標對象規模和重疊的國家/地區。
primaryAttribute

object (AudienceInsightsAttribute)

必要欄位。應與所有其他符合資格的目標對象交集的目標對象屬性。必須是興趣相似目標對象或潛在目標消費者、年齡範圍或性別。
dimensions[]

enum (AudienceInsightsDimension)

必要欄位。系統會計算與 primaryAttribute 重疊的屬性類型。值必須是 AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST、AGE_RANGE 和 GENDER 的子集。
customerInsightsGroup

string

要規劃的客戶名稱。這是使用者定義的值。

回應主體

AudienceInsightsService.GenerateAudienceOverlapInsights 的回應訊息。

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

JSON 表示法 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
欄位
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

主要屬性中繼資料，包括 YouTube 潛在觸及數。
dimensionResults[]

object (DimensionOverlapResult)

屬性及其與主要屬性重疊的清單，每個要求的維度都會有一份清單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

DimensionOverlapResult

單一維度的目標對象屬性清單 (包括與主要屬性重疊的屬性)，會以 GenerateAudienceOverlapInsightsResponse 的一部分傳回。

JSON 表示法 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
欄位
dimension

enum (AudienceInsightsDimension)

這個部分中所有屬性的維度。
items[]

object (AudienceOverlapItem)

屬性和與主要屬性重疊的屬性。

AudienceOverlapItem

目標對象屬性，其中包含中繼資料，包括這個屬性在 YouTube 上的潛在觸及數與主要屬性在 YouTube 上的潛在觸及數之間的重疊部分。

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

object (AudienceInsightsAttributeMetadata)

屬性及其中繼資料，包括 YouTube 潛在觸及數。
potentialYoutubeReachIntersection

string (int64 format)

這個目標對象屬性與主要屬性的交集估計人數，是指同時符合主要屬性與這個屬性的 YouTube 可觸及使用者人數。