Recommendation

推奨事項。

JSON 表現 
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  },
  "forecastingSetTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "maximizeConversionValueOptInRecommendation": {
    object (MaximizeConversionValueOptInRecommendation)
  },
  "improveGoogleTagCoverageRecommendation": {
    object (ImproveGoogleTagCoverageRecommendation)
  },
  "performanceMaxFinalUrlOptInRecommendation": {
    object (PerformanceMaxFinalUrlOptInRecommendation)
  },
  "refreshCustomerMatchListRecommendation": {
    object (RefreshCustomerMatchListRecommendation)
  },
  "customAudienceOptInRecommendation": {
    object (CustomAudienceOptInRecommendation)
  },
  "leadFormAssetRecommendation": {
    object (LeadFormAssetRecommendation)
  },
  "improveDemandGenAdStrengthRecommendation": {
    object (ImproveDemandGenAdStrengthRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
フィールド
resourceName

string

変更不可。推奨事項のリソース名。

customers/{customerId}/recommendations/{recommendation_id}
type

enum (RecommendationType)

出力のみ。推奨事項のタイプ。
impact

object (RecommendationImpact)

出力のみ。最適化案の適用がアカウントのパフォーマンスに及ぼす影響。
campaigns[]

string

出力のみ。この最適化案のターゲットとなっているキャンペーンです。

このフィールドは、最適化案の種類が CAMPAIGN_予算、FORECASTING_CAMPAIGN_budget、MARGINAL_ROI_CAMPAIGN_budget、MOVE_UNUSED_budget の場合に設定されます。
campaignBudget

string

出力のみ。この最適化案でターゲットとする予算。この値は、最適化案が 1 つのキャンペーン予算に影響する場合にのみ設定されます。

このフィールドは、次の最適化案タイプで設定されます: CAMPAIGN_予算、FORECASTING_CAMPAIGN_budget、MARGINAL_ROI_CAMPAIGN_budget、MOVE_UNUSED_budget
campaign

string

出力のみ。この最適化案のターゲットとなっているキャンペーン。

この項目は、次の最適化案の種類に設定されます: CALL_EXTENSION、CALLOUT_EXTENSION、OPC_EX_TARGETS、OPY_TARGET_LIMIT_TARGETS、OPC_LIMIT_TARGETS、OPYANCE_TARGET_LIMIT_TARGETS、OPYANCE_TARGET_TARGETS、OPC_LIMIT_TARGETS、OPC_TARGET_LIMIT_TARGETS、OPC_LIMIT_TARGETS、OPC_TARGET_LIMIT_TARGETS、OPC_TARGET_LIMIT_TARGETS、OPC_TARGETS、OPC_TARGET_LIMIT_TARGETS、
adGroup

string

出力のみ。この最適化案のターゲットとなっている広告グループ。これは、最適化案が 1 つの広告グループに影響する場合にのみ設定されます。

このフィールドは、最適化案の種類が KEYWORD、OPTIMIZE_AD_ROTATION、RESPONSIVE_SEARCH_AD、RESPONSIVE_SEARCH_AD_ASSET、TEXT_AD の場合に設定されます。
dismissed

boolean

出力のみ。推奨事項が拒否されるかどうか。
共用体フィールド recommendation。推奨事項の詳細。recommendation は次のいずれかになります。
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

出力のみ。キャンペーンの予算に関する最適化案。
forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

出力のみ。キャンペーン予算の予測に関する最適化案。
keywordRecommendation

object (KeywordRecommendation)

出力のみ。キーワードに関する最適化案。
textAdRecommendation

object (TextAdRecommendation)

出力のみ。拡張テキスト広告の追加に関する最適化案。
targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

出力のみ。「目標コンバージョン単価」の有効化に関する最適化案。
maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

出力のみ。「コンバージョン数の最大化」の最適化案。
enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

出力のみ。拡張クリック単価のオプトインの最適化案
searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

出力のみ。検索パートナーのオプトインに関する最適化案。
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

出力のみ。「クリック数の最大化」のオプトインの最適化案。
optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

出力のみ。広告のローテーションの最適化に関する最適化案。
keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

出力のみ。キーワードのマッチタイプに関する最適化案。
moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

出力のみ。未使用の予算を振り替える最適化案。
targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

出力のみ。「目標広告費用対効果」の有効化に関する最適化案。
responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

出力のみ。レスポンシブ検索広告の追加の最適化案。
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

出力のみ。限界費用対効果を重視したキャンペーン予算の推奨値です。
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

出力のみ。部分一致キーワードの使用に関する最適化案。
responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

出力のみ。レスポンシブ検索広告アセットの最適化案。
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

出力のみ。スマート ショッピング キャンペーンを P-MAX キャンペーンにアップグレードする最適化案。
responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

出力のみ。レスポンシブ検索広告により、広告の有効性に関する最適化案が改善される。
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

出力のみ。ディスプレイ ネットワーク対応の有効化に関する最適化案。
upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

出力のみ。ローカル キャンペーンを P-MAX キャンペーンにアップグレードする最適化案。
raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

出力のみ。目標コンバージョン単価の引き上げが低すぎる最適化案。
forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

出力のみ。予測に基づく目標広告費用対効果の最適化案。
calloutAssetRecommendation

object (CalloutAssetRecommendation)

出力のみ。コールアウト アセットの最適化案。
callAssetRecommendation

object (CallAssetRecommendation)

出力のみ。電話番号アセットの最適化案。
shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

出力のみ。ショッピング追加年齢層の最適化案。
shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

出力のみ。ショッピングの追加色に関する推奨事項。
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

出力のみ。ショッピングの追加の性別に関する最適化案。
shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

出力のみ。ショッピングの GTIN 追加に関する最適化案です。
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

出力のみ。ショッピング ID の追加に関する最適化案。
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

出力のみ。ショッピング広告の推奨サイズ。
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

出力のみ。ショッピング キャンペーンへの商品の追加に関する最適化案。
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

出力のみ。ショッピングの修正で不承認となった商品の最適化案です。
shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

出力のみ。ショッピング ターゲットのすべての商品の提案。
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

出力のみ。このショッピングの修正により、Merchant Center アカウントの最適化案が停止されました。
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

出力のみ。ショッピングの修正に関する Merchant Center アカウントの一時停止に関する警告の最適化案。
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

出力のみ。ショッピング キャンペーンによって、通常のショッピング キャンペーンの商品が P-MAX の最適化案に移行されます。
dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

出力のみ。アカウントで動的画像表示オプションを有効にすることをおすすめします。これにより、広告のランディング ページから最適な画像が検出され、テキスト広告を補完できます。
raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

出力のみ。目標コンバージョン単価を引き上げるための最適化案です。
lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

出力のみ。目標広告費用対効果を引き下げる最適化案。
performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

出力のみ。P-MAX のオプトインに関する最適化案。
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

出力のみ。P-MAX の広告の有効性に関する最適化案の改善。
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

出力のみ。動的検索広告から P-MAX への移行に関する最適化案。
forecastingSetTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

出力のみ。予測で設定された目標コンバージョン単価の最適化案。
setTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

出力のみ。目標コンバージョン単価を設定する最適化案。
setTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

出力のみ。目標広告費用対効果の設定に関する最適化案。
maximizeConversionValueOptInRecommendation

object (MaximizeConversionValueOptInRecommendation)

出力のみ。「コンバージョン値の最大化」の有効化に関する最適化案。
improveGoogleTagCoverageRecommendation

object (ImproveGoogleTagCoverageRecommendation)

出力のみ。より多くのページに Google タグを導入することをおすすめします。
performanceMaxFinalUrlOptInRecommendation

object (PerformanceMaxFinalUrlOptInRecommendation)

出力のみ。P-MAX キャンペーンで最終ページ URL の拡張機能を有効にすることが推奨されます。
refreshCustomerMatchListRecommendation

object (RefreshCustomerMatchListRecommendation)

出力のみ。顧客リストの更新に関する推奨事項。
customAudienceOptInRecommendation

object (CustomAudienceOptInRecommendation)

出力のみ。カスタム オーディエンスのオプトインに関する最適化案です。
leadFormAssetRecommendation

object (LeadFormAssetRecommendation)

出力のみ。リードフォーム アセットに関する最適化案。
improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

出力のみ。デマンド ジェネレーション広告の有効性を改善する最適化案

RecommendationImpact

最適化案で説明されている変更を行った場合の影響。最適化案の種類によっては、影響に関する情報が表示されない場合があります。

JSON 表現 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
フィールド
baseMetrics

object (RecommendationMetrics)

出力のみ。推奨事項が生成された時点の基本指標。
potentialMetrics

object (RecommendationMetrics)

出力のみ。最適化案が適用されている場合の推定指標。

RecommendationMetrics

アカウントのパフォーマンスに関する週次指標。最適化案の種類によっては、過去 90 日間の平均が算出されるため、小数値になることがあります。

JSON 表現 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionsValue": number,
  "videoViews": number
}
フィールド
impressions

number

出力のみ。広告のインプレッション数。
clicks

number

出力のみ。広告クリック数。
costMicros

string (int64 format)

出力のみ。広告費用（マイクロ単位）。アカウントの現地通貨で表します。
conversions

number

出力のみ。コンバージョン数。
conversionsValue

number

出力のみ。コンバージョンのコンバージョン値の合計。
videoViews

number

出力のみ。動画広告キャンペーンの動画再生回数です。

CampaignBudgetRecommendation

予算による制約を受けているキャンペーンの予算に関する最適化案。

JSON 表現 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
フィールド
budgetOptions[]

object (CampaignBudgetRecommendationOption)

出力のみ。可能な予算額の一部の値に対する、予算額とそれに関連する推定影響。
currentBudgetAmountMicros

string (int64 format)

出力のみ。現在の予算額（マイクロ秒単位）。
recommendedBudgetAmountMicros

string (int64 format)

出力のみ。推奨される予算額（マイクロ単位）。

CampaignBudgetRecommendationOption

指定した予算額で見込まれる効果。

JSON 表現 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
フィールド
impact

object (RecommendationImpact)

出力のみ。予算をこのオプションで指定された金額に変更した場合の影響の見積もり。
budgetAmountMicros

string (int64 format)

出力のみ。このオプションの予算額。

KeywordRecommendation

キーワードに関する最適化案。

JSON 表現 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
フィールド
keyword

object (KeywordInfo)

出力のみ。推奨されるキーワード。
searchTerms[]

object (SearchTerm)

出力のみ。このキーワードに一致する検索語句のリストです。同じ検索語句が複数のキーワードで繰り返される場合があります。
recommendedCpcBidMicros

string (int64 format)

出力のみ。推奨されるクリック単価（CPC）。

SearchTerm

キーワード候補に関連する検索語句の情報。

JSON 表現 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
フィールド
text

string

出力のみ。検索キーワードのテキスト。
estimatedWeeklySearchCount

string (int64 format)

出力のみ。この検索語句の週ごとの推定検索数です。

TextAdRecommendation

テキスト広告の最適化案。

JSON 表現 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
フィールド
ad

object (Ad)

出力のみ。おすすめの広告です。
creationDate

string

出力のみ。推奨された広告の作成日。YYYY-MM-DD 形式（例: 2018-04-17）。
autoApplyDate

string

出力のみ。日付（存在する場合）は、最適化案が自動適用される最も早い日付です。YYYY-MM-DD 形式（例: 2018-04-17）。

TargetCpaOptInRecommendation

「目標コンバージョン単価」オプトインの最適化案。

JSON 表現 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
フィールド
options[]

object (TargetCpaOptInRecommendationOption)

出力のみ。「目標コンバージョン単価」戦略で使用可能な目標とそれに対応するオプション。
recommendedTargetCpaMicros

string (int64 format)

出力のみ。推奨される平均コンバージョン単価の目標値です。必要な予算額と、この最適化案を使用した場合の影響をオプション リストで確認します。

TargetCpaOptInRecommendationOption

「目標コンバージョン単価」オプトイン オプションと影響の見積もり。

JSON 表現 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
フィールド
goal

enum (TargetCpaOptInRecommendationGoal)

出力のみ。このオプションで達成される目標。
impact

object (RecommendationImpact)

出力のみ。このオプションを選択した場合の推定影響。
targetCpaMicros

string (int64 format)

出力のみ。平均コンバージョン単価の目標値。
requiredCampaignBudgetAmountMicros

string (int64 format)

出力のみ。目標コンバージョン単価を達成するために必要なキャンペーンの最小予算（現地通貨）。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。

TargetCpaOptInRecommendationGoal

TargetCpaOptIn 推奨事項の目標。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SAME_COST 費用を一定に保つには、目標コンバージョン単価を設定することを推奨します。
SAME_CONVERSIONS 目標コンバージョン単価を設定して、同じコンバージョンを維持できるようにすることをおすすめします。
SAME_CPA 同じコンバージョン単価を維持するために目標コンバージョン単価を設定することを推奨。
CLOSEST_CPA 目標コンバージョン単価を、実際のコンバージョン単価（過去 28 日間で計算）にできるだけ近く、かつより低い値に設定することをおすすめします。

MaximizeConversionsOptInRecommendation

「コンバージョン数の最大化」のオプトインの最適化案。

JSON 表現 
{
  "recommendedBudgetAmountMicros": string
}
フィールド
recommendedBudgetAmountMicros

string (int64 format)

出力のみ。推奨される新しい予算額。

EnhancedCpcOptInRecommendation

このタイプにはフィールドがありません。

拡張クリック単価のオプトインの最適化案

SearchPartnersOptInRecommendation

このタイプにはフィールドがありません。

検索パートナーのオプトインに関する最適化案。

MaximizeClicksOptInRecommendation

「クリック数の最大化」オプトインの最適化案。

JSON 表現 
{
  "recommendedBudgetAmountMicros": string
}
フィールド
recommendedBudgetAmountMicros

string (int64 format)

出力のみ。推奨される新しい予算額。現在の予算が高すぎる場合にのみ設定します。

OptimizeAdRotationRecommendation

このタイプにはフィールドがありません。

広告のローテーションの最適化に関する最適化案。

KeywordMatchTypeRecommendation

キーワードのマッチタイプに関する最適化案。

JSON 表現 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
フィールド
keyword

object (KeywordInfo)

出力のみ。マッチタイプを広くする必要がある既存のキーワード。
recommendedMatchType

enum (KeywordMatchType)

出力のみ。推奨される新しいマッチタイプです。

MoveUnusedBudgetRecommendation

未使用の予算を振り替える最適化案。

JSON 表現 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
フィールド
budgetRecommendation

object (CampaignBudgetRecommendation)

出力のみ。予算による制約の引き上げに関する最適化案。
excessCampaignBudget

string

出力のみ。余剰予算の resourceName です。

TargetRoasOptInRecommendation

「目標広告費用対効果」の有効化に関する最適化案。

JSON 表現 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
フィールド
recommendedTargetRoas

number

出力のみ。推奨される目標広告費用対効果（費用単位あたりの収益）。値は 0.01 ～ 1000.0 です。
requiredCampaignBudgetAmountMicros

string (int64 format)

出力のみ。目標広告費用対効果を達成するために必要な、アカウントの最小キャンペーン予算（現地通貨）。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。

ResponsiveSearchAdRecommendation

レスポンシブ検索広告の追加の最適化案。

JSON 表現 
{
  "ad": {
    object (Ad)
  }
}
フィールド
ad

object (Ad)

出力のみ。おすすめの広告です。

UseBroadMatchKeywordRecommendation

部分一致キーワードの使用に関する最適化案。

JSON 表現 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
フィールド
keyword[]

object (KeywordInfo)

出力のみ。部分一致に拡張されるキーワードの例。
suggestedKeywordsCount

string (int64 format)

出力のみ。キャンペーンで部分一致に拡張するキーワードの合計数。
campaignKeywordsCount

string (int64 format)

出力のみ。キャンペーンのキーワードの合計数。
campaignUsesSharedBudget

boolean

出力のみ。関連付けられたキャンペーンで共有予算を使用しているかどうか。
requiredCampaignBudgetAmountMicros

string (int64 format)

出力のみ。最適化案の適用後に予算による制約を受けないようにするために推奨される予算です。

ResponsiveSearchAdAssetRecommendation

レスポンシブ検索広告アセットの追加に関する最適化案。

JSON 表現 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
フィールド
currentAd

object (Ad)

出力のみ。更新する現在の広告。
recommendedAssets

object (Ad)

出力のみ。推奨アセット。新しい広告見出しや説明文のみが自動的に入力され、それ以外の場合は空になります。

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

スマート ショッピング キャンペーンを P-MAX キャンペーンにアップグレードする最適化案。

JSON 表現 
{
  "merchantId": string,
  "salesCountryCode": string
}
フィールド
merchantId

string (int64 format)

出力のみ。Merchant Center アカウントの ID。
salesCountryCode

string

出力のみ。販売者の在庫の商品を含める国。

ResponsiveSearchAdImproveAdStrengthRecommendation

レスポンシブ検索広告により、広告の有効性に関する最適化案が改善される。

JSON 表現 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
フィールド
currentAd

object (Ad)

出力のみ。更新する現在の広告。
recommendedAd

object (Ad)

出力のみ。更新された広告。

DisplayExpansionOptInRecommendation

このタイプにはフィールドがありません。

ディスプレイ ネットワーク対応の有効化に関する最適化案。

UpgradeLocalCampaignToPerformanceMaxRecommendation

このタイプにはフィールドがありません。

「ローカル キャンペーンを P-MAX キャンペーンにアップグレードする」の最適化案。

RaiseTargetCpaBidTooLowRecommendation

目標コンバージョン単価の引き上げが低すぎる最適化案。

JSON 表現 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
フィールド
recommendedTargetMultiplier

number

出力のみ。1.0 より大きい数値は、目標コンバージョン単価の引き上げを推奨する係数を示します。
averageTargetCpaMicros

string (int64 format)

出力のみ。キャンペーンの現在の平均目標コンバージョン単価（マイクロ秒単位）。

ForecastingSetTargetRoasRecommendation

予測に基づく目標広告費用対効果の最適化案。

JSON 表現 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
フィールド
recommendedTargetRoas

number

出力のみ。推奨される目標広告費用対効果（費用単位あたりの収益）。値は 0.01 ～ 1000.0 です。
campaignBudget

object (CampaignBudget)

出力のみ。キャンペーンの予算

CampaignBudget

さまざまな予算の最適化案タイプ間で共有されるキャンペーン予算。

JSON 表現 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
フィールド
currentAmountMicros

string (int64 format)

出力のみ。現在の予算額。
recommendedNewAmountMicros

string (int64 format)

出力のみ。推奨予算額です。
newStartDate

string

出力のみ。新しい予算の使用が開始される日付。このフィールドは、最適化案の種類が FORECASTING_SET_TARGET_ROAS、FORECASTING_SET_TARGET_CPA、YYYY-MM-DD 形式（例: 2018-04-17）の場合に設定されます。

CalloutAssetRecommendation

コールアウト アセットの最適化案。

JSON 表現 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
フィールド
recommendedCampaignCalloutAssets[]

object (Asset)

出力のみ。キャンペーン単位で推奨される新しいコールアウト表示オプション アセット。
recommendedCustomerCalloutAssets[]

object (Asset)

出力のみ。新しいコールアウト表示オプションのアセットは、お客様単位で推奨されます。

SitelinkAssetRecommendation

サイトリンク アセットに関する最適化案です。

JSON 表現 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
フィールド

CallAssetRecommendation

このタイプにはフィールドがありません。

電話番号アセットの最適化案。

ShoppingOfferAttributeRecommendation

属性が指定されていないために降格された商品に属性を追加することを推奨するショッピングの推奨事項。

JSON 表現 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
フィールド
merchant

object (MerchantInfo)

出力のみ。Merchant Center アカウントの詳細。
feedLabel

string

出力のみ。キャンペーンのフィードラベル。
offersCount

string (int64 format)

出力のみ。オンラインで配信可能な商品の数。
demotedOffersCount

string (int64 format)

出力のみ。属性が指定されていないために降格された、オンラインで配信可能な商品の数。詳しくは Merchant Center をご覧ください。

MerchantInfo

Merchant Center アカウントの詳細。

JSON 表現 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
フィールド
id

string (int64 format)

出力のみ。Merchant Center アカウント ID。
name

string

出力のみ。Merchant Center アカウントの名前。
multiClient

boolean

出力のみ。Merchant Center アカウントがマルチクライアント アカウント（MCA）であるかどうか。

ShoppingAddProductsToCampaignRecommendation

ショッピング キャンペーンの広告枠に商品を追加するためのショッピングの最適化案。

JSON 表現 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
フィールド
merchant

object (MerchantInfo)

出力のみ。Merchant Center アカウントの詳細。
feedLabel

string

出力のみ。キャンペーンのフィードラベル。
reason

enum (Reason)

出力のみ。キャンペーンに商品が関連付けられていない理由。

理由

ショッピング キャンペーンで 1 個の商品をターゲットに設定する結果となる問題。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS この Merchant Center アカウントに登録済みの商品がありません。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED Merchant Center アカウントのフィード内に登録済みの商品がありません。
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Google 広告アカウントに有効なキャンペーン フィルタがあるため、キャンペーンに特典は含まれません。
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 掲載可能なすべての商品が、キャンペーンのターゲットから明示的に除外されています。

ShoppingFixDisapprovedProductsRecommendation

ショッピング キャンペーンの広告枠で不承認となった商品を修正するための、ショッピングの最適化案。

JSON 表現 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
フィールド
merchant

object (MerchantInfo)

出力のみ。Merchant Center アカウントの詳細。
feedLabel

string

出力のみ。キャンペーンのフィードラベル。
productsCount

string (int64 format)

出力のみ。キャンペーンの商品の数。
disapprovedProductsCount

string (int64 format)

出力のみ。不承認となったキャンペーンの商品の数。

ShoppingTargetAllOffersRecommendation

すべての商品をターゲットとする汎用のキャンペーンを作成することが推奨されるショッピング キャンペーン。

JSON 表現 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
フィールド
merchant

object (MerchantInfo)

出力のみ。Merchant Center アカウントの詳細。
untargetedOffersCount

string (int64 format)

出力のみ。ターゲット未設定の商品の数。
feedLabel

string

出力のみ。商品フィードのラベル。

ShoppingMerchantCenterAccountSuspensionRecommendation

Merchant Center アカウントの強制停止の問題を解決するためのショッピングの最適化案。

JSON 表現 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
フィールド
merchant

object (MerchantInfo)

出力のみ。Merchant Center アカウントの詳細。
feedLabel

string

出力のみ。強制停止が発生したキャンペーンのフィードラベル。

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

通常のショッピング キャンペーンのターゲットを絞った商品を P-MAX キャンペーンに移行するためのショッピングの最適化案です。

JSON 表現 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
フィールド
merchant

object (MerchantInfo)

出力のみ。Merchant Center アカウントの詳細。
feedLabel

string

出力のみ。この候補を共有するキャンペーンでターゲットとする商品のフィードラベル。

DynamicImageExtensionOptInRecommendation

このタイプにはフィールドがありません。

アカウントで動的画像表示オプションを有効にすることをおすすめします。これにより、広告のランディング ページから最適な画像が検出され、テキスト広告を補完できます。

RaiseTargetCpaRecommendation

目標コンバージョン単価を引き上げるための最適化案です。

JSON 表現 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
フィールド
targetAdjustment

object (TargetAdjustmentInfo)

出力のみ。推奨される目標値の調整を説明する関連情報。
appBiddingGoal

enum (AppBiddingGoal)

出力のみ。入札戦略の最適化の目標を表します。アプリ キャンペーンについてのみ入力されます。

TargetAdjustmentInfo

目標調整の最適化案の情報。

JSON 表現 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
フィールド
recommendedTargetMultiplier

number

出力のみ。推奨される目標値の調整係数。
currentAverageTargetMicros

string (int64 format)

出力のみ。この最適化案の対象となるキャンペーンまたはポートフォリオの現在の平均目標値。
sharedSet

string

出力のみ。目標が定義されているポートフォリオ入札戦略の共有設定リソース名。最適化案がポートフォリオ レベルの場合にのみ入力されます。

AppBiddingGoal

アプリ キャンペーンの入札戦略の最適化で重視する目標を表します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンの API では不明な値を表します。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME アプリ キャンペーンの入札戦略は、アプリのインストール数の最大化を目的としている必要があります。
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME アプリ キャンペーンの入札戦略は、選択したアプリ内コンバージョンの数を最大化することを目的としています。
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE アプリ キャンペーンの入札戦略は、すべてのコンバージョン（インストール コンバージョンと選択アプリ内コンバージョン）の価値を最大化することを目的としています。
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION アプリ キャンペーンの入札戦略は、選択したアプリ内コンバージョンの数を最大化しながら、目標アプリ内コンバージョン単価を達成するか上回ることを目標とする必要があります。
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND アプリ キャンペーンの入札戦略は、広告費用対効果の目標値を達成または超過しながら、すべてのコンバージョンの価値（インストールとアプリ内コンバージョン）を最大化することを目指します。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI アプリ キャンペーンの入札戦略では、広告主様が指定した目標インストール単価を設定せずに、アプリのインストール数を最大化することが目的です。
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME アプリ キャンペーンの入札戦略は、アプリの事前登録を最大化することを目的としています。

LowerTargetRoasRecommendation

目標広告費用対効果を引き下げる最適化案。

JSON 表現 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
フィールド
targetAdjustment

object (TargetAdjustmentInfo)

出力のみ。推奨される目標値の調整を説明する関連情報。

PerformanceMaxOptInRecommendation

このタイプにはフィールドがありません。

P-MAX のオプトインに関する最適化案。

ImprovePerformanceMaxAdStrengthRecommendation

P-MAX キャンペーンのアセット グループの有効性を「優良」の評価に改善するための最適化案。

JSON 表現 
{
  "assetGroup": string
}
フィールド
assetGroup

string

出力のみ。アセット グループのリソース名。

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

動的検索広告から P-MAX への移行に関する最適化案。

JSON 表現 
{
  "applyLink": string
}
フィールド

ForecastingSetTargetCpaRecommendation

目標コンバージョン単価を設定する最適化案。

JSON 表現 
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
フィールド
recommendedTargetCpaMicros

string (int64 format)

出力のみ。目標コンバージョン単価の推奨値です。
campaignBudget

object (CampaignBudget)

出力のみ。キャンペーンの予算

MaximizeConversionValueOptInRecommendation

このタイプにはフィールドがありません。

「コンバージョン値の最大化」入札戦略を有効にするための最適化案。

ImproveGoogleTagCoverageRecommendation

このタイプにはフィールドがありません。

より多くのページに Google タグを導入することをおすすめします。

PerformanceMaxFinalUrlOptInRecommendation

このタイプにはフィールドがありません。

P-MAX キャンペーンで最終ページ URL の拡張機能を有効にすることが推奨されます。

RefreshCustomerMatchListRecommendation

過去 90 日間更新されていない顧客リストの更新を推奨します。おすすめを受け取るお客様が、必ずしも所有者アカウントであるとは限りません。顧客リストは所有者アカウントで更新する必要があります。

JSON 表現 
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
フィールド
userListId

string (int64 format)

出力のみ。ユーザーリストの ID。
userListName

string

出力のみ。リストの名前。
daysSinceLastRefresh

string (int64 format)

出力のみ。最終更新からの日数。
topSpendingAccount[]

object (AccountInfo)

出力のみ。利用額が上位のアカウント。
targetingAccountsCount

string (int64 format)

出力のみ。所有者はユーザーリストを他のアカウントと共有できます。targetAccountsCount はターゲティングに使用できるアカウントの数です。
ownerAccount

object (AccountInfo)

出力のみ。所有者アカウント。このアカウントを使用して、顧客リストを更新します。

AccountInfo

Google 広告アカウントに関する情報のラッパー。

JSON 表現 
{
  "customerId": string,
  "descriptiveName": string
}
フィールド
customerId

string (int64 format)

出力のみ。アカウントのお客様 ID です。
descriptiveName

string

出力のみ。アカウントのわかりやすい名前。

CustomAudienceOptInRecommendation

カスタム オーディエンスのオプトインに関する最適化案。

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

object (KeywordInfo)

出力のみ。カスタム オーディエンスの作成に使用するキーワードのリスト。

LeadFormAssetRecommendation

このタイプにはフィールドがありません。

リードフォーム アセットに関する最適化案。

ImproveDemandGenAdStrengthRecommendation

デマンド ジェネレーション広告の有効性を改善する最適化案

JSON 表現 
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
フィールド
ad

string

出力のみ。改善の余地がある広告のリソース名。
adStrength

enum (AdStrength)

出力のみ。現在の広告の有効性。
demandGenAssetActionItems[]

string

出力のみ。広告の有効性を高めるための最適化案のリスト。