Method: customers.recommendations.generate

リクエストされた推奨事項タイプに基づいて推奨事項を生成します。

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customerId

string

必須。推奨事項を生成するお客様の ID。

リクエスト本文

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

JSON 表現 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
フィールド
recommendationTypes[]

enum (RecommendationType)

必須。生成対象となる RecommendationType のリスト。アップロードした条件では最適化案を作成するのに不十分な場合や、キャンペーンがすでに推奨状態になっている場合、そのタイプの最適化案は返されません。一般に、RecommendationType のすべての必須フィールドがアップロードされると、Recommendations が返されますが、それだけでは不十分な場合もあります。

最適化案の生成では、次の最適化案タイプがサポートされています: KEYWORD、MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、SITELINK_ASSET、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

必須。キャンペーンの広告チャネルのタイプ。レコメンデーションの生成では、次の advertisingChannelTypes: PERFORMANCE_MAX と SEARCH がサポートされています。
adGroupInfo[]

object (AdGroupInfo)

（省略可）現在の広告グループ情報。1 つの広告グループからの情報をサポートします。RecommendationTypes: KEYWORD の場合、このフィールドは省略できます
conversionTrackingStatus

enum (ConversionTrackingStatus)

（省略可）現在のコンバージョン トラッキングのステータスです。このフィールドは、次の最適化案タイプに必要です。タイプ: MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

（省略可）キャンペーンの現在の入札単価情報です。このフィールドは、次の最適化案タイプに必要です。タイプ: MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

（省略可）キーワードの基となる情報です。このフィールドは、recommendationTypes: KEYWORD に必要です。

レスポンスの本文

RecommendationService.GenerateRecommendations に対するレスポンス メッセージです。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
フィールド
recommendations[]

object (Recommendation)

渡されたリクエストされた推奨事項タイプのセットから生成された推奨事項のリスト。リクエストされたレコメンデーションの種類のレコメンデーションを生成するのに十分なデータがない場合、結果セットにそのタイプのレコメンデーションは含まれません。

承認スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 の概要をご覧ください。

BiddingInfo

キャンペーンの現在の入札単価情報です。最適化案を通知する入札関連のシグナルのラッパーを提供します。

JSON 表現 
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
フィールド
biddingStrategyType

enum (BiddingStrategyType)

現在の入札戦略です。このフィールドは、次の最適化案タイプに必要です。タイプ: MAXIMIZE_CLICKS_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
共用体フィールド bidding_strategy_target_info。Bidding_strategy_type に関連する詳細（省略可）。bidding_strategy_target_info は次のいずれかになります。
targetCpaMicros

string (int64 format)

現在の targetCpa（マイクロ秒単位）。この値は、入札戦略の種類が TARGET_CPA または MAXIMIZE_CONVERSIONS のキャンペーンで入力できます。
targetRoas

number

現在の目標広告費用対効果。この値は、入札戦略タイプが TARGET_ROAS または MAXIMIZE_CONVERSION_VALUE のキャンペーンに対して入力されます。

AdGroupInfo

キャンペーンの現在の広告グループ情報です。

JSON 表現 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
フィールド
keywords[]

object (KeywordInfo)

（省略可）現在のキーワード。adGroupInfo が設定されている場合、KEYWORD の recommendationTypes でこのフィールドは省略可能です。
adGroupType

enum (AdGroupType)

（省略可）広告グループの広告グループ タイプ。このフィールドは、adGroupInfo が設定されている場合の推奨事項タイプ KEYWORD に必要です。

SeedInfo

キーワードの生成元となるキーワードのシードと特定の URL。

JSON 表現 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
フィールド
keywordSeeds[]

string

（省略可）候補を生成するキーワードやフレーズ（例: 車、「近くの自動車ディーラー」）。
urlSeed

string

候補を生成する具体的な URL（例: www.example.com/cars）。