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)
  },
  "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)
  },
  "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)
  },
  "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)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "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)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
Campos
accountBudget

object (AccountBudget)

O orçamento da conta na consulta.

accountBudgetProposal

object (AccountBudgetProposal)

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

adGroup

object (AdGroup)

Grupo de anúncios mencionado na consulta.

adGroupAd

object (AdGroupAd)

O anúncio mencionado na consulta.

adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

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

adGroupAdAssetView

object (AdGroupAdAssetView)

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

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

O modificador de lance mencionado na consulta.

adGroupCriterion

object (AdGroupCriterion)

O critério indicado na consulta.

adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

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

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

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

adGroupCustomizer

object (AdGroupCustomizer)

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

adGroupExtensionSetting

object (AdGroupExtensionSetting)

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

adGroupFeed

object (AdGroupFeed)

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

adGroupLabel

object (AdGroupLabel)

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

adGroupSimulation

object (AdGroupSimulation)

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

adParameter

object (AdParameter)

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

ageRangeView

object (AgeRangeView)

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

adScheduleView

object (AdScheduleView)

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

domainCategory

object (DomainCategory)

A categoria de domínio indicada na consulta.

asset

object (Asset)

O recurso referenciado na consulta.

assetFieldTypeView

object (AssetFieldTypeView)

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

assetGroupAsset

object (AssetGroupAsset)

O recurso do grupo de recursos referenciado na consulta.

assetGroupSignal

object (AssetGroupSignal)

O indicador do grupo de recursos referenciado na consulta.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

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

assetGroupProductGroupView

object (AssetGroupProductGroupView)

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

assetGroup

object (AssetGroup)

O grupo de recursos referenciado na consulta.

assetSetAsset

object (AssetSetAsset)

O recurso do conjunto de recursos referenciado na consulta.

assetSet

object (AssetSet)

O conjunto de recursos referenciado na consulta.

assetSetTypeView

object (AssetSetTypeView)

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

batchJob

object (BatchJob)

Trabalho em lote mencionado na consulta.

biddingDataExclusion

object (BiddingDataExclusion)

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

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

O ajuste periódico dos lances mencionado na consulta.

biddingStrategy

object (BiddingStrategy)

Estratégia de lances mencionada na consulta.

biddingStrategySimulation

object (BiddingStrategySimulation)

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

billingSetup

object (BillingSetup)

A configuração de faturamento mencionada na consulta.

callView

object (CallView)

A visualização da chamada referenciada na consulta.

campaignBudget

object (CampaignBudget)

Orçamento da campanha mencionado na consulta.

campaign

object (Campaign)

A campanha mencionada na consulta.

campaignAsset

object (CampaignAsset)

O recurso da campanha mencionado na consulta.

campaignAssetSet

object (CampaignAssetSet)

O conjunto de recursos da campanha referenciado na consulta.

campaignAudienceView

object (CampaignAudienceView)

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

campaignBidModifier

object (CampaignBidModifier)

O modificador de lance da campanha mencionado na consulta.

campaignConversionGoal

object (CampaignConversionGoal)

A CampaignConversionGoal referenciada na consulta.

campaignCriterion

object (CampaignCriterion)

O critério de campanha indicado na consulta.

campaignCustomizer

object (CampaignCustomizer)

O personalizador de campanha mencionado na consulta.

campaignDraft

object (CampaignDraft)

O rascunho de campanha mencionado na consulta.

campaignExtensionSetting

object (CampaignExtensionSetting)

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

campaignFeed

object (CampaignFeed)

O feed de campanha mencionado na consulta.

campaignGroup

object (CampaignGroup)

Grupo de campanhas mencionado na consulta AWQL.

campaignLabel

object (CampaignLabel)

O rótulo da campanha mencionado na consulta.

campaignSearchTermInsight

object (CampaignSearchTermInsight)

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

campaignSharedSet

object (CampaignSharedSet)

Conjunto compartilhado da campanha mencionado na consulta AWQL.

campaignSimulation

object (CampaignSimulation)

Simulação de campanha mencionada na consulta.

carrierConstant

object (CarrierConstant)

A constante da operadora referenciada na consulta.

changeEvent

object (ChangeEvent)

O ChangeEvent indicado na consulta.

changeStatus

object (ChangeStatus)

ChangeStatus mencionado na consulta.

combinedAudience

object (CombinedAudience)

O CombineAudience mencionado na consulta.

audience

object (Audience)

O público-alvo mencionado na consulta.

conversionAction

object (ConversionAction)

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

conversionCustomVariable

object (ConversionCustomVariable)

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

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

A ConversionGoalCampaignConfig mencionada na consulta.

conversionValueRule

object (ConversionValueRule)

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

conversionValueRuleSet

object (ConversionValueRuleSet)

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

clickView

object (ClickView)

O ClickView mencionado na consulta.

currencyConstant

object (CurrencyConstant)

A constante de moeda referenciada na consulta.

customAudience

object (CustomAudience)

O CustomAudience referenciado na consulta.

customConversionGoal

object (CustomConversionGoal)

O CustomConversionGoal mencionado na consulta.

customInterest

object (CustomInterest)

O Custom Interest referenciado na consulta.

customer

object (Customer)

O cliente mencionado na consulta.

customerAsset

object (CustomerAsset)

O recurso do cliente mencionado na consulta.

customerAssetSet

object (CustomerAssetSet)

O conjunto de recursos do cliente mencionado na consulta.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

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

customerCustomizer

object (CustomerCustomizer)

O personalizador do cliente mencionado na consulta.

customerClient

object (CustomerClient)

O CustomerClient mencionado na consulta.

customerConversionGoal

object (CustomerConversionGoal)

O CustomerConversionGoal mencionado na consulta.

customerExtensionSetting

object (CustomerExtensionSetting)

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

customerFeed

object (CustomerFeed)

O feed de clientes mencionado na consulta.

customerLabel

object (CustomerLabel)

O rótulo do cliente mencionado na consulta.

customerNegativeCriterion

object (CustomerNegativeCriterion)

O critério negativo do cliente mencionado na consulta.

customerSearchTermInsight

object (CustomerSearchTermInsight)

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

customerUserAccess

object (CustomerUserAccess)

O CustomerUserAccess mencionado na consulta.

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

O CustomerUserAccessInvitation mencionado na consulta.

customizerAttribute

object (CustomizerAttribute)

O atributo do personalizador referenciado na consulta.

detailPlacementView

object (DetailPlacementView)

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

detailedDemographic

object (DetailedDemographic)

É o grupo demográfico detalhado mencionado na consulta.

displayKeywordView

object (DisplayKeywordView)

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

distanceView

object (DistanceView)

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

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

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

expandedLandingPageView

object (ExpandedLandingPageView)

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

extensionFeedItem

object (ExtensionFeedItem)

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

feed

object (Feed)

O feed mencionado na consulta.

feedItem

object (FeedItem)

O item do feed mencionado na consulta.

feedItemSet

object (FeedItemSet)

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

feedItemTarget

object (FeedItemTarget)

Destino do item de feed mencionado na consulta.

feedMapping

object (FeedMapping)

O mapeamento de feeds mencionado na consulta.

feedPlaceholderView

object (FeedPlaceholderView)

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

genderView

object (GenderView)

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

geoTargetConstant

object (GeoTargetConstant)

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

geographicView

object (GeographicView)

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

groupPlacementView

object (GroupPlacementView)

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

hotelGroupView

object (HotelGroupView)

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

hotelPerformanceView

object (HotelPerformanceView)

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

hotelReconciliation

object (HotelReconciliation)

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

incomeRangeView

object (IncomeRangeView)

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

keywordView

object (KeywordView)

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

keywordPlan

object (KeywordPlan)

Plano de palavras-chave mencionado na consulta.

keywordPlanCampaign

object (KeywordPlanCampaign)

Campanha do plano de palavras-chave mencionada na consulta.

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

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

keywordPlanAdGroup

object (KeywordPlanAdGroup)

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

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

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

keywordThemeConstant

object (KeywordThemeConstant)

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

label

object (Label)

O rótulo referenciado na consulta.

landingPageView

object (LandingPageView)

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

languageConstant

object (LanguageConstant)

A constante de linguagem referenciada na consulta.

locationView

object (LocationView)

A visualização do local referenciada na consulta.

managedPlacementView

object (ManagedPlacementView)

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

mediaFile

object (MediaFile)

O arquivo de mídia referenciado na consulta.

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

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

mobileDeviceConstant

object (MobileDeviceConstant)

A constante de dispositivo móvel referenciada na consulta.

offlineUserDataJob

object (OfflineUserDataJob)

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

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

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

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

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

qualifyingQuestion

object (QualifyingQuestion)

A pergunta de qualificação citada na consulta.

parentalStatusView

object (ParentalStatusView)

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

perStoreView

object (PerStoreView)

A visualização por loja referenciada na consulta.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

A categoria de lances do produto mencionada na consulta.

productGroupView

object (ProductGroupView)

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

recommendation

object (Recommendation)

Recomendação referenciada na consulta.

searchTermView

object (SearchTermView)

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

sharedCriterion

object (SharedCriterion)

O conjunto compartilhado referenciado na consulta.

sharedSet

object (SharedSet)

O conjunto compartilhado referenciado na consulta.

smartCampaignSetting

object (SmartCampaignSetting)

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

shoppingPerformanceView

object (ShoppingPerformanceView)

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

smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

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

topicView

object (TopicView)

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

travelActivityGroupView

object (TravelActivityGroupView)

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

travelActivityPerformanceView

object (TravelActivityPerformanceView)

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

experiment

object (Experiment)

O experimento mencionado na consulta.

experimentArm

object (ExperimentArm)

O grupo experimental mencionado na consulta.

userInterest

object (UserInterest)

O interesse do usuário referenciado na consulta.

lifeEvent

object (LifeEvent)

O evento importante referenciado na consulta.

userList

object (UserList)

A lista de usuários referenciada na consulta.

userLocationView

object (UserLocationView)

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

remarketingAction

object (RemarketingAction)

A ação de remarketing referenciada na consulta.

topicConstant

object (TopicConstant)

A constante de tópico referenciada na consulta.

video

object (Video)

Vídeo mencionado na consulta.

webpageView

object (WebpageView)

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

leadFormSubmissionData

object (LeadFormSubmissionData)

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

metrics

object (Metrics)

As métricas.

segments

object (Segments)

Os segmentos.

AccountBudget

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

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

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

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

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

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

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

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

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

string

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

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum (AccountBudgetStatus)

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

totalAdjustmentsMicros

string (int64 format)

Apenas saída. O valor total dos ajustes.

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

amountServedMicros

string (int64 format)

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

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

pendingProposal

object (PendingAccountBudgetProposal)

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

id

string (int64 format)

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

billingSetup

string

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

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

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

proposedStartDateTime

string

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

approvedStartDateTime

string

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

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

purchaseOrderNumber

string

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

notes

string

Apenas saída. Observações associadas ao orçamento.

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

string

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

proposedEndTimeType

enum (TimeType)

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

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

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

approvedEndDateTime

string

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

approvedEndTimeType

enum (TimeType)

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

Campo de união proposed_spending_limit. O limite de gastos proposto. proposed_spending_limit pode ser apenas de um dos tipos a seguir:
proposedSpendingLimitMicros

string (int64 format)

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

proposedSpendingLimitType

enum (SpendingLimitType)

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

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

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

approvedSpendingLimitMicros

string (int64 format)

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

approvedSpendingLimitType

enum (SpendingLimitType)

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

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

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

adjustedSpendingLimitMicros

string (int64 format)

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

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

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

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

adjustedSpendingLimitType

enum (SpendingLimitType)

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

AccountBudgetStatus

Os status possíveis de um AccountBudget.

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

PendingAccountBudgetProposal

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

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

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

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

enum (AccountBudgetProposalType)

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

accountBudgetProposal

string

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

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

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

startDateTime

string

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

purchaseOrderNumber

string

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

notes

string

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

creationDateTime

string

Apenas saída. A hora em que a proposta de orçamento no nível da conta foi criada. Formatado como aaaa-MM-dd HH:mm:ss.

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

string

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

endTimeType

enum (TimeType)

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

Campo de união spending_limit. O limite de gastos. spending_limit pode ser apenas de um dos tipos a seguir:
spendingLimitMicros

string (int64 format)

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

spendingLimitType

enum (SpendingLimitType)

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

AdGroupAdAssetCombinationView

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

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

string

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

servedAssets[]

object (AssetUsage)

Apenas saída. Recursos veiculados.

enabled

boolean

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

AssetUsage

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

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

string

Nome do recurso.

servedAssetFieldType

enum (ServedAssetFieldType)

O tipo de campo veiculado do recurso.

AdGroupAdAssetView

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

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

string

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

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

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

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

fieldType

enum (AssetFieldType)

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

policySummary

object (AdGroupAdAssetPolicySummary)

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

performanceLabel

enum (AssetPerformanceLabel)

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

pinnedField

enum (ServedAssetFieldType)

Apenas saída. Campo fixado.

adGroupAd

string

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

asset

string

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

enabled

boolean

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

AdGroupAdAssetPolicySummary

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

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

object (PolicyTopicEntry)

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

reviewStatus

enum (PolicyReviewStatus)

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

approvalStatus

enum (PolicyApprovalStatus)

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

AdGroupAudienceView

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

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

string

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

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

AdGroupCriterionSimulation

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

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

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

string

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

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

type

enum (SimulationType)

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

modificationMethod

enum (SimulationModificationMethod)

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

adGroupId

string (int64 format)

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

criterionId

string (int64 format)

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

startDate

string

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

endDate

string

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

Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
cpcBidPointList

object (CpcBidSimulationPointList)

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

percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

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

SimulationType

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

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

SimulationModificationMethod

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

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

CpcBidSimulationPointList

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

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

object (CpcBidSimulationPoint)

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

CpcBidSimulationPoint

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

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

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

string (int64 format)

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

biddableConversions

number

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

biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

topSlotImpressions

string (int64 format)

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

