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)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "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 referenciada na consulta.

adGroup

object (AdGroup)

O grupo de anúncios referenciado na consulta.

adGroupAd

object (AdGroupAd)

O anúncio referenciado na consulta.

adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

A visualização da combinação de recursos de anúncios do grupo de anúncios na consulta.

adGroupAdAssetView

object (AdGroupAdAssetView)

A visualização do recurso de anúncio do grupo de anúncios na consulta.

adGroupAdLabel

object (AdGroupAdLabel)

O rótulo do anúncio do grupo de anúncios referenciado 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 referenciada na consulta.

adGroupBidModifier

object (AdGroupBidModifier)

O modificador de lances referenciado na consulta.

adGroupCriterion

object (AdGroupCriterion)

O critério referenciado 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)

A simulação do critério do grupo de anúncios referenciada na consulta.

adGroupCustomizer

object (AdGroupCustomizer)

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

adGroupExtensionSetting

object (AdGroupExtensionSetting)

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

adGroupFeed

object (AdGroupFeed)

O feed do grupo de anúncios referenciado na consulta.

adGroupLabel

object (AdGroupLabel)

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

adGroupSimulation

object (AdGroupSimulation)

A simulação do grupo de anúncios referenciada 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 referenciada 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 referenciada na consulta.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

A visualização da combinação principal do grupo de recursos referenciada 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)

O job em lote referenciado na consulta.

biddingDataExclusion

object (BiddingDataExclusion)

A exclusão de dados de lances referenciada na consulta.

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

O ajuste periódico de lances referenciado na consulta.

biddingStrategy

object (BiddingStrategy)

A estratégia de lances referenciada na consulta.

biddingStrategySimulation

object (BiddingStrategySimulation)

A simulação da estratégia de lances referenciada na consulta.

billingSetup

object (BillingSetup)

A configuração de faturamento referenciada na consulta.

callView

object (CallView)

A visualização da chamada referenciada na consulta.

campaignBudget

object (CampaignBudget)

O orçamento da campanha indicado na consulta.

campaign

object (Campaign)

A campanha referenciada na consulta.

campaignAsset

object (CampaignAsset)

O recurso da campanha referenciado na consulta.

campaignAssetSet

object (CampaignAssetSet)

O grupo de recursos da campanha referenciado na consulta.

campaignAudienceView

object (CampaignAudienceView)

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

campaignBidModifier

object (CampaignBidModifier)

O modificador de lance da campanha referenciado na consulta.

campaignConversionGoal

object (CampaignConversionGoal)

O CampaignConversionGoal referenciado na consulta.

campaignCriterion

object (CampaignCriterion)

O critério da campanha referenciado na consulta.

campaignCustomizer

object (CampaignCustomizer)

O personalizador de campanhas mencionado na consulta.

campaignDraft

object (CampaignDraft)

O rascunho da campanha referenciado na consulta.

campaignExtensionSetting

object (CampaignExtensionSetting)

A configuração da extensão da campanha referenciada na consulta.

campaignFeed

object (CampaignFeed)

O feed de campanha referenciado na consulta.

campaignGroup

object (CampaignGroup)

Grupo de campanhas referenciado na consulta AWQL.

campaignLabel

object (CampaignLabel)

O rótulo da campanha referenciado na consulta.

campaignLifecycleGoal

object (CampaignLifecycleGoal)

A meta do ciclo de vida da campanha referenciada na consulta.

campaignSearchTermInsight

object (CampaignSearchTermInsight)

O insight sobre o termo de pesquisa da campanha referenciado na consulta.

campaignSharedSet

object (CampaignSharedSet)

Conjunto compartilhado de campanhas referenciado na consulta AWQL.

campaignSimulation

object (CampaignSimulation)

A simulação de campanha referenciada na consulta.

carrierConstant

object (CarrierConstant)

A constante da operadora referenciada na consulta.

changeEvent

object (ChangeEvent)

O ChangeEvent referenciado na consulta.

changeStatus

object (ChangeStatus)

O ChangeStatus referenciado na consulta.

combinedAudience

object (CombinedAudience)

O combineAudience mencionado na consulta.

audience

object (Audience)

O público-alvo referenciado na consulta.

conversionAction

object (ConversionAction)

A ação de conversão referenciada na consulta.

conversionCustomVariable

object (ConversionCustomVariable)

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

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

A ConversionGoalCampaignConfig referenciada na consulta.

conversionValueRule

object (ConversionValueRule)

A regra de valor da conversão referenciada na consulta.

conversionValueRuleSet

object (ConversionValueRuleSet)

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

clickView

object (ClickView)

O ClickView referenciado na consulta.

currencyConstant

object (CurrencyConstant)

A constante de moeda referenciada na consulta.

customAudience

object (CustomAudience)

A CustomAudience referenciada na consulta.

customConversionGoal

object (CustomConversionGoal)

O CustomConversionGoal referenciado na consulta.

customInterest

object (CustomInterest)

O Custominterest referenciados na consulta.

customer

object (Customer)

O cliente referenciado na consulta.

customerAsset

object (CustomerAsset)

O recurso do cliente referenciado na consulta.

customerAssetSet

object (CustomerAssetSet)

O conjunto de recursos do cliente referenciado na consulta.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

A estratégia de lances acessível referenciada 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 referenciado na consulta.

customerExtensionSetting

object (CustomerExtensionSetting)

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

customerFeed

object (CustomerFeed)

O feed de cliente referenciado na consulta.

customerLabel

object (CustomerLabel)

O rótulo do cliente referenciado na consulta.

customerLifecycleGoal

object (CustomerLifecycleGoal)

A meta do ciclo de vida do cliente referenciada na consulta.

customerNegativeCriterion

object (CustomerNegativeCriterion)

O critério negativo do cliente referenciado na consulta.

customerSearchTermInsight

object (CustomerSearchTermInsight)

O insight do termo de pesquisa do cliente referenciado na consulta.

customerUserAccess

object (CustomerUserAccess)

O CustomerUserAccess referenciado na consulta.

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

O CustomerUserAccessInvitation referenciado na consulta.

customizerAttribute

object (CustomizerAttribute)

O atributo do personalizador referenciado na consulta.

detailPlacementView

object (DetailPlacementView)

A visualização de posicionamento de detalhes referenciada na consulta.

detailedDemographic

object (DetailedDemographic)

É o grupo demográfico detalhado mencionado na consulta.

displayKeywordView

object (DisplayKeywordView)

A visualização da palavra-chave de exibição referenciada na consulta.

distanceView

object (DistanceView)

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

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

A visualização de termos de pesquisa dos anúncios dinâmicos de pesquisa referenciada na consulta.

expandedLandingPageView

object (ExpandedLandingPageView)

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

extensionFeedItem

object (ExtensionFeedItem)

O item de feed de extensão referenciado na consulta.

feed

object (Feed)

O feed referenciado na consulta.

feedItem

object (FeedItem)

O item do feed referenciado na consulta.

feedItemSet

object (FeedItemSet)

O conjunto de itens do feed referenciado na consulta.

feedItemTarget

object (FeedItemTarget)

O destino do item de feed referenciado na consulta.

feedMapping

object (FeedMapping)

O mapeamento do feed referenciado na consulta.

feedPlaceholderView

object (FeedPlaceholderView)

A visualização do marcador do feed referenciada na consulta.

genderView

object (GenderView)

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

geoTargetConstant

object (GeoTargetConstant)

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

geographicView

object (GeographicView)

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

groupPlacementView

object (GroupPlacementView)

A visualização da veiculação em grupo referenciada na consulta.

hotelGroupView

object (HotelGroupView)

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

hotelPerformanceView

object (HotelPerformanceView)

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

hotelReconciliation

object (HotelReconciliation)

A reconciliação de hotel referenciada na consulta.

incomeRangeView

object (IncomeRangeView)

A visualização do intervalo de renda referenciada na consulta.

keywordView

object (KeywordView)

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

keywordPlan

object (KeywordPlan)

O plano de palavras-chave referenciado na consulta.

keywordPlanCampaign

object (KeywordPlanCampaign)

A campanha do plano de palavras-chave referenciada 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 referenciado na consulta.

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

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

keywordThemeConstant

object (KeywordThemeConstant)

A constante do 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 referenciada 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 de posição gerenciada referenciada na consulta.

mediaFile

object (MediaFile)

O arquivo de mídia referenciado na consulta.

localServicesEmployee

object (LocalServicesEmployee)

O funcionário de serviços locais referenciado na consulta.

localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

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

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

A constante de categoria de aplicativo para dispositivos móveis referenciada na consulta.

mobileDeviceConstant

object (MobileDeviceConstant)

A constante de dispositivo móvel referenciada na consulta.

offlineConversionUploadClientSummary

object (OfflineConversionUploadClientSummary)

Resumo do upload de conversões off-line no nível do cliente.

offlineUserDataJob

object (OfflineUserDataJob)

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

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

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

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

A visualização do termo de pesquisa orgânica paga referenciada na consulta.

qualifyingQuestion

object (QualifyingQuestion)

A pergunta de qualificação referenciada na consulta.

parentalStatusView

object (ParentalStatusView)

A visualização de status parental referenciada na consulta.

perStoreView

object (PerStoreView)

A visualização por loja referenciada na consulta.

productCategoryConstant

object (ProductCategoryConstant)

A categoria do produto referenciada na consulta.

productGroupView

object (ProductGroupView)

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

recommendation

object (Recommendation)

A recomendação referenciada na consulta.

recommendationSubscription

object (RecommendationSubscription)

A assinatura de recomendação referenciada na consulta.

searchTermView

object (SearchTermView)

A visualização do termo de pesquisa referenciada 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 referenciada 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 referenciada 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 referenciado na consulta.

experimentArm

object (ExperimentArm)

O grupo experimental referenciado na consulta.

userInterest

object (UserInterest)

O interesse do usuário mencionado 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 de 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)

O vídeo mencionado na consulta.

webpageView

object (WebpageView)

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

leadFormSubmissionData

object (LeadFormSubmissionData)

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

localServicesLead

object (LocalServicesLead)

O lead de Serviços Locais referenciado na consulta.

localServicesLeadConversation

object (LocalServicesLeadConversation)

A conversa do lead de serviços locais referenciada na consulta.

androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

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

androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

A campanha do Google com chave compartilhada de privacidade do Android referenciada na consulta.

androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

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

metrics

object (Metrics)

As métricas.

segments

object (Segments)

Os segmentos.

AccountBudget

Um orçamento no nível da conta. Ele contém informações sobre o orçamento em si, bem como as alterações nele aprovadas mais recentemente e as alterações propostas que estão com aprovação pendente. As mudanças propostas que estão pendentes de aprovação, se houver, estão em "proposta pendente". Os detalhes efetivos sobre o orçamento estão nos campos com prefixo "approved_", "adjusted_" e 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 nos campos "proposed_", "approved_" e possivelmente "adjusted_".

Esse recurso é modificado usando AccountBudgetProposal e não pode ser modificado diretamente. Um orçamento pode ter no máximo uma proposta pendente. Ele é lido a pendingProposal.

Depois de aprovado, um orçamento pode estar sujeito a ajustes, como ajustes de crédito. 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 no nível da conta. Os nomes dos recursos de AccountBudget têm o seguinte formato:

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum (AccountBudgetStatus)

Apenas saída. O status do orçamento no nível da 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 custos de superfornecimento. Nesse caso, um crédito pode 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 no nível da conta.

