Recommendation

A recommendation.

JSON representation
{
  "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.
}
Fields
resourceName

string

Immutable. The resource name of the recommendation.

customers/{customerId}/recommendations/{recommendation_id}

type

enum (RecommendationType)

Output only. The type of recommendation.

impact

object (RecommendationImpact)

Output only. The impact on account performance as a result of applying the recommendation.

campaigns[]

string

Output only. The campaigns targeted by this recommendation.

This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET and MOVE_UNUSED_BUDGET

campaignBudget

string

Output only. The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget.

This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET

campaign

string

Output only. The campaign targeted by this recommendation.

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

Output only. The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group.

This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD

dismissed

boolean

Output only. Whether the recommendation is dismissed or not.

Union field recommendation. The details of recommendation. recommendation can be only one of the following:
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Output only. The campaign budget recommendation.

forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Output only. The forecasting campaign budget recommendation.

keywordRecommendation

object (KeywordRecommendation)

Output only. The keyword recommendation.

textAdRecommendation

object (TextAdRecommendation)

Output only. Add expanded text ad recommendation.

targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

Output only. The TargetCPA opt-in recommendation.

maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

Output only. The MaximizeConversions Opt-In recommendation.

enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

Output only. The Enhanced Cost-Per-Click Opt-In recommendation.

searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

Output only. The Search Partners Opt-In recommendation.

maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

Output only. The MaximizeClicks Opt-In recommendation.

optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

Output only. The Optimize Ad Rotation recommendation.

keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

Output only. The keyword match type recommendation.

moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

Output only. The move unused budget recommendation.

targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

Output only. The Target ROAS opt-in recommendation.

responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

Output only. The add responsive search ad recommendation.

marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Output only. The marginal ROI campaign budget recommendation.

useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

Output only. The use broad match keyword recommendation.

responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

Output only. The responsive search ad asset recommendation.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.

responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

Output only. The responsive search ad improve ad strength recommendation.

displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

Output only. The Display Expansion opt-in recommendation.

upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

Output only. The upgrade a Local campaign to a Performance Max campaign recommendation.

raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

Output only. The raise target CPA bid too low recommendation.

forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Output only. The forecasting set target ROAS recommendation.

calloutAssetRecommendation

object (CalloutAssetRecommendation)

Output only. The callout asset recommendation.

callAssetRecommendation

object (CallAssetRecommendation)

Output only. The call asset recommendation.

shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

Output only. The shopping add age group recommendation.

shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

Output only. The shopping add color recommendation.

shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

Output only. The shopping add gender recommendation.

shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

Output only. The shopping add GTIN recommendation.

shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

Output only. The shopping add more identifiers recommendation.

shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

Output only. The shopping add size recommendation.

shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

Output only. The shopping add products to campaign recommendation.

shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

Output only. The shopping fix disapproved products recommendation.

shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

Output only. The shopping target all offers recommendation.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Output only. The shopping fix suspended Merchant Center account recommendation.

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Output only. The shopping fix Merchant Center account suspension warning recommendation.

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

Output only. The shopping migrate Regular Shopping Campaign offers to Performance Max recommendation.

dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

Output only. Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.

raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

Output only. Recommendation to raise Target CPA.

lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

Output only. Recommendation to lower Target ROAS.

performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

Output only. The Performance Max Opt In recommendation.

improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

Output only. The improve Performance Max ad strength recommendation.

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

Output only. The Dynamic Search Ads to Performance Max migration recommendation.

forecastingSetTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

Output only. The forecasting set target CPA recommendation.

setTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

Output only. The set target CPA recommendation.

setTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Output only. The set target ROAS recommendation.

maximizeConversionValueOptInRecommendation

object (MaximizeConversionValueOptInRecommendation)

Output only. The Maximize Conversion Value opt-in recommendation.

improveGoogleTagCoverageRecommendation

object (ImproveGoogleTagCoverageRecommendation)

Output only. Recommendation to deploy Google Tag on more pages.

performanceMaxFinalUrlOptInRecommendation

object (PerformanceMaxFinalUrlOptInRecommendation)

Output only. Recommendation to turn on Final URL expansion for your Performance Max campaigns.

refreshCustomerMatchListRecommendation

object (RefreshCustomerMatchListRecommendation)

Output only. The refresh customer list recommendation.

