GoogleAdsRow

Uma linha retornada da consulta.

Representação JSON 
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignLifecycleGoal": {
    object (CampaignLifecycleGoal)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productCategoryConstant": {
    object (ProductCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "productLinkInvitation": {
    object (ProductLinkInvitation)
  },
  "recommendation": {
    object (Recommendation)
  },
  "recommendationSubscription": {
    object (RecommendationSubscription)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "localServicesLead": {
    object (LocalServicesLead)
  },
  "localServicesLeadConversation": {
    object (LocalServicesLeadConversation)
  },
  "androidPrivacySharedKeyGoogleAdGroup": {
    object (AndroidPrivacySharedKeyGoogleAdGroup)
  },
  "androidPrivacySharedKeyGoogleCampaign": {
    object (AndroidPrivacySharedKeyGoogleCampaign)
  },
  "androidPrivacySharedKeyGoogleNetworkType": {
    object (AndroidPrivacySharedKeyGoogleNetworkType)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
Campos
accountBudget

object (AccountBudget)

O orçamento da conta na consulta.
accountBudgetProposal

object (AccountBudgetProposal)

A proposta de orçamento da conta mencionada na consulta.
adGroup

object (AdGroup)

Grupo de anúncios mencionado na consulta.
adGroupAd

object (AdGroupAd)

O anúncio mencionado na consulta.
adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

Visualização de combinações de recursos de anúncio do grupo de anúncios na consulta.
adGroupAdAssetView

object (AdGroupAdAssetView)

A visualização dos recursos de anúncio do grupo de anúncios na consulta.
adGroupAdLabel

object (AdGroupAdLabel)

O rótulo do anúncio do grupo de anúncios mencionado na consulta.
adGroupAsset

object (AdGroupAsset)

O recurso do grupo de anúncios mencionado na consulta.
adGroupAssetSet

object (AdGroupAssetSet)

O conjunto de recursos do grupo de anúncios mencionado na consulta.
adGroupAudienceView

object (AdGroupAudienceView)

A visualização do público-alvo do grupo de anúncios mencionada na consulta.
adGroupBidModifier

object (AdGroupBidModifier)

O modificador de lance mencionado na consulta.
adGroupCriterion

object (AdGroupCriterion)

O critério indicado na consulta.
adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

O personalizador de critério do grupo de anúncios mencionado na consulta.
adGroupCriterionLabel

object (AdGroupCriterionLabel)

O rótulo do critério do grupo de anúncios mencionado na consulta.
adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

Simulação de critério do grupo de anúncios mencionada na consulta.
adGroupCustomizer

object (AdGroupCustomizer)

O personalizador de grupo de anúncios mencionado na consulta.
adGroupExtensionSetting

object (AdGroupExtensionSetting)

A configuração da extensão do grupo de anúncios mencionada na consulta.
adGroupFeed

object (AdGroupFeed)

O feed do grupo de anúncios mencionado na consulta.
adGroupLabel

object (AdGroupLabel)

O rótulo do grupo de anúncios mencionado na consulta.
adGroupSimulation

object (AdGroupSimulation)

Simulação de grupo de anúncios mencionada na consulta.
adParameter

object (AdParameter)

O parâmetro de anúncio referenciado na consulta.
ageRangeView

object (AgeRangeView)

A visualização de faixa etária referenciada na consulta.
adScheduleView

object (AdScheduleView)

A visualização da programação de anúncios referenciada na consulta.
domainCategory

object (DomainCategory)

A categoria de domínio indicada na consulta.
asset

object (Asset)

O recurso referenciado na consulta.
assetFieldTypeView

object (AssetFieldTypeView)

A visualização do tipo de campo do recurso referenciada na consulta.
assetGroupAsset

object (AssetGroupAsset)

O recurso do grupo de recursos referenciado na consulta.
assetGroupSignal

object (AssetGroupSignal)

O indicador do grupo de recursos referenciado na consulta.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

O filtro do grupo de produtos anunciados do grupo de recursos mencionado na consulta.
assetGroupProductGroupView

object (AssetGroupProductGroupView)

A visualização do grupo de produtos do grupo de recursos mencionada na consulta.
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

A visualização de combinação superior do grupo de recursos mencionada na consulta.
assetGroup

object (AssetGroup)

O grupo de recursos referenciado na consulta.
assetSetAsset

object (AssetSetAsset)

O recurso do conjunto de recursos referenciado na consulta.
assetSet

object (AssetSet)

O conjunto de recursos referenciado na consulta.
assetSetTypeView

object (AssetSetTypeView)

A visualização do tipo de conjunto de recursos referenciada na consulta.
batchJob

object (BatchJob)

Trabalho em lote mencionado na consulta.
biddingDataExclusion

object (BiddingDataExclusion)

A exclusão de dados de lances mencionada na consulta.
biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

O ajuste periódico dos lances mencionado na consulta.
biddingStrategy

object (BiddingStrategy)

Estratégia de lances mencionada na consulta.
biddingStrategySimulation

object (BiddingStrategySimulation)

Simulação de estratégia de lances mencionada na consulta.
billingSetup

object (BillingSetup)

A configuração de faturamento mencionada na consulta.
callView

object (CallView)

A visualização da chamada referenciada na consulta.
campaignBudget

object (CampaignBudget)

Orçamento da campanha mencionado na consulta.
campaign

object (Campaign)

A campanha mencionada na consulta.
campaignAsset

object (CampaignAsset)

O recurso da campanha mencionado na consulta.
campaignAssetSet

object (CampaignAssetSet)

O conjunto de recursos da campanha referenciado na consulta.
campaignAudienceView

object (CampaignAudienceView)

A visualização do público-alvo da campanha mencionada na consulta.
campaignBidModifier

object (CampaignBidModifier)

O modificador de lance da campanha mencionado na consulta.
campaignConversionGoal

object (CampaignConversionGoal)

A CampaignConversionGoal referenciada na consulta.
campaignCriterion

object (CampaignCriterion)

O critério de campanha indicado na consulta.
campaignCustomizer

object (CampaignCustomizer)

O personalizador de campanha mencionado na consulta.
campaignDraft

object (CampaignDraft)

O rascunho de campanha mencionado na consulta.
campaignExtensionSetting

object (CampaignExtensionSetting)

A configuração de extensão da campanha mencionada na consulta.
campaignFeed

object (CampaignFeed)

O feed de campanha mencionado na consulta.
campaignGroup

object (CampaignGroup)

Grupo de campanhas mencionado na consulta AWQL.
campaignLabel

object (CampaignLabel)

O rótulo da campanha mencionado na consulta.
campaignLifecycleGoal

object (CampaignLifecycleGoal)

Meta do ciclo de vida da campanha mencionada na consulta.
campaignSearchTermInsight

object (CampaignSearchTermInsight)

O insight do termo de pesquisa da campanha mencionado na consulta.
campaignSharedSet

object (CampaignSharedSet)

Conjunto compartilhado da campanha mencionado na consulta AWQL.
campaignSimulation

object (CampaignSimulation)

Simulação de campanha mencionada na consulta.
carrierConstant

object (CarrierConstant)

A constante da operadora referenciada na consulta.
changeEvent

object (ChangeEvent)

O ChangeEvent indicado na consulta.
changeStatus

object (ChangeStatus)

ChangeStatus mencionado na consulta.
combinedAudience

object (CombinedAudience)

O CombineAudience mencionado na consulta.
audience

object (Audience)

O público-alvo mencionado na consulta.
conversionAction

object (ConversionAction)

Ação de conversão mencionada na consulta.
conversionCustomVariable

object (ConversionCustomVariable)

A variável personalizada de conversão referenciada na consulta.
conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

A ConversionGoalCampaignConfig mencionada na consulta.
conversionValueRule

object (ConversionValueRule)

A regra do valor da conversão mencionada na consulta.
conversionValueRuleSet

object (ConversionValueRuleSet)

O conjunto de regras do valor da conversão mencionado na consulta.
clickView

object (ClickView)

O ClickView mencionado na consulta.
currencyConstant

object (CurrencyConstant)

A constante de moeda referenciada na consulta.
customAudience

object (CustomAudience)

O CustomAudience referenciado na consulta.
customConversionGoal

object (CustomConversionGoal)

O CustomConversionGoal mencionado na consulta.
customInterest

object (CustomInterest)

O Custom Interest referenciado na consulta.
customer

object (Customer)

O cliente mencionado na consulta.
customerAsset

object (CustomerAsset)

O recurso do cliente mencionado na consulta.
customerAssetSet

object (CustomerAssetSet)

O conjunto de recursos do cliente mencionado na consulta.
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

A estratégia de lances acessível mencionada na consulta.
customerCustomizer

object (CustomerCustomizer)

O personalizador do cliente mencionado na consulta.
customerClient

object (CustomerClient)

O CustomerClient mencionado na consulta.
customerConversionGoal

object (CustomerConversionGoal)

O CustomerConversionGoal mencionado na consulta.
customerExtensionSetting

object (CustomerExtensionSetting)

A configuração de extensão do cliente mencionada na consulta.
customerFeed

object (CustomerFeed)

O feed de clientes mencionado na consulta.
customerLabel

object (CustomerLabel)

O rótulo do cliente mencionado na consulta.
customerLifecycleGoal

object (CustomerLifecycleGoal)

A meta do ciclo de vida do cliente mencionada na consulta.
customerNegativeCriterion

object (CustomerNegativeCriterion)

O critério negativo do cliente mencionado na consulta.
customerSearchTermInsight

object (CustomerSearchTermInsight)

O insight do termo de pesquisa do cliente mencionado na consulta.
customerUserAccess

object (CustomerUserAccess)

O CustomerUserAccess mencionado na consulta.
customerUserAccessInvitation

object (CustomerUserAccessInvitation)

O CustomerUserAccessInvitation mencionado na consulta.
customizerAttribute

object (CustomizerAttribute)

O atributo do personalizador referenciado na consulta.
detailPlacementView

object (DetailPlacementView)

A visualização de detalhes da posição mencionada na consulta.
detailedDemographic

object (DetailedDemographic)

É o grupo demográfico detalhado mencionado na consulta.
displayKeywordView

object (DisplayKeywordView)

A visualização de palavra-chave da Rede de Display referenciada na consulta.
distanceView

object (DistanceView)

A visualização da distância referenciada na consulta.
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa mencionada na consulta.
expandedLandingPageView

object (ExpandedLandingPageView)

A visualização da página de destino expandida mencionada na consulta.
extensionFeedItem

object (ExtensionFeedItem)

O item do feed da extensão mencionado na consulta.
feed

object (Feed)

O feed mencionado na consulta.
feedItem

object (FeedItem)

O item do feed mencionado na consulta.
feedItemSet

object (FeedItemSet)

O item de feed definido como referência na consulta.
feedItemTarget

object (FeedItemTarget)

Destino do item de feed mencionado na consulta.
feedMapping

object (FeedMapping)

O mapeamento de feeds mencionado na consulta.
feedPlaceholderView

object (FeedPlaceholderView)

A visualização do marcador de posição do feed mencionada na consulta.
genderView

object (GenderView)

A visualização de gênero referenciada na consulta.
geoTargetConstant

object (GeoTargetConstant)

A constante de segmentação geográfica referenciada na consulta.
geographicView

object (GeographicView)

A visualização geográfica referenciada na consulta.
groupPlacementView

object (GroupPlacementView)

A visualização da posição do grupo referenciada na consulta.
hotelGroupView

object (HotelGroupView)

A visualização do grupo de hotéis mencionada na consulta.
hotelPerformanceView

object (HotelPerformanceView)

A visualização de desempenho do hotel referenciada na consulta.
hotelReconciliation

object (HotelReconciliation)

Reconciliação de hotéis mencionada na consulta.
incomeRangeView

object (IncomeRangeView)

Visualização da faixa de renda mencionada na consulta.
keywordView

object (KeywordView)

Visualização de palavra-chave referenciada na consulta.
keywordPlan

object (KeywordPlan)

Plano de palavras-chave mencionado na consulta.
keywordPlanCampaign

object (KeywordPlanCampaign)

Campanha do plano de palavras-chave mencionada na consulta.
keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

A palavra-chave da campanha do plano de palavras-chave mencionada na consulta.
keywordPlanAdGroup

object (KeywordPlanAdGroup)

O grupo de anúncios do plano de palavras-chave mencionado na consulta.
keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

O grupo de anúncios do plano de palavras-chave mencionado na consulta.
keywordThemeConstant

object (KeywordThemeConstant)

A constante de tema de palavra-chave referenciada na consulta.
label

object (Label)

O rótulo referenciado na consulta.
landingPageView

object (LandingPageView)

A visualização da página de destino mencionada na consulta.
languageConstant

object (LanguageConstant)

A constante de linguagem referenciada na consulta.
locationView

object (LocationView)

A visualização do local referenciada na consulta.
managedPlacementView

object (ManagedPlacementView)

A visualização da seleção manual de canais mencionada na consulta.
mediaFile

object (MediaFile)

O arquivo de mídia referenciado na consulta.
localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

O artefato de verificação de serviços locais mencionado na consulta.
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

A constante da categoria de app para dispositivos móveis referenciada na consulta.
mobileDeviceConstant

object (MobileDeviceConstant)

A constante de dispositivo móvel referenciada na consulta.
offlineConversionUploadClientSummary

object (OfflineConversionUploadClientSummary)

Resumo do cliente do upload de conversões off-line.
offlineUserDataJob

object (OfflineUserDataJob)

O job de dados do usuário off-line mencionado na consulta.
operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

A constante de versão do sistema operacional referenciada na consulta.
paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

Visualização do termo de pesquisa orgânica paga mencionada na consulta.
qualifyingQuestion

object (QualifyingQuestion)

A pergunta de qualificação citada na consulta.
parentalStatusView

object (ParentalStatusView)

A visualização do status parental mencionada na consulta.
perStoreView

object (PerStoreView)

A visualização por loja referenciada na consulta.
productCategoryConstant

object (ProductCategoryConstant)

A categoria do produto indicada na consulta.
productGroupView

object (ProductGroupView)

A visualização do grupo de produtos referenciada na consulta.
recommendation

object (Recommendation)

Recomendação referenciada na consulta.
recommendationSubscription

object (RecommendationSubscription)

A assinatura de recomendação referenciada na consulta.
searchTermView

object (SearchTermView)

Visualização do termo de pesquisa mencionado na consulta.
sharedCriterion

object (SharedCriterion)

O conjunto compartilhado referenciado na consulta.
sharedSet

object (SharedSet)

O conjunto compartilhado referenciado na consulta.
smartCampaignSetting

object (SmartCampaignSetting)

A configuração da campanha inteligente mencionada na consulta.
shoppingPerformanceView

object (ShoppingPerformanceView)

A visualização de desempenho de compras referenciada na consulta.
smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

Visualização do termo de pesquisa da campanha inteligente mencionado na consulta.
topicView

object (TopicView)

A visualização de tópicos referenciada na consulta.
travelActivityGroupView

object (TravelActivityGroupView)

A visualização do grupo de atividades de viagem referenciada na consulta.
travelActivityPerformanceView

object (TravelActivityPerformanceView)

A visualização de desempenho das atividades de viagem referenciada na consulta.
experiment

object (Experiment)

O experimento mencionado na consulta.
experimentArm

object (ExperimentArm)

O grupo experimental mencionado na consulta.
userInterest

object (UserInterest)

O interesse do usuário referenciado na consulta.
lifeEvent

object (LifeEvent)

O evento importante referenciado na consulta.
userList

object (UserList)

A lista de usuários referenciada na consulta.
userLocationView

object (UserLocationView)

A visualização do local do usuário referenciada na consulta.
remarketingAction

object (RemarketingAction)

A ação de remarketing referenciada na consulta.
topicConstant

object (TopicConstant)

A constante de tópico referenciada na consulta.
video

object (Video)

Vídeo mencionado na consulta.
webpageView

object (WebpageView)

A visualização da página da Web mencionada na consulta.
leadFormSubmissionData

object (LeadFormSubmissionData)

O envio do usuário do formulário de lead mencionado na consulta.
localServicesLead

object (LocalServicesLead)

O lead de serviços locais mencionado na consulta.
localServicesLeadConversation

object (LocalServicesLeadConversation)

O lead de serviços locais mencionado na consulta.
androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

O grupo de anúncios do Google com chave compartilhada de privacidade do Android mencionado na consulta.
androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

A campanha do Google de chave compartilhada de privacidade do Android mencionada na consulta.
androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

O tipo de rede do Google da chave compartilhada de privacidade do Android mencionado na consulta.
metrics

object (Metrics)

As métricas.
segments

object (Segments)

Os segmentos.

AccountBudget

Um orçamento em nível de conta. Ela contém informações sobre o orçamento, bem como as alterações aprovadas mais recentemente no orçamento e as alterações propostas que estão com aprovação pendente. As alterações propostas com aprovação pendente, se houver, são encontradas em "pendingProposal". Detalhes efetivos sobre o orçamento são encontrados nos campos com prefixo "allowed_", "adjusted_" e aqueles sem prefixo. Como alguns detalhes efetivos podem ser diferentes do que o usuário solicitou originalmente (por exemplo, limite de gastos), essas diferenças são justapostas por meio dos campos "propoed_", "aprovado_" e, possivelmente, "ajustado_".

Este recurso é modificado usando AccountBudgetProposal e não pode ser mudado diretamente. Um orçamento pode ter no máximo uma proposta pendente por vez. Ela é lida por pendingProposal.

Depois de aprovado, um orçamento pode estar sujeito a ajustes, como ajustes de crédito. Os ajustes criam diferenças entre os campos "aprovado" e "ajustado", que de outra forma seriam idênticos.

Representação JSON 
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

  // Union field proposed_end_time can be only one of the following:
  "proposedEndDateTime": string,
  "proposedEndTimeType": enum (TimeType)
  // End of list of possible types for union field proposed_end_time.

  // Union field approved_end_time can be only one of the following:
  "approvedEndDateTime": string,
  "approvedEndTimeType": enum (TimeType)
  // End of list of possible types for union field approved_end_time.

  // Union field proposed_spending_limit can be only one of the following:
  "proposedSpendingLimitMicros": string,
  "proposedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field proposed_spending_limit.

  // Union field approved_spending_limit can be only one of the following:
  "approvedSpendingLimitMicros": string,
  "approvedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field approved_spending_limit.

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
Campos
resourceName

string

Apenas saída. O nome do recurso do orçamento em nível de conta. Os nomes dos recursos AccountBudget têm o seguinte formato:

customers/{customerId}/accountBudgets/{account_budget_id}
status

enum (AccountBudgetStatus)

Apenas saída. O status desse orçamento em nível de conta.
totalAdjustmentsMicros

string (int64 format)

Apenas saída. O valor total dos ajustes.

Um exemplo de ajuste são os créditos de cortesia.
amountServedMicros

string (int64 format)

Apenas saída. O valor dos anúncios que foram veiculados, em micros.

Isso inclui os custos de superfornecimento. Nesse caso, um crédito poderá ser aplicado automaticamente ao orçamento (consulte totalAdjustmentsMicros).
pendingProposal

object (PendingAccountBudgetProposal)

Apenas saída. A proposta pendente para modificar o orçamento, se aplicável.
id

string (int64 format)

Apenas saída. O ID do orçamento em nível de conta.
billingSetup

string

Apenas saída. O nome do recurso da configuração de faturamento associada a esse orçamento no nível da conta. Os nomes dos recursos do BillingSetup têm o seguinte formato:

customers/{customerId}/billingSetups/{billing_setup_id}
name

string

Apenas saída. O nome do orçamento em nível de conta.
proposedStartDateTime

string

Apenas saída. A hora de início proposta do orçamento em nível de conta no formato aaaa-MM-dd HH:mm:ss. Se o tipo de horário de início NOW foi proposto, esse é o horário da solicitação.
approvedStartDateTime

string

Apenas saída. A hora de início aprovada do orçamento em nível de conta no formato aaaa-MM-dd HH:mm:ss.

Por exemplo, se um novo orçamento for aprovado após o horário de início proposto, o horário de início aprovado será o momento da aprovação.
purchaseOrderNumber

string

Apenas saída. O número da ordem de compra é um valor que ajuda os usuários a consultar esse orçamento nas faturas mensais.
notes

string

Apenas saída. Observações associadas ao orçamento.
Campo de união proposed_end_time. O horário de término proposto para o orçamento em nível de conta. proposed_end_time pode ser apenas de um dos tipos a seguir:
proposedEndDateTime

string

Apenas saída. O horário de término proposto no formato aaaa-MM-dd HH:mm:ss.
proposedEndTimeType

enum (TimeType)

Apenas saída. O horário de término proposto como um tipo bem definido, por exemplo, FOREVER.

Campo de união approved_end_time. O horário de término aprovado do orçamento em nível de conta.

Por exemplo, se o horário de término de um orçamento for atualizado e a proposta for aprovada após o horário de término proposto, o horário de término aprovado será o horário da aprovação. approved_end_time pode ser apenas de um dos tipos a seguir:
approvedEndDateTime

string

Apenas saída. A hora de término aprovada no formato aaaa-MM-dd HH:mm:ss.
approvedEndTimeType

enum (TimeType)

Apenas saída. O horário de término aprovado como um tipo bem definido, por exemplo, PARA SEMPRE.
Campo de união proposed_spending_limit. O limite de gastos proposto. proposed_spending_limit pode ser apenas de um dos tipos a seguir:
proposedSpendingLimitMicros

string (int64 format)

Apenas saída. O limite de gastos proposto em micros. Um milhão de micros é equivalente a uma unidade.
proposedSpendingLimitType

enum (SpendingLimitType)

Apenas saída. O limite de gastos proposto como um tipo bem definido, por exemplo, INFINITE.

Campo de união approved_spending_limit. O limite de gastos aprovado.

Por exemplo, se o valor já gasto pela conta exceder o limite de gastos proposto no momento em que a proposta for aprovada, esse limite será definido como o valor já gasto. approved_spending_limit pode ser apenas de um dos tipos a seguir:
approvedSpendingLimitMicros

string (int64 format)

Apenas saída. O limite de gastos aprovado, em micros. Um milhão de micros é equivalente a uma unidade. Só será preenchido se o limite de gastos proposto for finito e sempre será maior ou igual ao limite de gastos proposto.
approvedSpendingLimitType

enum (SpendingLimitType)

Apenas saída. O limite de gastos aprovado como um tipo bem definido, por exemplo, INFINITE. Só será preenchido se o limite de gastos aprovado for INFINITE.

Campo de união adjusted_spending_limit. O limite de gastos após a aplicação dos ajustes. Os ajustes são armazenados em total_adjustments_micros.

Esse valor tem a palavra final sobre quanto a conta pode gastar. adjusted_spending_limit pode ser apenas de um dos tipos a seguir:
adjustedSpendingLimitMicros

string (int64 format)

Apenas saída. O limite de gastos ajustado em micros. Um milhão de micros é equivalente a uma unidade.

Se o limite de gastos aprovado for finito, o limite de gastos ajustado poderá variar dependendo dos tipos de ajustes aplicados ao orçamento, se aplicável.

Os diferentes tipos de ajustes são descritos aqui: https://support.google.com/google-ads/answer/1704323

Por exemplo, um ajuste de débito reduz os gastos da conta.
adjustedSpendingLimitType

enum (SpendingLimitType)

Apenas saída. O limite de gastos ajustado como um tipo bem definido, por exemplo, INFINITE. Só será preenchido se o limite de gastos ajustado for INFINITE, o que vai ser verdadeiro se o limite de gastos aprovado for INFINITE.

AccountBudgetStatus

Os status possíveis de um AccountBudget.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PENDING A aprovação do orçamento da conta está pendente.
APPROVED O orçamento da conta foi aprovado.
CANCELLED O orçamento da conta foi cancelado pelo usuário.

PendingAccountBudgetProposal

Uma proposta pendente associada ao orçamento em nível de conta, se aplicável.

Representação JSON 
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
Campos
proposalType

enum (AccountBudgetProposalType)

Apenas saída. O tipo da proposta, por exemplo, FIM para encerrar o orçamento associado a ela.
accountBudgetProposal

string

Apenas saída. O nome do recurso da proposta. Os nomes dos recursos AccountBudgetProposal têm o seguinte formato:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}
name

string

Apenas saída. O nome a atribuir ao orçamento em nível de conta.
startDateTime

string

Apenas saída. A hora de início no formato aaaa-MM-dd HH:mm:ss.
purchaseOrderNumber

string

Apenas saída. O número da ordem de compra é um valor que ajuda os usuários a consultar esse orçamento nas faturas mensais.
notes

string

Apenas saída. Observações associadas a este orçamento.
creationDateTime

string

Apenas saída. A hora em que a proposta de orçamento no nível da conta foi criada. Formatado como aaaa-MM-dd HH:mm:ss.
Campo de união end_time. O horário de término do orçamento em nível de conta. end_time pode ser apenas de um dos tipos a seguir:
endDateTime

string

Apenas saída. A hora de término no formato aaaa-MM-dd HH:mm:ss.
endTimeType

enum (TimeType)

Apenas saída. O horário de término como um tipo bem definido, por exemplo, FOREVER.
Campo de união spending_limit. O limite de gastos. spending_limit pode ser apenas de um dos tipos a seguir:
spendingLimitMicros

string (int64 format)

Apenas saída. O limite de gastos, em micros. Um milhão de micros é equivalente a uma unidade.
spendingLimitType

enum (SpendingLimitType)

Apenas saída. O limite de gastos como um tipo bem definido, por exemplo, INFINITE.

AdGroupAdAssetCombinationView

Uma visualização sobre o uso da combinação de recursos de anúncio do grupo de anúncios. Agora, oferecemos compatibilidade apenas com adgroupAdAssetCombineView em anúncios responsivos de pesquisa, e há mais tipos de anúncios planejados para o futuro.

Representação JSON 
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de combinações de recursos de anúncio do grupo de anúncios. O ID de combinação tem 128 bits, em que os 64 bits mais altos são armazenados em asset_combine_id_high e os 64 bits inferiores são armazenados em asset_combine_id_low. Os nomes dos recursos de visualização de combinações de recursos do grupo de anúncios têm o seguinte formato: customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}
servedAssets[]

object (AssetUsage)

Apenas saída. Recursos veiculados.
enabled

boolean

Apenas saída. O status entre a combinação de recursos e a versão mais recente do anúncio. Se for verdadeiro, a combinação de recursos será vinculada à versão mais recente do anúncio. Se for falso, isso significa que o link existia antes, mas foi removido e não está mais presente na versão mais recente do anúncio.

AssetUsage

Contém as informações de uso do recurso.

Representação JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Campos
asset

string

Nome do recurso.
servedAssetFieldType

enum (ServedAssetFieldType)

O tipo de campo veiculado do recurso.

AdGroupAdAssetView

Um link entre um adgroupAd e um recurso. No momento, só oferecemos suporte a DatasetAdAssetView para AppAds e anúncios responsivos de pesquisa.

Representação JSON 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "source": enum (AssetSource),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do recurso de anúncio do grupo de anúncios. Os nomes dos recursos de visualização de recursos de anúncios do grupo de anúncios têm o seguinte formato (antes da V4):

customers/{customerId}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

Os nomes dos recursos de visualização de recursos de anúncios do grupo de anúncios têm o seguinte formato (a partir da V4):

customers/{customerId}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}
fieldType