billingSetup

string

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

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

Apenas saída. O nome do orçamento no nível da conta.

proposedStartDateTime

string

Apenas saída. A hora de início proposta do orçamento no nível da conta no formato AAAA-MM-DD HH:mm:ss. Se um tipo de horário de início de AGORA 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 horário da aprovação.

purchaseOrderNumber

string

Apenas saída. O número da ordem de compra é um valor que ajuda os usuários a fazer referência a 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 do orçamento da 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 no nível da 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 de 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, FOREVER.

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

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 é aprovada, o limite de gastos aprovado 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. Ele só será preenchido se o limite de gastos proposto for finito e sempre será maior ou igual ao limite proposto.

approvedSpendingLimitType

enum (SpendingLimitType)

Apenas saída. O limite de gastos aprovado como um tipo bem definido, por exemplo, INFINITE. Isso 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 ajustado poderá variar dependendo dos tipos de ajustes aplicados a esse 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 o valor que a conta pode gastar.

adjustedSpendingLimitType

enum (SpendingLimitType)

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

AccountBudgetStatus

Os status possíveis de um AccountBudget.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
PENDING O orçamento da conta está pendente de aprovação.
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 da 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 de proposta, por exemplo, "END" 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 ser atribuído 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. Um número de ordem de compra é um valor que ajuda os usuários a indicar esse orçamento nas faturas mensais.

notes

string

Apenas saída. Anotaçõ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. no formato aaaa-MM-dd HH:mm:ss.

Campo de união end_time. O horário de término do orçamento no nível da conta. end_time pode ser apenas de um dos tipos a seguir:
endDateTime

string

Apenas saída. O horário 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 visão do uso da combinação de recursos de anúncio do grupo de anúncios. Agora, só oferecemos suporte a AdGroupAdAssetCombinationView para anúncios responsivos de pesquisa, com 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 da combinação de recursos de anúncios do grupo de anúncios. O ID da combinação tem 128 bits, em que os 64 bits superiores são armazenados em asset_comparison_id_high e os 64 bits mais baixos são armazenados em asset_comparison_id_low. Os nomes dos recursos da 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 "false", significa que o link já existiu, mas foi removido e não está mais presente na versão mais recente do anúncio.

Uso de recursos

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 GroupAd e um recurso. No momento, só é possível usar "Grupo de anúnciosAdAssetView" 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úncio do grupo de anúncios têm o 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 da 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. Papel que o recurso assume no anúncio.

policySummary

object (AdGroupAdAssetPolicySummary)

Apenas saída. Informações da política do 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 do 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 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 está vinculado à versão mais recente do anúncio. Se "false", significa que o link já existiu, mas foi removido e não está mais presente na versão mais recente do anúncio.

AdGroupAdAssetPolicySummary

Contém informações sobre a política de 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 de aprovação geral desse recurso de anúncio do grupo de anúncios, calculado com base no status das entradas de tópicos de política individuais.

AdGroupAudienceView

Uma visualização do público-alvo do grupo de anúncios. Inclui dados de performance de interesses e listas de remarketing para anúncios da Rede de Display e da Rede de Display do YouTube, além de listas de remarketing para anúncios 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 de público-alvo do grupo de anúncios. Os nomes dos recursos de visualização do 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 do 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 da simulação estão detalhadas abaixo, respectivamente. Operações de simulação do ViewModel de hotel começando na V5.

  1. DISPLAY - KEYWORD - CPC_BID - UNIFORM
  2. SEARCH - KEYWORD - 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 do 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 de 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 é baseada, 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 uma meta de CPA.
BID_MODIFIER A simulação é para um modificador de lances.
TARGET_ROAS A simulação é para uma meta de ROAS.
PERCENT_CPC_BID A simulação é para um lance de porcentagem 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 a todos os filhos de um determinado recurso de maneira uniforme. As substituições em recursos filhos não foram respeitadas.
DEFAULT Os valores de uma simulação foram aplicados ao recurso especificado. As substituições em 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 TargetCpa simulada, o valor desejado da campanha e todos os valores desejados do grupo de anúncios foram dimensionados por um fator X.

CpcBidSimulationPointList

Um contêiner de 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

Métricas projetadas 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 necessário projetado que o anunciante precisa definir para receber o tráfego estimado, em micros na moeda do anunciante.

biddableConversions

number

Número projetado de conversões que podem receber lances.

biddableConversionsValue

number

Valor total projetado das conversões que podem receber lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número previsto de impressões.

topSlotImpressions

string (int64 format)

Número projetado de impressões de espaço superior. Somente o tipo de canal de publicidade de pesquisa é compatível com esse campo.

Campo de união cpc_simulation_key_value. Quando SimulationModificationMethod = UNIFORM ou DEFAULT, cpc_bid_micros é definido. Quando SimulationModificationMethod = 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 em que as métricas projetadas são baseadas.

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 de 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 de lances de CPC em percentual.

PercentCpcBidSimulationPoint

Métricas projetadas para um valor específico de CPC percentual. Somente o tipo de canal de publicidade de hotel é compatível com esse campo.

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

string (int64 format)

A porcentagem simulada do CPC no qual as métricas projetadas se baseiam. CPC percentual expresso como fração do preço anunciado de um produto ou serviço. O valor armazenado aqui é 1.000.000 * [fração].

biddableConversions

number

Número projetado de conversões que podem ser usadas em lances.

biddableConversionsValue

number

Valor total projetado das conversões com 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 previsto de impressões.

topSlotImpressions

string (int64 format)

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

AdGroupSimulation

Uma simulação de grupo de anúncios. Confira abaixo os detalhes das combinações compatíveis de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação.

  1. SEARCH - CPC_BID - DEFAULT
  2. SEARCH - CPC_BID - UNIFORM
  3. PESQUISA - TARGET_CPA - UNIFORM
  4. SEARCH - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_BID - DEFAULT
  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 de grupos 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 de base da simulação, 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 de 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

Métricas projetadas para um valor de lance de CPV específico.

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 são baseadas.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número previsto 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

Métricas projetadas 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 necessário projetado que o anunciante precisa definir para receber o tráfego estimado, em micros na moeda do anunciante.

appInstalls

number

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

inAppActions

number

Número projetado de ações no app.

biddableConversions

number

Número projetado de conversões que podem receber lances.

biddableConversionsValue

number

Valor total projetado das conversões que podem receber lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número previsto de impressões.

topSlotImpressions

string (int64 format)

Número projetado de impressões de espaço superior. Somente o tipo de canal de publicidade de pesquisa é compatível com esse campo.

interactions

string (int64 format)

Número previsto 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 SimulationValidationMethod = UNIFORM ou DEFAULT, target_cpa_micros é definido. Quando SimulationModificationMethod = SCALING, target_cpa_scaling_modifier é definido. target_cpa_simulation_key_value pode ser apenas de um dos tipos a seguir:
targetCpaMicros

string (int64 format)

É a simulação de CPA desejado com base nas métricas projetadas.

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 para 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 necessário projetado que o anunciante precisa definir para receber o tráfego estimado, em micros na moeda do anunciante.

targetRoas

number

É o ROAS desejado simulado com base nas métricas projetadas.

biddableConversions

number

Número projetado de conversões que podem receber lances.

biddableConversionsValue

number

Valor total projetado das conversões que podem receber lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número previsto de impressões.

topSlotImpressions

string (int64 format)

Número projetado de impressões de espaço superior. Somente o tipo de canal de publicidade de pesquisa é compatível com esse campo.

AgeRangeView

Uma visualização de faixa etária.

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

string

Apenas saída. O nome do recurso da visualização de 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 de programação de anúncios resume a performance das campanhas por critérios de programação de anúncios.

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

string

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

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

DomainCategory

Uma categoria gerada automaticamente ao rastrear um domínio. Se uma campanha usar a configuração "DynamicSearchAdsSetting", as categorias de domínio serão geradas para o domínio. As categorias podem ser segmentadas usando WebpageConditionInfo. Consulte: 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 de 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 de pesquisa. Esse é o idioma das páginas do seu site que você quer que o Google Ads encontre, crie e faça a correspondência das pesquisas.

domain

string

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

coverageFraction

number

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

categoryRank

string (int64 format)

Apenas saída. A posição dessa 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 esta categoria tem subcategorias.

recommendedCpcBidMicros

string (int64 format)

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

AssetFieldTypeView

Uma visualização do tipo de campo do recurso. Essa visualização informa as métricas não contabilizadas 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 do tipo de campo do recurso. Os nomes dos recursos de visualização do tipo de campo de recursos têm o seguinte formato:

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum (AssetFieldType)

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

AssetGroupProductGroupView

Uma visualização do 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 da visualização do grupo de produtos têm o seguinte formato:

customers/{customerId}/assetGroupProductGroupViews/{assetGroupId}~{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 do uso da combinação de recursos do 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 da combinação principal do grupo de recursos. Os nomes dos recursos de visualização de combinação de grupos de ativos têm o formato: "customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Apenas saída. As principais combinações de recursos veiculados juntos.

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 do tipo de grupo de recursos. Essa visualização informa as métricas não contabilizadas 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 pai.

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

string

Apenas saída. O nome do recurso da visualização do tipo de 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 grupo de recursos da visualização do tipo de grupo de recursos.

BiddingStrategySimulation

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

  1. TARGET_CPA – UNIFORM
  2. TARGET_ROAS - UNIFORME
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 de base da simulação, 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 chamada que inclui dados de 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 de 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 da pessoa que fez a chamada.

callerAreaCode

string

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

callDurationSeconds

string (int64 format)

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

startCallDateTime

string

Apenas saída. A data e a hora de início da chamada fornecidas pelo anunciante.

endCallDateTime

string

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

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

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

type

enum (CallType)

Apenas saída. O tipo de chamada.

callStatus

enum (GoogleVoiceCallStatus)

Apenas saída. O status da chamada.

CallTrackingDisplayLocation

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AD A chamada feita a partir do anúncio.
LANDING_PAGE A chamada feita a partir do anúncio da página de destino aponta para.

CallType

Possíveis tipos de propriedade de onde a chamada foi feita.

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

GoogleVoiceCallStatus

Possíveis status de uma ligação do Google.

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

CampaignAudienceView

Uma visualização do público-alvo da campanha. Inclui dados de desempenho de interesses e listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados por critério de público-alvo e campanha. Essa visualização inclui apenas os 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 de 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 de termo de pesquisa no nível da campanha. Os nomes dos recursos de insight de termo 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 denota a categoria genérica 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. Confira abaixo os detalhes das combinações compatíveis de tipo de canal de publicidade, tipo de simulação e método de modificação de simulação.

  • SEARCH - CPC_BID - UNIFORM
  • SEARCH - CPC_BID - SCALING
  • SEARCH - TARGET_CPA - UNIFORM
  • PESQUISA - TARGET_CPA - SCALING
  • SEARCH - TARGET_ROAS - UNIFORM
  • SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM
  • SEARCH - BUDGET - UNIFORM
  • 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 de base da simulação, 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 ORÇAMENTO.

TargetImpressionShareSimulationPointList

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

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

object (TargetImpressionShareSimulationPoint)

Métricas projetadas para um valor específico da parcela de impressões desejada.

TargetImpressionShareSimulationPoint

Métricas projetadas para um valor específico de 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. Esse valor é validado e não vai exceder 1 milhão (100%).

requiredCpcBidCeilingMicros

string (int64 format)

Limite de lance de CPC diário necessário projetado que o anunciante precisa definir para realizar essa simulação, em micros da moeda do anunciante.

requiredBudgetAmountMicros

string (int64 format)

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

biddableConversions

number

Número projetado de conversões que podem receber lances.

biddableConversionsValue

number

Valor total projetado das conversões que podem receber lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número previsto de impressões.

topSlotImpressions

string (int64 format)

Número previsto de impressões do slot principal. Somente o tipo de canal de publicidade de pesquisa é compatível com esse campo.

absoluteTopImpressions

string (int64 format)

Número projetado de impressões na primeira posição. Somente o tipo de canal de publicidade de pesquisa é compatível com esse campo.

BudgetSimulationPointList

Um contêiner para 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)