customAudienceOptInRecommendation

object (CustomAudienceOptInRecommendation)

Output only. The custom audience opt in recommendation.

leadFormAssetRecommendation

object (LeadFormAssetRecommendation)

Output only. The lead form asset recommendation.

improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

Output only. The improve Demand Gen ad strength recommendation.

RecommendationImpact

The impact of making the change as described in the recommendation. Some types of recommendations may not have impact information.

JSON representation
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
Fields
baseMetrics

object (RecommendationMetrics)

Output only. Base metrics at the time the recommendation was generated.

potentialMetrics

object (RecommendationMetrics)

Output only. Estimated metrics if the recommendation is applied.

RecommendationMetrics

Weekly account performance metrics. For some recommendation types, these are averaged over the past 90-day period and hence can be fractional.

JSON representation
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionsValue": number,
  "videoViews": number
}
Fields
impressions

number

Output only. Number of ad impressions.

clicks

number

Output only. Number of ad clicks.

costMicros

string (int64 format)

Output only. Cost (in micros) for advertising, in the local currency for the account.

conversions

number

Output only. Number of conversions.

conversionsValue

number

Output only. Sum of the conversion value of the conversions.

videoViews

number

Output only. Number of video views for a video ad campaign.

CampaignBudgetRecommendation

The budget recommendation for budget constrained campaigns.

JSON representation
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
Fields
budgetOptions[]

object (CampaignBudgetRecommendationOption)

Output only. The budget amounts and associated impact estimates for some values of possible budget amounts.

currentBudgetAmountMicros

string (int64 format)

Output only. The current budget amount in micros.

recommendedBudgetAmountMicros

string (int64 format)

Output only. The recommended budget amount in micros.

CampaignBudgetRecommendationOption

The impact estimates for a given budget amount.

JSON representation
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
Fields
impact

object (RecommendationImpact)

Output only. The impact estimate if budget is changed to amount specified in this option.

budgetAmountMicros

string (int64 format)

Output only. The budget amount for this option.

KeywordRecommendation

The keyword recommendation.

JSON representation
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
Fields
keyword

object (KeywordInfo)

Output only. The recommended keyword.

searchTerms[]

object (SearchTerm)

Output only. A list of search terms this keyword matches. The same search term may be repeated for multiple keywords.

recommendedCpcBidMicros

string (int64 format)

Output only. The recommended CPC (cost-per-click) bid.

SearchTerm

Information about a search term as related to a keyword recommendation.

JSON representation
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
Fields
text

string

Output only. The text of the search term.

estimatedWeeklySearchCount

string (int64 format)

Output only. Estimated number of historical weekly searches for this search term.

TextAdRecommendation

The text ad recommendation.

JSON representation
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
Fields
ad

object (Ad)

Output only. Recommended ad.

creationDate

string

Output only. Creation date of the recommended ad. YYYY-MM-DD format, for example, 2018-04-17.

autoApplyDate

string

Output only. Date, if present, is the earliest when the recommendation will be auto applied. YYYY-MM-DD format, for example, 2018-04-17.

TargetCpaOptInRecommendation

The Target CPA opt-in recommendation.

JSON representation
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
Fields
options[]

object (TargetCpaOptInRecommendationOption)

Output only. The available goals and corresponding options for Target CPA strategy.

recommendedTargetCpaMicros

string (int64 format)

Output only. The recommended average CPA target. See required budget amount and impact of using this recommendation in options list.

TargetCpaOptInRecommendationOption

The Target CPA opt-in option with impact estimate.

JSON representation
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
Fields
goal

enum (TargetCpaOptInRecommendationGoal)

Output only. The goal achieved by this option.

impact

object (RecommendationImpact)

Output only. The impact estimate if this option is selected.

targetCpaMicros

string (int64 format)

Output only. Average CPA target.

requiredCampaignBudgetAmountMicros

string (int64 format)

Output only. The minimum campaign budget, in local currency for the account, required to achieve the target CPA. Amount is specified in micros, where one million is equivalent to one currency unit.

TargetCpaOptInRecommendationGoal

Goal of TargetCpaOptIn recommendation.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
SAME_COST Recommendation to set Target CPA to maintain the same cost.
SAME_CONVERSIONS Recommendation to set Target CPA to maintain the same conversions.
SAME_CPA Recommendation to set Target CPA to maintain the same CPA.
CLOSEST_CPA Recommendation to set Target CPA to a value that is as close as possible to, yet lower than, the actual CPA (computed for past 28 days).