enum (AssetFieldType)

Apenas saída. A função que o recurso assume no anúncio.
policySummary

object (AdGroupAdAssetPolicySummary)

Apenas saída. Informações de política para o recurso de anúncio do grupo de anúncios.
performanceLabel

enum (AssetPerformanceLabel)

Apenas saída. Desempenho de uma vinculação de recursos.
pinnedField

enum (ServedAssetFieldType)

Apenas saída. Campo fixado.
source

enum (AssetSource)

Apenas saída. Origem do recurso de anúncio do grupo de anúncios.
adGroupAd

string

Apenas saída. O anúncio do grupo de anúncios ao qual o recurso está vinculado.
asset

string

Apenas saída. O recurso que está vinculado ao anúncio do grupo de anúncios.
enabled

boolean

Apenas saída. O status entre o recurso e a versão mais recente do anúncio. Se verdadeiro, o recurso é vinculado à versão mais recente do anúncio. Se for falso, isso significa que o link existia antes, mas foi removido e não está mais presente na versão mais recente do anúncio.

AdGroupAdAssetPolicySummary

Contém informações de política para um recurso de anúncio do grupo de anúncios.

Representação JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Campos
policyTopicEntries[]

object (PolicyTopicEntry)

Apenas saída. A lista de descobertas da política para o recurso de anúncio do grupo de anúncios.
reviewStatus

enum (PolicyReviewStatus)

Apenas saída. Em que ponto do processo de revisão esse recurso de anúncio do grupo de anúncios está.
approvalStatus

enum (PolicyApprovalStatus)

Apenas saída. O status geral de aprovação desse recurso de anúncio do grupo de anúncios, calculado com base no status das entradas individuais do tópico da política.

AdGroupAudienceView

Uma visualização do público-alvo do grupo de anúncios. Inclui dados de desempenho dos interesses e das listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios da rede de pesquisa (RLSA), agregados no nível do público-alvo.

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

string

Apenas saída. O nome do recurso da visualização do público-alvo do grupo de anúncios. Os nomes dos recursos de visualização de público-alvo do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupCriterionSimulation

Uma simulação de critério de grupo de anúncios. As combinações aceitas de tipo de canal de publicidade, tipo de critério, tipo de simulação e método de modificação de simulação estão detalhadas abaixo. Operações de simulação de gclid de hotel a partir da V5.

  1. DISPLAY – PALAVRA-CHAVE – CPC_BID – UNIFORM
  2. PESQUISA – PALAVRA-CHAVE – CPC_BID – UNIFORM
  3. SHOPPING – LISTING_GROUP – CPC_BID – UNIFORM
  4. HOTEL – LISTING_GROUP – CPC_BID – UNIFORM
  5. HOTEL – LISTING_GROUP – PERCENT_CPC_BID – UNIFORM
Representação JSON 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Campos
resourceName

string

Apenas saída. O nome do recurso da simulação de critério do grupo de anúncios. Os nomes dos recursos de simulação de critérios do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroupCriterionSimulations/{adGroupId}~{criterionId}~{type}~{modificationMethod}~{startDate}~{endDate}
type

enum (SimulationType)

Apenas saída. O campo que a simulação modifica.
modificationMethod

enum (SimulationModificationMethod)

Apenas saída. Como a simulação modifica o campo.
adGroupId

string (int64 format)

Apenas saída. ID do grupo de anúncios da simulação.
criterionId

string (int64 format)

Apenas saída. ID do critério da simulação.
startDate

string

Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD.
endDate

string

Apenas saída. Último dia em que a simulação se baseia, no formato AAAA-MM-DD.
Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
cpcBidPointList

