Recommendation

Uma recomendação.

Representação 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.
}
Campos
resourceName

string

Imutável. O nome do recurso da recomendação.

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

enum (RecommendationType)

Apenas saída. O tipo de recomendação.
impact

object (RecommendationImpact)

Apenas saída. O impacto na performance da conta como resultado da aplicação da recomendação.
campaigns[]

string

Apenas saída. As campanhas segmentadas por essa recomendação.

Esse campo será definido para os seguintes tipos de recomendação: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET e MOVE_UNUSED_BUDGET.
campaignBudget

string

Apenas saída. O orçamento segmentado por esta recomendação. Isso só vai ser definido quando a recomendação afetar um único orçamento de campanha.

Esse campo será definido para os seguintes tipos de recomendação: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUS_BUDGET
campaign

string

Apenas saída. A campanha segmentada por essa recomendação.

Esse campo será definido para os seguintes tipos de recomendação: 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

Apenas saída. O grupo de anúncios segmentado por essa recomendação. Isso só vai ser definido quando a recomendação afetar um único grupo de anúncios.

Esse campo será definido para os seguintes tipos de recomendação: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET e TEXT_AD
dismissed

boolean

Apenas saída. Se a recomendação foi dispensada ou não.
Campo de união recommendation. Os detalhes da recomendação. recommendation pode ser apenas de um dos tipos a seguir:
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação de orçamento da campanha.
forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação de orçamento da campanha de previsão.
keywordRecommendation

object (KeywordRecommendation)

Apenas saída. A recomendação de palavra-chave.
textAdRecommendation

object (TextAdRecommendation)

Apenas saída. Adicionar recomendação de anúncio de texto expandido.
targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

Apenas saída. A recomendação de ativação do CPA desejado.
maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

Apenas saída. A recomendação "Ativar a estratégia de lances Maximizar conversões".
enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

Apenas saída. A recomendação de ativação do Custo por clique otimizado.
searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

Apenas saída. A recomendação de ativação de parceiros de pesquisa.
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

Apenas saída. A recomendação "Ativar a estratégia de lances "Maximizar cliques".
optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

Apenas saída. A recomendação "Otimizar a rotação de anúncios".
keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

Apenas saída. A recomendação do tipo de correspondência de palavra-chave.
moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

Apenas saída. A recomendação de mover o orçamento não usado.
targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

Apenas saída. A recomendação de ativação do ROAS desejado.
responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

Apenas saída. A recomendação de adicionar anúncios responsivos de pesquisa.
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação de orçamento da campanha para ROI marginal.
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

Apenas saída. Use a recomendação de palavra-chave de correspondência ampla.
responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

Apenas saída. A recomendação de recurso de anúncio responsivo de pesquisa.
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

Apenas saída. Fazer upgrade de uma campanha inteligente do Shopping para uma recomendação de campanha Performance Max.
responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

Apenas saída. A recomendação de melhoria da qualidade do anúncio responsivo de pesquisa.
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

Apenas saída. A recomendação de ativação da Inclusão da Rede de Display.
upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

Apenas saída. A recomendação de fazer upgrade de uma campanha local para uma campanha Performance Max.
raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

Apenas saída. A recomendação de aumentar o lance de CPA desejado é muito baixa.
forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Apenas saída. A estimativa definiu a recomendação de ROAS desejado.
calloutAssetRecommendation

object (CalloutAssetRecommendation)

Apenas saída. A recomendação de recurso de frase de destaque.
callAssetRecommendation

object (CallAssetRecommendation)

Apenas saída. A recomendação de recurso de ligação.
shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação de faixa etária do Shopping.
shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação de cor do item adicionado.
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação de gênero do Shopping.
shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação GTIN do Shopping.
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação "adicionar mais identificadores".
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação de tamanho de anúncio do Shopping.
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

Apenas saída. O Shopping adiciona produtos à recomendação da campanha.
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

