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ções: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET e MOVE_UNABLE_BUDGET
campaignBudget

string

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

Esse campo será definido para os seguintes tipos de recomendações: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNused_BUDGET
campaign

string

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

Este campo será definido para os seguintes tipos de recomendações: CALL_EXTENSION_EXT.TEXT, CALLOUT_EXTENSION, ENHANCED_CPC_
adGroup

string

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

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

boolean

Apenas saída. Indica 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 estimativa de orçamento da campanha.
keywordRecommendation

object (KeywordRecommendation)

Apenas saída. A recomendação da 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 de ativação da estratégia "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 para ativar os parceiros de pesquisa.
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

Apenas saída. A recomendação de ativação "MaximizarClicks".
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 de tipo de correspondência de palavra-chave.
moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

Apenas saída. A recomendação de orçamento não utilizado da migração.
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 com ROI mínimo.
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

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

object (ResponsiveSearchAdAssetRecommendation)

Apenas saída. A recomendação de recursos de anúncios responsivos 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. Recomendação de melhoria da qualidade do anúncio responsivo de pesquisa.
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

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

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

Apenas saída. Fazer upgrade de uma campanha local para uma recomendação de 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 recomendação de ROAS desejado definido pela estimativa.
calloutAssetRecommendation

object (CalloutAssetRecommendation)

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

object (CallAssetRecommendation)

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

object (ShoppingOfferAttributeRecommendation)

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

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação de adição de cores do Shopping.
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

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

object (ShoppingOfferAttributeRecommendation)

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

object (ShoppingOfferAttributeRecommendation)

Apenas saída. Recomendação do Shopping para adicionar mais identificadores.
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

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

object (ShoppingAddProductsToCampaignRecommendation)

Apenas saída. A recomendação do Shopping para adicionar produtos à campanha
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

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

object (ShoppingTargetAllOffersRecommendation)

Apenas saída. O destino de compras oferece recomendações de todas as ofertas.
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Apenas saída. A correção do Shopping suspendeu a recomendação da conta do Merchant Center.
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

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

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

Apenas saída. O Shopping migra as ofertas da campanha normal do Shopping para a recomendação das campanhas Performance Max.
dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

Apenas saída. Recomendação para ativar as extensões de imagem dinâmicas na conta. Assim, o Google encontra as melhores imagens nas páginas de destino dos anúncios e complementa 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 de ativação das campanhas Performance Max.
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

Apenas saída. A recomendação para melhorar a qualidade do anúncio nas campanhas Performance Max.
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

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

object (ForecastingSetTargetCpaRecommendation)

Apenas saída. A recomendação de CPA desejado definido 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. A recomendação de ativação da estratégia "Maximizar o valor da conversão".
improveGoogleTagCoverageRecommendation

object (ImproveGoogleTagCoverageRecommendation)

Apenas saída. É recomendável 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 suas 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 do recurso de formulário de lead.
improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

Apenas saída. A recomendação para melhorar a 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 de desempenho semanais da conta. Para alguns tipos de recomendações, a média é calculada com base no período dos ú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 da conversão das conversões.
videoViews

number

Apenas saída. Número de exibições de um vídeo em uma campanha de anúncio em vídeo.

CampaignBudgetRecommendation

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 atual do orçamento em micros.
recommendedBudgetAmountMicros

string (int64 format)

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

CampaignBudgetRecommendationOption

Estimativas de impacto para 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 nessa opção.
budgetAmountMicros

string (int64 format)

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

KeywordRecommendation

A recomendação da 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 esta 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. no formato AAAA-MM-DD, por exemplo, 2018-04-17.
autoApplyDate

string

Apenas saída. A data (se presente) será a data mais próxima em que a recomendação será aplicada automaticamente. no 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. Veja o valor necessário do orçamento e o impacto do uso dessa recomendação na lista de opções.

TargetCpaOptInRecommendationOption

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. O objetivo alcançado com essa opção.
impact

object (RecommendationImpact)

Apenas saída. A estimativa de impacto, se esta 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 da conta, 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 TargetCpaOptIn.

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

MaximizeConversionsOptInRecommendation

A recomendação de ativação da estratégia "Maximizar conversões".

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

string (int64 format)

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

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 para ativar os 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 recomendado do orçamento. Definido somente 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 de 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 deve ser mais amplo.
recommendedMatchType

enum (KeywordMatchType)

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

MoveUnusedBudgetRecommendation

A recomendação de orçamento não utilizado da migração.

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

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação para aumentar o orçamento limitado.
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 1000,0.
requiredCampaignBudgetAmountMicros

string (int64 format)

Apenas saída. O orçamento mínimo da campanha, na moeda local da conta, necessário para atingir 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

Usar a recomendação de 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 a serem 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 ficar 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. Só é preenchido com os novos títulos e/ou descrições. Caso contrário, fica vazio.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