Limite de lance de CPC diário necessário projetado que o anunciante precisa definir para realizar essa simulação, em micros da moeda do anunciante. Somente as campanhas com a estratégia de lances de gasto desejado são compatíveis com esse campo.

biddableConversions

number

Número projetado de conversões que podem receber lances.

biddableConversionsValue

number

Valor total projetado das conversões que podem receber lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número previsto de impressões.

topSlotImpressions

string (int64 format)

Número projetado de impressões de espaço superior. Somente o tipo de canal de publicidade de pesquisa é compatível com esse campo.

interactions

string (int64 format)

Número previsto 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 de 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 de 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 do país em que a operadora está localizada, por exemplo, "AR", "FR" etc.

ChangeEvent

Descreve a alteração granular de recursos retornados de determinados tipos de recursos. As mudanças feitas pela interface ou API nos últimos 30 dias são incluídas. Os valores anteriores e novos dos campos alterados são mostrados. O ChangeEvent pode ter até três minutos de atraso 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 mudança de evento 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 Simply 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 essa alteração.

oldResource

object (ChangedResource)

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

newResource

object (ChangedResource)

Apenas saída. O novo recurso após a mudança. 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 mudança.

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

Enum que lista os tipos de recursos aceitos pelo recurso ChangeEvent.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um recurso não classificado desconhecido nesta versão.
AD Uma alteração no recurso de anúncio.
AD_GROUP Uma mudança no recurso AdGroup.
AD_GROUP_CRITERION Uma mudança no recurso AdGroupCriterion.
CAMPAIGN Uma mudança no recurso da campanha.
CAMPAIGN_BUDGET Uma alteração no recurso CampaignBudget.
AD_GROUP_BID_MODIFIER Uma alteração no recurso GroupBidModifier.
CAMPAIGN_CRITERION Uma mudança no recurso CampaignCriterion.
FEED Uma alteração no recurso de feed.
FEED_ITEM Uma mudança no recurso FeedItem.
CAMPAIGN_FEED Uma alteração no recurso CampaignFeed.
AD_GROUP_FEED Uma mudança no recurso "AdGroupFeed".
AD_GROUP_AD Uma alteração no recurso GroupAd.
ASSET Uma alteração no recurso do recurso.
CUSTOMER_ASSET Uma alteração no recurso CustomerAsset.
CAMPAIGN_ASSET Uma alteração no recurso CampaignAsset.
AD_GROUP_ASSET Uma mudança no recurso "AdGroupAsset".
ASSET_SET Uma mudança no recurso AssetSet.
ASSET_SET_ASSET Uma mudança no recurso AssetSetAsset.
CAMPAIGN_ASSET_SET Uma mudança no recurso CampaignAssetSet.

ChangeClientType

A origem em que o recurso changeEvent foi feito.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um tipo de cliente sem classificação desconhecido nesta versão.
GOOGLE_ADS_WEB_CLIENT Alterações feitas em "ads.google.com". Por exemplo, mudanças feitas no gerenciamento de campanhas.
GOOGLE_ADS_AUTOMATED_RULE Alterações feitas por meio de regras automatizadas do Google Ads.
GOOGLE_ADS_SCRIPTS Alterações feitas nos 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 mudanças.
GOOGLE_ADS_MOBILE_APP Alterações feitas pelo app Google Ads para dispositivos móveis.
GOOGLE_ADS_RECOMMENDATIONS Alterações feitas nas recomendações do Google Ads.
SEARCH_ADS_360_SYNC Mudanças feitas pela sincronização do Search Ads 360.
SEARCH_ADS_360_POST Alterações feitas na publicação do Search Ads 360.
INTERNAL_TOOL Mudanças feitas com ferramentas internas. Por exemplo, quando um usuário define um modelo de URL em uma entidade, como uma campanha, ele é automaticamente associado ao URL do servidor de cliques do SA360.
OTHER Tipos de alterações não categorizadas, por exemplo, alterações feitas por resgate de cupons no Google Ads.
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION Mudanças feitas ao assinar as 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_GROUPS.

campaign

object (Campaign)

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

campaignBudget

object (CampaignBudget)

Apenas saída. Defina 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_CRITERION.

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. Defina se changeResourceType == CAMPAIGN_FEED.

adGroupFeed

object (AdGroupFeed)

Apenas saída. Defina se changeResourceType == AD_GROUP_FEED.

adGroupAd

object (AdGroupAd)

Apenas saída. Defina 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. Defina se changeResourceType == AD_GROUP_ASSET.

assetSet

object (AssetSet)

Apenas saída. Defina se changeResourceType == ASSET_SET.

assetSetAsset

object (AssetSetAsset)

Apenas saída. Defina se changeResourceType == ASSET_SET_ASSET.

campaignAssetSet

object (CampaignAssetSet)

Apenas saída. Defina 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 o 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 levar 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 alteração de status 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 "campanha" 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 essa mudança.

campaignAsset

string

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

adGroupAsset

string

Apenas saída. O GroupAsset 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. Hora em que a alteração mais recente ocorreu neste 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 mudança.

adGroupAd

string

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

adGroupCriterion

string

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

campaignCriterion

string

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

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 IDFAFeed afetado por essa alteração.

campaignFeed

string

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

adGroupBidModifier

string

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

ChangeStatusResourceType

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

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um recurso não classificado desconhecido nesta versão.
AD_GROUP Uma mudança no recurso AdGroup.
AD_GROUP_AD Uma alteração no recurso GroupAd.
AD_GROUP_CRITERION Uma alteração no recurso gcr.
CAMPAIGN Uma mudança no recurso da campanha.
CAMPAIGN_CRITERION Uma mudança no recurso CampaignCriterion.
FEED Uma alteração no recurso de feed.
FEED_ITEM Uma alteração no recurso de item de feed.
AD_GROUP_FEED Uma alteração no recurso GroupFeed.
CAMPAIGN_FEED Uma alteração no recurso CampaignFeed.
AD_GROUP_BID_MODIFIER Uma mudança de recurso de AdGroupBidModifier.
SHARED_SET Uma alteração no recurso SharedSet.
CAMPAIGN_SHARED_SET Uma alteração no recurso CampaignSharedSet.
ASSET Uma mudança no recurso de recurso.
CUSTOMER_ASSET Uma alteração no recurso CustomerAsset.
CAMPAIGN_ASSET Uma alteração no recurso CampaignAsset.
AD_GROUP_ASSET Uma alteração no recurso GroupAsset.
COMBINED_AUDIENCE Uma alteração no recurso CombineAudience.

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 públicos diferentes.

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úblico-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 foi ativado ou removido.

name

string

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

description

string

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

CombinedAudienceStatus

Enum que contém possíveis tipos de status de público-alvo combinado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 de pesquisa, metrics.clicks representa o número de interações válidas e inválidas. As consultas que incluem o ClickView devem ter um filtro que limite os resultados a um dia e podem ser solicitadas para períodos de 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 de clique. Clique em visualizar os nomes dos recursos 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 uma e o clique corresponder ao canal PESQUISA.

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 da campanha associada, se houver.

userList

string

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

ClickLocation

Critérios de localização associados a um clique.

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

string

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

country

string

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

metro

string

O critério de local do metrô associado à impressão.

mostSpecific

string

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

region

string

O critério de localização 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 dos recursos de constante de moeda têm o seguinte formato:

currencyConstants/{code}

code

string

Apenas saída. Código de moeda ISO 4217 com três letras, 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 essa 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 das estratégias de lances que pertencem ao cliente e são compartilhadas com ele.

Ao contrário de BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e que foram compartilhadas com ele, além das estratégias dele. Esse recurso não oferece 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. describeName do cliente proprietário da estratégia de lances.

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

Apenas uma pode ser definida. scheme pode ser apenas de um dos tipos a seguir:

maximizeConversionValue

object (MaximizeConversionValue)

Apenas saída. Uma estratégia de lances automáticos para ajudar a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.

maximizeConversions

object (MaximizeConversions)

Apenas saída. Uma estratégia de lances automáticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder o orçamento.

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 que você definiu.

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 calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

Uma estratégia de lances automáticos para ajudar a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.

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 para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

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 ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.

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 mostrada na parte de cima da primeira página (ou em outro local segmentado).

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

enum (TargetImpressionShareLocation)

Apenas saída. O local segmentado na página de resultados da pesquisa.

locationFractionMicros

string (int64 format)

A fração escolhida de anúncios a serem exibidos no local segmentado 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 e calcular o retorno do investimento em publicidade (ROAS) desejado.

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 os 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 para saber mais.

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.

ClienteCliente

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

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 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 de recurso do cliente-cliente que está 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. Distância entre o cliente e o cliente. Para o self link, o valor do nível será 0. Somente leitura.

timeZone

string

Apenas saída. Representação de string do 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 do 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 geral dos 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 de detalhes da posição. Os nomes dos recursos da visualização de detalhes da posição 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 de 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 para sites, o nome do vídeo no YouTube e o nome traduzido do app para dispositivos móveis.

groupPlacementTargetUrl

string

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

targetUrl

string

Apenas saída. URL do posicionamento, por exemplo, site, link para o aplicativo para dispositivos móveis na app store ou URL de um 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 o valor de retorno. Representa um valor desconhecido nesta versão.
WEBSITE Sites(por exemplo, "www.flores4.com.br").
MOBILE_APP_CATEGORY Categorias de aplicativos para dispositivos móveis(por exemplo, "Jogos").
MOBILE_APPLICATION aplicativos para dispositivos móveis(por exemplo, "mobileapp::2-com.queaspalavrasanswers").
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 Dispositivos que são de propriedade e operados pelo Google (por exemplo, "tv.google.com").

DetailedDemographic

Informações demográficas detalhadas: 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 das informações demográficas detalhadas. Os nomes dos recursos de informações demográficas detalhadas têm o seguinte formato:

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string (int64 format)

Apenas saída. O ID das informações demográficas detalhadas.

name

string

Apenas saída. O nome da informação demográfica detalhada. Por exemplo, "Nível mais alto de aproveitamento educacional"

parent

string

Apenas saída. O pai de detalhes demográficos.

launchedToAll

boolean

Apenas saída. Verdadeiro se a informação demográfica detalhada for lançada em todos os canais e localidades.

availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade das informações demográficas detalhadas.

CriterionCategoryAvailability

Informações de 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)

As localidades disponíveis para a categoria do canal.

CriterionCategoryChannelAvailability

Informações sobre o tipo de canal de publicidade e os subtipos 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 está disponível para todos os subtipos abaixo dele) ou CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType e includeDefaultChannelSubType serão definidos).

advertisingChannelType

enum (AdvertisingChannelType)

Tipo de canal em que a categoria está disponível.

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

Subtipos de canal no tipo de canal em que a categoria está disponível.

