Method: customers.generateSuggestedTargetingInsights

リクエストされたオーディエンスに関連するターゲティング分析情報（ターゲティング可能なオーディエンスなど）のコレクションを返します。

スローされるエラーのリスト: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
フィールド
audience

object (InsightsAudience)

必須。インサイトがリクエストされている関心のあるオーディエンス。
baselineAudience

object (InsightsAudience)

（省略可）ベースライン オーディエンス。指定しない場合、デフォルトでは、対象とするオーディエンスと同じ国に住むすべてのユーザーが対象になります。
dataMonth

string

（省略可）分析情報に使用する過去のデータの 1 か月範囲（「yyyy-mm」形式）。設定しない場合、過去 30 日間のデータに関する分析情報が返されます。
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

ベースライン オーディエンスのカバレッジに対するカバレッジの比率。この比率が定義されていない場合や意味がない場合はゼロ。
potentialYoutubeReach

string (int64 format)

このターゲティングを使用して YouTube でリーチ可能なユーザーのおおよその推定数。