- Representação JSON
- AccountBudget
- AccountBudgetStatus
- PendingAccountBudgetProposal
- AdGroupAdAssetCombinationView
- AssetUsage
- AdGroupAdAssetView
- AdGroupAdAssetPolicySummary
- AdGroupAudienceView
- AdGroupCriterionSimulation
- SimulationType
- SimulationModificationMethod
- CpcBidSimulationPointList
- CpcBidSimulationPoint
- PercentCpcBidSimulationPointList
- PercentCpcBidSimulationPoint
- AdGroupSimulation
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- AgeRangeView
- AdScheduleView
- DomainCategory
- AssetFieldTypeView
- AssetGroupProductGroupView
- AssetSetTypeView
- BiddingStrategySimulation
- CallView
- CallTrackingDisplayLocation
- CallType
- GoogleVoiceCallStatus
- CampaignAudienceView
- CampaignSearchTermInsight
- CampaignSimulation
- TargetImpressionShareSimulationPointList
- TargetImpressionShareSimulationPoint
- BudgetSimulationPointList
- BudgetSimulationPoint
- CarrierConstant
- ChangeEvent
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
- ResourceChangeOperation
- ChangeStatus (em inglês)
- ChangeStatusResourceType
- ChangeStatusOperation
- CombinedAudience
- CombinedAudienceStatus
- ClickView
- ClickLocation
- CurrencyConstant
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas (em inglês)
- TargetSpend
- CustomerClient
- CustomerSearchTermInsight (em inglês)
- DetailPlacementView
- PlacementType
- DetailedDemographic
- CriterionCategoryAvailability
- CriterionCategoryChannelAvailability
- CriterionCategoryChannelAvailabilityMode
- CriterionCategoryLocaleAvailability
- CriterionCategoryLocaleAvailabilityMode
- DisplayKeywordView
- DistanceView
- DistanceBucket
- DynamicSearchAdsSearchTermView
- ExpandedLandingPageView
- FeedPlaceholderView
- GenderView
- GeographicView
- GeoTargetingType
- GroupPlacementView
- HotelGroupView
- HotelPerformanceView
- HotelReconciliation
- HotelReconciliationStatus
- IncomeRangeView
- KeywordView
- LandingPageView
- LanguageConstant
- LocationView
- ManagedPlacementView
- MobileAppCategoryConstant
- MobileDeviceConstant
- MobileDeviceType
- OperatingSystemVersionConstant
- OperatingSystemVersionOperatorType
- PaidOrganicSearchTermView
- QualifyingQuestion
- ParentalStatusView
- PerStoreView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryStatus
- ProductGroupView
- Recomendação
- RecommendationType
- RecommendationImpact
- RecommendationMetrics
- CampaignBudgetRecommendation
- CampaignBudgetRecommendationOption
- KeywordRecommendation
- SearchTerm
- TextAdRecommendation
- TargetCpaOptInRecommendation
- TargetCpaOptInRecommendationOption
- TargetCpaOptInRecommendationGoal
- MaximizeConversionsOptInRecommendation
- EnhancedCpcOptInRecommendation
- SearchPartnersOptInRecommendation
- MaximizeClicksOptInRecommendation
- OptimizeAdRotationRecommendation
- KeywordMatchTypeRecommendation
- MoveUnusedBudgetRecommendation
- TargetRoasOptInRecommendation
- ResponsiveSearchAdRecommendation
- UseBroadMatchKeywordRecommendation
- ResponsiveSearchAdAssetRecommendation
- UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
- ResponsiveSearchAdImproveAdStrengthRecommendation
- DisplayExpansionOptInRecommendation
- UpgradeLocalCampaignToPerformanceMaxRecommendation
- RaiseTargetCpaBidTooLowRecommendation
- ForecastingSetTargetRoasRecommendation
- CampaignBudget
- CalloutAssetRecommendation
- SitelinkAssetRecommendation
- CallAssetRecommendation
- ShoppingOfferAttributeRecommendation
- MerchantInfo
- ShoppingAddProductsToCampaignRecommendation
- Motivo
- ShoppingFixDisapprovedProductsRecommendation
- ShoppingTargetAllOffersRecommendation
- ShoppingMerchantCenterAccountSuspensionRecommendation
- ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
- DynamicImageExtensionOptInRecommendation
- RaiseTargetCpaRecommendation
- TargetAdjustmentInfo
- AppBiddingGoal
- LowerTargetRoasRecommendation
- PerformanceMaxOptInRecommendation
- ImprovePerformanceMaxAdStrengthRecommendation
- MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
- SearchTermView
- SearchTermTargetingStatus
- ShoppingPerformanceView
- SmartCampaignSearchTermView
- ThirdPartyAppAnalyticsLink
- TopicView
- TravelActivityGroupView
- TravelActivityPerformanceView
- UserInterest
- UserInterestTaxonomyType
- LifeEvent
- UserLocationView
- TopicConstant (link em inglês)
- Vídeo
- WebpageView
- LeadFormSubmissionData
- LeadFormSubmissionField
- CustomLeadFormSubmissionField
- Métricas
- InteractionEventType
- SearchVolumeRange
- Segmentos
- AdDestinationType
- AdNetworkType
- BudgetCampaignAssociationStatus
- BudgetCampaignAssociationStatus
- ClickType
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- Palavra-chave
- SearchEngineResultsPageType
- SearchTermMatchType
- Slot
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- SkAdNetworkAdEventType
- SkAdNetworkSourceApp
- SkAdNetworkAttributionCredit
- AssetInteractionTarget
- ConvertingUserPriorEngagementTypeAndLtvBucket
Uma linha retornada da consulta.
Representação JSON |
---|
{ "accountBudget": { object ( |
Campos | |
---|---|
accountBudget |
O orçamento da conta na consulta. |
accountBudgetProposal |
A proposta de orçamento da conta mencionada na consulta. |
accountLink |
O AccountLink mencionado na consulta. |
adGroup |
Grupo de anúncios mencionado na consulta. |
adGroupAd |
O anúncio mencionado na consulta. |
adGroupAdAssetCombinationView |
Visualização de combinações de recursos de anúncio do grupo de anúncios na consulta. |
adGroupAdAssetView |
A visualização dos recursos de anúncio do grupo de anúncios na consulta. |
adGroupAdLabel |
O rótulo do anúncio do grupo de anúncios mencionado na consulta. |
adGroupAsset |
O recurso do grupo de anúncios mencionado na consulta. |
adGroupAssetSet |
O conjunto de recursos do grupo de anúncios mencionado na consulta. |
adGroupAudienceView |
A visualização do público-alvo do grupo de anúncios mencionada na consulta. |
adGroupBidModifier |
O modificador de lance mencionado na consulta. |
adGroupCriterion |
O critério indicado na consulta. |
adGroupCriterionCustomizer |
O personalizador de critério do grupo de anúncios mencionado na consulta. |
adGroupCriterionLabel |
O rótulo do critério do grupo de anúncios mencionado na consulta. |
adGroupCriterionSimulation |
Simulação de critério do grupo de anúncios mencionada na consulta. |
adGroupCustomizer |
O personalizador de grupo de anúncios mencionado na consulta. |
adGroupExtensionSetting |
A configuração da extensão do grupo de anúncios mencionada na consulta. |
adGroupFeed |
O feed do grupo de anúncios mencionado na consulta. |
adGroupLabel |
O rótulo do grupo de anúncios mencionado na consulta. |
adGroupSimulation |
Simulação de grupo de anúncios mencionada na consulta. |
adParameter |
O parâmetro de anúncio referenciado na consulta. |
ageRangeView |
A visualização de faixa etária referenciada na consulta. |
adScheduleView |
A visualização da programação de anúncios referenciada na consulta. |
domainCategory |
A categoria de domínio indicada na consulta. |
asset |
O recurso referenciado na consulta. |
assetFieldTypeView |
A visualização do tipo de campo do recurso referenciada na consulta. |
assetGroupAsset |
O recurso do grupo de recursos referenciado na consulta. |
assetGroupSignal |
O indicador do grupo de recursos referenciado na consulta. |
assetGroupListingGroupFilter |
O filtro do grupo de produtos anunciados do grupo de recursos mencionado na consulta. |
assetGroupProductGroupView |
A visualização do grupo de produtos do grupo de recursos mencionada na consulta. |
assetGroup |
O grupo de recursos referenciado na consulta. |
assetSetAsset |
O recurso do conjunto de recursos referenciado na consulta. |
assetSet |
O conjunto de recursos referenciado na consulta. |
assetSetTypeView |
A visualização do tipo de conjunto de recursos referenciada na consulta. |
batchJob |
Trabalho em lote mencionado na consulta. |
biddingDataExclusion |
A exclusão de dados de lances mencionada na consulta. |
biddingSeasonalityAdjustment |
O ajuste periódico dos lances mencionado na consulta. |
biddingStrategy |
Estratégia de lances mencionada na consulta. |
biddingStrategySimulation |
Simulação de estratégia de lances mencionada na consulta. |
billingSetup |
A configuração de faturamento mencionada na consulta. |
callView |
A visualização da chamada referenciada na consulta. |
campaignBudget |
Orçamento da campanha mencionado na consulta. |
campaign |
A campanha mencionada na consulta. |
campaignAsset |
O recurso da campanha mencionado na consulta. |
campaignAssetSet |
O conjunto de recursos da campanha referenciado na consulta. |
campaignAudienceView |
A visualização do público-alvo da campanha mencionada na consulta. |
campaignBidModifier |
O modificador de lance da campanha mencionado na consulta. |
campaignConversionGoal |
A CampaignConversionGoal referenciada na consulta. |
campaignCriterion |
O critério de campanha indicado na consulta. |
campaignCustomizer |
O personalizador de campanha mencionado na consulta. |
campaignDraft |
O rascunho de campanha mencionado na consulta. |
campaignExtensionSetting |
A configuração de extensão da campanha mencionada na consulta. |
campaignFeed |
O feed de campanha mencionado na consulta. |
campaignGroup |
Grupo de campanhas mencionado na consulta AWQL. |
campaignLabel |
O rótulo da campanha mencionado na consulta. |
campaignSearchTermInsight |
O insight do termo de pesquisa da campanha mencionado na consulta. |
campaignSharedSet |
Conjunto compartilhado da campanha mencionado na consulta AWQL. |
campaignSimulation |
Simulação de campanha mencionada na consulta. |
carrierConstant |
A constante da operadora referenciada na consulta. |
changeEvent |
O ChangeEvent indicado na consulta. |
changeStatus |
ChangeStatus mencionado na consulta. |
combinedAudience |
O CombineAudience mencionado na consulta. |
audience |
O público-alvo mencionado na consulta. |
conversionAction |
Ação de conversão mencionada na consulta. |
conversionCustomVariable |
A variável personalizada de conversão referenciada na consulta. |
conversionGoalCampaignConfig |
A ConversionGoalCampaignConfig mencionada na consulta. |
conversionValueRule |
A regra do valor da conversão mencionada na consulta. |
conversionValueRuleSet |
O conjunto de regras do valor da conversão mencionado na consulta. |
clickView |
O ClickView mencionado na consulta. |
currencyConstant |
A constante de moeda referenciada na consulta. |
customAudience |
O CustomAudience referenciado na consulta. |
customConversionGoal |
O CustomConversionGoal mencionado na consulta. |
customInterest |
O Custom Interest referenciado na consulta. |
customer |
O cliente mencionado na consulta. |
customerAsset |
O recurso do cliente mencionado na consulta. |
customerAssetSet |
O conjunto de recursos do cliente mencionado na consulta. |
accessibleBiddingStrategy |
A estratégia de lances acessível mencionada na consulta. |
customerCustomizer |
O personalizador do cliente mencionado na consulta. |
customerManagerLink |
O CustomerManagerLink mencionado na consulta. |
customerClientLink |
O CustomerClientLink mencionado na consulta. |
customerClient |
O CustomerClient mencionado na consulta. |
customerConversionGoal |
O CustomerConversionGoal mencionado na consulta. |
customerExtensionSetting |
A configuração de extensão do cliente mencionada na consulta. |
customerFeed |
O feed de clientes mencionado na consulta. |
customerLabel |
O rótulo do cliente mencionado na consulta. |
customerNegativeCriterion |
O critério negativo do cliente mencionado na consulta. |
customerSearchTermInsight |
O insight do termo de pesquisa do cliente mencionado na consulta. |
customerUserAccess |
O CustomerUserAccess mencionado na consulta. |
customerUserAccessInvitation |
O CustomerUserAccessInvitation mencionado na consulta. |
customizerAttribute |
O atributo do personalizador referenciado na consulta. |
detailPlacementView |
A visualização de detalhes da posição mencionada na consulta. |
detailedDemographic |
É o grupo demográfico detalhado mencionado na consulta. |
displayKeywordView |
A visualização de palavra-chave da Rede de Display referenciada na consulta. |
distanceView |
A visualização da distância referenciada na consulta. |
dynamicSearchAdsSearchTermView |
Visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa mencionada na consulta. |
expandedLandingPageView |
A visualização da página de destino expandida mencionada na consulta. |
extensionFeedItem |
O item do feed da extensão mencionado na consulta. |
feed |
O feed mencionado na consulta. |
feedItem |
O item do feed mencionado na consulta. |
feedItemSet |
O item de feed definido como referência na consulta. |
feedItemSetLink |
O link do conjunto de itens do feed mencionado na consulta. |
feedItemTarget |
Destino do item de feed mencionado na consulta. |
feedMapping |
O mapeamento de feeds mencionado na consulta. |
feedPlaceholderView |
A visualização do marcador de posição do feed mencionada na consulta. |
genderView |
A visualização de gênero referenciada na consulta. |
geoTargetConstant |
A constante de segmentação geográfica referenciada na consulta. |
geographicView |
A visualização geográfica referenciada na consulta. |
groupPlacementView |
A visualização da posição do grupo referenciada na consulta. |
hotelGroupView |
A visualização do grupo de hotéis mencionada na consulta. |
hotelPerformanceView |
A visualização de desempenho do hotel referenciada na consulta. |
hotelReconciliation |
Reconciliação de hotéis mencionada na consulta. |
incomeRangeView |
Visualização da faixa de renda mencionada na consulta. |
keywordView |
Visualização de palavra-chave referenciada na consulta. |
keywordPlan |
Plano de palavras-chave mencionado na consulta. |
keywordPlanCampaign |
Campanha do plano de palavras-chave mencionada na consulta. |
keywordPlanCampaignKeyword |
A palavra-chave da campanha do plano de palavras-chave mencionada na consulta. |
keywordPlanAdGroup |
O grupo de anúncios do plano de palavras-chave mencionado na consulta. |
keywordPlanAdGroupKeyword |
O grupo de anúncios do plano de palavras-chave mencionado na consulta. |
keywordThemeConstant |
A constante de tema de palavra-chave referenciada na consulta. |
label |
O rótulo referenciado na consulta. |
landingPageView |
A visualização da página de destino mencionada na consulta. |
languageConstant |
A constante de linguagem referenciada na consulta. |
locationView |
A visualização do local referenciada na consulta. |
managedPlacementView |
A visualização da seleção manual de canais mencionada na consulta. |
mediaFile |
O arquivo de mídia referenciado na consulta. |
mobileAppCategoryConstant |
A constante da categoria de app para dispositivos móveis referenciada na consulta. |
mobileDeviceConstant |
A constante de dispositivo móvel referenciada na consulta. |
offlineUserDataJob |
O job de dados do usuário off-line mencionado na consulta. |
operatingSystemVersionConstant |
A constante de versão do sistema operacional referenciada na consulta. |
paidOrganicSearchTermView |
Visualização do termo de pesquisa orgânica paga mencionada na consulta. |
qualifyingQuestion |
A pergunta de qualificação citada na consulta. |
parentalStatusView |
A visualização do status parental mencionada na consulta. |
perStoreView |
A visualização por loja referenciada na consulta. |
productBiddingCategoryConstant |
A categoria de lances do produto mencionada na consulta. |
productGroupView |
A visualização do grupo de produtos referenciada na consulta. |
productLink |
Link do produto mencionado na consulta. |
recommendation |
Recomendação referenciada na consulta. |
searchTermView |
Visualização do termo de pesquisa mencionado na consulta. |
sharedCriterion |
O conjunto compartilhado referenciado na consulta. |
sharedSet |
O conjunto compartilhado referenciado na consulta. |
smartCampaignSetting |
A configuração da campanha inteligente mencionada na consulta. |
shoppingPerformanceView |
A visualização de desempenho de compras referenciada na consulta. |
smartCampaignSearchTermView |
Visualização do termo de pesquisa da campanha inteligente mencionado na consulta. |
thirdPartyAppAnalyticsLink |
O AccountLink mencionado na consulta. |
topicView |
A visualização de tópicos referenciada na consulta. |
travelActivityGroupView |
A visualização do grupo de atividades de viagem referenciada na consulta. |
travelActivityPerformanceView |
A visualização de desempenho das atividades de viagem referenciada na consulta. |
experiment |
O experimento mencionado na consulta. |
experimentArm |
O grupo experimental mencionado na consulta. |
userInterest |
O interesse do usuário referenciado na consulta. |
lifeEvent |
O evento importante referenciado na consulta. |
userList |
A lista de usuários referenciada na consulta. |
userLocationView |
A visualização do local do usuário referenciada na consulta. |
remarketingAction |
A ação de remarketing referenciada na consulta. |
topicConstant |
A constante de tópico referenciada na consulta. |
video |
Vídeo mencionado na consulta. |
webpageView |
A visualização da página da Web mencionada na consulta. |
leadFormSubmissionData |
O envio do usuário do formulário de lead mencionado na consulta. |
metrics |
As métricas. |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
status |
Apenas saída. O status desse orçamento em nível de conta. |
totalAdjustmentsMicros |
Apenas saída. O valor total dos ajustes. Um exemplo de ajuste são os créditos de cortesia. |
amountServedMicros |
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 |
Apenas saída. A proposta pendente para modificar o orçamento, se aplicável. |
id |
Apenas saída. O ID do orçamento em nível de conta. |
billingSetup |
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:
|
name |
Apenas saída. O nome do orçamento em nível de conta. |
proposedStartDateTime |
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 |
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 |
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 |
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 |
Apenas saída. O horário de término proposto no formato aaaa-MM-dd HH:mm:ss. |
proposedEndTimeType |
Apenas saída. O horário de término proposto como um tipo bem definido, por exemplo, FOREVER. |
Campo de união 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. |
|
approvedEndDateTime |
Apenas saída. A hora de término aprovada no formato aaaa-MM-dd HH:mm:ss. |
approvedEndTimeType |
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 |
Apenas saída. O limite de gastos proposto em micros. Um milhão de micros é equivalente a uma unidade. |
proposedSpendingLimitType |
Apenas saída. O limite de gastos proposto como um tipo bem definido, por exemplo, INFINITE. |
Campo de união 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. |
|
approvedSpendingLimitMicros |
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 |
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 Esse valor tem a palavra final sobre quanto a conta pode gastar. |
|
adjustedSpendingLimitMicros |
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 |
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 ( |
Campos | |
---|---|
proposalType |
Apenas saída. O tipo da proposta, por exemplo, FIM para encerrar o orçamento associado a ela. |
accountBudgetProposal |
Apenas saída. O nome do recurso da proposta. Os nomes dos recursos AccountBudgetProposal têm o seguinte formato:
|
name |
Apenas saída. O nome a atribuir ao orçamento em nível de conta. |
startDateTime |
Apenas saída. A hora de início no formato aaaa-MM-dd HH:mm:ss. |
purchaseOrderNumber |
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 |
Apenas saída. Observações associadas a este orçamento. |
creationDateTime |
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 |
Apenas saída. A hora de término no formato aaaa-MM-dd HH:mm:ss. |
endTimeType |
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 |
Apenas saída. O limite de gastos, em micros. Um milhão de micros é equivalente a uma unidade. |
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 ( |
Campos | |
---|---|
resourceName |
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: |
servedAssets[] |
Apenas saída. Recursos veiculados. |
enabled |
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 ( |
Campos | |
---|---|
asset |
Nome do recurso. |
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 ( |
Campos | |
---|---|
resourceName |
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):
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):
|
fieldType |
Apenas saída. A função que o recurso assume no anúncio. |
policySummary |
Apenas saída. Informações de política para o recurso de anúncio do grupo de anúncios. |
performanceLabel |
Apenas saída. Desempenho de uma vinculação de recursos. |
pinnedField |
Apenas saída. Campo fixado. |
adGroupAd |
Apenas saída. O anúncio do grupo de anúncios ao qual o recurso está vinculado. |
asset |
Apenas saída. O recurso que está vinculado ao anúncio do grupo de anúncios. |
enabled |
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 ( |
Campos | |
---|---|
policyTopicEntries[] |
Apenas saída. A lista de descobertas da política para o recurso de anúncio do grupo de anúncios. |
reviewStatus |
Apenas saída. Em que ponto do processo de revisão esse recurso de anúncio do grupo de anúncios está. |
approvalStatus |
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 |
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:
|
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.
- DISPLAY – PALAVRA-CHAVE – CPC_BID – UNIFORM
- PESQUISA – PALAVRA-CHAVE – CPC_BID – UNIFORM
- SHOPPING – LISTING_GROUP – CPC_BID – UNIFORM
- HOTEL – LISTING_GROUP – CPC_BID – UNIFORM
- HOTEL – LISTING_GROUP – PERCENT_CPC_BID – UNIFORM
Representação JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
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:
|
type |
Apenas saída. O campo que a simulação modifica. |
modificationMethod |
Apenas saída. Como a simulação modifica o campo. |
adGroupId |
Apenas saída. ID do grupo de anúncios da simulação. |
criterionId |
Apenas saída. ID do critério da simulação. |
startDate |
Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD. |
endDate |
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 |
Apenas saída. Pontos de simulação se o tipo de simulação for CPC_BID. |
percentCpcBidPointList |
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 ( |
Campos | |
---|---|
points[] |
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 |
Campos | |
---|---|
requiredBudgetAmountMicros |
É 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 |
Número projetado de conversões que recebem lances. |
biddableConversionsValue |
Valor total previsto das conversões que recebem lances. |
clicks |
Número projetado de cliques. |
costMicros |
Custo projetado em micros. |
impressions |
Número projetado de impressões. |
topSlotImpressions |
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 |
O lance de CPC simulado no qual as métricas projetadas se baseiam. |
cpcBidScalingModifier |
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 ( |
Campos | |
---|---|
points[] |
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 |
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 |
Número projetado de conversões que recebem lances. |
biddableConversionsValue |
Valor total previsto das conversões que recebem lances na moeda local. |
clicks |
Número projetado de cliques. |
costMicros |
Custo projetado em micros. |
impressions |
Número projetado de impressões. |
topSlotImpressions |
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.
- PESQUISA - CPC_BID - PADRÃO
- PESQUISA - CPC_BID - UNIFORM
- PESQUISA - TARGET_CPA - UNIFORM
- PESQUISA - TARGET_ROAS - UNIFORM
- DISPLAY – CPC_BID – PADRÃO
- DISPLAY - CPC_BID - UNIFORM
- DISPLAY - TARGET_CPA - UNIFORM
Representação JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
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:
|
type |
Apenas saída. O campo que a simulação modifica. |
modificationMethod |
Apenas saída. Como a simulação modifica o campo. |
adGroupId |
Apenas saída. ID do grupo de anúncios da simulação. |
startDate |
Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD. |
endDate |
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 |
Apenas saída. Pontos de simulação se o tipo de simulação for CPC_BID. |
cpvBidPointList |
Apenas saída. Pontos de simulação se o tipo de simulação for CPV_BID. |
targetCpaPointList |
Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_CPA. |
targetRoasPointList |
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 ( |
Campos | |
---|---|
points[] |
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 |
O lance de CPV simulado em que as métricas projetadas se baseiam. |
costMicros |
Custo projetado em micros. |
impressions |
Número projetado de impressões. |
views |
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 ( |
Campos | |
---|---|
points[] |
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 |
Campos | |
---|---|
requiredBudgetAmountMicros |
É 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 |
Número projetado de instalações de apps. |
inAppActions |
Número estimado de ações no app. |
biddableConversions |
Número projetado de conversões que recebem lances. |
biddableConversionsValue |
Valor total previsto das conversões que recebem lances. |
clicks |
Número projetado de cliques. |
costMicros |
Custo projetado em micros. |
impressions |
Número projetado de impressões. |
topSlotImpressions |
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 |
O CPA desejado simulado em que as métricas projetadas são baseadas. |
targetCpaScalingModifier |
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 ( |
Campos | |
---|---|
points[] |
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 |
É 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 |
O ROAS desejado simulado em que as métricas projetadas são baseadas. |
biddableConversions |
Número projetado de conversões que recebem lances. |
biddableConversionsValue |
Valor total previsto das conversões que recebem lances. |
clicks |
Número projetado de cliques. |
costMicros |
Custo projetado em micros. |
impressions |
Número projetado de impressões. |
topSlotImpressions |
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 |
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:
|
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 |
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:
|
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 |
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:
|
campaign |
Apenas saída. A campanha para a qual essa categoria é recomendada. |
category |
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 |
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 |
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 |
Apenas saída. Fração de páginas no seu site que correspondem a esta categoria. |
categoryRank |
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 |
Apenas saída. Indica se essa categoria tem subcategorias. |
recommendedCpcBidMicros |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
fieldType |
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 |
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:
|
assetGroup |
Apenas saída. O grupo de recursos associado ao filtro do grupo de fichas. |
assetGroupListingGroupFilter |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
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.
- TARGET_CPA: UNIFORM
- TARGET_ROAS – UNIFORM
Representação JSON |
---|
{ "resourceName": string, "biddingStrategyId": string, "type": enum ( |
Campos | |
---|---|
resourceName |
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:
|
biddingStrategyId |
Apenas saída. ID do conjunto compartilhado da estratégia de lances da simulação. |
type |
Apenas saída. O campo que a simulação modifica. |
modificationMethod |
Apenas saída. Como a simulação modifica o campo. |
startDate |
Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD. |
endDate |
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 |
Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_CPA. |
targetRoasPointList |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
callerCountryCode |
Apenas saída. Código do país do autor da chamada. |
callerAreaCode |
Apenas saída. Código de área do autor da chamada. Nulo se a duração da chamada for menor que 15 segundos. |
callDurationSeconds |
Apenas saída. A duração em segundos da chamada fornecida pelo anunciante. |
startCallDateTime |
Apenas saída. A hora de início da chamada fornecida pelo anunciante. |
endCallDateTime |
Apenas saída. A data de término da chamada fornecida pelo anunciante. |
callTrackingDisplayLocation |
Apenas saída. O local de exibição do acompanhamento de chamadas. |
type |
Apenas saída. O tipo da chamada. |
callStatus |
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. |
HIGH_END_MOBILE_SEARCH |
A chamada foi um clique para ligar para celular. |
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 |
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:
|
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 |
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:
|
categoryLabel |
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 |
Apenas saída. O ID do insight. |
campaignId |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
campaignId |
Apenas saída. ID da campanha da simulação. |
type |
Apenas saída. O campo que a simulação modifica. |
modificationMethod |
Apenas saída. Como a simulação modifica o campo. |
startDate |
Apenas saída. Primeiro dia em que a simulação se baseia, no formato AAAA-MM-DD. |
endDate |
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 |
Apenas saída. Pontos de simulação se o tipo de simulação for CPC_BID. |
targetCpaPointList |
Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_CPA. |
targetRoasPointList |
Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_ROAS. |
targetImpressionSharePointList |
Apenas saída. Pontos de simulação se o tipo de simulação for TARGET_IMPRESSION_SHARE. |
budgetPointList |
Apenas saída. Pontos de simulação se o tipo de simulação for BUDGET. |
BudgetSimulationPointList
Um contêiner com pontos de simulação para simulações do tipo BUDGET.
Representação JSON |
---|
{
"points": [
{
object ( |
Campos | |
---|---|
points[] |
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 |
O orçamento simulado em que as métricas projetadas se baseiam. |
requiredCpcBidCeilingMicros |
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 |
Número projetado de conversões que recebem lances. |
biddableConversionsValue |
Valor total previsto das conversões que recebem lances. |
clicks |
Número projetado de cliques. |
costMicros |
Custo projetado em micros. |
impressions |
Número projetado de impressões. |
topSlotImpressions |
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 |
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:
|
id |
Apenas saída. O ID do critério da operadora. |
name |
Apenas saída. O nome completo da operadora em inglês. |
countryCode |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
changeDateTime |
Apenas saída. Horário em que a alteração foi confirmada neste recurso. |
changeResourceType |
Apenas saída. O tipo do recurso alterado. Isso determina qual recurso será definido em oldResource e newResource. |
changeResourceName |
Apenas saída. O recurso "Simples" em que essa mudança ocorreu. |
clientType |
Apenas saída. Onde a mudança foi feita. |
userEmail |
Apenas saída. O e-mail do usuário que fez a alteração. |
oldResource |
Apenas saída. O recurso antigo antes da alteração. Somente os campos alterados serão preenchidos. |
newResource |
Apenas saída. O novo recurso após a alteração. Somente os campos alterados serão preenchidos. |
resourceChangeOperation |
Apenas saída. A operação no recurso alterado. |
changedFields |
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: |
campaign |
Apenas saída. A campanha afetada por essa alteração. |
adGroup |
Apenas saída. O grupo de anúncios afetado por essa alteração. |
feed |
Apenas saída. O feed afetado por essa mudança. |
feedItem |
Apenas saída. O item de feed afetado por essa alteração. |
asset |
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 ( |
Campos | |
---|---|
ad |
Apenas saída. Definido se changeResourceType == AD. |
adGroup |
Apenas saída. Definido se changeResourceType == AD_GROUP. |
adGroupCriterion |
Apenas saída. Definido se changeResourceType == AD_GROUP_criteria |
campaign |
Apenas saída. Defina se changeResourceType == CAMPAIGN. |
campaignBudget |
Apenas saída. Definido se changeResourceType == CAMPAIGN_BUDGET. |
adGroupBidModifier |
Apenas saída. Definido se changeResourceType == AD_GROUP_BID_MODIFIER. |
campaignCriterion |
Apenas saída. Defina se changeResourceType == CAMPAIGN_ etapa. |
feed |
Apenas saída. Definido se changeResourceType == FEED. |
feedItem |
Apenas saída. Definido se changeResourceType == FEED_ITEM. |
campaignFeed |
Apenas saída. Definido se changeResourceType == CAMPAIGN_FEED. |
adGroupFeed |
Apenas saída. Definido se changeResourceType == AD_GROUP_FEED. |
adGroupAd |
Apenas saída. Definido se changeResourceType == AD_GROUP_AD. |
asset |
Apenas saída. Definido se changeResourceType == ASSET. |
customerAsset |
Apenas saída. Definido se changeResourceType == CUSTOMER_ASSET. |
campaignAsset |
Apenas saída. Definido se changeResourceType == CAMPAIGN_ASSET. |
adGroupAsset |
Apenas saída. Definido se changeResourceType == AD_GROUP_ASSET. |
assetSet |
Apenas saída. Definido se changeResourceType == ASSET_SET. |
assetSetAsset |
Apenas saída. Definido se changeResourceType == ASSET_SET_ASSET. |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
resourceType |
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 |
Apenas saída. Representa o status do recurso alterado. |
sharedSet |
Apenas saída. O SharedSet afetado por essa mudança. |
campaignSharedSet |
Apenas saída. O CampaignSharedSet afetado por essa alteração. |
asset |
Apenas saída. O recurso afetado por essa mudança. |
customerAsset |
Apenas saída. O CustomerAsset afetado por esta mudança. |
campaignAsset |
Apenas saída. O CampaignAsset afetado por essa alteração. |
adGroupAsset |
Apenas saída. O grupo de anúncios afetado por essa alteração. |
combinedAudience |
Apenas saída. O público-alvo combinado afetado por essa mudança. |
lastChangeDateTime |
Apenas saída. Horário em que a alteração mais recente ocorreu nesse recurso. |
campaign |
Apenas saída. A campanha afetada por essa alteração. |
adGroup |
Apenas saída. O grupo de anúncios afetado por essa alteração. |
adGroupAd |
Apenas saída. O GroupAd afetado por essa alteração. |
adGroupCriterion |
Apenas saída. O gclid afetado por essa alteração. |
campaignCriterion |
Apenas saída. O Campaigncriterio afetado por essa alteração. |
feed |
Apenas saída. O feed afetado por essa mudança. |
feedItem |
Apenas saída. O item de feed afetado por essa alteração. |
adGroupFeed |
Apenas saída. O GroupFeed afetado por essa alteração. |
campaignFeed |
Apenas saída. O CampaignFeed afetado por essa alteração. |
adGroupBidModifier |
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 ( |
Campos | |
---|---|
resourceName |
Imutável. O nome do recurso do público-alvo combinado. Os nomes de públicos-alvo combinados têm o seguinte formato:
|
id |
Apenas saída. ID do público-alvo combinado. |
status |
Apenas saída. Status deste público-alvo combinado. Indica se o público-alvo combinado está ativado ou removido. |
name |
Apenas saída. Nome do público-alvo combinado. Ele precisa ser único em todos os públicos-alvo combinados. |
description |
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 ( |
Campos | |
---|---|
resourceName |
Apenas saída. O nome do recurso da visualização com clique. Os nomes dos recursos de visualização têm o seguinte formato:
|
areaOfInterest |
Apenas saída. Os critérios de local que correspondem à área de interesse associada à impressão. |
locationOfPresence |
Apenas saída. Os critérios de local que correspondem ao local de presença associado à impressão. |
keyword |
Apenas saída. A palavra-chave associada, se houver, e o clique corresponder ao canal SEARCH. |
keywordInfo |
Apenas saída. Informações básicas sobre a palavra-chave associada, se houver. |
gclid |
Apenas saída. O ID de clique do Google. |
pageNumber |
Apenas saída. Número da página nos resultados de pesquisa em que o anúncio foi exibido. |
adGroupAd |
Apenas saída. O anúncio associado. |
campaignLocationTarget |
Apenas saída. O local de segmentação associado à campanha, se houver. |
userList |
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 |
O critério do local da cidade associado à impressão. |
country |
O critério do local de país associado à impressão. |
metro |
O critério de localização de área metropolitana associado à impressão. |
mostSpecific |
O critério de local mais específico associado à impressão. |
region |
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 |
Apenas saída. O nome do recurso da constante de moeda. Os nomes de recursos de constante de moeda têm o seguinte formato:
|
code |
Apenas saída. Código de moeda de três letras do ISO 4217, por exemplo, "USD" |
name |
Apenas saída. Nome completo da moeda em inglês. |
symbol |
Apenas saída. Símbolo padrão para descrever esta moeda, por exemplo, "$" para dólares americanos. |
billableUnitMicros |
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 ( |
Campos | |
---|---|
resourceName |
Apenas saída. O nome do recurso da estratégia de lances acessível. Os nomes dos recursos AccessibleBiddingStrategy têm o seguinte formato:
|
id |
Apenas saída. O ID da estratégia de lances. |
name |
Apenas saída. É o nome da estratégia de lances. |
type |
Apenas saída. É o tipo de estratégia de lances. |
ownerCustomerId |
Apenas saída. O ID do cliente proprietário da estratégia de lances. |
ownerDescriptiveName |
Somente saída. DescriptionName do Cliente que é proprietário da estratégia de lances. |
Campo de união Somente um pode ser definido. |
|
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 |
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 |
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 |
Apenas saída. Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões. |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
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 ( |
Campos | |
---|---|
resourceName |
Apenas saída. O nome do recurso do cliente do cliente. Os nomes dos recursos do CustomerClient têm o formato: |
appliedLabels[] |
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:
|
status |
Apenas saída. O status do cliente. Somente leitura. |
clientCustomer |
Apenas saída. O nome do recurso cliente-cliente vinculado ao cliente em questão. Somente leitura. |
level |
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 |
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 |
Apenas saída. Identifica se o cliente é uma conta de teste. Somente leitura. |
manager |
Apenas saída. Identifica se o cliente é um gerente. Somente leitura. |
descriptiveName |
Apenas saída. Nome descritivo para o cliente. Somente leitura. |
currencyCode |
Apenas saída. Código da moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura. |
id |
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 |
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:
|
categoryLabel |
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 |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
placementType |
Apenas saída. Tipo de canal, por exemplo, "Site", "Vídeo do YouTube" e "Aplicativo para dispositivos móveis". |
placement |
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 |
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 |
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 |
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 ( |
Campos | |
---|---|
resourceName |
Apenas saída. O nome do recurso do grupo demográfico detalhado. Os nomes dos recursos demográficos detalhados têm o seguinte formato:
|
id |
Apenas saída. É o ID do grupo demográfico detalhado. |
name |
Apenas saída. É o nome do grupo demográfico detalhado. Por exemplo,"Nível mais alto de realização educacional". |
parent |
Apenas saída. O pai de detalheDemográfico. |
launchedToAll |
Apenas saída. Verdadeiro se as informações demográficas detalhadas foram lançadas para todos os canais e localidades. |
availabilities[] |
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 ( |
Campos | |
---|---|
channel |
Tipos e subtipos de canal disponíveis para a categoria. |
locale[] |
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 ( |
Campos | |
---|---|
availabilityMode |
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 |
Tipo de canal para o qual a categoria está disponível. |
advertisingChannelSubType[] |
Subtipos de canal no tipo de canal para o qual a categoria está disponível. |
includeDefaultChannelSubType |
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 ( |
Campos | |
---|---|
availabilityMode |
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 |
O código do país ISO-3166-1 alfa-2 associado à categoria. |
languageCode |
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 |
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:
|
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 ( |
Campos | |
---|---|
resourceName |
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:
|
distanceBucket |
Apenas saída. Agrupamento de distâncias do usuário das extensões de local. |
metricSystem |
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 |
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:
|
searchTerm |
Apenas saída. Termo de pesquisa Este campo é somente leitura. |
headline |
Apenas saída. O título do anúncio dinâmico de pesquisa gerado dinamicamente. Este campo é somente leitura. |
landingPage |
Apenas saída. O URL da página de destino da impressão selecionado dinamicamente. Este campo é somente leitura. |
pageUrl |
Apenas saída. É o URL do item do feed de páginas veiculado para a impressão. Este campo é somente leitura. |
hasNegativeKeyword |
Apenas saída. Verdadeiro se a consulta corresponder a uma palavra-chave negativa. Este campo é somente leitura. |
hasMatchingKeyword |
Apenas saída. Verdadeiro se a consulta for adicionada às palavras-chave segmentadas. Este campo é somente leitura. |
hasNegativeUrl |
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 |
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:
|
expandedFinalUrl |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
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 |
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:
|
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 ( |
Campos | |
---|---|
resourceName |
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:
|
locationType |
Apenas saída. Tipo de segmentação por área geográfica da campanha. |
countryCriterionId |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
placementType |
Apenas saída. Tipo de canal, por exemplo, "Site", "Canal do YouTube", "App para dispositivos móveis". |
placement |
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 |
Apenas saída. Nome de domínio para sites e nome de canal do YouTube para canais do YouTube. |
targetUrl |
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 |
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:
|
HotelPerformanceView
Uma visão do desempenho de um hotel.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
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 ( |
Campos | |
---|---|
resourceName |
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:
|
commissionId |
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 |
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 |
Apenas saída. O nome do recurso da campanha associada à conversão. |
hotelCenterId |
Apenas saída. Identificador da conta da Central para Hotéis que informa as tarifas da campanha de hotel. |
hotelId |
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 |
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 |
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 |
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 |
Apenas saída. se uma reserva foi faturada ou não. Depois de faturada, não é possível modificar uma reserva. |
status |
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 |
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:
|
KeywordView
Uma visualização de palavras-chave.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
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 |
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:
|
unexpandedFinalUrl |
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 |
Apenas saída. O nome do recurso da constante de linguagem. Os nomes de recursos de constantes de linguagem têm o seguinte formato:
|
id |
Apenas saída. O ID da constante de linguagem. |
code |
Apenas saída. O código de idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc. |
name |
Apenas saída. O nome completo do idioma em inglês, por exemplo, "Inglês (EUA)", "Espanhol" etc. |
targetable |
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 |
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:
|
ManagedPlacementView
Uma visualização de seleção manual de canais.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
MobileAppCategoryConstant
Uma constante da categoria de aplicativo para dispositivos móveis.
Representação JSON |
---|
{ "resourceName": string, "id": integer, "name": string } |
Campos | |
---|---|
resourceName |
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:
|
id |
Apenas saída. O ID da constante da categoria do app para dispositivos móveis. |
name |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
type |
Apenas saída. O tipo de dispositivo móvel. |
id |
Apenas saída. O ID da constante do dispositivo móvel. |
name |
Apenas saída. O nome do dispositivo móvel. |
manufacturerName |
Apenas saída. O fabricante do dispositivo móvel. |
operatingSystemName |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
operatorType |
Apenas saída. Determina se esta constante representa uma única versão ou um intervalo de versões. |
id |
Apenas saída. O ID da versão do sistema operacional. |
name |
Apenas saída. Nome do sistema operacional. |
osMajorVersion |
Apenas saída. O número da versão principal do SO. |
osMinorVersion |
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 |
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:
|
searchTerm |
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 |
Apenas saída. O nome do recurso da pergunta de qualificação. 'QualifyingQuestions/{qualifiedingQuestionId}" |
qualifyingQuestionId |
Apenas saída. O ID da pergunta de qualificação. |
locale |
Apenas saída. O local da pergunta de qualificação. |
text |
Apenas saída. A pergunta de qualificação. |
ParentalStatusView
Uma visualização do status parental.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
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 |
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:
|
placeId |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
level |
Apenas saída. Nível da categoria de lances do produto. |
status |
Apenas saída. Status da categoria de lances do produto. |
id |
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 |
Apenas saída. Código do país com duas letras maiúsculas da categoria de lances do produto. |
productBiddingCategoryConstantParent |
Apenas saída. Nome do recurso da categoria de lances do produto pai. |
languageCode |
Apenas saída. Código do idioma da categoria de lances do produto. |
localizedName |
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 |
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:
|
Recomendação
Uma recomendação.
Representação JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
Imutável. O nome do recurso da recomendação.
|
type |
Apenas saída. O tipo de recomendação. |
impact |
Apenas saída. O impacto na performance da conta como resultado da aplicação da recomendação. |
campaigns[] |
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 |
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 |
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 |
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 |
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 |
Apenas saída. A recomendação de orçamento da campanha. |
forecastingCampaignBudgetRecommendation |
Apenas saída. A recomendação de estimativa de orçamento da campanha. |
keywordRecommendation |
Apenas saída. A recomendação da palavra-chave. |
textAdRecommendation |
Apenas saída. Adicionar recomendação de anúncio de texto expandido |
targetCpaOptInRecommendation |
Apenas saída. A recomendação de ativação do CPA desejado. |
maximizeConversionsOptInRecommendation |
Apenas saída. A recomendação de ativação da estratégia "Maximizar conversões". |
enhancedCpcOptInRecommendation |
Apenas saída. A recomendação de ativação do custo por clique otimizado. |
searchPartnersOptInRecommendation |
Apenas saída. A recomendação para ativar os parceiros de pesquisa. |
maximizeClicksOptInRecommendation |
Apenas saída. A recomendação de ativação "MaximizarClicks". |
optimizeAdRotationRecommendation |
Apenas saída. A recomendação "Otimizar a rotação de anúncios". |
keywordMatchTypeRecommendation |
Apenas saída. A recomendação de tipo de correspondência de palavra-chave. |
moveUnusedBudgetRecommendation |
Apenas saída. A recomendação de orçamento não utilizado da migração. |
targetRoasOptInRecommendation |
Apenas saída. A recomendação de ativação do ROAS desejado. |
responsiveSearchAdRecommendation |
Apenas saída. A recomendação de adicionar anúncios responsivos de pesquisa. |
marginalRoiCampaignBudgetRecommendation |
Apenas saída. A recomendação de orçamento da campanha com ROI mínimo. |
useBroadMatchKeywordRecommendation |
Apenas saída. Usar a recomendação de palavra-chave de correspondência ampla. |
responsiveSearchAdAssetRecommendation |
Apenas saída. A recomendação de recursos de anúncios responsivos de pesquisa. |
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation |
Apenas saída. Fazer upgrade de uma campanha inteligente do Shopping para uma recomendação de campanha Performance Max |
responsiveSearchAdImproveAdStrengthRecommendation |
Apenas saída. Recomendação de melhoria da qualidade do anúncio responsivo de pesquisa. |
displayExpansionOptInRecommendation |
Apenas saída. Recomendação de ativação da Inclusão da Rede de Display. |
upgradeLocalCampaignToPerformanceMaxRecommendation |
Apenas saída. Fazer upgrade de uma campanha local para uma recomendação de campanha Performance Max |
raiseTargetCpaBidTooLowRecommendation |
Apenas saída. A recomendação de aumentar o lance de CPA desejado é muito baixa. |
forecastingSetTargetRoasRecommendation |
Apenas saída. A recomendação de ROAS desejado definido pela estimativa. |
calloutAssetRecommendation |
Apenas saída. A recomendação de recurso de frase de destaque. |
sitelinkAssetRecommendation |
Apenas saída. A recomendação do recurso de sitelink. |
callAssetRecommendation |
Apenas saída. A recomendação do recurso de ligação. |
shoppingAddAgeGroupRecommendation |
Apenas saída. A recomendação de faixa etária de adição do Shopping. |
shoppingAddColorRecommendation |
Apenas saída. A recomendação de adição de cores do Shopping. |
shoppingAddGenderRecommendation |
Apenas saída. A recomendação de adicionar gênero ao Shopping. |
shoppingAddGtinRecommendation |
Apenas saída. A recomendação de GTIN de adição do Shopping. |
shoppingAddMoreIdentifiersRecommendation |
Apenas saída. Recomendação do Shopping para adicionar mais identificadores. |
shoppingAddSizeRecommendation |
Apenas saída. A recomendação de tamanho de anúncios do Shopping. |
shoppingAddProductsToCampaignRecommendation |
Apenas saída. A recomendação do Shopping para adicionar produtos à campanha |
shoppingFixDisapprovedProductsRecommendation |
Apenas saída. Recomendação de produtos reprovados para correção do Shopping. |
shoppingTargetAllOffersRecommendation |
Apenas saída. O destino de compras oferece recomendações de todas as ofertas. |
shoppingFixSuspendedMerchantCenterAccountRecommendation |
Apenas saída. A correção do Shopping suspendeu a recomendação da conta do Merchant Center. |
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation |
Apenas saída. A recomendação de aviso de suspensão da conta do Merchant Center com correção do Shopping. |
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation |
Apenas saída. O Shopping migra as ofertas da campanha normal do Shopping para a recomendação das campanhas Performance Max. |
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 |
Apenas saída. Recomendação para aumentar o CPA desejado. |
lowerTargetRoasRecommendation |
Apenas saída. Recomendação para diminuir o ROAS desejado. |
performanceMaxOptInRecommendation |
Apenas saída. A recomendação de ativação das campanhas Performance Max. |
improvePerformanceMaxAdStrengthRecommendation |
Apenas saída. A recomendação para melhorar a qualidade do anúncio nas campanhas Performance Max. |
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. |
SITELINK_ASSET |
Recomendação para adicionar recursos de sitelink 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 ( |
Campos | |
---|---|
baseMetrics |
Apenas saída. Métricas de base no momento em que a recomendação foi gerada. |
potentialMetrics |
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 |
Apenas saída. Número de impressões de anúncios. |
clicks |
Apenas saída. Número de cliques no anúncio. |
costMicros |
Apenas saída. Custo (em micros) da publicidade na moeda local da conta. |
conversions |
Apenas saída. Número de conversões. |
videoViews |
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 ( |
Campos | |
---|---|
budgetOptions[] |
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 |
Apenas saída. O valor atual do orçamento em micros. |
recommendedBudgetAmountMicros |
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 ( |
Campos | |
---|---|
impact |
Apenas saída. A estimativa de impacto se o orçamento for alterado para o valor especificado nessa opção. |
budgetAmountMicros |
Apenas saída. O valor do orçamento dessa opção. |
KeywordRecommendation
A recomendação da palavra-chave.
Representação JSON |
---|
{ "keyword": { object ( |
Campos | |
---|---|
keyword |
Apenas saída. A palavra-chave recomendada. |
searchTerms[] |
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 |
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 |
Apenas saída. O texto do termo de pesquisa. |
estimatedWeeklySearchCount |
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 ( |
Campos | |
---|---|
ad |
Apenas saída. Anúncio recomendado. |
creationDate |
Apenas saída. Data de criação do anúncio recomendado. no formato AAAA-MM-DD, por exemplo, 2018-04-17. |
autoApplyDate |
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 ( |
Campos | |
---|---|
options[] |
Apenas saída. As metas disponíveis e as opções correspondentes para a estratégia de CPA desejado. |
recommendedTargetCpaMicros |
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 ( |
Campos | |
---|---|
goal |
Apenas saída. O objetivo alcançado com essa opção. |
impact |
Apenas saída. A estimativa de impacto, se esta opção for selecionada. |
targetCpaMicros |
Apenas saída. Meta de CPA médio. |
requiredCampaignBudgetAmountMicros |
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 |
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 |
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 ( |
Campos | |
---|---|
keyword |
Apenas saída. A palavra-chave atual em que o tipo de correspondência deve ser mais amplo. |
recommendedMatchType |
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 ( |
Campos | |
---|---|
budgetRecommendation |
Apenas saída. A recomendação para aumentar o orçamento limitado. |
excessCampaignBudget |
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 |
Apenas saída. O ROAS desejado recomendado (receita por unidade de gasto). O valor está entre 0,01 e 1000,0. |
requiredCampaignBudgetAmountMicros |
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 ( |
Campos | |
---|---|
ad |
Apenas saída. Anúncio recomendado. |
UseBroadMatchKeywordRecommendation
Usar a recomendação de palavra-chave de correspondência ampla.
Representação JSON |
---|
{
"keyword": [
{
object ( |
Campos | |
---|---|
keyword[] |
Apenas saída. Exemplo de palavras-chave que serão expandidas para correspondência ampla. |
suggestedKeywordsCount |
Apenas saída. Número total de palavras-chave a serem expandidas para correspondência ampla na campanha. |
campaignKeywordsCount |
Apenas saída. Número total de palavras-chave na campanha. |
campaignUsesSharedBudget |
Apenas saída. Indica se a campanha associada usa um orçamento compartilhado. |
requiredCampaignBudgetAmountMicros |
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 ( |
Campos | |
---|---|
currentAd |
Apenas saída. O anúncio atual a ser atualizado. |
recommendedAssets |
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 |
Apenas saída. ID da conta do Merchant Center. |
salesCountryCode |
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 ( |
Campos | |
---|---|
currentAd |
Apenas saída. O anúncio atual a ser atualizado. |
recommendedAd |
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 |
Apenas saída. Um número maior que 1,0 que indica o fator pelo qual recomendamos aumentar o CPA desejado. |
averageTargetCpaMicros |
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 ( |
Campos | |
---|---|
recommendedTargetRoas |
Apenas saída. O ROAS desejado recomendado (receita por unidade de gasto). O valor está entre 0,01 e 1000,0. |
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 |
Apenas saída. Valor atual do orçamento. |
recommendedNewAmountMicros |
Apenas saída. Valor do orçamento recomendado. |
newStartDate |
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 ( |
Campos | |
---|---|
recommendedCampaignCalloutAssets[] |
Apenas saída. Novos recursos de extensão de frase de destaque recomendados no nível da campanha. |
recommendedCustomerCalloutAssets[] |
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 ( |
Campos | |
---|---|
recommendedCampaignSitelinkAssets[] |
Apenas saída. Novos recursos de sitelink recomendados no nível da campanha. |
recommendedCustomerSitelinkAssets[] |
Apenas saída. Novos recursos de sitelink recomendados no nível do cliente. |
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 ( |
Campos | |
---|---|
merchant |
Apenas saída. Os detalhes da conta do Merchant Center. |
feedLabel |
Apenas saída. O rótulo do feed da campanha. |
offersCount |
Apenas saída. O número de ofertas on-line que podem ser veiculadas. |
demotedOffersCount |
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 |
Apenas saída. O ID da conta do Merchant Center. |
name |
Apenas saída. O nome da conta do Merchant Center. |
multiClient |
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 ( |
Campos | |
---|---|
merchant |
Apenas saída. Os detalhes da conta do Merchant Center. |
feedLabel |
Apenas saída. O rótulo do feed da campanha. |
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 ( |
Campos | |
---|---|
merchant |
Apenas saída. Os detalhes da conta do Merchant Center. |
feedLabel |
Apenas saída. O rótulo do feed da campanha. |
productsCount |
Apenas saída. Número de produtos da campanha. |
disapprovedProductsCount |
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 ( |
Campos | |
---|---|
merchant |
Apenas saída. Os detalhes da conta do Merchant Center. |
untargetedOffersCount |
Apenas saída. O número de ofertas não segmentadas. |
feedLabel |
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 ( |
Campos | |
---|---|
merchant |
Apenas saída. Os detalhes da conta do Merchant Center. |
feedLabel |
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 ( |
Campos | |
---|---|
merchant |
Apenas saída. Os detalhes da conta do Merchant Center. |
feedLabel |
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 ( |
Campos | |
---|---|
targetAdjustment |
Apenas saída. Informações relevantes que descrevem o ajuste de meta recomendado. |
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 |
Apenas saída. O fator pelo qual recomendamos o ajuste da meta. |
currentAverageTargetMicros |
Apenas saída. A meta média atual da campanha ou do portfólio segmentada por essa recomendação. |
sharedSet |
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 ( |
Campos | |
---|---|
targetAdjustment |
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 |
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 | |
---|---|
applyLink |
Apenas saída. Um link para a interface do Google Ads em que o cliente pode aplicar a recomendação manualmente. |
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 ( |
Campos | |
---|---|
resourceName |
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:
|
status |
Apenas saída. Indica se o termo de pesquisa é atualmente uma das suas palavras-chave segmentadas ou excluídas. |
searchTerm |
Apenas saída. O termo da pesquisa. |
adGroup |
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 |
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: |
SmartCampaignSearchTermView
Visualização do termo de pesquisa da campanha inteligente.
Representação JSON |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
Campos | |
---|---|
resourceName |
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:
|
searchTerm |
Apenas saída. O termo da pesquisa. |
campaign |
Apenas saída. A campanha inteligente em que o termo de pesquisa foi veiculado. |
ThirdPartyAppAnalyticsLink
Uma conexão de compartilhamento de dados que permite a importação de análises de aplicativos de terceiros para um cliente do Google Ads.
Representação JSON |
---|
{ "resourceName": string, "shareableLinkId": string } |
Campos | |
---|---|
resourceName |
Imutável. O nome do recurso do link de análise de aplicativos de terceiros. Os nomes dos recursos de link da análise de aplicativos de terceiros têm o seguinte formato:
|
shareableLinkId |
Apenas saída. O ID do link compartilhável que precisa ser fornecido ao terceiro ao configurar a análise de aplicativos. Ele pode ser gerado novamente usando o método "Regenerar" no ThirdPartyAppAnalyticsLinkService. |
TopicView
Uma visualização de tópicos.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
TravelActivityGroupView
Visualização do grupo de atividades de viagem.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
TravelActivityPerformanceView
Uma visualização do desempenho de atividades de viagem.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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:
|
UserInterest
Um interesse do usuário: um segmento específico com base em interesses a ser segmentado.
Representação JSON |
---|
{ "resourceName": string, "taxonomyType": enum ( |
Campos | |
---|---|
resourceName |
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:
|
taxonomyType |
Apenas saída. Tipo de taxonomia do interesse do usuário. |
availabilities[] |
Apenas saída. Informações de disponibilidade do interesse do usuário. |
userInterestId |
Apenas saída. O ID do interesse do usuário. |
name |
Apenas saída. O nome do interesse do usuário. |
userInterestParent |
Apenas saída. O pai do interesse do usuário. |
launchedToAll |
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 ( |
Campos | |
---|---|
resourceName |
Apenas saída. O nome do recurso do evento importante. Os nomes dos recursos de eventos importantes têm o seguinte formato:
|
id |
Apenas saída. O ID do evento importante. |
name |
Apenas saída. O nome do evento importante, por exemplo,"Mudou recentemente". |
parent |
Apenas saída. O pai de lifeEvent. |
launchedToAll |
Apenas saída. Verdadeiro se o evento importante foi lançado para todos os canais e locais. |
availabilities[] |
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 |
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:
|
countryCriterionId |
Apenas saída. ID do critério do país. |
targetingLocation |
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 |
Apenas saída. O nome do recurso da constante de tópico. Esses nomes têm o seguinte formato:
|
path[] |
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 |
Apenas saída. O ID do tópico. |
topicConstantParent |
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 |
Apenas saída. O nome do recurso do vídeo. Os nomes dos recursos de vídeo têm o seguinte formato:
|
id |
Apenas saída. O ID do vídeo. |
channelId |
Apenas saída. O ID do canal do proprietário do vídeo. |
durationMillis |
Apenas saída. A duração do vídeo em milissegundos. |
title |
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 |
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:
|
LeadFormSubmissionData
Dados dos envios de formulário de lead.
Representação JSON |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
Campos | |
---|---|
resourceName |
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:
|
id |
Apenas saída. É o ID deste envio do formulário de lead. |
asset |
Apenas saída. Recurso associado ao formulário de lead enviado. |
campaign |
Apenas saída. Campanha associada ao formulário de lead enviado. |
leadFormSubmissionFields[] |
Apenas saída. Dados de envio associados a um formulário de lead. |
customLeadFormSubmissionFields[] |
Apenas saída. Dados de envio associados a um formulário de lead personalizado. |
adGroup |
Apenas saída. Grupo de anúncios associado ao formulário de lead enviado. |
adGroupAd |
Apenas saída. O grupo de anúncios associado ao formulário de lead enviado. |
gclid |
Apenas saída. ID de clique do Google associado ao formulário de lead enviado. |
submissionDateTime |
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 ( |
Campos | |
---|---|
fieldType |
Apenas saída. Tipo dos campos do formulário de lead. |
fieldValue |
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 |
Apenas saída. O texto da pergunta personalizada. O número máximo de caracteres é 300. |
fieldValue |
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 ( |
Campos | |
---|---|
allConversionsValueByConversionDate |
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 |
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 |
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 |
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 |
O índice de qualidade histórico do criativo. |
historicalLandingPageQualityScore |
A qualidade da experiência histórica na página de destino. |
historicalSearchPredictedCtr |
A taxa de cliques (CTR) prevista de pesquisa histórica. |
interactionEventTypes[] |
Os tipos de interação com pagamentos e sem custo. |
skAdNetworkConversions |
É o número de conversões de rede de publicidade do kit da loja do iOS. |
publisherPurchasedClicks |
Cliques de propriedades cujo tráfego foi pago ou adquirido por atividades de incentivo pelo editor, mas que não pertencem a ele |
publisherOrganicClicks |
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 |
Cliques do tráfego que não é identificado como "Comprado pelo editor" ou "Orgânico do editor" |
absoluteTopImpressionPercentage |
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 |
Custo médio das impressões visíveis ( |
activeViewCtr |
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 |
Uma medida da frequência com que seu anúncio ficou visível em um site da Rede de Display. |
activeViewMeasurability |
É a proporção de impressões que podem ser medidas pelo Active View pelo número de impressões veiculadas. |
activeViewMeasurableCostMicros |
O custo das impressões recebidas que foram avaliadas pelo Active View. |
activeViewMeasurableImpressions |
O número de vezes que seus anúncios são exibidos em canais em posições em que podem ser vistos. |
activeViewViewability |
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 |
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 |
Valor de todas as conversões. |
allNewCustomerLifetimeValue |
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 |
O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. |
allConversionsValuePerCost |
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 |
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 |
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 |
O valor de todas as conversões de interações dividido pelo número total de interações. |
allConversionsFromMenu |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
O custo total de todos os cliques dividido pelo número total de cliques recebidos. |
averageCpe |
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 |
Custo médio por mil impressões (CPM médio). |
averageCpv |
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 |
Número médio de páginas visualizadas por sessão. |
averageTimeOnSite |
Duração total de todas as sessões (em segundos) / número de sessões. Importado do Google Analytics. |
benchmarkAverageMaxCpc |
Uma indicação de como outros anunciantes estão definindo lances para produtos semelhantes. |
biddableAppInstallConversions |
Número de instalações do app. |
biddableAppPostInstallConversions |
Número de ações no app. |
benchmarkCtr |
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 |
Porcentagem de cliques em que o usuário visitou apenas uma página do site. Importado do Google Analytics. |
clicks |
O número de cliques. |
combinedClicks |
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 |
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 |
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 |
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 |
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 |
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 |
A data da conversão mais recente para esta ação de conversão. A data está no fuso horário do cliente. |
contentRankLostImpressionShare |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
O custo das interações com anúncios dividido por todas as conversões. |
costPerConversion |
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 |
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 |
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 |
O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões). |
currentModelAttributedConversions |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Valor médio do lead com base nos cliques. |
hotelCommissionRateMicros |
Taxa de lances de comissão em micros. Uma comissão de 20% é representada como 200.000. |
hotelExpectedCommissionCost |
Custo de comissão esperado. O resultado da multiplicação do valor da comissão vezes hotel_commission_rate na moeda do anunciante. |
hotelPriceDifferencePercentage |
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 |
O número de impressões que os parceiros de hotéis poderiam ter atribuído a performance do feed. |
historicalQualityScore |
O índice de qualidade histórico. |
gmailForwards |
O número de vezes que o anúncio foi encaminhado para outra pessoa como uma mensagem. |
gmailSaves |
O número de vezes que alguém salvou seu anúncio do Gmail na Caixa de entrada como uma mensagem. |
gmailSecondaryClicks |
O número de cliques para acessar a página de destino no estado expandido dos anúncios do Gmail. |
impressionsFromStoreReach |
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 |
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 |
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 |
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 |
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 |
Número de cliques que o Google considera ilegítimos e que não são cobrados de você. |
messageChats |
Número de chats de mensagens iniciados para impressões de clique para enviar mensagens que estavam qualificadas para o rastreamento de mensagens. |
messageImpressions |
Número de impressões do tipo "clique para enviar mensagem" que estavam qualificadas para o acompanhamento de mensagens. |
messageChatRate |
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 |
A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis. |
optimizationScoreUplift |
Aumento total da pontuação de otimização de todas as recomendações. |
optimizationScoreUrl |
URL da página da pontuação de otimização na interface da Web do Google Ads. Essa métrica pode ser selecionada de |
organicClicks |
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 |
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 |
É 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 |
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 |
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 |
Porcentagem de primeiras sessões (de pessoas que nunca visitaram seu site). Importado do Google Analytics. |
phoneCalls |
Número de chamadas off-line. |
phoneImpressions |
Número de impressões do número de telefone off-line. |
phoneThroughRate |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Intervalo do volume de pesquisas para uma categoria de insight do termo de pesquisa. |
speedScore |
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 |
É 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 |
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 |
A porcentagem de impressões de anúncios que são exibidas ao lado dos principais resultados da pesquisa orgânica. |
validAcceleratedMobilePagesClicksPercentage |
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 |
O valor de todas as conversões dividido pelo número de todas as conversões. |
valuePerAllConversionsByConversionDate |
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 |
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 |
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 |
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 |
Porcentagem de impressões em que os espectadores assistiram todo o vídeo. |
videoQuartileP25Rate |
Porcentagem de impressões em que o espectador assistiu 25% do seu vídeo. |
videoQuartileP50Rate |
Porcentagem de impressões em que o espectador assistiu 50% do seu vídeo. |
videoQuartileP75Rate |
Porcentagem de impressões em que o espectador assistiu 75% do seu vídeo. |
videoViewRate |
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 |
Número de vezes que seus anúncios em vídeo foram visualizados. |
viewThroughConversions |
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 |
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 |
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 |
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 |
É 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 |
É 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 |
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 |
É 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 |
É 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 |
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 |
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 |
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 |
É 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 |
É 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 |
Número estimado de visitas à loja após uma impressão. Essa medida é proveniente do local com base nos recursos. |
viewThroughConversionsFromLocationAssetWebsite |
É 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 |
Limite inferior do volume de pesquisas. |
max |
Limite superior do volume de pesquisas. |
Segmentos
Campos apenas para segmentos.
Representação JSON |
---|
{ "adDestinationType": enum ( |
Campos | |
---|---|
adDestinationType |
Tipo de destino do anúncio. |
adNetworkType |
Tipo de rede de publicidade. |
budgetCampaignAssociationStatus |
É o status da associação da campanha de orçamento. |
clickType |
Tipo de clique. |
conversionActionCategory |
Categoria de ação de conversão. |
conversionAttributionEventType |
Tipo de evento de atribuição de conversão |
conversionLagBucket |
Um valor de enumeração que representa o número de dias entre a impressão e a conversão. |
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 |
Dia da semana, por exemplo, MONDAY. |
device |
Dispositivo a que as métricas se aplicam. |
externalConversionSource |
Origem da conversão externa. |
hotelCheckInDayOfWeek |
Dia da semana do check-in no hotel. |
hotelDateSelectionType |
Tipo de seleção da data do hotel. |
hotelRateType |
Tipo de diária do hotel. |
hotelPriceBucket |
Faixa de preço do hotel. |
keyword |
Critério de palavra-chave. |
monthOfYear |
Mês do ano, por exemplo, janeiro. |
placeholderType |
Tipo de marcador de posição. Isso é usado somente com métricas de itens do feed. |
productChannel |
Canal do produto. |
productChannelExclusivity |
Exclusividade do canal do produto. |
productCondition |
Estado do produto. |
recommendationType |
Tipo de recomendação. |
searchEngineResultsPageType |
Tipo da página de resultados do mecanismo de pesquisa. |
searchTermMatchType |
Tipo de correspondência da palavra-chave que acionou o anúncio, incluindo variantes. |
slot |
Posição do anúncio. |
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 |
Tipo de usuário da rede de publicidade do kit da loja do iOS. |
skAdNetworkAdEventType |
Tipo de evento de anúncio da rede de publicidade do kit da loja do iOS. |
skAdNetworkAttributionCredit |
Crédito de atribuição da rede de publicidade do kit da loja do iOS |
newVersusReturningCustomers |
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 |
ID da conta da atividade. |
activityRating |
Classificação da atividade. |
externalActivityId |
ID da atividade fornecido pelo anunciante. |
adGroup |
Nome do recurso do grupo de anúncios. |
assetGroup |
Nome do recurso do grupo. |
auctionInsightDomain |
Domínio (URL visível) de um participante no Relatório de informações do leilão. |
campaign |
Nome do recurso da campanha. |
conversionAction |
Nome do recurso da ação de conversão. |
conversionActionName |
Nome da ação de conversão. |
conversionAdjustment |
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 |
Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17. |
geoTargetAirport |
Nome do recurso da constante de segmentação por área geográfica que representa um aeroporto. |
geoTargetCanton |
Nome do recurso da constante de segmentação geográfica que representa um cantão. |
geoTargetCity |
Nome do recurso da constante de segmentação por área geográfica que representa uma cidade. |
geoTargetCountry |
Nome do recurso da constante de segmentação por área geográfica que representa um país. |
geoTargetCounty |
Nome do recurso da constante de segmentação geográfica que representa um condado. |
geoTargetDistrict |
Nome do recurso da constante de segmentação geográfica que representa um distrito. |
geoTargetMetro |
Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana. |
geoTargetMostSpecificLocation |
Nome do recurso da constante de segmentação por área geográfica que representa a localização mais específica. |
geoTargetPostalCode |
Nome do recurso da constante de segmentação por área geográfica que representa um código postal. |
geoTargetProvince |
Nome do recurso da constante de segmentação por área geográfica que representa uma província. |
geoTargetRegion |
Nome do recurso da constante de segmentação por área geográfica que representa uma região. |
geoTargetState |
Nome do recurso da constante de segmentação geográfica que representa um estado. |
hotelBookingWindowDays |
Janela de reserva do hotel em dias. |
hotelCenterId |
ID da Central para Hotéis. |
hotelCheckInDate |
Data do check-in no hotel. no formato aaaa-MM-dd. |
hotelCity |
Cidade do hotel. |
hotelClass |
Classificação do hotel. |
hotelCountry |
País do hotel. |
hotelLengthOfStay |
Tempo de permanência no hotel. |
hotelRateRuleId |
ID da regra da tarifa do hotel. |
hotelState |
Estado do hotel. |
hour |
Hora do dia como um número entre 0 e 23. |
interactionOnThisExtension |
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 |
Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd. |
partnerHotelId |
ID do hotel do parceiro. |
productAggregatorId |
ID agregado do produto. |
productBiddingCategoryLevel1 |
Categoria do lance (nível 1) do produto. |
productBiddingCategoryLevel2 |
Categoria do lance (nível 2) do produto. |
productBiddingCategoryLevel3 |
Categoria do lance (nível 3) do produto. |
productBiddingCategoryLevel4 |
Categoria do lance (nível 4) do produto. |
productBiddingCategoryLevel5 |
Categoria do lance (nível 5) do produto. |
productBrand |
Marca do produto. |
productCountry |
Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto. |
productCustomAttribute0 |
Atributo personalizado 0 do produto. |
productCustomAttribute1 |
Atributo personalizado 1 do produto. |
productCustomAttribute2 |
Atributo personalizado 2 do produto. |
productCustomAttribute3 |
Atributo personalizado 3 do produto. |
productCustomAttribute4 |
Atributo personalizado 4 do produto. |
productFeedLabel |
Rótulo do feed do produto. |
productItemId |
ID do item do produto. |
productLanguage |
Nome do recurso da constante de idioma para o idioma do produto. |
productMerchantId |
ID do comerciante do produto. |
productStoreId |
ID da loja do produto. |
productTitle |
Título do produto. |
productTypeL1 |
Tipo (nível 1) do produto. |
productTypeL2 |
Tipo (nível 2) do produto. |
productTypeL3 |
Tipo (nível 3) do produto. |
productTypeL4 |
Tipo (nível 4) do produto. |
productTypeL5 |
Tipo (nível 5) do produto. |
quarter |
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 |
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 |
Um termo de pesquisa. |
webpage |
Nome do recurso do critério do grupo de anúncios que representa o critério da página da Web. |
week |
É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd. |
year |
Ano, formatado como aaaa. |
skAdNetworkConversionValue |
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 |
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 |
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_DEEP_LINK |
Link direto do app |
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_SEARCH |
Pesquisa do YouTube. |
YOUTUBE_WATCH |
Vídeos do YouTube |
MIXED |
Várias redes. |
BudgetCampaignAssociationStatus
Um segmentoBudgetCampaignAssociationStatus.
Representação JSON |
---|
{
"status": enum ( |
Campos | |
---|---|
status |
É o status da associação da campanha de orçamento. |
campaign |
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. |
APP_DEEPLINK |
Link direto do anúncio de engajamento no app. |
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. |
SITELINKS |
Sitelink. |
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. |
VISUAL_SITELINKS |
Sitelinks visuais. |
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. |
PRODUCT_AD_APP_DEEPLINK |
Link direto do Google Shopping – Produto – Anúncio de engajamento no app. |
SHOWCASE_AD_CATEGORY_LINK |
Google Shopping – Demonstração – Categoria. |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK |
Google Shopping – Demonstração – Vitrine local. |
SHOWCASE_AD_ONLINE_PRODUCT_LINK |
Google Shopping – Demonstração – Produto on-line. |
SHOWCASE_AD_LOCAL_PRODUCT_LINK |
Google Shopping – Demonstração – Produto local. |
PROMOTION_EXTENSION |
Extensão de promoção. |
SWIPEABLE_GALLERY_AD_HEADLINE |
Título do anúncio. |
SWIPEABLE_GALLERY_AD_SWIPES |
Deslizar. |
SWIPEABLE_GALLERY_AD_SEE_MORE |
Saiba mais. |
SWIPEABLE_GALLERY_AD_SITELINK_ONE |
Sitelink 1. |
SWIPEABLE_GALLERY_AD_SITELINK_TWO |
Sitelink 2. |
SWIPEABLE_GALLERY_AD_SITELINK_THREE |
Sitelink 3. |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR |
Sitelink 4. |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE |
Sitelink 5. |
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 ( |
Campos | |
---|---|
info |
Informações da palavra-chave |
adGroupCriterion |
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 |
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 |
O nome do recurso do recurso. |
interactionOnThisAsset |
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. |