includeDefaultChannelSubType

boolean

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

CriterionCategoryChannelAvailabilityMode

Enumeração que contém o possível CriteCategoryChannelAvailabilityMode.

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.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES A categoria está disponível para campanhas de um tipo e subtipo de canal específico.

CriterionCategoryLocaleAvailability

Informações sobre os locais em que uma categoria está disponível.

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

enum (CriterionCategoryLocaleAvailabilityMode)

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

countryCode

string

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

languageCode

string

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

CriterionCategoryLocaleAvailabilityMode

Enum que contém o possível CriterionCategoryLocaleAvailabilityMode.

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ís e idioma.

DisplayKeywordView

Uma visualização de palavra-chave de display.

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

string

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

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

DistanceView

Uma visualização de distância com métricas agregadas pela distância do usuário a partir das extensões de local de um anunciante. Cada DistanceBucket inclui todas as impressões que estão dentro da distância dele, e uma única impressão contribui 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. True se o DistanceBucket estiver usando o sistema métrico. Caso contrário, false.

DistanceBucket

O intervalo de distância de um usuário em relação à extensão de local de um anunciante.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 a 10 km do local.
WITHIN_15KM O usuário estava a 15 km do local.
WITHIN_20KM O usuário estava a até 20 km do local.
WITHIN_25KM O usuário estava a 25 km do local.
WITHIN_30KM O usuário estava a até 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 até 65 km do local.
BEYOND_65KM O usuário estava além de 65 km do local.
WITHIN_0_7MILES O usuário estava a até 1,1 km do local.
WITHIN_1MILE O usuário estava a até 1,6 km do local.
WITHIN_5MILES O usuário estava a 8 km do local.
WITHIN_10MILES O usuário estava a até 16 quilômetros do local.
WITHIN_15MILES O usuário estava a até 25 quilômetros do local.
WITHIN_20MILES O usuário estava a até 32 quilômetros do local.
WITHIN_25MILES O usuário estava a até 40 quilômetros 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é 64 quilômetros do local.
BEYOND_40MILES O usuário estava além de 64 quilômetros do local.

DynamicSearchAdsSearchTermView

Uma visualização dos termos de pesquisa dos 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 dos termos de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos da visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa têm o seguinte formato:

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 gerado dinamicamente do anúncio dinâmico de pesquisa.

Este campo é somente leitura.

landingPage

string

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

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 da visualização de 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 de 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 de marcador de posição do 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 do feed.

GenderView

Uma visualização de gênero. O recurso "genderView" reflete o estado de veiculação efetivo, e não os critérios que foram adicionados. Um grupo de anúncios sem critérios de gênero por padrão é exibido para todos os sexos, portanto, todos os sexos aparecem em 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 da 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 as métricas no local físico real do usuário ou em uma área de interesse. Se outros campos de segmento forem usados, você poderá ter 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 tem interesse ao fazer a consulta.
LOCATION_OF_PRESENCE Local do usuário que emitiu a consulta.

GroupPlacementView

Uma visualização de grupo de posições.

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 do 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, aplicativo 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 do canal do YouTube para canais do YouTube.

targetUrl

string

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

HotelGroupView

Uma visualização de 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 de 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 da 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 hotel para reconciliação com os registros do anunciante. Essas linhas podem ser atualizadas ou canceladas antes do faturamento por upload 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 ID do pedido é o identificador dessa reserva, conforme fornecido 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 fornece 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 é extraído do parâmetro "ID" da tag de acompanhamento de conversões.

checkInDate

string

Apenas saída. Data de 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 está 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. Indica se uma reserva foi cobrada. Depois de faturada, não é possível modificar uma reserva.

status

enum (HotelReconciliationStatus)

Obrigatório. Apenas saída. Status atual de uma reserva com 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 nessa 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 de 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 da visualização de faixa de renda têm o seguinte formato:

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

KeywordView

Uma visualização de palavra-chave.

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

string

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

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

LandingPageView

Uma visualização de 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 idioma. 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 idioma.

code

string

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

name

string

Apenas saída. O nome completo do idioma em inglês, como "English (US)", "Spanish" 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 localização estiver definido, nenhum resultado será retornado. Use geographicView 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 de local. Os nomes dos recursos de visualização do 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 visualização de posição gerenciada. Os nomes dos recursos de visualização de posicionamento gerenciado 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 de 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 o nome de um arquivo). Usado apenas para mídias do tipo ÁUDIO e IMAGEM.

name

string

Imutável. O nome do arquivo de mídia. O nome pode ser usado pelos clientes para ajudar a identificar mídias enviadas 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. Uma mídia de arquivo ZIP cujo conteúdo contém recursos HTML5.

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 somente de resposta.

IMAGE Imagem estática, usada para o anúncio gráfico.
ICON Imagem pequena, usada para anúncios no mapa.
MEDIA_BUNDLE Arquivo ZIP, usado em campos de anúncios de 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 da versão em tamanho real 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 exibido nos URLs do YouTube). Adicionar o prefixo "https://www.youtube.com/watch?v=" a este ID resulta no URL de streaming do YouTube para este vídeo.

advertisingIdCode

string

Apenas saída. O código de Identificação Digital de Publicidade deste 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.

LocalServicesEmployee

Um recurso de funcionário dos serviços locais.

Representação JSON
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
Campos
resourceName

string

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

customers/{customerId}/localServicesEmployees/{gls_employee_id}

creationDateTime

string

Apenas saída. Carimbo de data/hora da criação do funcionário. 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 (LocalServicesEmployeeStatus)

Apenas saída. Status de funcionário, como EXCLUÍDO ou ATIVADO.

type

enum (LocalServicesEmployeeType)

Apenas saída. Tipo de funcionário.

universityDegrees[]

object (UniversityDegree)

Apenas saída. Uma lista de diplomas que este funcionário obteve e quer exibir.

residencies[]

object (Residency)

Apenas saída. As instituições em que o funcionário concluiu a residência.

fellowships[]

object (Fellowship)

Apenas saída. As instituições em que o funcionário concluiu o bolsa de estudos.

languagesSpoken[]

string

Apenas saída. Idiomas que o funcionário fala, representados como tags de idioma de https://developers.google.com/admin-sdk/directory/v1/languages

categoryIds[]

string

Apenas saída. Categoria do funcionário. Acesse https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids para conferir uma lista de IDs de categoria de Serviços Locais.

id

string (int64 format)

Apenas saída. O ID do funcionário.

jobTitle

string

Apenas saída. Cargo do funcionário, como "parceiro sênior" no setor jurídico.

yearStartedPracticing

integer

Apenas saída. O ano em que o funcionário começou a praticar nesse campo.

nationalProviderIdNumber

string

Apenas saída. ID do NPI associado ao funcionário.

emailAddress

string

Apenas saída. Endereço de e-mail do funcionário.

firstName

string

Apenas saída. Nome do funcionário.

middleName

string

Apenas saída. Nome do funcionário.

lastName

string

Apenas saída. Sobrenome do funcionário.

LocalServicesEmployeeStatus

Enumerações que descrevem os status de um funcionário de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED O funcionário não é removido e o status dele é ativo.
REMOVED O funcionário é removido. Usado para excluir um funcionário da empresa.

LocalServicesEmployeeType

Enumerações que descrevem os tipos de um funcionário de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
BUSINESS_OWNER Representa o proprietário da empresa.
EMPLOYEE Representa um funcionário da empresa.

UniversityDegree

Uma lista de diplomas que este funcionário obteve e quer exibir.

Representação JSON
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
Campos
institutionName

string

Apenas saída. Nome da universidade em que o diploma foi obtido.

degree

string

Apenas saída. Nome do diploma obtido.

graduationYear

integer

Apenas saída. Ano de formatura.

Residência

Detalhes sobre a residência médica do funcionário. A residência é uma etapa da educação médica de pós-graduação em que um profissional médico qualificado pratica sob a supervisão de um clínico sênior.

Representação JSON
{
  "institutionName": string,
  "completionYear": integer
}
Campos
institutionName

string

Apenas saída. Nome da instituição em que a residência foi concluída.

completionYear

integer

Apenas saída. Ano de conclusão.

Comunhão

Detalhes sobre a bolsa de estudos médica do funcionário. A bolsa é um período de treinamento médico que o profissional realiza após concluir a residência.

Representação JSON
{
  "institutionName": string,
  "completionYear": integer
}
Campos
institutionName

string

Apenas saída. Nome da instituição em que a bolsa de estudos foi concluída.

completionYear

integer

