Method: customers.recommendations.generate

リクエストされた recommendationTypes に基づいてレコメンデーションを生成します。

スローされるエラーのリスト: 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 の必須フィールドがすべてアップロードされると推奨事項が返されますが、それだけでは不十分な場合もあります。

最適化案の生成では、RecommendationType がサポートされています: 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)

省略可。現在のコンバージョン トラッキングのステータス。このフィールドは、recommendationTypes が 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)

省略可。キャンペーンの現在の入札情報。このフィールドは、recommendationTypes が 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)

リクエストされた RecommendationTypes のセットで渡された生成済みの最適化案のリスト。リクエストされた recommendationTypes の推奨事項を生成するのに十分なデータがない場合、そのタイプの推奨事項は結果セットに含まれません。

認可スコープ

次の 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)

現在の入札戦略。このフィールドは、RecommendationTypes の 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。（省略可）bid_strategy_type に関連する詳細。bidding_strategy_target_info は次のいずれかになります。
targetCpaMicros

string (int64 format)

現在の目標コンバージョン単価（マイクロ単位）。これは、入札戦略の種類が TARGET_CPA または MAXIMIZE_CONVERSIONS のキャンペーンに入力できます。
targetRoas

number

現在の targetRoas。これは、入札戦略のタイプが TARGET_ROAS または MAXIMIZE_CONVERSION_VALUE のキャンペーンに入力できます。

AdGroupInfo

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

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

object (KeywordInfo)

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

enum (AdGroupType)

省略可。広告グループの広告グループタイプ。このフィールドは、adGroupInfo が設定されている場合、recommendationsTypes で KEYWORD を指定する必要があります。

SeedInfo

キーワード シードと、キーワードを生成する特定の URL。

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

string

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

string

候補を生成する特定の URL（例: www.example.com/cars）。