Apenas saída. A recomendação de produtos reprovados para correção do Shopping.
shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

Apenas saída. A segmentação de compras recomenda todas as ofertas.
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Apenas saída. A correção do Shopping na recomendação de uma conta do Merchant Center suspensa.
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Apenas saída. A recomendação de aviso de suspensão da conta do Merchant Center.
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

Apenas saída. A migração da campanha padrão do Shopping oferece recomendações de campanhas Performance Max.
dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

Apenas saída. Recomendação para ativar as extensões de imagem dinâmicas na conta, permitindo que o Google encontre as melhores imagens nas páginas de destino dos anúncios e complemente os anúncios de texto.
raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

Apenas saída. Recomendação para aumentar o CPA desejado.
lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

Apenas saída. Recomendação para diminuir o ROAS desejado.
performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

Apenas saída. A recomendação para ativar as campanhas Performance Max.
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

Apenas saída. Recomendação para melhorar a qualidade do anúncio Performance Max.
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

Apenas saída. A recomendação de migração de anúncios dinâmicos de pesquisa para Performance Max.
forecastingSetTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

Apenas saída. A recomendação de CPA desejado do conjunto de previsão.
setTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

Apenas saída. A recomendação de CPA desejado definida.
setTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Apenas saída. A recomendação de ROAS desejado definida.
maximizeConversionValueOptInRecommendation

object (MaximizeConversionValueOptInRecommendation)

Apenas saída. Ativar a estratégia de lances "Maximizar o valor da conversão".
improveGoogleTagCoverageRecommendation

object (ImproveGoogleTagCoverageRecommendation)

Apenas saída. Recomendação para implantar a tag do Google em mais páginas.
performanceMaxFinalUrlOptInRecommendation

object (PerformanceMaxFinalUrlOptInRecommendation)

Apenas saída. Recomendação para ativar a expansão de URL final nas campanhas Performance Max.
refreshCustomerMatchListRecommendation

object (RefreshCustomerMatchListRecommendation)

Apenas saída. A recomendação de atualização da lista de clientes.
customAudienceOptInRecommendation

object (CustomAudienceOptInRecommendation)

Apenas saída. A recomendação de ativação do público-alvo personalizado.
leadFormAssetRecommendation

object (LeadFormAssetRecommendation)

Apenas saída. A recomendação de recurso de formulário de lead.
improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

Apenas saída. A recomendação de melhoria da qualidade do anúncio da Geração de demanda.

RecommendationImpact

O impacto da mudança conforme descrito na recomendação. Alguns tipos de recomendações podem não ter informações de impacto.

Representação JSON 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
Campos
baseMetrics

object (RecommendationMetrics)

Apenas saída. Métricas de base no momento em que a recomendação foi gerada.
potentialMetrics

object (RecommendationMetrics)

Apenas saída. Métricas estimadas se a recomendação for aplicada.

RecommendationMetrics

Métricas semanais de desempenho da conta. Para alguns tipos de recomendação, a média é calculada nos últimos 90 dias e, portanto, pode ser fracionária.

Representação JSON 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionsValue": number,
  "videoViews": number
}
Campos
impressions

number

Apenas saída. Número de impressões de anúncios.
clicks

number

Apenas saída. Número de cliques no anúncio.
costMicros

string (int64 format)

Apenas saída. Custo (em micros) da publicidade na moeda local da conta.
conversions

number

Apenas saída. Número de conversões.
conversionsValue

number

Apenas saída. Soma do valor das conversões.
videoViews

number

Apenas saída. Número de visualizações de vídeo de uma campanha de anúncios em vídeo.

CampaignBudgetRecommendation

A recomendação de orçamento para campanhas limitadas pelo orçamento.

Representação JSON 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
Campos
budgetOptions[]

object (CampaignBudgetRecommendationOption)

Apenas saída. Os valores do orçamento e as estimativas de impacto associadas para alguns valores de possíveis valores de orçamento.
currentBudgetAmountMicros