Apenas saída. Ano de conclusã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)
  },
  "businessRegistrationCheckVerificationArtifact": {
    object (BusinessRegistrationCheckVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
Campos
resourceName

string

Imutável. O nome do recurso da verificação de 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 este 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 de 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 verificação de histórico para contratação.

insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

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

licenseVerificationArtifact

object (LicenseVerificationArtifact)

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

businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

Apenas saída. Um artefato de verificação do registro da empresa.

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 o valor de retorno. Representa um valor desconhecido nesta versão.
PASSED O artefato foi aprovado na verificação.
FAILED O artefato falhou na verificação.
PENDING O artefato está em processo de verificação.
NO_SUBMISSION O artefato precisa que o usuário faça upload de informações antes de ser verificado.
CANCELLED O artefato foi cancelado pelo usuário.

LocalServicesVerificationArtifactType

Enumerações 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 verificação de investigação de histórico para contratação.
INSURANCE Artefato de verificação de seguro.
LICENSE Artefato de verificação de licença.
BUSINESS_REGISTRATION_CHECK Artefato de verificação de registro comercial.

BackgroundCheckVerificationArtifact

Um protótipo que armazena informações específicas da verificação de antecedentes de 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 verificação de antecedentes foi julgado. 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. Ele é medido em "micros" da moeda mencionada no documento de seguro.

rejectionReason

enum (LocalServicesInsuranceRejectionReason)

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

insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

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

LocalServicesInsuranceRejectionReason

Enums que descrevem possíveis motivos de rejeição de um artefato de verificação de 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 nome da empresa no anúncio do Serviços Locais.
INSURANCE_AMOUNT_INSUFFICIENT O valor do seguro não atende ao requisito listado na documentação de resumos legais para essa combinação de ID de categoria e região.
EXPIRED O documento de seguro expirou.
NO_SIGNATURE O documento de seguro não tem uma assinatura.
NO_POLICY_NUMBER O documento de seguro não tem um número de apólice.
NO_COMMERCIAL_GENERAL_LIABILITY A caixa de responsabilidade civil geral comercial (CGL, na sigla em inglês) não está marcada no documento de seguro.
EDITABLE_FORMAT O documento do seguro está em um formato editável.
CATEGORY_MISMATCH O documento de seguro não cobre uma categoria específica.
MISSING_EXPIRATION_DATE O documento de seguro não tem uma data de validade.
POOR_QUALITY O documento do seguro tem baixa qualidade (imagens borradas, ilegíveis etc.).
POTENTIALLY_EDITED Suspeita de edição no documento de seguro.
WRONG_DOCUMENT_TYPE O documento de seguro não foi aceito. Por exemplo, documentos de propostas de seguro, mas sem coberturas, não são aceitos.
NON_FINAL O documento de seguro não é definitivo.
OTHER O documento de seguro tem outra falha que não foi listada explicitamente.

LocalServicesDocumentReadOnly

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

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

string

URL para acessar um documento dos Serviços Locais que já foi 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. Campo somente leitura que contém as informações de um documento de licença enviado.

LocalServicesLicenseRejectionReason

Enumerações que descrevem possíveis motivos de rejeição de um artefato de verificação de 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 nome da empresa 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 Licença de baixa qualidade – imagens borradas, ilegíveis etc.
UNVERIFIABLE Não foi possível verificar a licença devido a uma 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.

BusinessRegistrationCheckVerificationArtifact

Um proto com informações específicas para um cheque de registro de empresa de serviços locais.

Representação JSON
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
Campos
registrationType

enum (LocalServicesBusinessRegistrationType)

Apenas saída. O tipo de verificação de registro comercial (número, documento).

checkId

string

Apenas saída. O ID do cheque, como vat_tax_id, que representa o requisito de "ID fiscal do IVA".

rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

Apenas saída. Motivo da rejeição do documento de registro.

Campo de união business_registration. Informações de registro da empresa. Ele será um dos seguintes formulários com base nos requisitos de diferentes países. business_registration pode ser apenas de um dos tipos a seguir:
registrationNumber

object (BusinessRegistrationNumber)

Apenas saída. Mensagem armazenando o número emitido pelo governo da empresa.

registrationDocument

object (BusinessRegistrationDocument)

Apenas saída. Mensagem que armazena informações de documentos da empresa.

LocalServicesBusinessRegistrationType

Enumerações que descrevem possíveis tipos de registro de um artefato de verificação de verificação de registro de empresa de serviços locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
NUMBER Tipo de verificação do número de registro.
DOCUMENT Tipo de verificação do documento de registro.

LocalServicesBusinessRegistrationCheckRejectionReason

enumeração que descreve possíveis motivos de rejeição do artefato de verificação do registro de uma empresa 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 nome da empresa no anúncio do Serviços Locais.
BUSINESS_DETAILS_MISMATCH Os detalhes da empresa não correspondem.
ID_NOT_FOUND O ID de registro da empresa não foi encontrado.
POOR_DOCUMENT_IMAGE_QUALITY O documento enviado não está claro, está desfocado etc.
DOCUMENT_EXPIRED O documento enviado expirou.
DOCUMENT_INVALID Documento revogado ou anulado.
DOCUMENT_TYPE_MISMATCH Incompatibilidade de tipo de documento.
DOCUMENT_UNVERIFIABLE Não foi possível verificar o documento enviado como legítimo.
OTHER Não foi possível concluir o processo de registro da empresa devido a um problema. Entre em contato com https://support.google.com/localservices para saber mais.

BusinessRegistrationNumber

Um proto com informações específicas do número de registro de uma empresa de serviços locais.

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

string

Apenas saída. Número oficial da empresa.

BusinessRegistrationDocument

Um proto que contém informações específicas de um documento de registro de empresa de serviços locais.

Representação JSON
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Campos
documentReadonly

object (LocalServicesDocumentReadOnly)

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

MobileAppCategoryConstant

Uma constante de 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 de app para dispositivos móveis. Os nomes das constantes de recursos de categoria de aplicativo 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 de 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 das constantes de recursos 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 o valor de retorno. Representa um valor desconhecido nesta versão.
MOBILE Celulares.
TABLET Tablets.

OfflineConversionUploadClientSummary

Resumo do upload de conversões off-line no nível do cliente.

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 upload de conversões off-line no nível do cliente. Os nomes dos recursos de resumo do cliente para 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 da 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 com sucesso.

successRate

number

Apenas saída. Taxa de sucesso.

lastUploadDateTime

string

Apenas saída. Data do lote de uploads 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 pelos últimos N dias.

jobSummaries[]

object (OfflineConversionSummary)

Apenas saída. Resumo das estatísticas do histórico dos ú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 com estatísticas de upload.

OfflineEventUploadClient

Tipo de cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
GOOGLE_ADS_API API Google Ads.
GOOGLE_ADS_WEB_CLIENT Cliente da Web do Google Ads, que pode incluir várias origens, como a 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 o 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. Ver alertas.
NEEDS_ATTENTION Sua configuração de ingestão de dados off-line está ativa, mas há erros que exigem atenção. Ver alertas.
NO_RECENT_UPLOAD Sua configuração de ingestão de dados off-line não recebeu dados nos últimos 28 dias. Talvez tenha ocorrido um erro.

OfflineConversionSummary

Resumo do histórico de envios, agrupado por data 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 de alerta do 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 do acervo.

conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

Apenas saída. Erro no upload do ajuste da 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 de dados.

ConversionAdjustmentUploadError

Enum que descreve possíveis erros de upload de ajustes de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 dessa ação nem o identificador dela. Verifique se os identificadores estão associados à ação de conversão correta e tente de novo.
CONVERSION_EXPIRED Não é possível ajustar uma conversão que ocorreu há mais de 54 dias.
ADJUSTMENT_PRECEDES_CONVERSION O ajuste tem um 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 de adjustmentDateTime está correto e tente novamente.
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 um ajuste 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 nas conversões atuais.
RESTATEMENT_ALREADY_EXISTS A conversão tem uma redefinição anterior com o mesmo adjustmentDateTime. Verifique se o ajuste tem o adjustmentDateTime correto e exclusivo e tente novamente.
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 padronize-os de acordo com as diretrizes.
UNSUPPORTED_USER_IDENTIFIER Use 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 gclidDateTimePair e orderId ao mesmo tempo. 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 de conversão no site exige um ID do pedido (ou seja, um ID da transação). Garanta que as tags do seu site capturem os códigos de pedido e envie esses mesmos códigos com seus ajustes.
ORDER_ID_CONTAINS_PII Não é possível usar ajustes com códigos de pedidos que contêm informações de identificação pessoal (PII).
INVALID_JOB_ID O ID da tarefa fornecido na solicitação não está dentro do intervalo permitido. O ID do job 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 do tipo SALESFORCE, UPLOAD_CLICK ou WEBPAGE. Um ajuste de conversão do tipo ENHANCEMENT só é permitido para ações do tipo WEBPAGE.

ConversionUploadError

Enumeração que descreve possíveis erros de upload de conversão.

Enums
UNSPECIFIED Enum não especificado.
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 precede 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 novamente após 6 horas.
EVENT_NOT_FOUND O evento importado não pôde ser atribuído a um clique. Isso pode ter acontecido porque o evento não veio 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 em vigor da conta do Google Ads do 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 6 horas. Tente fazer o upload novamente daqui a 6 horas.
EXPIRED_CALL Não é possível registrar a chamada porque ela ocorreu antes da janela de lookback da ação de conversão. Verifique se a importação está configurada para receber os dados mais recentes.
CALL_NOT_FOUND Não foi possível encontrar a chamada ou o clique que leva ao evento importado. Verifique se a fonte de dados está configurada para incluir os identificadores corretos.
CONVERSION_PRECEDES_CALL A chamada tem um conversionDateTime que precede 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 efetiva da conta do Google Ads do 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 o mesmo clique e conversionDateTime de uma conversão atual. Use um conversionDateTime ou código de pedido exclusivo para cada evento e tente de novo.
CALL_CONVERSION_ALREADY_EXISTS A chamada importada tem o mesmo 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 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 conversionAcompanhamentoSetting.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 porque o cliente não autorizou 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 padronize-os de acordo com as diretrizes.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER Não é possível usar dados fornecidos pelo usuário com modelos de atribuição externos. Use um modelo de atribuição diferente ou omita os identificadores do usuário e tente de novo.
UNSUPPORTED_USER_IDENTIFIER Os identificadores de usuário fornecidos não são compatíveis. Use apenas um e-mail ou número 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. Para verificar sua configuração, consulte conversionTrackingSetting.accepted_customer_data_terms no cliente.
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. Para verificar sua configuração, consulte conversionAcompanhamentoSetting.Enhanced_conversions_for_leads_enabled no Customer.
INVALID_JOB_ID O ID da tarefa 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álidas.
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 precisa ser aaaa-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS O formato da data e hora da string precisa ser aaaa-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET O formato de 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 que está tentando ser mutado é imutável.
INVALID_VALUE O valor do campo é inválido.
VALUE_MUST_BE_UNSET Não é possível definir o campo.
REQUIRED_NONEMPTY_LIST O campo repetido obrigatório estava vazio.
FIELD_CANNOT_BE_CLEARED Não é possível limpar o campo.
BLOCKED_VALUE O valor do campo está em uma lista de bloqueio.
FIELD_CAN_ONLY_BE_CLEARED O valor do campo não pode ser modificado, exceto para limpar.

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 em uma 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 mutações para o recurso solicitado.
RESOURCE_NOT_IN_GOOGLE_ADS O recurso não está no Google Ads. Ele pertence a outro sistema de anúncios.
RESOURCE_ALREADY_EXISTS O recurso que está sendo criado já existe.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY Esse recurso não pode ser usado com "validateOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE Essa operação não pode ser usada com "partialFailure".
RESOURCE_READ_ONLY Tenta gravar em campos somente leitura.

NotAllowlistedError

Enumeração que descreve possíveis erros de não permissão.

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

Enum que descreve possíveis erros de comprimento de 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 deve conter pelo menos um caractere que não seja um espaço em branco.
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 de recursos de constante da versão do sistema operacional têm o seguinte formato:

operatingSystemVersionConstants/{criterionId}

operatorType

enum (OperatingSystemVersionOperatorType)

Apenas saída. Determina se essa 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 mostra as estatísticas de pesquisa de 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 da visualização do termo 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/{qualifyingQuestionId}'

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 de 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 o alcance da impressão por loja e as estatísticas de conversão de ação local 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 de 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 de recursos das categorias de produtos têm o seguinte formato:

productCategoryConstants/{level}~{categoryId}

categoryId

string (int64 format)

Apenas saída. ID da categoria do produto.

Esse ID é 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 de produto mãe.

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

Representação JSON
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
Campos
regionCode

string

Apenas saída. Código do país ISO 3166-1 com duas letras maiúsculas 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 do grupo de produtos têm o seguinte formato:

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

SearchTermView

Uma visualização de 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 da visualização do termo 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 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 o valor de retorno. Representa um valor desconhecido nesta versão.
ADDED O termo de pesquisa é 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 é segmentado nem excluído.

ShoppingPerformanceView

Visualização de performance do Shopping. Fornece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores de dimensão do produto do Merchant Center, como marca, categoria, atributos personalizados, condição do produto e tipo de produto, refletem o estado de cada dimensão na 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 Shopping. Os nomes dos recursos da visualização de performance de compras têm o formato: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

Uma visualização de termos de pesquisa de uma 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 dos termos de pesquisa da campanha inteligente têm o seguinte formato:

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 de tópicos. Os nomes dos recursos da visualização de tópicos têm o seguinte formato:

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

TravelActivityGroupView

Uma visualização de 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 da visualização do grupo de atividades de viagem têm o seguinte formato:

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

TravelActivityPerformanceView

Uma visualização de desempenho das atividades de viagem.

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

string

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

customers/{customerId}/travelActivityPerformanceView

Interesse do usuário

Um interesse do usuário: uma indústria específica com base em interesses a ser segmentada.

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 for lançado para todos os canais e localidades.

UserInterestTaxonomyType

Enum que contém os possíveis UserInterestTaxonomyTypes.

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 para esse interesse do usuário.
MOBILE_APP_INSTALL_USER Usuários que instalaram 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 categoria específica com base em interesses para alcançar usuários quando eles estiverem passando por momentos 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 de vida. Os nomes de recursos de eventos importantes têm o seguinte formato:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

Apenas saída. ID do evento importante.

name

string

Apenas saída. O nome do evento importante, por exemplo, "Mudança recente".

parent

string

Apenas saída. O pai de LifeEvent.

launchedToAll

boolean

Apenas saída. Verdadeiro se o evento ao vivo for lançado em todos os canais e locais.

availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade do evento de vida.

UserLocationView

Uma visualização da localização do usuário.

A visualização de localização do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele informa métricas sobre a localização física real do usuário de acordo com a região de segmentação ou não. Se outros campos de segmento forem usados, você poderá receber 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 da 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 da Rede de Display do Google com base na categoria em que está o canal (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. Os nomes de recursos de constantes de tópico 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 "Pets & Animals/Pets/Dogs". 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.

Vídeo

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áginas da Web têm o seguinte formato:

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

LeadFormSubmissionData

Dados dos envios de formulários 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 do formulário de lead têm o seguinte formato:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

Apenas saída. ID desse envio de 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 GroupAd 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 de campo para campos do formulário de lead.

fieldValue

string

Apenas saída. Valor do campo para campos do formulário de lead.

CustomLeadFormSubmissionField

Campos da pergunta personalizada enviada

Representação JSON
{
  "questionText": string,
  "fieldValue": string
}
Campos
questionText

string

Apenas saída. O texto da pergunta personalizada pode ter no máximo 300 caracteres.

fieldValue

string

Apenas saída. O valor do campo para a resposta da pergunta personalizada, com o número máximo de caracteres é 70.

Lead de serviços locais

Dados do líder dos Serviços Locais. Contém detalhes do lead que são gerados quando o usuário liga, envia mensagens ou reserva 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)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
Campos
resourceName

string

Apenas saída. O nome do recurso dos dados de lead de serviços locais. O nome do recurso de lead dos Serviços Locais precisa ter o formato

customers/{customerId}/localServicesLead/{local_services_lead_id}

id

string (int64 format)

Apenas saída. 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, consulte: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids

serviceId

string

Apenas saída. Serviço para a categoria. Por exemplo: buyer_agent, seller_agent para a categoria de xcat:service_area_business_real_estate_agent.

contactDetails

object (ContactDetails)

Apenas saída. Dados de contato do lead

leadType

enum (LeadType)

Apenas saída. Tipo de lead dos Serviços Locais: telefone, mensagem, agendamento 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. Observação adicionada pelo anunciante para o lead.

creditDetails

object (CreditDetails)

Apenas saída. Detalhes do crédito do lead.

ContactDetails

Campos com 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 E.164.

email

string

Apenas saída. Endereço de e-mail do consumidor.

consumerName

string

Apenas saída. Nome do consumidor, caso ele tenha fornecido o nome em uma mensagem ou no formulário de reserva em google.com

LeadType

Possíveis tipos de lead.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
MESSAGE Lead de mensagem.
PHONE_CALL Lead criado por ligação.
BOOKING Lead de reserva.

LeadStatus

Possíveis status do lead.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
NEW Novo lead que ainda não foi visto pelo anunciante.
ACTIVE Lead que interagiu com o 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 as observações, 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. A data e a 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 cliente em potencial.

CreditDetails

Representa os detalhes de crédito de um lead.

Representação JSON
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
Campos
creditState

enum (CreditState)

Apenas saída. Estado de crédito do lead.

creditStateLastUpdateDateTime

string

Apenas saída. A data e a hora em que o estado de crédito do lead foi atualizado pela última vez. 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"

CreditState

Possíveis estados de crédito de um lead.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PENDING Um crédito foi registrado e está sendo processado pelo back-end do Google Ads, mas ainda não foi aplicado à conta.
CREDITED O crédito foi emitido para a conta do Google Ads.

LocalServicesLeadConversation

Dados da conversa de leads dos Serviços Locais. Contém detalhes da conversa de lead que é gerada quando o usuário liga, envia mensagens ou reserva 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 de conversa de lead dos Serviços Locais. O nome do recurso de conversa de lead dos Serviços Locais tem o seguinte formato:

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}

id

string (int64 format)

Apenas saída. ID desta conversa de lead.

conversationChannel

enum (ConversationType)

Apenas saída. Tipo de conversa de lead GLS, EMAIL, MESSAGE, PHONE_CALL, SMS etc.

participantType

enum (ParticipantType)

Apenas saída. Tipo de participante na conversa principal, ANUNCIANTE ou CONSUMER.

lead

string

Apenas saída. Nome do recurso do lead associado à conversa.

eventDateTime

string

Apenas saída. A data e hora em que a conversa de 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 de possíveis conversas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EMAIL Conversa por e-mail.
MESSAGE Conversa com o lead por chat.
PHONE_CALL Conversa de lead telefônico.
SMS Conversa de lead por SMS.
BOOKING Conversa de lead de reserva.

ParticipantType

Possíveis tipos de participantes da conversa principal.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ADVERTISER Participante do provedor de anúncios dos Serviços Locais.
CONSUMER Consumidor de anúncios dos Serviços Locais Participante.

PhoneCallDetails

Representa 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 início a fim).

