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_UNUSED_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, 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. Adicione uma 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 para ativar o custo por clique otimizado.
searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

Apenas saída. A recomendação de ativação dos 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 de 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. Adicionar recomendação de anúncio responsivo de pesquisa.
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação de orçamento da campanha com 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 do 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. 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 do conjunto de previsão.
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 cores para anúncios do Shopping.
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

Apenas saída. A recomendação de gênero do item adicionado.
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 do item adicionado.
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

Apenas saída. A recomendação de adicionar produtos à campanha do Shopping.
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 de compras 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.
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 de ativação das campanhas Performance Max.
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

Apenas saída. A recomendação de melhoria da qualidade dos anúncios 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 estimativa definiu uma recomendação de CPA desejado.
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 do 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 de performance semanal da conta. Para alguns tipos de recomendação, 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 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 de orçamento e as estimativas de impacto associadas para alguns valores possíveis 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

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

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 data mais antiga 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 na lista de opções o valor do orçamento necessário e o impacto do uso dessa recomendação.

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 estiver 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 alcançar 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 o valor de retorno. Representa um valor desconhecido nesta versão.
SAME_COST Recomendação para definir o CPA desejado e 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 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 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. Só é definido 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 1000,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 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 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

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

Recomendação de campanha local 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 que o CPA desejado seja aumentado.
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 do conjunto de previsão.

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çã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 vai começar 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. 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 e que foram rebaixadas por falta de atributos. 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 é uma conta 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. 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á associado à campanha.

Motivo

Problemas que resultam em uma campanha do Shopping sem produtos segmentados.

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 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 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. 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. 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 segmenta 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 do Shopping 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 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. 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â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 sobre 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 o 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 no app e de instalação 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 de ativação das 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 suas campanhas Performance Max.

RefreshCustomerMatchListRecommendation

A recomendação de 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 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 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 precisa 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. Lista de palavras-chave a serem 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.

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.