string (int64 format)

Apenas saída. O valor do orçamento atual em micros.
recommendedBudgetAmountMicros

string (int64 format)

Apenas saída. O valor do orçamento recomendado em micros.

CampaignBudgetRecommendationOption

As estimativas de impacto de um determinado valor de orçamento.

Representação JSON 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
Campos
impact

object (RecommendationImpact)

Apenas saída. A estimativa de impacto se o orçamento for alterado para o valor especificado nesta opção.
budgetAmountMicros

string (int64 format)

Apenas saída. O valor do orçamento para essa opção.

KeywordRecommendation

A recomendação de palavra-chave.

Representação JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
Campos
keyword

object (KeywordInfo)

Apenas saída. A palavra-chave recomendada.
searchTerms[]

object (SearchTerm)

Apenas saída. Uma lista de termos de pesquisa correspondentes a essa palavra-chave. O mesmo termo de pesquisa pode ser repetido para várias palavras-chave.
recommendedCpcBidMicros

string (int64 format)

Apenas saída. O lance de CPC (custo por clique) recomendado.

SearchTerm

Informações sobre um termo de pesquisa relacionado a uma recomendação de palavra-chave.

Representação JSON 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
Campos
text

string

Apenas saída. O texto do termo de pesquisa.
estimatedWeeklySearchCount

string (int64 format)

Apenas saída. Número estimado de pesquisas semanais históricas para esse termo de pesquisa.

TextAdRecommendation

A recomendação de anúncio de texto.

Representação JSON 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
Campos
ad

object (Ad)

Apenas saída. Anúncio recomendado.
creationDate

string

Apenas saída. Data de criação do anúncio recomendado. Formato AAAA-MM-DD, por exemplo, 2018-04-17.
autoApplyDate

string

Apenas saída. A data, se presente, é a primeira em que a recomendação será aplicada automaticamente. Formato AAAA-MM-DD, por exemplo, 2018-04-17.

TargetCpaOptInRecommendation

A recomendação de ativação do CPA desejado.

Representação JSON 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
Campos
options[]

object (TargetCpaOptInRecommendationOption)

Apenas saída. As metas disponíveis e as opções correspondentes para a estratégia de CPA desejado.
recommendedTargetCpaMicros

string (int64 format)

Apenas saída. A meta de CPA médio recomendada. Confira o valor do orçamento necessário e o impacto do uso dessa recomendação na lista de opções.

TargetCpaOptInRecommendationOption

A opção de ativação do CPA desejado com estimativa de impacto.

Representação JSON 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
Campos
goal

enum (TargetCpaOptInRecommendationGoal)

Apenas saída. A meta alcançada com essa opção.
impact

object (RecommendationImpact)

Apenas saída. A estimativa de impacto se essa opção for selecionada.
targetCpaMicros

string (int64 format)

Apenas saída. Meta de CPA médio.
requiredCampaignBudgetAmountMicros

string (int64 format)

Apenas saída. O orçamento mínimo da campanha, na moeda local, necessário para atingir o CPA desejado. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária.

TargetCpaOptInRecommendationGoal

Meta da recomendação de TargetCpaOptIn.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
SAME_COST Recomendação para definir o CPA desejado de modo a manter o mesmo custo.
SAME_CONVERSIONS Recomendação para definir o CPA desejado e manter as mesmas conversões.
SAME_CPA Recomendação para definir o CPA desejado e manter o mesmo CPA.
CLOSEST_CPA Recomendação para definir o CPA desejado como um valor o mais próximo possível do CPA real (calculado nos últimos 28 dias), mas menor.

MaximizeConversionsOptInRecommendation

A recomendação para ativar a estratégia "Maximizar conversões".

Representação JSON 
{
  "recommendedBudgetAmountMicros": string
}
Campos
recommendedBudgetAmountMicros

string (int64 format)

Apenas saída. O novo valor do orçamento recomendado.

EnhancedCpcOptInRecommendation

Esse tipo não tem campos.