callRecordingUrl

string

Apenas saída. URL do arquivo de áudio de gravação de chamada.

MessageDetails

Representa detalhes da mensagem de texto no caso de e-mail, mensagem ou SMS.

Representação JSON
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
Campos
text

string

Apenas saída. Conteúdo textual da mensagem.

attachmentUrls[]

string

Apenas saída. URL do SMS ou dos anexos de e-mail. Esses URLs podem ser usados para fazer download do conteúdo do anexo usando o token de desenvolvedor.

AndroidPrivacySharedKeyGoogleAdGroup

Uma visualização de 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 de 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. O tipo enumerado de interação usado na codificação da 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. O tipo de enumeração de rede usado na codificação da chave de compartilhamento.

adGroupId

string (int64 format)

Apenas saída. O ID do grupo de anúncios usado na codificação da chave de compartilhamento.

sharedAdGroupKey

string

Apenas saída. String hexadecimal de 128 bits da chave codificada do grupo de anúncios compartilhado, incluindo um prefixo "0x". Essa chave pode ser usada para fazer um operador OR bit a bit com a chave de conversão agregada para 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 de 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 de chave compartilhada de privacidade do Android para a chave da 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 de 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. O tipo enumerado de interação usado na codificação da 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 o prefixo "0x". Essa chave pode ser usada para fazer um operador OR bit a bit com a chave de conversão agregada para 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 da 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 de 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. O tipo enumerado de interação usado na codificação da 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. O tipo de enumeração de rede usado na codificação da chave de compartilhamento.

sharedNetworkTypeKey

string

Apenas saída. String hexadecimal de 128 bits da chave de tipo de rede compartilhada codificada, incluindo um prefixo "0x". Essa chave pode ser usada para fazer um operador OR bit a bit com a chave de conversão agregada para 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 esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 a 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 que incluem o atributo includeInConversionsMetric como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 da 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 da rede de publicidade do iOS Store Kit.

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 cujo tráfego não foi pago nem adquirido por atividades de incentivo pelo editor

publisherUnknownClicks

string (int64 format)

Cliques de tráfego 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 de 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

O valor da conversão de vida útil de todos os novos clientes. Se você tiver configurado a meta de aquisição de clientes no nível da conta ou da campanha, ela vai incluir o valor de conversão adicional de novos clientes para conversões com e sem lances. Se a campanha tiver a meta de aquisição de clientes e selecionado "Definir lances mais altos 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 informa se as chamadas foram atendidas ou a duração delas.

Essa métrica se aplica somente a itens do feed.

allConversionsFromDirections

number

O número de vezes que as pessoas clicaram no botão "Como chegar" para ir a uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos 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

Quantas vezes as pessoas 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 as pessoas 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 apenas aos itens do feed.

auctionInsightSearchAbsoluteTopImpressionPercentage

number

Essa métrica faz parte do Relatório de informações do leilão e mostra a frequência com que os anúncios de outro participante apareceram na posição mais destacada na página de resultados da pesquisa. Essa porcentagem é calculada apenas em relação aos 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 que seus anúncios superaram (exibidos acima) de outro participante 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 insights do leilão e mostra a frequência com que 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 alta 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 a frequência com que os anúncios de outro participante foram exibidos ao lado dos principais resultados da pesquisa orgânica. Essa porcentagem é calculada apenas 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 dando lances em produtos semelhantes.

biddableAppInstallConversions

number

Número de instalações de apps.

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 visualizam o anúncio clicam nele.

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. Veja mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

combinedClicksPerQuery

number