Campo de união cpc_simulation_key_value. Quando SimulationModifiedMethod = UNIFORM ou DEFAULT, cpc_bid_micros é definido. Quando SimulationModifiedMethod = SCALING, cpc_bid_scaling_modifier é definido. cpc_simulation_key_value pode ser apenas de um dos tipos a seguir:
cpcBidMicros

string (int64 format)

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

cpcBidScalingModifier

number

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

PercentCpcBidSimulationPointList

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

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

object (PercentCpcBidSimulationPoint)

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

PercentCpcBidSimulationPoint

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

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

string (int64 format)

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

biddableConversions

number

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

biddableConversionsValue

number

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

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

topSlotImpressions

string (int64 format)

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

AdGroupSimulation

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

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

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

string

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

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

type

enum (SimulationType)

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

modificationMethod

enum (SimulationModificationMethod)

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

adGroupId

string (int64 format)

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

startDate

string

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

endDate

string

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

Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
cpcBidPointList

object (CpcBidSimulationPointList)

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

cpvBidPointList

object (CpvBidSimulationPointList)

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

targetCpaPointList

object (TargetCpaSimulationPointList)

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

targetRoasPointList

object (TargetRoasSimulationPointList)

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

CpvBidSimulationPointList

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

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

object (CpvBidSimulationPoint)

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

CpvBidSimulationPoint

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

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

string (int64 format)

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

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

views

string (int64 format)

Número projetado de visualizações.

TargetCpaSimulationPointList

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

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

object (TargetCpaSimulationPoint)

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

TargetCpaSimulationPoint

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

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

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

string (int64 format)

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

appInstalls

number

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

inAppActions

number

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

biddableConversions

number

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

biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

topSlotImpressions

string (int64 format)

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

Campo de união target_cpa_simulation_key_value. Quando SimulationModifiedMethod = UNIFORM ou DEFAULT, target_cpa_micros é definido. Quando SimulationModificaçãoMethod = SCALING, target_cpa_scaling_modifier é definido. target_cpa_simulation_key_value pode ser apenas de um dos tipos a seguir:
targetCpaMicros

string (int64 format)

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

targetCpaScalingModifier

number

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

TargetRoasSimulationPointList

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

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

object (TargetRoasSimulationPoint)

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

TargetRoasSimulationPoint

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

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

string (int64 format)

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

targetRoas

number

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

biddableConversions

number

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

biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

topSlotImpressions

string (int64 format)

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

AgeRangeView

Uma visualização por faixa etária.

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

string

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

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

AdScheduleView

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

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

string

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

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

DomainCategory

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

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

string

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

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

campaign

string

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

category

string

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

languageCode

string

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

domain

string

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

coverageFraction

number

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

categoryRank

string (int64 format)

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

hasChildren

boolean

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

recommendedCpcBidMicros

string (int64 format)

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

AssetFieldTypeView

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

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

string

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

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum (AssetFieldType)

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

AssetGroupProductGroupView

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

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

string

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

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

assetGroup

string

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

assetGroupListingGroupFilter

string

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

AssetSetTypeView

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

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

string

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

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

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

BiddingStrategySimulation

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

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

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

string

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

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

biddingStrategyId

string (int64 format)

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

type

enum (SimulationType)

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

modificationMethod

enum (SimulationModificationMethod)

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

startDate

string

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

endDate

string

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

Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
targetCpaPointList

object (TargetCpaSimulationPointList)

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

targetRoasPointList

object (TargetRoasSimulationPointList)

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

CallView

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

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

string

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

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

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

callerAreaCode

string

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

callDurationSeconds

string (int64 format)

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

startCallDateTime

string

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

endCallDateTime

string

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

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

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

type

enum (CallType)

Apenas saída. O tipo da chamada.

callStatus

enum (GoogleVoiceCallStatus)

Apenas saída. Status da chamada.

CallTrackingDisplayLocation

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

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

CallType

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

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

GoogleVoiceCallStatus

Possíveis status de uma chamada do Google Voice.

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

CampaignAudienceView

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

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

string

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

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

CampaignSearchTermInsight

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

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

string

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

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

categoryLabel

string

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

id

string (int64 format)

Apenas saída. O ID do insight.

campaignId

string (int64 format)

Apenas saída. O ID da campanha.

CampaignSimulation

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

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

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

string

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

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

campaignId

string (int64 format)

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

type

enum (SimulationType)

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

modificationMethod

enum (SimulationModificationMethod)

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

startDate

string

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

endDate

string

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

Campo de união point_list. Lista de pontos de simulação. point_list pode ser apenas de um dos tipos a seguir:
cpcBidPointList

object (CpcBidSimulationPointList)

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

targetCpaPointList

object (TargetCpaSimulationPointList)

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

targetRoasPointList

object (TargetRoasSimulationPointList)

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

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

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

budgetPointList

object (BudgetSimulationPointList)

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

TargetImpressionShareSimulationPointList

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

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

object (TargetImpressionShareSimulationPoint)

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

TargetImpressionShareSimulationPoint

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

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

string (int64 format)

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

requiredCpcBidCeilingMicros

string (int64 format)

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

requiredBudgetAmountMicros

string (int64 format)

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

biddableConversions

number

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

biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

topSlotImpressions

string (int64 format)

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

absoluteTopImpressions

string (int64 format)

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

BudgetSimulationPointList

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

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

object (BudgetSimulationPoint)

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

BudgetSimulationPoint

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

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

string (int64 format)

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

requiredCpcBidCeilingMicros

string (int64 format)

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

biddableConversions

number

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

biddableConversionsValue

number

Valor total previsto das conversões que recebem lances.

clicks

string (int64 format)

Número projetado de cliques.

costMicros

string (int64 format)

Custo projetado em micros.

impressions

string (int64 format)

Número projetado de impressões.

topSlotImpressions

string (int64 format)

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

CarrierConstant

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

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

string

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

carrierConstants/{criterionId}

id

string (int64 format)

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

name

string

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

countryCode

string

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

ChangeEvent

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

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

string

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

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

changeDateTime

string

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

changeResourceType

enum (ChangeEventResourceType)

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

changeResourceName

string

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

clientType

enum (ChangeClientType)

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

userEmail

string

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

oldResource

object (ChangedResource)

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

newResource

object (ChangedResource)

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

resourceChangeOperation

enum (ResourceChangeOperation)

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

changedFields

string (FieldMask format)

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

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

campaign

string

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

adGroup

string

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

feed

string

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

feedItem

string

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

asset

string

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

ChangeEventResourceType

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

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

ChangeClientType

A origem do recurso changeEvent.

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

ChangedResource

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

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

object (Ad)

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

adGroup

object (AdGroup)

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

adGroupCriterion

object (AdGroupCriterion)

Apenas saída. Definido se changeResourceType == AD_GROUP_criteria

campaign

object (Campaign)

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

campaignBudget

object (CampaignBudget)

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

adGroupBidModifier

object (AdGroupBidModifier)

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

campaignCriterion

object (CampaignCriterion)

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

feed

object (Feed)

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

feedItem

object (FeedItem)

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

campaignFeed

object (CampaignFeed)

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

adGroupFeed

object (AdGroupFeed)

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

adGroupAd

object (AdGroupAd)

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

asset

object (Asset)

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

customerAsset

object (CustomerAsset)

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

campaignAsset

object (CampaignAsset)

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

adGroupAsset

object (AdGroupAsset)

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

assetSet

object (AssetSet)

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

assetSetAsset

object (AssetSetAsset)

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

campaignAssetSet

object (CampaignAssetSet)

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

ResourceChangeOperation

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

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

ChangeStatus

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

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

string

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

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum (ChangeStatusResourceType)

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

resourceStatus

enum (ChangeStatusOperation)

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

sharedSet

string

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

campaignSharedSet

string

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

asset

string

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

customerAsset

string

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

campaignAsset

string

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

adGroupAsset

string

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

combinedAudience

string

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

lastChangeDateTime

string

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

campaign

string

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

adGroup

string

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

adGroupAd

string

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

adGroupCriterion

string

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

campaignCriterion

string

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

feed

string

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

feedItem

string

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

adGroupFeed

string

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

campaignFeed

string

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

adGroupBidModifier

string

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

ChangeStatusResourceType

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

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

ChangeStatusOperation

Status do recurso alterado

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

CombinedAudience

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

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

string

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

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string (int64 format)

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

status

enum (CombinedAudienceStatus)

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

name

string

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

description

string

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

CombinedAudienceStatus

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

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

ClickView

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

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

string

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

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

areaOfInterest

object (ClickLocation)

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

locationOfPresence

object (ClickLocation)

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

keyword

string

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

keywordInfo

object (KeywordInfo)

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

gclid

string

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

pageNumber

string (int64 format)

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

adGroupAd

string

Apenas saída. O anúncio associado.

campaignLocationTarget

string

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

userList

string

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

ClickLocation

Critérios de local associados a um clique.

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

string

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

country

string

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

metro

string

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

mostSpecific

string

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

region

string

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

CurrencyConstant

Uma constante de moeda.

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

string

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

currencyConstants/{code}

code

string

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

name

string

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

symbol

string

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

billableUnitMicros

string (int64 format)

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

AccessibleBiddingStrategy

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

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

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

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

string

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

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

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

name

string

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

type

enum (BiddingStrategyType)

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

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

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

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

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

CustomerClient

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

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

string

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

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

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

clientCustomer

string

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

hidden

boolean

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

level

string (int64 format)

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

timeZone

string

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

testAccount

boolean

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

manager

boolean

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

descriptiveName

string

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

currencyCode

string

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

id

string (int64 format)

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

CustomerSearchTermInsight

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

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

string

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

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

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

id

string (int64 format)

Apenas saída. O ID do insight.

DetailPlacementView

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

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

string

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

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

placementType

enum (PlacementType)

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

placement

string

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

displayName

string

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

groupPlacementTargetUrl

string

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

targetUrl

string

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

PlacementType

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

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

DetailedDemographic

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

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

string

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

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string (int64 format)

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

name

string

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

parent

string

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

launchedToAll

boolean

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

availabilities[]

object (CriterionCategoryAvailability)

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

CriterionCategoryAvailability

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

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

object (CriterionCategoryChannelAvailability)

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

locale[]

object (CriterionCategoryLocaleAvailability)

Localidades disponíveis para a categoria do canal.

CriterionCategoryChannelAvailability

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

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

enum (CriterionCategoryChannelAvailabilityMode)

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

advertisingChannelType

enum (AdvertisingChannelType)

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

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

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

includeDefaultChannelSubType

boolean

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

CriterionCategoryChannelAvailabilityMode

Enumeração contendo o possível CriteriaCategoryChannelAvailabilityMode.

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

CriterionCategoryLocaleAvailability

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

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

enum (CriterionCategoryLocaleAvailabilityMode)

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

countryCode

string

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

languageCode

string

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

CriterionCategoryLocaleAvailabilityMode

Enumeração contendo o possível LatLngCategoryLocaleAvailabilityMode.

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

DisplayKeywordView

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

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

string

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

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

DistanceView

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

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

string

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

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

distanceBucket

enum (DistanceBucket)

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

metricSystem

boolean

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

DistanceBucket

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

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

DynamicSearchAdsSearchTermView

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

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

string

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

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

searchTerm

string

Apenas saída. Termo de pesquisa

Este campo é somente leitura.

headline

string

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

Este campo é somente leitura.

landingPage

string

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

Este campo é somente leitura.

pageUrl

string

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

Este campo é somente leitura.

hasNegativeKeyword

boolean

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

Este campo é somente leitura.

hasMatchingKeyword

boolean

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

Este campo é somente leitura.

hasNegativeUrl

boolean

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

Este campo é somente leitura.

ExpandedLandingPageView

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

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

string

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

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expandedFinalUrl

string

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

FeedPlaceholderView

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

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

string

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

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum (PlaceholderType)

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

GenderView

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

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

string

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

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

GeographicView

Uma visualização geográfica.

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

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

string

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

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

locationType

enum (GeoTargetingType)

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

countryCriterionId

string (int64 format)

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

GeoTargetingType

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

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

GroupPlacementView

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

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

string

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

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

placementType

enum (PlacementType)

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

placement

string

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

displayName

string

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

targetUrl

string

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

HotelGroupView

Visualização do grupo de hotéis.

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

string

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

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

HotelPerformanceView

Uma visão do desempenho de um hotel.

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

string

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

customers/{customerId}/hotelPerformanceView

HotelReconciliation

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

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

string

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

customers/{customerId}/hotelReconciliations/{commissionId}

commissionId

string

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

orderId

string

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

campaign

string

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

hotelCenterId

string (int64 format)

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

hotelId

string

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

checkInDate

string

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

checkOutDate

string

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

reconciledValueMicros

string (int64 format)

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

billed

boolean

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

status

enum (HotelReconciliationStatus)

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

HotelReconciliationStatus

Status da reconciliação de reserva do hotel.

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

IncomeRangeView

Uma visualização da faixa de renda.

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

string

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

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

KeywordView

Uma visualização de palavras-chave.

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

string

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

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

LandingPageView

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

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

string

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

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}

unexpandedFinalUrl

string

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

LanguageConstant

Um idioma.

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

string

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

languageConstants/{criterionId}

id

string (int64 format)

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

code

string

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

name

string

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

targetable

boolean

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

LocationView

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

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

string

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

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

ManagedPlacementView

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

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

string

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

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

MobileAppCategoryConstant

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

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

string

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

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

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

name

string

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

MobileDeviceConstant

Uma constante de dispositivo móvel.

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

string

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

mobileDeviceConstants/{criterionId}

type

enum (MobileDeviceType)

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

id

string (int64 format)

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

name

string

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

manufacturerName

string

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

operatingSystemName

string

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

MobileDeviceType

O tipo de dispositivo móvel.

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

OperatingSystemVersionConstant

Uma versão do sistema operacional para dispositivos móveis ou um intervalo de versões, dependendo de operatorType. Lista de plataformas móveis disponíveis em https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