A recomendação de ativação do Custo por clique otimizado.

SearchPartnersOptInRecommendation

Esse tipo não tem campos.

A recomendação de ativação de parceiros de pesquisa.

MaximizeClicksOptInRecommendation

A recomendação de ativação da estratégia "Maximizar cliques".

Representação JSON 
{
  "recommendedBudgetAmountMicros": string
}
Campos
recommendedBudgetAmountMicros

string (int64 format)

Apenas saída. O novo valor do orçamento recomendado. Defina apenas se o orçamento atual for muito alto.

OptimizeAdRotationRecommendation

Esse tipo não tem campos.

A recomendação "Otimizar a rotação de anúncios".

KeywordMatchTypeRecommendation

A recomendação do tipo de correspondência de palavra-chave.

Representação JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
Campos
keyword

object (KeywordInfo)

Apenas saída. A palavra-chave atual em que o tipo de correspondência precisa ser mais amplo.
recommendedMatchType

enum (KeywordMatchType)

Apenas saída. O novo tipo de correspondência recomendado.

MoveUnusedBudgetRecommendation

A recomendação de mover o orçamento não usado.

Representação JSON 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
Campos
budgetRecommendation

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação para aumentar o orçamento restrito.
excessCampaignBudget

string

Apenas saída. O resourceName do orçamento excedente.

TargetRoasOptInRecommendation

A recomendação de ativação do ROAS desejado.

Representação JSON 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
Campos
recommendedTargetRoas

number

Apenas saída. O ROAS desejado recomendado (receita por unidade de gasto). O valor está entre 0,01 e 1.000,0.
requiredCampaignBudgetAmountMicros

string (int64 format)

Apenas saída. O orçamento mínimo da campanha, na moeda local da conta, necessário para alcançar o ROAS desejado. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária.

ResponsiveSearchAdRecommendation

A recomendação de adicionar anúncios responsivos de pesquisa.

Representação JSON 
{
  "ad": {
    object (Ad)
  }
}
Campos
ad

object (Ad)

Apenas saída. Anúncio recomendado.

UseBroadMatchKeywordRecommendation

A recomendação de usar a palavra-chave de correspondência ampla.

Representação JSON 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
Campos
keyword[]

object (KeywordInfo)

Apenas saída. Exemplo de palavras-chave que serão expandidas para correspondência ampla.
suggestedKeywordsCount

string (int64 format)

Apenas saída. Número total de palavras-chave que serão expandidas para correspondência ampla na campanha.
campaignKeywordsCount

string (int64 format)

Apenas saída. Número total de palavras-chave na campanha.
campaignUsesSharedBudget

boolean

Apenas saída. Indica se a campanha associada usa um orçamento compartilhado.
requiredCampaignBudgetAmountMicros

string (int64 format)

Apenas saída. O orçamento recomendado para evitar que fique limitado pelo orçamento após a aplicação da recomendação.

ResponsiveSearchAdAssetRecommendation

A recomendação de adicionar recursos de anúncios responsivos de pesquisa.

Representação JSON 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
Campos
currentAd

object (Ad)

Apenas saída. O anúncio atual a ser atualizado.
recommendedAssets

object (Ad)

Apenas saída. Os recursos recomendados. Esse campo é preenchido apenas com os novos títulos e/ou descrições e fica vazio.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

A recomendação de fazer upgrade de uma campanha inteligente do Shopping para uma campanha Performance Max.

Representação JSON 
{
  "merchantId": string,
  "salesCountryCode": string
}
Campos
merchantId

string (int64 format)

Apenas saída. ID da conta do Merchant Center.
salesCountryCode

string

Apenas saída. País cujos produtos do inventário do comerciante precisam ser incluídos.

ResponsiveSearchAdImproveAdStrengthRecommendation

A recomendação de melhoria da qualidade do anúncio responsivo de pesquisa.

Representação JSON 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
Campos
currentAd

object (Ad)

Apenas saída. O anúncio atual a ser atualizado.
recommendedAd