object (CpcBidSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for CPC_BID.
percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for PERCENT_CPC_BID.

SimulationType

Enumeração que descreve o campo que uma simulação modifica.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CPC_BID A simulação é para um lance de CPC.
CPV_BID A simulação é para um lance de CPV.
TARGET_CPA A simulação é para um CPA desejado.
BID_MODIFIER A simulação é para um modificador de lance.
TARGET_ROAS A simulação é para um ROAS desejado.
PERCENT_CPC_BID A simulação é para um lance percentual de CPC.
TARGET_IMPRESSION_SHARE A simulação é para uma meta de parcela de impressões.
BUDGET A simulação é para um orçamento.

SimulationModificationMethod

Enumeração que descreve o método pelo qual uma simulação modifica um campo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
UNIFORM Os valores em uma simulação foram aplicados de maneira uniforme a todos os filhos de um determinado recurso. As modificações nos recursos filhos não foram respeitadas.
DEFAULT Os valores em uma simulação foram aplicados ao recurso especificado. As modificações nos recursos filhos foram respeitadas, e as estimativas de tráfego não incluem esses recursos.
SCALING Todos os valores em uma simulação foram dimensionados pelo mesmo fator. Por exemplo, em uma campanha de TargetCpa simulada, as segmentações da campanha e de todos os grupos de anúncios foram dimensionadas por um fator de X.

CpcBidSimulationPointList

Um contêiner com pontos de simulação para simulações do tipo CPC_BID.

Representação JSON 
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
Campos
points[]

object (CpcBidSimulationPoint)

Métricas projetadas para uma série de valores de lance de CPC.

CpcBidSimulationPoint

Projeção de métricas para um valor específico de lance de CPC.

Representação JSON 
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
Campos
requiredBudgetAmountMicros

string (int64 format)

É o orçamento diário previsto e necessário que o anunciante precisa definir para receber o tráfego estimado, em micros da moeda do anunciante.
biddableConversions

number

Número projetado de conversões que recebem lances.
biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.
clicks

string (int64 format)

Número projetado de cliques.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
topSlotImpressions

string (int64 format)

Número projetado de impressões do slot principal. Somente o tipo de canal de publicidade de pesquisa suporta este campo.
Campo de união cpc_simulation_key_value. Quando SimulationModifiedMethod = UNIFORM ou DEFAULT, cpc_bid_micros é definido. Quando SimulationModifiedMethod = SCALING, cpc_bid_scaling_modifier é definido. cpc_simulation_key_value pode ser apenas de um dos tipos a seguir:
cpcBidMicros

string (int64 format)

O lance de CPC simulado no qual as métricas projetadas se baseiam.
cpcBidScalingModifier

number

O modificador de escalonamento simulado em que as métricas projetadas são baseadas. Todos os lances de CPC relevantes para a entidade simulada são ajustados por esse modificador.

PercentCpcBidSimulationPointList

Um contêiner para pontos de simulação para simulações do tipo PERCENT_CPC_BID.

Representação JSON 
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
Campos
points[]

object (PercentCpcBidSimulationPoint)

Métricas projetadas para uma série de valores percentuais de lance de CPC.

PercentCpcBidSimulationPoint

Projeção de métricas para um valor percentual específico de CPC. Somente o tipo de canal de publicidade de hotel aceita esse campo.

Representação JSON 
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Campos
percentCpcBidMicros

string (int64 format)

O CPC percentual simulado em que as métricas projetadas se baseiam. Percentual de CPC expresso como fração do preço anunciado de algum produto ou serviço. O valor armazenado aqui é 1.000.000 * [fração].
biddableConversions

number

Número projetado de conversões que recebem lances.
biddableConversionsValue

number

Valor total previsto das conversões que recebem lances na moeda local.
clicks

string (int64 format)

Número projetado de cliques.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
topSlotImpressions

string (int64 format)

Número projetado de impressões do slot principal.

AdGroupSimulation

Uma simulação de grupo de anúncios. As combinações suportadas de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação estão detalhadas abaixo.

  1. PESQUISA - CPC_BID - PADRÃO
  2. PESQUISA - CPC_BID - UNIFORM
  3. PESQUISA - TARGET_CPA - UNIFORM
  4. PESQUISA - TARGET_ROAS - UNIFORM
  5. DISPLAY – CPC_BID – PADRÃO
  6. DISPLAY - CPC_BID - UNIFORM
  7. DISPLAY - TARGET_CPA - UNIFORM
Representação JSON 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Campos
resourceName

string

Apenas saída. O nome do recurso da simulação do grupo de anúncios. Os nomes dos recursos de simulação do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroupSimulations/{adGroupId}~{type}~{modificationMethod}~{startDate}~{endDate}
type

enum (SimulationType)

Apenas saída. O campo que a simulação modifica.
modificationMethod

enum (SimulationModificationMethod)

Apenas saída. Como a simulação modifica o campo.
adGroupId

string (int64 format)

Apenas saída. ID do grupo de anúncios da simulação.
startDate

string

Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD.
endDate

string

Apenas saída. Último dia em que a simulação se baseia, no formato AAAA-MM-DD.
Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
cpcBidPointList

object (CpcBidSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for CPC_BID.
cpvBidPointList

object (CpvBidSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for CPV_BID.
targetCpaPointList

object (TargetCpaSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_CPA.
targetRoasPointList

object (TargetRoasSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_ROAS.

CpvBidSimulationPointList

Um contêiner com pontos de simulação para simulações do tipo CPV_BID.

Representação JSON 
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
Campos
points[]

object (CpvBidSimulationPoint)

Métricas projetadas para uma série de valores de lances de CPV.

CpvBidSimulationPoint

Projeção de métricas para um valor específico de lance de CPV.

Representação JSON 
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
Campos
cpvBidMicros

string (int64 format)

O lance de CPV simulado em que as métricas projetadas se baseiam.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
views

string (int64 format)

Número projetado de visualizações.

TargetCpaSimulationPointList

Um contêiner para pontos de simulação para simulações do tipo TARGET_CPA.

Representação JSON 
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
Campos
points[]

object (TargetCpaSimulationPoint)

Métricas projetadas para uma série de valores de CPA desejado.

TargetCpaSimulationPoint

Projeção de métricas para um valor específico de CPA desejado.

Representação JSON 
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
Campos
requiredBudgetAmountMicros

string (int64 format)

É o orçamento diário previsto e necessário que o anunciante precisa definir para receber o tráfego estimado, em micros da moeda do anunciante.
appInstalls

number

Número projetado de instalações de apps.
inAppActions

number

Número estimado de ações no app.
biddableConversions

number

Número projetado de conversões que recebem lances.
biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.
clicks

string (int64 format)

Número projetado de cliques.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
topSlotImpressions

string (int64 format)

Número projetado de impressões do slot principal. Somente o tipo de canal de publicidade de pesquisa suporta este campo.
interactions

string (int64 format)

Número projetado de interações. Somente o tipo de canal de publicidade Discovery é compatível com esse campo.
Campo de união target_cpa_simulation_key_value. Quando SimulationModifiedMethod = UNIFORM ou DEFAULT, target_cpa_micros é definido. Quando SimulationModificaçãoMethod = SCALING, target_cpa_scaling_modifier é definido. target_cpa_simulation_key_value pode ser apenas de um dos tipos a seguir:
targetCpaMicros

string (int64 format)

O CPA desejado simulado em que as métricas projetadas são baseadas.
targetCpaScalingModifier

number

O modificador de escalonamento simulado em que as métricas projetadas são baseadas. Todas as metas de CPA relevantes para a entidade simulada são dimensionadas por esse modificador.

TargetRoasSimulationPointList

Um contêiner com pontos de simulação para simulações do tipo TARGET_ROAS.

Representação JSON 
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
Campos
points[]

object (TargetRoasSimulationPoint)

Métricas projetadas para uma série de valores de ROAS desejado.

TargetRoasSimulationPoint

Métricas projetadas para um valor específico de ROAS desejado.

Representação JSON 
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Campos
requiredBudgetAmountMicros

string (int64 format)

É o orçamento diário previsto e necessário que o anunciante precisa definir para receber o tráfego estimado, em micros da moeda do anunciante.
targetRoas

number

O ROAS desejado simulado em que as métricas projetadas são baseadas.
biddableConversions

number

Número projetado de conversões que recebem lances.
biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.
clicks

string (int64 format)

Número projetado de cliques.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
topSlotImpressions

string (int64 format)

Número projetado de impressões do slot principal. Somente o tipo de canal de publicidade de pesquisa aceita esse campo.

AgeRangeView

Uma visualização por faixa etária.

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

string

Apenas saída. O nome do recurso da visualização por faixa etária. Os nomes dos recursos de visualização de faixa etária têm o seguinte formato:

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

AdScheduleView

Uma visualização da programação de anúncios resume o desempenho das campanhas por critérios do AdSchedule.

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

string

Apenas saída. O nome do recurso da visualização da programação de anúncios. Os nomes dos recursos de visualização do AdSchedule têm o seguinte formato:

customers/{customerId}/adScheduleViews/{campaignId}~{criterionId}

DomainCategory

Uma categoria gerada automaticamente pelo rastreamento de um domínio. Se uma campanha usar DynamicSearchAdsSetting, categorias de domínio serão geradas para o domínio. As categorias podem ser segmentadas usando WebpageConditionInfo. Acesse: https://support.google.com/google-ads/answer/2471185

Representação JSON 
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da categoria do domínio. Os nomes dos recursos da categoria de domínio têm o seguinte formato:

customers/{customerId}/domainCategories/{campaignId}~{category_base64}~{languageCode}
campaign

string

Apenas saída. A campanha para a qual essa categoria é recomendada.
category

string

Apenas saída. Categoria recomendada para o domínio do site. Por exemplo, se você tem um site sobre eletrônicos, as categorias podem ser "câmeras", "televisões" etc.
languageCode

string

Apenas saída. O código de idioma que especifica o idioma do site, por exemplo, "en" para inglês. O idioma pode ser especificado no DynamicSearchAdsSetting necessário para anúncios dinâmicos da rede de pesquisa. Esse é o idioma das páginas do seu site que você quer que o Google Ads encontre, para as quais crie anúncios e com as quais faça a correspondência de pesquisas.
domain

string

Apenas saída. O domínio do site. O domínio pode ser especificado no DynamicSearchAdsSetting necessário para anúncios dinâmicos da rede de pesquisa.
coverageFraction

number

Apenas saída. Fração de páginas no seu site que correspondem a esta categoria.
categoryRank

string (int64 format)

Apenas saída. A posição desta categoria no conjunto de categorias. Números menores indicam uma correspondência melhor para o domínio. "null" indica que não é recomendado.
hasChildren

boolean

Apenas saída. Indica se essa categoria tem subcategorias.
recommendedCpcBidMicros

string (int64 format)

Apenas saída. Custo por clique recomendado para a categoria.

AssetFieldTypeView

Uma visualização de tipo de campo de recurso. Essa visualização informa métricas não contadas em excesso para cada tipo de campo de recurso quando o recurso é usado como extensão.

Representação JSON 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de tipo de campo do recurso. Os nomes dos recursos de visualização do tipo de campo do recurso têm o seguinte formato:

customers/{customerId}/assetFieldTypeViews/{fieldType}
fieldType

enum (AssetFieldType)

Apenas saída. O tipo de campo do recurso na visualização de tipo de campo.

AssetGroupProductGroupView

Uma visualização de grupo de produtos do grupo de recursos.

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

string

Apenas saída. O nome do recurso da visualização do grupo de produtos do grupo de recursos. Os nomes dos recursos de visualização do grupo de produtos do grupo de recursos têm o seguinte formato:

customers/{customerId}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

Apenas saída. O grupo de recursos associado ao filtro do grupo de fichas.
assetGroupListingGroupFilter

string

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

AssetGroupTopCombinationView

Uma visualização sobre o uso da combinação de recursos de anúncio do grupo de anúncios.

Representação JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de combinação superior do grupo de recursos. Os nomes dos recursos da visualização de principais combinações de recursos têm o seguinte formato: `"customers/{customerId}/assetGroupTopCombineViews/{asset_group_id}~{asset_comparison_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Apenas saída. As principais combinações de recursos que foram veiculados em conjunto.

AssetGroupAssetCombinationData

Dados de combinação de recursos do grupo de recursos

Representação JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Campos
assetCombinationServedAssets[]

object (AssetUsage)

Apenas saída. Recursos veiculados.

AssetSetTypeView

Uma visualização de tipo de conjunto de recursos. Essa visualização informa métricas não contadas em excesso para cada tipo de conjunto de recursos. Os tipos de conjuntos de recursos filhos não estão incluídos neste relatório. As estatísticas são agregadas no tipo de conjunto de recursos principal.

Representação JSON 
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do tipo do conjunto de recursos. Os nomes dos recursos de visualização do tipo de conjunto de recursos têm o seguinte formato:

customers/{customerId}/assetSetTypeViews/{assetSetType}
assetSetType

enum (AssetSetType)

Apenas saída. O tipo de conjunto de recursos da visualização de tipo de conjunto de recursos.

BiddingStrategySimulation

Uma simulação de estratégia de lances. As combinações aceitas de tipo de simulação e método de modificação de simulação são detalhadas abaixo.

  1. TARGET_CPA: UNIFORM
  2. TARGET_ROAS – UNIFORM
Representação JSON 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Campos
resourceName

string

Apenas saída. O nome do recurso da simulação da estratégia de lances. Os nomes dos recursos de simulação da estratégia de lances têm o seguinte formato:

customers/{customerId}/biddingStrategySimulations/{biddingStrategyId}~{type}~{modificationMethod}~{startDate}~{endDate}
biddingStrategyId

string (int64 format)

Apenas saída. ID do conjunto compartilhado da estratégia de lances da simulação.
type

enum (SimulationType)

Apenas saída. O campo que a simulação modifica.
modificationMethod

enum (SimulationModificationMethod)

Apenas saída. Como a simulação modifica o campo.
startDate

string

Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD.
endDate

string

Apenas saída. Último dia em que a simulação se baseia, no formato AAAA-MM-DD.
Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
targetCpaPointList

object (TargetCpaSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_CPA.
targetRoasPointList

object (TargetRoasSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_ROAS.

CallView

Uma visualização de chamadas que inclui dados para o acompanhamento de chamadas de anúncios só para chamadas ou extensões de chamada.

Representação JSON 
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização da chamada. Os nomes dos recursos de visualização de chamadas têm o seguinte formato:

customers/{customerId}/callViews/{call_detail_id}
callerCountryCode

string

Apenas saída. Código do país do autor da chamada.
callerAreaCode

string

Apenas saída. Código de área do autor da chamada. Nulo se a duração da chamada for menor que 15 segundos.
callDurationSeconds

string (int64 format)

Apenas saída. A duração em segundos da chamada fornecida pelo anunciante.
startCallDateTime

string

Apenas saída. A hora de início da chamada fornecida pelo anunciante.
endCallDateTime

string

Apenas saída. A data de término da chamada fornecida pelo anunciante.
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

Apenas saída. O local de exibição do acompanhamento de chamadas.
type

enum (CallType)

Apenas saída. O tipo da chamada.
callStatus

enum (GoogleVoiceCallStatus)

Apenas saída. Status da chamada.

CallTrackingDisplayLocation

Possíveis locais de exibição do acompanhamento de chamadas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
AD A chamada telefônica feita pelo anúncio.
LANDING_PAGE A ligação feita do anúncio da página de destino direciona o cliente.

CallType

Possíveis tipos de propriedade em que a chamada foi feita.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
MANUALLY_DIALED A chamada foi discada manualmente.

GoogleVoiceCallStatus

Possíveis status de uma chamada do Google Voice.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
MISSED A ligação não foi atendida.
RECEIVED A ligação foi recebida.

CampaignAudienceView

Visualização do público-alvo da campanha Inclui dados de desempenho dos interesses e das listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios da rede de pesquisa (RLSA), agregadas por critério de campanha e público-alvo. Essa visualização só inclui públicos-alvo anexados no nível da campanha.

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

string

Apenas saída. O nome do recurso da visualização do público-alvo da campanha. Os nomes dos recursos de visualização de público-alvo da campanha têm o seguinte formato:

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignSearchTermInsight

Uma visualização do termo de pesquisa da campanha. Os dados históricos estão disponíveis a partir de março de 2023.

Representação JSON 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do insight do termo de pesquisa no nível da campanha. Os nomes dos recursos de insights de termos de pesquisa no nível da campanha têm o seguinte formato:

customers/{customerId}/campaignSearchTermInsights/{campaignId}~{categoryId}
categoryLabel

string

Apenas saída. O rótulo da categoria de pesquisa. Uma string vazia indica a categoria abrangente para termos de pesquisa que não se encaixam em outra categoria.
id

string (int64 format)

Apenas saída. O ID do insight.
campaignId

string (int64 format)

Apenas saída. O ID da campanha.

CampaignSimulation

Uma simulação de campanha. As combinações suportadas de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação estão detalhadas abaixo.

  • PESQUISA - CPC_BID - UNIFORM
  • PESQUISA - CPC_BID - ESCALA
  • PESQUISA - TARGET_CPA - UNIFORM
  • PESQUISA – TARGET_CPA – SCALING
  • PESQUISA - TARGET_ROAS - UNIFORM
  • PESQUISA - TARGET_IMPRESSION_SHARE - UNIFORM
  • PESQUISA – ORÇAMENTO – UNIFORME
  • SHOPPING – ORÇAMENTO – UNIFORME
  • SHOPPING – TARGET_ROAS – UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • DISCOVERY - TARGET_CPA - DEFAULT
  • DISPLAY - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - ORÇAMENTO - UNIFORM
Representação JSON 
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Campos
resourceName

string

Apenas saída. O nome do recurso da simulação da campanha. Os nomes dos recursos de simulação de campanha têm o seguinte formato:

customers/{customerId}/campaignSimulations/{campaignId}~{type}~{modificationMethod}~{startDate}~{endDate}
campaignId

string (int64 format)

Apenas saída. ID da campanha da simulação.
type

enum (SimulationType)

Apenas saída. O campo que a simulação modifica.
modificationMethod

enum (SimulationModificationMethod)

Apenas saída. Como a simulação modifica o campo.
startDate

string

Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD.
endDate

string

Apenas saída. Último dia em que a simulação se baseia, no formato AAAA-MM-DD.
Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
cpcBidPointList

object (CpcBidSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for CPC_BID.
targetCpaPointList

object (TargetCpaSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_CPA.
targetRoasPointList

object (TargetRoasSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_ROAS.
targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_IMPRESSION_SHARE.
budgetPointList

object (BudgetSimulationPointList)

Apenas saída. Pontos de simulação se o tipo de simulação for BUDGET.

TargetImpressionShareSimulationPointList

Um contêiner para pontos de simulação para simulações do tipo TARGET_IMPRESSION_SHARE.

Representação JSON 
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
Campos
points[]

object (TargetImpressionShareSimulationPoint)

São as métricas projetadas para um valor específico da parcela de impressões desejada.

TargetImpressionShareSimulationPoint

São as métricas projetadas para um valor específico da parcela de impressões desejada.

Representação JSON 
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
Campos
targetImpressionShareMicros

string (int64 format)

É o valor simulado da parcela de impressões desejada (em micros) no qual as métricas projetadas se baseiam. Por exemplo, uma parcela de impressões de 10%, que é igual a 0,1, é armazenada como 100_000. Este valor é validado e não vai exceder 1 milhão (100%).
requiredCpcBidCeilingMicros

string (int64 format)

Projeção do limite diário de lance de CPC diário que o anunciante deve definir para realizar a simulação, em micros da moeda do anunciante.
requiredBudgetAmountMicros

string (int64 format)

É o orçamento diário previsto e necessário que o anunciante precisa definir para receber o tráfego estimado, em micros da moeda do anunciante.
biddableConversions

number

Número projetado de conversões que recebem lances.
biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.
clicks

string (int64 format)

Número projetado de cliques.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
topSlotImpressions

string (int64 format)

Número projetado de impressões do slot principal. Somente o tipo de canal de publicidade de pesquisa suporta este campo.
absoluteTopImpressions

string (int64 format)

Número estimado de impressões na primeira posição Somente o tipo de canal de publicidade de pesquisa suporta este campo.

BudgetSimulationPointList

Um contêiner com pontos de simulação para simulações do tipo BUDGET.

Representação JSON 
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
Campos
points[]

object (BudgetSimulationPoint)

Métricas projetadas para uma série de valores de orçamento.

BudgetSimulationPoint

Métricas projetadas para um valor de orçamento específico.

Representação JSON 
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string
}
Campos
budgetAmountMicros

string (int64 format)

O orçamento simulado em que as métricas projetadas se baseiam.
requiredCpcBidCeilingMicros

string (int64 format)

Projeção do limite diário de lance de CPC diário que o anunciante deve definir para realizar a simulação, em micros da moeda do anunciante. Somente campanhas com a estratégia de lances de gasto desejado aceitam esse campo.
biddableConversions

number

Número projetado de conversões que recebem lances.
biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.
clicks

string (int64 format)

Número projetado de cliques.
costMicros

string (int64 format)

Custo projetado em micros.
impressions

string (int64 format)

Número projetado de impressões.
topSlotImpressions

string (int64 format)

Número projetado de impressões do slot principal. Somente o tipo de canal de publicidade de pesquisa suporta este campo.
interactions

string (int64 format)

Número projetado de interações. Somente o tipo de canal de publicidade Discovery é compatível com esse campo.

CarrierConstant

Um critério de operadora que pode ser usado na segmentação da campanha.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do critério da operadora. Os nomes dos recursos de critério de operadora têm o seguinte formato:

carrierConstants/{criterionId}
id

string (int64 format)

Apenas saída. O ID do critério da operadora.
name

string

Apenas saída. O nome completo da operadora em inglês.
countryCode

string

Apenas saída. O código do país onde a operadora está localizada, por exemplo, "AR", "FR" etc.

ChangeEvent

Descreve a mudança granular de recursos retornados de determinados tipos de recursos. As mudanças feitas na interface ou na API nos últimos 30 dias são incluídas. Os valores anteriores e novos dos campos alterados são mostrados. O ChangeEvent pode ter um atraso de até três minutos para refletir uma nova alteração.

Representação JSON 
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do evento de alteração. Os nomes dos recursos de eventos de alteração têm o seguinte formato:

customers/{customerId}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}
changeDateTime

string

Apenas saída. Horário em que a alteração foi confirmada neste recurso.
changeResourceType

enum (ChangeEventResourceType)

Apenas saída. O tipo do recurso alterado. Isso determina qual recurso será definido em oldResource e newResource.
changeResourceName

string

Apenas saída. O recurso "Simples" em que essa mudança ocorreu.
clientType

enum (ChangeClientType)

Apenas saída. Onde a mudança foi feita.
userEmail

string

Apenas saída. O e-mail do usuário que fez a alteração.
oldResource

object (ChangedResource)

Apenas saída. O recurso antigo antes da alteração. Somente os campos alterados serão preenchidos.
newResource

object (ChangedResource)

Apenas saída. O novo recurso após a alteração. Somente os campos alterados serão preenchidos.
resourceChangeOperation

enum (ResourceChangeOperation)

Apenas saída. A operação no recurso alterado.
changedFields

string (FieldMask format)

Apenas saída. Uma lista de campos que são alterados no recurso retornado.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
campaign

string

Apenas saída. A campanha afetada por essa alteração.
adGroup

string

Apenas saída. O grupo de anúncios afetado por essa alteração.
feed

string

Apenas saída. O feed afetado por essa mudança.
feedItem

string

Apenas saída. O item de feed afetado por essa alteração.
asset

string

Apenas saída. O recurso afetado por essa mudança.

ChangeEventResourceType

Enumeração que lista os tipos de recurso compatíveis com o recurso ChangeEvent.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um recurso não classificado desconhecido nesta versão.
AD Uma alteração no recurso de anúncios.
AD_GROUP Uma alteração de recurso do Grupo de anúncios.
AD_GROUP_CRITERION Uma alteração no recurso vTPM.
CAMPAIGN Uma alteração no recurso Campanha.
CAMPAIGN_BUDGET Uma alteração no recurso CampaignBudget.
AD_GROUP_BID_MODIFIER Uma alteração de recurso DatasetBidModifier.
CAMPAIGN_CRITERION Uma alteração no recurso CampaignCriteria.
FEED Uma alteração no recurso de feed.
FEED_ITEM Uma alteração de recurso de item de feed.
CAMPAIGN_FEED Uma alteração no recurso CampaignFeed.
AD_GROUP_FEED Uma alteração no recurso AdGroupFeed.
AD_GROUP_AD Uma alteração no recurso seg-adsAd.
ASSET Uma alteração no recurso de recurso.
CUSTOMER_ASSET Uma mudança no recurso CustomerAsset.
CAMPAIGN_ASSET Uma alteração no recurso CampaignAsset.
AD_GROUP_ASSET Uma alteração no recurso AdGroupAsset.
ASSET_SET Uma alteração no recurso AssetSet.
ASSET_SET_ASSET Uma mudança no recurso AssetSetAsset.
CAMPAIGN_ASSET_SET Uma alteração no recurso CampaignAssetSet.

ChangeClientType

A origem do recurso changeEvent.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um tipo de cliente não classificado desconhecido nesta versão.
GOOGLE_ADS_WEB_CLIENT Alterações feitas em "ads.google.com". Por exemplo, mudanças feitas por meio do gerenciamento de campanhas.
GOOGLE_ADS_AUTOMATED_RULE Alterações feitas pelas regras automatizadas do Google Ads.
GOOGLE_ADS_SCRIPTS Alterações feitas por meio de scripts do Google Ads.
GOOGLE_ADS_BULK_UPLOAD Alterações feitas pelo upload em massa do Google Ads.
GOOGLE_ADS_API Alterações feitas pela API Google Ads.
GOOGLE_ADS_EDITOR Alterações feitas pelo Google Ads Editor. Esse valor é um marcador de posição. A API não retorna essas alterações.
GOOGLE_ADS_MOBILE_APP Alterações feitas pelo app Google Ads para dispositivos móveis.
GOOGLE_ADS_RECOMMENDATIONS Alterações feitas pelas recomendações do Google Ads.
SEARCH_ADS_360_SYNC Alterações feitas pela sincronização do Search Ads 360.
SEARCH_ADS_360_POST Alterações feitas pela publicação do Search Ads 360.
INTERNAL_TOOL Mudanças feitas usando ferramentas internas. Por exemplo, quando um usuário define um modelo de URL em uma entidade como uma campanha, ele é automaticamente unido com o URL do servidor de cliques do SA360.
OTHER Tipos de alterações que não são categorizadas, por exemplo, alterações feitas por resgate de cupons por meio do Google Ads.
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION Alterações feitas ao se inscrever nas recomendações do Google Ads.

ChangedResource

Um .proto de wrapper que apresenta todos os recursos compatíveis. Somente o recurso do changeResourceType será definido.

Representação JSON 
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
Campos
ad

object (Ad)

Apenas saída. Definido se changeResourceType == AD.
adGroup

object (AdGroup)

Apenas saída. Definido se changeResourceType == AD_GROUP.
adGroupCriterion

object (AdGroupCriterion)

Apenas saída. Definido se changeResourceType == AD_GROUP_criteria
campaign

object (Campaign)

Apenas saída. Defina se changeResourceType == CAMPAIGN.
campaignBudget

object (CampaignBudget)

Apenas saída. Definido se changeResourceType == CAMPAIGN_BUDGET.
adGroupBidModifier

object (AdGroupBidModifier)

Apenas saída. Definido se changeResourceType == AD_GROUP_BID_MODIFIER.
campaignCriterion

object (CampaignCriterion)

Apenas saída. Defina se changeResourceType == CAMPAIGN_ etapa.
feed

object (Feed)

Apenas saída. Definido se changeResourceType == FEED.
feedItem

object (FeedItem)

Apenas saída. Definido se changeResourceType == FEED_ITEM.
campaignFeed

object (CampaignFeed)

Apenas saída. Definido se changeResourceType == CAMPAIGN_FEED.
adGroupFeed

object (AdGroupFeed)

Apenas saída. Definido se changeResourceType == AD_GROUP_FEED.
adGroupAd

object (AdGroupAd)

Apenas saída. Definido se changeResourceType == AD_GROUP_AD.
asset

object (Asset)

Apenas saída. Definido se changeResourceType == ASSET.
customerAsset

object (CustomerAsset)

Apenas saída. Definido se changeResourceType == CUSTOMER_ASSET.
campaignAsset

object (CampaignAsset)

Apenas saída. Definido se changeResourceType == CAMPAIGN_ASSET.
adGroupAsset

object (AdGroupAsset)

Apenas saída. Definido se changeResourceType == AD_GROUP_ASSET.
assetSet

object (AssetSet)

Apenas saída. Definido se changeResourceType == ASSET_SET.
assetSetAsset

object (AssetSetAsset)

Apenas saída. Definido se changeResourceType == ASSET_SET_ASSET.
campaignAssetSet

object (CampaignAssetSet)

Apenas saída. Definido se changeResourceType == CAMPAIGN_ASSET_SET.

ResourceChangeOperation

A operação no recurso alterado no recurso changeEvent.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa uma operação não classificada desconhecida nesta versão.
CREATE O recurso foi criado.
UPDATE O recurso foi modificado.
REMOVE O recurso foi removido.

ChangeStatus

Descreve o status do recurso retornado. O ChangeStatus pode ter um atraso de até três minutos para refletir uma nova alteração.

Representação JSON 
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do status da alteração. Os nomes dos recursos de status de alteração têm o seguinte formato:

customers/{customerId}/changeStatus/{change_status_id}
resourceType

enum (ChangeStatusResourceType)

Apenas saída. Representa o tipo do recurso alterado. Isso determina quais campos serão definidos. Por exemplo, para AD_GROUP, os campos campaign e adGroup serão definidos.
resourceStatus

enum (ChangeStatusOperation)

Apenas saída. Representa o status do recurso alterado.
sharedSet

string

Apenas saída. O SharedSet afetado por essa mudança.
campaignSharedSet

string

Apenas saída. O CampaignSharedSet afetado por essa alteração.
asset

string

Apenas saída. O recurso afetado por essa mudança.
customerAsset

string

Apenas saída. O CustomerAsset afetado por esta mudança.
campaignAsset

string

Apenas saída. O CampaignAsset afetado por essa alteração.
adGroupAsset

string

Apenas saída. O grupo de anúncios afetado por essa alteração.
combinedAudience

string

Apenas saída. O público-alvo combinado afetado por essa mudança.
lastChangeDateTime

string

Apenas saída. Horário em que a alteração mais recente ocorreu nesse recurso.
campaign

string

Apenas saída. A campanha afetada por essa alteração.
adGroup

string

Apenas saída. O grupo de anúncios afetado por essa alteração.
adGroupAd

string

Apenas saída. O GroupAd afetado por essa alteração.
adGroupCriterion

string

Apenas saída. O gclid afetado por essa alteração.
campaignCriterion

string

Apenas saída. O Campaigncriterio afetado por essa alteração.
feed

string

Apenas saída. O feed afetado por essa mudança.
feedItem

string

Apenas saída. O item de feed afetado por essa alteração.
adGroupFeed

string

Apenas saída. O GroupFeed afetado por essa alteração.
campaignFeed

string

Apenas saída. O CampaignFeed afetado por essa alteração.
adGroupBidModifier

string

Apenas saída. O GroupBidModifier afetado por essa alteração.

ChangeStatusResourceType

Enumeração que lista os tipos de recurso compatíveis com o recurso ChangeStatus.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um recurso não classificado desconhecido nesta versão.
AD_GROUP Uma alteração de recurso do Grupo de anúncios.
AD_GROUP_AD Uma alteração no recurso seg-adsAd.
AD_GROUP_CRITERION Uma alteração no recurso vTPM.
CAMPAIGN Uma alteração no recurso Campanha.
CAMPAIGN_CRITERION Uma alteração no recurso CampaignCriteria.
FEED Uma alteração no recurso de feed.
FEED_ITEM Uma alteração de recurso de item de feed.
AD_GROUP_FEED Uma alteração no recurso AdGroupFeed.
CAMPAIGN_FEED Uma alteração no recurso CampaignFeed.
AD_GROUP_BID_MODIFIER Uma alteração de recurso DatasetBidModifier.
SHARED_SET Uma alteração no recurso SharedSet.
CAMPAIGN_SHARED_SET Uma alteração no recurso CampaignSharedSet.
ASSET Uma alteração no recurso de recurso.
CUSTOMER_ASSET Uma mudança no recurso CustomerAsset.
CAMPAIGN_ASSET Uma alteração no recurso CampaignAsset.
AD_GROUP_ASSET Uma alteração no recurso AdGroupAsset.
COMBINED_AUDIENCE Uma mudança no recurso MergeAudience.

ChangeStatusOperation

Status do recurso alterado

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um recurso não classificado desconhecido nesta versão.
ADDED O recurso foi criado.
CHANGED O recurso foi modificado.
REMOVED O recurso foi removido.

CombinedAudience

Descreva um recurso para públicos-alvo combinados que inclua diferentes públicos.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
Campos
resourceName

string

Imutável. O nome do recurso do público-alvo combinado. Os nomes de públicos-alvo combinados têm o seguinte formato:

customers/{customerId}/combinedAudience/{combined_audience_id}
id

string (int64 format)

Apenas saída. ID do público-alvo combinado.
status

enum (CombinedAudienceStatus)

Apenas saída. Status deste público-alvo combinado. Indica se o público-alvo combinado está ativado ou removido.
name

string

Apenas saída. Nome do público-alvo combinado. Ele precisa ser único em todos os públicos-alvo combinados.
description

string

Apenas saída. Descrição deste público-alvo combinado.

CombinedAudienceStatus

Enumeração que contém os possíveis tipos de status do público-alvo combinado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED Status ativado: o público-alvo combinado está ativado e pode ser segmentado.
REMOVED Status "Removido": o público-alvo combinado foi removido e não pode ser usado para segmentação.

ClickView

Uma visualização de clique com métricas agregadas em cada nível de clique, incluindo cliques válidos e inválidos. Para campanhas que não são da rede de pesquisa, metrics.clicks representa o número de interações válidas e inválidas. Consultas que incluem ClickView devem ter um filtro que limite os resultados a um dia e podem ser solicitadas para datas até 90 dias antes do momento da solicitação.

Representação JSON 
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização com clique. Os nomes dos recursos de visualização têm o seguinte formato:

customers/{customerId}/clickViews/{date (yyyy-MM-dd)}~{gclid}
areaOfInterest

object (ClickLocation)

Apenas saída. Os critérios de local que correspondem à área de interesse associada à impressão.
locationOfPresence

object (ClickLocation)

Apenas saída. Os critérios de local que correspondem ao local de presença associado à impressão.
keyword

string

Apenas saída. A palavra-chave associada, se houver, e o clique corresponder ao canal SEARCH.
keywordInfo

object (KeywordInfo)

Apenas saída. Informações básicas sobre a palavra-chave associada, se houver.
gclid

string

Apenas saída. O ID de clique do Google.
pageNumber

string (int64 format)

Apenas saída. Número da página nos resultados de pesquisa em que o anúncio foi exibido.
adGroupAd

string

Apenas saída. O anúncio associado.
campaignLocationTarget

string

Apenas saída. O local de segmentação associado à campanha, se houver.
userList

string

Apenas saída. A lista de usuários associados, se houver.

ClickLocation

Critérios de local associados a um clique.

Representação JSON 
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
Campos
city

string

O critério do local da cidade associado à impressão.
country

string

O critério do local de país associado à impressão.
metro

string

O critério de localização de área metropolitana associado à impressão.
mostSpecific

string

O critério de local mais específico associado à impressão.
region

string

O critério do local da região associado à impressão.

CurrencyConstant

Uma constante de moeda.

Representação JSON 
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de moeda. Os nomes de recursos de constante de moeda têm o seguinte formato:

currencyConstants/{code}
code

string

Apenas saída. Código de moeda de três letras do ISO 4217, por exemplo, "USD"
name

string

Apenas saída. Nome completo da moeda em inglês.
symbol

string

Apenas saída. Símbolo padrão para descrever esta moeda, por exemplo, "$" para dólares americanos.
billableUnitMicros

string (int64 format)

Apenas saída. A unidade faturável desta moeda. Os valores faturados precisam ser múltiplos desse valor.

AccessibleBiddingStrategy

Representa uma visualização de BiddingStrategies que pertencem e são compartilhadas com o cliente.

Em contraste com a BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e são compartilhadas com ele, além das estratégias que pertencem a ele. Esse recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos BiddingStrategy.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Campos
resourceName

string

Apenas saída. O nome do recurso da estratégia de lances acessível. Os nomes dos recursos AccessibleBiddingStrategy têm o seguinte formato:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}
id

string (int64 format)

Apenas saída. O ID da estratégia de lances.
name

string

Apenas saída. É o nome da estratégia de lances.
type

enum (BiddingStrategyType)

Apenas saída. É o tipo de estratégia de lances.
ownerCustomerId

string (int64 format)

Apenas saída. O ID do cliente proprietário da estratégia de lances.
ownerDescriptiveName

string

Somente saída. DescriptionName do Cliente que é proprietário da estratégia de lances.

Campo de união scheme. O esquema de lances.

Somente um pode ser definido. scheme pode ser apenas de um dos tipos a seguir:
maximizeConversionValue

object (MaximizeConversionValue)

Apenas saída. Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.
maximizeConversions

object (MaximizeConversions)

Apenas saída. Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.
targetCpa

object (TargetCpa)

Apenas saída. Uma estratégia que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido.
targetImpressionShare

object (TargetImpressionShare)

Apenas saída. Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões.
targetRoas

object (TargetRoas)

Apenas saída. Uma estratégia de lances que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.
targetSpend

object (TargetSpend)

Apenas saída. Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento.

MaximizeConversionValue

Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.

Representação JSON 
{
  "targetRoas": number
}
Campos
targetRoas

number

Apenas saída. Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento.

MaximizeConversions

Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.

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

string (int64 format)

Apenas saída. A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição.

TargetCpa

Uma estratégia de lances automática que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido.

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

string (int64 format)

Apenas saída. Meta de CPA médio. Essa meta deve ser maior ou igual ao mínimo de unidades faturáveis baseadas na moeda da conta.

TargetImpressionShare

Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja exibida na parte superior da primeira página (ou em outra região de segmentação).

Representação JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Campos
location

enum (TargetImpressionShareLocation)

Apenas saída. A região de segmentação na página de resultados da pesquisa.
locationFractionMicros

string (int64 format)

A fração de anúncios escolhida para ser exibida na região de segmentação, em micros. Por exemplo, 1% é igual a 10.000.
cpcBidCeilingMicros

string (int64 format)

Apenas saída. O lance de CPC mais alto que o sistema de lances automáticos pode especificar. É um campo obrigatório inserido pelo anunciante que estabelece o limite e é especificado nos micros locais.

TargetRoas

Uma estratégia de lances automáticos que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.

Representação JSON 
{
  "targetRoas": number
}
Campos
targetRoas

number

Apenas saída. Receita escolhida (com base nos dados de conversão) por unidade de gasto.

TargetSpend

Uma estratégia de lances automática que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

Representação JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Campos
targetSpendMicros
(deprecated)

string (int64 format)

Apenas saída. A meta de gastos na qual maximizar os cliques. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html (link em inglês) para mais detalhes.
cpcBidCeilingMicros

string (int64 format)

Apenas saída. Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia.

CustomerClient

Um link entre um determinado cliente e um cliente cliente. Os CustomerClients só existem para clientes administradores. Todos os clientes diretos e indiretos estão incluídos, além do próprio gerente.

Representação JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do cliente do cliente. Os nomes dos recursos do CustomerClient têm o formato: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

Apenas saída. Os nomes dos recursos dos rótulos de propriedade do cliente solicitante que são aplicados ao cliente do cliente. Os nomes dos recursos de rótulo têm o seguinte formato:

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

Apenas saída. O status do cliente. Somente leitura.
clientCustomer

string

Apenas saída. O nome do recurso cliente-cliente vinculado ao cliente em questão. Somente leitura.
hidden

boolean

Apenas saída. Especifica se a conta é oculta. Somente leitura.
level

string (int64 format)

Apenas saída. A distância entre o cliente e o cliente. Para "self link", o valor do nível será 0. Somente leitura.
timeZone

string

Apenas saída. Representação da string Common Locale Data Repository (CLDR) do fuso horário do cliente, por exemplo, America/Los_Angeles. Somente leitura.
testAccount

boolean

Apenas saída. Identifica se o cliente é uma conta de teste. Somente leitura.
manager

boolean

Apenas saída. Identifica se o cliente é um gerente. Somente leitura.
descriptiveName

string

Apenas saída. Nome descritivo para o cliente. Somente leitura.
currencyCode

string

Apenas saída. Código da moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura.
id

string (int64 format)

Apenas saída. O ID do cliente. Somente leitura.

CustomerSearchTermInsight

Uma visualização do termo de pesquisa do cliente. Os dados históricos estão disponíveis a partir de março de 2023.

Representação JSON 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do insight do termo de pesquisa no nível do cliente. Os nomes dos recursos de insights de termos de pesquisa no nível do cliente têm o seguinte formato:

customers/{customerId}/customerSearchTermInsights/{categoryId}
categoryLabel

string

Apenas saída. O rótulo da categoria de pesquisa. Uma string vazia indica a categoria abrangente para termos de pesquisa que não se encaixam em outra categoria.
id

string (int64 format)

Apenas saída. O ID do insight.

DetailPlacementView

Uma visualização com métricas agregadas por grupo de anúncios e URL ou vídeo do YouTube.

Representação JSON 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização da posição dos detalhes. Os nomes dos recursos de visualização de posições de detalhes têm o seguinte formato:

customers/{customerId}/detailPlacementViews/{adGroupId}~{base64_placement}
placementType

enum (PlacementType)

Apenas saída. Tipo de canal, por exemplo, "Site", "Vídeo do YouTube" e "Aplicativo para dispositivos móveis".
placement

string

Apenas saída. A string de seleção automática de canais no nível dos detalhes, por exemplo, URL do site, ID do aplicativo para dispositivos móveis ou ID do vídeo do YouTube.
displayName

string

Apenas saída. O nome de exibição é o nome do URL de sites, o nome do vídeo do YouTube para vídeos do YouTube e o nome traduzido do app para dispositivos móveis.
groupPlacementTargetUrl

string

Apenas saída. URL do canal do grupo, por exemplo, domínio, link do aplicativo para dispositivos móveis na app store ou o URL de um canal do YouTube.
targetUrl

string

Apenas saída. URL do canal, por exemplo, site, link para o aplicativo para dispositivos móveis na app store ou URL de vídeo do YouTube.

PlacementType

Possíveis tipos de posições para um mapeamento de feed.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
WEBSITE Sites(por exemplo, "www.flores4vendas.com.br").
MOBILE_APP_CATEGORY Categorias de aplicativos para dispositivos móveis, como "Jogos".
MOBILE_APPLICATION aplicativos para dispositivos móveis(por exemplo, "mobileapp::2-com.whatsthewordanswers").
YOUTUBE_VIDEO Vídeos do YouTube(por exemplo, "youtube.com/video/wtLJPvx7-ys").
YOUTUBE_CHANNEL Canais do YouTube(por exemplo, "youtube.com::L8ZULXASCc1I_oaOT0NaOQ").
GOOGLE_PRODUCTS Plataformas pertencentes e operadas pelo Google(por exemplo, "tv.google.com").

DetailedDemographic

Um grupo demográfico detalhado: uma indústria específica com base em interesses a ser segmentada para alcançar usuários com base em fatos biográficos de longa duração.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Campos
resourceName

string

Apenas saída. O nome do recurso do grupo demográfico detalhado. Os nomes dos recursos demográficos detalhados têm o seguinte formato:

customers/{customerId}/detailedDemographics/{detailed_demographic_id}
id

string (int64 format)

Apenas saída. É o ID do grupo demográfico detalhado.
name

string

Apenas saída. É o nome do grupo demográfico detalhado. Por exemplo,"Nível mais alto de realização educacional".
parent

string

Apenas saída. O pai de detalheDemográfico.
launchedToAll

boolean

Apenas saída. Verdadeiro se as informações demográficas detalhadas foram lançadas para todos os canais e localidades.
availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade do grupo demográfico detalhado.

CriterionCategoryAvailability

Informações sobre a disponibilidade da categoria por canal de publicidade.

Representação JSON 
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
Campos
channel

object (CriterionCategoryChannelAvailability)

Tipos e subtipos de canal disponíveis para a categoria.
locale[]

object (CriterionCategoryLocaleAvailability)

Localidades disponíveis para a categoria do canal.

CriterionCategoryChannelAvailability

Informações sobre o tipo e os subtipos de canal de publicidade em que uma categoria está disponível.

Representação JSON 
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
Campos
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

Formato da disponibilidade do canal. Pode ser ALL_CHANNELS (o restante dos campos não será definido), CHANNEL_TYPE (somente o tipo advertisingChannelType será definido, a categoria estará disponível para todos os subtipos sob ela) ou CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType e includeDefaultChannelSubType serão definidos).
advertisingChannelType

enum (AdvertisingChannelType)

Tipo de canal para o qual a categoria está disponível.
advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

Subtipos de canal no tipo de canal para o qual a categoria está disponível.
includeDefaultChannelSubType

boolean

Indica se o subtipo de canal padrão está incluído. Por exemplo, se o AdvertisingChannelType for DISPLAY e o includeDefaultChannelSubType for falso, a campanha padrão de display em que o subtipo de canal não está definido não será incluída nessa configuração de disponibilidade.

CriterionCategoryChannelAvailabilityMode

Enumeração contendo o possível CriteriaCategoryChannelAvailabilityMode.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ALL_CHANNELS A categoria está disponível para campanhas de todos os tipos e subtipos de canal.
CHANNEL_TYPE_AND_ALL_SUBTYPES A categoria está disponível para campanhas de um tipo de canal específico, incluindo todos os subtipos dele.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES A categoria está disponível para campanhas de um tipo e subtipo de canal específicos.

CriterionCategoryLocaleAvailability

Informações sobre em quais localidades uma categoria está disponível.

Representação JSON 
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
Campos
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

Formato da disponibilidade de localidade. Pode ser LAUNCHED_TO_ALL (o país e o idioma estarão em branco), COUNTRY (somente o país será definido), LANGUAGE (somente o idioma será definido), COUNTRY_AND_LANGUAGE (o país e o idioma serão definidos).
countryCode

string

O código do país ISO-3166-1 alfa-2 associado à categoria.
languageCode

string

Código ISO 639-1 do idioma associado à categoria.

CriterionCategoryLocaleAvailabilityMode

Enumeração contendo o possível LatLngCategoryLocaleAvailabilityMode.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ALL_LOCALES A categoria está disponível para campanhas de todas as localidades.
COUNTRY_AND_ALL_LANGUAGES A categoria está disponível para campanhas em uma lista de países, independentemente do idioma.
LANGUAGE_AND_ALL_COUNTRIES A categoria está disponível para campanhas em uma lista de idiomas, independentemente do país.
COUNTRY_AND_LANGUAGE A categoria está disponível para campanhas em uma lista de pares de países e idiomas.

DisplayKeywordView

Uma visualização de palavra-chave da Rede de Display.

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

string

Apenas saída. O nome do recurso da visualização de palavra-chave da Rede de Display. Os nomes dos recursos de visualização de palavra-chave da Rede de Display têm o seguinte formato:

customers/{customerId}/displayKeywordViews/{adGroupId}~{criterionId}

DistanceView

Uma visualização da distância com métricas agregadas pela distância do usuário em relação às extensões de local de um anunciante. Cada DistanceBucket inclui todas as impressões que estão dentro de sua distância, e uma única impressão contribuirá para as métricas de todos os DistanceBuckets que incluem a distância do usuário.

Representação JSON 
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de distância. Os nomes dos recursos de visualização de distância têm o seguinte formato:

customers/{customerId}/distanceViews/1~{distanceBucket}
distanceBucket

enum (DistanceBucket)

Apenas saída. Agrupamento de distâncias do usuário das extensões de local.
metricSystem

boolean

Apenas saída. Verdadeiro se o DistanceBucket estiver usando o sistema métrico. Caso contrário, será falso.

DistanceBucket

O intervalo de distância referente à distância de um usuário a partir da extensão de local de um anunciante.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
WITHIN_700M O usuário estava a 700 m do local.
WITHIN_1KM O usuário estava a 1 km do local.
WITHIN_5KM O usuário estava a 5 km do local.
WITHIN_10KM O usuário estava dentro de 10 km do local.
WITHIN_15KM O usuário estava a 15 km do local.
WITHIN_20KM O usuário estava a 20 km do local.
WITHIN_25KM O usuário estava a 25 km do local.
WITHIN_30KM O usuário estava a 30 km do local.
WITHIN_35KM O usuário estava a 35 km do local.
WITHIN_40KM O usuário estava a 40 km do local.
WITHIN_45KM O usuário estava a 45 km do local.
WITHIN_50KM O usuário estava a 50 km do local.
WITHIN_55KM O usuário estava a 55 km do local.
WITHIN_60KM O usuário estava a 60 km do local.
WITHIN_65KM O usuário estava a 65 km do local.
BEYOND_65KM O usuário estava além de 65 km do local.
WITHIN_0_7MILES O usuário estava dentro de 1,1 quilômetro do local.
WITHIN_1MILE O usuário estava a 1,6 km do local.
WITHIN_5MILES O usuário estava a até 8 km do local.
WITHIN_10MILES O usuário estava a até 16 km do local.
WITHIN_15MILES O usuário estava a 25 quilômetros do local.
WITHIN_20MILES O usuário estava a até 32 km do local.
WITHIN_25MILES O usuário estava a até 40 km do local.
WITHIN_30MILES O usuário estava a 48 km do local.
WITHIN_35MILES O usuário estava a 56 km do local.
WITHIN_40MILES O usuário estava a até 40 milhas do local.
BEYOND_40MILES O usuário estava além de 60 quilômetros do local.

DynamicSearchAdsSearchTermView

Visualização do termo de pesquisa em anúncios dinâmicos de pesquisa.

Representação JSON 
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos para visualização de termos de pesquisa nos anúncios dinâmicos de pesquisa têm a seguinte forma:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
searchTerm

string

Apenas saída. Termo de pesquisa

Este campo é somente leitura.
headline

string

Apenas saída. O título do anúncio dinâmico de pesquisa gerado dinamicamente.

Este campo é somente leitura.
landingPage

string

Apenas saída. O URL da página de destino da impressão selecionado dinamicamente.

Este campo é somente leitura.
pageUrl

string

Apenas saída. É o URL do item do feed de páginas veiculado para a impressão.

Este campo é somente leitura.
hasNegativeKeyword

boolean

Apenas saída. Verdadeiro se a consulta corresponder a uma palavra-chave negativa.

Este campo é somente leitura.
hasMatchingKeyword

boolean

Apenas saída. Verdadeiro se a consulta for adicionada às palavras-chave segmentadas.

Este campo é somente leitura.
hasNegativeUrl

boolean

Apenas saída. Verdadeiro se a consulta corresponder a um URL negativo.

Este campo é somente leitura.

ExpandedLandingPageView

Uma visualização de página de destino com métricas agregadas no nível do URL final expandido.

Representação JSON 
{
  "resourceName": string,
  "expandedFinalUrl": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização da página de destino expandida. Os nomes dos recursos de visualização da página de destino expandida têm o seguinte formato:

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}
expandedFinalUrl

string

Apenas saída. O URL final para onde os cliques são direcionados.

FeedPlaceholderView

Uma visualização do marcador de posição do feed.

Representação JSON 
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do marcador do feed. Os nomes dos recursos de visualização do marcador de feed têm o seguinte formato:

customers/{customerId}/feedPlaceholderViews/{placeholderType}
placeholderType

enum (PlaceholderType)

Apenas saída. O tipo de marcador da visualização do marcador de posição do feed.

GenderView

Uma visualização de gênero. O recurso "genderView" reflete o estado de exibição efetivo, em vez dos critérios que foram adicionados. Por padrão, um grupo de anúncios sem critérios de sexo é exibido para todos os sexos. Assim, todos os sexos aparecem na genderView com estatísticas.

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

string

Apenas saída. O nome do recurso da visualização de gênero. Os nomes dos recursos de visualização de gênero têm o seguinte formato:

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeographicView

Uma visualização geográfica.

A visualização geográfica inclui todas as métricas agregadas no nível do país, uma linha por país. Ele informa métricas no local físico real do usuário ou em uma área de interesse. Se outros campos de segmento forem utilizados, você poderá obter mais de uma linha por país.

Representação JSON 
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização geográfica. Os nomes dos recursos de visualização geográfica têm o seguinte formato:

customers/{customerId}/geographicViews/{countryCriterionId}~{locationType}
locationType

enum (GeoTargetingType)

Apenas saída. Tipo de segmentação por área geográfica da campanha.
countryCriterionId

string (int64 format)

Apenas saída. ID do critério do país.

GeoTargetingType

Os possíveis tipos de segmentação por área geográfica.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
AREA_OF_INTEREST Local em que o usuário está interessado ao fazer a consulta.
LOCATION_OF_PRESENCE Local do usuário que está emitindo a consulta.

GroupPlacementView

Uma visualização de posição em grupo.

Representação JSON 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de posição em grupo. Os nomes dos recursos de visualização de posição em grupo têm o seguinte formato:

customers/{customerId}/groupPlacementViews/{adGroupId}~{base64_placement}
placementType

enum (PlacementType)

Apenas saída. Tipo de canal, por exemplo, "Site", "Canal do YouTube", "App para dispositivos móveis".
placement

string

Apenas saída. A string de seleção automática de canais no nível do grupo, por exemplo, domínio da Web, ID do aplicativo para dispositivos móveis ou ID do canal do YouTube.
displayName

string

Apenas saída. Nome de domínio para sites e nome de canal do YouTube para canais do YouTube.
targetUrl

string

Apenas saída. URL do canal do grupo, por exemplo, domínio, link do aplicativo para dispositivos móveis na app store ou o URL de um canal do YouTube.

HotelGroupView

Visualização do grupo de hotéis.

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

string

Apenas saída. O nome do recurso da visualização do grupo de hotéis. Os nomes dos recursos de visualização do grupo de hotéis têm o seguinte formato:

customers/{customerId}/hotelGroupViews/{adGroupId}~{criterionId}

HotelPerformanceView

Uma visão do desempenho de um hotel.

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

string

Apenas saída. O nome do recurso da visualização de desempenho do hotel. Os nomes dos recursos de visualização de desempenho do hotel têm o seguinte formato:

customers/{customerId}/hotelPerformanceView

HotelReconciliation

Uma reconciliação de hotel. Ele contém informações de conversão das reservas de hotéis para reconciliar com os registros do anunciante. Essas linhas podem ser atualizadas ou canceladas antes do faturamento por meio de uploads em massa.

Representação JSON 
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
Campos
resourceName

string

Imutável. O nome do recurso da reconciliação de hotel. Os nomes dos recursos de reconciliação de hotéis têm o seguinte formato:

customers/{customerId}/hotelReconciliations/{commissionId}
commissionId

string

Obrigatório. Apenas saída. O ID de comissão é o ID do Google para esta reserva. Cada evento de reserva é atribuído a um ID de comissão para ajudar você a fazer a correspondência com uma estadia.
orderId

string

Apenas saída. O código do pedido é o identificador dessa reserva, conforme informado no parâmetro "transaction_id" da tag de acompanhamento de conversões.
campaign

string

Apenas saída. O nome do recurso da campanha associada à conversão.
hotelCenterId

string (int64 format)

Apenas saída. Identificador da conta da Central para Hotéis que informa as tarifas da campanha de hotel.
hotelId

string

Apenas saída. Identificador exclusivo da propriedade reservada, conforme fornecido no feed da Central para Hotéis. O ID do hotel é proveniente do parâmetro "ID" da tag de acompanhamento de conversões.
checkInDate

string

Apenas saída. Data do check-in registrada quando a reserva é feita. Se a data do check-in for modificada na reconciliação, a data revisada substituirá a original nesta coluna. O formato é AAAA-MM-DD.
checkOutDate

string

Apenas saída. Data do check-out registrada quando a reserva é feita. Se a data do check-in for modificada na reconciliação, a data revisada substituirá a original nesta coluna. O formato é AAAA-MM-DD.
reconciledValueMicros

string (int64 format)

Obrigatório. Apenas saída. "Valor de reconciliação" é o valor final de uma reserva pago pelo hóspede. Se o valor original da reserva mudar por algum motivo, como alterações de itinerário ou upsell de quartos, o valor de reconciliação deverá ser o valor final completo recebido. Se uma reserva for cancelada, o valor de reconciliação deverá incluir o valor das taxas de cancelamento ou das diárias não reembolsáveis. O valor é em milionésimos da moeda da unidade base. Por exemplo, US$ 12,35 seria representado como 12350000. A unidade monetária está na moeda padrão do cliente.
billed

boolean

Apenas saída. se uma reserva foi faturada ou não. Depois de faturada, não é possível modificar uma reserva.
status

enum (HotelReconciliationStatus)

Obrigatório. Apenas saída. Status atual de uma reserva em relação à reconciliação e ao faturamento. As reservas devem ser reconciliadas em até 45 dias após a data do check-out. Reservas que não forem reconciliadas nesse prazo serão cobradas de acordo com o valor original.

HotelReconciliationStatus

Status da reconciliação de reserva do hotel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
RESERVATION_ENABLED As reservas referem-se a uma data futura ou a estadia está em andamento, mas a data de check-out ainda não passou. Não é possível reconciliar reservas ativas.
RECONCILIATION_NEEDED O check-out já foi feito ou as datas de estadia passaram sem que houvesse o cancelamento da reserva. As reservas não reconciliadas até 45 dias depois do check-out são faturadas com base no preço original de reserva.
RECONCILED Essas reservas foram reconciliadas. As reservas reconciliadas são faturadas em até 45 dias após a data do check-out.
CANCELED Essa reserva foi marcada como cancelada. As estadias canceladas com valor maior que zero (devido a regras de estadia mínima ou taxas de cancelamento) serão faturadas até 45 dias após a data do check-out.

IncomeRangeView

Uma visualização da faixa de renda.

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

string

Apenas saída. O nome do recurso da visualização de faixa de renda. Os nomes dos recursos de visualização de faixa de renda têm o seguinte formato:

customers/{customerId}/incomeRangeViews/{adGroupId}~{criterionId}

KeywordView

Uma visualização de palavras-chave.

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

string

Apenas saída. O nome do recurso da visualização da palavra-chave. Os nomes dos recursos de visualização de palavras-chave têm o seguinte formato:

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

LandingPageView

Uma visualização da página de destino com métricas agregadas no nível do URL final não expandido.

Representação JSON 
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização da página de destino. Os nomes dos recursos de visualização da página de destino têm o seguinte formato:

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}
unexpandedFinalUrl

string

Apenas saída. O URL final especificado pelo anunciante.

LanguageConstant

Um idioma.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de linguagem. Os nomes de recursos de constantes de linguagem têm o seguinte formato:

languageConstants/{criterionId}
id

string (int64 format)

Apenas saída. O ID da constante de linguagem.
code

string

Apenas saída. O código de idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc.
name

string

Apenas saída. O nome completo do idioma em inglês, por exemplo, "Inglês (EUA)", "Espanhol" etc.
targetable

boolean

Apenas saída. Indica se o idioma pode ser segmentado.

LocationView

Uma visualização de local resume a performance das campanhas por um critério de local. Se nenhum critério de local for definido, nenhum resultado será retornado. Em vez disso, use geográficoView ou userLocationView para dados de localização do visitante.

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

string

Apenas saída. O nome do recurso da visualização do local. Os nomes dos recursos de visualização de local têm o seguinte formato:

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ManagedPlacementView

Uma visualização de seleção manual de canais.

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

string

Apenas saída. O nome do recurso da vista da seleção manual de canais. Os nomes dos recursos de visualização da seleção manual de canais têm o seguinte formato:

customers/{customerId}/managedPlacementViews/{adGroupId}~{criterionId}

MediaFile

Um arquivo de mídia.

Representação JSON 
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
Campos
resourceName

string

Imutável. O nome do recurso do arquivo de mídia. Os nomes dos recursos de arquivos de mídia têm o seguinte formato:

customers/{customerId}/mediaFiles/{media_file_id}
type

enum (MediaType)

Imutável. Tipo do arquivo de mídia.
mimeType

enum (MimeType)

Apenas saída. O tipo MIME do arquivo de mídia.
id

string (int64 format)

Apenas saída. O ID do arquivo de mídia.
sourceUrl

string

Imutável. O URL de onde foi feito o download do arquivo de mídia original (ou um nome de arquivo). Usado apenas para mídias dos tipos AUDIO e IMAGE.
name

string

Imutável. O nome do arquivo de mídia. O nome pode ser usado pelos clientes para ajudar a identificar a mídia enviada anteriormente.
fileSize

string (int64 format)

Apenas saída. O tamanho do arquivo de mídia em bytes.
Campo de união mediatype. O tipo específico do arquivo de mídia. mediatype pode ser apenas de um dos tipos a seguir:
image

object (MediaImage)

Imutável. Encapsula uma imagem.
mediaBundle

object (MediaBundle)

Imutável. Um arquivo ZIP que tem recursos HTML5 com conteúdo.
audio

object (MediaAudio)

Apenas saída. Encapsula um áudio.
video

object (MediaVideo)

Imutável. Encapsula um vídeo.

MediaType

O tipo de mídia.

Enums
UNSPECIFIED O tipo de mídia não foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
IMAGE Imagem estática usada para anúncio gráfico.
ICON Imagem pequena, usada para anúncio de mapa.
MEDIA_BUNDLE ZIP, usado em campos de anúncios modelo.
AUDIO Arquivo de áudio.
VIDEO Arquivo de vídeo.
DYNAMIC_IMAGE Imagem animada, como GIF animado.

MediaImage

Encapsula uma imagem.

Representação JSON 
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
Campos
data

string (bytes format)

Imutável. Dados brutos da imagem.

Uma string codificada em base64.
fullSizeImageUrl

string

Apenas saída. O URL para a versão em tamanho original da imagem.
previewSizeImageUrl

string

Apenas saída. O URL para a versão do tamanho de visualização da imagem.

MediaBundle

Representa uma mídia de arquivo ZIP cujo conteúdo contém recursos HTML5.

Representação JSON 
{
  "data": string,
  "url": string
}
Campos
data

string (bytes format)

Imutável. Dados brutos compactados.

Uma string codificada em base64.
url

string

Apenas saída. O URL para acessar os dados compactados enviados. Por exemplo, https://tpc.googlesyndication.com/simgad/123 Este campo é somente leitura.

MediaAudio

Encapsula um áudio.

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

string (int64 format)

Apenas saída. A duração do áudio em milissegundos.

MediaVideo

Encapsula um vídeo.

Representação JSON 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
Campos
adDurationMillis

string (int64 format)

Apenas saída. A duração do vídeo em milissegundos.
youtubeVideoId

string

Imutável. O ID do vídeo do YouTube (conforme visto nos URLs do YouTube). A adição do prefixo "https://www.youtube.com/watch?v=" a esse ID resulta no URL de streaming do YouTube para esse vídeo.
advertisingIdCode

string

Apenas saída. O código de Identificação digital de publicidade para este vídeo, conforme definido pela Associação Americana de Agências de Publicidade, usado principalmente para comerciais de televisão.
isciCode

string

Apenas saída. O código Identificador comercial padrão da indústria para este vídeo, usado principalmente para comerciais de televisão.

LocalServicesVerificationArtifact

Um recurso de verificação de serviços locais.

Representação JSON 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
Campos
resourceName

string

Imutável. O nome do recurso da verificação do Serviços Locais. Os nomes dos recursos de verificação dos Serviços Locais têm o seguinte formato:

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}
creationDateTime

string

Apenas saída. O carimbo de data/hora em que o artefato de verificação foi criado. O formato é "AAAA-MM-DD HH:MM:SS" no fuso horário da conta do Google Ads. Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
status

enum (LocalServicesVerificationArtifactStatus)

Apenas saída. O status do artefato de verificação.
artifactType

enum (LocalServicesVerificationArtifactType)

Apenas saída. O tipo do artefato de verificação.
id

string (int64 format)

Apenas saída. O ID do artefato de verificação.
Campo de união artifact_data. Os tipos de informação de verificação. artifact_data pode ser apenas um dos seguintes:
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

Apenas saída. Um artefato de investigação de histórico para contratação
insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

Apenas saída. Um artefato de verificação de seguros.
licenseVerificationArtifact

object (LicenseVerificationArtifact)

Apenas saída. Um artefato de verificação de licença.

LocalServicesVerificationArtifactStatus

Enumerações que descrevem os status de um artefato de verificação de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PASSED O artefato foi aprovado na verificação.
FAILED Falha na verificação do artefato.
PENDING O artefato está em processo de verificação.
NO_SUBMISSION O artefato precisa que o usuário faça upload das informações antes de verificar.
CANCELLED O artefato foi cancelado pelo usuário.

LocalServicesVerificationArtifactType

Enums que descrevem possíveis tipos de artefato de verificação de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BACKGROUND_CHECK Artefato de investigação de histórico para contratação
INSURANCE Artefato de verificação do seguro
LICENSE Artefato de verificação de licença

BackgroundCheckVerificationArtifact

Um proto contendo informações específicas para a investigação de histórico para contratação dos serviços locais.

Representação JSON 
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
Campos
caseUrl

string

Apenas saída. URL para acessar o caso em segundo plano.
finalAdjudicationDateTime

string

Apenas saída. O carimbo de data/hora em que o resultado do caso de investigação de histórico para contratação foi avaliado. O formato é "AAAA-MM-DD HH:MM:SS" no fuso horário da conta do Google Ads. Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"

InsuranceVerificationArtifact

Um protótipo com informações específicas de um seguro de serviços locais.

Representação JSON 
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Campos
amountMicros

string (int64 format)

Apenas saída. Valor do seguro. Isso é medido em "micros" da moeda mencionada no documento de seguro.
rejectionReason

enum (LocalServicesInsuranceRejectionReason)

Apenas saída. Motivo da rejeição do documento do seguro.
insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

Apenas saída. O campo somente leitura que contém as informações de um documento de seguro enviado.

LocalServicesInsuranceRejectionReason

Tipos enumerados que descrevem os possíveis motivos de rejeição de um artefato de verificação do seguro de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BUSINESS_NAME_MISMATCH O nome da empresa não corresponde ao do anúncio do Serviços Locais.
INSURANCE_AMOUNT_INSUFFICIENT O valor do seguro não atende aos requisitos listados na documentação dos resumos legais para essa combinação de região geográfica e ID de categoria.
EXPIRED O documento de seguro expirou.
NO_SIGNATURE Está faltando uma assinatura no documento de seguro.
NO_POLICY_NUMBER Falta um número de apólice no documento de seguro.
NO_COMMERCIAL_GENERAL_LIABILITY A caixa de Responsabilidade Geral Comercial(CGL) não está marcada no documento de seguro.
EDITABLE_FORMAT O documento de seguro está em um formato editável.
CATEGORY_MISMATCH O documento de seguro não cobre o seguro de uma categoria específica.
MISSING_EXPIRATION_DATE Falta uma data de validade no documento de seguro.
POOR_QUALITY O documento de seguro tem baixa qualidade (imagens desfocadas, ilegível etc.)
POTENTIALLY_EDITED O documento do seguro é suspeito de estar sendo editado.
WRONG_DOCUMENT_TYPE Documento de seguro não aceito. Por exemplo, documentos de propostas de seguro, mas coberturas ausentes não são aceitas.
NON_FINAL O documento de seguro não é definitivo.
OTHER O documento de seguro tem outra falha não listada explicitamente.

LocalServicesDocumentReadOnly

Um documento do Serviços Locais com dados somente leitura acessíveis.

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

string

URL para acessar um documento dos Serviços Locais já enviado.

LicenseVerificationArtifact

Um proto com informações específicas de uma licença de serviços locais.

Representação JSON 
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Campos
licenseType

string

Apenas saída. Tipo / nome da licença.
licenseNumber

string

Apenas saída. Número da licença.
licenseeFirstName

string

Apenas saída. Nome do licenciado.
licenseeLastName

string

Apenas saída. Sobrenome do licenciado.
rejectionReason

enum (LocalServicesLicenseRejectionReason)

Apenas saída. Motivo da rejeição da licença.
licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

Apenas saída. O campo somente leitura que contém as informações de um documento de licença enviado.

LocalServicesLicenseRejectionReason

Enumerações que descrevem os possíveis motivos de rejeição de um artefato de verificação da licença de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BUSINESS_NAME_MISMATCH O nome da empresa não corresponde ao do anúncio do Serviços Locais.
UNAUTHORIZED A licença não foi autorizada ou foi revogada.
EXPIRED A licença expirou.
POOR_QUALITY A licença é de baixa qualidade - imagens desfocadas, ilegíveis etc.
UNVERIFIABLE Não foi possível verificar a licença porque a imagem não é legítima.
WRONG_DOCUMENT_OR_ID A licença não é o tipo de documento solicitado ou contém um ID inválido.
OTHER A licença tem outra falha não listada explicitamente.

MobileAppCategoryConstant

Uma constante da categoria de aplicativo para dispositivos móveis.

Representação JSON 
{
  "resourceName": string,
  "id": integer,
  "name": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de categoria do app para dispositivos móveis. Os nomes dos recursos constantes da categoria de app para dispositivos móveis têm o seguinte formato:

mobileAppCategoryConstants/{mobile_app_category_id}
id

integer

Apenas saída. O ID da constante da categoria do app para dispositivos móveis.
name

string

Apenas saída. Nome da categoria do app para dispositivos móveis.

MobileDeviceConstant

Uma constante de dispositivo móvel.

Representação JSON 
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de dispositivo móvel. Os nomes de recursos constantes de dispositivos móveis têm o seguinte formato:

mobileDeviceConstants/{criterionId}
type

enum (MobileDeviceType)

Apenas saída. O tipo de dispositivo móvel.
id

string (int64 format)

Apenas saída. O ID da constante do dispositivo móvel.
name

string

Apenas saída. O nome do dispositivo móvel.
manufacturerName

string

Apenas saída. O fabricante do dispositivo móvel.
operatingSystemName

string

Apenas saída. O sistema operacional do dispositivo móvel.

MobileDeviceType

O tipo de dispositivo móvel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
MOBILE Celulares.
TABLET Tablets

OfflineConversionUploadClientSummary

Resumo do cliente do upload de conversões off-line.

Representação JSON 
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
Campos
resourceName

string

Apenas saída. O nome do recurso do resumo do cliente do upload de conversões off-line. Os nomes dos recursos de resumo do cliente do upload de conversões off-line têm o seguinte formato:

customers/{customerId}/offlineConversionUploadClientSummaries/{client}
client

enum (OfflineEventUploadClient)

Apenas saída. Tipo de cliente do evento de upload.
status

enum (OfflineConversionDiagnosticStatus)

Apenas saída. Status geral do resumo do cliente de conversão off-line. O status é gerado a partir do dia mais recente, com estatísticas de upload
totalEventCount

string (int64 format)

Apenas saída. Contagem total de eventos enviados.
successfulEventCount

string (int64 format)

Apenas saída. Contagem total de eventos enviados.
successRate

number

Apenas saída. Taxa de êxito.
lastUploadDateTime

string

Apenas saída. Data do lote de envio mais recente. O formato é "aaaa-mm-dd hh:mm:ss" e está no fuso horário da conta do Google Ads.
dailySummaries[]

object (OfflineConversionSummary)

Apenas saída. Resumo das estatísticas do histórico dos últimos N dias.
jobSummaries[]

object (OfflineConversionSummary)

Apenas saída. Resumo das estatísticas do histórico pelos últimos N jobs.
alerts[]

object (OfflineConversionAlert)

Apenas saída. Detalhes de cada código de erro Os alertas são gerados a partir do dia mais recente do calendário com estatísticas de upload.

OfflineEventUploadClient

Tipo de cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
GOOGLE_ADS_API a API Google Ads.
GOOGLE_ADS_WEB_CLIENT Cliente da Web do Google Ads, que pode incluir várias origens, como interface do Google Ads, SFTP etc.
ADS_DATA_CONNECTOR Plataforma de conexão.

OfflineConversionDiagnosticStatus

Possíveis status da configuração de ingestão off-line.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EXCELLENT Sua configuração de ingestão de dados off-line está ativa e é ideal para o processamento downstream.
GOOD Sua configuração de ingestão de dados off-line está ativa, mas ainda é possível fazer melhorias. Mostrar alertas.
NEEDS_ATTENTION Sua configuração de ingestão de dados off-line está ativa, mas há erros que exigem atenção. Mostrar alertas.
NO_RECENT_UPLOAD Sua configuração de ingestão de dados off-line não recebeu dados nos últimos 28 dias. Algo pode estar errado.

OfflineConversionSummary

Resumo do upload histórico, agrupado por data de upload ou job.

Representação JSON 
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
Campos
successfulCount

string (int64 format)

Apenas saída. Contagem total de eventos bem-sucedidos.
failedCount

string (int64 format)

Apenas saída. Contagem total de eventos com falha.
Campo de união dimension_key. Chave de dimensão para resumo. dimension_key pode ser apenas de um dos tipos a seguir:
jobId

string (int64 format)

Apenas saída. Chave de dimensão para os últimos N jobs.
uploadDate

string

Apenas saída. Chave de dimensão para os últimos N dias.

OfflineConversionAlert

Alerta para o resumo do cliente de conversão off-line.

Representação JSON 
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
Campos
error

object (OfflineConversionError)

Apenas saída. Erro no alerta de cliente de conversão off-line.
errorPercentage

number

Apenas saída. Porcentagem do erro.O intervalo desse campo deve ser [0, 1, 0].

OfflineConversionError

Possíveis erros no resumo do cliente de conversão off-line.

Representação JSON 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
Campos
Campo de união error_code. Erro na descrição. error_code pode ser apenas de um dos tipos a seguir:
collectionSizeError

enum (CollectionSizeError)

Apenas saída. Erro de tamanho de coleção.
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

Apenas saída. Erro no upload do ajuste de conversão.
conversionUploadError

enum (ConversionUploadError)

Apenas saída. Erro no upload da conversão.
dateError

enum (DateError)

Apenas saída. Erro de data.
distinctError

enum (DistinctError)

Apenas saída. Erro distinto.
fieldError

enum (FieldError)

Apenas saída. Erro de campo.
mutateError

enum (MutateError)

Apenas saída. Erro de modificação.
notAllowlistedError

enum (NotAllowlistedError)

Apenas saída. Erro na lista de permissões.
stringFormatError

enum (StringFormatError)

Apenas saída. Erro de formato da string.
stringLengthError

enum (StringLengthError)

Apenas saída. Erro de comprimento da string.

CollectionSizeError

Enumeração que descreve possíveis erros de tamanho de coleção.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
TOO_FEW Poucos.
TOO_MANY Excesso.

ConversionAdjustmentUploadError

Enumeração que descreve possíveis erros de upload do ajuste de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
TOO_RECENT_CONVERSION_ACTION Não é possível importar eventos para uma ação de conversão que acabou de ser criada. Tente importar de novo em seis horas.
CONVERSION_ALREADY_RETRACTED A conversão já foi retirada. Esse ajuste não foi processado.
CONVERSION_NOT_FOUND Não foi possível encontrar a conversão desta ação nem o identificador da conversão. Verifique se os identificadores estão associados à ação de conversão correta e tente de novo.
CONVERSION_EXPIRED Não é possível fazer ajustes em uma conversão que ocorreu há mais de 54 dias.
ADJUSTMENT_PRECEDES_CONVERSION O ajuste tem uma adjustmentDateTime que ocorreu antes da conversão associada. Verifique se o adjustmentDateTime está correto e tente de novo.
MORE_RECENT_RESTATEMENT_FOUND O ajuste mais recente adjustmentDateTime já foi informado para a conversão associada. Verifique se o ajuste adjustmentDateTime está correto e tente de novo.
TOO_RECENT_CONVERSION Não é possível registrar o ajuste porque a conversão ocorreu muito recentemente. Tente ajustar uma conversão que ocorreu há pelo menos 24 horas.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE Não é possível fazer ajustes em uma conversão configurada para usar o valor padrão. Verifique a configuração do valor da ação de conversão e tente de novo.
TOO_MANY_ADJUSTMENTS_IN_REQUEST Tente fazer upload de até 2.000 ajustes em uma única solicitação de API.
TOO_MANY_ADJUSTMENTS A conversão já foi ajustada pelo número máximo de vezes. Faça apenas os ajustes necessários na conversão atual.
RESTATEMENT_ALREADY_EXISTS A conversão já foi reformulada com o mesmo adjustmentDateTime. Verifique se o ajuste tem o adjustmentDateTime correto e exclusivo e tente de novo.
DUPLICATE_ADJUSTMENT_IN_REQUEST O ajuste importado tem um ajuste de conversão duplicado com o mesmo adjustmentDateTime. Verifique se o ajuste tem o adjustmentDateTime correto e tente de novo.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Aceite os Termos de Processamento de Dados do cliente nas configurações de conversão e tente de novo.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Não é possível usar conversões otimizadas com a ação de conversão especificada.
INVALID_USER_IDENTIFIER Use o SHA-256 para gerar hash dos dados fornecidos pelo usuário e verifique se está normalizando de acordo com as diretrizes.
UNSUPPORTED_USER_IDENTIFIER Use os dados fornecidos pelo usuário, como e-mails ou números de telefone, com hash usando SHA-256 e tente de novo.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET Não é possível definir o gclidDateTimePair e o orderId. Use apenas um tipo e tente de novo.
CONVERSION_ALREADY_ENHANCED A conversão já tem melhorias com o mesmo código do pedido e a mesma ação de conversão. Verifique se os dados estão configurados corretamente e tente de novo.
DUPLICATE_ENHANCEMENT_IN_REQUEST Várias melhorias têm a mesma ação de conversão e o mesmo código do pedido. Verifique se os dados estão configurados corretamente e tente de novo.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT Não é possível usar as conversões otimizadas para esta conta devido às políticas de dados do cliente do Google. Entre em contato com seu representante do Google.
MISSING_ORDER_ID_FOR_WEBPAGE O ajuste na conversão no site exige o ID do pedido (ou seja, o ID da transação). Garanta que as tags do seu site capturem os códigos de pedido e envie esses mesmos códigos com seu ajuste.
ORDER_ID_CONTAINS_PII Não é possível usar ajustes com códigos de pedido que contêm informações de identificação pessoal (PII).
INVALID_JOB_ID O ID da vaga fornecido na solicitação não está dentro do intervalo permitido. Ele precisa ser um número inteiro positivo no intervalo [1, 2^31).
NO_CONVERSION_ACTION_FOUND Não foi possível encontrar a ação de conversão especificada na solicitação de ajuste. Confira se ela está disponível nessa conta.
INVALID_CONVERSION_ACTION_TYPE O tipo de ação de conversão especificado na solicitação de ajuste não é compatível com o upload de ajustes. Um ajuste de conversão do tipo RETRACTION ou RESTATEMENT só é permitido para ações de conversão dos tipos SALESFORCE, UPLOAD_CLICK ou WEBPAGE. Um ajuste de conversão do tipo ENHANCEMENT só é permitido para ações de conversão do tipo WEBPAGE.

ConversionUploadError

Enumeração que descreve possíveis erros de upload de conversão.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
TOO_MANY_CONVERSIONS_IN_REQUEST Faça upload de menos de 2.001 eventos em uma única solicitação.
UNPARSEABLE_GCLID Não foi possível decodificar o GCLID importado. Verifique se você não modificou os IDs de clique.
CONVERSION_PRECEDES_EVENT O evento importado tem um conversionDateTime que antecede o clique. Verifique se o conversionDateTime está correto e tente de novo.
EXPIRED_EVENT O evento importado não pode ser registrado porque o clique ocorreu antes da janela de cliques desta conversão. Importe os dados mais recentes.
TOO_RECENT_EVENT O clique associado ao identificador fornecido ou ao parâmetro de URL do iOS ocorreu há menos de seis horas. Tente de novo após 6 horas.
EVENT_NOT_FOUND O evento importado não pôde ser atribuído a um clique. Talvez ele não tenha vindo de uma campanha do Google Ads.
UNAUTHORIZED_CUSTOMER O ID do clique ou a ligação está associada a uma conta do Google Ads a que você não tem acesso. Importe as conversões das contas gerenciadas pela sua conta de administrador.
TOO_RECENT_CONVERSION_ACTION Não é possível importar eventos para uma ação de conversão que acabou de ser criada. Tente importar de novo em seis horas.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME No momento do clique, o acompanhamento de conversões não estava ativado na conta de conversão da conta do Google Ads que recebeu o clique.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION O evento importado inclui dados de atribuição externos, mas a ação de conversão não está configurada para usar um modelo de atribuição externo. Verifique se a ação de conversão está configurada corretamente e tente de novo.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION A ação de conversão está configurada para usar um modelo de atribuição externo, mas faltam dados no evento importado. Verifique se os eventos importados incluem o crédito de atribuição externa e todos os campos necessários.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Não é possível usar códigos de pedido para uma conversão medida com um modelo de atribuição externo. Verifique se a conversão está configurada corretamente e se os eventos importados incluem apenas os dados necessários e tente de novo.
ORDER_ID_ALREADY_IN_USE O evento importado inclui um código de pedido que foi registrado anteriormente e, por isso, não foi processado.
DUPLICATE_ORDER_ID Os eventos importados incluem várias conversões com o mesmo código de pedido e não foram processados. Verifique se os códigos dos pedidos são únicos e tente de novo.
TOO_RECENT_CALL Não é possível importar chamadas que ocorreram há menos de seis horas. Tente fazer o upload novamente em 6 horas.
EXPIRED_CALL Não é possível registrar a chamada porque ela ocorreu antes da janela de lookback dessa ação de conversão. Verifique se a importação está configurada para acessar os dados mais recentes.
CALL_NOT_FOUND A chamada ou o clique que leva ao evento importado não foi encontrado. Verifique se a fonte de dados está configurada para incluir identificadores corretos.
CONVERSION_PRECEDES_CALL A chamada tem um conversionDateTime que antecede o clique associado. Verifique se o conversionDateTime está correto.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME No momento da chamada importada, o acompanhamento de conversões não estava ativado na conta de conversão em vigor da conta do Google Ads que recebeu o clique.
UNPARSEABLE_CALLERS_PHONE_NUMBER Verifique se os números de telefone estão no formato E.164 (+16502531234), internacional (+64 3-331 6005) ou número nacional dos EUA (6502531234).
CLICK_CONVERSION_ALREADY_EXISTS O evento importado tem os mesmos clique e conversionDateTime de uma conversão atual. Use um código do pedido ou conversionDateTime exclusivo para cada evento exclusivo e tente de novo.
CALL_CONVERSION_ALREADY_EXISTS A chamada importada tem os mesmos conversionDateTime de uma conversão atual. Verifique se o conversionDateTime está configurado corretamente e tente de novo.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Vários eventos têm o mesmo clique e conversionDateTime. Verifique se o conversionDateTime está configurado corretamente e tente de novo.
DUPLICATE_CALL_CONVERSION_IN_REQUEST Vários eventos têm a mesma chamada e conversionDateTime. Verifique se o conversionDateTime está configurado corretamente e tente de novo.
CUSTOM_VARIABLE_NOT_ENABLED Ative a variável personalizada nas suas configurações de conversão e tente de novo.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Não é possível importar eventos com variáveis personalizadas que contêm informações de identificação pessoal (PII). Remova essas variáveis e tente de novo.
INVALID_CUSTOMER_FOR_CLICK O clique do evento importado está associado a outra conta do Google Ads. Verifique se você está importando para a conta correta.
INVALID_CUSTOMER_FOR_CALL O clique da chamada está associado a outra conta do Google Ads. Verifique se você está importando para a conta correta. Consulte conversionTrackingSetting.google_ads_conversion_customer no cliente para identificar a conta correta.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY Não é possível importar a conversão porque a origem da conversão não estava em conformidade com as políticas do Apple App Transparency Tracking (ATT) ou o cliente não consentiu com o rastreamento.
CLICK_NOT_FOUND O endereço de e-mail ou o número de telefone deste evento não corresponde a um clique. Talvez ele não tenha se originado de uma campanha do Google Ads. Você pode ignorar este aviso com segurança. Se isso ocorrer com mais eventos importados do que o esperado, verifique sua configuração.
INVALID_USER_IDENTIFIER Use o SHA-256 para gerar hash dos dados fornecidos pelo usuário e verifique se está normalizando de acordo com as diretrizes.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER Não é possível usar os dados fornecidos pelo usuário com modelos de atribuição externos. Use outro modelo de atribuição ou omita os identificadores de usuário e tente de novo.
UNSUPPORTED_USER_IDENTIFIER Os identificadores de usuário fornecidos não são aceitos. Use apenas e-mails ou números de telefone com hash e tente de novo.
GBRAID_WBRAID_BOTH_SET Não é possível usar os parâmetros gbraid e wbraid ao mesmo tempo. Use apenas um e tente de novo.
UNPARSEABLE_WBRAID Não é possível analisar os dados de importação de eventos. Verifique se o parâmetro wbraid não foi modificado e tente de novo.
UNPARSEABLE_GBRAID Não é possível analisar os dados de importação de eventos. Verifique se o parâmetro gbraid não foi modificado e tente de novo.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID As ações de conversão que usam a contagem de uma por clique não podem ser usadas com parâmetros gbraid ou wbraid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Não é possível usar as conversões otimizadas para esta conta devido às políticas de dados do cliente do Google. Entre em contato com seu representante do Google.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Aceite os Termos de Processamento de Dados do cliente nas configurações de conversão e tente de novo. É possível verificar sua configuração consultando conversionTrackingSetting.accepted_customer_data_terms no Customer.
ORDER_ID_CONTAINS_PII Não é possível importar eventos com códigos de pedido que contêm informações de identificação pessoal (PII).
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Verifique se você ativou as conversões otimizadas para leads nas configurações da conversão e tente de novo. Você pode verificar sua configuração consultando conversionTrackingSetting.enhanced_conversions_for_leads_enabled no cliente.
INVALID_JOB_ID O ID da vaga fornecido na solicitação não está dentro do intervalo permitido. Ele precisa ser um número inteiro positivo no intervalo [1, 2^31).
NO_CONVERSION_ACTION_FOUND Não foi possível encontrar a ação de conversão especificada no pedido de upload. Confira se ela está disponível nessa conta.
INVALID_CONVERSION_ACTION_TYPE A ação de conversão especificada no pedido de upload não está configurada para o upload de conversões.

DateError

Enumeração que descreve possíveis erros de data.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
INVALID_FIELD_VALUES_IN_DATE Os valores de campo fornecidos não correspondem a uma data válida.
INVALID_FIELD_VALUES_IN_DATE_TIME Os valores de campo fornecidos não correspondem a uma data e hora válida.
INVALID_STRING_DATE O formato da data da string precisa ser aaaa-mm-dd.
INVALID_STRING_DATE_TIME_MICROS O formato da data e hora da string deve ser aaaa-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS O formato da data e hora da string deve ser aaaa-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET O formato da data e hora da string deve ser aaaa-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE A data é anterior ao mínimo permitido.
LATER_THAN_MAXIMUM_DATE A data é posterior ao máximo permitido.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Os limites do período não estão em ordem.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL As duas datas no período são nulas.

DistinctError

Enumeração que descreve possíveis erros distintos.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
DUPLICATE_ELEMENT Elemento duplicado.
DUPLICATE_TYPE Tipo duplicado.

FieldError

Enumeração que descreve possíveis erros de campo.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
REQUIRED O campo obrigatório não estava presente.
IMMUTABLE_FIELD O campo tentado ser modificado é imutável.
INVALID_VALUE O valor do campo é inválido.
VALUE_MUST_BE_UNSET O campo não pode ser definido.
REQUIRED_NONEMPTY_LIST O campo repetido obrigatório estava em branco.
FIELD_CANNOT_BE_CLEARED Não é possível limpar o campo.
BLOCKED_VALUE O valor do campo está em uma lista de bloqueio para este campo.
FIELD_CAN_ONLY_BE_CLEARED O valor do campo não pode ser modificado, exceto para limpeza.

MutateError

Enumeração que descreve possíveis erros de mutação.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
RESOURCE_NOT_FOUND O recurso solicitado não foi encontrado.
ID_EXISTS_IN_MULTIPLE_MUTATES Não é possível modificar o mesmo recurso duas vezes na mesma solicitação.
INCONSISTENT_FIELD_VALUES O conteúdo do campo não corresponde a outro campo que representa os mesmos dados.
MUTATE_NOT_ALLOWED Não são permitidas modificações para o recurso solicitado.
RESOURCE_NOT_IN_GOOGLE_ADS O recurso não está no Google Ads. Pertence a outro sistema de anúncios.
RESOURCE_ALREADY_EXISTS O recurso que está sendo criado já existe.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY Este recurso não pode ser usado com "validateOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE Esta operação não pode ser usada com "partialFailure".
RESOURCE_READ_ONLY Tente gravar em campos somente leitura.

NotAllowlistedError

Enumeração que descreve possíveis erros não permitidos.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE O cliente não está na lista de permissões para acessar esse recurso.

StringFormatError

Enumeração que descreve possíveis erros de formato da string.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
ILLEGAL_CHARS O valor da string de entrada contém caracteres não permitidos.
INVALID_FORMAT O valor da string de entrada é inválido para o campo associado.

StringLengthError

Enumeração que descreve possíveis erros de comprimento da string.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
EMPTY O campo especificado precisa ter pelo menos um caractere que não seja um espaço.
TOO_SHORT Muito curto.
TOO_LONG Muito longo.

OperatingSystemVersionConstant

Uma versão do sistema operacional para dispositivos móveis ou um intervalo de versões, dependendo de operatorType. Lista de plataformas móveis disponíveis em https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

Representação JSON 
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de versão do sistema operacional. Os nomes dos recursos constantes da versão do sistema operacional têm o seguinte formato:

operatingSystemVersionConstants/{criterionId}
operatorType

enum (OperatingSystemVersionOperatorType)

Apenas saída. Determina se esta constante representa uma única versão ou um intervalo de versões.
id

string (int64 format)

Apenas saída. O ID da versão do sistema operacional.
name

string

Apenas saída. Nome do sistema operacional.
osMajorVersion

integer

Apenas saída. O número da versão principal do SO.
osMinorVersion

integer

Apenas saída. O número da versão secundária do SO.

OperatingSystemVersionOperatorType

O tipo de versão do sistema operacional.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EQUALS_TO Igual à versão especificada.
GREATER_THAN_EQUALS_TO Maior ou igual à versão especificada.

PaidOrganicSearchTermView

Uma visualização de termo de pesquisa orgânica paga que fornece uma visão das estatísticas de pesquisa em anúncios e listagens orgânicas agregadas por termo de pesquisa no nível do grupo de anúncios.

Representação JSON 
{
  "resourceName": string,
  "searchTerm": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do termo de pesquisa. Os nomes dos recursos de visualização de termos de pesquisa têm o seguinte formato:

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}
searchTerm

string

Apenas saída. O termo da pesquisa.

QualifyingQuestion

Perguntas de qualificação para o formulário de lead.

Representação JSON 
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da pergunta de qualificação.

'QualifyingQuestions/{qualifiedingQuestionId}"
qualifyingQuestionId

string (int64 format)

Apenas saída. O ID da pergunta de qualificação.
locale

string

Apenas saída. O local da pergunta de qualificação.
text

string

Apenas saída. A pergunta de qualificação.

ParentalStatusView

Uma visualização do status parental.

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

string

Apenas saída. O nome do recurso da visualização do status parental. Os nomes dos recursos de visualização de status parental têm o seguinte formato:

customers/{customerId}/parentalStatusViews/{adGroupId}~{criterionId}

PerStoreView

Uma visualização por loja. Essa visualização mostra estatísticas de conversão de ações locais e o alcance de impressões por loja para os anunciantes.

Representação JSON 
{
  "resourceName": string,
  "placeId": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização por loja. Os nomes dos recursos por visualização de loja têm o seguinte formato:

customers/{customerId}/perStoreViews/{placeId}
placeId

string

Apenas saída. O ID do lugar da visualização por loja.

ProductCategoryConstant

Uma categoria de produto.

Representação JSON 
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da categoria do produto. Os nomes dos recursos de categorias de produtos têm o seguinte formato:

productCategoryConstants/{level}~{categoryId}
categoryId

string (int64 format)

Apenas saída. O ID da categoria do produto.

Ele é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436.
level

enum (ProductCategoryLevel)

Apenas saída. Nível da categoria do produto.
state

enum (ProductCategoryState)

Apenas saída. Estado da categoria do produto.
localizations[]

object (ProductCategoryLocalization)

Apenas saída. Lista de todas as localizações disponíveis da categoria dos produtos.
productCategoryConstantParent

string

Apenas saída. Nome do recurso da categoria do produto principal.

ProductCategoryState

Enumeração que descreve o estado da categoria do produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A categoria está ativada.
OBSOLETE A categoria está obsoleta. Usado apenas para fins de relatório.

ProductCategoryLocalization

Localização da categoria dos produtos.

Representação JSON 
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
Campos
regionCode

string

Apenas saída. Código do país ISO 3166-1 de duas letras maiúsculo da categoria localizada.
languageCode

string

Apenas saída. Código de idioma ISO 639-1 de duas letras da categoria localizada.
value

string

Apenas saída. O nome da categoria na localidade especificada.

ProductGroupView

Uma visualização do grupo de produtos.

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

string

Apenas saída. O nome do recurso da visualização do grupo de produtos. Os nomes dos recursos da visualização de grupo de produtos têm o seguinte formato:

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

ProductLinkInvitation

Representa um convite para a conexão de compartilhamento de dados entre uma conta do Google Ads e outra conta.

Representação JSON 
{
  "resourceName": string,
  "productLinkInvitationId": string,
  "status": enum (ProductLinkInvitationStatus),
  "type": enum (LinkedProductType),

  // Union field invited_account can be only one of the following:
  "hotelCenter": {
    object (HotelCenterLinkInvitationIdentifier)
  },
  "merchantCenter": {
    object (MerchantCenterLinkInvitationIdentifier)
  }
  // End of list of possible types for union field invited_account.
}
Campos
resourceName

string

Imutável. O nome do recurso de um convite de vinculação de produtos. Os nomes dos recursos de convite do link de produtos têm o seguinte formato:

customers/{customerId}/productLinkInvitations/{productLinkInvitationId}
status

enum (ProductLinkInvitationStatus)

Apenas saída. O status do convite do link do produto. Este campo é somente leitura.
type

enum (LinkedProductType)

Apenas saída. O tipo da conta convidada. Este campo é somente leitura e pode ser usado para filtrar convites com {@code GoogleAdsService.SearchGoogleAdsRequest}.
Campo de união invited_account. Uma conta convidada a vincular-se a esta conta do Google Ads. invited_account pode ser apenas de um dos tipos a seguir:
hotelCenter

object (HotelCenterLinkInvitationIdentifier)

Apenas saída. Convite de vinculação ao hotel.
merchantCenter

object (MerchantCenterLinkInvitationIdentifier)

Apenas saída. Convite de vinculação do Merchant Center.

HotelCenterLinkInvitationIdentifier

O identificador da conta do hotel.

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

string (int64 format)

Apenas saída. O código da Central para Hotéis da conta do hotel. Este campo é somente leitura

MerchantCenterLinkInvitationIdentifier

É o identificador da conta do Merchant Center.

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

string (int64 format)

Apenas saída. O ID do Merchant Center da conta do comerciante. Este campo é somente leitura

Recomendação

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)
  }
  // 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.

O campo será definido para os seguintes tipos de recomendações: CALL_EXTENSION_EXT.TEXT, PARTNER_
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.

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

SearchTermView

Uma visualização do termo de pesquisa com métricas agregadas por termo de pesquisa no nível do grupo de anúncios.

Representação JSON 
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do termo de pesquisa. Os nomes dos recursos de visualização de termos de pesquisa têm o seguinte formato:

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}
status

enum (SearchTermTargetingStatus)

Apenas saída. Indica se o termo de pesquisa é atualmente uma das suas palavras-chave segmentadas ou excluídas.
searchTerm

string

Apenas saída. O termo da pesquisa.
adGroup

string

Apenas saída. O grupo de anúncios em que o termo de pesquisa foi veiculado.

SearchTermTargetingStatus

Indica se o termo de pesquisa é uma das suas palavras-chave segmentadas ou excluídas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ADDED O termo de pesquisa foi adicionado às palavras-chave segmentadas.
EXCLUDED O termo de pesquisa corresponde a uma palavra-chave negativa.
ADDED_EXCLUDED O termo de pesquisa foi adicionado e excluído.
NONE O termo de pesquisa não está segmentado nem excluído.

ShoppingPerformanceView

Visualização de desempenho do Google Shopping. Oferece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores das dimensões de produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, vão refletir o estado de cada dimensão a partir da data e hora em que o evento correspondente foi registrado.

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

string

Apenas saída. O nome do recurso da visualização de desempenho do Google Shopping. Os nomes dos recursos de visualização de desempenho do Shopping têm o seguinte formato: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

Visualização do termo de pesquisa da campanha inteligente.

Representação JSON 
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do termo de pesquisa da campanha inteligente. Os nomes dos recursos de visualização de termos de pesquisa das campanhas inteligentes têm a seguinte forma:

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}
searchTerm

string

Apenas saída. O termo da pesquisa.
campaign

string

Apenas saída. A campanha inteligente em que o termo de pesquisa foi veiculado.

TopicView

Uma visualização de tópicos.

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

string

Apenas saída. O nome do recurso da visualização do tópico. Os nomes dos recursos de visualização de tópicos têm o seguinte formato:

customers/{customerId}/topicViews/{adGroupId}~{criterionId}

TravelActivityGroupView

Visualização do grupo de atividades de viagem.

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

string

Apenas saída. O nome do recurso da visualização do grupo de atividades de viagem. Os nomes dos recursos de visualização do grupo de atividades de viagem têm o seguinte formato:

customers/{customerId}/travelActivityGroupViews/{adGroupId}~{criterionId}

TravelActivityPerformanceView

Uma visualização do desempenho de atividades de viagem.

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

string

Apenas saída. O nome do recurso da visualização de desempenho da atividade de viagem. Os nomes dos recursos de visualização de desempenho da atividade de viagem têm o seguinte formato:

customers/{customerId}/travelActivityPerformanceView

UserInterest

Um interesse do usuário: um segmento específico com base em interesses a ser segmentado.

Representação JSON 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso do interesse do usuário. Os nomes dos recursos de interesse do usuário têm o seguinte formato:

customers/{customerId}/userInterests/{userInterestId}
taxonomyType

enum (UserInterestTaxonomyType)

Apenas saída. Tipo de taxonomia do interesse do usuário.
availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade do interesse do usuário.
userInterestId

string (int64 format)

Apenas saída. O ID do interesse do usuário.
name

string

Apenas saída. O nome do interesse do usuário.
userInterestParent

string

Apenas saída. O pai do interesse do usuário.
launchedToAll

boolean

Apenas saída. Verdadeiro se o interesse do usuário tiver sido lançado em todos os canais e localidades.

UserInterestTaxonomyType

Enumeração contendo os possíveis User InterestTaxonomyTypes.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
AFFINITY A afinidade desse interesse do usuário.
IN_MARKET O mercado desse interesse do usuário.
MOBILE_APP_INSTALL_USER Usuários conhecidos por instalarem aplicativos nas categorias especificadas.
VERTICAL_GEO A localização geográfica da indústria com base em interesses.
NEW_SMART_PHONE_USER Critérios de interesse do usuário para novos usuários de smartphones.

LifeEvent

Um evento importante: uma indústria específica com base em interesses a ser segmentada para alcançar usuários quando eles estiverem passando por marcos importantes da vida.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Campos
resourceName

string

Apenas saída. O nome do recurso do evento importante. Os nomes dos recursos de eventos importantes têm o seguinte formato:

customers/{customerId}/lifeEvents/{lifeEventId}
id

string (int64 format)

Apenas saída. O ID do evento importante.
name

string

Apenas saída. O nome do evento importante, por exemplo,"Mudou recentemente".
parent

string

Apenas saída. O pai de lifeEvent.
launchedToAll

boolean

Apenas saída. Verdadeiro se o evento importante foi lançado para todos os canais e locais.
availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade do evento importante.

UserLocationView

Uma visualização do local do usuário.

A visualização do local do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele informa métricas da localização física real do usuário por região de segmentação ou não. Se outros campos de segmento forem utilizados, você poderá obter mais de uma linha por país.

Representação JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do local do usuário. Os nomes dos recursos de visualização UserLocation têm o seguinte formato:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

Apenas saída. ID do critério do país.
targetingLocation

boolean

Apenas saída. Indica se o local foi segmentado ou não.

TopicConstant

Use tópicos para segmentar ou excluir canais na Rede de Display do Google com base na categoria em que o canal se enquadra (por exemplo, "Animais de estimação e animais/Animais de estimação/Cães").

Representação JSON 
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de tópico. Esses nomes têm o seguinte formato:

topicConstants/{topic_id}
path[]

string

Apenas saída. A categoria a ser segmentada ou excluída. Cada elemento subsequente na matriz descreve uma subcategoria mais específica. Por exemplo, {"Pets & Animals", "Pets", "Dogs"} representa a categoria "Animais de estimação e animais/Animais de estimação/Cães". Lista de categorias de tópicos disponíveis em https://developers.google.com/google-ads/api/reference/data/verticals
id

string (int64 format)

Apenas saída. O ID do tópico.
topicConstantParent

string

Apenas saída. Nome do recurso do pai da constante de tópico.

Video

Um vídeo.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do vídeo. Os nomes dos recursos de vídeo têm o seguinte formato:

customers/{customerId}/videos/{videoId}
id

string

Apenas saída. O ID do vídeo.
channelId

string

Apenas saída. O ID do canal do proprietário do vídeo.
durationMillis

string (int64 format)

Apenas saída. A duração do vídeo em milissegundos.
title

string

Apenas saída. É o título do vídeo.

WebpageView

Uma visualização de página da Web.

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

string

Apenas saída. O nome do recurso da visualização da página da Web. Os nomes dos recursos de visualização de página da Web têm o seguinte formato:

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

LeadFormSubmissionData

Dados dos envios de formulário de lead.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso dos dados de envio do formulário de lead. Os nomes dos recursos de dados de envio de formulário de lead têm o seguinte formato:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}
id

string

Apenas saída. É o ID deste envio do formulário de lead.
asset

string

Apenas saída. Recurso associado ao formulário de lead enviado.
campaign

string

Apenas saída. Campanha associada ao formulário de lead enviado.
leadFormSubmissionFields[]

object (LeadFormSubmissionField)

Apenas saída. Dados de envio associados a um formulário de lead.
customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

Apenas saída. Dados de envio associados a um formulário de lead personalizado.
adGroup

string

Apenas saída. Grupo de anúncios associado ao formulário de lead enviado.
adGroupAd

string

Apenas saída. O grupo de anúncios associado ao formulário de lead enviado.
gclid

string

Apenas saída. ID de clique do Google associado ao formulário de lead enviado.
submissionDateTime

string

Apenas saída. Data e hora em que o formulário de lead foi enviado. O formato é "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".

LeadFormSubmissionField

Campos no formulário de lead enviado.

Representação JSON 
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
Campos
fieldType

enum (LeadFormFieldUserInputType)

Apenas saída. Tipo dos campos do formulário de lead.
fieldValue

string

Apenas saída. Valor dos campos do formulário de lead.

CustomLeadFormSubmissionField

Campos na pergunta personalizada enviada

Representação JSON 
{
  "questionText": string,
  "fieldValue": string
}
Campos
questionText

string

Apenas saída. O texto da pergunta personalizada. O número máximo de caracteres é 300.
fieldValue

string

Apenas saída. Valor do campo para resposta à pergunta personalizada. O número máximo de caracteres é 70.

LocalServicesLead

Dados do lead dos Serviços Locais. Contém detalhes do lead que é gerado quando o usuário liga, envia uma mensagem ou agenda o serviço do anunciante. Mais informações: https://ads.google.com/local-services-ads

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  }
}
Campos
resourceName

string

Apenas saída. O nome do recurso dos dados do lead de serviços locais. O nome do recurso de lead dos Serviços Locais tem o formato

customers/{customerId}/localServicesLead/{local_services_lead_id}
id

string (int64 format)

Apenas saída. É o ID desse lead.
categoryId

string

Apenas saída. Categoria de serviço do lead. Por exemplo: xcat:service_area_business_hvac, xcat:service_area_business_real_estate_agent etc. Para mais detalhes, acesse: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
serviceId

string

Apenas saída. Serviço da categoria. Por exemplo: buyer_agent, seller_agent para a categoria xcat:service_area_business_real_estate_agent.
contactDetails

object (ContactDetails)

Apenas saída. Detalhes de contato do lead.
leadType

enum (LeadType)

Apenas saída. Tipo de lead dos Serviços Locais: telefone, mensagem, reserva etc.
leadStatus

enum (LeadStatus)

Apenas saída. Status atual do lead.
creationDateTime

string

Apenas saída. Data e hora em que o lead foi criado pelos anúncios dos Serviços Locais. O formato é "AAAA-MM-DD HH:MM:SS" no fuso horário da conta do Google Ads. Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
locale

string

Apenas saída. Idioma usado pelo provedor do Serviços Locais vinculado ao lead. Consulte https://developers.google.com/google-ads/api/data/codes-formats#locales
leadCharged

boolean

Apenas saída. Verdadeiro se o anunciante foi cobrado pelo lead.
note

object (Note)

Apenas saída. Nota adicionada pelo anunciante para o lead.

ContactDetails

Campos contendo detalhes de contato do consumidor.

Representação JSON 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
Campos
phoneNumber

string

Apenas saída. Número de telefone do consumidor no formato E164.
email

string

Apenas saída. Endereço de e-mail do consumidor.
consumerName

string

Apenas saída. Nome do consumidor se ele aparecer na mensagem ou no formulário de reserva no google.com

LeadType

Possíveis tipos de lead.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
MESSAGE Lead de mensagem.
PHONE_CALL Lead criado por chamada telefônica.
BOOKING Lead de reserva.

LeadStatus

Possíveis status do lead.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
NEW Novo lead que ainda não foi visto pelo anunciante.
ACTIVE Lead que teve a interação do anunciante.
BOOKED O lead foi reservado.
DECLINED O lead foi recusado pelo anunciante.
EXPIRED O lead expirou por inatividade.
DISABLED Desativada devido a spam ou disputa.
CONSUMER_DECLINED O consumidor recusou o lead.
WIPED_OUT As informações de identificação pessoal do lead são apagadas.

Observação

Representa uma observação adicionada a um lead pelo anunciante. Os anunciantes podem editar notas, o que redefine o horário de edição e altera a descrição.

Representação JSON 
{
  "editDateTime": string,
  "description": string
}
Campos
editDateTime

string

Apenas saída. Data e hora em que a nota do lead foi editada. O formato é "AAAA-MM-DD HH:MM:SS" no fuso horário da conta do Google Ads. Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
description

string

Apenas saída. Conteúdo da nota de lead.

LocalServicesLeadConversation

Dados da conversa de leads dos Serviços Locais. Contém detalhes da conversa de lead que é gerado quando o usuário liga, envia mensagens ou agenda o serviço do anunciante. Eles são anexados a um lead. Mais informações: https://ads.google.com/local-services-ads

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
Campos
resourceName

string

Apenas saída. O nome do recurso dos dados da conversa do lead dos serviços locais. O nome do recurso de conversa de lead dos Serviços Locais tem o formato

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}
id

string (int64 format)

Apenas saída. ID desta conversa principal.
conversationChannel

enum (ConversationType)

Apenas saída. Tipo de conversa para leads de GLS, EMAIL, MESSAGE, PHONE_CALL, SMS etc.
participantType

enum (ParticipantType)

Apenas saída. Tipo de participante na conversa de lead: ADVERTISER ou CONSUMER.
lead

string

Apenas saída. Nome do recurso do lead associado à conversa do lead.
eventDateTime

string

Apenas saída. Data e hora em que a conversa do lead foi criada pelos anúncios dos Serviços Locais. O formato é "AAAA-MM-DD HH:MM:SS" no fuso horário da conta do Google Ads. Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
phoneCallDetails

object (PhoneCallDetails)

Apenas saída. Detalhes da conversa por chamada telefônica no caso de PHONE_CALL.
messageDetails

object (MessageDetails)

Apenas saída. Detalhes da conversa por mensagem no caso de EMAIL, MESSAGE ou SMS.

ConversationType

Tipos possíveis de conversa de lead.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EMAIL Conversa de lead por e-mail.
MESSAGE Conversa de lead de mensagem.
PHONE_CALL Conversa de lead telefônico.
SMS Conversa para lead por SMS.
BOOKING Agendando conversa de lead.

ParticipantType

Possíveis tipos de participante da conversa principal.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ADVERTISER Participante do provedor de anúncios dos Serviços Locais.
CONSUMER Participante do consumidor de anúncios dos Serviços Locais.

PhoneCallDetails

Representa os detalhes de uma conversa de chamada telefônica.

Representação JSON 
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
Campos
callDurationMillis

string (int64 format)

Apenas saída. A duração (em milissegundos) da chamada telefônica (de ponta a ponta).
callRecordingUrl

string

Apenas saída. URL para o arquivo de áudio de gravação de chamada.

MessageDetails

Representa os detalhes da mensagem de texto no caso de e-mail, mensagem ou SMS.

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

string

Apenas saída. Conteúdo textual da mensagem.

AndroidPrivacySharedKeyGoogleAdGroup

Uma visualização da chave compartilhada de privacidade do Android para a chave do grupo de anúncios do Google.

Representação JSON 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da chave compartilhada de privacidade do Android. Os nomes dos recursos da chave compartilhada de privacidade do Android têm o seguinte formato:

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

Apenas saída. O ID da campanha usado na codificação da chave de compartilhamento.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

Apenas saída. A enumeração do tipo de interação usada na codificação de chave de compartilhamento.
androidPrivacyInteractionDate

string

Apenas saída. É a data da interação usada na codificação de chave compartilhada no formato "AAAA-MM-DD" no fuso horário UTC.
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

Apenas saída. A enumeração do tipo de rede usada na codificação de chave de compartilhamento.
adGroupId

string (int64 format)

Apenas saída. O ID do grupo de anúncios usado na codificação de chave de compartilhamento.
sharedAdGroupKey

string

Apenas saída. String hexadecimal de 128 bits da chave codificada do grupo de anúncios compartilhada, incluindo um prefixo "0x". Essa chave pode ser usada para fazer um operador bit a bit OR com a chave de conversão agregada e criar uma chave de agregação completa e recuperar o Relatório de API agregado no Sandbox de privacidade do Android.

AndroidPrivacyInteractionType

Enumera os tipos de interação

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
CLICK É o tipo de interação por clique físico.
ENGAGED_VIEW O tipo de interação de visualização engajada de 10 segundos.
VIEW É o tipo de interação da visualização (impressão de anúncio).

AndroidPrivacyNetworkType

Enumera os tipos de rede

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH Rede de pesquisa.
DISPLAY Rede de Display.
YOUTUBE Rede do YouTube.

AndroidPrivacySharedKeyGoogleCampaign

Uma visualização da chave compartilhada de privacidade do Android para a chave de campanha do Google.

Representação JSON 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da chave compartilhada de privacidade do Android. Os nomes dos recursos da chave compartilhada de privacidade do Android têm o seguinte formato:

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

Apenas saída. O ID da campanha usado na codificação da chave de compartilhamento.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

Apenas saída. A enumeração do tipo de interação usada na codificação de chave de compartilhamento.
androidPrivacyInteractionDate

string

Apenas saída. É a data da interação usada na codificação de chave compartilhada no formato "AAAA-MM-DD" no fuso horário UTC.
sharedCampaignKey

string

Apenas saída. String hexadecimal de 128 bits da chave de campanha compartilhada codificada, incluindo um prefixo "0x". Essa chave pode ser usada para fazer um operador bit a bit OR com a chave de conversão agregada e criar uma chave de agregação completa e recuperar o Relatório de API agregado no Sandbox de privacidade do Android.

AndroidPrivacySharedKeyGoogleNetworkType

Uma visualização de chave compartilhada de privacidade do Android para a chave de tipo de Rede do Google.

Representação JSON 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da chave compartilhada de privacidade do Android. Os nomes dos recursos da chave compartilhada de privacidade do Android têm o seguinte formato:

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

Apenas saída. O ID da campanha usado na codificação da chave de compartilhamento.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

Apenas saída. A enumeração do tipo de interação usada na codificação de chave de compartilhamento.
androidPrivacyInteractionDate

string

Apenas saída. É a data da interação usada na codificação de chave compartilhada no formato "AAAA-MM-DD" no fuso horário UTC.
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

Apenas saída. A enumeração do tipo de rede usada na codificação de chave de compartilhamento.
sharedNetworkTypeKey

string

Apenas saída. String hexadecimal de 128 bits da chave codificada de tipo de rede compartilhada, incluindo um prefixo "0x". Essa chave pode ser usada para fazer um operador bit a bit OR com a chave de conversão agregada e criar uma chave de agregação completa e recuperar o Relatório de API agregado no Sandbox de privacidade do Android.

Métricas

Dados de métricas.

Representação JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValueMicros": string,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Campos
allConversionsValueByConversionDate

number

Valor de todas as conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
allConversionsByConversionDate

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
conversionsValueByConversionDate

number

Valor das conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
conversionsByConversionDate

number

O número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
historicalCreativeQualityScore

enum (QualityScoreBucket)

O índice de qualidade histórico do criativo.
historicalLandingPageQualityScore

enum (QualityScoreBucket)

A qualidade da experiência histórica na página de destino.
historicalSearchPredictedCtr

enum (QualityScoreBucket)

A taxa de cliques (CTR) prevista de pesquisa histórica.
interactionEventTypes[]

enum (InteractionEventType)

Os tipos de interação com pagamentos e sem custo.
skAdNetworkInstalls

string (int64 format)

É o número de conversões de rede de publicidade do kit da loja do iOS.
skAdNetworkTotalConversions

string (int64 format)

É o número total de conversões de rede de publicidade do kit da loja do iOS.
publisherPurchasedClicks

string (int64 format)

Cliques de propriedades cujo tráfego foi pago ou adquirido por atividades de incentivo pelo editor, mas que não pertencem a ele
publisherOrganicClicks

string (int64 format)

Cliques de propriedades para as quais o tráfego que o editor não pagou ou não adquiriu por meio de atividades incentivadas
publisherUnknownClicks

string (int64 format)

Cliques do tráfego que não é identificado como "Comprado pelo editor" ou "Orgânico do editor"
absoluteTopImpressionPercentage

number

A parcela de impressões na primeira posição da pesquisa é a porcentagem de impressões de anúncios de pesquisa que são exibidas na posição de maior destaque da rede.
activeViewCpm

number

Custo médio das impressões visíveis (activeViewImpressions).
activeViewCtr

number

Cliques mensuráveis do Active View divididos pelas impressões visíveis do Active View.

Essa métrica é informada apenas para a Rede de Display.
activeViewImpressions

string (int64 format)

Uma medida da frequência com que seu anúncio ficou visível em um site da Rede de Display.
activeViewMeasurability

number

É a proporção de impressões que podem ser medidas pelo Active View pelo número de impressões veiculadas.
activeViewMeasurableCostMicros

string (int64 format)

O custo das impressões recebidas que foram avaliadas pelo Active View.
activeViewMeasurableImpressions

string (int64 format)

O número de vezes que seus anúncios são exibidos em canais em posições em que podem ser vistos.
activeViewViewability

number

A porcentagem de tempo em que seu anúncio foi exibido em um site com Active View ativado (impressões mensuráveis) e ficou visível (impressões visíveis).
allConversionsFromInteractionsRate

number

Todas as conversões de interações (como opostas a conversões de visualização) divididas pelo número de interações com anúncios.
allConversionsValue

number

Valor de todas as conversões.
allNewCustomerLifetimeValue

number

Valor da conversão da vida útil de todos os novos clientes. Se você configurou uma meta de aquisição de clientes no nível da conta ou da campanha, isso incluirá o valor da conversão adicional de novos clientes para conversões que recebem ou não recebem lances. Se a sua campanha adotou a meta de aquisição de clientes e selecionou "Lance mais alto para novos clientes", esses valores serão incluídos em "allConversionsValue". Consulte https://support.google.com/google-ads/answer/12080169 para mais detalhes.
allConversions

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric.
allConversionsValuePerCost

number

O valor de todas as conversões dividido pelo custo total das interações com os anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).
allConversionsFromClickToCall

number

O número de vezes que os usuários clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. Esse número não indica se as ligações foram ou não completadas nem a duração delas.

Essa métrica se aplica somente a itens do feed.
allConversionsFromDirections

number

O número de vezes que os usuários clicaram no botão "Como chegar" para ir a uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.
allConversionsFromInteractionsValuePerInteraction

number

O valor de todas as conversões de interações dividido pelo número total de interações.
allConversionsFromMenu

number

O número de vezes que os usuários clicaram em um link para ver o menu de uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.
allConversionsFromOrder

number

Quantas vezes os usuários fizeram um pedido em uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.
allConversionsFromOtherEngagement

number

O número de outras conversões (por exemplo, postar uma avaliação ou salvar o local de uma loja) que ocorreram depois que os usuários clicaram em um anúncio.

Essa métrica se aplica somente a itens do feed.
allConversionsFromStoreVisit

number

Número estimado de vezes que os usuários visitaram uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.
allConversionsFromStoreWebsite

number

O número de vezes que os usuários foram direcionados ao URL de uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.
auctionInsightSearchAbsoluteTopImpressionPercentage

number

Essa métrica faz parte do Relatório de informações do leilão e informa com que frequência os anúncios de outro participante foram exibidos na posição de maior destaque da página de resultados de pesquisa. Essa porcentagem é calculada apenas com base nos leilões em que você apareceu na página.

Essa métrica não está disponível publicamente.
auctionInsightSearchImpressionShare

number

Essa métrica faz parte do Relatório de informações do leilão e informa a porcentagem de impressões que outro participante teve em relação ao número total de impressões para as quais seus anúncios estavam qualificados. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Essa métrica não está disponível publicamente.
auctionInsightSearchOutrankingShare

number

Essa métrica faz parte do Relatório de informações do leilão e informa a porcentagem de impressões em que seus anúncios superaram (exibidos acima) outros participantes do leilão, em comparação com o número total de impressões para as quais seus anúncios estavam qualificados. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Essa métrica não está disponível publicamente.
auctionInsightSearchOverlapRate

number

Essa métrica faz parte do Relatório de informações do leilão e informa com que frequência o anúncio de outro participante recebeu uma impressão quando seu anúncio também recebeu uma impressão.

Essa métrica não está disponível publicamente.
auctionInsightSearchPositionAboveRate

number

Essa métrica faz parte do Relatório de informações do leilão e informa a frequência com que o anúncio de outro participante foi exibido em uma posição mais elevada que o seu, quando ambos os anúncios foram exibidos na mesma página.

Essa métrica não está disponível publicamente.
auctionInsightSearchTopImpressionPercentage

number

Essa métrica faz parte do Relatório de informações do leilão e informa com que frequência os anúncios de outro participante foram exibidos ao lado dos principais resultados de pesquisa orgânica. Essa porcentagem é calculada apenas com base nos leilões em que você apareceu na página.

Essa métrica não está disponível publicamente.
averageCost

number

Valor médio que você paga por interação. Esse valor é o custo total dos seus anúncios dividido pelo número total de interações.
averageCpc

number

O custo total de todos os cliques dividido pelo número total de cliques recebidos.
averageCpe

number

O valor médio cobrado por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncios dividido pelo número total de engajamentos de anúncios.
averageCpm

number

Custo médio por mil impressões (CPM médio).
averageCpv

number

O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pela divisão do custo total de todas as visualizações pelo número de visualizações do anúncio.
averagePageViews

number

Número médio de páginas visualizadas por sessão.
averageTimeOnSite

number

Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics.
benchmarkAverageMaxCpc

number

Uma indicação de como outros anunciantes estão definindo lances para produtos semelhantes.
biddableAppInstallConversions

number

Número de instalações do app.
biddableAppPostInstallConversions

number

Número de ações no app.
benchmarkCtr

number

Uma indicação da performance dos anúncios do Shopping de outros anunciantes para produtos semelhantes com base na frequência com que as pessoas que veem o anúncio clicam neles.
bounceRate

number

Porcentagem de cliques em que o usuário visitou apenas uma página do site. Importado do Google Analytics.
clicks

string (int64 format)

O número de cliques.
combinedClicks

string (int64 format)

O número de vezes que os usuários clicaram no seu anúncio ou na listagem do seu site nos resultados não pagos. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
combinedClicksPerQuery

number

O número de vezes que seu anúncio ou a listagem do seu site nos resultados não pagos foram clicados (combinedClicks) dividido por combinadoQueries. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
combinedQueries

string (int64 format)

O número de pesquisas que retornaram páginas do seu site nos resultados não pagos ou que exibiram um dos seus anúncios de texto. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
contentBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de Display, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
contentImpressionShare

number

As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você pode receber. Observação: a parcela de impressões de conteúdo é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.
conversionLastReceivedRequestDateTime

string

A última data e hora em que a tag de conversão dessa ação de conversão foi disparada e foi vista pelo Google Ads. Esse evento de disparo pode não ter sido o resultado de uma conversão atribuível. Por exemplo, a tag foi disparada de um navegador que não clicou anteriormente em um anúncio de um anunciante apropriado. A data/hora está no fuso horário do cliente.
conversionLastConversionDate

string

A data da conversão mais recente para esta ação de conversão. A data está no fuso horário do cliente.
contentRankLostImpressionShare

number

A porcentagem estimada de impressões na rede de Display que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas do conteúdo é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
conversionsFromInteractionsRate

number

Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
conversionsValue

number

Valor das conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
newCustomerLifetimeValue

number

Valor da conversão de vida útil de novos clientes. Se você configurou uma meta de aquisição de clientes no nível da conta ou da campanha, isso incluirá o valor da conversão adicional de novos clientes para conversões que recebem lances. Se a sua campanha adotou a meta de aquisição de clientes e selecionou "Lance mais alto para novos clientes", esses valores serão incluídos em "conversionsValue" para otimização. Consulte https://support.google.com/google-ads/answer/12080169 para mais detalhes.
conversionsValuePerCost

number

O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
conversionsFromInteractionsValuePerInteraction

number

O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
conversions

number

O número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
costMicros

string (int64 format)

A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período.
costPerAllConversions

number

O custo das interações com anúncios dividido por todas as conversões.
costPerConversion

number

O custo das interações com anúncios dividido pelas conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
costPerCurrentModelAttributedConversion

number

O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
crossDeviceConversions

number

Conversões de um cliente que clica em um anúncio do Google Ads em um dispositivo e faz a conversão em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em todas as conversões.
crossDeviceConversionsValueMicros

string (int64 format)

A soma do valor das conversões em dispositivos diferentes, em micros.
ctr

number

O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões).
currentModelAttributedConversions

number

Mostra a aparência dos dados históricos de conversão no modelo de atribuição selecionado no momento. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
currentModelAttributedConversionsFromInteractionsRate

number

Modelo atual de conversões atribuídas a partir de interações divididas pelo número de interações com o anúncio (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

O valor das conversões atribuídas pelo modelo atual a partir das interações dividido pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
currentModelAttributedConversionsValue

number

O valor das conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
currentModelAttributedConversionsValuePerCost

number

O valor das conversões atribuídas ao modelo atual dividido pelo custo das interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
engagementRate

number

A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.
engagements

string (int64 format)

O número de interações. A interação ocorre quando um usuário expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncio poderão ser compatíveis com as métricas de engajamento.
hotelAverageLeadValueMicros

number

Valor médio do lead com base nos cliques.
hotelCommissionRateMicros

string (int64 format)

Taxa de lances de comissão em micros. Uma comissão de 20% é representada como 200.000.
hotelExpectedCommissionCost

number

Custo de comissão esperado. O resultado da multiplicação do valor da comissão vezes hotel_commission_rate na moeda do anunciante.
hotelPriceDifferencePercentage

number

A diferença média de preço entre o preço oferecido pelo anunciante de hotéis que informa e o preço mais barato oferecido pelo anunciante concorrente.
hotelEligibleImpressions

string (int64 format)

O número de impressões que os parceiros de hotéis poderiam ter atribuído a performance do feed.
historicalQualityScore

string (int64 format)

O índice de qualidade histórico.
gmailForwards

string (int64 format)

O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.
gmailSaves

string (int64 format)

O número de vezes que alguém salvou seu anúncio do Gmail na Caixa de entrada como uma mensagem.
gmailSecondaryClicks

string (int64 format)

O número de cliques para acessar a página de destino no estado expandido dos anúncios do Gmail.
impressionsFromStoreReach

string (int64 format)

Quantas vezes o anúncio de uma loja com base no local foi exibido.

Essa métrica se aplica somente a itens do feed.
impressions

string (int64 format)

Contagem da frequência com que seu anúncio foi exibido em uma página de resultados de pesquisa ou em um site na Rede do Google.
interactionRate

number

A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
interactions

string (int64 format)

O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio (cliques em anúncios de texto e do Shopping, visualizações de anúncios em vídeo etc.).
invalidClickRate

number

A porcentagem de cliques filtrados do número total de cliques (cliques filtrados e não filtrados) durante o período do relatório.
invalidClicks

string (int64 format)

Número de cliques que o Google considera ilegítimos e que não são cobrados de você.
messageChats

string (int64 format)

Número de chats de mensagens iniciados para impressões de clique para enviar mensagens que estavam qualificadas para o rastreamento de mensagens.
messageImpressions

string (int64 format)

Número de impressões do tipo "clique para enviar mensagem" que estavam qualificadas para o acompanhamento de mensagens.
messageChatRate

number

Número de chats de mensagens iniciados (messageChats) dividido pelo número de impressões de mensagens (messageimpressions). É a taxa em que um usuário inicia um chat por mensagens a partir de uma impressão de anúncio com a opção de mensagens e o rastreamento de mensagens ativados. Essa taxa pode ser maior que 1,0 para uma determinada impressão de mensagem.
mobileFriendlyClicksPercentage

number

A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis.
optimizationScoreUplift

number

Aumento total da pontuação de otimização de todas as recomendações.
optimizationScoreUrl

string

URL da página da pontuação de otimização na interface da Web do Google Ads. Essa métrica pode ser selecionada de customer ou campaign e pode ser segmentada por segments.recommendation_type. Por exemplo, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer retorna um URL para cada combinação exclusiva (customer, recommendationsType).
organicClicks

string (int64 format)

O número de vezes que alguém clicou na listagem do seu site nos resultados não pagos para uma consulta específica. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
organicClicksPerQuery

number

O número de vezes que alguém clicou na listagem de seu site nos resultados não pagos (orgânicas) dividido pelo número total de pesquisas que retornaram páginas de seu site (organicQueries). Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
organicImpressions

string (int64 format)

É o número de listagens do seu site nos resultados da pesquisa não pagas. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
organicImpressionsPerQuery

number

O número de vezes que uma página do seu site foi listada nos resultados de pesquisa não paga (orgânicas) dividido pelo número de pesquisas que retornam a listagem do seu site nos resultados não pagos (orgânicas). Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
organicQueries

string (int64 format)

O número total de pesquisas que retornaram a listagem do seu site nos resultados não pagos. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.
percentNewVisitors

number

Porcentagem de primeiras sessões (de pessoas que nunca visitaram seu site). Importado do Google Analytics.
phoneCalls

string (int64 format)

Número de chamadas off-line.
phoneImpressions

string (int64 format)

Número de impressões do número de telefone off-line.
phoneThroughRate

number

Número de chamadas telefônicas recebidas (phoneCalls) dividido pelo número de vezes que seu número de telefone foi mostrado (phoneImpressões).
relativeCtr

number

Sua taxa de cliques (CTR) dividida pela taxa média de cliques de todos os anunciantes nos sites que exibem seus anúncios. Avalia o desempenho dos seus anúncios em sites da Rede de Display em comparação com outros anúncios nos mesmos sites.
searchAbsoluteTopImpressionShare

number

A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente exibidas na posição de maior destaque no Shopping. Consulte https://support.google.com/google-ads/answer/7501826 para mais detalhes. Qualquer valor abaixo de 0,1 é informado como 0,0999.
searchBudgetLostAbsoluteTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi o primeiro entre os principais anúncios nos resultados de pesquisa devido a um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
searchBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de pesquisa, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
searchBudgetLostTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi exibido ao lado dos principais resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
searchClickShare

number

O número de cliques que você recebeu na rede de pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.
searchExactMatchImpressionShare

number

As impressões recebidas divididas pelo número estimado de impressões que você tinha qualificação para receber na rede de pesquisa para termos de pesquisa que corresponderam exatamente às suas palavras-chave (ou eram variações aproximadas da sua palavra-chave), independentemente dos tipos de correspondência de palavra-chave. Observação: a parcela de impressões de correspondência exata de pesquisa é informada entre 0,1 e 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.
searchImpressionShare

number

O número de impressões recebidas na rede de pesquisa dividido pelo número estimado de impressões que você está qualificado para receber. Observação: a parcela de impressões da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.
searchRankLostAbsoluteTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi o primeiro entre os principais resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
searchRankLostImpressionShare

number

A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
searchRankLostTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi exibido ao lado dos principais resultados da pesquisa orgânica devido a uma classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.
searchTopImpressionShare

number

As impressões que você recebeu entre os principais anúncios em comparação com o número estimado de impressões que você estava qualificado para receber entre eles. Observação: a parcela de impressões na parte superior da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Esses anúncios geralmente ficam acima dos resultados orgânicos principais, embora possam aparecer abaixo desses resultados em determinadas consultas.
searchVolume

object (SearchVolumeRange)

Intervalo do volume de pesquisas para uma categoria de insight do termo de pesquisa.
speedScore

string (int64 format)

Uma medida da velocidade de carregamento da página após o clique em anúncios para dispositivos móveis. A pontuação varia de 1 a 10, sendo 10 a mais rápida.
averageTargetCpaMicros

string (int64 format)

É o CPA desejado médio. Se não estiver disponível, por exemplo, para campanhas que tinham tráfego de estratégias de lances de portfólio ou não tCPA.
averageTargetRoas

number

O ROAS desejado médio ou não definido, se não estiver disponível. Por exemplo, para campanhas que tinham tráfego de estratégias de lances de portfólio ou não tROAS.
topImpressionPercentage

number

A porcentagem de impressões de anúncios que são exibidas ao lado dos principais resultados da pesquisa orgânica.
validAcceleratedMobilePagesClicksPercentage

number

A porcentagem de cliques no anúncio em páginas de destino Accelerated Mobile Pages (AMP) que levam a uma página AMP válida.
valuePerAllConversions

number

O valor de todas as conversões dividido pelo número de todas as conversões.
valuePerAllConversionsByConversionDate

number

O valor de todas as conversões dividido pelo número de todas as conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
valuePerConversion

number

O valor das conversões dividido pelo número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
valuePerConversionsByConversionDate

number

O valor das conversões dividido pelo número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.
valuePerCurrentModelAttributedConversion

number

O valor do modelo atual atribuído a conversões dividido pelo número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
videoQuartileP100Rate

number

Porcentagem de impressões em que os espectadores assistiram todo o vídeo.
videoQuartileP25Rate

number

Porcentagem de impressões em que o espectador assistiu 25% do seu vídeo.
videoQuartileP50Rate

number

Porcentagem de impressões em que o espectador assistiu 50% do seu vídeo.
videoQuartileP75Rate

number

Porcentagem de impressões em que o espectador assistiu 75% do seu vídeo.
videoViewRate

number

O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões dele, incluindo impressões de miniaturas de anúncios TrueView em display.
videoViews

string (int64 format)

Número de vezes que seus anúncios em vídeo foram visualizados.
viewThroughConversions

string (int64 format)

O número total de conversões de visualização. Elas acontecem quando um cliente vê um anúncio gráfico ou rich media e depois conclui uma conversão no seu site sem interagir (por exemplo, clicar) com outro anúncio.
allConversionsFromLocationAssetClickToCall

number

Número de cliques no botão de chamada em qualquer plataforma de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.
allConversionsFromLocationAssetDirections

number

Número de cliques em rotas de carro em qualquer superfície de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.
allConversionsFromLocationAssetMenu

number

Número de cliques em links de menu em qualquer plataforma de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.
allConversionsFromLocationAssetOrder

number

É o número de cliques em pedidos em qualquer plataforma de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.
allConversionsFromLocationAssetOtherEngagement

number

É o número de outros tipos de cliques de ação local em qualquer plataforma após um evento de anúncio sujeito a cobrança (clique ou impressão). Essa medida é proveniente do local com base nos recursos.
allConversionsFromLocationAssetStoreVisits

number

Número estimado de visitas à loja após um evento de anúncio (clique ou impressão) que pode ser cobrado. Essa medida é proveniente do local com base nos recursos.
allConversionsFromLocationAssetWebsite

number

É o número de cliques no URL do site em qualquer plataforma após um evento de anúncio (clique ou impressão) que pode ser cobrado. Essa medida é proveniente do local com base nos recursos.
eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

É o número de impressões em que o local da loja foi mostrado ou foi usado para segmentação. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetClickToCall

number

Número de cliques no botão de chamada em qualquer superfície de local após uma impressão. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetDirections

number

Número de cliques para rotas de carro em qualquer superfície de local após uma impressão. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetMenu

number

Número de cliques em links de menu em qualquer plataforma de local após uma impressão. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetOrder

number

É o número de cliques em pedidos em qualquer plataforma de local após uma impressão. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetOtherEngagement

number

É o número de outros tipos de cliques de ação local em qualquer superfície de local após uma impressão. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetStoreVisits

number

Número estimado de visitas à loja após uma impressão. Essa medida é proveniente do local com base nos recursos.
viewThroughConversionsFromLocationAssetWebsite

number

É o número de cliques no URL do site em qualquer plataforma após uma impressão. Essa medida é proveniente do local com base nos recursos.
orders

number

"Pedidos" é o número total de conversões de compra que você gerou e foram atribuídas aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se uma conversão for atribuída a interações anteriores com seus anúncios (cliques em anúncios de texto ou do Shopping, visualizações de anúncios em vídeo etc.), ela será contabilizada como um pedido. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa em um pedido no seu site. Embora a pessoa tenha comprado dois produtos, apenas um pedido é registrado. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
averageOrderValueMicros

string (int64 format)

O valor médio do pedido é a receita média por pedido atribuído aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. O valor médio do pedido é a receita total dos seus pedidos dividida pelo número total de pedidos. Exemplo: você recebeu três pedidos que geraram uma receita de US $10, US$ 15 e US $20. O valor médio do pedido é US$ 15 = (US$ 10 + US$ 15 + US$ 20)/3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
averageCartSize

number

O tamanho médio do carrinho é o número médio de produtos em cada pedido atribuído aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. O tamanho médio do carrinho é o número total de produtos vendidos dividido pelo número total de pedidos que você recebeu. Exemplo: você recebeu dois pedidos, o primeiro incluía três produtos e o segundo incluía dois. O tamanho médio do carrinho é de 2,5 produtos = (3+2)/2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
costOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos (CPV) é o custo total dos produtos que você vendeu em pedidos atribuídos aos seus anúncios. Como funciona: é possível adicionar um custo de produtos vendidos a cada produto no Merchant Center. Se você informar conversões com os dados do carrinho, os produtos vendidos vão corresponder ao custo dos produtos vendidos, e esse valor poderá ser usado para calcular o lucro bruto de cada pedido. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos vendidos para esse pedido é R$ 8 = R$ 3 + R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
grossProfitMicros

string (int64 format)

O lucro bruto é aquele gerado por pedidos atribuídos aos seus anúncios menos o custo dos produtos vendidos (CPV). Como funciona: o lucro bruto é a receita gerada pelas vendas atribuídas aos seus anúncios menos o custo dos produtos vendidos. Os cálculos de lucro bruto incluem apenas produtos que têm valor de custo dos produtos vendidos no Merchant Center. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa em um pedido no seu site. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. O chapéu tem um custo de produtos vendidos de R$ 3, mas a camisa não tem esse custo. O lucro bruto desse pedido só vai considerar o chapéu, ou seja, R $7 = R $10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
grossProfitMargin

number

A margem de lucro bruto é a porcentagem de lucro bruto gerada com os pedidos atribuídos aos seus anúncios após a dedução do custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. A margem de lucro bruto é o lucro bruto dividido pela receita total e multiplicado por 100%. Os cálculos de margem de lucro bruto incluem apenas itens que têm valor de custo dos produtos vendidos no Merchant Center. Exemplo: alguém comprou um chapéu e uma camisa em um pedido no seu site. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O preço da camisa é US$ 20, mas ela não tem custo dos produtos vendidos. A margem de lucro bruto desse pedido vai considerar apenas o chapéu, que tem o valor de custo dos produtos vendidos: 70% = (R$ 10 - R$ 3)/R$ 10 x 100%. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
revenueMicros

string (int64 format)

A receita é o valor total que você gerou pelos pedidos atribuídos aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. A receita é o valor total de todos os pedidos recebidos que são atribuídos aos seus anúncios, menos qualquer desconto. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa em um pedido no seu site. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. Todo o pedido tem um desconto de R$ 5. A receita desse pedido é de R$ 25 = (R$ 10 + R$ 20) - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
unitsSold

number

As unidades vendidas são o número total de produtos vendidos dos pedidos atribuídos aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. As unidades vendidas são o número total de produtos vendidos de todos os pedidos atribuídos aos seus anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. Nesse pedido, há três unidades vendidas. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
crossSellCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos (CPV) com venda cruzada é o valor total dos itens comercializados como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos de venda cruzada é o custo total dos produtos vendidos que não foram anunciados. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos de venda cruzada desse pedido é de R $5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
crossSellGrossProfitMicros

string (int64 format)

O lucro bruto de venda cruzada é o lucro dos produtos vendidos como resultado da publicidade de um produto diferente, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído na compra é um produto vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O lucro bruto de venda cruzada é a receita gerada com a venda cruzada atribuída aos seus anúncios menos o custo dos produtos vendidos. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
crossSellRevenueMicros

string (int64 format)

A receita de venda cruzada é o valor total que você ganha de produtos vendidos como resultado da publicidade de um produto diferente. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
crossSellUnitsSold

number

As unidades vendidas em venda cruzada representam o número total de produtos vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. As unidades vendidas em venda cruzada são o número total de produtos de venda cruzada em todos os pedidos atribuídos aos anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas em venda cruzada neste pedido é 2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
leadCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos de lead (CPV) é o custo total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse produto será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
leadGrossProfitMicros

string (int64 format)

O lucro bruto de lead é o lucro dos produtos vendidos como resultado da publicidade do mesmo produto, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, a receita gerada por essas vendas menos o custo dos produtos vendidos será seu lucro bruto de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
leadRevenueMicros

string (int64 format)

A receita de lead é o valor total gerado com produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor total gerado com as vendas desses itens vai ser mostrado em "Receita de lead". Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
leadUnitsSold

number

As unidades vendidas de lead representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas de lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.
uniqueUsers

string (int64 format)

O número de usuários únicos que viram seu anúncio durante o período solicitado. Essa métrica não pode ser agregada e só pode ser solicitada para períodos de até 92 dias. Essa métrica está disponível para os seguintes tipos de campanhas: display, vídeo, Discovery e para apps.
averageImpressionFrequencyPerUser

number

O número médio de vezes que um usuário único visualizou seu anúncio durante o período solicitado. Essa métrica não pode ser agregada e só pode ser solicitada para períodos de até 92 dias. Essa métrica está disponível para os seguintes tipos de campanhas: display, vídeo, Discovery e para apps.

InteractionEventType

Enumeração que descreve os tipos possíveis de interações a pagar e sem custo financeiro.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CLICK Clique para acessar o site. Na maioria dos casos, essa interação navega para um local externo, geralmente a página de destino do anunciante. Também é o InteractionEventType padrão para eventos de clique.
ENGAGEMENT A intenção expressa do usuário de interagir com o anúncio.
VIDEO_VIEW O usuário visualizou um anúncio em vídeo.
NONE O InteractionEventType padrão para eventos de conversão de anúncios. Usado quando uma linha de conversão de anúncios NÃO indica que as interações sem custo financeiro (por exemplo, conversões de anúncios) precisam ser "promovidas" e informadas como parte das métricas principais. Essas são simplesmente outras conversões (anúncios).

SearchVolumeRange

Intervalo do volume de pesquisa. O volume de pesquisa real está dentro deste intervalo.

Representação JSON 
{
  "min": string,
  "max": string
}
Campos
min

string (int64 format)

Limite inferior do volume de pesquisas.
max

string (int64 format)

Limite superior do volume de pesquisas.

Segmentos

Campos apenas para segmentos.

Representação JSON 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Campos
adDestinationType

enum (AdDestinationType)

Tipo de destino do anúncio.
adNetworkType

enum (AdNetworkType)

Tipo de rede de publicidade.
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

É o status da associação da campanha de orçamento.
clickType

enum (ClickType)

Tipo de clique.
conversionActionCategory

enum (ConversionActionCategory)

Categoria de ação de conversão.
conversionAttributionEventType

enum (ConversionAttributionEventType)

Tipo de evento de atribuição de conversão
conversionLagBucket

enum (ConversionLagBucket)

Um valor de enumeração que representa o número de dias entre a impressão e a conversão.
conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

É um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão.
dayOfWeek

enum (DayOfWeek)

Dia da semana, por exemplo, MONDAY.
device

enum (Device)

Dispositivo a que as métricas se aplicam.
externalConversionSource

enum (ExternalConversionSource)

Origem da conversão externa.
hotelCheckInDayOfWeek

enum (DayOfWeek)

Dia da semana do check-in no hotel.
hotelDateSelectionType

enum (HotelDateSelectionType)

Tipo de seleção da data do hotel.
hotelRateType

enum (HotelRateType)

Tipo de diária do hotel.
hotelPriceBucket

enum (HotelPriceBucket)

Faixa de preço do hotel.
keyword

object (Keyword)

Critério de palavra-chave.
monthOfYear

enum (MonthOfYear)

Mês do ano, por exemplo, janeiro.
placeholderType

enum (PlaceholderType)

Tipo de marcador de posição. Isso é usado somente com métricas de itens do feed.
productChannel

enum (ProductChannel)

Canal do produto.
productChannelExclusivity

enum (ProductChannelExclusivity)

Exclusividade do canal do produto.
productCondition

enum (ProductCondition)

Estado do produto.
recommendationType

enum (RecommendationType)

Tipo de recomendação.
searchEngineResultsPageType

enum (SearchEngineResultsPageType)

Tipo da página de resultados do mecanismo de pesquisa.
searchTermMatchType

enum (SearchTermMatchType)

Tipo de correspondência da palavra-chave que acionou o anúncio, incluindo variantes.
slot

enum (Slot)

Posição do anúncio.
conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

Dimensão principal das regras de valor da conversão aplicadas. NO_RULE_APPLIED mostra o valor total registrado das conversões que não têm uma regra de valor aplicada. "ORIGINAL" mostra o valor original das conversões às quais uma regra de valor foi aplicada. GEO_LOCATION, DEVICE, AUDIENCE mostra o ajuste líquido depois que as regras de valor foram aplicadas.
skAdNetworkUserType

enum (SkAdNetworkUserType)

Tipo de usuário da rede de publicidade do kit da loja do iOS.
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

Tipo de evento de anúncio da rede de publicidade do kit da loja do iOS.
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

Crédito de atribuição da rede de publicidade do kit da loja do iOS
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Valor de conversão aproximado da rede de anúncios do kit da loja do iOS.
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

O tipo de origem em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. Um valor nulo significa que o segmento não é aplicável, por exemplo, uma campanha que não é de iOS ou que nem o domínio de origem nem o aplicativo de origem estavam presentes em postbacks enviados pela Apple.
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

Isso serve para segmentar as conversões de acordo com o usuário: novo ou recorrente. Essa segmentação é normalmente usada para medir o impacto da meta de aquisição de clientes.
activityAccountId

string (int64 format)

ID da conta da atividade.
activityRating

string (int64 format)

Classificação da atividade.
externalActivityId

string

ID da atividade fornecido pelo anunciante.
adGroup

string

Nome do recurso do grupo de anúncios.
assetGroup

string

Nome do recurso do grupo.
auctionInsightDomain

string

Domínio (URL visível) de um participante no Relatório de informações do leilão.
campaign

string

Nome do recurso da campanha.
conversionAction

string

Nome do recurso da ação de conversão.
conversionActionName

string

Nome da ação de conversão.
conversionAdjustment

boolean

Assim, suas colunas de conversão são segmentadas pela conversão original e pelo valor da conversão, em comparação com o delta se as conversões tiverem sido ajustadas. A linha falsa tem os dados conforme declarado originalmente; enquanto a linha verdadeira tem o delta entre os dados atuais e os originalmente declarados. A soma dos dois resulta nos dados pós-ajuste.
date

string

Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17.
geoTargetAirport

string

Nome do recurso da constante de segmentação por área geográfica que representa um aeroporto.
geoTargetCanton

string

Nome do recurso da constante de segmentação geográfica que representa um cantão.
geoTargetCity

string

Nome do recurso da constante de segmentação por área geográfica que representa uma cidade.
geoTargetCountry

string

Nome do recurso da constante de segmentação por área geográfica que representa um país.
geoTargetCounty

string

Nome do recurso da constante de segmentação geográfica que representa um condado.
geoTargetDistrict

string

Nome do recurso da constante de segmentação geográfica que representa um distrito.
geoTargetMetro

string

Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana.
geoTargetMostSpecificLocation

string

Nome do recurso da constante de segmentação por área geográfica que representa a localização mais específica.
geoTargetPostalCode

string

Nome do recurso da constante de segmentação por área geográfica que representa um código postal.
geoTargetProvince

string

Nome do recurso da constante de segmentação por área geográfica que representa uma província.
geoTargetRegion

string

Nome do recurso da constante de segmentação por área geográfica que representa uma região.
geoTargetState

string

Nome do recurso da constante de segmentação geográfica que representa um estado.
hotelBookingWindowDays

string (int64 format)

Janela de reserva do hotel em dias.
hotelCenterId

string (int64 format)

ID da Central para Hotéis.
hotelCheckInDate

string

Data do check-in no hotel. no formato aaaa-MM-dd.
hotelCity

string

Cidade do hotel.
hotelClass

integer

Classificação do hotel.
hotelCountry

string

País do hotel.
hotelLengthOfStay

integer

Tempo de permanência no hotel.
hotelRateRuleId

string

ID da regra da tarifa do hotel.
hotelState

string

Estado do hotel.
hour

integer

Hora do dia como um número entre 0 e 23.
interactionOnThisExtension

boolean

Usado somente com métricas de itens do feed. Indica se as métricas de interação ocorreram no próprio item do feed ou em uma extensão ou um bloco de anúncios diferente.
month

string

Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd.
partnerHotelId

string

ID do hotel do parceiro.
productAggregatorId

string (int64 format)

ID agregado do produto.
productCategoryLevel1

string

A categoria (nível 1) do produto.
productCategoryLevel2

string

Categoria (nível 2) do produto.
productCategoryLevel3

string

Categoria (nível 3) do produto.
productCategoryLevel4

string

Categoria (nível 4) do produto.
productCategoryLevel5

string

A categoria (nível 5) do produto.
productBrand

string

Marca do produto.
productCountry

string

Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto.
productCustomAttribute0

string

Atributo personalizado 0 do produto.
productCustomAttribute1

string

Atributo personalizado 1 do produto.
productCustomAttribute2

string

Atributo personalizado 2 do produto.
productCustomAttribute3

string

Atributo personalizado 3 do produto.
productCustomAttribute4

string

Atributo personalizado 4 do produto.
productFeedLabel

string

Rótulo do feed do produto.
productItemId

string

ID do item do produto.
productLanguage

string

Nome do recurso da constante de idioma para o idioma do produto.
productMerchantId

string (int64 format)

ID do comerciante do produto.
productStoreId

string

ID da loja do produto.
productTitle

string

Título do produto.
productTypeL1

string

Tipo (nível 1) do produto.
productTypeL2

string

Tipo (nível 2) do produto.
productTypeL3

string

Tipo (nível 3) do produto.
productTypeL4

string

Tipo (nível 4) do produto.
productTypeL5

string

Tipo (nível 5) do produto.
quarter

string

Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. no formato aaaa-MM-dd.
searchSubcategory

string

Uma subcategoria do termo de pesquisa. Uma string vazia indica a subcategoria abrangente para os termos de pesquisa que não se encaixam em outra subcategoria.
searchTerm

string

Um termo de pesquisa.
webpage

string

Nome do recurso do critério do grupo de anúncios que representa o critério da página da Web.
week

string

É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd.
year

integer

Ano, formatado como aaaa.
skAdNetworkConversionValue

string (int64 format)

Valor da conversão da rede de publicidade do kit da loja do iOS. Um valor nulo significa que esse segmento não é aplicável, por exemplo, uma campanha que não seja para iOS.
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

App em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. Um valor nulo significa que o segmento não é aplicável, por exemplo, a uma campanha que não era de iOS, ou que não estava presente em postbacks enviados pela Apple.
skAdNetworkSourceDomain

string

Site em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. Um valor nulo significa que o segmento não é aplicável, por exemplo, a uma campanha que não era de iOS, ou que não estava presente em postbacks enviados pela Apple.
skAdNetworkPostbackSequenceIndex

string (int64 format)

Índice da sequência de postback da rede de anúncios do kit da loja do iOS.
assetInteractionTarget

object (AssetInteractionTarget)

Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios. As interações (por exemplo, cliques) são contabilizadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando são veiculadas juntas. Quando interatividadeOnThisAsset é definido como verdadeiro, isso significa que as interações estão nesse recurso específico. Se o "InteractionOnThisAsset" é falso, isso significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio com que ele é veiculado.

AdDestinationType

Enumera os tipos de destino do Google Ads

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
NOT_APPLICABLE Anúncios que não têm a intenção de afastar os usuários dos anúncios para outros destinos
WEBSITE Site
APP_STORE App Store do iOS ou Play Store
PHONE_CALL Ligar para discador
MAP_DIRECTIONS App de mapas
LOCATION_LISTING Página dedicada à localização
MESSAGE Texto
LEAD_FORM Formulário de geração de leads
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS Destino do anúncio para conversões com chaves desconhecidas

AdNetworkType

Enumera os tipos de rede do Google Ads.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH Pesquisa do Google.
SEARCH_PARTNERS Parceiros de pesquisa.
CONTENT Rede de Display.
MIXED Várias redes.
YOUTUBE YouTube
GOOGLE_TV Google TV

BudgetCampaignAssociationStatus

Um segmentoBudgetCampaignAssociationStatus.

Representação JSON 
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
Campos
status

enum (BudgetCampaignAssociationStatus)

É o status da associação da campanha de orçamento.
campaign

string

O nome do recurso da campanha.

BudgetCampaignAssociationStatus

Possíveis status da associação entre o orçamento e a campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A campanha está usando o orçamento no momento.
REMOVED A campanha não está mais usando o orçamento.

ClickType

Enumera os tipos de clique do Google Ads.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
BREADCRUMBS Navegação estrutural.
BROADBAND_PLAN Plano de banda larga.
CALL_TRACKING Chamadas telefônicas discadas manualmente.
CALLS Chamadas telefônicas.
CLICK_ON_ENGAGEMENT_AD Clique no anúncio de engajamento.
GET_DIRECTIONS Rota de carro.
LOCATION_EXPANSION Mais detalhes do local.
LOCATION_FORMAT_CALL Chamada.
LOCATION_FORMAT_DIRECTIONS Rotas.
LOCATION_FORMAT_IMAGE Imagens.
LOCATION_FORMAT_LANDING_PAGE Acesse a página de destino.
LOCATION_FORMAT_MAP Mapa.
LOCATION_FORMAT_STORE_INFO Acesse as informações da loja.
LOCATION_FORMAT_TEXT Texto.
MOBILE_CALL_TRACKING Chamadas de telefone celular.
OFFER_PRINTS Imprimir oferta.
OTHER Outros
PRODUCT_EXTENSION_CLICKS Oferta da caixa que contém o sinal de adição do produto.
PRODUCT_LISTING_AD_CLICKS Google Shopping – Produto – On-line.
STORE_LOCATOR Mostrar locais próximos.
URL_CLICKS Título.
VIDEO_APP_STORE_CLICKS Loja de aplicativos.
VIDEO_CALL_TO_ACTION_CLICKS Sobreposição de call-to-action.
VIDEO_CARD_ACTION_HEADLINE_CLICKS Cartões.
VIDEO_END_CAP_CLICKS Imagem final.
VIDEO_WEBSITE_CLICKS Site.
WIRELESS_PLAN Plano de rede sem fio.
PRODUCT_LISTING_AD_LOCAL Google Shopping – Produto – Local.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL Google Shopping – Produto – Multicanal local.
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE Google Shopping – Produto – Multicanal on-line.
PRODUCT_LISTING_ADS_COUPON Google Shopping – Produto – Cupom.
PRODUCT_LISTING_AD_TRANSACTABLE Google Shopping – Produto – Vender no Google.
PROMOTION_EXTENSION Extensão de promoção.
HOTEL_PRICE Preço do hotel.
PRICE_EXTENSION Extensão de preço.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Reserva de hotéis no Google: seleção de quartos.
SHOPPING_COMPARISON_LISTING Shopping – Lista de comparação.
CROSS_NETWORK Várias redes. Com as campanhas Performance Max e Discovery.

ConversionAttributionEventType

O tipo de evento ao qual as conversões são atribuídas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa um valor desconhecido nesta versão.
IMPRESSION A conversão é atribuída a uma impressão.
INTERACTION A conversão é atribuída a uma interação.

ConversionLagBucket

Enumeração que representa o número de dias entre a impressão e a conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
LESS_THAN_ONE_DAY Intervalo de tempo de conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não.
ONE_TO_TWO_DAYS Intervalo de tempo de conversão de 1 a 2 dias. 1 dia está incluído, mas 2 dias não.
TWO_TO_THREE_DAYS Intervalo de tempo de conversão de dois a três dias. 2 dias estão incluídos, mas 3 dias não.
THREE_TO_FOUR_DAYS Intervalo de tempo de conversão de 3 a 4 dias. Três dias estão incluídos, mas quatro dias não.
FOUR_TO_FIVE_DAYS Intervalo de tempo de conversão de 4 a 5 dias. 4 dias está incluído, mas 5 dias não.
FIVE_TO_SIX_DAYS Intervalo de tempo de conversão de 5 a 6 dias. 5 dias está incluído, mas 6 dias não.
SIX_TO_SEVEN_DAYS Intervalo de tempo de conversão de 6 a 7 dias. Seis dias estão incluídos, mas sete dias não.
SEVEN_TO_EIGHT_DAYS Intervalo de tempo de conversão de 7 a 8 dias. 7 dias está incluído, mas 8 dias não.
EIGHT_TO_NINE_DAYS Intervalo de tempo de conversão de 8 a 9 dias. 8 dias está incluído, mas 9 dias não.
NINE_TO_TEN_DAYS Intervalo de tempo de conversão de 9 a 10 dias. 9 dias está incluído, mas 10 dias não.
TEN_TO_ELEVEN_DAYS Intervalo de tempo de conversão de 10 a 11 dias. 10 dias está incluído, 11 dias não.
ELEVEN_TO_TWELVE_DAYS Intervalo de tempo de conversão de 11 a 12 dias. 11 dias está incluído, 12 dias não.
TWELVE_TO_THIRTEEN_DAYS Intervalo de tempo de conversão de 12 a 13 dias. 12 dias está incluído, 13 dias não.
THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de conversão de 13 a 14 dias. 13 dias está incluído, 14 dias não.
FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de tempo de conversão de 14 a 21 dias. 14 dias está incluído, 21 dias não.
TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo de conversão de 21 a 30 dias. 21 dias está incluído, 30 dias não.
THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo de conversão de 30 a 45 dias. 30 dias está incluído, 45 dias não.
FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo de conversão de 45 a 60 dias. 45 dias está incluído, mas 60 dias não.
SIXTY_TO_NINETY_DAYS Intervalo de tempo de conversão de 60 a 90 dias. 60 dias está incluído, mas 90 dias não.

ConversionOrAdjustmentLagBucket

Enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes feitos na conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CONVERSION_LESS_THAN_ONE_DAY Intervalo de tempo de conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não.
CONVERSION_ONE_TO_TWO_DAYS Intervalo de tempo de conversão de 1 a 2 dias. 1 dia está incluído, mas 2 dias não.
CONVERSION_TWO_TO_THREE_DAYS Intervalo de tempo de conversão de dois a três dias. 2 dias estão incluídos, mas 3 dias não.
CONVERSION_THREE_TO_FOUR_DAYS Intervalo de tempo de conversão de 3 a 4 dias. Três dias estão incluídos, mas quatro dias não.
CONVERSION_FOUR_TO_FIVE_DAYS Intervalo de tempo de conversão de 4 a 5 dias. 4 dias está incluído, mas 5 dias não.
CONVERSION_FIVE_TO_SIX_DAYS Intervalo de tempo de conversão de 5 a 6 dias. 5 dias está incluído, mas 6 dias não.
CONVERSION_SIX_TO_SEVEN_DAYS Intervalo de tempo de conversão de 6 a 7 dias. Seis dias estão incluídos, mas sete dias não.
CONVERSION_SEVEN_TO_EIGHT_DAYS Intervalo de tempo de conversão de 7 a 8 dias. 7 dias está incluído, mas 8 dias não.
CONVERSION_EIGHT_TO_NINE_DAYS Intervalo de tempo de conversão de 8 a 9 dias. 8 dias está incluído, mas 9 dias não.
CONVERSION_NINE_TO_TEN_DAYS Intervalo de tempo de conversão de 9 a 10 dias. 9 dias está incluído, mas 10 dias não.
CONVERSION_TEN_TO_ELEVEN_DAYS Intervalo de tempo de conversão de 10 a 11 dias. 10 dias está incluído, 11 dias não.
CONVERSION_ELEVEN_TO_TWELVE_DAYS Intervalo de tempo de conversão de 11 a 12 dias. 11 dias está incluído, 12 dias não.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS Intervalo de tempo de conversão de 12 a 13 dias. 12 dias está incluído, 13 dias não.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de conversão de 13 a 14 dias. 13 dias está incluído, 14 dias não.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de tempo de conversão de 14 a 21 dias. 14 dias está incluído, 21 dias não.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo de conversão de 21 a 30 dias. 21 dias está incluído, 30 dias não.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo de conversão de 30 a 45 dias. 30 dias está incluído, 45 dias não.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo de conversão de 45 a 60 dias. 45 dias está incluído, mas 60 dias não.
CONVERSION_SIXTY_TO_NINETY_DAYS Intervalo de tempo de conversão de 60 a 90 dias. 60 dias está incluído, mas 90 dias não.
ADJUSTMENT_LESS_THAN_ONE_DAY Intervalo de tempo de ajuste da conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não.
ADJUSTMENT_ONE_TO_TWO_DAYS Intervalo de tempo de ajuste da conversão de um a dois dias. 1 dia está incluído, mas 2 dias não.
ADJUSTMENT_TWO_TO_THREE_DAYS Intervalo de tempo de ajuste da conversão de dois a três dias. 2 dias estão incluídos, mas 3 dias não.
ADJUSTMENT_THREE_TO_FOUR_DAYS Intervalo de tempo de ajuste da conversão de três a quatro dias. Três dias estão incluídos, mas quatro dias não.
ADJUSTMENT_FOUR_TO_FIVE_DAYS Intervalo de tempo de ajuste da conversão de 4 a 5 dias. 4 dias está incluído, mas 5 dias não.
ADJUSTMENT_FIVE_TO_SIX_DAYS Intervalo de tempo de ajuste de conversão de 5 a 6 dias. 5 dias está incluído, mas 6 dias não.
ADJUSTMENT_SIX_TO_SEVEN_DAYS Intervalo de tempo de ajuste de conversão de 6 a 7 dias. Seis dias estão incluídos, mas sete dias não.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS Intervalo de tempo de ajuste da conversão de 7 a 8 dias. 7 dias está incluído, mas 8 dias não.
ADJUSTMENT_EIGHT_TO_NINE_DAYS Intervalo de tempo de ajuste da conversão de 8 a 9 dias. 8 dias está incluído, mas 9 dias não.
ADJUSTMENT_NINE_TO_TEN_DAYS Intervalo de tempo de ajuste da conversão de 9 a 10 dias. 9 dias está incluído, mas 10 dias não.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS Intervalo de tempo de ajuste de conversão de 10 a 11 dias. 10 dias está incluído, 11 dias não.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS Intervalo de tempo de ajuste da conversão de 11 a 12 dias. 11 dias está incluído, 12 dias não.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS Intervalo de tempo de ajuste de conversão de 12 a 13 dias. 12 dias está incluído, 13 dias não.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de ajuste de conversão de 13 a 14 dias. 13 dias está incluído, 14 dias não.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de tempo de ajuste de conversão de 14 a 21 dias. 14 dias está incluído, 21 dias não.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo de ajuste de conversão de 21 a 30 dias. 21 dias está incluído, 30 dias não.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo de ajuste de conversão de 30 a 45 dias. 30 dias está incluído, 45 dias não.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo de ajuste de conversão de 45 a 60 dias. 45 dias está incluído, mas 60 dias não.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS Intervalo de tempo de ajuste de conversão de 60 a 90 dias. 60 dias está incluído, mas 90 dias não.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS Intervalo de tempo de ajuste da conversão de 90 a 145 dias. 90 dias está incluído, 145 dias não.
CONVERSION_UNKNOWN Intervalo de tempo de conversão DESCONHECIDO. Refere-se a datas antes da disponibilização do intervalo de tempo de conversão no Google Ads.
ADJUSTMENT_UNKNOWN Intervalo de tempo de ajuste de conversão DESCONHECIDO. Esse valor é referente a datas antes da disponibilização do intervalo de tempo de ajuste de conversão no Google Ads.

ExternalConversionSource

A origem externa da conversão associada a uma ConversionAction.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa um valor desconhecido nesta versão.
WEBPAGE Conversão que ocorre quando um usuário navega até uma página da Web específica depois de visualizar um anúncio. Exibida na IU do Google Ads como "Site".
ANALYTICS Conversão originada de uma meta ou transação vinculada do Google Analytics. Exibido na IU do Google Ads como "Analytics".
UPLOAD Conversão do site que é enviada por meio do ConversionUploadService; exibida na interface do Google Ads como "Importar de cliques".
AD_CALL_METRICS Conversão que ocorre quando um usuário clica em uma extensão de chamada diretamente em um anúncio. Exibida na interface do Google Ads como "Chamadas a partir de anúncios".
WEBSITE_CALL_METRICS Conversão que ocorre quando um usuário liga para um número de telefone gerado dinamicamente (pelo JavaScript instalado) no site de um anunciante depois de clicar em um anúncio. Exibida na interface do Google Ads como "Chamadas do site".
STORE_VISITS Conversão que ocorre quando um usuário visita a loja de um anunciante após clicar em um anúncio do Google. Exibida na interface do Google Ads como "Visitas à loja".
ANDROID_IN_APP Conversão que ocorre quando um usuário realiza uma ação no app, como uma compra em um app Android. Exibida na IU do Google Ads como "Ação no app Android".
IOS_IN_APP Conversão que ocorre quando um usuário realiza uma ação no app, como uma compra em um app iOS. Exibida na IU do Google Ads como "Ação no app iOS".
IOS_FIRST_OPEN Conversão que ocorre quando um usuário abre um app iOS pela primeira vez. Exibida na interface do Google Ads como "Instalação de app iOS (primeiro acesso)".
APP_UNSPECIFIED Conversões de app legadas que não têm uma AppPlatform. Exibidas na interface do Google Ads como "App para dispositivos móveis".
ANDROID_FIRST_OPEN Conversão que ocorre quando um usuário abre um aplicativo Android pela primeira vez. Exibida na IU do Google Ads como "Instalação de aplicativo Android (primeiro acesso)".
UPLOAD_CALLS Conversão de chamada que é enviada por meio do ConversionUploadService; exibida na interface do Google Ads como "Importar de chamadas".
FIREBASE Conversão de um evento vinculado do Firebase. Exibido na IU do Google Ads como "Firebase".
CLICK_TO_CALL Conversão que ocorre quando um usuário clica em um número de celular. Exibida na interface do Google Ads como "Cliques no número de telefone".
SALESFORCE Conversão do Salesforce exibida na IU do Google Ads como "Salesforce.com".
STORE_SALES_CRM Conversão de compras na loja registradas pelo CRM. Exibida na interface do Google Ads como "Vendas na loja (parceiro de dados)".
STORE_SALES_PAYMENT_NETWORK Conversão proveniente de compras na loja da rede de pagamentos. Exibida na interface do Google Ads como "Vendas na loja (rede de pagamentos)".
GOOGLE_PLAY Conversão sem código do Google Play, exibida na interface do Google Ads como "Google Play".
THIRD_PARTY_APP_ANALYTICS Conversão proveniente de um evento vinculado de análise de aplicativos de terceiros. Exibida na interface do Google Ads como "Análise de aplicativos de terceiros".
GOOGLE_ATTRIBUTION Conversão controlada pelo Google Attribution.
STORE_SALES_DIRECT_UPLOAD Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros. Exibida na interface do Google Ads como "Vendas na loja (upload direto)".
STORE_SALES Conversão de vendas na loja com base nos uploads de dados próprios ou de terceiros e/ou de compras na loja usando cartões de redes de pagamentos. Aparece na interface do Google Ads como "Vendas na loja".
SEARCH_ADS_360 Conversões importadas dos dados do Floodlight no Search Ads 360.
GOOGLE_HOSTED Conversões que acompanham ações locais de produtos e serviços do Google depois de interagir com um anúncio.
FLOODLIGHT Conversões informadas pelas tags do Floodlight.
ANALYTICS_SEARCH_ADS_360 Conversões que vêm do Google Analytics especificamente para o Search Ads 360. Exibido na IU do Google Ads como Google Analytics (SA360).
FIREBASE_SEARCH_ADS_360 Conversão de um evento vinculado do Firebase para o Search Ads 360.
DISPLAY_AND_VIDEO_360_FLOODLIGHT A conversão é informada pelo Floodlight para o DV360.

HotelRateType

Enumeração que descreve os possíveis tipos de tarifa de hotel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE As informações sobre o tipo de tarifa não estão disponíveis.
PUBLIC_RATE Tarifas disponíveis para todos.
QUALIFIED_RATE Uma tarifa do programa de assinatura está disponível e atende aos requisitos básicos, como ter uma tarifa pública disponível. O tratamento de IU tacará a taxa pública e indicará que um desconto está disponível para o usuário. Para mais informações sobre as tarifas qualificadas, acesse https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates.
PRIVATE_RATE Tarifas disponíveis para usuários que atendem a alguns critérios de qualificação (por exemplo, todos os usuários que fizeram login, 20% dos usuários de dispositivos móveis, todos os usuários de dispositivos móveis no Canadá etc.).

HotelPriceBucket

Enumeração que descreve possíveis faixas de preço do hotel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
LOWEST_UNIQUE O menor preço. O parceiro tem o menor preço, e nenhum outro parceiro tem uma pequena variação desse preço.
LOWEST_TIED Tem o menor preço possível. O parceiro está dentro de uma pequena variação em relação ao preço mais baixo.
NOT_LOWEST Não é o menor preço. O parceiro não tem uma variação pequena em relação ao preço mais baixo.
ONLY_PARTNER_SHOWN O parceiro foi o único mostrado.

Palavra-chave

Um segmento de critério de palavra-chave.

Representação JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Campos
info

object (KeywordInfo)

Informações da palavra-chave
adGroupCriterion

string

O nome do recurso name.

SearchEngineResultsPageType

O tipo de página de resultados do mecanismo de pesquisa.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ADS_ONLY Apenas anúncios estavam contidos na página de resultados do mecanismo de pesquisa.
ORGANIC_ONLY Somente resultados orgânicos estavam na página de resultados do mecanismo de pesquisa.
ADS_AND_ORGANIC Os anúncios e os resultados orgânicos ficavam na página de resultados do mecanismo de pesquisa.

SearchTermMatchType

Possíveis tipos de correspondência de uma palavra-chave que aciona um anúncio, incluindo variantes

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BROAD Correspondência ampla.
EXACT Correspondência exata.
PHRASE Correspondência de frase.
NEAR_EXACT Correspondência exata (variação aproximada).
NEAR_PHRASE Correspondência de frase (variação aproximada).

Slot

Enumera as possíveis posições do anúncio.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH_SIDE Pesquisa do Google: Parte lateral.
SEARCH_TOP Pesquisa do Google: Parte superior.
SEARCH_OTHER Pesquisa do Google: Outro
CONTENT Rede de Display do Google.
SEARCH_PARTNER_TOP Parceiros de pesquisa: parte superior.
SEARCH_PARTNER_OTHER Parceiros de pesquisa: outro.
MIXED Várias redes.

ConversionValueRulePrimaryDimension

Identifica a dimensão principal das estatísticas de regras de valor da conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
NO_RULE_APPLIED Para conversões sem regra de valor aplicada após a ativação da regra de valor.
ORIGINAL Consulte abaixo as conversões aplicadas pela regra de valor: as estatísticas originais.
NEW_VS_RETURNING_USER Quando uma condição de cliente novo ou recorrente é satisfeita.
GEO_LOCATION Quando uma condição de localização geográfica no tempo de consulta é atendida.
DEVICE Quando uma condição do dispositivo de navegação durante a consulta é atendida.
AUDIENCE Quando uma condição de público-alvo no momento da consulta é atendida.
MULTIPLE Quando várias regras são aplicadas.

SkAdNetworkUserType

Enumera os tipos de usuário da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
NEW_INSTALLER O usuário instalou o app pela primeira vez.
REINSTALLER O usuário já instalou o app.

SkAdNetworkAdEventType

Enumera os tipos de evento de anúncio da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
INTERACTION O usuário interagiu com o anúncio.
VIEW O usuário visualizou o anúncio.

SkAdNetworkSourceApp

Um segmento SkAdNetworkSourceApp.

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

string

ID do app em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado.

SkAdNetworkAttributionCredit

Enumera os créditos de atribuição da SkAdNetwork.

Enums
UNSPECIFIED Valor padrão. Esse valor é equivalente a nulo.
UNKNOWN O valor é desconhecido nesta versão da API. O valor verdadeiro de enumeração não pode ser retornado nesta versão da API ou ainda não é compatível.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
WON O Google foi a rede de publicidade que ganhou a atribuição de anúncios.
CONTRIBUTED O Google se qualificou para a atribuição, mas não venceu.

SkAdNetworkCoarseConversionValue

Enumera os valores de conversão aproximados da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
LOW Um valor de conversão aproximado baixo.
MEDIUM Um valor de conversão médio aproximado.
HIGH Um alto valor aproximado de conversão.
NONE Um valor de conversão aproximado não foi configurado.

SkAdNetworkSourceType

Enumera os tipos de origem da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE O ID do app ou o domínio de origem não estava presente no postback ou não temos esses dados por outros motivos.
WEBSITE O anúncio foi exibido em uma página da Web.
MOBILE_APPLICATION O anúncio foi exibido em um app.

AssetInteractionTarget

Um segmento AssetInteractionTarget.

Representação JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Campos
asset

string

O nome do recurso do recurso.
interactionOnThisAsset

boolean

Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.

ConvertingUserPriorEngagementTypeAndLtvBucket

Enumera os tipos de engajamento anteriores do usuário com conversão e o intervalo de valor da vida útil

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
NEW O usuário que realiza conversões é novo no anunciante.
RETURNING O usuário que realiza conversões está retornando ao anunciante. A definição de retorno difere entre os tipos de conversão, como uma segunda visita à loja em comparação com uma segunda compra on-line.
NEW_AND_HIGH_LTV O usuário que realiza conversões é novo para o anunciante e tem um alto valor da vida útil.