Representação JSON
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de versão do sistema operacional. Os nomes dos recursos constantes da versão do sistema operacional têm o seguinte formato:

operatingSystemVersionConstants/{criterionId}

operatorType

enum (OperatingSystemVersionOperatorType)

Apenas saída. Determina se esta constante representa uma única versão ou um intervalo de versões.

id

string (int64 format)

Apenas saída. O ID da versão do sistema operacional.

name

string

Apenas saída. Nome do sistema operacional.

osMajorVersion

integer

Apenas saída. O número da versão principal do SO.

osMinorVersion

integer

Apenas saída. O número da versão secundária do SO.

OperatingSystemVersionOperatorType

O tipo de versão do sistema operacional.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EQUALS_TO Igual à versão especificada.
GREATER_THAN_EQUALS_TO Maior ou igual à versão especificada.

PaidOrganicSearchTermView

Uma visualização de termo de pesquisa orgânica paga que fornece uma visão das estatísticas de pesquisa em anúncios e listagens orgânicas agregadas por termo de pesquisa no nível do grupo de anúncios.

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

string

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

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}

searchTerm

string

Apenas saída. O termo da pesquisa.

QualifyingQuestion

Perguntas de qualificação para o formulário de lead.

Representação JSON
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da pergunta de qualificação.

'QualifyingQuestions/{qualifiedingQuestionId}"

qualifyingQuestionId

string (int64 format)

Apenas saída. O ID da pergunta de qualificação.

locale

string

Apenas saída. O local da pergunta de qualificação.

text

string

Apenas saída. A pergunta de qualificação.

ParentalStatusView

Uma visualização do status parental.

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

string

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

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

PerStoreView

Uma visualização por loja. Essa visualização mostra estatísticas de conversão de ações locais e o alcance de impressões por loja para os anunciantes.

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

string

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

customers/{customerId}/perStoreViews/{placeId}

placeId

string

Apenas saída. O ID do lugar da visualização por loja.

ProductBiddingCategoryConstant

Uma categoria de lances de produtos.

Representação JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Campos
resourceName

string

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

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Apenas saída. Nível da categoria de lances do produto.

status

enum (ProductBiddingCategoryStatus)

Apenas saída. Status da categoria de lances do produto.

id

string (int64 format)

Apenas saída. ID da categoria de lances do produto.

Ele é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436.

countryCode

string

Apenas saída. Código do país com duas letras maiúsculas da categoria de lances do produto.

productBiddingCategoryConstantParent

string

Apenas saída. Nome do recurso da categoria de lances do produto pai.

languageCode

string

Apenas saída. Código do idioma da categoria de lances do produto.

localizedName

string

Apenas saída. Valor de exibição da categoria de lances do produto localizado de acordo com languageCode.

ProductBiddingCategoryStatus

Enumeração que descreve o status da categoria de lances do produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ACTIVE A categoria está ativa e pode ser usada para lances.
OBSOLETE A categoria está obsoleta. Usado apenas para fins de relatório.

ProductGroupView

Uma visualização do grupo de produtos.

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

string

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

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

Recomendação

Uma recomendação.

Representação JSON
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
Campos
resourceName

string

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

customers/{customerId}/recommendations/{recommendation_id}

type

enum (RecommendationType)

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

impact

object (RecommendationImpact)

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

campaigns[]

string

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

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

campaignBudget

string

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

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

campaign

string

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

O campo será definido para os seguintes tipos de recomendações: CALL_EXTENSION_EXT.NAME, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, IDENTIFIER_BROAD_MATCH_KEYWORDS, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_

adGroup

string

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

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

dismissed

boolean

Apenas saída. Indica se a recomendação foi dispensada ou não.

Campo de união recommendation. Os detalhes da recomendação. recommendation pode ser apenas de um dos tipos a seguir:
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

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

forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

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

keywordRecommendation

object (KeywordRecommendation)

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

textAdRecommendation

object (TextAdRecommendation)

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

targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

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

maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

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

enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

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

searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

Apenas saída. A recomendação para ativar os parceiros de pesquisa.

maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

Apenas saída. A recomendação de ativação "MaximizarClicks".

optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

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

keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

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

moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

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

targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

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

responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

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

marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Apenas saída. A recomendação de orçamento da campanha com ROI mínimo.

useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

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

responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

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

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

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

responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

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

displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

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

upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

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

raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

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

forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Apenas saída. A recomendação de ROAS desejado definido pela estimativa.

calloutAssetRecommendation

object (CalloutAssetRecommendation)

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

callAssetRecommendation

object (CallAssetRecommendation)

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

shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

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

shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

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

shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

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

shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

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

shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

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

shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

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

shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

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

shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

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

shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

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

shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

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

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

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

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

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

dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

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

raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

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

lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

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

performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

Apenas saída. A recomendação de ativação das campanhas Performance Max.

improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

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

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

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

RecommendationType

Tipos de recomendações.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CAMPAIGN_BUDGET Recomendação de orçamento para campanhas que estão atualmente limitadas pelo orçamento (ao contrário da recomendação FORECASTING_CAMPAIGN_BUDGET, que se aplica a campanhas que provavelmente ficarão limitadas pelo orçamento no futuro).
KEYWORD Recomendação de palavra-chave.
TEXT_AD Recomendação para adicionar um novo anúncio de texto.
TARGET_CPA_OPT_IN Recomendação para atualizar uma campanha para usar uma estratégia de lances de CPA desejado.
MAXIMIZE_CONVERSIONS_OPT_IN Recomendação para atualizar uma campanha para usar a estratégia de lances "Maximizar conversões".
ENHANCED_CPC_OPT_IN Recomendação para ativar o custo por clique otimizado para uma campanha.
SEARCH_PARTNERS_OPT_IN Recomendação para começar a exibir os anúncios da sua campanha nos sites dos parceiros de pesquisa do Google.
MAXIMIZE_CLICKS_OPT_IN Recomendação para atualizar uma campanha para usar uma estratégia de lances "Maximizar cliques".
OPTIMIZE_AD_ROTATION É recomendável começar a usar a configuração de rotação de anúncios "Otimizar" no grupo de anúncios.
KEYWORD_MATCH_TYPE Recomendação para mudar uma palavra-chave existente de um tipo de correspondência para um mais amplo.
MOVE_UNUSED_BUDGET Recomendação para transferir o orçamento não utilizado de um orçamento para um limitado.
FORECASTING_CAMPAIGN_BUDGET Recomendação de orçamento para campanhas que provavelmente serão limitadas pelo orçamento no futuro, em vez da recomendação CAMPAIGN_BUDGET, que se aplica a campanhas atualmente limitadas pelo orçamento.
TARGET_ROAS_OPT_IN Recomendação para atualizar uma campanha para usar uma estratégia de lances de ROAS desejado.
RESPONSIVE_SEARCH_AD Recomendação para adicionar um novo anúncio responsivo de pesquisa.
MARGINAL_ROI_CAMPAIGN_BUDGET Recomendação de orçamento para campanhas com previsão de aumento do ROI com um ajuste de orçamento.
USE_BROAD_MATCH_KEYWORD Recomendação para adicionar versões de correspondência ampla de palavras-chave a campanhas de lances com base em conversões totalmente automatizadas.
RESPONSIVE_SEARCH_AD_ASSET Recomendação para adicionar novos recursos de anúncios responsivos de pesquisa.
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX Recomendação para fazer upgrade de uma campanha inteligente do Shopping para uma campanha Performance Max.
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH Recomendação para melhorar a qualidade do anúncio responsivo de pesquisa.
DISPLAY_EXPANSION_OPT_IN Recomendação para atualizar uma campanha para usar a Inclusão da Rede de Display.
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX Recomendação para fazer upgrade de uma campanha local para uma campanha Performance Max.
RAISE_TARGET_CPA_BID_TOO_LOW É recomendável aumentar o CPA desejado quando ele estiver muito baixo e houver poucas ou nenhuma conversão. Ela é aplicada de forma assíncrona e pode levar minutos, dependendo do número de grupos de anúncios existentes na campanha relacionada.
FORECASTING_SET_TARGET_ROAS Recomendação para aumentar o orçamento antes de um evento sazonal com previsão de aumento do tráfego e mudar a estratégia de lances de "Maximizar o valor da conversão" para ROAS desejado.
CALLOUT_ASSET É recomendável adicionar recursos de frase de destaque ao nível da campanha ou do cliente.
CALL_ASSET Recomendação para adicionar recursos de ligação ao nível da campanha ou do cliente.
SHOPPING_ADD_AGE_GROUP É recomendável adicionar o atributo de idade às ofertas que são rebaixadas devido à ausência de uma idade.
SHOPPING_ADD_COLOR É recomendável adicionar uma cor às ofertas rebaixadas devido à ausência de uma cor.
SHOPPING_ADD_GENDER É recomendável adicionar um gênero às ofertas que são rebaixadas devido à ausência do gênero.
SHOPPING_ADD_GTIN É recomendável adicionar um Número global do item comercial (GTIN) às ofertas rebaixadas devido à ausência de um GTIN.
SHOPPING_ADD_MORE_IDENTIFIERS É recomendável adicionar mais identificadores às ofertas rebaixadas devido à ausência de identificadores.
SHOPPING_ADD_SIZE É recomendável adicionar o tamanho às ofertas rebaixadas devido à ausência desse tamanho.
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN Recomendação para informar um cliente sobre uma campanha que não pode ser veiculada porque nenhum produto está sendo segmentado.
SHOPPING_FIX_DISAPPROVED_PRODUCTS A recomendação de compras que informa um cliente sobre uma campanha com uma alta porcentagem de produtos reprovados.
SHOPPING_TARGET_ALL_OFFERS É recomendável criar uma campanha abrangente que segmente todas as ofertas.
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT Recomendação para corrigir problemas de suspensão de conta do Merchant Center.
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING Recomendação para corrigir problemas de aviso de suspensão da conta do Merchant Center.
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX É recomendável migrar as ofertas segmentadas pelas campanhas padrão do Shopping para campanhas Performance Max.
DYNAMIC_IMAGE_EXTENSION_OPT_IN Recomendação para ativar as extensões de imagem dinâmicas na conta. Assim, o Google encontra as melhores imagens nas páginas de destino dos anúncios e complementa os anúncios de texto.
RAISE_TARGET_CPA Recomendação para aumentar o CPA desejado com base nas previsões do Google baseadas em conversões anteriores. Ela é aplicada de forma assíncrona e pode levar minutos, dependendo do número de grupos de anúncios existentes na campanha relacionada.
LOWER_TARGET_ROAS Recomendação para diminuir o ROAS desejado.
PERFORMANCE_MAX_OPT_IN Recomendação para ativar as campanhas Performance Max.
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH Recomendação para melhorar a qualidade do grupo de recursos de uma campanha Performance Max para uma classificação "Excelente".
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX Recomendação para migrar os anúncios dinâmicos de pesquisa para campanhas Performance Max.

RecommendationImpact

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

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

object (RecommendationMetrics)

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

potentialMetrics

object (RecommendationMetrics)

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

RecommendationMetrics

Métricas de desempenho semanais da conta. Para alguns tipos de recomendações, a média é calculada com base no período dos últimos 90 dias e, portanto, pode ser fracionária.

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

number

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

clicks

number

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

costMicros

string (int64 format)

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

conversions

number

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

videoViews

number

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

CampaignBudgetRecommendation

Recomendação de orçamento para campanhas limitadas pelo orçamento.

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

object (CampaignBudgetRecommendationOption)

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

currentBudgetAmountMicros

string (int64 format)

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

recommendedBudgetAmountMicros

string (int64 format)

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

CampaignBudgetRecommendationOption

Estimativas de impacto para um determinado valor de orçamento.

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

object (RecommendationImpact)

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

budgetAmountMicros

string (int64 format)

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

KeywordRecommendation

A recomendação da palavra-chave.

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

object (KeywordInfo)

Apenas saída. A palavra-chave recomendada.

searchTerms[]

object (SearchTerm)

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

recommendedCpcBidMicros

string (int64 format)

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

SearchTerm

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

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

string

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

estimatedWeeklySearchCount

string (int64 format)

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

TextAdRecommendation

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

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

object (Ad)

Apenas saída. Anúncio recomendado.

creationDate

string

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

autoApplyDate

string

Apenas saída. A data (se presente) será a data mais próxima em que a recomendação será aplicada automaticamente. no formato AAAA-MM-DD, por exemplo, 2018-04-17.

TargetCpaOptInRecommendation

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

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

object (TargetCpaOptInRecommendationOption)

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

recommendedTargetCpaMicros

string (int64 format)

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

TargetCpaOptInRecommendationOption

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

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

enum (TargetCpaOptInRecommendationGoal)

Apenas saída. O objetivo alcançado com essa opção.

impact

object (RecommendationImpact)

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

targetCpaMicros

string (int64 format)

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

requiredCampaignBudgetAmountMicros

string (int64 format)

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

TargetCpaOptInRecommendationGoal

Meta da recomendação TargetCpaOptIn.

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

MaximizeConversionsOptInRecommendation

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

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

string (int64 format)

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

EnhancedCpcOptInRecommendation

Esse tipo não tem campos.

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

SearchPartnersOptInRecommendation

Esse tipo não tem campos.

A recomendação para ativar os parceiros de pesquisa.

MaximizeClicksOptInRecommendation

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

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

string (int64 format)

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

OptimizeAdRotationRecommendation

Esse tipo não tem campos.

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

KeywordMatchTypeRecommendation

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

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

object (KeywordInfo)

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

recommendedMatchType

enum (KeywordMatchType)

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

MoveUnusedBudgetRecommendation

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

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

object (CampaignBudgetRecommendation)

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

excessCampaignBudget

string

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

TargetRoasOptInRecommendation

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

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

number

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

requiredCampaignBudgetAmountMicros

string (int64 format)

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

ResponsiveSearchAdRecommendation

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

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

object (Ad)

Apenas saída. Anúncio recomendado.

UseBroadMatchKeywordRecommendation

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

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

object (KeywordInfo)

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