object (Ad)

Apenas saída. O anúncio atualizado.

DisplayExpansionOptInRecommendation

Esse tipo não tem campos.

A recomendação de ativação da Inclusão da Rede de Display.

UpgradeLocalCampaignToPerformanceMaxRecommendation

Esse tipo não tem campos.

A recomendação "Fazer upgrade da campanha local para Performance Max".

RaiseTargetCpaBidTooLowRecommendation

A recomendação de aumentar o lance de CPA desejado é muito baixa.

Representação JSON 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
Campos
recommendedTargetMultiplier

number

Apenas saída. Um número maior que 1,0 que indica o fator pelo qual recomendamos que o CPA desejado seja aumentado.
averageTargetCpaMicros

string (int64 format)

Apenas saída. O CPA desejado médio atual da campanha, em micros na moeda local do cliente.

ForecastingSetTargetRoasRecommendation

A estimativa definiu a recomendação de ROAS desejado.

Representação JSON 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Campos
recommendedTargetRoas

number

Apenas saída. O ROAS desejado recomendado (receita por unidade de gasto). O valor está entre 0,01 e 1.000,0.
campaignBudget

object (CampaignBudget)

Apenas saída. O orçamento da campanha.

CampaignBudget

Um orçamento de campanha compartilhado entre vários tipos de recomendação de orçamento.

Representação JSON 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
Campos
currentAmountMicros

string (int64 format)

Apenas saída. Valor do orçamento atual.
recommendedNewAmountMicros

string (int64 format)

Apenas saída. Valor do orçamento recomendado.
newStartDate

string

Apenas saída. A data em que o novo orçamento começaria a ser usado. Esse campo será definido para os seguintes tipos de recomendação: FORECASTING_SET_TARGET_ROAS, FORECASTING_SET_TARGET_CPA no formato AAAA-MM-DD, por exemplo, 2018-04-17.

CalloutAssetRecommendation

A recomendação de recurso de frase de destaque.

Representação JSON 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
Campos
recommendedCampaignCalloutAssets[]

object (Asset)

Apenas saída. Novos recursos de extensão de frase de destaque recomendados no nível da campanha.
recommendedCustomerCalloutAssets[]

object (Asset)

Apenas saída. Novos recursos de extensão de frase de destaque recomendados no nível do cliente.

SitelinkAssetRecommendation

A recomendação de recurso de sitelink.

Representação JSON 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
Campos

CallAssetRecommendation

Esse tipo não tem campos.

A recomendação de recurso de ligação.

ShoppingOfferAttributeRecommendation

A recomendação de compras para adicionar um atributo a ofertas rebaixadas por falta.

Representação JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Detalhes da conta do Merchant Center.
feedLabel

string

Apenas saída. O rótulo do feed da campanha.
offersCount

string (int64 format)

Apenas saída. O número de ofertas on-line que podem ser veiculadas.
demotedOffersCount

string (int64 format)

Apenas saída. O número de ofertas on-line que podem ser veiculadas e que foram rebaixadas por falta de atributos. Acesse o Merchant Center para mais detalhes.

MerchantInfo

Os detalhes da conta do Merchant Center.

Representação JSON 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
Campos
id

string (int64 format)

Apenas saída. O ID da conta do Merchant Center.
name

string

Apenas saída. O nome da conta do Merchant Center.
multiClient

boolean

Apenas saída. Se a conta do Merchant Center é de múltiplos clientes (MCA).

ShoppingAddProductsToCampaignRecommendation

A recomendação de compras para adicionar produtos ao inventário de uma campanha do Shopping.

Representação JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Detalhes da conta do Merchant Center.
feedLabel

string

Apenas saída. O rótulo do feed da campanha.
reason

enum (Reason)

Apenas saída. O motivo pelo qual nenhum produto está associado à campanha.

Motivo