O número de vezes que seu anúncio ou a listagem do seu site nos resultados não pagos recebeu cliques (combinedClicks) e dividido por combinadas consultas. Confira mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

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. Veja mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

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/hora em que uma tag de conversão para essa ação foi disparada e visualizada pelo Google Ads. Esse evento de disparo pode não ter sido o resultado de uma conversão atribuível (por exemplo, porque 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 essa 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 dos novos clientes. Se você tiver configurado a meta de aquisição de clientes no nível da conta ou da campanha, o valor da conversão adicional de novos clientes para conversões que podem receber lances será incluído. Se a campanha tiver a meta de aquisição de clientes e selecionado "Definir lances mais altos 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 anúncios. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 que incluem o atributo includeInConversionsMetric 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 que incluem o atributo includeInConversionsMetric como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

currentModelAttributedConversionsFromInteractionsRate

number

O modelo atual atribui 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 que incluem o atributo includeInConversionsMetric 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 ao modelo atual das interações divididas pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão que incluem o atributo includeInConversionsMetric 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 anúncios. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 de lead com base nos cliques.

hotelCommissionRateMicros

string (int64 format)

Taxa de lance 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 pela hotel_commission_rate na moeda do anunciante.

hotelPriceDifferencePercentage

number

A diferença média de preço entre o preço oferecido pelo anunciante do hotel informado 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 considerando 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 mensagem que tinham qualificação para rastreamento de mensagens.

messageImpressions

string (int64 format)

O número de impressões de clique para enviar uma mensagem que estava qualificada para o rastreamento de mensagens.

messageChatRate

number

É o 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 de mensagens em uma impressão de anúncio com uma opção de mensagens e o rastreamento de mensagens ativado. Essa taxa pode ser superior a 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 entre customer ou campaign e segmentada por segments.recommendation_type. Por exemplo, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer retornará um URL para cada combinação exclusiva (cliente, recommendationType).

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. Confira mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

organicClicksPerQuery

number

O número de vezes que alguém clicou na listagem do seu site nos resultados não pagos (orgânicaClicks) dividido pelo número total de pesquisas que retornaram páginas do seu site (orgânicaConsultas). Veja mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

organicImpressions

string (int64 format)

É o número de listagens do seu site nos resultados da pesquisa não pagas. Confira mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

organicImpressionsPerQuery

number

O número de vezes que uma página do seu site foi listada nos resultados de pesquisa não paga (organicImpressions) dividido pelo número de pesquisas que retornam a listagem do seu site nos resultados não pagos (organicQueries). Confira mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

organicQueries

string (int64 format)

O número total de pesquisas que retornaram a listagem do seu site nos resultados não pagos. Veja mais detalhes na página de ajuda em https://support.google.com/google-ads/answer/3097241.

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 exibido (phoneImpression).

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. Saiba mais em https://support.google.com/google-ads/answer/7501826. 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 anúncios na parte superior dos resultados da 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 apareceu ao lado dos principais resultados da 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 anúncios na parte superior dos 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 apareceu perto dos principais resultados da pesquisa orgânica 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.

searchTopImpressionShare

number

As impressões que você recebeu entre os anúncios na parte de cima em comparação com o número estimado de impressões que você tinha qualificação para receber entre os anúncios nessa posição. 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 de volume de pesquisa 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 ou não definido, se não estiver disponível (por exemplo, para campanhas que tiveram tráfego de estratégias de lances de portfólio ou sem tCPA).

averageTargetRoas

number

O ROAS desejado médio ou não definido, se não estiver disponível (por exemplo, para campanhas que tiveram tráfego de estratégias de lances de portfólio ou que não são de tROAS).

topImpressionPercentage

number

A porcentagem de impressões de anúncios 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 a data, os valores na coluna de data significam a data da conversão. Confira os detalhes das colunas "by_conversion_date" 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". 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 ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 que incluem o atributo includeInConversionsMetric 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 sujeito a cobrança (clique ou impressão). Essa medida vem do local com base no recurso.

allConversionsFromLocationAssetDirections

number

Número de cliques em rotas de carro em qualquer superfície de local após um evento de anúncio que gere cobranças (clique ou impressão). Essa medida vem do local com base no recurso.

allConversionsFromLocationAssetMenu

number

Número de cliques em links de menu em qualquer plataforma de local após um evento de anúncio sujeito a cobrança (clique ou impressão). Essa medida vem do local com base no recurso.

allConversionsFromLocationAssetOrder

number

Número de cliques em pedidos em qualquer plataforma após um evento de anúncio sujeito a cobrança (clique ou impressão). Essa medida vem do local com base no recurso.

allConversionsFromLocationAssetOtherEngagement

number

Número de outros tipos de cliques de ações locais em qualquer plataforma após um evento de anúncio sujeito a cobrança (clique ou impressão). Essa medição vem da localização com base no recurso.

allConversionsFromLocationAssetStoreVisits

number

Número estimado de visitas à loja após um evento de anúncio que gera cobrança (clique ou impressão). Essa medição vem da localização com base no recurso.

allConversionsFromLocationAssetWebsite

number

Número de cliques no URL do site em qualquer plataforma de local após um evento de anúncio sujeito a cobrança (clique ou impressão). Essa medição vem da localização com base no recurso.

eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

É o número de impressões em que o local da loja foi exibido ou foi usado para segmentação. Essa medida vem do local com base no recurso.

viewThroughConversionsFromLocationAssetClickToCall

number

Número de cliques no botão de chamada em qualquer plataforma de local após uma impressão. Essa medida vem do local com base no recurso.

viewThroughConversionsFromLocationAssetDirections

number

Número de cliques em rotas de carro em qualquer superfície de local após uma impressão. Essa medição vem da localização com base no recurso.

viewThroughConversionsFromLocationAssetMenu

number

Número de cliques no link de menu em qualquer plataforma de local após uma impressão. Essa medição vem da localização com base no recurso.

viewThroughConversionsFromLocationAssetOrder

number

Número de cliques de pedidos em qualquer superfície de local após uma impressão. Essa medição vem da localização com base no recurso.

viewThroughConversionsFromLocationAssetOtherEngagement

number

Número de outros tipos de cliques de ações locais em qualquer superfície do local após uma impressão. Essa medição vem da localização com base no recurso.

viewThroughConversionsFromLocationAssetStoreVisits

number

Número estimado de visitas à loja após uma impressão. Essa medição vem da localização com base no recurso.

viewThroughConversionsFromLocationAssetWebsite

number

Número de cliques no URL do site em qualquer plataforma de local após uma impressão. Essa medida vem do local com base no recurso.

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 esse item 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 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 no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 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 produtos 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 um 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 por venda cruzada é o valor total dos itens comercializados que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O CPV com 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 no anúncio de um chapéu no Shopping 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 no anúncio de um chapéu no Shopping e comprou esse item 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 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 deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 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 no anúncio de um chapéu no Shopping e comprou esse item 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 no anúncio de um chapéu no Shopping 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 campanha: display, vídeo, Discovery e app.

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 campanha: display, vídeo, Discovery e para apps.

InteractionEventType

Enumeração que descreve possíveis tipos de interações a pagar e sem custo financeiro.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
CLICK Clique no site. Na maioria dos casos, essa interação navega para um local externo, geralmente a página de destino do anunciante. Esse também é o InteractionEventType padrão para eventos de clique.
ENGAGEMENT A intenção expressa do usuário de interagir com o anúncio no local.
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. Ele é usado quando uma linha de conversão de anúncio NÃO indica que as interações sem custo financeiro (por exemplo, conversões de anúncio) precisam ser "promovidas" e informadas como parte das métricas principais. Trata-se simplesmente de outras conversões (de anúncios).

SearchVolumeRange

Intervalo do volume de pesquisa. O volume de pesquisas real está dentro desse intervalo.

Representação JSON
{
  "min": string,
  "max": string
}
Campos
min

string (int64 format)

Limite inferior do volume de pesquisas.

max

string (int64 format)

Limite máximo do volume de pesquisa.

Segmentos

Segmentar apenas campos.

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,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": 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)

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 tipo enumerado que representa o número de dias entre a impressão e a conversão.

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

Um valor enum que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes à conversão.

dayOfWeek

enum (DayOfWeek)

Dia da semana, por exemplo, SEGUNDA-FEIRA.

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 tarifa do hotel.

hotelPriceBucket

enum (HotelPriceBucket)

Faixa de preço do hotel.

keyword

object (Keyword)

Critério da palavra-chave.

monthOfYear

enum (MonthOfYear)

Mês do ano, por exemplo, janeiro.

placeholderType

enum (PlaceholderType)

Tipo de marcador de posição. Ele é usado somente com métricas de itens de 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 do 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 em que uma regra de valor foi aplicada. GEO_LOCATION, DEVICE, AUDIENCE mostram o ajuste líquido depois que as regras de valor foram aplicadas.

skAdNetworkUserType

enum (SkAdNetworkUserType)

Tipo de usuário da rede de publicidade do iOS Store Kit.

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

Tipo de evento de anúncio da rede de publicidade da iOS Store Kit.

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

Crédito de atribuição da rede de publicidade do kit da loja do iOS

skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Valor da conversão aproximado da rede de publicidade do kit de apps da App Store para 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. O valor nulo significa que o segmento não é aplicável (por exemplo, campanha que não seja do iOS) ou que o domínio de origem e o app de origem não estavam presentes nos postbacks enviados pela Apple.

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

Serve para segmentar conversões por se o usuário é um cliente novo ou recorrente. Geralmente, essa segmentação é usada para medir o impacto da meta de aquisição de clientes.

activityAccountId

string (int64 format)

ID da conta da atividade.

activityCity

string

A cidade em que a atividade de viagem está disponível.

activityCountry

string

O país em que a atividade de viagem está disponível.

activityRating

string (int64 format)

Classificação da atividade.

activityState

string

O estado em que a atividade de viagem está disponível.

externalActivityId

string

ID de atividade fornecido pelo anunciante.

adGroup

string

Nome do recurso do grupo de anúncios.

assetGroup

string

Nome do recurso do grupo de recursos.

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

Isso segmenta as colunas de conversão de acordo com a conversão original e o valor da conversão em comparação com o delta se as conversões tiverem sido ajustadas. Uma linha falsa contém os dados como originalmente declarados. Já a linha verdadeira tem o delta entre os dados atuais e os dados conforme indicado originalmente. A soma dos dois resulta em 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 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 por área geográfica que representa um município.

geoTargetDistrict

string

Nome do recurso da constante de segmentação por área 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 geográfica que representa um código postal.

geoTargetProvince

string

Nome do recurso da constante de segmentação 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 de 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 estadia no hotel.

hotelRateRuleId

string

ID da regra de tarifa do hotel.

hotelState

string

Estado do hotel.

hour

integer

Hora do dia como um número entre 0 e 23.

interactionOnThisExtension

boolean

Usado apenas com métricas de itens de feed. Indica se as métricas de interação ocorreram no próprio item do feed ou em uma extensão ou 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

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

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 2018-04-01. no formato aaaa-MM-dd.

searchSubcategory

string

Uma subcategoria de termo de pesquisa. Uma string vazia denota a subcategoria geral dos 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 de conversão da rede de anúncios do kit da loja do iOS. O valor nulo significa que o segmento não é aplicável, por exemplo, em campanhas que não sejam 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 exibido. Valor nulo significa que esse segmento não é aplicável, por exemplo, uma campanha não iOS ou que não estava presente em nenhum postback enviado 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. Valor nulo significa que esse segmento não é aplicável, por exemplo, uma campanha não iOS ou que não estava presente em nenhum postback enviado pela Apple.

skAdNetworkPostbackSequenceIndex

string (int64 format)

Índice de sequência de postback da rede de anúncios do kit da loja do iOS.

assetInteractionTarget

object (AssetInteractionTarget)

Usado apenas com as métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente. As interações (por exemplo, cliques) são contadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando elas são veiculadas em conjunto. Quando interactionOnThisAsset é verdadeiro, significa que as interações estão nesse recurso específico. Quando interactionOnThisAsset é falso, significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio veiculado com esse recurso.

AdDestinationType

Enumera os tipos de destino do Google Ads

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
NOT_APPLICABLE Anúncios que não têm a intenção de direcionar os usuários para outros destinos
WEBSITE Site
APP_STORE App Store ou Play Store do iOS
PHONE_CALL Ligar para o discador
MAP_DIRECTIONS App Mapa
LOCATION_LISTING Página dedicada a locais
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 segmento BudgetCampaignAssociationStatus.

Representação JSON
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
Campos
status

enum (BudgetCampaignAssociationStatus)

Status da associação da campanha ao 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 o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A campanha está usando o orçamento.
REMOVED A campanha não está mais usando o orçamento.

ClickType

Enumera os tipos de cliques 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 Ligações telefônicas discadas manualmente.
CALLS Chamadas telefônicas.
CLICK_ON_ENGAGEMENT_AD Clique no anúncio de engajamento.
GET_DIRECTIONS Direção de direção.
LOCATION_EXPANSION Receber detalhes do local.
LOCATION_FORMAT_CALL Ligar.
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 App Store.
VIDEO_CALL_TO_ACTION_CLICKS Overlay 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 wireless.
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. Nas campanhas Performance Max e Discovery.

ConversionAttributionEventType

Tipo de evento das conversões 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. O dia 0 é incluído, mas o dia 1 não.
ONE_TO_TWO_DAYS Intervalo de conversão de 1 a 2 dias. Um dia é incluído, dois dias não.
TWO_TO_THREE_DAYS Intervalo de conversão de 2 a 3 dias. 2 dias são incluídos, 3 dias não são.
THREE_TO_FOUR_DAYS Intervalo de tempo de conversão de 3 a 4 dias. 3 dias estão incluídos, 4 dias não.
FOUR_TO_FIVE_DAYS Intervalo de conversão de 4 a 5 dias. 4 dias estão incluídos, 5 dias não.
FIVE_TO_SIX_DAYS Bucket de tempo de conversão de 5 a 6 dias. 5 dias são incluídos, 6 dias não são.
SIX_TO_SEVEN_DAYS Intervalo de tempo de conversão de 6 a 7 dias. 6 dias são incluídos, 7 dias não são.
SEVEN_TO_EIGHT_DAYS Intervalo de tempo de conversão de 7 a 8 dias. Sete dias estão incluídos, oito dias não.
EIGHT_TO_NINE_DAYS Intervalo de tempo de conversão de 8 a 9 dias. Oito dias estão incluídos, 9 dias não.
NINE_TO_TEN_DAYS Intervalo de tempo de conversão de 9 a 10 dias. 9 dias estão incluídos, 10 dias não.
TEN_TO_ELEVEN_DAYS Intervalo de tempo de conversão de 10 a 11 dias. 10 dias são incluídos, 11 dias não sã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 conversão de 12 para 13 dias. 12 dias são incluídos, 13 dias não são.
THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de conversão de 13 para 14 dias. 13 dias são incluídos, 14 dias não são.
FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo 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ão incluídos, 30 dias não estão.
THIRTY_TO_FORTY_FIVE_DAYS Bucket 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 conversão de 45 a 60 dias. 45 dias está incluído, 60 dias não.
SIXTY_TO_NINETY_DAYS Intervalo de conversão de 60 a 90 dias. 60 dias está incluído, 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 da 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. O dia 0 é incluído, mas o dia 1 não.
CONVERSION_ONE_TO_TWO_DAYS Intervalo de conversão de 1 a 2 dias. Um dia é incluído, dois dias não.
CONVERSION_TWO_TO_THREE_DAYS Intervalo de conversão de 2 a 3 dias. 2 dias são incluídos, 3 dias não são.
CONVERSION_THREE_TO_FOUR_DAYS Intervalo de tempo de conversão de 3 a 4 dias. 3 dias estão incluídos, 4 dias não.
CONVERSION_FOUR_TO_FIVE_DAYS Intervalo de conversão de 4 a 5 dias. 4 dias estão incluídos, 5 dias não.
CONVERSION_FIVE_TO_SIX_DAYS Bucket de tempo de conversão de 5 a 6 dias. 5 dias são incluídos, 6 dias não são.
CONVERSION_SIX_TO_SEVEN_DAYS Intervalo de tempo de conversão de 6 a 7 dias. 6 dias são incluídos, 7 dias não são.
CONVERSION_SEVEN_TO_EIGHT_DAYS Intervalo de tempo de conversão de 7 a 8 dias. Sete dias estão incluídos, oito dias não.
CONVERSION_EIGHT_TO_NINE_DAYS Intervalo de tempo de conversão de 8 a 9 dias. Oito dias estão incluídos, 9 dias não.
CONVERSION_NINE_TO_TEN_DAYS Intervalo de tempo de conversão de 9 a 10 dias. 9 dias estão incluídos, 10 dias não.
CONVERSION_TEN_TO_ELEVEN_DAYS Intervalo de tempo de conversão de 10 a 11 dias. 10 dias são incluídos, 11 dias não sã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 conversão de 12 para 13 dias. 12 dias são incluídos, 13 dias não são.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de conversão de 13 para 14 dias. 13 dias são incluídos, 14 dias não são.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo 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ão incluídos, 30 dias não estão.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS Bucket 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 conversão de 45 a 60 dias. 45 dias está incluído, 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, 90 dias não.
ADJUSTMENT_LESS_THAN_ONE_DAY Intervalo de atraso do ajuste de conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não é.
ADJUSTMENT_ONE_TO_TWO_DAYS Intervalo de tempo do ajuste de conversão de 1 a 2 dias. Um dia está incluído, dois dias não.
ADJUSTMENT_TWO_TO_THREE_DAYS Intervalo de tempo do ajuste de conversão de 2 a 3 dias. 2 dias são incluídos, 3 dias não são.
ADJUSTMENT_THREE_TO_FOUR_DAYS Intervalo de ajuste da conversão de 3 a 4 dias. 3 dias estão incluídos, 4 dias não.
ADJUSTMENT_FOUR_TO_FIVE_DAYS Intervalo de ajuste da conversão de 4 a 5 dias. 4 dias estão incluídos, 5 dias não.
ADJUSTMENT_FIVE_TO_SIX_DAYS Intervalo de tempo do ajuste de conversão de 5 a 6 dias. 5 dias estão incluídos, 6 dias não.
ADJUSTMENT_SIX_TO_SEVEN_DAYS Intervalo de ajuste da conversão de 6 a 7 dias. Seis dias estão incluídos, 7 dias não.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS Intervalo de tempo do ajuste de conversão de 7 a 8 dias. Sete dias estão incluídos, oito dias não.
ADJUSTMENT_EIGHT_TO_NINE_DAYS Intervalo de ajuste da conversão de 8 para 9 dias. Oito dias estão incluídos, 9 dias não.
ADJUSTMENT_NINE_TO_TEN_DAYS Intervalo de tempo do ajuste de conversão de 9 a 10 dias. 9 dias estão incluídos, 10 dias não.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS Intervalo de tempo do ajuste de conversão de 10 para 11 dias. 10 dias está incluído, 11 dias não.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS Intervalo de ajuste da conversão de 11 para 12 dias. 11 dias está incluído, 12 dias não.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS Intervalo de ajuste da conversão de 12 para 13 dias. 12 dias são incluídos, 13 dias não são.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS Intervalo de ajuste de conversão de 13 para 14 dias. 13 dias está incluído, 14 dias não.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de ajuste da conversão de 14 para 21 dias. 14 dias está incluído, 21 dias não.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo do ajuste de conversão de 21 para 30 dias. 21 dias são incluídos, 30 dias não são.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo do ajuste de conversão de 30 para 45 dias. 30 dias está incluído, 45 dias não.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo do ajuste de conversão de 45 para 60 dias. 45 dias está incluído, 60 dias não.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS Intervalo de tempo do ajuste de conversão de 60 a 90 dias. 60 dias está incluído, 90 dias não.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS Intervalo de tempo do ajuste de conversão de 90 para 145 dias. 90 dias estão incluídos, 145 dias não estão.
CONVERSION_UNKNOWN Bucket de tempo de conversão DESCONHECIDO. Isso se aplica a datas anteriores ao período de atraso de conversão disponível no Google Ads.
ADJUSTMENT_UNKNOWN Intervalo de tempo de ajuste de conversão DESCONHECIDO. Esse valor é referente a datas anteriores à disponibilização do intervalo de tempo do ajuste de conversão no Google Ads.

ExternalConversionSource

A origem de conversão externa 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 interface do Google Ads como "Site".
ANALYTICS Conversão que vem da meta ou transação vinculada do Google Analytics. É exibida na interface do Google Ads como "Analytics".
UPLOAD Conversão no site enviada pelo ConversionUploadService. Exibido na interface do Google Ads como "Importar de cliques".
AD_CALL_METRICS A conversão que ocorre quando um usuário clica diretamente em uma extensão de chamada 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) a partir do 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 varejo de um anunciante depois de clicar em um anúncio do Google. É exibida na interface do Google Ads como "Visitas à loja".
ANDROID_IN_APP A conversão que ocorre quando um usuário realiza uma ação no app, como uma compra em um app Android. É exibida na interface 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 interface 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 apps legadas que não têm uma AppPlatform fornecida. São mostradas 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 interface do Google Ads como "Instalação de app Android (primeiro acesso)".
UPLOAD_CALLS Conversão de chamada enviada por meio do ConversionUploadService. Exibido na interface do Google Ads como "Importar de chamadas".
FIREBASE Conversão proveniente de um evento vinculado do Firebase. Exibido na interface do Google Ads como "Firebase".
CLICK_TO_CALL Conversão que ocorre quando um usuário clica em um número de telefone para dispositivos móveis. É exibida na interface do Google Ads como "Cliques em número de telefone".
SALESFORCE Conversão que vem do Salesforce. Exibida na interface do Google Ads como "Salesforce.com".
STORE_SALES_CRM Conversão proveniente de compras na loja registrada pelo CRM. É exibida na interface do Google Ads como "Vendas na loja (parceiro de dados)".
STORE_SALES_PAYMENT_NETWORK Conversão que vem de compras na loja da rede de pagamentos. Exibido na interface do Google Ads como "Vendas na loja (rede de pagamentos)".
GOOGLE_PLAY Conversão do Google Play sem código; exibida na interface do Google Ads como "Google Play".
THIRD_PARTY_APP_ANALYTICS Conversão que vem de um evento de análise de apps de terceiros vinculado. É exibida na interface do Google Ads como "Análise de apps 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 comerciantes de terceiros. Exibido na interface do Google Ads como "Vendas na loja (upload direto)".
STORE_SALES Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros do comerciante e/ou de compras na loja usando cartões de redes de pagamento. É exibido na interface do Google Ads como "Vendas na loja".
SEARCH_ADS_360 Conversões importadas dos dados do Floodlight do 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 interface do Google Ads como Google Analytics (SA360).
FIREBASE_SEARCH_ADS_360 Conversão que vem de um evento vinculado do Firebase para o Search Ads 360.
DISPLAY_AND_VIDEO_360_FLOODLIGHT Conversão informada pelo Floodlight para o DV360.

