Method: customers.generateSuggestedTargetingInsights

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

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

HTTP リクエスト

POST https://googleads.googleapis.com/v15/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 でリーチ可能なユーザーのおおよその推定数です。