Problemas que resultam em uma campanha do Shopping que segmenta zero produtos.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS A conta do Merchant Center não tem produtos enviados.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED A conta do Merchant Center não tem produtos enviados no feed.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN A conta do Google Ads tem filtros ativos que impedem a inclusão de ofertas na campanha.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN Todos os produtos disponíveis foram explicitamente excluídos da segmentação da campanha.

ShoppingFixDisapprovedProductsRecommendation

A recomendação de corrigir produtos reprovados no inventário de uma campanha do Shopping.

Representação JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Detalhes da conta do Merchant Center.
feedLabel

string

Apenas saída. O rótulo do feed da campanha.
productsCount

string (int64 format)

Apenas saída. O número de produtos da campanha.
disapprovedProductsCount

string (int64 format)

Apenas saída. O número de produtos da campanha que foram reprovados.

ShoppingTargetAllOffersRecommendation

A recomendação de compras para criar uma campanha abrangente que segmente todas as ofertas.

Representação JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Detalhes da conta do Merchant Center.
untargetedOffersCount

string (int64 format)

Apenas saída. O número de ofertas não segmentadas.
feedLabel

string

Apenas saída. O rótulo do feed de ofertas.

ShoppingMerchantCenterAccountSuspensionRecommendation

A recomendação de compras para corrigir problemas de suspensão da conta do Merchant Center.

Representação JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Detalhes da conta do Merchant Center.
feedLabel

string

Apenas saída. O rótulo do feed da campanha em que a suspensão ocorreu.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

A recomendação de migração das ofertas segmentadas das campanhas padrão do Shopping para as campanhas Performance Max.

Representação JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Detalhes da conta do Merchant Center.
feedLabel

string

Apenas saída. O rótulo do feed das ofertas segmentadas pelas campanhas que compartilham essa sugestão.

DynamicImageExtensionOptInRecommendation

Esse tipo não tem campos.

Recomendação para ativar as extensões de imagem dinâmica na conta, permitindo que o Google encontre as melhores imagens nas páginas de destino dos anúncios e complemente os anúncios de texto.

RaiseTargetCpaRecommendation

Recomendação para aumentar o CPA desejado.

Representação JSON 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Campos
targetAdjustment

object (TargetAdjustmentInfo)

Apenas saída. As informações relevantes que descrevem o ajuste de meta recomendado.
appBiddingGoal

enum (AppBiddingGoal)

Apenas saída. Representa a meta que a estratégia de lances precisa otimizar. Preenchido apenas para campanhas para apps.

TargetAdjustmentInfo

Informações de uma recomendação de ajuste de meta.

Representação JSON 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Campos
recommendedTargetMultiplier

number

Apenas saída. O fator pelo qual recomendamos que a meta seja ajustada.
currentAverageTargetMicros

string (int64 format)

Apenas saída. A meta média atual da campanha ou do portfólio segmentado por essa recomendação.
sharedSet

string

Apenas saída. O nome do recurso de conjunto compartilhado da estratégia de lances de portfólio em que a meta é definida. Só é preenchido se a recomendação for no nível do portfólio.

AppBiddingGoal

Representa a meta que a estratégia de lances de uma campanha para apps precisa otimizar.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa um valor desconhecido nesta versão da API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME A estratégia de lances da campanha para apps precisa ter como objetivo maximizar a instalação do app.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME A estratégia de lances da campanha para apps precisa maximizar o volume das conversões no app selecionadas.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE A estratégia de lances da campanha para apps precisa maximizar o valor de todas as conversões, ou seja, as conversões de instalação e as conversões no app selecionadas.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION A estratégia de lances da campanha para apps precisa maximizar apenas o volume da conversão no app selecionada, alcançando ou excedendo o custo desejado por conversão no app.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND A estratégia de lances da campanha para apps precisa maximizar o valor de todas as conversões, ou seja, conversões no aplicativo selecionadas e de instalação, atingindo ou excedendo o retorno do investimento em publicidade desejado.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI Essa estratégia de lances da campanha do app precisa ter como objetivo maximizar a instalação do app sem usar o custo por instalação desejado fornecido pelo anunciante.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME Essa estratégia de lances da campanha para apps precisa maximizar o pré-registro do app.