suggestedKeywordsCount

string (int64 format)

Apenas saída. Número total de palavras-chave a serem expandidas para correspondência ampla na campanha.

campaignKeywordsCount

string (int64 format)

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

campaignUsesSharedBudget

boolean

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

requiredCampaignBudgetAmountMicros

string (int64 format)

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

ResponsiveSearchAdAssetRecommendation

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

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

object (Ad)

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

recommendedAssets

object (Ad)

Apenas saída. Os recursos recomendados. Só é preenchido com os novos títulos e/ou descrições. Caso contrário, fica vazio.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

Fazer upgrade de uma campanha inteligente do Shopping para uma recomendação de campanha Performance Max

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

string (int64 format)

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

salesCountryCode

string

Apenas saída. O país em que os produtos do inventário do comerciante precisam ser incluídos.

ResponsiveSearchAdImproveAdStrengthRecommendation

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

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

object (Ad)

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

recommendedAd

object (Ad)

Apenas saída. O anúncio atualizado.

DisplayExpansionOptInRecommendation

Esse tipo não tem campos.

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

UpgradeLocalCampaignToPerformanceMaxRecommendation

Esse tipo não tem campos.

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

RaiseTargetCpaBidTooLowRecommendation

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

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

number

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

averageTargetCpaMicros

string (int64 format)

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

ForecastingSetTargetRoasRecommendation

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

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

number

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

campaignBudget

object (CampaignBudget)

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

CampaignBudget

Um orçamento de campanha compartilhado entre vários tipos de recomendações de orçamento.

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

string (int64 format)

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

recommendedNewAmountMicros

string (int64 format)

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

newStartDate

string

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

CalloutAssetRecommendation

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

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

object (Asset)

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

recommendedCustomerCalloutAssets[]

object (Asset)

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

SitelinkAssetRecommendation

A recomendação do recurso de sitelink.

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

CallAssetRecommendation

Esse tipo não tem campos.

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

ShoppingOfferAttributeRecommendation

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

Representação JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Os detalhes da conta do Merchant Center.

feedLabel

string

Apenas saída. O rótulo do feed da campanha.

offersCount

string (int64 format)

Apenas saída. O número de ofertas on-line que podem ser veiculadas.

demotedOffersCount

string (int64 format)

Apenas saída. O número de ofertas on-line que podem ser veiculadas que são rebaixadas devido a atributos ausentes. Acesse o Merchant Center para saber mais.

MerchantInfo

Os detalhes da conta do Merchant Center.

Representação JSON
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
Campos
id

string (int64 format)

Apenas saída. O ID da conta do Merchant Center.

name

string

Apenas saída. O nome da conta do Merchant Center.

multiClient

boolean

Apenas saída. Se a conta do Merchant Center é de múltiplos clientes (MCA).

ShoppingAddProductsToCampaignRecommendation

A recomendação de compras para adicionar produtos a um inventário da campanha do Shopping.

Representação JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Os detalhes da conta do Merchant Center.

feedLabel

string

Apenas saída. O rótulo do feed da campanha.

reason

enum (Reason)

Apenas saída. O motivo pelo qual nenhum produto está anexado à campanha.

Motivo

Problemas que resultam em uma campanha do Shopping que segmenta nenhum produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS A conta do Merchant Center não tem produtos enviados.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED A conta do Merchant Center não tem produtos enviados no feed.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN A conta do Google Ads tem filtros de campanha ativos que impedem a inclusão de ofertas na campanha.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN Todos os produtos disponíveis foram explicitamente excluídos da segmentação pela campanha.

ShoppingFixDisapprovedProductsRecommendation

A recomendação do Shopping para corrigir produtos reprovados em um inventário da campanha do Shopping.

Representação JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Os detalhes da conta do Merchant Center.

feedLabel

string

Apenas saída. O rótulo do feed da campanha.

productsCount

string (int64 format)

Apenas saída. Número de produtos da campanha.

disapprovedProductsCount

string (int64 format)

Apenas saída. Número de produtos da campanha que foram reprovados.

ShoppingTargetAllOffersRecommendation

A recomendação do Shopping para criar uma campanha abrangente que segmente todas as ofertas.

Representação JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Os detalhes da conta do Merchant Center.

untargetedOffersCount

string (int64 format)

Apenas saída. O número de ofertas não segmentadas.

feedLabel

string

Apenas saída. O rótulo do feed de ofertas.

ShoppingMerchantCenterAccountSuspensionRecommendation

A recomendação de compras para corrigir problemas de suspensão da conta do Merchant Center.

Representação JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Os detalhes da conta do Merchant Center.

feedLabel

string

Apenas saída. O rótulo do feed da campanha que resultou na suspensão.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

A recomendação do Shopping para migrar ofertas segmentadas de campanhas padrão do Shopping para campanhas Performance Max.

Representação JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Campos
merchant

object (MerchantInfo)

Apenas saída. Os detalhes da conta do Merchant Center.

feedLabel

string

Apenas saída. O rótulo do feed das ofertas segmentadas pelas campanhas que compartilham essa sugestão.

DynamicImageExtensionOptInRecommendation

Esse tipo não tem campos.

Recomendação para ativar as extensões de imagem dinâmicas na conta. Assim, o Google encontra as melhores imagens nas páginas de destino dos anúncios e complementa os anúncios de texto.

RaiseTargetCpaRecommendation

Recomendação para aumentar o CPA desejado.

Representação JSON
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Campos
targetAdjustment

object (TargetAdjustmentInfo)

Apenas saída. Informações relevantes que descrevem o ajuste de meta recomendado.

appBiddingGoal

enum (AppBiddingGoal)

Apenas saída. Representa a meta que a estratégia de lances precisa otimizar. Só é preenchido em campanhas para apps.

TargetAdjustmentInfo

Informações de uma recomendação de ajuste do valor desejado.

Representação JSON
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Campos
recommendedTargetMultiplier

number

Apenas saída. O fator pelo qual recomendamos o ajuste da meta.

currentAverageTargetMicros

string (int64 format)

Apenas saída. A meta média atual da campanha ou do portfólio segmentada por essa recomendação.

sharedSet

string

Apenas saída. O nome do recurso do conjunto compartilhado da estratégia de lances de portfólio em que a meta está definida. Preenchido apenas se a recomendação estiver no nível do portfólio.

AppBiddingGoal

Representa a meta que precisa ser otimizada pela estratégia de lances de uma campanha para apps.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa o valor desconhecido nesta versão da API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME A estratégia de lances da campanha para apps deve ter como objetivo maximizar a instalação do aplicativo.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME A estratégia de lances da campanha para apps precisa ter como objetivo maximizar o volume selecionado de conversões no aplicativo.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE A estratégia de lances da campanha para apps precisa ter como objetivo maximizar o valor de todas as conversões, ou seja, conversões de instalação e seleção no aplicativo.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION A estratégia de lances da campanha para apps precisa ter como objetivo maximizar apenas o volume selecionado da conversão no aplicativo, além de alcançar ou ultrapassar o custo desejado por conversão.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND A estratégia de lances da campanha para apps precisa ter como objetivo maximizar o valor de todas as conversões, ou seja, gerar instalações e conversões selecionadas no aplicativo, além de alcançar ou ultrapassar o retorno do investimento em publicidade desejado.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI Essa estratégia de lances da campanha para apps deve ter como objetivo maximizar a instalação do aplicativo sem o custo por instalação desejado fornecido pelo anunciante.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME Essa estratégia de lances da campanha para apps precisa ter como objetivo maximizar o pré-registro do aplicativo.

LowerTargetRoasRecommendation

Recomendação para diminuir o ROAS desejado.

Representação JSON
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Campos
targetAdjustment

object (TargetAdjustmentInfo)

Apenas saída. Informações relevantes que descrevem o ajuste de meta recomendado.

PerformanceMaxOptInRecommendation

Esse tipo não tem campos.

A recomendação de ativação das campanhas Performance Max.

ImprovePerformanceMaxAdStrengthRecommendation

Recomendação para melhorar a qualidade do grupo de recursos de uma campanha Performance Max para uma classificação "Excelente".

Representação JSON
{
  "assetGroup": string
}
Campos
assetGroup

string

Apenas saída. O nome do recurso do grupo de recursos.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

A recomendação de migração dos anúncios dinâmicos de pesquisa para as campanhas Performance Max.

Representação JSON
{
  "applyLink": string
}
Campos

SearchTermView

Uma visualização do termo de pesquisa com métricas agregadas por termo de pesquisa no nível do grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do termo de pesquisa. Os nomes dos recursos de visualização de termos de pesquisa têm o seguinte formato:

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}

status

enum (SearchTermTargetingStatus)

Apenas saída. Indica se o termo de pesquisa é atualmente uma das suas palavras-chave segmentadas ou excluídas.

searchTerm

string

Apenas saída. O termo da pesquisa.

adGroup

string

Apenas saída. O grupo de anúncios em que o termo de pesquisa foi veiculado.

SearchTermTargetingStatus

Indica se o termo de pesquisa é uma das suas palavras-chave segmentadas ou excluídas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ADDED O termo de pesquisa foi adicionado às palavras-chave segmentadas.
EXCLUDED O termo de pesquisa corresponde a uma palavra-chave negativa.
ADDED_EXCLUDED O termo de pesquisa foi adicionado e excluído.
NONE O termo de pesquisa não está segmentado nem excluído.

ShoppingPerformanceView

Visualização de desempenho do Google Shopping. Oferece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores das dimensões de produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, vão refletir o estado de cada dimensão a partir da data e hora em que o evento correspondente foi registrado.

Representação JSON
{
  "resourceName": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de desempenho do Google Shopping. Os nomes dos recursos de visualização de desempenho do Shopping têm o seguinte formato: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

Visualização do termo de pesquisa da campanha inteligente.

Representação JSON
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do termo de pesquisa da campanha inteligente. Os nomes dos recursos de visualização de termos de pesquisa das campanhas inteligentes têm a seguinte forma:

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}

searchTerm

string

Apenas saída. O termo da pesquisa.

campaign

string

Apenas saída. A campanha inteligente em que o termo de pesquisa foi veiculado.

TopicView

Uma visualização de tópicos.