Fazer upgrade de uma campanha inteligente do Shopping para uma recomendação de 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. O país em que os produtos do inventário do comerciante precisam ser incluídos.

ResponsiveSearchAdImproveAdStrengthRecommendation

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.

Recomendação de ativação da Inclusão da Rede de Display.

UpgradeLocalCampaignToPerformanceMaxRecommendation

Esse tipo não tem campos.

A recomendação para 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 aumentar o CPA desejado.
averageTargetCpaMicros

string (int64 format)

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

ForecastingSetTargetRoasRecommendation

A recomendação de ROAS desejado definido pela estimativa.

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 1000,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ções de orçamento.

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

string (int64 format)

Apenas saída. Valor atual do orçamento.
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ções: FORECASTING_SET_TARGET_ROAS , FORECASTING_SET_TARGET_CPA AAAA-MM-DD, por exemplo, 17/04/2018.

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 do recurso de sitelink.

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

CallAssetRecommendation

Esse tipo não tem campos.

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

ShoppingOfferAttributeRecommendation

A recomendação de compras para adicionar um atributo às ofertas que são rebaixadas porque está ausente.

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

object (MerchantInfo)

Apenas saída. Os 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 que são rebaixadas devido a atributos ausentes. Acesse o Merchant Center para saber mais.

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 a um inventário da campanha do Shopping.

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

object (MerchantInfo)

Apenas saída. Os 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á anexado à campanha.

Motivo

Problemas que resultam em uma campanha do Shopping que segmenta nenhum produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para 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 de campanha 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 pela campanha.

ShoppingFixDisapprovedProductsRecommendation

A recomendação do Shopping para corrigir produtos reprovados em um inventário da campanha do Shopping.

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

object (MerchantInfo)

Apenas saída. Os 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. Número de produtos da campanha.
disapprovedProductsCount

string (int64 format)

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

ShoppingTargetAllOffersRecommendation

A recomendação do Shopping 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. Os 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. Os detalhes da conta do Merchant Center.
feedLabel

string

Apenas saída. O rótulo do feed da campanha que resultou na suspensão.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

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

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

object (MerchantInfo)

Apenas saída. Os 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âmicas na conta. Assim, o Google encontra as melhores imagens nas páginas de destino dos anúncios e complementa 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. 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. Só é preenchido em campanhas para apps.

TargetAdjustmentInfo

Informações de uma recomendação de ajuste do valor desejado.

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

number

Apenas saída. O fator pelo qual recomendamos o ajuste da meta.
currentAverageTargetMicros

string (int64 format)

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

string

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

AppBiddingGoal

Representa a meta que precisa ser otimizada pela estratégia de lances de uma campanha para apps.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa o valor desconhecido nesta versão da API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME A estratégia de lances da campanha para apps deve ter como objetivo maximizar a instalação do aplicativo.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME A estratégia de lances da campanha para apps precisa ter como objetivo maximizar o volume selecionado de conversões no aplicativo.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE A estratégia de lances da campanha para apps precisa ter como objetivo maximizar o valor de todas as conversões, ou seja, conversões de instalação e seleção no aplicativo.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION A estratégia de lances da campanha para apps precisa ter como objetivo maximizar apenas o volume selecionado da conversão no aplicativo, além de alcançar ou ultrapassar o custo desejado por conversão.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND A estratégia de lances da campanha para apps precisa ter como objetivo maximizar o valor de todas as conversões, ou seja, gerar instalações e conversões selecionadas no aplicativo, além de alcançar ou ultrapassar o retorno do investimento em publicidade desejado.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI Essa estratégia de lances da campanha para apps deve ter como objetivo maximizar a instalação do aplicativo sem 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 ter como objetivo maximizar o pré-registro do aplicativo.

LowerTargetRoasRecommendation

Recomendação para diminuir o ROAS desejado.

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

object (TargetAdjustmentInfo)

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

PerformanceMaxOptInRecommendation

Esse tipo não tem campos.

A recomendação de ativação das campanhas Performance Max.

ImprovePerformanceMaxAdStrengthRecommendation

Recomendação para melhorar a qualidade 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 dos anúncios dinâmicos de pesquisa para as campanhas 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.

É recomendável 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 suas 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 recebeu a recomendação não é necessariamente a conta do proprietário. A conta do proprietário deve 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. 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 mais gastos.
targetingAccountsCount

string (int64 format)

Apenas saída. As listas de usuários podem ser compartilhadas com outras contas pelo proprietário. targetAccountsCount é o número dessas contas que podem usá-las para segmentação.
ownerAccount

object (AccountInfo)

Apenas saída. A conta do proprietário. Essa é a conta que deve 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 de público-alvo personalizado.

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

object (KeywordInfo)

Apenas saída. É a lista de palavras-chave que serão usadas para a criação de públicos-alvo personalizados.

LeadFormAssetRecommendation

Esse tipo não tem campos.

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

ImproveDemandGenAdStrengthRecommendation

A 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.