MaximizeConversionsOptInRecommendation

The Maximize Conversions Opt-In recommendation.

JSON representation
{
  "recommendedBudgetAmountMicros": string
}
Fields
recommendedBudgetAmountMicros

string (int64 format)

Output only. The recommended new budget amount.

EnhancedCpcOptInRecommendation

This type has no fields.

The Enhanced Cost-Per-Click Opt-In recommendation.

SearchPartnersOptInRecommendation

This type has no fields.

The Search Partners Opt-In recommendation.

MaximizeClicksOptInRecommendation

The Maximize Clicks opt-in recommendation.

JSON representation
{
  "recommendedBudgetAmountMicros": string
}
Fields
recommendedBudgetAmountMicros

string (int64 format)

Output only. The recommended new budget amount. Only set if the current budget is too high.

OptimizeAdRotationRecommendation

This type has no fields.

The Optimize Ad Rotation recommendation.

KeywordMatchTypeRecommendation

The keyword match type recommendation.

JSON representation
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
Fields
keyword

object (KeywordInfo)

Output only. The existing keyword where the match type should be more broad.

recommendedMatchType

enum (KeywordMatchType)

Output only. The recommended new match type.

MoveUnusedBudgetRecommendation

The move unused budget recommendation.

JSON representation
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
Fields
budgetRecommendation

object (CampaignBudgetRecommendation)

Output only. The recommendation for the constrained budget to increase.

excessCampaignBudget

string

Output only. The excess budget's resourceName.

TargetRoasOptInRecommendation

The Target ROAS opt-in recommendation.

JSON representation
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
Fields
recommendedTargetRoas

number

Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive.

requiredCampaignBudgetAmountMicros

string (int64 format)

Output only. The minimum campaign budget, in local currency for the account, required to achieve the target ROAS. Amount is specified in micros, where one million is equivalent to one currency unit.

ResponsiveSearchAdRecommendation

The add responsive search ad recommendation.

JSON representation
{
  "ad": {
    object (Ad)
  }
}
Fields
ad

object (Ad)

Output only. Recommended ad.

UseBroadMatchKeywordRecommendation

The use broad match keyword recommendation.

JSON representation
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
Fields
keyword[]

object (KeywordInfo)

Output only. Sample of keywords to be expanded to Broad Match.

suggestedKeywordsCount

string (int64 format)

Output only. Total number of keywords to be expanded to Broad Match in the campaign.

campaignKeywordsCount

string (int64 format)

Output only. Total number of keywords in the campaign.

campaignUsesSharedBudget

boolean

Output only. Whether the associated campaign uses a shared budget.

requiredCampaignBudgetAmountMicros

string (int64 format)

Output only. The budget recommended to avoid becoming budget constrained after applying the recommendation.

ResponsiveSearchAdAssetRecommendation

The add responsive search ad asset recommendation.

JSON representation
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
Fields
currentAd

object (Ad)

Output only. The current ad to be updated.

recommendedAssets

object (Ad)

Output only. The recommended assets. This is populated only with the new headlines and/or descriptions, and is otherwise empty.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.

JSON representation
{
  "merchantId": string,
  "salesCountryCode": string
}
Fields
merchantId

string (int64 format)

Output only. ID of Merchant Center account.

salesCountryCode

string

Output only. Country whose products from merchant's inventory should be included.

ResponsiveSearchAdImproveAdStrengthRecommendation

The responsive search ad improve ad strength recommendation.

JSON representation
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
Fields
currentAd

object (Ad)

Output only. The current ad to be updated.

recommendedAd

object (Ad)

Output only. The updated ad.

DisplayExpansionOptInRecommendation

This type has no fields.

The Display Expansion opt-in recommendation.

UpgradeLocalCampaignToPerformanceMaxRecommendation

This type has no fields.

The Upgrade Local campaign to Performance Max campaign recommendation.

RaiseTargetCpaBidTooLowRecommendation

The raise target CPA bid too low recommendation.

JSON representation
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
Fields
recommendedTargetMultiplier

number

Output only. A number greater than 1.0 indicating the factor by which we recommend the target CPA should be increased.

averageTargetCpaMicros

string (int64 format)