HotelRateType

Enumeração que descreve possíveis tipos de tarifas de hotel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa 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 associação está disponível e atende aos requisitos básicos, como ter uma tarifa pública disponível. O tratamento da IU vai riscar a tarifa pública e indicar que um desconto está disponível para o usuário. Para mais informações sobre 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 os possíveis intervalos de preço de hotéis.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
LOWEST_UNIQUE O menor preço exclusivo. O parceiro tem o menor preço, e não há outros parceiros com uma pequena variação desse preço.
LOWEST_TIED Tem o menor preço (igual a outros parceiros). O parceiro está dentro de uma pequena variação do preço mais baixo.
NOT_LOWEST Não é o preço mais baixo. O parceiro não está dentro de uma pequena variação do 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 da 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 Somente anúncios estavam contidos na página de resultados do mecanismo de pesquisa.
ORGANIC_ONLY Apenas resultados orgânicos estavam contidos na página de resultados do mecanismo de pesquisa.
ADS_AND_ORGANIC Os anúncios e os resultados orgânicos estavam contidos na página de resultados do mecanismo de pesquisa.

SearchTermMatchType

Possíveis tipos de correspondência para 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 posições possíveis do anúncio.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
SEARCH_SIDE Pesquisa do Google: 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 da regra do 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 valor aplicada após a ativação da regra de valor.
ORIGINAL Confira abaixo as conversões aplicadas por regras de valor: as estatísticas originais.
NEW_VS_RETURNING_USER Quando uma condição de cliente novo ou recorrente é atendida.
GEO_LOCATION Quando uma condição de geolocalização no momento da consulta é atendida.
DEVICE Quando uma condição do dispositivo de navegação no tempo de 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ários 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 viu o anúncio.

SkAdNetworkSourceApp

Um segmento de SkAdNetworkSourceApp.

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

string

ID do aplicativo em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi exibido.

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 de tipo enumerado verdadeiro não pode ser retornado nesta versão da API ou ainda não tem suporte.
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 do anúncio.
CONTRIBUTED O Google se qualificou para a atribuição, mas não venceu.

SkAdNetworkSourceType

Enumera os tipos de origem da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
UNAVAILABLE O ID ou o domínio do app 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 apenas com as métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente.

ConvertingUserPriorEngagementTypeAndLtvBucket

Enumera os tipos de engajamento anteriores do usuário e o bucket de valor da vida útil

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
NEW O usuário que converteu é novo para o anunciante.
RETURNING O usuário que converte está retornando ao anunciante. A definição de retorno varia de acordo com 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 faz a conversão é novo para o anunciante e tem alto valor da vida útil.