Representação JSON
{
  "resourceName": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do tópico. Os nomes dos recursos de visualização de tópicos têm o seguinte formato:

customers/{customerId}/topicViews/{adGroupId}~{criterionId}

TravelActivityGroupView

Visualização do grupo de atividades de viagem.

Representação JSON
{
  "resourceName": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do grupo de atividades de viagem. Os nomes dos recursos de visualização do grupo de atividades de viagem têm o seguinte formato:

customers/{customerId}/travelActivityGroupViews/{adGroupId}~{criterionId}

TravelActivityPerformanceView

Uma visualização do desempenho de atividades de viagem.

Representação JSON
{
  "resourceName": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização de desempenho da atividade de viagem. Os nomes dos recursos de visualização de desempenho da atividade de viagem têm o seguinte formato:

customers/{customerId}/travelActivityPerformanceView

UserInterest

Um interesse do usuário: um segmento específico com base em interesses a ser segmentado.

Representação JSON
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso do interesse do usuário. Os nomes dos recursos de interesse do usuário têm o seguinte formato:

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum (UserInterestTaxonomyType)

Apenas saída. Tipo de taxonomia do interesse do usuário.

availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade do interesse do usuário.

userInterestId

string (int64 format)

Apenas saída. O ID do interesse do usuário.

name

string

Apenas saída. O nome do interesse do usuário.

userInterestParent

string

Apenas saída. O pai do interesse do usuário.

launchedToAll

boolean

Apenas saída. Verdadeiro se o interesse do usuário tiver sido lançado em todos os canais e localidades.

UserInterestTaxonomyType

Enumeração contendo os possíveis User InterestTaxonomyTypes.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
AFFINITY A afinidade desse interesse do usuário.
IN_MARKET O mercado desse interesse do usuário.
MOBILE_APP_INSTALL_USER Usuários conhecidos por instalarem aplicativos nas categorias especificadas.
VERTICAL_GEO A localização geográfica da indústria com base em interesses.
NEW_SMART_PHONE_USER Critérios de interesse do usuário para novos usuários de smartphones.

LifeEvent

Um evento importante: uma indústria específica com base em interesses a ser segmentada para alcançar usuários quando eles estiverem passando por marcos importantes da vida.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Campos
resourceName

string

Apenas saída. O nome do recurso do evento importante. Os nomes dos recursos de eventos importantes têm o seguinte formato:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

Apenas saída. O ID do evento importante.

name

string

Apenas saída. O nome do evento importante, por exemplo,"Mudou recentemente".

parent

string

Apenas saída. O pai de lifeEvent.

launchedToAll

boolean

Apenas saída. Verdadeiro se o evento importante foi lançado para todos os canais e locais.

availabilities[]

object (CriterionCategoryAvailability)

Apenas saída. Informações de disponibilidade do evento importante.

UserLocationView

Uma visualização do local do usuário.

A visualização do local do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele informa métricas da localização física real do usuário por região de segmentação ou não. Se outros campos de segmento forem utilizados, você poderá obter mais de uma linha por país.

Representação JSON
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização do local do usuário. Os nomes dos recursos de visualização UserLocation têm o seguinte formato:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

Apenas saída. ID do critério do país.

targetingLocation

boolean

Apenas saída. Indica se o local foi segmentado ou não.

TopicConstant

Use tópicos para segmentar ou excluir canais na Rede de Display do Google com base na categoria em que o canal se enquadra (por exemplo, "Animais de estimação e animais/Animais de estimação/Cães").

Representação JSON
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da constante de tópico. Esses nomes têm o seguinte formato:

topicConstants/{topic_id}

path[]

string

Apenas saída. A categoria a ser segmentada ou excluída. Cada elemento subsequente na matriz descreve uma subcategoria mais específica. Por exemplo, {"Pets & Animals", "Pets", "Dogs"} representa a categoria "Animais de estimação e animais/Animais de estimação/Cães". Lista de categorias de tópicos disponíveis em https://developers.google.com/google-ads/api/reference/data/verticals

id

string (int64 format)

Apenas saída. O ID do tópico.

topicConstantParent

string

Apenas saída. Nome do recurso do pai da constante de tópico.

Video

Um vídeo.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso do vídeo. Os nomes dos recursos de vídeo têm o seguinte formato:

customers/{customerId}/videos/{videoId}

id

string

Apenas saída. O ID do vídeo.

channelId

string

Apenas saída. O ID do canal do proprietário do vídeo.

durationMillis

string (int64 format)

Apenas saída. A duração do vídeo em milissegundos.

title

string

Apenas saída. É o título do vídeo.

WebpageView

Uma visualização de página da Web.

Representação JSON
{
  "resourceName": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso da visualização da página da Web. Os nomes dos recursos de visualização de página da Web têm o seguinte formato:

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

LeadFormSubmissionData

Dados dos envios de formulário de lead.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
Campos
resourceName

string

Apenas saída. O nome do recurso dos dados de envio do formulário de lead. Os nomes dos recursos de dados de envio de formulário de lead têm o seguinte formato:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

Apenas saída. É o ID deste envio do formulário de lead.

asset

string

Apenas saída. Recurso associado ao formulário de lead enviado.

campaign

string

Apenas saída. Campanha associada ao formulário de lead enviado.

leadFormSubmissionFields[]

object (LeadFormSubmissionField)

Apenas saída. Dados de envio associados a um formulário de lead.

customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

Apenas saída. Dados de envio associados a um formulário de lead personalizado.

adGroup

string

Apenas saída. Grupo de anúncios associado ao formulário de lead enviado.

adGroupAd

string

Apenas saída. O grupo de anúncios associado ao formulário de lead enviado.

gclid

string

Apenas saída. ID de clique do Google associado ao formulário de lead enviado.

submissionDateTime

string

Apenas saída. Data e hora em que o formulário de lead foi enviado. O formato é "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".

LeadFormSubmissionField

Campos no formulário de lead enviado.

Representação JSON
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
Campos
fieldType

enum (LeadFormFieldUserInputType)

Apenas saída. Tipo dos campos do formulário de lead.

fieldValue

string

Apenas saída. Valor dos campos do formulário de lead.

CustomLeadFormSubmissionField

Campos na pergunta personalizada enviada

Representação JSON
{
  "questionText": string,
  "fieldValue": string
}
Campos
questionText

string

Apenas saída. O texto da pergunta personalizada. O número máximo de caracteres é 300.

fieldValue

string

Apenas saída. Valor do campo para resposta à pergunta personalizada. O número máximo de caracteres é 70.

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)
  ],
  "skAdNetworkConversions": 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,
  "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
}
Campos
allConversionsValueByConversionDate

number

Valor de todas as conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.

allConversionsByConversionDate

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.

conversionsValueByConversionDate

number

Valor das conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.

conversionsByConversionDate

number

O número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.

historicalCreativeQualityScore

enum (QualityScoreBucket)

O índice de qualidade histórico do criativo.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

A qualidade da experiência histórica na página de destino.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

A taxa de cliques (CTR) prevista de pesquisa histórica.

interactionEventTypes[]

enum (InteractionEventType)

Os tipos de interação com pagamentos e sem custo.

skAdNetworkConversions

string (int64 format)

É o número de conversões de rede de publicidade do kit da loja do iOS.

publisherPurchasedClicks

string (int64 format)

Cliques de propriedades cujo tráfego foi pago ou adquirido por atividades de incentivo pelo editor, mas que não pertencem a ele

publisherOrganicClicks

string (int64 format)

Cliques de propriedades para as quais o tráfego que o editor não pagou ou não adquiriu por meio de atividades incentivadas

publisherUnknownClicks

string (int64 format)

Cliques do tráfego que não é identificado como "Comprado pelo editor" ou "Orgânico do editor"

absoluteTopImpressionPercentage

number

A parcela de impressões na primeira posição da pesquisa é a porcentagem de impressões de anúncios de pesquisa que são exibidas na posição de maior destaque da rede.

activeViewCpm

number

Custo médio das impressões visíveis (activeViewImpressions).

activeViewCtr

number

Cliques mensuráveis do Active View divididos pelas impressões visíveis do Active View.

Essa métrica é informada apenas para a Rede de Display.

activeViewImpressions

string (int64 format)

Uma medida da frequência com que seu anúncio ficou visível em um site da Rede de Display.

activeViewMeasurability

number

É a proporção de impressões que podem ser medidas pelo Active View pelo número de impressões veiculadas.

activeViewMeasurableCostMicros

string (int64 format)

O custo das impressões recebidas que foram avaliadas pelo Active View.

activeViewMeasurableImpressions

string (int64 format)

O número de vezes que seus anúncios são exibidos em canais em posições em que podem ser vistos.

activeViewViewability

number

A porcentagem de tempo em que seu anúncio foi exibido em um site com Active View ativado (impressões mensuráveis) e ficou visível (impressões visíveis).

allConversionsFromInteractionsRate

number

Todas as conversões de interações (como opostas a conversões de visualização) divididas pelo número de interações com anúncios.

allConversionsValue

number

Valor de todas as conversões.

allNewCustomerLifetimeValue

number

Valor da conversão da vida útil de todos os novos clientes. Se você configurou uma meta de aquisição de clientes no nível da conta ou da campanha, isso incluirá o valor da conversão adicional de novos clientes para conversões que recebem ou não recebem lances. Se a sua campanha adotou a meta de aquisição de clientes e selecionou "Lance mais alto para novos clientes", esses valores serão incluídos em "allConversionsValue". Consulte https://support.google.com/google-ads/answer/12080169 para mais detalhes.

allConversions

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric.

allConversionsValuePerCost

number

O valor de todas as conversões dividido pelo custo total das interações com os anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).

allConversionsFromClickToCall

number

O número de vezes que os usuários clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. Esse número não indica se as ligações foram ou não completadas nem a duração delas.

Essa métrica se aplica somente a itens do feed.

allConversionsFromDirections

number

O número de vezes que os usuários clicaram no botão "Como chegar" para ir a uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromInteractionsValuePerInteraction

number

O valor de todas as conversões de interações dividido pelo número total de interações.

allConversionsFromMenu

number

O número de vezes que os usuários clicaram em um link para ver o menu de uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromOrder

number

Quantas vezes os usuários fizeram um pedido em uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromOtherEngagement

number

O número de outras conversões (por exemplo, postar uma avaliação ou salvar o local de uma loja) que ocorreram depois que os usuários clicaram em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromStoreVisit

number

Número estimado de vezes que os usuários visitaram uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromStoreWebsite

number

O número de vezes que os usuários foram direcionados ao URL de uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

auctionInsightSearchAbsoluteTopImpressionPercentage

number

Essa métrica faz parte do Relatório de informações do leilão e informa com que frequência os anúncios de outro participante foram exibidos na posição de maior destaque da página de resultados de pesquisa. Essa porcentagem é calculada apenas com base nos leilões em que você apareceu na página.

Essa métrica não está disponível publicamente.

auctionInsightSearchImpressionShare

number

Essa métrica faz parte do Relatório de informações do leilão e informa a porcentagem de impressões que outro participante teve em relação ao número total de impressões para as quais seus anúncios estavam qualificados. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Essa métrica não está disponível publicamente.

auctionInsightSearchOutrankingShare

number

Essa métrica faz parte do Relatório de informações do leilão e informa a porcentagem de impressões em que seus anúncios superaram (exibidos acima) outros participantes do leilão, em comparação com o número total de impressões para as quais seus anúncios estavam qualificados. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Essa métrica não está disponível publicamente.

auctionInsightSearchOverlapRate

number

Essa métrica faz parte do Relatório de informações do leilão e informa com que frequência o anúncio de outro participante recebeu uma impressão quando seu anúncio também recebeu uma impressão.

Essa métrica não está disponível publicamente.

auctionInsightSearchPositionAboveRate

number

Essa métrica faz parte do Relatório de informações do leilão e informa a frequência com que o anúncio de outro participante foi exibido em uma posição mais elevada que o seu, quando ambos os anúncios foram exibidos na mesma página.

Essa métrica não está disponível publicamente.

auctionInsightSearchTopImpressionPercentage

number

Essa métrica faz parte do Relatório de informações do leilão e informa com que frequência os anúncios de outro participante foram exibidos ao lado dos principais resultados de pesquisa orgânica. Essa porcentagem é calculada apenas com base nos leilões em que você apareceu na página.

Essa métrica não está disponível publicamente.

averageCost

number

Valor médio que você paga por interação. Esse valor é o custo total dos seus anúncios dividido pelo número total de interações.

averageCpc

number

O custo total de todos os cliques dividido pelo número total de cliques recebidos.

averageCpe

number

O valor médio cobrado por um engajamento de anúncio. Esse valor é o custo total de todos os engajamentos de anúncios dividido pelo número total de engajamentos de anúncios.

averageCpm

number

Custo médio por mil impressões (CPM médio).

averageCpv

number

O valor médio que você paga cada vez que alguém visualiza seu anúncio. O CPV médio é definido pela divisão do custo total de todas as visualizações pelo número de visualizações do anúncio.

averagePageViews

number

Número médio de páginas visualizadas por sessão.

averageTimeOnSite

number

Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics.

benchmarkAverageMaxCpc

number

Uma indicação de como outros anunciantes estão definindo lances para produtos semelhantes.

biddableAppInstallConversions

number

Número de instalações do app.

biddableAppPostInstallConversions

number

Número de ações no app.

benchmarkCtr

number

Uma indicação da performance dos anúncios do Shopping de outros anunciantes para produtos semelhantes com base na frequência com que as pessoas que veem o anúncio clicam neles.

bounceRate

number

Porcentagem de cliques em que o usuário visitou apenas uma página do site. Importado do Google Analytics.

clicks

string (int64 format)

O número de cliques.

combinedClicks

string (int64 format)

O número de vezes que os usuários clicaram no seu anúncio ou na listagem do seu site nos resultados não pagos. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

combinedClicksPerQuery

number

O número de vezes que seu anúncio ou a listagem do seu site nos resultados não pagos foram clicados (combinedClicks) dividido por combinadoQueries. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

combinedQueries

string (int64 format)

O número de pesquisas que retornaram páginas do seu site nos resultados não pagos ou que exibiram um dos seus anúncios de texto. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

contentBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de Display, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

contentImpressionShare

number

As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você pode receber. Observação: a parcela de impressões de conteúdo é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

conversionLastReceivedRequestDateTime

string

A última data e hora em que a tag de conversão dessa ação de conversão foi disparada e foi vista pelo Google Ads. Esse evento de disparo pode não ter sido o resultado de uma conversão atribuível. Por exemplo, a tag foi disparada de um navegador que não clicou anteriormente em um anúncio de um anunciante apropriado. A data/hora está no fuso horário do cliente.

conversionLastConversionDate

string

A data da conversão mais recente para esta ação de conversão. A data está no fuso horário do cliente.

contentRankLostImpressionShare

number

A porcentagem estimada de impressões na rede de Display que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas do conteúdo é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

conversionsFromInteractionsRate

number

Conversões de interações divididas pelo número de interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

conversionsValue

number

Valor das conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

newCustomerLifetimeValue

number

Valor da conversão de vida útil de novos clientes. Se você configurou uma meta de aquisição de clientes no nível da conta ou da campanha, isso incluirá o valor da conversão adicional de novos clientes para conversões que recebem lances. Se a sua campanha adotou a meta de aquisição de clientes e selecionou "Lance mais alto para novos clientes", esses valores serão incluídos em "conversionsValue" para otimização. Consulte https://support.google.com/google-ads/answer/12080169 para mais detalhes.

conversionsValuePerCost

number

O valor das conversões dividido pelo custo das interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

conversionsFromInteractionsValuePerInteraction

number

O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

conversions

number

O número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

costMicros

string (int64 format)

A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período.

costPerAllConversions

number

O custo das interações com anúncios dividido por todas as conversões.

costPerConversion

number

O custo das interações com anúncios dividido pelas conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

costPerCurrentModelAttributedConversion

number

O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

crossDeviceConversions

number

Conversões de um cliente que clica em um anúncio do Google Ads em um dispositivo e faz a conversão em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em todas as conversões.

ctr

number

O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões).

currentModelAttributedConversions

number

Mostra a aparência dos dados históricos de conversão no modelo de atribuição selecionado no momento. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

currentModelAttributedConversionsFromInteractionsRate

number

