Method: customers.generateSuggestedTargetingInsights

傳回與指定目標對象相關的一組指定目標深入分析 (例如可指定的目標對象)。

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

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

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

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

object (InsightsAudience)

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

object (InsightsAudience)

選用設定。基準目標對象。如果未指定，預設會使用與感興趣目標對象相同國家/地區的所有使用者。
dataMonth

string

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

string

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

回應主體

AudienceInsightsService.GenerateSuggestedTargetingInsights 的回應訊息。

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

JSON 表示法 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
欄位
suggestions[]

object (TargetingSuggestionMetrics)

針對可指定的目標對象提供的洞察建議。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

TargetingSuggestionMetrics

與廣告請求相關的建議目標對象。

JSON 表示法 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
欄位
locations[]

object (AudienceInsightsAttributeMetadata)

建議的指定地區。這些屬性都含有「GEO_TARGET_COUNTRY」或「SUB_COUNTRY_LOCATION」的維度
ageRanges[]

object (AgeRangeInfo)

建議的年齡指定目標；如果留空，表示未指定年齡。
gender

object (GenderInfo)

建議的性別指定目標。如果有的話，這項屬性就會包含維度「GENDER」。
userInterests[]

object (AudienceInsightsAttributeMetadata)

建議指定的目標對象區隔。這些屬性都具有「AFFINITY_USER_INTEREST」或「IN_MARKET_USER_INTEREST」維度
coverage

number

使用建議指定目標可觸及的廣告請求目標對像比例 (從 0 到 1，含首尾)。
index

number

涵蓋率與基準目標對象涵蓋率的比率，如果這個比例未定義或沒有意義，則為 0。
potentialYoutubeReach

string (int64 format)

使用這個指定目標在 YouTube 中可觸及的預估使用者人數。