Output only. The current average target CPA of the campaign, in micros of customer local currency.

ForecastingSetTargetRoasRecommendation

The forecasting set target ROAS recommendation.

JSON representation
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Fields
recommendedTargetRoas

number

Output only. The recommended target ROAS (revenue per unit of spend). The value is between 0.01 and 1000.0, inclusive.

campaignBudget

object (CampaignBudget)

Output only. The campaign budget.

CampaignBudget

A campaign budget shared amongst various budget recommendation types.

JSON representation
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
Fields
currentAmountMicros

string (int64 format)

Output only. Current budget amount.

recommendedNewAmountMicros

string (int64 format)

Output only. Recommended budget amount.

newStartDate

string

Output only. The date when the new budget would start being used. This field will be set for the following recommendation types: FORECASTING_SET_TARGET_ROAS , FORECASTING_SET_TARGET_CPA YYYY-MM-DD format, for example, 2018-04-17.

CalloutAssetRecommendation

The callout asset recommendation.

JSON representation
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
Fields
recommendedCampaignCalloutAssets[]

object (Asset)

Output only. New callout extension assets recommended at the campaign level.

recommendedCustomerCalloutAssets[]

object (Asset)

Output only. New callout extension assets recommended at the customer level.

SitelinkAssetRecommendation

The sitelink asset recommendation.

JSON representation
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
Fields

CallAssetRecommendation

This type has no fields.

The call asset recommendation.

ShoppingOfferAttributeRecommendation

The shopping recommendation to add an attribute to offers that are demoted because it is missing.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Fields
merchant

object (MerchantInfo)

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The campaign feed label.

offersCount

string (int64 format)

Output only. The number of online, servable offers.

demotedOffersCount

string (int64 format)

Output only. The number of online, servable offers that are demoted for missing attributes. Visit the Merchant Center for more details.

MerchantInfo

The Merchant Center account details.

JSON representation
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
Fields
id

string (int64 format)

Output only. The Merchant Center account ID.

name

string

Output only. The name of the Merchant Center account.

multiClient

boolean

Output only. Whether the Merchant Center account is a Multi-Client account (MCA).

ShoppingAddProductsToCampaignRecommendation

The shopping recommendation to add products to a Shopping Campaign Inventory.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Fields
merchant

object (MerchantInfo)

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label for the campaign.

reason

enum (Reason)

Output only. The reason why no products are attached to the campaign.

Reason

Issues that results in a shopping campaign targeting zero products.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS The Merchant Center account does not have any submitted products.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED The Merchant Center account does not have any submitted products in the feed.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN The Google Ads account has active campaign filters that prevents inclusion of offers in the campaign.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN All products available have been explicitly excluded from being targeted by the campaign.

ShoppingFixDisapprovedProductsRecommendation

The shopping recommendation to fix disapproved products in a Shopping Campaign Inventory.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Fields
merchant

object (MerchantInfo)

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label for the campaign.

productsCount

string (int64 format)

Output only. The number of products of the campaign.

disapprovedProductsCount

string (int64 format)

Output only. The numbers of products of the campaign that are disapproved.

ShoppingTargetAllOffersRecommendation

The shopping recommendation to create a catch-all campaign that targets all offers.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Fields
merchant

object (MerchantInfo)

Output only. The details of the Merchant Center account.

untargetedOffersCount

string (int64 format)

Output only. The number of untargeted offers.

feedLabel

string

Output only. The offer feed label.

ShoppingMerchantCenterAccountSuspensionRecommendation

The shopping recommendation to fix Merchant Center account suspension issues.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Fields
merchant

object (MerchantInfo)

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label of the campaign for which the suspension happened.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

The shopping recommendation to migrate Regular Shopping Campaign targeted offers to Performance Max campaigns.

JSON representation
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Fields
merchant

object (MerchantInfo)

Output only. The details of the Merchant Center account.

feedLabel

string

Output only. The feed label of the offers targeted by the campaigns sharing this suggestion.

DynamicImageExtensionOptInRecommendation

This type has no fields.

Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.

RaiseTargetCpaRecommendation

Recommendation to raise Target CPA.

JSON representation
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Fields
targetAdjustment

object (TargetAdjustmentInfo)

Output only. The relevant information describing the recommended target adjustment.

appBiddingGoal

enum (AppBiddingGoal)

Output only. Represents the goal towards which the bidding strategy should optimize. Only populated for App Campaigns.