Modelo atual de conversões atribuídas a partir de interações divididas pelo número de interações com o anúncio (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

O valor das conversões atribuídas pelo modelo atual a partir das interações dividido pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

currentModelAttributedConversionsValue

number

O valor das conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

currentModelAttributedConversionsValuePerCost

number

O valor das conversões atribuídas ao modelo atual dividido pelo custo das interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

engagementRate

number

A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de expansões de anúncios dividido pelo número de vezes que seu anúncio é exibido.

engagements

string (int64 format)

O número de interações. A interação ocorre quando um usuário expande seu anúncio lightbox. Além disso, no futuro, outros tipos de anúncio poderão ser compatíveis com as métricas de engajamento.

hotelAverageLeadValueMicros

number

Valor médio do lead com base nos cliques.

hotelCommissionRateMicros

string (int64 format)

Taxa de lances de comissão em micros. Uma comissão de 20% é representada como 200.000.

hotelExpectedCommissionCost

number

Custo de comissão esperado. O resultado da multiplicação do valor da comissão vezes hotel_commission_rate na moeda do anunciante.

hotelPriceDifferencePercentage

number

A diferença média de preço entre o preço oferecido pelo anunciante de hotéis que informa e o preço mais barato oferecido pelo anunciante concorrente.

hotelEligibleImpressions

string (int64 format)

O número de impressões que os parceiros de hotéis poderiam ter atribuído a performance do feed.

historicalQualityScore

string (int64 format)

O índice de qualidade histórico.

gmailForwards

string (int64 format)

O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem.

gmailSaves

string (int64 format)

O número de vezes que alguém salvou seu anúncio do Gmail na Caixa de entrada como uma mensagem.

gmailSecondaryClicks

string (int64 format)

O número de cliques para acessar a página de destino no estado expandido dos anúncios do Gmail.

impressionsFromStoreReach

string (int64 format)

Quantas vezes o anúncio de uma loja com base no local foi exibido.

Essa métrica se aplica somente a itens do feed.

impressions

string (int64 format)

Contagem da frequência com que seu anúncio foi exibido em uma página de resultados de pesquisa ou em um site na Rede do Google.

interactionRate

number

A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.

interactions

string (int64 format)

O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio (cliques em anúncios de texto e do Shopping, visualizações de anúncios em vídeo etc.).

invalidClickRate

number

A porcentagem de cliques filtrados do número total de cliques (cliques filtrados e não filtrados) durante o período do relatório.

invalidClicks

string (int64 format)

Número de cliques que o Google considera ilegítimos e que não são cobrados de você.

messageChats

string (int64 format)

Número de chats de mensagens iniciados para impressões de clique para enviar mensagens que estavam qualificadas para o rastreamento de mensagens.

messageImpressions

string (int64 format)

Número de impressões do tipo "clique para enviar mensagem" que estavam qualificadas para o acompanhamento de mensagens.

messageChatRate

number

Número de chats de mensagens iniciados (messageChats) dividido pelo número de impressões de mensagens (messageimpressions). É a taxa em que um usuário inicia um chat por mensagens a partir de uma impressão de anúncio com a opção de mensagens e o rastreamento de mensagens ativados. Essa taxa pode ser maior que 1,0 para uma determinada impressão de mensagem.

mobileFriendlyClicksPercentage

number

A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis.

optimizationScoreUplift

number

Aumento total da pontuação de otimização de todas as recomendações.

optimizationScoreUrl

string

URL da página da pontuação de otimização na interface da Web do Google Ads. Essa métrica pode ser selecionada de customer ou campaign e pode ser segmentada por segments.recommendation_type. Por exemplo, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer retorna um URL para cada combinação exclusiva (customer, recommendationsType).

organicClicks

string (int64 format)

O número de vezes que alguém clicou na listagem do seu site nos resultados não pagos para uma consulta específica. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

organicClicksPerQuery

number

O número de vezes que alguém clicou na listagem de seu site nos resultados não pagos (orgânicas) dividido pelo número total de pesquisas que retornaram páginas de seu site (organicQueries). Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

organicImpressions

string (int64 format)

É o número de listagens do seu site nos resultados da pesquisa não pagas. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

organicImpressionsPerQuery

number

O número de vezes que uma página do seu site foi listada nos resultados de pesquisa não paga (orgânicas) dividido pelo número de pesquisas que retornam a listagem do seu site nos resultados não pagos (orgânicas). Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

organicQueries

string (int64 format)

O número total de pesquisas que retornaram a listagem do seu site nos resultados não pagos. Consulte a página de ajuda em https://support.google.com/google-ads/answer/3097241 para saber mais detalhes.

percentNewVisitors

number

Porcentagem de primeiras sessões (de pessoas que nunca visitaram seu site). Importado do Google Analytics.

phoneCalls

string (int64 format)

Número de chamadas off-line.

phoneImpressions

string (int64 format)

Número de impressões do número de telefone off-line.

phoneThroughRate

number

Número de chamadas telefônicas recebidas (phoneCalls) dividido pelo número de vezes que seu número de telefone foi mostrado (phoneImpressões).

relativeCtr

number

Sua taxa de cliques (CTR) dividida pela taxa média de cliques de todos os anunciantes nos sites que exibem seus anúncios. Avalia o desempenho dos seus anúncios em sites da Rede de Display em comparação com outros anúncios nos mesmos sites.

searchAbsoluteTopImpressionShare

number

A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente exibidas na posição de maior destaque no Shopping. Consulte https://support.google.com/google-ads/answer/7501826 para mais detalhes. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi o primeiro entre os principais anúncios nos resultados de pesquisa devido a um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de pesquisa, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi exibido ao lado dos principais resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchClickShare

number

O número de cliques que você recebeu na rede de pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchExactMatchImpressionShare

number

As impressões recebidas divididas pelo número estimado de impressões que você tinha qualificação para receber na rede de pesquisa para termos de pesquisa que corresponderam exatamente às suas palavras-chave (ou eram variações aproximadas da sua palavra-chave), independentemente dos tipos de correspondência de palavra-chave. Observação: a parcela de impressões de correspondência exata de pesquisa é informada entre 0,1 e 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchImpressionShare

number

O número de impressões recebidas na rede de pesquisa dividido pelo número estimado de impressões que você está qualificado para receber. Observação: a parcela de impressões da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi o primeiro entre os principais resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchRankLostImpressionShare

number

A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchRankLostTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi exibido ao lado dos principais resultados da pesquisa orgânica devido a uma classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchTopImpressionShare

number

As impressões que você recebeu entre os principais anúncios em comparação com o número estimado de impressões que você estava qualificado para receber entre eles. Observação: a parcela de impressões na parte superior da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Esses anúncios geralmente ficam acima dos resultados orgânicos principais, embora possam aparecer abaixo desses resultados em determinadas consultas.

searchVolume

object (SearchVolumeRange)

Intervalo do volume de pesquisas para uma categoria de insight do termo de pesquisa.

speedScore

string (int64 format)

Uma medida da velocidade de carregamento da página após o clique em anúncios para dispositivos móveis. A pontuação varia de 1 a 10, sendo 10 a mais rápida.

averageTargetCpaMicros

string (int64 format)

É o CPA desejado médio. Se não estiver disponível, por exemplo, para campanhas que tinham tráfego de estratégias de lances de portfólio ou não tCPA.

averageTargetRoas

number

O ROAS desejado médio ou não definido, se não estiver disponível. Por exemplo, para campanhas que tinham tráfego de estratégias de lances de portfólio ou não tROAS.

topImpressionPercentage

number

A porcentagem de impressões de anúncios que são exibidas ao lado dos principais resultados da pesquisa orgânica.

validAcceleratedMobilePagesClicksPercentage

number

A porcentagem de cliques no anúncio em páginas de destino Accelerated Mobile Pages (AMP) que levam a uma página AMP válida.

valuePerAllConversions

number

O valor de todas as conversões dividido pelo número de todas as conversões.

valuePerAllConversionsByConversionDate

number

O valor de todas as conversões dividido pelo número de todas as conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.

valuePerConversion

number

O valor das conversões dividido pelo número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

valuePerConversionsByConversionDate

number

O valor das conversões dividido pelo número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/google-ads/answer/9549009.

valuePerCurrentModelAttributedConversion

number

O valor do modelo atual atribuído a conversões dividido pelo número de conversões. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

videoQuartileP100Rate

number

Porcentagem de impressões em que os espectadores assistiram todo o vídeo.

videoQuartileP25Rate

number

Porcentagem de impressões em que o espectador assistiu 25% do seu vídeo.

videoQuartileP50Rate

number

Porcentagem de impressões em que o espectador assistiu 50% do seu vídeo.

videoQuartileP75Rate

number

Porcentagem de impressões em que o espectador assistiu 75% do seu vídeo.

videoViewRate

number

O número de visualizações que seu anúncio em vídeo TrueView recebe dividido pelo número de impressões dele, incluindo impressões de miniaturas de anúncios TrueView em display.

videoViews

string (int64 format)

Número de vezes que seus anúncios em vídeo foram visualizados.

viewThroughConversions

string (int64 format)

O número total de conversões de visualização. Elas acontecem quando um cliente vê um anúncio gráfico ou rich media e depois conclui uma conversão no seu site sem interagir (por exemplo, clicar) com outro anúncio.

allConversionsFromLocationAssetClickToCall

number

Número de cliques no botão de chamada em qualquer plataforma de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.

allConversionsFromLocationAssetDirections

number

Número de cliques em rotas de carro em qualquer superfície de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.

allConversionsFromLocationAssetMenu

number

Número de cliques em links de menu em qualquer plataforma de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.

allConversionsFromLocationAssetOrder

number

É o número de cliques em pedidos em qualquer plataforma de local após um evento de anúncio cobrável (clique ou impressão). Essa medida é proveniente do local com base nos recursos.

allConversionsFromLocationAssetOtherEngagement

number

É o número de outros tipos de cliques de ação local em qualquer plataforma após um evento de anúncio sujeito a cobrança (clique ou impressão). Essa medida é proveniente do local com base nos recursos.

allConversionsFromLocationAssetStoreVisits

number

Número estimado de visitas à loja após um evento de anúncio (clique ou impressão) que pode ser cobrado. Essa medida é proveniente do local com base nos recursos.

allConversionsFromLocationAssetWebsite

number

É o número de cliques no URL do site em qualquer plataforma após um evento de anúncio (clique ou impressão) que pode ser cobrado. Essa medida é proveniente do local com base nos recursos.

eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

É o número de impressões em que o local da loja foi mostrado ou foi usado para segmentação. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetClickToCall

number

Número de cliques no botão de chamada em qualquer superfície de local após uma impressão. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetDirections

number

Número de cliques para rotas de carro em qualquer superfície de local após uma impressão. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetMenu

number

Número de cliques em links de menu em qualquer plataforma de local após uma impressão. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetOrder

number

É o número de cliques em pedidos em qualquer plataforma de local após uma impressão. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetOtherEngagement

number

É o número de outros tipos de cliques de ação local em qualquer superfície de local após uma impressão. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetStoreVisits

number

Número estimado de visitas à loja após uma impressão. Essa medida é proveniente do local com base nos recursos.

viewThroughConversionsFromLocationAssetWebsite

number

É o número de cliques no URL do site em qualquer plataforma após uma impressão. Essa medida é proveniente do local com base nos recursos.

InteractionEventType

Enumeração que descreve os tipos possíveis de interações a pagar e sem custo financeiro.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CLICK Clique para acessar o site. Na maioria dos casos, essa interação navega para um local externo, geralmente a página de destino do anunciante. Também é o InteractionEventType padrão para eventos de clique.
ENGAGEMENT A intenção expressa do usuário de interagir com o anúncio.
VIDEO_VIEW O usuário visualizou um anúncio em vídeo.
NONE O InteractionEventType padrão para eventos de conversão de anúncios. Usado quando uma linha de conversão de anúncios NÃO indica que as interações sem custo financeiro (por exemplo, conversões de anúncios) precisam ser "promovidas" e informadas como parte das métricas principais. Essas são simplesmente outras conversões (anúncios).

SearchVolumeRange

Intervalo do volume de pesquisa. O volume de pesquisa real está dentro deste intervalo.

Representação JSON
{
  "min": string,
  "max": string
}
Campos
min

string (int64 format)

Limite inferior do volume de pesquisas.

max

string (int64 format)

Limite superior do volume de pesquisas.

Segmentos

Campos apenas para segmentos.

Representação JSON
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": 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)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Campos
adDestinationType

enum (AdDestinationType)

Tipo de destino do anúncio.

adNetworkType

enum (AdNetworkType)

Tipo de rede de publicidade.

budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

É o status da associação da campanha de orçamento.

clickType

enum (ClickType)

Tipo de clique.

conversionActionCategory

enum (ConversionActionCategory)

Categoria de ação de conversão.

conversionAttributionEventType

enum (ConversionAttributionEventType)

Tipo de evento de atribuição de conversão

conversionLagBucket

enum (ConversionLagBucket)

Um valor de enumeração que representa o número de dias entre a impressão e a conversão.

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

É um valor de enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes na conversão.

dayOfWeek

enum (DayOfWeek)

Dia da semana, por exemplo, MONDAY.

device

enum (Device)

Dispositivo a que as métricas se aplicam.

externalConversionSource

enum (ExternalConversionSource)

Origem da conversão externa.

hotelCheckInDayOfWeek

enum (DayOfWeek)

Dia da semana do check-in no hotel.

hotelDateSelectionType

enum (HotelDateSelectionType)

Tipo de seleção da data do hotel.

hotelRateType

enum (HotelRateType)

Tipo de diária do hotel.

hotelPriceBucket

enum (HotelPriceBucket)

Faixa de preço do hotel.

keyword

object (Keyword)

Critério de palavra-chave.

monthOfYear

enum (MonthOfYear)

Mês do ano, por exemplo, janeiro.

placeholderType

enum (PlaceholderType)

Tipo de marcador de posição. Isso é usado somente com métricas de itens do feed.

productChannel

enum (ProductChannel)

Canal do produto.

productChannelExclusivity

enum (ProductChannelExclusivity)

Exclusividade do canal do produto.

productCondition

enum (ProductCondition)

Estado do produto.

recommendationType

enum (RecommendationType)

Tipo de recomendação.

searchEngineResultsPageType

enum (SearchEngineResultsPageType)

Tipo da página de resultados do mecanismo de pesquisa.

searchTermMatchType

enum (SearchTermMatchType)

Tipo de correspondência da palavra-chave que acionou o anúncio, incluindo variantes.

slot

enum (Slot)

Posição do anúncio.

conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

Dimensão principal das regras de valor da conversão aplicadas. NO_RULE_APPLIED mostra o valor total registrado das conversões que não têm uma regra de valor aplicada. "ORIGINAL" mostra o valor original das conversões às quais uma regra de valor foi aplicada. GEO_LOCATION, DEVICE, AUDIENCE mostra o ajuste líquido depois que as regras de valor foram aplicadas.

skAdNetworkUserType

enum (SkAdNetworkUserType)

Tipo de usuário da rede de publicidade do kit da loja do iOS.

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

Tipo de evento de anúncio da rede de publicidade do kit da loja do iOS.

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

Crédito de atribuição da rede de publicidade do kit da loja do iOS

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

Isso serve para segmentar as conversões de acordo com o usuário: novo ou recorrente. Essa segmentação é normalmente usada para medir o impacto da meta de aquisição de clientes.

activityAccountId

string (int64 format)

ID da conta da atividade.

activityRating

string (int64 format)

Classificação da atividade.

externalActivityId

string

ID da atividade fornecido pelo anunciante.

adGroup

string

Nome do recurso do grupo de anúncios.

assetGroup

string

Nome do recurso do grupo.

auctionInsightDomain

string

Domínio (URL visível) de um participante no Relatório de informações do leilão.

campaign

string

Nome do recurso da campanha.

conversionAction

string

Nome do recurso da ação de conversão.

conversionActionName

string

Nome da ação de conversão.

conversionAdjustment

boolean

Assim, suas colunas de conversão são segmentadas pela conversão original e pelo valor da conversão, em comparação com o delta se as conversões tiverem sido ajustadas. A linha falsa tem os dados conforme declarado originalmente; enquanto a linha verdadeira tem o delta entre os dados atuais e os originalmente declarados. A soma dos dois resulta nos dados pós-ajuste.

date

string

Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17.

geoTargetAirport

string

Nome do recurso da constante de segmentação por área geográfica que representa um aeroporto.

geoTargetCanton

string

Nome do recurso da constante de segmentação geográfica que representa um cantão.

geoTargetCity

string

Nome do recurso da constante de segmentação por área geográfica que representa uma cidade.

geoTargetCountry

string

Nome do recurso da constante de segmentação por área geográfica que representa um país.

geoTargetCounty

string

Nome do recurso da constante de segmentação geográfica que representa um condado.

geoTargetDistrict

string

Nome do recurso da constante de segmentação geográfica que representa um distrito.

geoTargetMetro

string

Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana.

geoTargetMostSpecificLocation

string

Nome do recurso da constante de segmentação por área geográfica que representa a localização mais específica.

geoTargetPostalCode

string

Nome do recurso da constante de segmentação por área geográfica que representa um código postal.

geoTargetProvince

string

Nome do recurso da constante de segmentação por área geográfica que representa uma província.

geoTargetRegion

string

Nome do recurso da constante de segmentação por área geográfica que representa uma região.

geoTargetState

string

Nome do recurso da constante de segmentação geográfica que representa um estado.

hotelBookingWindowDays

string (int64 format)

Janela de reserva do hotel em dias.

hotelCenterId

string (int64 format)

ID da Central para Hotéis.

hotelCheckInDate

string

Data do check-in no hotel. no formato aaaa-MM-dd.

hotelCity

string

Cidade do hotel.

hotelClass

integer

Classificação do hotel.

hotelCountry

string

País do hotel.

hotelLengthOfStay

integer

Tempo de permanência no hotel.

hotelRateRuleId

string

ID da regra da tarifa do hotel.

hotelState

string

Estado do hotel.

hour

integer

Hora do dia como um número entre 0 e 23.

interactionOnThisExtension

boolean

Usado somente com métricas de itens do feed. Indica se as métricas de interação ocorreram no próprio item do feed ou em uma extensão ou um bloco de anúncios diferente.

month

string

Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd.

partnerHotelId

string

ID do hotel do parceiro.

productAggregatorId

string (int64 format)

ID agregado do produto.

productBiddingCategoryLevel1

string

Categoria do lance (nível 1) do produto.

productBiddingCategoryLevel2

string

Categoria do lance (nível 2) do produto.

productBiddingCategoryLevel3

string

Categoria do lance (nível 3) do produto.

productBiddingCategoryLevel4

string

Categoria do lance (nível 4) do produto.

productBiddingCategoryLevel5

string

Categoria do lance (nível 5) do produto.

productBrand

string

Marca do produto.

productCountry

string

Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto.

productCustomAttribute0

string

Atributo personalizado 0 do produto.

productCustomAttribute1

string

Atributo personalizado 1 do produto.

productCustomAttribute2

string

Atributo personalizado 2 do produto.

productCustomAttribute3

string

Atributo personalizado 3 do produto.

productCustomAttribute4

string

Atributo personalizado 4 do produto.

productFeedLabel

string

Rótulo do feed do produto.

productItemId

string

ID do item do produto.

productLanguage

string

Nome do recurso da constante de idioma para o idioma do produto.

productMerchantId

string (int64 format)

ID do comerciante do produto.

productStoreId

string

ID da loja do produto.

productTitle

string

Título do produto.

productTypeL1

string

Tipo (nível 1) do produto.

productTypeL2

string

Tipo (nível 2) do produto.

productTypeL3

string

Tipo (nível 3) do produto.

productTypeL4

string

Tipo (nível 4) do produto.

productTypeL5

string

Tipo (nível 5) do produto.

quarter

string

Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. no formato aaaa-MM-dd.

searchSubcategory

string

Uma subcategoria do termo de pesquisa. Uma string vazia indica a subcategoria abrangente para os termos de pesquisa que não se encaixam em outra subcategoria.

searchTerm

string

Um termo de pesquisa.

webpage

string

Nome do recurso do critério do grupo de anúncios que representa o critério da página da Web.

week

string

É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd.

year

integer

Ano, formatado como aaaa.

skAdNetworkConversionValue

string (int64 format)

Valor da conversão da rede de publicidade do kit da loja do iOS. Um valor nulo significa que esse segmento não é aplicável, por exemplo, uma campanha que não seja para iOS.

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

App em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. Um valor nulo significa que o segmento não é aplicável, por exemplo, a uma campanha que não era de iOS, ou que não estava presente em postbacks enviados pela Apple.

assetInteractionTarget

object (AssetInteractionTarget)

Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios. As interações (por exemplo, cliques) são contabilizadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando são veiculadas juntas. Quando interatividadeOnThisAsset é definido como verdadeiro, isso significa que as interações estão nesse recurso específico. Se o "InteractionOnThisAsset" é falso, isso significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio com que ele é veiculado.

AdDestinationType

Enumera os tipos de destino do Google Ads

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
NOT_APPLICABLE Anúncios que não têm a intenção de afastar os usuários dos anúncios para outros destinos
WEBSITE Site
APP_STORE App Store do iOS ou Play Store
PHONE_CALL Ligar para discador
MAP_DIRECTIONS App de mapas
LOCATION_LISTING Página dedicada à localização
MESSAGE Texto
LEAD_FORM Formulário de geração de leads
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS Destino do anúncio para conversões com chaves desconhecidas

AdNetworkType

Enumera os tipos de rede do Google Ads.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH Pesquisa do Google.
SEARCH_PARTNERS Parceiros de pesquisa.
CONTENT Rede de Display.
YOUTUBE_WATCH Vídeos do YouTube
MIXED Várias redes.

BudgetCampaignAssociationStatus

Um segmentoBudgetCampaignAssociationStatus.

Representação JSON
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
Campos
status

enum (BudgetCampaignAssociationStatus)

É o status da associação da campanha de orçamento.

campaign

string

O nome do recurso da campanha.

BudgetCampaignAssociationStatus

Possíveis status da associação entre o orçamento e a campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A campanha está usando o orçamento no momento.
REMOVED A campanha não está mais usando o orçamento.

ClickType

Enumera os tipos de clique do Google Ads.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
BREADCRUMBS Navegação estrutural.
BROADBAND_PLAN Plano de banda larga.
CALL_TRACKING Chamadas telefônicas discadas manualmente.
CALLS Chamadas telefônicas.
CLICK_ON_ENGAGEMENT_AD Clique no anúncio de engajamento.
GET_DIRECTIONS Rota de carro.
LOCATION_EXPANSION Mais detalhes do local.
LOCATION_FORMAT_CALL Chamada.
LOCATION_FORMAT_DIRECTIONS Rotas.
LOCATION_FORMAT_IMAGE Imagens.
LOCATION_FORMAT_LANDING_PAGE Acesse a página de destino.
LOCATION_FORMAT_MAP Mapa.
LOCATION_FORMAT_STORE_INFO Acesse as informações da loja.
LOCATION_FORMAT_TEXT Texto.
MOBILE_CALL_TRACKING Chamadas de telefone celular.
OFFER_PRINTS Imprimir oferta.
OTHER Outros
PRODUCT_EXTENSION_CLICKS Oferta da caixa que contém o sinal de adição do produto.
PRODUCT_LISTING_AD_CLICKS Google Shopping – Produto – On-line.
STORE_LOCATOR Mostrar locais próximos.
URL_CLICKS Título.
VIDEO_APP_STORE_CLICKS Loja de aplicativos.
VIDEO_CALL_TO_ACTION_CLICKS Sobreposição de call-to-action.
VIDEO_CARD_ACTION_HEADLINE_CLICKS Cartões.
VIDEO_END_CAP_CLICKS Imagem final.
VIDEO_WEBSITE_CLICKS Site.
WIRELESS_PLAN Plano de rede sem fio.
PRODUCT_LISTING_AD_LOCAL Google Shopping – Produto – Local.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL Google Shopping – Produto – Multicanal local.
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE Google Shopping – Produto – Multicanal on-line.
PRODUCT_LISTING_ADS_COUPON Google Shopping – Produto – Cupom.
PRODUCT_LISTING_AD_TRANSACTABLE Google Shopping – Produto – Vender no Google.
PROMOTION_EXTENSION Extensão de promoção.
HOTEL_PRICE Preço do hotel.
PRICE_EXTENSION Extensão de preço.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Reserva de hotéis no Google: seleção de quartos.
SHOPPING_COMPARISON_LISTING Shopping – Lista de comparação.
CROSS_NETWORK Várias redes. Com as campanhas Performance Max e Discovery.

ConversionAttributionEventType

O tipo de evento ao qual as conversões são atribuídas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa um valor desconhecido nesta versão.
IMPRESSION A conversão é atribuída a uma impressão.
INTERACTION A conversão é atribuída a uma interação.

ConversionLagBucket

Enumeração que representa o número de dias entre a impressão e a conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
LESS_THAN_ONE_DAY Intervalo de tempo de conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não.
ONE_TO_TWO_DAYS Intervalo de tempo de conversão de 1 a 2 dias. 1 dia está incluído, mas 2 dias não.
TWO_TO_THREE_DAYS Intervalo de tempo de conversão de dois a três dias. 2 dias estão incluídos, mas 3 dias não.
THREE_TO_FOUR_DAYS Intervalo de tempo de conversão de 3 a 4 dias. Três dias estão incluídos, mas quatro dias não.
FOUR_TO_FIVE_DAYS Intervalo de tempo de conversão de 4 a 5 dias. 4 dias está incluído, mas 5 dias não.
FIVE_TO_SIX_DAYS Intervalo de tempo de conversão de 5 a 6 dias. 5 dias está incluído, mas 6 dias não.
SIX_TO_SEVEN_DAYS Intervalo de tempo de conversão de 6 a 7 dias. Seis dias estão incluídos, mas sete dias não.
SEVEN_TO_EIGHT_DAYS Intervalo de tempo de conversão de 7 a 8 dias. 7 dias está incluído, mas 8 dias não.
EIGHT_TO_NINE_DAYS Intervalo de tempo de conversão de 8 a 9 dias. 8 dias está incluído, mas 9 dias não.
NINE_TO_TEN_DAYS Intervalo de tempo de conversão de 9 a 10 dias. 9 dias está incluído, mas 10 dias não.
TEN_TO_ELEVEN_DAYS Intervalo de tempo de conversão de 10 a 11 dias. 10 dias está incluído, 11 dias não.
ELEVEN_TO_TWELVE_DAYS Intervalo de tempo de conversão de 11 a 12 dias. 11 dias está incluído, 12 dias não.
TWELVE_TO_THIRTEEN_DAYS Intervalo de tempo de conversão de 12 a 13 dias. 12 dias está incluído, 13 dias não.
THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de conversão de 13 a 14 dias. 13 dias está incluído, 14 dias não.
FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de tempo de conversão de 14 a 21 dias. 14 dias está incluído, 21 dias não.
TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo de conversão de 21 a 30 dias. 21 dias está incluído, 30 dias não.
THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo de conversão de 30 a 45 dias. 30 dias está incluído, 45 dias não.
FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo de conversão de 45 a 60 dias. 45 dias está incluído, mas 60 dias não.
SIXTY_TO_NINETY_DAYS Intervalo de tempo de conversão de 60 a 90 dias. 60 dias está incluído, mas 90 dias não.

ConversionOrAdjustmentLagBucket

Enumeração que representa o número de dias entre a impressão e a conversão ou entre a impressão e os ajustes feitos na conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CONVERSION_LESS_THAN_ONE_DAY Intervalo de tempo de conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não.
CONVERSION_ONE_TO_TWO_DAYS Intervalo de tempo de conversão de 1 a 2 dias. 1 dia está incluído, mas 2 dias não.
CONVERSION_TWO_TO_THREE_DAYS Intervalo de tempo de conversão de dois a três dias. 2 dias estão incluídos, mas 3 dias não.
CONVERSION_THREE_TO_FOUR_DAYS Intervalo de tempo de conversão de 3 a 4 dias. Três dias estão incluídos, mas quatro dias não.
CONVERSION_FOUR_TO_FIVE_DAYS Intervalo de tempo de conversão de 4 a 5 dias. 4 dias está incluído, mas 5 dias não.
CONVERSION_FIVE_TO_SIX_DAYS Intervalo de tempo de conversão de 5 a 6 dias. 5 dias está incluído, mas 6 dias não.
CONVERSION_SIX_TO_SEVEN_DAYS Intervalo de tempo de conversão de 6 a 7 dias. Seis dias estão incluídos, mas sete dias não.
CONVERSION_SEVEN_TO_EIGHT_DAYS Intervalo de tempo de conversão de 7 a 8 dias. 7 dias está incluído, mas 8 dias não.
CONVERSION_EIGHT_TO_NINE_DAYS Intervalo de tempo de conversão de 8 a 9 dias. 8 dias está incluído, mas 9 dias não.
CONVERSION_NINE_TO_TEN_DAYS Intervalo de tempo de conversão de 9 a 10 dias. 9 dias está incluído, mas 10 dias não.
CONVERSION_TEN_TO_ELEVEN_DAYS Intervalo de tempo de conversão de 10 a 11 dias. 10 dias está incluído, 11 dias não.
CONVERSION_ELEVEN_TO_TWELVE_DAYS Intervalo de tempo de conversão de 11 a 12 dias. 11 dias está incluído, 12 dias não.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS Intervalo de tempo de conversão de 12 a 13 dias. 12 dias está incluído, 13 dias não.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de conversão de 13 a 14 dias. 13 dias está incluído, 14 dias não.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de tempo de conversão de 14 a 21 dias. 14 dias está incluído, 21 dias não.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo de conversão de 21 a 30 dias. 21 dias está incluído, 30 dias não.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo de conversão de 30 a 45 dias. 30 dias está incluído, 45 dias não.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo de conversão de 45 a 60 dias. 45 dias está incluído, mas 60 dias não.
CONVERSION_SIXTY_TO_NINETY_DAYS Intervalo de tempo de conversão de 60 a 90 dias. 60 dias está incluído, mas 90 dias não.
ADJUSTMENT_LESS_THAN_ONE_DAY Intervalo de tempo de ajuste da conversão de 0 a 1 dia. 0 dia está incluído, 1 dia não.
ADJUSTMENT_ONE_TO_TWO_DAYS Intervalo de tempo de ajuste da conversão de um a dois dias. 1 dia está incluído, mas 2 dias não.
ADJUSTMENT_TWO_TO_THREE_DAYS Intervalo de tempo de ajuste da conversão de dois a três dias. 2 dias estão incluídos, mas 3 dias não.
ADJUSTMENT_THREE_TO_FOUR_DAYS Intervalo de tempo de ajuste da conversão de três a quatro dias. Três dias estão incluídos, mas quatro dias não.
ADJUSTMENT_FOUR_TO_FIVE_DAYS Intervalo de tempo de ajuste da conversão de 4 a 5 dias. 4 dias está incluído, mas 5 dias não.
ADJUSTMENT_FIVE_TO_SIX_DAYS Intervalo de tempo de ajuste de conversão de 5 a 6 dias. 5 dias está incluído, mas 6 dias não.
ADJUSTMENT_SIX_TO_SEVEN_DAYS Intervalo de tempo de ajuste de conversão de 6 a 7 dias. Seis dias estão incluídos, mas sete dias não.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS Intervalo de tempo de ajuste da conversão de 7 a 8 dias. 7 dias está incluído, mas 8 dias não.
ADJUSTMENT_EIGHT_TO_NINE_DAYS Intervalo de tempo de ajuste da conversão de 8 a 9 dias. 8 dias está incluído, mas 9 dias não.
ADJUSTMENT_NINE_TO_TEN_DAYS Intervalo de tempo de ajuste da conversão de 9 a 10 dias. 9 dias está incluído, mas 10 dias não.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS Intervalo de tempo de ajuste de conversão de 10 a 11 dias. 10 dias está incluído, 11 dias não.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS Intervalo de tempo de ajuste da conversão de 11 a 12 dias. 11 dias está incluído, 12 dias não.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS Intervalo de tempo de ajuste de conversão de 12 a 13 dias. 12 dias está incluído, 13 dias não.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS Intervalo de tempo de ajuste de conversão de 13 a 14 dias. 13 dias está incluído, 14 dias não.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS Intervalo de tempo de ajuste de conversão de 14 a 21 dias. 14 dias está incluído, 21 dias não.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS Intervalo de tempo de ajuste de conversão de 21 a 30 dias. 21 dias está incluído, 30 dias não.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS Intervalo de tempo de ajuste de conversão de 30 a 45 dias. 30 dias está incluído, 45 dias não.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS Intervalo de tempo de ajuste de conversão de 45 a 60 dias. 45 dias está incluído, mas 60 dias não.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS Intervalo de tempo de ajuste de conversão de 60 a 90 dias. 60 dias está incluído, mas 90 dias não.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS Intervalo de tempo de ajuste da conversão de 90 a 145 dias. 90 dias está incluído, 145 dias não.
CONVERSION_UNKNOWN Intervalo de tempo de conversão DESCONHECIDO. Refere-se a datas antes da disponibilização do intervalo de tempo de conversão no Google Ads.
ADJUSTMENT_UNKNOWN Intervalo de tempo de ajuste de conversão DESCONHECIDO. Esse valor é referente a datas antes da disponibilização do intervalo de tempo de ajuste de conversão no Google Ads.

ExternalConversionSource

A origem externa da conversão associada a uma ConversionAction.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Representa um valor desconhecido nesta versão.
WEBPAGE Conversão que ocorre quando um usuário navega até uma página da Web específica depois de visualizar um anúncio. Exibida na IU do Google Ads como "Site".
ANALYTICS Conversão originada de uma meta ou transação vinculada do Google Analytics. Exibido na IU do Google Ads como "Analytics".
UPLOAD Conversão do site que é enviada por meio do ConversionUploadService; exibida na interface do Google Ads como "Importar de cliques".
AD_CALL_METRICS Conversão que ocorre quando um usuário clica em uma extensão de chamada diretamente em um anúncio. Exibida na interface do Google Ads como "Chamadas a partir de anúncios".
WEBSITE_CALL_METRICS Conversão que ocorre quando um usuário liga para um número de telefone gerado dinamicamente (pelo JavaScript instalado) no site de um anunciante depois de clicar em um anúncio. Exibida na interface do Google Ads como "Chamadas do site".
STORE_VISITS Conversão que ocorre quando um usuário visita a loja de um anunciante após clicar em um anúncio do Google. Exibida na interface do Google Ads como "Visitas à loja".
ANDROID_IN_APP Conversão que ocorre quando um usuário realiza uma ação no app, como uma compra em um app Android. Exibida na IU do Google Ads como "Ação no app Android".
IOS_IN_APP Conversão que ocorre quando um usuário realiza uma ação no app, como uma compra em um app iOS. Exibida na IU do Google Ads como "Ação no app iOS".
IOS_FIRST_OPEN Conversão que ocorre quando um usuário abre um app iOS pela primeira vez. Exibida na interface do Google Ads como "Instalação de app iOS (primeiro acesso)".
APP_UNSPECIFIED Conversões de app legadas que não têm uma AppPlatform. Exibidas na interface do Google Ads como "App para dispositivos móveis".
ANDROID_FIRST_OPEN Conversão que ocorre quando um usuário abre um aplicativo Android pela primeira vez. Exibida na IU do Google Ads como "Instalação de aplicativo Android (primeiro acesso)".
UPLOAD_CALLS Conversão de chamada que é enviada por meio do ConversionUploadService; exibida na interface do Google Ads como "Importar de chamadas".
FIREBASE Conversão de um evento vinculado do Firebase. Exibido na IU do Google Ads como "Firebase".
CLICK_TO_CALL Conversão que ocorre quando um usuário clica em um número de celular. Exibida na interface do Google Ads como "Cliques no número de telefone".
SALESFORCE Conversão do Salesforce exibida na IU do Google Ads como "Salesforce.com".
STORE_SALES_CRM Conversão de compras na loja registradas pelo CRM. Exibida na interface do Google Ads como "Vendas na loja (parceiro de dados)".
STORE_SALES_PAYMENT_NETWORK Conversão proveniente de compras na loja da rede de pagamentos. Exibida na interface do Google Ads como "Vendas na loja (rede de pagamentos)".
GOOGLE_PLAY Conversão sem código do Google Play, exibida na interface do Google Ads como "Google Play".
THIRD_PARTY_APP_ANALYTICS Conversão proveniente de um evento vinculado de análise de aplicativos de terceiros. Exibida na interface do Google Ads como "Análise de aplicativos de terceiros".
GOOGLE_ATTRIBUTION Conversão controlada pelo Google Attribution.
STORE_SALES_DIRECT_UPLOAD Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros. Exibida na interface do Google Ads como "Vendas na loja (upload direto)".
STORE_SALES Conversão de vendas na loja com base nos uploads de dados próprios ou de terceiros e/ou de compras na loja usando cartões de redes de pagamentos. Aparece na interface do Google Ads como "Vendas na loja".
SEARCH_ADS_360 Conversões importadas dos dados do Floodlight no Search Ads 360.
GOOGLE_HOSTED Conversões que acompanham ações locais de produtos e serviços do Google depois de interagir com um anúncio.
FLOODLIGHT Conversões informadas pelas tags do Floodlight.
ANALYTICS_SEARCH_ADS_360 Conversões que vêm do Google Analytics especificamente para o Search Ads 360. Exibido na IU do Google Ads como Google Analytics (SA360).
FIREBASE_SEARCH_ADS_360 Conversão de um evento vinculado do Firebase para o Search Ads 360.
DISPLAY_AND_VIDEO_360_FLOODLIGHT A conversão é informada pelo Floodlight para o DV360.

HotelRateType

Enumeração que descreve os possíveis tipos de tarifa de hotel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE As informações sobre o tipo de tarifa não estão disponíveis.
PUBLIC_RATE Tarifas disponíveis para todos.
QUALIFIED_RATE Uma tarifa do programa de assinatura está disponível e atende aos requisitos básicos, como ter uma tarifa pública disponível. O tratamento de IU tacará a taxa pública e indicará que um desconto está disponível para o usuário. Para mais informações sobre as tarifas qualificadas, acesse https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates.
PRIVATE_RATE Tarifas disponíveis para usuários que atendem a alguns critérios de qualificação (por exemplo, todos os usuários que fizeram login, 20% dos usuários de dispositivos móveis, todos os usuários de dispositivos móveis no Canadá etc.).

HotelPriceBucket

Enumeração que descreve possíveis faixas de preço do hotel.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
LOWEST_UNIQUE O menor preço. O parceiro tem o menor preço, e nenhum outro parceiro tem uma pequena variação desse preço.
LOWEST_TIED Tem o menor preço possível. O parceiro está dentro de uma pequena variação em relação ao preço mais baixo.
NOT_LOWEST Não é o menor preço. O parceiro não tem uma variação pequena em relação ao preço mais baixo.
ONLY_PARTNER_SHOWN O parceiro foi o único mostrado.

Palavra-chave

Um segmento de critério de palavra-chave.

Representação JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Campos
info

object (KeywordInfo)

Informações da palavra-chave

adGroupCriterion

string

O nome do recurso name.

SearchEngineResultsPageType

O tipo de página de resultados do mecanismo de pesquisa.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ADS_ONLY Apenas anúncios estavam contidos na página de resultados do mecanismo de pesquisa.
ORGANIC_ONLY Somente resultados orgânicos estavam na página de resultados do mecanismo de pesquisa.
ADS_AND_ORGANIC Os anúncios e os resultados orgânicos ficavam na página de resultados do mecanismo de pesquisa.

SearchTermMatchType

Possíveis tipos de correspondência de uma palavra-chave que aciona um anúncio, incluindo variantes

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BROAD Correspondência ampla.
EXACT Correspondência exata.
PHRASE Correspondência de frase.
NEAR_EXACT Correspondência exata (variação aproximada).
NEAR_PHRASE Correspondência de frase (variação aproximada).

Slot

Enumera as possíveis posições do anúncio.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH_SIDE Pesquisa do Google: Parte lateral.
SEARCH_TOP Pesquisa do Google: Parte superior.
SEARCH_OTHER Pesquisa do Google: Outro
CONTENT Rede de Display do Google.
SEARCH_PARTNER_TOP Parceiros de pesquisa: parte superior.
SEARCH_PARTNER_OTHER Parceiros de pesquisa: outro.
MIXED Várias redes.

ConversionValueRulePrimaryDimension

Identifica a dimensão principal das estatísticas de regras de valor da conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
NO_RULE_APPLIED Para conversões sem regra de valor aplicada após a ativação da regra de valor.
ORIGINAL Consulte abaixo as conversões aplicadas pela regra de valor: as estatísticas originais.
NEW_VS_RETURNING_USER Quando uma condição de cliente novo ou recorrente é satisfeita.
GEO_LOCATION Quando uma condição de localização geográfica no tempo de consulta é atendida.
DEVICE Quando uma condição do dispositivo de navegação durante a consulta é atendida.
AUDIENCE Quando uma condição de público-alvo no momento da consulta é atendida.
MULTIPLE Quando várias regras são aplicadas.

SkAdNetworkUserType

Enumera os tipos de usuário da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
NEW_INSTALLER O usuário instalou o app pela primeira vez.
REINSTALLER O usuário já instalou o app.

SkAdNetworkAdEventType

Enumera os tipos de evento de anúncio da SkAdNetwork

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
INTERACTION O usuário interagiu com o anúncio.
VIEW O usuário visualizou o anúncio.

SkAdNetworkSourceApp

Um segmento SkAdNetworkSourceApp.

Representação JSON
{
  "skAdNetworkSourceAppId": string
}
Campos
skAdNetworkSourceAppId

string

ID do app em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado.

SkAdNetworkAttributionCredit

Enumera os créditos de atribuição da SkAdNetwork.

Enums
UNSPECIFIED Valor padrão. Esse valor é equivalente a nulo.
UNKNOWN O valor é desconhecido nesta versão da API. O valor verdadeiro de enumeração não pode ser retornado nesta versão da API ou ainda não é compatível.
UNAVAILABLE O valor não estava presente no postback ou não temos esses dados por outros motivos.
WON O Google foi a rede de publicidade que ganhou a atribuição de anúncios.
CONTRIBUTED O Google se qualificou para a atribuição, mas não venceu.

AssetInteractionTarget

Um segmento AssetInteractionTarget.

Representação JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Campos
asset

string

O nome do recurso do recurso.

interactionOnThisAsset

boolean

Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.

ConvertingUserPriorEngagementTypeAndLtvBucket

Enumera os tipos de engajamento anteriores do usuário com conversão e o intervalo de valor da vida útil

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
NEW O usuário que realiza conversões é novo no anunciante.
RETURNING O usuário que realiza conversões está retornando ao anunciante. A definição de retorno difere entre os tipos de conversão, como uma segunda visita à loja em comparação com uma segunda compra on-line.
NEW_AND_HIGH_LTV O usuário que realiza conversões é novo para o anunciante e tem um alto valor da vida útil.