Method: customers.recommendations.apply

string

必須。推奨事項があるお客様の ID。

{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  },
  "forecastingSetTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  }
  // End of list of possible types for union field apply_parameters.
}

string

適用する推奨事項のリソース名。

object (CampaignBudgetParameters)

キャンペーン予算の最適化案を適用するときに使用するパラメータ（省略可）。

object (TextAdParameters)

テキスト広告の最適化案を適用するときに使用するオプションのパラメータ。

object (KeywordParameters)

キーワードの最適化案を適用する際に使用するパラメータ（省略可）です。

object (TargetCpaOptInParameters)

目標コンバージョン単価のオプトインの最適化案を適用するときに使用するオプションのパラメータ。

object (TargetRoasOptInParameters)

目標広告費用対効果のオプトインの最適化案を適用するときに使用する省略可能なパラメータ。

object (CalloutExtensionParameters)

コールアウト表示オプションの最適化案を適用するときに使用するパラメータです。

object (CallExtensionParameters)

電話番号表示オプションの最適化案を適用する際に使用するパラメータです。

object (SitelinkExtensionParameters)

サイトリンクの最適化案を適用する際に使用するパラメータ。

object (MoveUnusedBudgetParameters)

未使用の予算の最適化案を適用するときに使用するパラメータ。

object (ResponsiveSearchAdParameters)

レスポンシブ検索広告の最適化案を適用する際に使用するパラメータ。

object (UseBroadMatchKeywordParameters)

部分一致キーワードの最適化案を適用するときに使用するパラメータ。

object (ResponsiveSearchAdAssetParameters)

レスポンシブ検索広告アセットの最適化案を適用する際に使用するパラメータ。

object (ResponsiveSearchAdImproveAdStrengthParameters)

レスポンシブ検索広告の適用時に使用するパラメータにより、広告の有効性に関する最適化案が改善されます。

object (RaiseTargetCpaBidTooLowParameters)

目標コンバージョン単価の引き上げを適用する際の推奨パラメータが低すぎます。適用は非同期で、関連するキャンペーン内の広告グループの数に応じて数分かかる場合があります。

object (ForecastingSetTargetRoasParameters)

予測セットの目標広告費用対効果の最適化案を適用するときに使用するパラメータ。

object (CalloutAssetParameters)

コールアウト アセットの最適化案を適用する際に使用するパラメータです。

object (CallAssetParameters)

電話番号アセットの最適化案を適用するときに使用するパラメータです。

object (SitelinkAssetParameters)

サイトリンク アセットの最適化案を適用する際に使用するパラメータです。

object (RaiseTargetCpaParameters)

目標コンバージョン単価の引き上げの最適化案を適用するときに使用するパラメータ。

object (LowerTargetRoasParameters)

目標広告費用対効果を引き下げる最適化案を適用するときに使用するパラメータ。

object (ForecastingSetTargetCpaParameters)

予測設定の目標コンバージョン単価の最適化案を適用する際に使用するパラメータ。

object (ForecastingSetTargetCpaParameters)

目標コンバージョン単価の最適化案を適用するときに使用するパラメータです。

object (ForecastingSetTargetRoasParameters)

目標広告費用対効果の設定の最適化案を適用するときに使用するパラメータです。

{
  "newBudgetAmountMicros": string
}

string (int64 format)

ターゲット予算リソースに設定する新しい予算額。これは必須項目です。

{
  "ad": {
    object (Ad)
  }
}

object (Ad)

推奨される広告グループに追加する新しい広告です。このメッセージには、すべての必須項目を設定する必要があります。これは必須項目です。

{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}

enum (KeywordMatchType)

キーワードのマッチタイプです。これは必須項目です。

string

キーワードの追加先の広告グループのリソース。これは必須項目です。

string (int64 format)

（省略可）キーワードに設定するクリック単価。設定しない場合、キーワードでは、ターゲットの広告グループで使用されている入札戦略に基づく入札単価が使用されます。

{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}

string (int64 format)

「目標コンバージョン単価」入札戦略で使用する平均コンバージョン単価です。これは必須項目です。

string (int64 format)

（省略可）キャンペーンに設定する予算額。

{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}

number

「目標広告費用対効果」入札戦略で使用する平均広告費用対効果（費用単位収益）。値は 0.01 ～ 1, 000.0 です。newCampaignBudgetAmountMicros が設定されていない限り、この項目は必須項目です。

string (int64 format)

（省略可）キャンペーンに設定する予算額。

{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}

object (CalloutFeedItem)

コールアウト表示オプションを追加します。これは必須項目です。

{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}

object (CallFeedItem)

追加する電話番号表示オプション。これは必須項目です。

{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}

object (SitelinkFeedItem)

追加するサイトリンク。これは必須項目です。

{
  "budgetMicrosToMove": string
}

string (int64 format)

「超過予算」から「制限予算」に移行するための予算額。これは必須項目です。

{
  "ad": {
    object (Ad)
  }
}

object (Ad)

必須。推奨される広告グループに追加する新しい広告です。

{
  "newBudgetAmountMicros": string
}

string (int64 format)

ターゲット予算リソースに設定する新しい予算額。

{
  "updatedAd": {
    object (Ad)
  }
}

object (Ad)

広告を更新しました。現在の広告のコンテンツが置き換えられます。

{
  "updatedAd": {
    object (Ad)
  }
}

object (Ad)

広告を更新しました。現在の広告のコンテンツが置き換えられます。

{
  "targetMultiplier": number
}

number

必須。1.0 より大きい数値は、目標コンバージョン単価を引き上げる要因を示します。これは必須項目です。

{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}

number

キャンペーン リソースに設定する新しい目標広告費用対効果（費用単位収益）。値は 0.01 ～ 1, 000.0 です。

string (int64 format)

キャンペーン リソースに設定する新しいキャンペーン予算の金額。

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}

object (AdAssetApplyParameters)

必須。追加するコールアウト アセットです。これは必須項目です。

{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}

object (Asset)

作成してスコープに関連付けるアセット。同じ呼び出しで既存の Assets と組み合わせることもできます。

string

スコープに関連付ける既存のアセットのリソース名。この値は、同じ呼び出しで newAssets と組み合わせることができます。

enum (ApplyScope)

必須。アセットを適用する範囲。キャンペーン スコープ単位のアセットは、最適化案が関連付けられているキャンペーンに適用されます。お客様側のアセットは、アカウント全体に適用されます。キャンペーン対象のアセットは、お客様スコープに関連付けられたアセットよりも優先されます。

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}

object (AdAssetApplyParameters)

必須。追加する電話番号アセットです。これは必須項目です。

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}

object (AdAssetApplyParameters)

必須。追加するサイトリンク アセットです。これは必須項目です。

{
  "targetCpaMultiplier": number
}

number

必須。コンバージョン単価の乗数を設定する目標値です。これは必須項目です。

{
  "targetRoasMultiplier": number
}

number

必須。広告費用対効果の乗数を設定する目標値です。これは必須項目です。

{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}

string (int64 format)

「目標コンバージョン単価」入札戦略で使用する平均コンバージョン単価です。

string (int64 format)

キャンペーン リソースに設定する新しいキャンペーン予算の金額。

{
  "resourceName": string
}

string

適用が成功した場合に返されます。