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)
  },
  "leadFormAsset": {
    object (LeadFormAssetParameters)
  }
  // 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)

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

object (LeadFormAssetParameters)

リードフォーム アセットの最適化案を適用するときに使用するパラメータ。

{
  "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 ～ 1000.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 ～ 1000.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)

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

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  },
  "setSubmitLeadFormAssetCampaignGoal": boolean
}

object (AdAssetApplyParameters)

必須。追加するリードフォーム アセット。必須フィールドです。

boolean

true の場合、ターゲット キャンペーンに「リードフォームの送信」目標が設定されます。そのため、広告はリードフォーム クリエイティブ広告として表示されます。false の場合、キャンペーンに「リードフォームの送信」目標は設定されず、広告にリードフォーム アセットが含まれます。

{
  "resourceName": string
}

string

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