TargetAdjustmentInfo

Information of a target adjustment recommendation.

JSON representation
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Fields
recommendedTargetMultiplier

number

Output only. The factor by which we recommend the target to be adjusted by.

currentAverageTargetMicros

string (int64 format)

Output only. The current average target of the campaign or portfolio targeted by this recommendation.

sharedSet

string

Output only. The shared set resource name of the portfolio bidding strategy where the target is defined. Only populated if the recommendation is portfolio level.

AppBiddingGoal

Represents the goal towards which the bidding strategy, of an app campaign, should optimize for.

Enums
UNSPECIFIED Not specified.
UNKNOWN Represents value unknown in this version of the API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME The bidding strategy of the app campaign should aim to maximize installation of the app.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME The bidding strategy of the app campaign should aim to maximize the selected in-app conversions' volume.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION The bidding strategy of the app campaign should aim to maximize just the selected in-app conversion's volume, while achieving or exceeding target cost per in-app conversion.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND The bidding strategy of the app campaign should aim to maximize all conversions' value, that is, install and selected in-app conversions while achieving or exceeding target return on advertising spend.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI This bidding strategy of the app campaign should aim to maximize installation of the app without advertiser-provided target cost-per-install.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME This bidding strategy of the app campaign should aim to maximize pre-registration of the app.

LowerTargetRoasRecommendation

Recommendation to lower Target ROAS.

JSON representation
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Fields
targetAdjustment

object (TargetAdjustmentInfo)

Output only. The relevant information describing the recommended target adjustment.

PerformanceMaxOptInRecommendation

This type has no fields.

The Performance Max Opt In recommendation.

ImprovePerformanceMaxAdStrengthRecommendation

Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating.

JSON representation
{
  "assetGroup": string
}
Fields
assetGroup

string

Output only. The asset group resource name.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

The Dynamic Search Ads to Performance Max migration recommendation.

JSON representation
{
  "applyLink": string
}
Fields

ForecastingSetTargetCpaRecommendation

The set target CPA recommendations.

JSON representation
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Fields
recommendedTargetCpaMicros

string (int64 format)

Output only. The recommended target CPA.

campaignBudget

object (CampaignBudget)

Output only. The campaign budget.

MaximizeConversionValueOptInRecommendation

This type has no fields.

Recommendation to opt into Maximize Conversion Value bidding strategy.

ImproveGoogleTagCoverageRecommendation

This type has no fields.

Recommendation to deploy Google Tag on more pages.

PerformanceMaxFinalUrlOptInRecommendation

This type has no fields.

Recommendation to turn on Final URL expansion for your Performance Max campaigns.

RefreshCustomerMatchListRecommendation

The recommendation to update a customer list that hasn't been updated in the last 90 days. The customer receiving the recommendation is not necessarily the owner account. The owner account should update the customer list.

JSON representation
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
Fields
userListId

string (int64 format)

Output only. The user list ID.

userListName

string

Output only. The name of the list.

daysSinceLastRefresh

string (int64 format)

Output only. Days since last refresh.

topSpendingAccount[]

object (AccountInfo)

Output only. The top spending account.

targetingAccountsCount

string (int64 format)

Output only. User lists can be shared with other accounts by the owner. targetingAccountsCount is the number of those accounts that can use it for targeting.

ownerAccount

object (AccountInfo)

Output only. The owner account. This is the account that should update the customer list.

AccountInfo

Wrapper for information about a Google Ads account.

JSON representation
{
  "customerId": string,
  "descriptiveName": string
}
Fields
customerId

string (int64 format)

Output only. The customer ID of the account.

descriptiveName

string

Output only. The descriptive name of the account.

CustomAudienceOptInRecommendation

The Custom Audience Opt In recommendation.

JSON representation
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ]
}
Fields
keywords[]

object (KeywordInfo)

Output only. The list of keywords to use for custom audience creation.

LeadFormAssetRecommendation

This type has no fields.

The lead form asset recommendation.

ImproveDemandGenAdStrengthRecommendation

The improve Demand Gen ad strength recommendation.

JSON representation
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
Fields
ad

string

Output only. The resource name of the ad that can be improved.

adStrength

enum (AdStrength)

Output only. The current ad strength.

demandGenAssetActionItems[]

string

Output only. A list of recommendations to improve the ad strength.