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_BUDGET、FORECASTING_CAMPAIGN_BUDGET、MARGINAL_ROI_CAMPAIGN_BUDGET、MOVE_UNUSED_BUDGET の推奨事項タイプに設定されます。

campaignBudget

string

出力専用。この最適化案の対象となる予算。この値は、推奨事項が単一のキャンペーン予算に影響する場合にのみ設定されます。

このフィールドは、CAMPAIGN_BUDGET、FORECASTING_CAMPAIGN_BUDGET、MARGINAL_ROI_CAMPAIGN_BUDGET、MOVE_UNUSED_BUDGET の推奨事項タイプに設定されます。

campaign

string

出力専用。この最適化案の対象となるキャンペーン。

This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS, FORECASTING_SET_TARGET_CPA, SET_TARGET_CPA, SET_TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE_OPT_IN, IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN

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)

出力専用。最適化案: アカウントで動的画像表示オプションを有効にすると、Google が広告のランディング ページから最適な画像を見つけ出し、テキスト広告を補完できるようになります。

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)

出力専用。推奨クリック単価。

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)

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

理由

ショッピング キャンペーンで商品がターゲットに設定されない原因となる問題。

列挙型
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

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

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

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

出力専用。広告の有効性を改善するための最適化案のリスト。