LowerTargetRoasRecommendation

Recomendação para diminuir o ROAS desejado.

Representação JSON 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Campos
targetAdjustment

object (TargetAdjustmentInfo)

Apenas saída. As informações relevantes que descrevem o ajuste de meta recomendado.

PerformanceMaxOptInRecommendation

Esse tipo não tem campos.

A recomendação para ativar as campanhas Performance Max.

ImprovePerformanceMaxAdStrengthRecommendation

Recomendação para melhorar a força do grupo de recursos de uma campanha Performance Max para uma classificação "Excelente".

Representação JSON 
{
  "assetGroup": string
}
Campos
assetGroup

string

Apenas saída. O nome do recurso do grupo de recursos.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

A recomendação de migração de anúncios dinâmicos de pesquisa para Performance Max.

Representação JSON 
{
  "applyLink": string
}
Campos

ForecastingSetTargetCpaRecommendation

As recomendações de CPA desejado definidas.

Representação JSON 
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Campos
recommendedTargetCpaMicros

string (int64 format)

Apenas saída. O CPA desejado recomendado.
campaignBudget

object (CampaignBudget)

Apenas saída. O orçamento da campanha.

MaximizeConversionValueOptInRecommendation

Esse tipo não tem campos.

Recomendação para ativar a estratégia de lances "Maximizar o valor da conversão".

ImproveGoogleTagCoverageRecommendation

Esse tipo não tem campos.

Recomendação para implantar a tag do Google em mais páginas.

PerformanceMaxFinalUrlOptInRecommendation

Esse tipo não tem campos.

Recomendação para ativar a expansão de URL final nas campanhas Performance Max.

RefreshCustomerMatchListRecommendation

A recomendação para atualizar uma lista de clientes que não foi atualizada nos últimos 90 dias. O cliente que recebe a recomendação não é necessariamente a conta do proprietário. A conta do proprietário precisa atualizar a lista de clientes.

Representação JSON 
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
Campos
userListId

string (int64 format)

Apenas saída. O ID da lista de usuários.
userListName

string

Apenas saída. O nome da lista.
daysSinceLastRefresh

string (int64 format)

Apenas saída. Dias desde a última atualização.
topSpendingAccount[]

object (AccountInfo)

Apenas saída. A conta com os maiores gastos.
targetingAccountsCount

string (int64 format)

Apenas saída. O proprietário pode compartilhar listas de usuários com outras contas. A variável targetingAccountsCount é o número de contas que podem usar a lista para segmentação.
ownerAccount

object (AccountInfo)

Apenas saída. A conta de proprietário. Essa é a conta que vai atualizar a lista de clientes.

AccountInfo

Wrapper para informações sobre uma conta do Google Ads.

Representação JSON 
{
  "customerId": string,
  "descriptiveName": string
}
Campos
customerId

string (int64 format)

Apenas saída. O ID do cliente da conta.
descriptiveName

string

Apenas saída. O nome descritivo da conta.

CustomAudienceOptInRecommendation

A recomendação de ativação do público-alvo personalizado.

Representação JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ]
}
Campos
keywords[]

object (KeywordInfo)

Apenas saída. A lista de palavras-chave a serem usadas na criação de um público-alvo personalizado.

LeadFormAssetRecommendation

Esse tipo não tem campos.

A recomendação de recurso de formulário de lead.

Melhorar a recomendação de força do DemandGenAd

Recomendação para melhorar a qualidade do anúncio da Geração de demanda.

Representação JSON 
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
Campos
ad

string

Apenas saída. O nome do recurso do anúncio que pode ser melhorado.
adStrength

enum (AdStrength)

Apenas saída. A qualidade atual do anúncio.
demandGenAssetActionItems[]

string

Apenas saída. Uma lista de recomendações para melhorar a qualidade do anúncio.