- Representação JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Anúncio
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdEffectiveLabel
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- Dispositivo
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- Posições estimadas
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionEffectiveLabel
- AdGroupCriterionLabel
- AdGroupEffectiveLabel
- AdGroupLabel
- AgeRangeView
- Recurso
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel (em inglês)
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- Campanha
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignEffectiveLabel
- CampaignLabel
- CartDataSalesView
- Público
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- Cliente
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- Rótulo
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView (em inglês)
- ShoppingPerformanceView
- UserList
- UserListType
- UserLocationView
- WebpageView
- Acessar
- ProductChannel
- Conversões
- AttributionType
- ConversionStatus
- Métricas
- Valor
- QualityScoreBucket
- InteractionEventType
- Segmentos
- AdNetworkType
- Palavra-chave
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
Uma linha retornada da consulta.
Representação JSON |
---|
{ "adGroup": { object ( |
Campos | |
---|---|
ad |
O grupo de anúncios referenciado na consulta. |
ad |
O anúncio referenciado na consulta. |
ad |
O rótulo efetivo do anúncio do grupo de anúncios mencionado na consulta. |
ad |
O rótulo do anúncio do grupo de anúncios referenciado na consulta. |
ad |
O recurso do grupo de anúncios referenciado na consulta. |
ad |
O conjunto de recursos do grupo de anúncios referenciado na consulta. |
ad |
A visualização do público-alvo do grupo de anúncios referenciada na consulta. |
ad |
O modificador de lances referenciado na consulta. |
ad |
O critério referenciado na consulta. |
ad |
O rótulo efetivo do critério do grupo de anúncios referenciado na consulta. |
ad |
O rótulo do critério do grupo de anúncios mencionado na consulta. |
ad |
O rótulo efetivo do grupo de anúncios referenciado na consulta. |
ad |
O rótulo do grupo de anúncios referenciado na consulta. |
age |
A visualização de faixa etária referenciada na consulta. |
asset |
O recurso referenciado na consulta. |
asset |
O recurso do grupo de recursos referenciado na consulta. |
asset |
O indicador do grupo de recursos referenciado na consulta. |
asset |
O filtro do grupo de produtos anunciados do grupo de recursos mencionado na consulta. |
asset |
A visualização da combinação principal do grupo de recursos referenciada na consulta. |
asset |
O grupo de recursos referenciado na consulta. |
asset |
O recurso do conjunto de recursos referenciado na consulta. |
asset |
O conjunto de recursos referenciado na consulta. |
bidding |
A estratégia de lances referenciada na consulta. |
campaign |
O orçamento da campanha referenciado na consulta. |
campaign |
A campanha referenciada na consulta. |
campaign |
O recurso da campanha referenciado na consulta. |
campaign |
O grupo de recursos da campanha referenciado na consulta. |
campaign |
A visualização do público-alvo da campanha referenciada na consulta. |
campaign |
O critério da campanha referenciado na consulta. |
campaign |
O rótulo efetivo da campanha mencionado na consulta. |
campaign |
O rótulo da campanha referenciado na consulta. |
cart |
A visualização de vendas de dados do carrinho referenciada na consulta. |
audience |
O público-alvo referenciado na consulta. |
conversion |
A ação de conversão referenciada na consulta. |
conversion |
A variável personalizada de conversão referenciada na consulta. |
customer |
O cliente referenciado na consulta. |
customer |
O recurso do cliente referenciado na consulta. |
customer |
O conjunto de recursos do cliente referenciado na consulta. |
accessible |
A estratégia de lances acessível referenciada na consulta. |
customer |
O CustomerManagerLink referenciado na consulta. |
customer |
O CustomerClient mencionado na consulta. |
dynamic |
A visualização de termos de pesquisa dos anúncios dinâmicos de pesquisa referenciada na consulta. |
gender |
A visualização de gênero referenciada na consulta. |
geo |
A constante de segmentação por área geográfica referenciada na consulta. |
keyword |
A visualização de palavra-chave referenciada na consulta. |
label |
O rótulo referenciado na consulta. |
language |
A constante de linguagem referenciada na consulta. |
location |
A visualização de local referenciada na consulta. |
product |
A categoria de lances do produto referenciada na consulta. |
product |
A visualização do grupo de produtos referenciada na consulta. |
shopping |
A visualização de desempenho de compras referenciada na consulta. |
user |
A lista de usuários referenciada na consulta. |
user |
A visualização de local do usuário referenciada na consulta. |
webpage |
A visualização da página da Web referenciada na consulta. |
visit |
A visita no nível do evento referenciada na consulta. |
conversion |
A conversão no nível do evento referenciada na consulta. |
metrics |
As métricas. |
segments |
Os segmentos. |
custom |
As colunas personalizadas. |
Grupo de anúncios
Um grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome de recurso do grupo de anúncios. Os nomes de recursos do grupo de anúncios têm o seguinte formato:
|
status |
O status do grupo de anúncios. |
type |
O tipo do grupo de anúncios. |
ad |
Modo de rotação de anúncios do grupo de anúncios. |
creation |
O carimbo de data/hora em que esse adGroup foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
targeting |
Configuração para recursos relacionados à segmentação. |
labels[] |
Os nomes de recursos dos rótulos anexados a este grupo de anúncios. |
effective |
Os nomes dos recursos dos rótulos efetivos anexados a este grupo de anúncios. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse grupo de anúncios. |
engine |
ID do grupo de anúncios na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads (por exemplo, Yahoo Japan, Microsoft, Baidu etc.). Para a entidade do Google Ads, use "adGroup.id". |
start |
Data em que o grupo de anúncios começa a veicular anúncios. Por padrão, o grupo de anúncios começa agora ou na data de início do grupo de anúncios, o que for posterior. Se esse campo for definido, o grupo de anúncios começará no início da data especificada no fuso horário do cliente. Esse campo só está disponível para contas de gateway do Microsoft Advertising e do Facebook. Formato: AAAA-MM-DD Exemplo: 2019-03-14 |
end |
Data em que o grupo de anúncios termina de veicular anúncios. Por padrão, o grupo de anúncios termina na data de término do grupo de anúncios. Se esse campo for definido, o grupo de anúncios terminará no final da data especificada no fuso horário do cliente. Esse campo só está disponível para contas de gateway do Microsoft Advertising e do Facebook. Formato: AAAA-MM-DD Exemplo: 2019-03-14 |
language |
O idioma dos anúncios e das palavras-chave em um grupo de anúncios. Esse campo só está disponível para contas do Microsoft Advertising. Mais detalhes: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last |
A data e a hora em que esse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
id |
O ID do grupo de anúncios. |
name |
O nome do grupo de anúncios. Este campo é obrigatório e não deve ficar vazio ao criar novos grupos de anúncios. Ele precisa ter menos de 255 caracteres UTF-8 de largura total. Ele não pode conter nenhum caractere nulo (ponto de código 0x0), feed de linha NL (ponto de código 0xA) nem retorno de carro (ponto de código 0xD). |
cpc |
É o lance máximo de CPC (custo por clique). |
engine |
O status do mecanismo para o grupo de anúncios. |
AdGroupStatus
Os possíveis status de um grupo de anúncios.
Enums | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
O grupo de anúncios está ativado. |
PAUSED |
O grupo de anúncios está pausado. |
REMOVED |
O grupo de anúncios é removido. |
AdGroupType
Enum que lista os tipos possíveis de um grupo de anúncios.
Enums | |
---|---|
UNSPECIFIED |
O tipo não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
SEARCH_STANDARD |
O tipo de grupo de anúncios padrão para campanhas de pesquisa. |
DISPLAY_STANDARD |
O tipo de grupo de anúncios padrão para campanhas de display. |
SHOPPING_PRODUCT_ADS |
O tipo de grupo de anúncios das campanhas do Shopping que veicula anúncios de produtos padrão. |
SHOPPING_SHOWCASE_ADS |
O tipo de grupos de anúncios que são limitados à veiculação de anúncios de demonstração ou do comerciante nos resultados do Shopping. |
HOTEL_ADS |
O tipo de grupo de anúncios padrão para campanhas de hotel. |
SHOPPING_SMART_ADS |
O tipo de grupos de anúncios em campanhas inteligentes do Shopping. |
VIDEO_BUMPER |
Anúncios em vídeo in-stream curtos e não puláveis. |
VIDEO_TRUE_VIEW_IN_STREAM |
Anúncios em vídeo TrueView (puláveis) in-stream. |
VIDEO_TRUE_VIEW_IN_DISPLAY |
Anúncios em vídeo TrueView in-display. |
VIDEO_NON_SKIPPABLE_IN_STREAM |
Anúncios em vídeo in-stream não puláveis. |
VIDEO_OUTSTREAM |
Anúncios em vídeo out-stream. |
SEARCH_DYNAMIC_ADS |
Tipo de grupo de anúncios dinâmicos de pesquisa. |
SHOPPING_COMPARISON_LISTING_ADS |
O tipo de grupos de anúncios nas campanhas de comparação do Shopping. |
PROMOTED_HOTEL_ADS |
O tipo de grupo de anúncios para grupos de anúncios de hotéis promovidos. |
VIDEO_RESPONSIVE |
Grupos de anúncios responsivos em vídeo. |
VIDEO_EFFICIENT_REACH |
Grupos de anúncios de alcance eficiente de vídeo. |
SMART_CAMPAIGN_ADS |
Tipo de grupo de anúncios para campanhas inteligentes. |
TRAVEL_ADS |
Tipo de grupo de anúncios para campanhas de viagens. |
AdGroupAdRotationMode
Os possíveis modos de rotação de anúncios de um grupo.
Enums | |
---|---|
UNSPECIFIED |
O modo de rotação de anúncios não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
OPTIMIZE |
Otimize os anúncios do grupo com base em cliques ou conversões. |
ROTATE_FOREVER |
Alternar uniformemente. |
AdGroupEngineStatus
Status do mecanismo do grupo de anúncios.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
AD_GROUP_ELIGIBLE |
Obsoleto. Não use. |
AD_GROUP_EXPIRED |
Nenhum anúncio está sendo exibido para esse grupo de anúncios porque a data de término dele já passou. |
AD_GROUP_REMOVED |
O grupo de anúncios foi excluído. |
AD_GROUP_DRAFT |
Nenhum anúncio está sendo veiculado para esse grupo porque o grupo associado ainda está em rascunho. |
AD_GROUP_PAUSED |
O grupo de anúncios foi pausado. |
AD_GROUP_SERVING |
O grupo de anúncios está ativo e veiculando anúncios. |
AD_GROUP_SUBMITTED |
O grupo de anúncios foi enviado (status legado do Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
Nenhum anúncio está sendo veiculado para esse grupo porque a campanha foi pausada. |
ACCOUNT_PAUSED |
Nenhum anúncio está em exibição para esse grupo porque a conta foi pausada. |
TargetingSetting
Configurações dos recursos relacionados à segmentação, nos níveis da campanha e do grupo de anúncios. Para mais detalhes sobre a configuração de segmentação, acesse https://support.google.com/google-ads/answer/7365594.
Representação JSON |
---|
{
"targetRestrictions": [
{
object ( |
Campos | |
---|---|
target |
A configuração de dimensão por segmentação para restringir o alcance da campanha ou do grupo de anúncios. |
TargetRestriction
Lista de configurações de segmentação por dimensão de segmentação.
Representação JSON |
---|
{
"targetingDimension": enum ( |
Campos | |
---|---|
targeting |
A dimensão de segmentação a que essas configurações se aplicam. |
bid |
Indica se você deve restringir seus anúncios para serem exibidos somente para os critérios selecionados para essa segmentaçãoDimension ou para segmentar todos os valores para essa segmentaçãoDimension e exibir anúncios com base em sua segmentação em outras TargetingDimensions. Um valor de |
TargetingDimension
Enumeração que descreve possíveis dimensões de segmentação.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
KEYWORD |
Critérios de palavra-chave, por exemplo, "mars cruise". KEYWORD pode ser usada como uma dimensão de lance personalizado. As palavras-chave são sempre uma dimensão de segmentação. Sendo assim, elas podem não ser definidas como uma dimensão "ALL" de destino com TargetRestriction. |
AUDIENCE |
Os critérios de público-alvo, que incluem lista de usuários, interesse do usuário, afinidade personalizada e público-alvo personalizado no mercado. |
TOPIC |
Critérios de tema para segmentar categorias de conteúdo, por exemplo, "category::Animals>Pets", usado para segmentação de display e vídeo. |
GENDER |
Critérios para segmentação por gênero. |
AGE_RANGE |
Critérios para segmentar faixas etárias. |
PLACEMENT |
Critérios de canais, que incluem sites como "www.flowers4sale.com", além de aplicativos, categorias de apps para dispositivos móveis, vídeos e canais do YouTube. |
PARENTAL_STATUS |
Critérios para segmentação por status parental. |
INCOME_RANGE |
Critérios para segmentação por faixa de renda. |
AdGroupAd
Um anúncio do grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do anúncio. Os nomes dos recursos de anúncios do grupo de anúncios têm o seguinte formato:
|
status |
O status do anúncio. |
ad |
O anúncio. |
creation |
A data e a hora em que o adGroupAd foi criado. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
labels[] |
Os nomes dos recursos dos rótulos anexados ao anúncio do grupo de anúncios. |
effective |
Os nomes dos recursos dos rótulos eficazes anexados a este anúncio. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse anúncio. |
engine |
É o ID do anúncio na conta de mecanismo externo. Esse campo é somente para contas do Search Ads 360, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para entidades que não são do Search Ads 360, use "adGroupAd.ad.id". |
engine |
Status adicional do anúncio na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem ativa, qualificada, revisão pendente etc. |
last |
A data e a hora em que o anúncio desse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
AdGroupAdStatus
Os status possíveis de um AdGroupAd.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
O anúncio do grupo de anúncios está ativado. |
PAUSED |
O anúncio do grupo de anúncios está pausado. |
REMOVED |
O anúncio do grupo de anúncios é removido. |
Anúncio
Anúncio
Representação JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do anúncio. Os nomes dos recursos de anúncios têm o seguinte formato:
|
final |
A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio. |
type |
O tipo de anúncio. |
id |
O ID do anúncio. |
display |
É o URL exibido na descrição de alguns formatos de anúncio. |
name |
É o nome do anúncio. Isso é usado apenas para identificar o anúncio. Ele não precisa ser único e não afeta o anúncio veiculado. No momento, o campo de nome só é compatível com DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd. |
Campo de união ad_data . Detalhes pertinentes ao tipo de anúncio. É necessário definir exatamente um valor. ad_data pode ser apenas de um dos tipos a seguir: |
|
text |
Detalhes relacionados a um anúncio de texto. |
expanded |
Detalhes relacionados a um anúncio de texto expandido. |
responsive |
Detalhes relacionados a um anúncio responsivo de pesquisa. |
product |
Detalhes relacionados a um anúncio de produto. |
expanded |
Detalhes relacionados a um anúncio dinâmico expandido de pesquisa. |
AdType
Os possíveis tipos de anúncio.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
TEXT_AD |
O anúncio é de texto. |
EXPANDED_TEXT_AD |
O anúncio é um anúncio de texto expandido. |
CALL_ONLY_AD |
O anúncio é só para chamadas. |
EXPANDED_DYNAMIC_SEARCH_AD |
O anúncio é um anúncio dinâmico expandido de pesquisa. |
HOTEL_AD |
O anúncio é de hotel. |
SHOPPING_SMART_AD |
O anúncio é inteligente do Shopping. |
SHOPPING_PRODUCT_AD |
O anúncio é um anúncio padrão do Shopping. |
VIDEO_AD |
O anúncio é em vídeo. |
GMAIL_AD |
Este anúncio é do Gmail. |
IMAGE_AD |
Este anúncio é gráfico. |
RESPONSIVE_SEARCH_AD |
O anúncio é um anúncio responsivo de pesquisa. |
LEGACY_RESPONSIVE_DISPLAY_AD |
O anúncio é um anúncio responsivo de display legado. |
APP_AD |
O anúncio é de um app. |
LEGACY_APP_INSTALL_AD |
É um anúncio legado de instalação de apps. |
RESPONSIVE_DISPLAY_AD |
O anúncio é responsivo de display. |
LOCAL_AD |
O anúncio é local. |
HTML5_UPLOAD_AD |
O anúncio é um upload de display com o tipo de produto HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
O anúncio é de upload de display com um dos tipos de produto DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
O anúncio é de engajamento no app. |
SHOPPING_COMPARISON_LISTING_AD |
O anúncio é um anúncio de comparação do Shopping. |
VIDEO_BUMPER_AD |
Anúncio bumper em vídeo. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Anúncio in-stream não pulável em vídeo. |
VIDEO_OUTSTREAM_AD |
Anúncio em vídeo out-stream. |
VIDEO_TRUEVIEW_DISCOVERY_AD |
Anúncio em vídeo TrueView in-display. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Anúncio in-stream TrueView em vídeo. |
VIDEO_RESPONSIVE_AD |
Anúncio responsivo em vídeo. |
SMART_CAMPAIGN_AD |
Anúncio da campanha inteligente. |
APP_PRE_REGISTRATION_AD |
Anúncio de pré-registro do app universal. |
DISCOVERY_MULTI_ASSET_AD |
Anúncio Discovery com vários recursos. |
DISCOVERY_CAROUSEL_AD |
Anúncio Discovery de carrossel. |
TRAVEL_AD |
Anúncio de viagem. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Anúncio Discovery em vídeo responsivo. |
MULTIMEDIA_AD |
Anúncio multimídia. |
SearchAds360TextAdInfo
Um anúncio de texto do Search Ads 360.
Representação JSON |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
Campos | |
---|---|
headline |
O título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
display |
O URL exibido do anúncio. |
display |
O URL para dispositivos móveis exibido no anúncio. |
ad |
O ID de acompanhamento do anúncio. |
SearchAds360ExpandedTextAdInfo
Um anúncio de texto expandido do Search Ads 360.
Representação JSON |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
Campos | |
---|---|
headline |
O título do anúncio. |
headline2 |
O segundo título do anúncio. |
headline3 |
O terceiro título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
path1 |
Texto anexado ao URL visível gerado automaticamente com um delimitador. |
path2 |
Texto anexado a path1 com um delimitador. |
ad |
O ID de acompanhamento do anúncio. |
SearchAds360ResponsiveSearchAdInfo
Um anúncio responsivo de pesquisa do Search Ads 360.
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. |
path1 |
Texto anexado ao URL visível gerado automaticamente com um delimitador. |
path2 |
Texto anexado a path1 com um delimitador. |
ad |
O ID de acompanhamento do anúncio. |
AdTextAsset
Um recurso de texto usado em um anúncio.
Representação JSON |
---|
{ "text": string } |
Campos | |
---|---|
text |
Texto do recurso. |
SearchAds360ProductAdInfo
Esse tipo não tem campos.
Um anúncio de produto do Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
Um anúncio dinâmico expandido de pesquisa.
Representação JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
Campos | |
---|---|
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
ad |
O ID de acompanhamento do anúncio. |
AdGroupAdEngineStatus
Enumera os status do mecanismo GroupAd.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
AD_GROUP_AD_ELIGIBLE |
Obsoleto. Não use. |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: o criativo não foi aprovado. |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: o URL para dispositivos móveis está em processo de revisão. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: o criativo é inválido em dispositivos móveis, mas válido em computadores. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: o criativo está pronto para ativação. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: o criativo não foi analisado. |
AD_GROUP_AD_ON_HOLD |
Obsoleto. Não use. Usado anteriormente pelo Gemini |
AD_GROUP_AD_PAUSED |
O criativo foi pausado. |
AD_GROUP_AD_REMOVED |
O criativo foi removido. |
AD_GROUP_AD_PENDING_REVIEW |
O criativo está com análise pendente. |
AD_GROUP_AD_UNDER_REVIEW |
O criativo está em análise. |
AD_GROUP_AD_APPROVED |
O criativo foi aprovado. |
AD_GROUP_AD_DISAPPROVED |
O criativo foi reprovado. |
AD_GROUP_AD_SERVING |
O criativo está sendo veiculado. |
AD_GROUP_AD_ACCOUNT_PAUSED |
O criativo foi pausado porque a conta está pausada. |
AD_GROUP_AD_CAMPAIGN_PAUSED |
O criativo foi pausado porque a campanha está pausada. |
AD_GROUP_AD_AD_GROUP_PAUSED |
O criativo foi pausado porque o grupo de anúncios está pausado. |
AdGroupAdEffectiveLabel
Uma relação entre um anúncio de grupo de anúncios e um rótulo efetivo. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a este anúncio do grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
O nome do recurso do rótulo efetivo do anúncio do grupo de anúncios. Os nomes dos recursos de rótulo efetivo do anúncio do grupo de anúncios têm o seguinte formato: |
ad |
O anúncio do grupo de anúncios ao qual o rótulo eficaz está anexado. |
label |
O rótulo efetivo atribuído ao anúncio do grupo de anúncios. |
owner |
O ID do cliente que possui o rótulo efetivo. |
AdGroupAdLabel
Uma relação entre um anúncio de grupo de anúncios e um rótulo.
Representação JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo do anúncio do grupo de anúncios têm o formato: |
ad |
O anúncio de grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao anúncio do grupo de anúncios. |
owner |
O ID do cliente que é proprietário do rótulo. |
AdGroupAsset
Uma conexão entre um grupo de anúncios e um recurso.
Representação JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do grupo de anúncios. Os nomes dos recursos de AdGroupAsset têm o seguinte formato:
|
ad |
Obrigatório. O grupo de anúncios ao qual o recurso está vinculado. |
asset |
Obrigatório. O recurso que está vinculado ao grupo de anúncios. |
status |
Status do recurso do grupo de anúncios. |
AssetLinkStatus
Enumeração que descreve os status de um link de recurso.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
O link do recurso está ativado. |
REMOVED |
O link do recurso foi removido. |
PAUSED |
O link do recurso está pausado. |
AdGroupAssetSet
O conjunto de recursos do grupo de anúncios é a vinculação entre um grupo de anúncios e um conjunto de recursos. A criação de um conjunto de recursos de grupo de anúncios vincula um conjunto de recursos a um grupo de anúncios.
Representação JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do conjunto de recursos do grupo de anúncios. Os nomes dos recursos do conjunto de recursos do grupo de anúncios têm o seguinte formato:
|
ad |
O grupo de anúncios ao qual esse conjunto de recursos está vinculado. |
asset |
O conjunto de recursos vinculado ao grupo de anúncios. |
status |
O status do conjunto de recursos do grupo de anúncios. Somente leitura. |
AssetSetLinkStatus
Os possíveis status da vinculação entre o conjunto de recursos e o contêiner.
Enums | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
A vinculação entre o conjunto de recursos e o contêiner está ativada. |
REMOVED |
A vinculação entre o conjunto de recursos e o contêiner é removida. |
AdGroupAudienceView
Uma visualização do público-alvo do grupo de anúncios. Inclui dados de performance de interesses e listas de remarketing para anúncios da Rede de Display e da Rede de Display do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público-alvo.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de público-alvo do grupo de anúncios. Os nomes dos recursos da visualização do público-alvo do grupo de anúncios têm o formato:
|
AdGroupBidModifier
Representa um modificador do lance de grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Campos | |
---|---|
resource |
O nome do recurso do modificador de lance do grupo de anúncios. Os nomes dos recursos do modificador de lance do grupo de anúncios têm o seguinte formato:
|
bid |
O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. O intervalo é de 1,0 a 6,0 para PreferredContent. Use 0 para desativar um tipo de dispositivo. |
Campo de união Obrigatório em operações de criação a partir da V5. |
|
device |
Um critério de dispositivo. |
DeviceInfo
Um critério de dispositivo.
Representação JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo de dispositivo. |
Dispositivo
Enumera os dispositivos do Google Ads disponíveis para segmentação.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nessa versão. |
MOBILE |
Dispositivos móveis com navegadores completos. |
TABLET |
Tablets com navegadores completos. |
DESKTOP |
Computadores. |
CONNECTED_TV |
Smart TVs e consoles de jogos. |
OTHER |
Outros tipos de dispositivos. |
AdGroupCriterion
Um critério do grupo de anúncios. O relatório "adGroupCriterion" só retorna critérios que foram adicionados explicitamente ao grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do critério do grupo de anúncios. Os nomes dos recursos do critério do grupo de anúncios têm o seguinte formato:
|
creation |
A data e a hora em que esse critério do grupo de anúncios foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
status |
O status do critério. Este é o status da entidade do critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios da interface do usuário podem incorporar informações adicionais que afetam a qualificação de um critério para execução. Em alguns casos, um critério REMOVIDO na API ainda pode aparecer como ativado na IU. Por exemplo, as campanhas são exibidas por padrão para usuários de todas as faixas etárias, a menos que sejam excluídas. A interface vai mostrar cada faixa etária como "ativada", já que elas estão qualificadas para ver os anúncios. mas gclid.status mostrará "removido", já que nenhum critério positivo foi adicionado. |
quality |
Informações sobre a qualidade do critério. |
type |
Tipo do critério. |
labels[] |
Os nomes dos recursos dos rótulos anexados a este critério do grupo de anúncios. |
effective |
Os nomes dos recursos dos rótulos efetivos anexados a este critério do grupo de anúncios. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse critério do grupo de anúncios. |
position |
Estimativas para lances de critério em várias posições. |
final |
A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio. |
engine |
ID do critério do grupo de anúncios na conta de mecanismo externo. Esse campo é apenas para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para a entidade do Google Ads, use "adGroupcri.criterion_id". |
last |
A data e a hora em que esse critério do grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
criterion |
ID do critério. |
ad |
O grupo de anúncios ao qual o critério pertence. |
negative |
Indica se o critério será segmentado ( Este campo não pode ser modificado. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente. |
bid |
O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores. |
cpc |
Lance de CPC (custo por clique). |
effective |
O lance de CPC (custo por clique) efetivo. |
engine |
O status do mecanismo para o critério do grupo de anúncios. |
final |
Modelo de URL para anexar parâmetros ao URL final. |
tracking |
O modelo de URL para criar um URL de rastreamento. |
Campo de união É necessário definir exatamente um. |
|
keyword |
Palavra-chave. |
listing |
Grupo de produtos anunciados. |
age |
Faixa etária. |
gender |
Gênero. |
user |
Lista de usuários. |
webpage |
Página da Web |
location |
Local. |
AdGroupCriterionStatus
Os status possíveis de um AdGroupCriterion.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
O critério do grupo de anúncios está ativado. |
PAUSED |
O critério do grupo de anúncios está pausado. |
REMOVED |
O critério do grupo de anúncios é removido. |
QualityInfo
Um contêiner para informações de qualidade do critério do grupo de anúncios.
Representação JSON |
---|
{ "qualityScore": integer } |
Campos | |
---|---|
quality |
Índice de qualidade. Esse campo não será preenchido se o Google não tiver informações suficientes para determinar um valor. |
CriterionType
Enumeração que descreve possíveis tipos de critérios.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
KEYWORD |
Palavra-chave, por exemplo, "mars cruise". |
PLACEMENT |
Posição, também conhecida como site, por exemplo, "www.flowers4sale.com" |
MOBILE_APP_CATEGORY |
Categorias de apps para dispositivos móveis a segmentar. |
MOBILE_APPLICATION |
Aplicativos para dispositivos móveis a serem segmentados. |
DEVICE |
Dispositivos a serem segmentados. |
LOCATION |
Locais a serem segmentados. |
LISTING_GROUP |
Grupos de produtos anunciados a serem segmentados. |
AD_SCHEDULE |
Programação de anúncios. |
AGE_RANGE |
Faixa etária. |
GENDER |
Gênero. |
INCOME_RANGE |
Faixa de renda. |
PARENTAL_STATUS |
Status parental. |
YOUTUBE_VIDEO |
Vídeo do YouTube. |
YOUTUBE_CHANNEL |
Canal do YouTube. |
USER_LIST |
Lista de usuários. |
PROXIMITY |
Proximidade. |
TOPIC |
Uma segmentação por tópico na Rede de Display (por exemplo, "Animais de estimação e animais"). |
LISTING_SCOPE |
Escopo do item para segmentação. |
LANGUAGE |
e linguagem Hashicorp. |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
Marcador de conteúdo para exclusão de categoria. |
CARRIER |
Operadora. |
USER_INTEREST |
Uma categoria em que o usuário tem interesse. |
WEBPAGE |
Critério de página da Web para anúncios dinâmicos de pesquisa. |
OPERATING_SYSTEM_VERSION |
A versão do sistema operacional. |
APP_PAYMENT_MODEL |
Modelo de pagamento do app. |
MOBILE_DEVICE |
Dispositivo móvel. |
CUSTOM_AFFINITY |
Afinidade personalizada. |
CUSTOM_INTENT |
Intenção personalizada. |
LOCATION_GROUP |
Grupo por locais. |
CUSTOM_AUDIENCE |
Público-alvo personalizado |
COMBINED_AUDIENCE |
Público-alvo combinado |
KEYWORD_THEME |
Tema de palavra-chave da campanha inteligente |
AUDIENCE |
Público-alvo |
LOCAL_SERVICE_ID |
ID do serviço dos anúncios dos Serviços Locais. |
BRAND |
Marca |
BRAND_LIST |
Lista de marcas |
LIFE_EVENT |
Evento importante |
Posição estimada
Estimativas de lances de critério em várias posições.
Representação JSON |
---|
{ "topOfPageCpcMicros": string } |
Campos | |
---|---|
top |
A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página dos resultados de pesquisa. |
AdGroupCriterionEngineStatus
Enumera os status do mecanismo de AdGroupCriterion.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
AD_GROUP_CRITERION_ELIGIBLE |
Obsoleto. Não use. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: o lance ou a qualidade é muito baixo para exibição. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: lance ou qualidade muito baixos para dispositivos móveis, mas apropriados para exibição em computadores. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: lance ou qualidade muito baixos para computadores, mas apropriados para exibição em dispositivos móveis. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: o lance ou a qualidade é muito baixo para exibição. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: pausado pelo Baidu devido ao baixo volume de pesquisas. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: o URL para dispositivos móveis está em processo de revisão. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: a página de destino de um dispositivo é inválida, enquanto a página de destino do outro dispositivo é válida. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: a palavra-chave foi criada e pausada pelo gerenciamento de conta do Baidu e agora está pronta para ser ativada. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: em processo de análise pelo Baidu. Gemini: critério em análise. |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: critério a ser revisado. |
AD_GROUP_CRITERION_ON_HOLD |
Obsoleto. Não use. Usado anteriormente pelo Gemini |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : Critério em análise |
AD_GROUP_CRITERION_PAUSED |
O critério foi pausado. |
AD_GROUP_CRITERION_REMOVED |
O critério foi removido. |
AD_GROUP_CRITERION_APPROVED |
O critério foi aprovado. |
AD_GROUP_CRITERION_DISAPPROVED |
O critério foi reprovado. |
AD_GROUP_CRITERION_SERVING |
O critério está ativo e em veiculação. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
O critério foi pausado porque a conta está pausada. |
KeywordInfo
Um critério de palavra-chave.
Representação JSON |
---|
{
"matchType": enum ( |
Campos | |
---|---|
match |
Tipo de correspondência da palavra-chave. |
text |
O texto da palavra-chave (no máximo 80 caracteres e 10 palavras). |
KeywordMatchType
Possíveis tipos de correspondência de palavra-chave.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
EXACT |
Correspondência exata. |
PHRASE |
Correspondência de frase. |
BROAD |
Correspondência ampla. |
ListingGroupInfo
Um critério do grupo de produtos anunciados.
Representação JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo do grupo de produtos anunciados. |
ListingGroupType
O tipo do grupo de produtos anunciados.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SUBDIVISION |
Subdivisão de produtos em alguma dimensão da listagem. Esses nós não são usados para servir para segmentar entradas de listagem, mas servem meramente para definir a estrutura da árvore. |
UNIT |
Unidade de grupo de listagem que define um lance. |
AgeRangeInfo
Um critério de faixa etária.
Representação JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo de faixa etária. |
AgeRangeType
O tipo de faixa etária demográfica (por exemplo, entre 18 e 24 anos).
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
AGE_RANGE_18_24 |
Entre 18 e 24 anos. |
AGE_RANGE_25_34 |
Entre 25 e 34 anos. |
AGE_RANGE_35_44 |
Entre 35 e 44 anos. |
AGE_RANGE_45_54 |
Entre 45 e 54 anos. |
AGE_RANGE_55_64 |
Entre 55 e 64 anos. |
AGE_RANGE_65_UP |
65 anos ou mais. |
AGE_RANGE_UNDETERMINED |
Faixa etária indeterminada. |
GenderInfo
Um critério de gênero.
Representação JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo de gênero. |
GenderType
O tipo de gênero demográfico (por exemplo, feminino).
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
MALE |
Masculino. |
FEMALE |
Feminino. |
UNDETERMINED |
Gênero indeterminado. |
UserListInfo
Um critério da lista de usuários. Representa uma lista de usuários definida pelo anunciante para ser segmentada.
Representação JSON |
---|
{ "userList": string } |
Campos | |
---|---|
user |
O nome do recurso da lista de usuários. |
WebpageInfo
Representa um critério para segmentar páginas da Web do site de um anunciante.
Representação JSON |
---|
{
"conditions": [
{
object ( |
Campos | |
---|---|
conditions[] |
Condições, ou expressões lógicas, para a segmentação de páginas da Web. A lista de condições de segmentação de páginas da Web é adicionada e combinada quando avaliada. Uma lista vazia de condições indica que todas as páginas do site da campanha estão segmentadas. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
coverage |
Porcentagem de cobertura dos critérios do site. Essa é a porcentagem calculada da cobertura do site com base na segmentação do site e das palavras-chave negativas no grupo de anúncios e na campanha. Por exemplo, quando a cobertura retorna como 1, isso indica que tem 100% de cobertura. Este campo é somente leitura. |
criterion |
O nome do critério definido por este parâmetro. O valor do nome será usado para identificar, classificar e filtrar critérios com esse tipo de parâmetro. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
WebpageConditionInfo
Expressão lógica para segmentação da página da web do site de um anunciante.
Representação JSON |
---|
{ "operand": enum ( |
Campos | |
---|---|
operand |
Operando da condição de segmentação de páginas da Web. |
operator |
Operador da condição de segmentação de páginas da Web. |
argument |
Argumento da condição de segmentação de páginas da Web. |
WebpageConditionOperand
O operando de condição da página da Web no critério da página da Web.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
URL |
Operando que denota uma condição de segmentação de URL de página da Web. |
CATEGORY |
Operando que denota uma condição de segmentação de categoria de página da Web. |
PAGE_TITLE |
Operando que indica uma condição de segmentação de título de página da Web. |
PAGE_CONTENT |
Operando que indica uma condição de segmentação de conteúdo de página da Web. |
CUSTOM_LABEL |
Operando que indica uma condição de segmentação de rótulo personalizado de uma página da Web. |
WebpageConditionOperator
O operador de condição da página da Web no critério da página da Web.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
EQUALS |
A condição da Web do argumento é igual à condição da Web comparada. |
CONTAINS |
A condição da Web do argumento faz parte da condição da Web comparada. |
LocationInfo
Um critério de localização.
Representação JSON |
---|
{ "geoTargetConstant": string } |
Campos | |
---|---|
geo |
O nome do recurso constante de destino geográfico. |
AdGroupCriterionEffectiveLabel
Uma relação entre um critério de grupo de anúncios e um rótulo efetivo. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a esse critério de grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
O nome do recurso do rótulo efetivo do critério do grupo de anúncios. Os nomes dos recursos do rótulo do critério do grupo de anúncios têm o formato: |
ad |
O critério do grupo de anúncios ao qual o rótulo efetivo está anexado. |
label |
O rótulo efetivo atribuído ao critério do grupo de anúncios. |
owner |
O ID do Cliente proprietário do rótulo em vigor. |
AdGroupCriterionLabel
Uma relação entre um critério de grupo de anúncios e um rótulo.
Representação JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
Nome do recurso do rótulo do critério do grupo de anúncios. Os nomes dos recursos do rótulo do critério do grupo de anúncios têm o formato: |
ad |
O critério do grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao critério do grupo de anúncios. |
owner |
O ID do cliente que é proprietário do rótulo. |
AdGroupEffectiveLabel
Uma relação entre um grupo de anúncios e um rótulo eficaz. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
O nome do recurso do rótulo eficaz do grupo de anúncios. Os nomes dos recursos do rótulo eficaz do grupo de anúncios têm o formato: |
ad |
O grupo de anúncios ao qual o rótulo eficaz está anexado. |
label |
O rótulo efetivo atribuído ao grupo de anúncios. |
owner |
O ID do cliente que possui o rótulo efetivo. |
AdGroupLabel
Uma relação entre um grupo de anúncios e um rótulo.
Representação JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
Nome do recurso do rótulo do grupo de anúncios. Os nomes dos recursos do rótulo do grupo de anúncios têm o formato: |
ad |
O grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao grupo de anúncios. |
owner |
O ID do cliente que é proprietário do rótulo. |
AgeRangeView
Uma visualização de faixa etária.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de faixa etária. Os nomes dos recursos de visualização de faixa etária têm o seguinte formato:
|
Recurso
O recurso faz parte de um anúncio que pode ser compartilhado entre vários anúncios. Pode ser uma imagem (ImageAsset), um vídeo (YoutubeVideoAsset) etc. Os recursos são imutáveis e não podem ser removidos. Para interromper a veiculação de um recurso, remova-o da entidade que o usa.
Representação JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resource |
O nome do recurso. Os nomes dos recursos de ativos têm o seguinte formato:
|
type |
Tipo do recurso. |
final |
Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. |
status |
O status do recurso. |
creation |
O carimbo de data/hora em que o recurso foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
last |
A data e a hora em que este recurso foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
id |
O ID do recurso. |
name |
Nome opcional do recurso. |
tracking |
Modelo de URL para criar um URL de rastreamento. |
engine |
O status do mecanismo de um recurso. |
Campo de união asset_data . O tipo específico do recurso. asset_data pode ser apenas de um dos tipos a seguir: |
|
youtube |
Um recurso de vídeo do YouTube. |
image |
Um recurso de imagem. |
text |
Um recurso de texto. |
callout |
Um recurso de frase de destaque unificado. |
sitelink |
Um recurso de sitelink unificado. |
page |
Um recurso de feed de páginas unificado. |
mobile |
Um recurso de app para dispositivos móveis. |
call |
Um recurso de ligação unificado. |
call |
Um recurso de call-to-action. |
location |
Um recurso de local unificado. |
AssetType
Enumeração que descreve possíveis tipos de recurso.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
YOUTUBE_VIDEO |
Recurso de vídeo do YouTube. |
MEDIA_BUNDLE |
Recurso do pacote de mídia. |
IMAGE |
Recurso de imagem. |
TEXT |
Recurso de texto. |
LEAD_FORM |
Recurso de formulário de lead. |
BOOK_ON_GOOGLE |
Recurso "Reservas no Google". |
PROMOTION |
Recurso de promoção. |
CALLOUT |
Recurso de frase de destaque. |
STRUCTURED_SNIPPET |
Recurso de snippet estruturado. |
SITELINK |
Recurso de sitelink. |
PAGE_FEED |
Recurso do feed de páginas. |
DYNAMIC_EDUCATION |
Recurso de educação dinâmica. |
MOBILE_APP |
Recurso de app para dispositivos móveis. |
HOTEL_CALLOUT |
Recurso de frase de destaque de hotel. |
CALL |
Recurso de ligação. |
PRICE |
Recurso de preço. |
CALL_TO_ACTION |
Recurso de call-to-action. |
DYNAMIC_REAL_ESTATE |
Recurso imobiliário dinâmico. |
DYNAMIC_CUSTOM |
Recurso personalizado dinâmico. |
DYNAMIC_HOTELS_AND_RENTALS |
Recurso de hotéis e aluguéis dinâmico. |
DYNAMIC_FLIGHTS |
Recurso de veiculação dinâmica de voos. |
DISCOVERY_CAROUSEL_CARD |
Recurso do card de carrossel do Discovery. |
DYNAMIC_TRAVEL |
Recurso de viagem dinâmico. |
DYNAMIC_LOCAL |
Recurso local dinâmico. |
DYNAMIC_JOBS |
Recurso de tarefas dinâmicas. |
LOCATION |
Recurso de local. |
HOTEL_PROPERTY |
Recurso de propriedade do hotel. |
AssetStatus
Os possíveis status de um recurso.
Enums | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
O recurso está ativado. |
REMOVED |
O recurso é removido. |
ARCHIVED |
O recurso foi arquivado. |
PENDING_SYSTEM_GENERATED |
O recurso foi gerado pelo sistema e está aguardando a revisão do usuário. |
AssetEngineStatus
Próximo ID = 11
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
SERVING |
O recurso está ativo. |
SERVING_LIMITED |
O recurso está limitado. |
DISAPPROVED |
O recurso foi reprovado (não qualificado). |
DISABLED |
O recurso está inativo (pendente). |
REMOVED |
O recurso foi removido. |
YoutubeVideoAsset
Um recurso do YouTube.
Representação JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Campos | |
---|---|
youtube |
Título do vídeo do YouTube. |
youtube |
ID do vídeo do YouTube. É o valor de string de 11 caracteres usado no URL do vídeo do YouTube. |
ImageAsset
Um recurso de imagem.
Representação JSON |
---|
{ "mimeType": enum ( |
Campos | |
---|---|
mime |
Tipo MIME do recurso de imagem. |
full |
Metadados da imagem no tamanho original. |
file |
Tamanho do arquivo de imagem em bytes. |
MimeType
O tipo MIME
Enums | |
---|---|
UNSPECIFIED |
O tipo MIME não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
IMAGE_JPEG |
Tipo MIME de image/jpeg. |
IMAGE_GIF |
Tipo MIME de image/gif. |
IMAGE_PNG |
Tipo MIME de image/png. |
FLASH |
Tipo MIME de application/x-shockwave-flash. |
TEXT_HTML |
Tipo MIME de text/html. |
PDF |
Tipo MIME de application/pdf. |
MSWORD |
Tipo MIME de aplicativo/msword. |
MSEXCEL |
Tipo MIME de aplicativo/vnd.ms-excel. |
RTF |
Tipo MIME de application/rtf. |
AUDIO_WAV |
Tipo MIME de áudio/wav. |
AUDIO_MP3 |
Tipo MIME de audio/mp3. |
HTML5_AD_ZIP |
Tipo MIME de application/x-html5-ad-zip. |
ImageDimension
Metadados de uma imagem em um determinado tamanho, original ou redimensionada.
Representação JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Campos | |
---|---|
height |
Altura da imagem. |
width |
É a largura da imagem. |
url |
Um URL que retorna a imagem com essa altura e largura. |
TextAsset
Um recurso de texto.
Representação JSON |
---|
{ "text": string } |
Campos | |
---|---|
text |
Conteúdo de texto do recurso de texto. |
UnifiedCalloutAsset
Um recurso de frase de destaque unificado.
Representação JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
callout |
O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
start |
Data de início da vigência do recurso e início da veiculação, no formato AAAA-MM-DD. |
end |
Última data em que este recurso está em vigor e ainda sendo veiculado, no formato aaaa-mm-dd. |
ad |
Lista de programações não sobrepostas que especifica todos os intervalos em que o recurso pode ser veiculado. É possível criar até seis programações por dia, 42 no total. |
use |
Indica se o recurso vai ser mostrado no fuso horário do usuário de pesquisa. Válido para o Microsoft Ads. |
AdScheduleInfo
Representa um critério de programação de anúncios.
A programação de anúncios é especificada como o dia da semana e um intervalo de tempo em que os anúncios vão ser veiculados.
Não é possível adicionar mais de seis programações de anúncios para o mesmo dia.
Representação JSON |
---|
{ "startMinute": enum ( |
Campos | |
---|---|
start |
Minutos após a hora de início da programação. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
end |
Minutos após o término da programação. A programação é exclusiva do minuto final. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
day |
Dia da semana ao qual se aplica a programação. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
start |
Horário de início no formato de 24 horas. Este campo precisa estar entre 0 e 23, inclusive. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
end |
Hora de término no formato 24 horas, sendo que 24 significa o fim do dia. Este campo precisa estar entre 0 e 24, inclusive. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
MinuteOfHour
Enumera quartos de hora. Por exemplo, "FIFTEEN"
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nessa versão. |
ZERO |
Zero minutos após a hora. |
FIFTEEN |
Quinze minutos após a hora. |
THIRTY |
Trinta minutos após a hora. |
FORTY_FIVE |
Quarenta e cinco minutos após a hora. |
DayOfWeek
Enumera os dias da semana, por exemplo, "Segunda-feira".
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
MONDAY |
Segunda-feira. |
TUESDAY |
Terça-feira. |
WEDNESDAY |
Quarta-feira. |
THURSDAY |
quinta-feira. |
FRIDAY |
Sexta-feira. |
SATURDAY |
sábado. |
SUNDAY |
Domingo. |
UnifiedSitelinkAsset
Um recurso de sitelink unificado.
Representação JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
link |
Texto de visualização do URL para o sitelink. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
description1 |
Primeira linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusivo, e a description2 também precisa ser definida. |
description2 |
Segunda linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, sendo inclusivo, e a description1 também precisa ser definida. |
start |
Data de início da vigência do recurso e início da veiculação, no formato AAAA-MM-DD. |
end |
Última data em que este recurso está em vigor e ainda sendo veiculado, no formato aaaa-mm-dd. |
ad |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Cada dia pode ter no máximo 6 programações, com 42 no total. |
tracking |
ID usado para rastrear cliques no recurso de sitelink. Esta é uma conta do Yahoo! Campo exclusivo do Japão. |
use |
Indica se o recurso de sitelink será mostrado no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
mobile |
Indica se a preferência é que o recurso de sitelink seja exibido em dispositivos móveis. Válido para o Microsoft Ads. |
UnifiedPageFeedAsset
Um recurso de feed de páginas unificado.
Representação JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Campos | |
---|---|
page |
A página da Web que os anunciantes querem segmentar. |
labels[] |
Rótulos usados para agrupar os URLs das páginas. |
MobileAppAsset
Um recurso que representa um aplicativo para dispositivos móveis.
Representação JSON |
---|
{
"appId": string,
"appStore": enum ( |
Campos | |
---|---|
app |
Obrigatório. Uma string que identifica exclusivamente um app para dispositivos móveis. Ele precisa conter apenas o ID nativo da plataforma, como "com.android.ebay" para Android ou "12345689" para iOS. |
app |
Obrigatório. A loja de aplicativos que distribui esse app específico. |
MobileAppVendor
O tipo de fornecedor de apps para dispositivos móveis
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
APPLE_APP_STORE |
Fornecedor de apps para dispositivos móveis da Apple App Store. |
GOOGLE_APP_STORE |
Fornecedor de apps para dispositivos móveis para a Google Play Store. |
UnifiedCallAsset
Um recurso de ligação unificado.
Representação JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Campos | |
---|---|
country |
Código de país de duas letras do número de telefone. Exemplos: "US", "us". |
phone |
O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890" |
call |
Indica se este CallAsset deve usar sua própria configuração de conversões de chamada, seguir a configuração no nível da conta ou desativar a conversão de chamada. |
call |
A ação de conversão a que uma conversão de chamada é atribuída. Se não for definido, a ação de conversão padrão será usada. Esse campo só tem efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
ad |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. É possível criar até seis programações por dia, 42 no total. |
call |
Se a chamada mostra apenas o número de telefone sem um link para o site. Válido para o Microsoft Ads. |
call |
Se a chamada precisa ser ativada no acompanhamento de chamadas. Válido para o Microsoft Ads. |
use |
Define se a extensão de chamada vai ser mostrada no fuso horário do usuário de pesquisa. Válido para o Microsoft Ads. |
start |
Data de início da vigência do recurso e início da veiculação, no formato AAAA-MM-DD. |
end |
Última data de quando este recurso entra em vigor e ainda está sendo veiculado, no formato aaaa-MM-dd. |
CallConversionReportingState
Possíveis tipos de dados para um estado de ação de conversão de chamada.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
DISABLED |
A ação de conversão de chamada está desativada. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
A ação de conversão de chamada usará o tipo de conversão de chamada definido no nível da conta. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
A ação de conversão de chamada vai usar o tipo de conversão de chamada definido no nível do recurso (anúncios só para chamadas/extensões de chamada). |
CallToActionAsset
Um recurso de call-to-action.
Representação JSON |
---|
{
"callToAction": enum ( |
Campos | |
---|---|
call |
Call-to-action. |
CallToActionType
Enumeração que descreve possíveis tipos de call-to-action.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
LEARN_MORE |
O tipo de call-to-action é "Saiba mais". |
GET_QUOTE |
O tipo de call-to-action é "pedir orçamento". |
APPLY_NOW |
O tipo de call-to-action é "Inscrever-se agora". |
SIGN_UP |
O tipo de call-to-action é "Inscrever-se". |
CONTACT_US |
O tipo de call-to-action é "Entre em contato". |
SUBSCRIBE |
O tipo de call-to-action é "Assinar". |
DOWNLOAD |
O tipo de call-to-action é "Fazer o download". |
BOOK_NOW |
O tipo de call-to-action é "Reserve agora". |
SHOP_NOW |
O tipo de call-to-action é "Compre agora". |
BUY_NOW |
O tipo de call-to-action é "Compre agora". |
DONATE_NOW |
O tipo de call-to-action é "Doe agora". |
ORDER_NOW |
O tipo de call-to-action é "Peça agora". |
PLAY_NOW |
O tipo de call-to-action é "ouvir agora". |
SEE_MORE |
O tipo de call-to-action é "Saiba mais". |
START_NOW |
O tipo de call-to-action é "Comece agora". |
VISIT_SITE |
O tipo de call-to-action é "Visite o site". |
WATCH_NOW |
O tipo de call-to-action é "Assistir agora". |
UnifiedLocationAsset
Um recurso de local unificado.
Representação JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Campos | |
---|---|
place |
IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Esse campo é exclusivo para um determinado ID de cliente e tipo de recurso. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre o ID de lugar. |
business |
A lista de locais comerciais do cliente. Ele só vai ser retornado se o recurso de local estiver sendo sincronizado com a conta do Perfil da Empresa. É possível ter várias fichas na mesma conta que apontam para o mesmo ID de lugar. |
location |
O tipo de propriedade do local. Se o tipo for BUSINESS_OWNER, ele será veiculado como uma extensão de local. Se o tipo for AFFILIATE, ele será veiculado como um local afiliado. |
BusinessProfileLocation
Dados de local do Perfil da Empresa sincronizados da conta vinculada.
Representação JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Campos | |
---|---|
labels[] |
Rótulo especificado pelo anunciante para o local na conta do Perfil da Empresa. Isso é sincronizado com a conta do Perfil da Empresa. |
store |
O código da loja do Perfil da Empresa desse local. Isso é sincronizado com a conta do Perfil da Empresa. |
listing |
ID da ficha da empresa desse local do Perfil da Empresa. A sincronização é feita pela conta vinculada do Perfil da Empresa. |
LocationOwnershipType
Possíveis tipos de propriedade de local.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
BUSINESS_OWNER |
Proprietário da empresa do local(extensão de local legada - LE). |
AFFILIATE |
Local do afiliado(extensão de local de terceiros: ALE). |
AssetGroupAsset
AssetGroupAsset é o vínculo entre um recurso e um grupo de recursos. A adição de um AssetGroupAsset vincula um recurso a um grupo.
Representação JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do grupo de recursos. O nome do recurso do grupo de recursos tem este formato:
|
asset |
O grupo de recursos a que este recurso está vinculado. |
asset |
O recurso que está vinculado a este grupo de recursos. |
field |
A descrição da posição do recurso no grupo. Por exemplo: HEADLINE, YOUTUBE_VIDEO etc. |
status |
O status da vinculação entre um recurso e um grupo de recursos. |
AssetFieldType
Enumeração que descreve as possíveis posições de um recurso.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
HEADLINE |
O recurso está vinculado para uso como título. |
DESCRIPTION |
O recurso está vinculado para uso como descrição. |
MANDATORY_AD_TEXT |
O recurso está vinculado para uso como texto obrigatório do anúncio. |
MARKETING_IMAGE |
O recurso está vinculado para uso como imagem de marketing. |
MEDIA_BUNDLE |
O recurso está vinculado para uso como um pacote de mídia. |
YOUTUBE_VIDEO |
O recurso está vinculado para uso como um vídeo do YouTube. |
BOOK_ON_GOOGLE |
O recurso é vinculado para indicar que uma campanha de hotel está com a opção "Reservas no Google" ativada. |
LEAD_FORM |
O recurso está vinculado para uso como uma extensão de formulário de lead. |
PROMOTION |
O recurso está vinculado para ser usado como uma extensão de promoção. |
CALLOUT |
O recurso está vinculado para uso como uma extensão de frase de destaque. |
STRUCTURED_SNIPPET |
O recurso é vinculado para uso como uma extensão de snippet estruturado. |
SITELINK |
O recurso está vinculado para uso como um sitelink. |
MOBILE_APP |
O recurso está vinculado para uso como uma extensão de app para dispositivos móveis. |
HOTEL_CALLOUT |
O recurso está vinculado para uso como uma extensão de frase de destaque de hotel. |
CALL |
O recurso está vinculado para uso como uma extensão de chamada. |
PRICE |
O recurso está vinculado para uso como uma extensão de preço. |
LONG_HEADLINE |
O recurso está vinculado para ser usado como um título longo. |
BUSINESS_NAME |
O recurso está vinculado para uso como nome de empresa. |
SQUARE_MARKETING_IMAGE |
O recurso está vinculado para uso como uma imagem de marketing quadrada. |
PORTRAIT_MARKETING_IMAGE |
O recurso está vinculado para uso como uma imagem de marketing em modo retrato. |
LOGO |
O recurso está vinculado para uso como logotipo. |
LANDSCAPE_LOGO |
O recurso está vinculado para uso como um logotipo no modo paisagem. |
VIDEO |
O recurso está vinculado para uso como um logotipo que não é do YouTube. |
CALL_TO_ACTION_SELECTION |
O recurso está vinculado para uso ao selecionar uma call-to-action. |
AD_IMAGE |
O recurso está vinculado para uso na seleção de uma imagem de anúncio. |
BUSINESS_LOGO |
O recurso está vinculado para uso como logotipo da empresa. |
HOTEL_PROPERTY |
O recurso é vinculado para uso como uma propriedade de hotel em uma campanha Performance Max para metas de turismo. |
DISCOVERY_CAROUSEL_CARD |
O recurso está vinculado para uso como um card de carrossel do Discovery. |
AssetGroupSignal
AssetGroupSignal representa um indicador em um grupo de recursos. A existência de um indicador informa à campanha Performance Max quem tem mais chances de fazer uma conversão. A campanha Performance Max usa o indicador para procurar outras pessoas com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais.
Representação JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
Campos | |
---|---|
resource |
O nome do recurso do indicador do grupo de recursos. O nome do recurso do indicador do grupo de recursos tem o seguinte formato:
|
asset |
O grupo de recursos ao qual o indicador pertence. |
Campo de união signal . O indicador do grupo de recursos. signal pode ser apenas de um dos tipos a seguir: |
|
audience |
O indicador de público-alvo a ser usado pela campanha Performance Max. |
AudienceInfo
Um critério de público-alvo.
Representação JSON |
---|
{ "audience": string } |
Campos | |
---|---|
audience |
O nome do recurso de público-alvo. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter representa um nó da árvore de filtros do grupo de fichas em um grupo de recursos.
Representação JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos. O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos tem o seguinte formato:
|
asset |
O grupo de recursos ao qual esse filtro pertence. |
id |
O ID do ListingGroupFilter. |
type |
Tipo de nó de filtro de grupo de produtos anunciados. |
vertical |
A vertical que a árvore de nós atual representa. Todos os nós na mesma árvore precisam pertencer à mesma vertical. |
case |
Valor da dimensão com que esse grupo de produtos anunciados está refinando o pai/mãe. Não definido para o grupo raiz. |
parent |
Nome do recurso da subdivisão do grupo de listagens pai. Nulo para o nó do filtro do grupo de fichas da empresa raiz. |
path |
O caminho das dimensões que definem esse filtro de grupo de fichas. |
ListingGroupFilterType
O tipo do filtro do grupo de produtos anunciados.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SUBDIVISION |
Subdivisão de produtos em algumas dimensões de detalhes. |
UNIT_INCLUDED |
Um nó de folha de filtro de grupo de fichas incluído. |
UNIT_EXCLUDED |
Um nó de folha de filtro do grupo de fichas excluído. |
ListingGroupFilterVertical
O tipo da indústria do filtro do grupo de fichas.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SHOPPING |
Representa a vertical de compras. A categoria só é permitida em campanhas Performance Max para varejo. |
ListingGroupFilterDimension
Dimensões de listagem para o filtro do grupo de produtos anunciados do grupo de recursos.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união dimension . A dimensão de um dos tipos abaixo está sempre presente. dimension pode ser apenas de um dos tipos a seguir: |
|
product |
Categoria do lance de uma oferta de produto. |
product |
Marca de uma oferta de produto. |
product |
Localidade de uma oferta de produto. |
product |
Condição de uma oferta de produto. |
product |
Atributo personalizado de uma oferta de produto. |
product |
ID do item de uma oferta de produto. |
product |
Tipo de oferta de produto. |
ProductBiddingCategory
Um elemento de uma categoria de lances em um determinado nível. As categorias de nível superior estão no nível 1, as filhas no nível 2 e assim por diante. No momento, oferecemos suporte a até cinco níveis. O usuário precisa especificar um tipo de dimensão que indique o nível da categoria. Todos os casos da mesma subdivisão precisam ter o mesmo tipo de dimensão (nível de categoria).
Representação JSON |
---|
{
"level": enum ( |
Campos | |
---|---|
level |
Indica o nível da categoria na taxonomia. |
id |
ID da categoria de lance do produto. Esse ID é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436 |
ListingGroupFilterBiddingCategoryLevel
O nível da categoria do lance do filtro do grupo de produtos anunciados.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
LEVEL1 |
Nível 1. |
LEVEL2 |
Nível 2. |
LEVEL3 |
Nível 3. |
LEVEL4 |
Nível 4. |
LEVEL5 |
Nível 5. |
ProductBrand
Marca do produto.
Representação JSON |
---|
{ "value": string } |
Campos | |
---|---|
value |
Valor de string da marca do produto. |
ProductChannel
Localidade de uma oferta de produto.
Representação JSON |
---|
{
"channel": enum ( |
Campos | |
---|---|
channel |
Valor da localidade. |
ListingGroupFilterProductChannel
Enumeração que descreve a localidade de uma oferta de produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ONLINE |
O item é vendido on-line. |
LOCAL |
O item é vendido em lojas locais. |
ProductCondition
Condição de uma oferta de produto.
Representação JSON |
---|
{
"condition": enum ( |
Campos | |
---|---|
condition |
Valor da condição. |
ListingGroupFilterProductCondition
Enumeração que descreve a condição de uma oferta de produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
NEW |
O produto está em bom estado. |
REFURBISHED |
O produto está recondicionado. |
USED |
O estado do produto é "usado". |
ProductCustomAttribute
Atributo personalizado de uma oferta de produto.
Representação JSON |
---|
{
"index": enum ( |
Campos | |
---|---|
index |
Indica o índice do atributo personalizado. |
value |
Valor de string do atributo personalizado do produto. |
ListingGroupFilterCustomAttributeIndex
O índice de atributos do cliente.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
INDEX0 |
Atributo personalizado do primeiro filtro do grupo de produtos anunciados. |
INDEX1 |
Atributo personalizado do segundo filtro do grupo de produtos anunciados. |
INDEX2 |
Terceiro atributo personalizado do filtro do grupo de produtos anunciados. |
INDEX3 |
Atributo personalizado do filtro do quarto grupo de produtos anunciados. |
INDEX4 |
Quinto atributo personalizado do filtro do grupo de produtos anunciados. |
ProductItemId
ID do item de uma oferta de produto.
Representação JSON |
---|
{ "value": string } |
Campos | |
---|---|
value |
Valor do ID. |
ProductType
Tipo de oferta de produto.
Representação JSON |
---|
{
"level": enum ( |
Campos | |
---|---|
level |
Nível do tipo. |
value |
Valor do tipo. |
ListingGroupFilterProductTypeLevel
Enum que descreve o nível do tipo de uma oferta de produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
LEVEL1 |
Nível 1. |
LEVEL2 |
Nível 2. |
LEVEL3 |
Nível 3. |
LEVEL4 |
Nível 4. |
LEVEL5 |
Nível 5. |
ListingGroupFilterDimensionPath
O caminho de definição das dimensões que definem um filtro de grupo de listagens.
Representação JSON |
---|
{
"dimensions": [
{
object ( |
Campos | |
---|---|
dimensions[] |
O caminho completo das dimensões na hierarquia do filtro do grupo de fichas (excluindo o nó raiz) até o filtro desse grupo. |
AssetGroupTopCombinationView
Uma visão do uso da combinação de recursos de anúncio do grupo de anúncios.
Representação JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Campos | |
---|---|
resource |
O nome do recurso da visualização de combinação da parte superior do grupo de recursos. Os nomes dos recursos de visualização de combinação mais usada do grupo de ativos têm o formato: "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
asset |
As principais combinações de recursos veiculados juntos. |
AssetGroupAssetCombinationData
Dados de combinação de recursos do grupo de recursos
Representação JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Campos | |
---|---|
asset |
Recursos veiculados. |
Uso de recursos
Contém as informações de uso do recurso.
Representação JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Campos | |
---|---|
asset |
Nome do recurso. |
served |
O tipo de campo veiculado do recurso. |
ServedAssetFieldType
Os possíveis tipos de campo de recurso.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
HEADLINE_1 |
O recurso é usado no título 1. |
HEADLINE_2 |
O recurso é usado no título 2. |
HEADLINE_3 |
O recurso é usado no título 3. |
DESCRIPTION_1 |
O recurso é usado na descrição 1. |
DESCRIPTION_2 |
O recurso é usado na descrição 2. |
HEADLINE |
O recurso foi usado em um título. Use esse campo somente se houver apenas um título no anúncio. Caso contrário, use os tipos enumerados HEADLINE_1, HEADLINE_2 ou HEADLINE_3 |
HEADLINE_IN_PORTRAIT |
O recurso foi usado como título na imagem em modo retrato. |
LONG_HEADLINE |
O recurso foi usado em um título longo (usado em MultiAssetResponsiveAd). |
DESCRIPTION |
O recurso foi usado em uma descrição. Use essa opção somente se houver apenas uma descrição no anúncio. Caso contrário, use os tipos enumerados DESCRIPTION_1 ou DESCRIPTION_@. |
DESCRIPTION_IN_PORTRAIT |
O recurso foi usado como descrição na imagem em modo retrato. |
BUSINESS_NAME_IN_PORTRAIT |
O recurso foi usado como nome da empresa na imagem em modo retrato. |
BUSINESS_NAME |
O recurso foi usado como nome da empresa. |
MARKETING_IMAGE |
O recurso foi usado como imagem de marketing. |
MARKETING_IMAGE_IN_PORTRAIT |
O recurso foi usado como uma imagem de marketing em modo retrato. |
SQUARE_MARKETING_IMAGE |
O recurso foi usado como uma imagem de marketing quadrada. |
PORTRAIT_MARKETING_IMAGE |
O recurso foi usado como uma imagem de marketing em modo retrato. |
LOGO |
O recurso foi usado como logotipo. |
LANDSCAPE_LOGO |
O recurso foi usado como um logotipo no modo paisagem. |
CALL_TO_ACTION |
O recurso foi usado como uma call-to-action. |
YOU_TUBE_VIDEO |
O recurso foi usado como um vídeo do YouTube. |
SITELINK |
Esse recurso é usado como um sitelink. |
CALL |
Esse recurso é usado como uma chamada. |
MOBILE_APP |
Esse recurso é usado como um app para dispositivos móveis. |
CALLOUT |
Esse recurso é usado como um call-out. |
STRUCTURED_SNIPPET |
Esse recurso é usado como um snippet estruturado. |
PRICE |
Este recurso é usado como um preço. |
PROMOTION |
Este recurso é usado como uma promoção. |
AD_IMAGE |
Esse recurso é usado como uma imagem. |
LEAD_FORM |
O recurso é usado como um formulário de lead. |
BUSINESS_LOGO |
O recurso é usado como um logo de empresa. |
AssetGroup
Um grupo de recursos. AssetGroupAsset é usado para vincular um recurso ao grupo. O AssetGroupSignal é usado para associar um indicador a um grupo de recursos.
Representação JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do grupo de recursos. Os nomes dos recursos do grupo de recursos têm o seguinte formato:
|
id |
O ID do grupo de recursos. |
campaign |
A campanha associada a esse grupo de recursos. O recurso que está vinculado ao grupo. |
name |
Obrigatório. Nome do grupo de recursos. Obrigatório. Precisa ter no mínimo 1 e no máximo 128 caracteres. Ele precisa ser exclusivo em uma campanha. |
final |
Uma lista de URLs finais após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, os URLs são qualificados para expansão por padrão, a menos que a expansão seja desativada. |
final |
Uma lista de URLs finais para dispositivos móveis após todos os redirecionamentos de vários domínios. Nas campanhas Performance Max, os URLs são qualificados para expansão por padrão, a menos que a expansão seja desativada. |
status |
O status do grupo de recursos. |
path1 |
Primeira parte do texto que pode aparecer anexado ao URL exibido no anúncio. |
path2 |
Segunda parte do texto que pode aparecer anexada ao URL exibido no anúncio. Este campo só pode ser definido quando path1 está definido. |
ad |
Qualidade geral do anúncio desse grupo de recursos. |
AssetGroupStatus
Os possíveis status de um grupo de recursos.
Enums | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. |
ENABLED |
O grupo de recursos está ativado. |
PAUSED |
O grupo de recursos está pausado. |
REMOVED |
O grupo de recursos é removido. |
AdStrength
Enum que lista as possíveis qualidades do anúncio.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
PENDING |
A qualidade do anúncio está pendente. |
NO_ADS |
Não foi possível gerar anúncios. |
POOR |
Baixa qualidade. |
AVERAGE |
Força média. |
GOOD |
Força boa. |
EXCELLENT |
Excelente força. |
AssetSetAsset
AssetSetAsset é o vínculo entre um recurso e um conjunto de recursos. Adicionar um AssetSetAsset vincula um recurso a um conjunto de recursos.
Representação JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do conjunto de recursos. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:
|
asset |
O conjunto a que o recurso está vinculado. |
asset |
O recurso a que o recurso do conjunto está vinculado. |
status |
O status do conjunto de recursos. Somente leitura. |
AssetSetAssetStatus
Os possíveis status de um recurso de conjunto de recursos.
Enums | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
O recurso do conjunto de recursos está ativado. |
REMOVED |
O recurso do conjunto de recursos é removido. |
AssetSet
Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso ao conjunto de recursos.
Representação JSON |
---|
{ "id": string, "resourceName": string } |
Campos | |
---|---|
id |
O ID do conjunto de recursos. |
resource |
O nome do recurso do conjunto de recursos. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
BiddingStrategy
Uma estratégia de lances.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da estratégia de lances. Os nomes dos recursos da estratégia de lances têm o seguinte formato:
|
status |
É o status da estratégia de lances. Este campo é somente leitura. |
type |
É o tipo de estratégia de lances. Cria uma estratégia de lances definindo o esquema de lance. Este campo é somente leitura. |
currency |
A moeda usada pela estratégia de lances (código ISO 4217 de três letras). Para estratégias de lances em clientes administradores, essa moeda pode ser definida na criação e é padrão para a moeda do cliente administrador. Para clientes de veiculação, esse campo não pode ser definido. Todas as estratégias em um cliente de veiculação usam implicitamente a moeda desse cliente. Em todos os casos, o campo "effectiveCurrencyCode" retorna a moeda usada pela estratégia. |
id |
O ID da estratégia de lances. |
name |
É o nome da estratégia de lances. Todas as estratégias de lances em uma conta devem ter nomes diferentes. A string precisa estar entre 1 e 255, inclusive, em bytes UTF-8 (cortados). |
effective |
A moeda usada pela estratégia de lances (código de três letras do ISO 4217). Para estratégias de lances em clientes do Gerenciador, essa é a moeda definida pelo anunciante ao criar a estratégia. Para clientes atendidos, esse é o currencyCode do cliente. As métricas da estratégia de lances são informadas nessa moeda. Este campo é somente leitura. |
campaign |
O número de campanhas vinculadas a essa estratégia de lances. Este campo é somente leitura. |
non |
O número de campanhas não removidas anexadas a essa estratégia de lances. Este campo é somente leitura. |
Campo de união Apenas uma pode ser definida. |
|
enhanced |
Uma estratégia de lances que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques em áreas com menor probabilidade. |
maximize |
Uma estratégia de lances automática que ajuda a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento. |
maximize |
Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento. |
target |
Uma estratégia de lances que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado. |
target |
Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões. |
target |
Uma estratégia de lances que define lances com base na fração de lances de leilões em que o anunciante precisa superar um concorrente específico. Este campo está obsoleto. Não será possível criar uma nova estratégia de lances com esse campo ou anexar estratégias de lances com ele a uma campanha. Mutações para estratégias que já têm esse esquema preenchido são permitidas. |
target |
Uma estratégia de lances que ajuda a maximizar a receita enquanto calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico. |
target |
Uma estratégia que define os lances para conseguir o máximo de cliques possível com o orçamento disponível. |
BiddingStrategyStatus
Os status possíveis de uma estratégia de lances.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
A estratégia de lances está ativada. |
REMOVED |
A estratégia de lances é removida. |
BiddingStrategyType
Enumeração que descreve os possíveis tipos de estratégia de lances.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
COMMISSION |
A comissão é uma estratégia de lances automáticos em que o anunciante paga uma determinada parte do valor da conversão. |
ENHANCED_CPC |
O CPC otimizado é uma estratégia de lances que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques com menor probabilidade. |
INVALID |
Usado apenas para valor de retorno. Indica que uma campanha não tem uma estratégia de lances. Isso impede a veiculação da campanha. Por exemplo, uma campanha pode ser anexada a uma estratégia de lances de administrador e a conta de veiculação é desvinculada da conta de administrador. Nesse caso, a campanha será automaticamente desvinculada da estratégia de lances do gerenciador agora inacessível e vai passar para o tipo INVALID. |
MANUAL_CPA |
Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante. |
MANUAL_CPC |
Lances com base em cliques manuais nos quais o usuário paga por clique. |
MANUAL_CPM |
Lance baseado na impressão manual, no qual o usuário para por mil impressões. |
MANUAL_CPV |
Uma estratégia de lances que paga um valor configurável por exibição de vídeo. |
MAXIMIZE_CONVERSIONS |
Uma estratégia de lances que maximiza automaticamente o número de conversões com um orçamento diário. |
MAXIMIZE_CONVERSION_VALUE |
Uma estratégia de lances automática que define lances automaticamente para maximizar a receita enquanto você gasta seu orçamento. |
PAGE_ONE_PROMOTED |
Esquema de lances promovidos na primeira página, que define lances de CPC máx. para segmentar impressões na primeira página ou nos espaços promovidos da primeira página no google.com. Este valor de tipo enumerado foi descontinuado. |
PERCENT_CPC |
O CPC percentual é uma estratégia de lances em que os lances são uma fração do preço anunciado de um produto ou serviço. |
TARGET_CPA |
O CPA desejado é uma estratégia de lances automática que define lances para ajudar a gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado. |
TARGET_CPM |
O CPM desejado é uma estratégia de lances automática que define lances para gerar o maior número possível de impressões sem exceder o custo por mil impressões (CPM) desejado que você definiu. |
TARGET_IMPRESSION_SHARE |
Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja mostrada na parte de cima da primeira página (ou em outro local segmentado). |
TARGET_OUTRANK_SHARE |
A Parcela de classificação desejada é uma estratégia de lances automática que define lances com base na fração desejada de leilões em que o anunciante precisa superar um concorrente específico. Esse valor de tipo enumerado foi descontinuado. |
TARGET_ROAS |
O ROAS desejado é uma estratégia de lances automatizada que ajuda a maximizar a receita e calcular uma média de retorno do investimento médio (ROAS) desejado. |
TARGET_SPEND |
O gasto desejado é uma estratégia de lances automática que define os lances para conseguir o máximo de cliques possível com o orçamento disponível. |
EnhancedCpc
Esse tipo não tem campos.
Uma estratégia de lances automáticos que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques com menor probabilidade.
Essa estratégia de lances foi descontinuada e não pode mais ser criada. Use ManualCpc com EnhancedCpcEnabled definido como verdadeiro para uma funcionalidade equivalente.
MaximizeConversionValue
Uma estratégia de lances automática que ajuda a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Campos | |
---|---|
cpc |
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. Mutável somente para estratégias de lances de portfólio. |
cpc |
Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável apenas para estratégias de lances de portfólio. |
target |
Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento. |
MaximizeConversions
Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Campos | |
---|---|
cpc |
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. Mutável somente para estratégias de lances de portfólio. |
cpc |
Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável somente para estratégias de lances de portfólio. |
target |
A opção de custo por ação (CPA) desejado. Esse é o valor médio que você quer gastar por ação de conversão especificada em microunidades da moeda da estratégia de lances. Se definida, a estratégia de lances vai gerar o maior número possível de conversões sem exceder o custo por ação desejado. Se o CPA desejado não estiver definido, a estratégia de lances vai tentar alcançar o menor CPA possível com base no orçamento. |
TargetCpa
Uma estratégia de lances automática que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.
Representação JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campos | |
---|---|
target |
Meta de CPA médio. Essa meta deve ser maior ou igual ao mínimo de unidades faturáveis baseadas na moeda da conta. |
cpc |
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. Isso só deve ser definido para estratégias de lances de portfólio. |
cpc |
Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio. |
TargetRoas
Uma estratégia de lances automáticos que ajuda a maximizar a receita enquanto calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.
Representação JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campos | |
---|---|
target |
Obrigatório. Receita escolhida (com base nos dados de conversão) por unidade de gasto. O valor deve estar entre 0,01 e 1.000,0, incluído. |
cpc |
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. Isso só deve ser definido para estratégias de lances de portfólio. |
cpc |
Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio. |
TargetSpend
Uma estratégia de lances automática que define os lances para conseguir o máximo de cliques possível com o orçamento disponível.
Representação JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Campos | |
---|---|
targetSpendMicros |
Descontinuado: é a meta de gastos em que os cliques serão maximizados. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para saber mais. |
cpc |
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. |
CampaignBudget
Um orçamento da campanha.
Representação JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento da campanha têm o seguinte formato:
|
delivery |
O método de exibição que determina a taxa em que o orçamento da campanha é gasto. O padrão será "STANDARD" se não for especificado em uma operação de criação. |
period |
Período em que o orçamento será usado. O padrão será DIÁRIO se não for especificado. |
amount |
É o valor do orçamento, na moeda local da conta. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária. O gasto mensal é limitado a 30,4 vezes esse valor. |
BudgetDeliveryMethod
Possíveis métodos de exibição de um orçamento.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
STANDARD |
O servidor de orçamentos controlará o serviço de forma equilibrada durante todo o período. |
ACCELERATED |
O servidor de orçamento não vai limitar a veiculação, e os anúncios serão veiculados o mais rápido possível. |
BudgetPeriod
Período possível de um orçamento.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
DAILY |
Orçamento diário. |
FIXED_DAILY |
Orçamento diário fixo. |
CUSTOM_PERIOD |
O orçamento personalizado pode ser usado com total_amount para especificar o limite do orçamento vitalício. |
Campanha
Uma campanha.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da campanha. Os nomes dos recursos de campanha têm o seguinte formato:
|
status |
É o status da campanha. Quando uma nova campanha é adicionada, o status é ATIVADO. |
serving |
O status de veiculação de anúncios da campanha. |
bidding |
O status do sistema da estratégia de lances da campanha. |
ad |
O status da otimização da veiculação de anúncios da campanha. |
advertising |
É a principal meta de veiculação de anúncios na campanha. As opções de segmentação podem ser refinadas em Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas. Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado. |
advertising |
Refinamento opcional para Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado. |
url |
A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um |
real |
Configurações para lances em tempo real, um recurso disponível apenas para campanhas que segmentam a rede do Ad Exchange. |
network |
As configurações de rede da campanha. |
dynamic |
A configuração para controlar os anúncios dinâmicos de pesquisa (DSA). |
shopping |
A configuração para controlar as campanhas do Shopping. |
geo |
A configuração de segmentação geográfica de anúncios. |
effective |
Os nomes dos recursos dos rótulos efetivos anexados a esta campanha. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a essa campanha. |
labels[] |
Os nomes dos recursos dos rótulos anexados a esta campanha. |
bidding |
É o tipo de estratégia de lances. Uma estratégia de lances pode ser criada definindo o esquema de lances para criar uma estratégia de lances padrão ou o campo Este campo é somente leitura. |
accessible |
Nome do recurso de Accessible BiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada identificada por "lanceStrategy". Deixar em branco se a campanha não usar uma estratégia de portfólio. Os atributos de estratégia irrestrita estão disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Já os atributos restritos estão disponíveis apenas para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos do recurso BiddingStrategy. |
frequency |
Uma lista que limita a frequência com que cada usuário vai ver os anúncios da campanha. |
selective |
Configuração de otimização seletiva para essa campanha, que inclui um conjunto de ações de conversão para otimização. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType. |
optimization |
Configuração da meta de otimização desta campanha, que inclui um conjunto de tipos de meta de otimização. |
tracking |
Configurações no nível da campanha para informações de acompanhamento. |
engine |
ID da campanha na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para a entidade do Google Ads, use "campaign.id". |
excluded |
Os tipos de campo de recurso que devem ser excluídos dessa campanha. Os links de recursos com esses tipos de campo não serão herdados por essa campanha do nível superior. |
create |
O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". O createTime será descontinuado na v1. Use creationTime. |
creation |
O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
last |
A data e a hora em que essa campanha foi modificada pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
id |
O ID da campanha. |
name |
O nome da campanha. Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas. Ele não pode conter nenhum caractere nulo (ponto de código 0x0), feed de linha NL (ponto de código 0xA) nem retorno de carro (ponto de código 0xD). |
tracking |
O modelo de URL para criar um URL de rastreamento. |
campaign |
O nome do recurso do orçamento da campanha. |
start |
A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD. |
end |
O último dia da campanha no fuso horário da veiculação no formato AAAA-MM-DD. Na criação, o padrão é 2037-12-30, ou seja, a campanha será exibida indefinidamente. Para definir que uma campanha existente seja exibida indefinidamente, defina esse campo para 2037-12-30. |
final |
Sufixo usado para anexar parâmetros de consulta às páginas de destino veiculadas com o acompanhamento paralelo. |
url |
Representa a desativação da expansão de URLs para mais URLs segmentados. Se desativada (verdadeiro), apenas os URLs finais no grupo de recursos ou especificados no Google Merchant Center ou nos feeds de dados da empresa do anunciante são segmentados. Se a opção estiver ativada (falso), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "false". |
Campo de união Precisa ser de portfólio (criado pelo serviço BiddingStrategy) ou padrão, que é incorporado à campanha. |
|
bidding |
O nome do recurso da estratégia de lances de portfólio usada pela campanha. |
manual |
Estratégia de lances de CPA manual padrão. Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante. Disponível apenas para campanhas de Serviços locais. |
manual |
Estratégia de lances manuais padrão de CPC. Lances manuais com base em cliques, em que o usuário paga por clique. |
manual |
Estratégia de lances de CPM manual padrão. Lances manuais com base nas impressões em que o usuário paga por mil impressões. |
maximize |
A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões sem exceder o orçamento. |
maximize |
Estratégia de lances padrão que maximiza o valor da conversão e define lances automaticamente para maximizar a receita sem exceder o orçamento. |
target |
Estratégia de lances de CPA desejado padrão que define lances automaticamente para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu. |
target |
Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para alcançar uma porcentagem de impressões escolhida. |
target |
Estratégia de lances padrão de ROAS desejado que maximiza automaticamente a receita e calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico. |
target |
Estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível com o orçamento disponível. |
percent |
Estratégia de lances de porcentagem padrão de CPC em que os lances são uma fração do preço anunciado de um produto ou serviço. |
target |
Uma estratégia de lances que otimiza automaticamente o custo por mil impressões. |
CampaignStatus
Possíveis status de uma campanha.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
A campanha está ativa e pode exibir anúncios. |
PAUSED |
A campanha foi pausada pelo usuário. |
REMOVED |
A campanha foi removida. |
CampaignServingStatus
Possíveis status de veiculação de uma campanha.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
SERVING |
Veiculação. |
NONE |
Nenhum. |
ENDED |
Finalizado. |
PENDING |
Pendente. |
SUSPENDED |
Suspenso. |
BiddingStrategySystemStatus
Os possíveis status do sistema de uma estratégia de lances.
Enums | |
---|---|
UNSPECIFIED |
Indica que ocorreu um erro inesperado, por exemplo, nenhum tipo de estratégia de lances foi encontrado ou nenhuma informação de status foi encontrada. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
A estratégia de lances está ativa, e o Google AdWords não encontrou nenhum problema específico com a estratégia. |
LEARNING_NEW |
A estratégia de lances está aprendendo porque foi criada ou reativada recentemente. |
LEARNING_SETTING_CHANGE |
A estratégia de lances está aprendendo por causa de uma mudança recente na configuração. |
LEARNING_BUDGET_CHANGE |
A estratégia de lances está em processo de aprendizado devido a uma mudança recente no orçamento. |
LEARNING_COMPOSITION_CHANGE |
A estratégia de lances está aprendendo devido a uma mudança recente no número de campanhas, grupos de anúncios ou palavras-chave associadas a ela. |
LEARNING_CONVERSION_TYPE_CHANGE |
A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão relevantes para a estratégia que o cliente modificou recentemente. |
LEARNING_CONVERSION_SETTING_CHANGE |
A estratégia de lances depende dos relatórios de conversão, e o cliente alterou as configurações de conversão recentemente. |
LIMITED_BY_CPC_BID_CEILING |
A estratégia de lances é limitada pelo teto de lances. |
LIMITED_BY_CPC_BID_FLOOR |
A estratégia de lances é limitada pelo lance mínimo. |
LIMITED_BY_DATA |
A estratégia de lances está limitada porque não houve tráfego de conversão suficiente nas últimas semanas. |
LIMITED_BY_BUDGET |
Uma parte significativa das palavras-chave nessa estratégia de lances está limitada pelo orçamento. |
LIMITED_BY_LOW_PRIORITY_SPEND |
A estratégia de lances não consegue atingir o gasto desejado porque a prioridade dele foi removida. |
LIMITED_BY_LOW_QUALITY |
Uma parte significativa das palavras-chave nessa estratégia de lances tem um Índice de qualidade baixo. |
LIMITED_BY_INVENTORY |
A estratégia de lances não pode gastar todo o orçamento devido à segmentação restrita. |
MISCONFIGURED_ZERO_ELIGIBILITY |
Acompanhamento de conversões ausente (sem pings) e/ou listas de remarketing para a SSC. |
MISCONFIGURED_CONVERSION_TYPES |
A estratégia de lances depende dos relatórios de conversão, e o cliente não tem os tipos de conversão que podem ser incluídos nos relatórios dessa estratégia. |
MISCONFIGURED_CONVERSION_SETTINGS |
A estratégia de lances depende dos relatórios de conversão, e as configurações de conversão do cliente estão incorretas. |
MISCONFIGURED_SHARED_BUDGET |
Há campanhas fora da estratégia de lances que compartilham orçamentos com as campanhas incluídas na estratégia. |
MISCONFIGURED_STRATEGY_TYPE |
A campanha tem um tipo de estratégia inválido e não está sendo veiculada. |
PAUSED |
A estratégia de lances não está ativa. Não há campanhas, grupos de anúncios ou palavras-chave ativas vinculadas à estratégia de lances. Ou não há orçamentos ativos conectados à estratégia de lances. |
UNAVAILABLE |
No momento, essa estratégia de lances não é compatível com relatórios de status. |
MULTIPLE_LEARNING |
Houve vários status do sistema LEARNING_* para essa estratégia de lances durante o período em questão. |
MULTIPLE_LIMITED |
Houve vários status LIMITED_* do sistema para essa estratégia de lances durante o período em questão. |
MULTIPLE_MISCONFIGURED |
Havia vários status de sistema MISCONFIGURED_* para essa estratégia de lances durante o período em questão. |
MULTIPLE |
Houve vários status do sistema para essa estratégia de lances durante o período em questão. |
AdServingOptimizationStatus
Enumeração que descreve possíveis status de veiculação.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
OPTIMIZE |
A veiculação de anúncios é otimizada com base na CTR da campanha. |
CONVERSION_OPTIMIZE |
A veiculação de anúncios é otimizada com base na CTR * conversão da campanha. Se a campanha não estiver na estratégia de lances do Otimizador de conversões, o padrão será "OTIMIZADO". |
ROTATE |
Os anúncios são alternados de forma uniforme por 90 dias e, em seguida, otimizados para cliques. |
ROTATE_INDEFINITELY |
Mostrar anúncios com desempenho inferior de maneira mais uniforme com anúncios de desempenho superior e não otimizar. |
UNAVAILABLE |
O status de otimização do serviço de anúncios não está disponível. |
AdvertisingChannelType
Enum que descreve os vários tipos de canais de publicidade.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SEARCH |
Rede de pesquisa. Inclui campanhas de display agrupadas e de pesquisa+. |
DISPLAY |
Somente na Rede de Display do Google. |
SHOPPING |
As campanhas do Shopping são veiculadas na propriedade do Shopping e nos resultados da pesquisa do google.com.br. |
HOTEL |
Campanhas de anúncios de hotéis. |
VIDEO |
Campanhas de vídeo. |
MULTI_CHANNEL |
campanhas de apps e campanhas de apps para engajamento, que são exibidas em vários canais. |
LOCAL |
Campanhas de anúncios locais. |
SMART |
Campanhas inteligentes. |
PERFORMANCE_MAX |
campanhas Performance Max. |
LOCAL_SERVICES |
Campanhas de serviços locais. |
DISCOVERY |
Campanhas Discovery. |
TRAVEL |
Campanhas de viagens. |
SOCIAL |
Campanhas sociais. |
AdvertisingChannelSubType
Enumeração que descreve os diferentes subtipos de canal.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como um valor de retorno. Representa um valor desconhecido nesta versão. |
SEARCH_MOBILE_APP |
Campanhas de apps para dispositivos móveis na Pesquisa. |
DISPLAY_MOBILE_APP |
campanhas de apps para dispositivos móveis da Rede de Display. |
SEARCH_EXPRESS |
Campanhas Express do Google Ads para pesquisa. |
DISPLAY_EXPRESS |
Campanhas do AdWords Express para display. |
SHOPPING_SMART_ADS |
Campanhas inteligentes do Shopping. |
DISPLAY_GMAIL_AD |
Campanhas publicitárias do Gmail. |
DISPLAY_SMART_CAMPAIGN |
Campanhas inteligentes da Rede de Display: Não é possível criar novas campanhas desse subtipo. |
VIDEO_OUTSTREAM |
Campanhas de vídeo out-stream. |
VIDEO_ACTION |
Campanhas TrueView for Action de vídeo. |
VIDEO_NON_SKIPPABLE |
Campanhas de vídeo com anúncios em vídeo não puláveis. |
APP_CAMPAIGN |
Campanha para apps que permite promover seu app Android ou iOS nos principais serviços do Google, incluindo a Pesquisa, o Google Play, o YouTube e a Rede de Display. |
APP_CAMPAIGN_FOR_ENGAGEMENT |
Campanha para apps para engajamento, focada em gerar mais engajamento com o app em várias das principais propriedades do Google, incluindo a Pesquisa, o YouTube e a Rede de Display. |
LOCAL_CAMPAIGN |
Campanhas especializadas em publicidade local. |
SHOPPING_COMPARISON_LISTING_ADS |
Campanhas de lista de comparação do Shopping. |
SMART_CAMPAIGN |
Campanhas inteligentes padrão. |
VIDEO_SEQUENCE |
Campanhas de vídeo com anúncios em vídeo em sequência. |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
Campanha de apps para pré-registro, especializada para anunciar o pré-registro de apps para dispositivos móveis, que segmenta vários canais de publicidade no Google Play, no YouTube e na Rede de Display. |
VIDEO_REACH_TARGET_FREQUENCY |
Campanha de alcance de vídeo com a estratégia de lances de frequência desejada. |
TRAVEL_ACTIVITIES |
campanhas de atividades de viagem. |
SOCIAL_FACEBOOK_TRACKING_ONLY |
O rastreamento do Facebook só é feito em campanhas sociais. |
CustomParameter
Um mapeamento que pode ser usado por tags de parâmetros personalizados em um trackingUrlTemplate
, finalUrls
ou mobile_final_urls
.
Representação JSON |
---|
{ "key": string, "value": string } |
Campos | |
---|---|
key |
A chave que corresponde ao nome da tag de parâmetro. |
value |
O valor a ser substituído. |
RealTimeBiddingSetting
Configurações para lances em tempo real, um recurso disponível apenas para campanhas que segmentam a rede do Ad Exchange.
Representação JSON |
---|
{ "optIn": boolean } |
Campos | |
---|---|
opt |
Indica se a campanha está ativada para lances em tempo real. |
NetworkSettings
As configurações de rede da campanha.
Representação JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Campos | |
---|---|
target |
Se os anúncios serão veiculados com os resultados da pesquisa do google.com.br. |
target |
Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que |
target |
Indica se os anúncios serão veiculados em canais específicos na Rede de Display do Google. Os canais são especificados usando o critério Canal. |
target |
Indica se os anúncios serão veiculados na rede de parceiros do Google. Esse recurso está disponível apenas para algumas contas de parceiros do Google selecionadas. |
DynamicSearchAdsSetting
A configuração para controlar os anúncios dinâmicos de pesquisa (DSA).
Representação JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Campos | |
---|---|
domain |
Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com". |
language |
Obrigatório. O código do idioma que especifica o idioma do domínio, por exemplo, "en". |
use |
Indica se a campanha usa exclusivamente URLs fornecidos pelo anunciante. |
ShoppingSetting
A configuração das campanhas do Shopping. Define o universo de produtos que podem ser anunciados pela campanha e como ela interage com outras campanhas do Shopping.
Representação JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Campos | |
---|---|
feed |
Rótulo do feed de produtos a serem incluídos na campanha. Só é possível definir um dos dois campos "feedLabel" ou "salesCountry". Se usado em vez de "salesCountry", o campo "feedLabel" aceita códigos de país no mesmo formato, por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center. |
use |
Indica se o inventário de listagem de veículos será segmentado. |
merchant |
ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo é imutável para campanhas do Shopping. |
sales |
País de venda dos produtos a serem incluídos na campanha. |
campaign |
Prioridade da campanha. As campanhas com prioridades numericamente maiores têm precedência sobre as com prioridades mais baixas. Esse campo é obrigatório para campanhas do Shopping, com valores entre 0 e 2. Esse campo é opcional para campanhas inteligentes do Shopping, mas precisa ser igual a 3 se definido. |
enable |
Se os produtos locais serão incluídos. |
GeoTargetTypeSetting
Representa um conjunto de configurações relacionadas à segmentação geográfica de anúncios.
Representação JSON |
---|
{ "positiveGeoTargetType": enum ( |
Campos | |
---|---|
positive |
A configuração usada para a segmentação geográfica positiva nessa campanha específica. |
negative |
A configuração usada para a segmentação geográfica negativa nessa campanha específica. |
PositiveGeoTargetType
Os possíveis tipos de segmentação geográfica positivas.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nessa versão. |
PRESENCE_OR_INTEREST |
Especifica que um anúncio é acionado se o usuário está ou demonstra interesse nos locais segmentados do anunciante. |
SEARCH_INTEREST |
Especifica que um anúncio é acionado se o usuário pesquisar os locais segmentados do anunciante. Esse recurso só pode ser usado com campanhas de pesquisa e padrão do Shopping. |
PRESENCE |
Especifica que um anúncio será acionado se o usuário estiver na região de segmentação do anunciante ou regularmente nessas regiões. |
NegativeGeoTargetType
Os possíveis tipos de segmentação geográfica negativa.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nessa versão. |
PRESENCE_OR_INTEREST |
Especifica que um usuário não vai receber o anúncio se estiver em um local excluído do anunciante ou demonstrar interesse por ele. |
PRESENCE |
Especifica que um usuário não vai ver o anúncio se estiver em locais excluídos do anunciante. |
FrequencyCapEntry
Esse tipo não tem campos.
Uma regra que especifica o número máximo de vezes que um anúncio (ou algum conjunto de anúncios) pode ser exibido para um usuário em um determinado período.
SelectiveOptimization
Configuração de otimização seletiva desta campanha, que inclui um conjunto de ações de conversão que serão otimizadas. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.
Representação JSON |
---|
{ "conversionActions": [ string ] } |
Campos | |
---|---|
conversion |
Conjunto selecionado de nomes de recursos para ações de conversão para otimizar esta campanha. |
OptimizationGoalSetting
Configuração da meta de otimização para essa campanha, que inclui um conjunto de tipos de meta de otimização.
Representação JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Campos | |
---|---|
optimization |
A lista de tipos de meta de otimização. |
OptimizationGoalType
O tipo de meta de otimização
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como um valor de retorno. Representa um valor desconhecido nesta versão. |
CALL_CLICKS |
Otimizar para cliques em botões de chamada. As conversões de cliques em ligações são as vezes que as pessoas selecionaram "Ligar" para entrar em contato com uma loja depois de visualizar um anúncio. |
DRIVING_DIRECTIONS |
Otimizar para rotas de carro. As conversões de direções para chegar de carro são as vezes que as pessoas selecionaram "Como chegar" para ir a uma loja depois de ver um anúncio. |
APP_PRE_REGISTRATION |
Otimizar para pré-registro. As conversões de pré-registro são o número de inscrições para receber uma notificação quando o app for lançado. |
TrackingSetting
Configurações no nível da campanha para informações de acompanhamento.
Representação JSON |
---|
{ "trackingUrl": string } |
Campos | |
---|---|
tracking |
O URL usado para o acompanhamento dinâmico. |
ManualCpa
Esse tipo não tem campos.
Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante.
ManualCpc
Lances manuais com base no clique, em que o usuário paga por clique.
Representação JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
enhanced |
Indica se os lances devem ser otimizados com base nos dados do otimizador de conversões. |
ManualCpm
Esse tipo não tem campos.
Lances manuais com base nas impressões em que o usuário paga por mil impressões.
PercentCpc
Uma estratégia de lances em que os lances são uma fração do preço anunciado de um produto ou serviço.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
cpc |
Limite de lance máximo que pode ser definido pela estratégia de lances. É um campo opcional inserido pelo anunciante e especificado nos micros locais. Observação: um valor zero é interpretado da mesma forma que um bid_ceiling indefinido. |
enhanced |
Ajusta o lance para cada leilão para cima ou para baixo, dependendo da probabilidade de uma conversão. Os lances individuais podem exceder cpcBidCeuringMicros, mas o valor médio do lance de uma campanha não deve. |
TargetCpm
Esse tipo não tem campos.
O CPM desejado (custo por mil impressões) é uma estratégia de lances automática que define lances para otimizar a performance com base no CPM desejado.
CampaignAsset
Uma vinculação entre uma campanha e um recurso.
Representação JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da campanha. Os nomes dos recursos de CampaignAsset têm o seguinte formato:
|
status |
Status do recurso da campanha. |
campaign |
A campanha à qual o recurso está vinculado. |
asset |
O recurso que está vinculado à campanha. |
CampaignAssetSet
O CampaignAssetSet é a vinculação entre uma campanha e um conjunto de recursos. A adição de um CampaignAssetSet vincula um conjunto de recursos a uma campanha.
Representação JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do grupo de recursos da campanha. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:
|
campaign |
A campanha a que este conjunto de recursos está vinculado. |
asset |
O conjunto de recursos vinculado à campanha. |
status |
O status do recurso do conjunto de recursos da campanha. Somente leitura. |
CampaignAudienceView
Uma visualização do público-alvo da campanha. Inclui dados de desempenho de interesses e listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados por critério de público-alvo e campanha. Essa visualização inclui apenas os públicos-alvo anexados no nível da campanha.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
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:
|
CampaignCriterion
Um critério de campanha.
Representação JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do critério da campanha. Os nomes dos recursos de critério da campanha têm o seguinte formato:
|
display |
O nome de exibição do critério. Este campo é ignorado para mutações. |
type |
Tipo do critério. |
status |
O status do critério. |
last |
A data e a hora em que esse critério de campanha foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
criterion |
ID do critério. Este campo é ignorado durante a modificação. |
bid |
O modificador dos lances quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores. Use 0 para desativar um tipo de dispositivo. |
negative |
Indica se o critério será segmentado ( |
Campo de união Exatamente um deve ser definido. |
|
keyword |
Palavra-chave. |
location |
Local. |
device |
Dispositivo. |
age |
Faixa etária. |
gender |
Gênero. |
user |
Lista de usuários. |
language |
e linguagem Hashicorp. |
webpage |
página da Web. |
location |
Grupo por locais |
CampaignCriterionStatus
Os status possíveis de um CampaignCritério.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
O critério da campanha está ativado. |
PAUSED |
O critério da campanha está pausado. |
REMOVED |
O critério da campanha é removido. |
LanguageInfo
Um critério de idioma.
Representação JSON |
---|
{ "languageConstant": string } |
Campos | |
---|---|
language |
O nome do recurso da constante de idioma. |
LocationGroupInfo
Um raio em torno de uma lista de locais especificados em um feed.
Representação JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Campos | |
---|---|
geo |
Constantes de segmentação por área geográfica que restringem o escopo da área geográfica no feed. No momento, só é permitida uma constante de segmentação geográfica. |
radius |
Unidade do raio. Milhas e metros são aceitos para constantes de segmentação por área geográfica. Os milissegundos e metros são aceitos para conjuntos de itens do feed. Isso é obrigatório e precisa ser definido em operações CREATE. |
feed |
São os itens de grupo com os quais os itens de feed são segmentados. Se vários IDs forem especificados, todos os itens que aparecerem em pelo menos um conjunto serão segmentados. Esse campo não pode ser usado com geoTargetConstants. Esse campo é opcional e só pode ser definido em operações CREATE. |
radius |
Distância em unidades que especifica o raio em torno das regiões de segmentação. Isso é obrigatório e deve ser definido nas operações CREATE. |
LocationGroupRadiusUnits
A unidade de distância do raio no grupo por local (por exemplo, MILHAS)
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
METERS |
Metros |
MILES |
Milhas |
MILLI_MILES |
Milli Miles |
CampaignEffectiveLabel
Representa uma relação entre uma campanha e um rótulo eficaz. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a essa campanha.
Representação JSON |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
Nome do recurso. Os nomes dos recursos do CampaignEffectivelabel têm o seguinte formato: |
campaign |
A campanha à qual o rótulo efetivo está anexado. |
label |
O rótulo efetivo atribuído à campanha. |
owner |
O ID do Cliente proprietário do rótulo em vigor. |
CampaignLabel
Representa um relacionamento entre uma campanha e um rótulo.
Representação JSON |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
Campos | |
---|---|
resource |
Nome do recurso. Os nomes dos recursos de rótulo de campanha têm o formato: |
campaign |
A campanha a que o rótulo está anexado. |
label |
Rótulo atribuído à campanha. |
owner |
O ID do cliente proprietário do rótulo. |
CartDataSalesView
Visualização de vendas de dados do carrinho.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de vendas de dados do carrinho. Os nomes dos recursos da visualização de vendas de dados do carrinho têm o formato: |
Público-alvo
O público-alvo é uma opção de segmentação eficaz que permite cruzar diferentes atributos de segmentos, como informações demográficas e afinidades detalhadas, para criar públicos-alvo que representam seções dos seus segmentos.
Representação JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Campos | |
---|---|
resource |
O nome do recurso do público-alvo. Os nomes de público-alvo têm o seguinte formato:
|
id |
ID do público-alvo. |
name |
Obrigatório. Nome do público-alvo. Ele precisa ser exclusivo em todos os públicos-alvo. Precisa ter no mínimo 1 e no máximo 255 caracteres. |
description |
Descrição desse público-alvo. |
ConversionAction
Uma ação de conversão
Representação JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da ação de conversão. Os nomes dos recursos de ações de conversão têm o seguinte formato:
|
creation |
Carimbo de data/hora da criação da atividade do Floodlight, formatado em ISO 8601. |
status |
É o status desta ação de conversão para acúmulo de eventos de conversão. |
type |
O tipo dessa ação de conversão. |
category |
A categoria de conversões informada para essa ação. |
value |
Configurações relacionadas ao valor dos eventos de conversão associados a essa ação de conversão. |
attribution |
Configurações relacionadas ao modelo de atribuição da ação de conversão. |
floodlight |
Configurações do Floodlight para tipos de conversão do Floodlight. |
id |
O ID da ação de conversão. |
name |
Nome da ação de conversão. Este campo é obrigatório e não deve ficar em branco ao criar novas ações de conversão. |
primary |
Se o bit primaryForGoal de uma ação de conversão for falso, ela não poderá receber lances para todas as campanhas, independentemente da meta de conversão do cliente ou da meta de conversão da campanha. No entanto, as metas de conversão personalizadas não respeitam a propriedade "primaryForGoal". Portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão "primaryForGoal = false", essa ação de conversão ainda poderá receber lances. Por padrão, primaryForGoal será "true" se não for definido. Na V9, o atributo primaryForGoal só pode ser definido como "false" após a criação por uma operação de "update" porque ele não é declarado como opcional. |
owner |
O nome do recurso do cliente proprietário da ação de conversão ou nulo se essa for uma ação de conversão definida pelo sistema. |
include |
Indica se essa ação de conversão precisa ser incluída na métrica "clientAccountConversions". |
include |
Se essa ação de conversão precisa ser incluída na métrica "conversões". |
click |
É o número máximo de dias que pode transcorrer entre uma interação (por exemplo, um clique) e um evento de conversão. |
app |
ID do app para uma ação de conversão de app. |
ConversionActionStatus
Possíveis status de uma ação de conversão.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
As conversões serão registradas. |
REMOVED |
As conversões não serão registradas. |
HIDDEN |
As conversões não serão registradas, e a ação de conversão não vai aparecer na interface. |
ConversionActionType
Possíveis tipos de uma ação de conversão.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
AD_CALL |
Conversões que ocorrem quando um usuário clica na extensão de chamada de um anúncio. |
CLICK_TO_CALL |
Conversões que ocorrem quando um usuário em um dispositivo móvel clica em um número de telefone. |
GOOGLE_PLAY_DOWNLOAD |
Conversões que ocorrem quando um usuário faz o download de um app para dispositivos móveis na Google Play Store. |
GOOGLE_PLAY_IN_APP_PURCHASE |
Conversões que ocorrem quando um usuário faz uma compra em um app usando o Faturamento do Android. |
UPLOAD_CALLS |
As conversões de chamada que são acompanhadas pelo anunciante e enviadas. |
UPLOAD_CLICKS |
Conversões que são rastreadas pelo anunciante e enviadas com cliques atribuídos. |
WEBPAGE |
Conversões que ocorrem em uma página da Web. |
WEBSITE_CALL |
Conversões que ocorrem quando um usuário liga para um número de telefone gerado dinamicamente no site de um anunciante. |
STORE_SALES_DIRECT_UPLOAD |
Conversão de vendas na loja com base em uploads de dados próprios ou de comerciantes de terceiros. Somente os clientes na lista de permissões podem usar os tipos de upload direto de vendas na loja. |
STORE_SALES |
Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros do comerciante e/ou de compras na loja usando cartões de redes de pagamento. Somente os clientes na lista de permissões podem usar os tipos de vendas na loja. Somente leitura. |
FIREBASE_ANDROID_FIRST_OPEN |
Conversões de primeiro acesso do app Android acompanhadas com o Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Conversões de compras no app de apps Android acompanhadas pelo Firebase. |
FIREBASE_ANDROID_CUSTOM |
Conversões personalizadas de apps Android acompanhadas com o Firebase. |
FIREBASE_IOS_FIRST_OPEN |
Conversões de primeiro acesso do app iOS acompanhadas pelo Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
Conversões de compras no app de um app iOS rastreadas pelo Firebase. |
FIREBASE_IOS_CUSTOM |
Conversões personalizadas de apps iOS acompanhadas com o Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
Conversões de primeiro acesso de apps Android acompanhadas pela análise de apps de terceiros. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Conversões de compras no app Android acompanhadas pela análise de apps de terceiros. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Conversões personalizadas de apps Android acompanhadas pela análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Conversões de primeiro acesso de apps iOS rastreadas pela análise de apps de terceiros. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Conversões de compra no aplicativo no aplicativo iOS acompanhadas por meio da análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Conversões personalizadas de apps para iOS rastreadas usando a análise de apps de terceiros. |
ANDROID_APP_PRE_REGISTRATION |
Conversões que ocorrem quando um usuário faz o pré-registro de um aplicativo para dispositivos móveis na Google Play Store. Somente leitura. |
ANDROID_INSTALLS_ALL_OTHER_APPS |
Conversões que acompanham todos os downloads do Google Play que não são rastreados por um tipo específico de app. Somente leitura. |
FLOODLIGHT_ACTION |
Atividade do Floodlight que conta o número de vezes que os usuários visitaram uma página da Web específica após ver ou clicar em um dos anúncios de um anunciante. Somente leitura. |
FLOODLIGHT_TRANSACTION |
Atividade do Floodlight que rastreia o número de vendas realizadas ou o número de itens comprados. Também é possível capturar o valor total de cada venda. Somente leitura. |
GOOGLE_HOSTED |
Conversões que acompanham ações locais de produtos e serviços do Google depois de interagir com um anúncio. Somente leitura. |
LEAD_FORM_SUBMIT |
Conversões informadas quando um usuário envia um formulário de lead. Somente leitura. |
SALESFORCE |
Conversões que vêm do Salesforce. Somente leitura. |
SEARCH_ADS_360 |
Conversões importadas dos dados do Floodlight do Search Ads 360. Somente leitura. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
As conversões de chamada que ocorrem em anúncios de campanhas inteligentes sem a configuração do acompanhamento de chamadas usando os critérios personalizados das campanhas inteligentes. Somente leitura. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
O usuário clica em um elemento de chamada no Google Maps. Apenas campanhas inteligentes. Somente leitura. |
SMART_CAMPAIGN_MAP_DIRECTIONS |
O usuário solicita rotas para um local da empresa no Google Maps. Apenas para campanhas inteligentes. Somente leitura. |
SMART_CAMPAIGN_TRACKED_CALLS |
As conversões de chamada que ocorrem em anúncios de campanhas inteligentes com configuração de acompanhamento de chamadas usando critérios personalizados. Somente leitura. |
STORE_VISITS |
Conversões que ocorrem quando um usuário visita a loja de varejo de um anunciante. Somente leitura. |
WEBPAGE_CODELESS |
Conversões criadas a partir de eventos do site (como envios de formulários ou carregamentos de página) que não usam snippets de eventos codificados individualmente. Somente leitura. |
UNIVERSAL_ANALYTICS_GOAL |
Conversões provenientes de metas vinculadas do Universal Analytics. |
UNIVERSAL_ANALYTICS_TRANSACTION |
Conversões que vêm de transações vinculadas do Universal Analytics. |
GOOGLE_ANALYTICS_4_CUSTOM |
Conversões que vêm de eventos personalizados vinculados do Google Analytics 4. |
GOOGLE_ANALYTICS_4_PURCHASE |
Conversões que vêm das conversões de compra vinculadas do Google Analytics 4. |
ConversionActionCategory
A categoria de conversões associadas a uma ConversionAction.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
DEFAULT |
Categoria padrão. |
PAGE_VIEW |
Usuário acessando uma página. |
PURCHASE |
Evento de compra, vendas ou "pedido feito". |
SIGNUP |
Ação do usuário de inscrição. |
LEAD |
Ação de geração de leads. |
DOWNLOAD |
Ação de download de software (como para um app). |
ADD_TO_CART |
Adição de itens a um carrinho de compras ou sacola no site de um anunciante. |
BEGIN_CHECKOUT |
Quando alguém inicia o fluxo de finalização de compra no site de um anunciante. |
SUBSCRIBE_PAID |
O início de uma assinatura paga de um produto ou serviço. |
PHONE_CALL_LEAD |
Uma chamada para indicar interesse na oferta de um anunciante. |
IMPORTED_LEAD |
Uma conversão de lead importada de uma fonte externa para o Google Ads. |
SUBMIT_LEAD_FORM |
O envio de um formulário em um site do anunciante indicando interesse comercial. |
BOOK_APPOINTMENT |
O agendamento de um horário com a empresa de um anunciante. |
REQUEST_QUOTE |
Uma solicitação de cotação ou estimativa de preço. |
GET_DIRECTIONS |
Uma pesquisa pelo local da empresa de um anunciante com a intenção de visitar. |
OUTBOUND_CLICK |
Um clique para acessar o site do parceiro de um anunciante. |
CONTACT |
Uma chamada, SMS, e-mail, chat ou outro tipo de contato com um anunciante. |
ENGAGEMENT |
Um evento de engajamento no site, como tempo de permanência no site ou uma meta inteligente do Google Analytics (GA). Destinado a ser usado para importações de metas do GA, Firebase e GA Gold. |
STORE_VISIT |
Uma visita a uma loja física. |
STORE_SALE |
Uma venda que ocorre em uma loja física. |
QUALIFIED_LEAD |
Uma conversão de lead importada de uma fonte externa para o Google Ads, que foi qualificada pelo anunciante (equipe de marketing/vendas). Na jornada de lead a venda, os anunciantes recebem leads e, em seguida, entram em contato com o consumidor. Se o consumidor tiver interesse e puder comprar o produto dele, o anunciante vai marcar esses leads como "leads qualificados". |
CONVERTED_LEAD |
Uma conversão de lead importada de uma fonte externa para o Google Ads que concluiu uma etapa escolhida conforme definido pelo anunciante de geração de leads. |
ValueSettings
Configurações relacionadas ao valor dos eventos de conversão associados a essa ação.
Representação JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Campos | |
---|---|
default |
O valor a ser usado quando os eventos dessa ação de conversão forem enviados com um valor inválido, não permitido ou ausente, ou quando essa ação de conversão estiver configurada para usar sempre o valor padrão. |
default |
O código da moeda a ser usado quando os eventos de conversão dessa ação forem enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão estiver configurada para sempre usar o valor padrão. |
always |
Controla se o valor padrão e o código de moeda padrão são usados no lugar do valor e do código de moeda especificados nos eventos de conversão para essa ação de conversão. |
AttributionModelSettings
Configurações relacionadas ao modelo de atribuição da ação de conversão.
Representação JSON |
---|
{ "attributionModel": enum ( |
Campos | |
---|---|
attribution |
O tipo de modelo de atribuição dessa ação de conversão. |
data |
O status do modelo de atribuição baseada em dados para a ação de conversão. |
AttributionModel
O modelo de atribuição que descreve como distribuir o crédito de uma conversão específica entre muitas interações anteriores.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
EXTERNAL |
Usa atribuição externa. |
GOOGLE_ADS_LAST_CLICK |
Atribui todo o crédito de uma conversão ao último clique. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
Atribui todo o crédito de uma conversão ao primeiro clique usando a atribuição da Pesquisa Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Atribui o crédito de uma conversão igualmente a todos os cliques usando a atribuição da Pesquisa Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Atribui exponencialmente mais crédito de uma conversão aos cliques mais recentes usando a atribuição da Pesquisa Google (metade da vida útil é de uma semana). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Atribui 40% do crédito de uma conversão ao primeiro e ao último clique. Os 20% restantes serão distribuídos de maneira uniforme entre todos os outros cliques. Essa opção usa a atribuição da Pesquisa Google. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Modelo flexível que usa o aprendizado de máquina para determinar a distribuição adequada de crédito entre os cliques usando a atribuição da Pesquisa Google. |
DataDrivenModelStatus
Enumera os status do modelo baseado em dados.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
AVAILABLE |
O modelo baseado em dados está disponível. |
STALE |
O modelo baseado em dados está desatualizado. Ele não foi atualizado há pelo menos sete dias. Ele ainda está em uso, mas vai expirar se não for atualizado em 30 dias. |
EXPIRED |
O modelo baseado em dados expirou. Ele não foi atualizado há pelo menos 30 dias e não pode ser usado. Isso geralmente acontece porque não houve o número necessário de eventos em um período recente de 30 dias. |
NEVER_GENERATED |
O modelo baseado em dados nunca foi gerado. Isso geralmente acontece porque nunca houve o número necessário de eventos em um período de 30 dias. |
FloodlightSettings
Configurações relacionadas a uma ação de conversão do Floodlight.
Representação JSON |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
Campos | |
---|---|
activity |
String usada para identificar um grupo de atividades do Floodlight ao registrar as conversões. |
activity |
String usada para identificar uma atividade do Floodlight ao registrar conversões. |
activity |
ID da atividade do Floodlight no DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
Uma variável personalizada de conversão. Consulte "Sobre dimensões e métricas personalizadas do Floodlight no novo Search Ads 360" em https://support.google.com/sa360/answer/13567857.
Representação JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da variável personalizada de conversão. Os nomes dos recursos de variáveis personalizadas de conversão têm o seguinte formato:
|
id |
O ID da variável personalizada de conversão. |
name |
Obrigatório. O nome da variável personalizada de conversão. O nome precisa ser exclusivo. O nome pode ter até 100 caracteres. Não deve haver espaços extras antes e depois. |
tag |
Obrigatório. A tag da variável personalizada de conversão. A tag precisa ser exclusiva e consistir em um caractere "u" seguido diretamente por um número menor ou igual a 100. Por exemplo: "u4". |
status |
O status da variável personalizada de conversão para o acúmulo de eventos de conversão. |
owner |
O nome do recurso do cliente que é proprietário da variável personalizada de conversão. |
family |
Família da variável personalizada de conversão. |
cardinality |
Cardinalidade da variável personalizada de conversão. |
floodlight |
Campos para variáveis personalizadas de conversão do Floodlight no Search Ads 360. |
custom |
Os IDs das colunas personalizadas que usam essa variável personalizada de conversão. |
ConversionCustomVariableStatus
Status possíveis de uma variável personalizada de conversão.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ACTIVATION_NEEDED |
A ativação da variável personalizada de conversão está pendente e não acumulará estatísticas até ser definida como ATIVADO. Esse status não pode ser usado em solicitações CREATE e UPDATE. |
ENABLED |
A variável personalizada de conversão é ativada e acumula estatísticas. |
PAUSED |
A variável personalizada de conversão é pausada e não acumula estatísticas até ser definida como ATIVADA novamente. |
ConversionCustomVariableFamily
Família de uma variável personalizada de conversão.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
STANDARD |
A variável personalizada de conversão padrão. Os clientes precisam fazer a ativação antes do uso. |
FLOODLIGHT |
A variável personalizada de conversão importada de uma variável personalizada do Floodlight. |
ConversionCustomVariableCardinality
Cardinalidade de uma variável personalizada de conversão.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
BELOW_ALL_LIMITS |
A variável personalizada de conversão tem cardinalidade abaixo de todos os limites. A variável pode ser usada para segmentação, e as estatísticas podem acumular novos valores se a variável estiver ativada. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
A variável personalizada de conversão tem cardinalidade que excede o limite de segmentação, mas não excede o limite de estatísticas. A segmentação será desativada, mas as estatísticas poderão ser acumuladas para novos valores se a variável estiver ativada. |
APPROACHES_STATS_LIMIT |
A variável personalizada de conversão excedeu os limites de segmentação e está se aproximando dos limites de estatísticas (> 90%). A segmentação será desativada, mas as estatísticas poderão ser acumuladas para novos valores se a variável estiver ativada. |
EXCEEDS_STATS_LIMIT |
A variável personalizada de conversão excedeu os limites de segmentação e estatísticas. A segmentação será desativada, e as estatísticas das variáveis ativadas só poderão ser acumuladas se os valores atuais não aumentarem a cardinalidade da variável. |
FloodlightConversionCustomVariableInfo
Informações sobre as variáveis personalizadas de conversão do Floodlight no Search Ads 360.
Representação JSON |
---|
{ "floodlightVariableType": enum ( |
Campos | |
---|---|
floodlight |
Tipo de variável do Floodlight definida no Search Ads 360. |
floodlight |
Tipo de dados da variável do Floodlight definido no Search Ads 360. |
FloodlightVariableType
Tipo da variável do Floodlight, conforme definido no Search Ads 360. Consulte https://support.google.com/searchads/answer/4397154?hl=en para saber mais.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
DIMENSION |
Tipo de variável de dimensão do Floodlight. |
METRIC |
Tipo de variável métrica do Floodlight. |
UNSET |
O tipo de variável do Floodlight não está definido. |
FloodlightVariableDataType
O tipo de dados da variável do Floodlight, conforme definido no Search Ads 360. Acesse https://support.google.com/searchads/answer/4397154?hl=en para saber mais.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
NUMBER |
Representa uma variável do Floodlight do tipo "Número". Essa variável pode ser atribuída a variáveis do Floodlight dos tipos DIMENSÃO ou MÉTRICA. |
STRING |
Representa uma variável do Floodlight do tipo "String". Essa variável pode ser atribuída a variáveis do Floodlight do tipo DIMENSÃO. |
Cliente
Um cliente.
Representação JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Campos | |
---|---|
resource |
O nome do recurso do cliente. Os nomes dos recursos do cliente têm o seguinte formato:
|
conversion |
Configuração do acompanhamento de conversões de um cliente. |
account |
Tipo de conta de mecanismo, por exemplo: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track etc. |
double |
Configuração do DoubleClick Campaign Manager (DCM) para um cliente administrador. |
account |
Status da conta, como "Ativada", "Pausada", "Removida" etc. |
last |
A data e a hora em que o cliente foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss". |
engine |
ID da conta na conta de mecanismo externo. |
status |
O status do cliente. |
creation |
O carimbo de data/hora em que o cliente foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
id |
O ID do cliente. |
descriptive |
Nome descritivo opcional e não exclusivo do cliente. |
currency |
A moeda em que a conta opera. É compatível com um subconjunto dos códigos de moeda do padrão ISO 4217. |
time |
O ID de fuso horário local do cliente. |
tracking |
O modelo de URL para criar um URL de rastreamento com base em parâmetros. |
final |
O modelo de URL para anexar parâmetros ao URL final. |
auto |
Indica se a codificação automática está ativada para o cliente. |
manager |
Se o cliente é um gerente. |
ConversionTrackingSetting
Uma coleção de configurações do cliente relacionadas ao acompanhamento de conversões do Search Ads 360.
Representação JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Campos | |
---|---|
accepted |
Se o cliente aceitou os termos de dados do cliente. Se você usar o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura. Para mais informações, acesse https://support.google.com/adspolicy/answer/7475709. |
conversion |
Status do acompanhamento de conversões. Ele indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário desse acompanhamento. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai variar com base no |
enhanced |
Indica se o cliente ativou as conversões otimizadas para leads. Se você estiver usando o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura. |
google |
O nome do recurso do cliente em que as conversões são criadas e gerenciadas. Este campo é somente leitura. |
conversion |
O ID de acompanhamento de conversões usado para esta conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (o conversionTrackingStatus sim). Este campo é somente leitura. |
google |
O ID de acompanhamento de conversões do administrador do cliente. Esse valor é definido quando o cliente ativa o acompanhamento de conversões e substitui o conversionTrackingId. Só é possível gerenciar esse campo na interface do Google Ads. Este campo é somente leitura. |
cross |
O ID de acompanhamento de conversões do administrador do cliente. Isso é definido quando o cliente ativa o acompanhamento de conversões de várias contas e substitui o conversionAcompanhamentoId. |
ConversionTrackingStatus
Status do acompanhamento de conversões do cliente.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
NOT_CONVERSION_TRACKED |
O cliente não usa o acompanhamento de conversões. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
As ações de conversão são criadas e gerenciadas por esse cliente. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
As ações de conversão são criadas e gerenciadas pelo administrador especificado na login-customer-id da solicitação. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
As ações de conversão são criadas e gerenciadas por um administrador diferente do cliente ou administrador especificado na login-customer-id da solicitação. |
AccountType
Possíveis tipos de conta de mecanismo.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
BAIDU |
Conta do Baidu. |
ENGINE_TRACK |
Conta de rastreamento por mecanismo. |
FACEBOOK |
Conta do Facebook. |
FACEBOOK_GATEWAY |
Conta do Facebook gerenciada pelo gateway. |
GOOGLE_ADS |
conta do Google Ads. |
MICROSOFT |
conta do Microsoft Advertising. |
SEARCH_ADS_360 |
Conta de administrador do Search Ads 360. |
YAHOO_JAPAN |
do Yahoo! Japan. |
DoubleClickCampaignManagerSetting
Configuração do DoubleClick Campaign Manager (DCM) para um cliente administrador.
Representação JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
Campos | |
---|---|
advertiser |
ID do anunciante do Campaign Manager associado a esse cliente. |
network |
ID da rede do Campaign Manager associada a esse cliente. |
time |
Fuso horário da rede do Campaign Manager associada a esse cliente no formato do banco de dados de fusos horários da IANA, como America/New_York. |
AccountStatus
Status possíveis de uma conta.
Enums | |
---|---|
UNSPECIFIED |
Valor padrão. |
UNKNOWN |
Valor desconhecido. |
ENABLED |
A conta pode veicular anúncios. |
PAUSED |
A conta é desativada pelo usuário. |
SUSPENDED |
A conta é desativada por um processo interno. |
REMOVED |
A conta é desativada de forma irreversível. |
DRAFT |
A conta ainda está em processo de configuração e ainda não está ATIVADA. |
CustomerStatus
Possíveis status de um cliente.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
Indica uma conta ativa capaz de veicular anúncios. |
CANCELED |
Indica que uma conta cancelada não pode veicular anúncios. Pode ser reativado por um usuário administrador. |
SUSPENDED |
Indica uma conta suspensa que não pode veicular anúncios. Pode ser ativado somente pelo Suporte do Google. |
CLOSED |
Indica uma conta fechada que não pode veicular anúncios. A conta de teste também terá o status CLOSED. O status é permanente e não pode ser reaberto. |
CustomerAsset
Uma conexão entre um cliente e um recurso.
Representação JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do cliente. Os nomes dos recursos CustomerAsset têm o seguinte formato:
|
asset |
Obrigatório. O recurso vinculado ao cliente. |
status |
Status do recurso do cliente. |
CustomerAssetSet
CustomerAssetSet é a vinculação entre um cliente e um conjunto de recursos. A adição de um CustomerAssetSet vincula um conjunto de recursos a um cliente.
Representação JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do conjunto de recursos do cliente. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:
|
asset |
O conjunto de recursos vinculado ao cliente. |
customer |
O cliente a que este conjunto de recursos está vinculado. |
status |
O status do conjunto de recursos do cliente. Somente leitura. |
AccessibleBiddingStrategy
Representa uma visualização das estratégias de lances que pertencem ao cliente e foram compartilhadas com ele.
Ao contrário de BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e que foram compartilhadas com ele, além das estratégias dele. Esse recurso não fornece métricas e apenas expõe um subconjunto limitado dos atributos da estratégia de lances.
Representação JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da estratégia de lances acessível. Os nomes dos recursos AccessibleBiddingStrategy têm o seguinte formato:
|
id |
O ID da estratégia de lances. |
name |
É o nome da estratégia de lances. |
type |
É o tipo de estratégia de lances. |
owner |
O ID do cliente proprietário da estratégia de lances. |
owner |
DescriptiveName do cliente proprietário da estratégia de lances. |
Campo de união Apenas uma pode ser definida. |
|
maximize |
Uma estratégia de lances automática que ajuda a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento. |
maximize |
Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento. |
target |
Uma estratégia de lances que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado. |
target |
Uma estratégia de lances que otimiza automaticamente para uma porcentagem escolhida de impressões. |
target |
Uma estratégia de lances que ajuda a maximizar a receita e calcular o retorno do investimento em publicidade (ROAS) desejado. |
target |
Uma estratégia que define os lances para conseguir o máximo de cliques possível com o orçamento disponível. |
MaximizeConversionValue
Uma estratégia de lances automática que ajuda a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.
Representação JSON |
---|
{ "targetRoas": number } |
Campos | |
---|---|
target |
Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento. |
MaximizeConversions
Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.
Representação JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Campos | |
---|---|
target |
A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição. |
target |
A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição. |
TargetCpa
Uma estratégia de lances automática que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.
Representação JSON |
---|
{ "targetCpaMicros": string } |
Campos | |
---|---|
target |
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 calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.
Representação JSON |
---|
{ "targetRoas": number } |
Campos | |
---|---|
target |
Receita escolhida (com base nos dados de conversão) por unidade de gasto. |
TargetSpend
Uma estratégia de lances automática que define os lances para conseguir o máximo de cliques possível com o orçamento disponível.
Representação JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Campos | |
---|---|
targetSpendMicros |
A meta de gastos na qual maximizar os cliques. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para mais detalhes. |
cpc |
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. |
CustomerManagerLink
Representa a relação de vínculo entre cliente e gerente.
Representação JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resource |
Nome do recurso. Os nomes dos recursos de CustomerManagerLink têm o formato: |
status |
Status da vinculação entre o cliente e o administrador. |
manager |
O cliente administrador vinculado ao cliente. |
manager |
ID do link de gerente de clientes. Este campo é somente leitura. |
start |
O carimbo de data/hora em que o CustomerManagerLink foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
ManagerLinkStatus
Status possíveis de um link.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ACTIVE |
Indica a relação atual em efeito |
INACTIVE |
Indica relacionamento encerrado |
PENDING |
Indica que a relação foi solicitada pelo gerente, mas o cliente ainda não aceitou. |
REFUSED |
O gerente solicitou o relacionamento, mas o cliente se recusou. |
CANCELED |
Indica que a relação foi solicitada pelo gerente, mas ele a cancelou. |
ClienteCliente
Uma associação entre o cliente e um cliente do cliente. Os clientes só existem para clientes administradores. Todos os clientes diretos e indiretos do cliente, além do próprio administrador, estão incluídos.
Representação JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso do cliente do cliente. Os nomes dos recursos CustomerClient têm o formato: |
applied |
Os nomes dos recursos dos rótulos do cliente solicitante que são aplicados ao cliente do cliente. Os nomes dos recursos de rótulos têm o seguinte formato:
|
status |
O status do cliente. Somente leitura. |
client |
O nome de recurso do cliente-cliente que está vinculado ao cliente em questão. Somente leitura. |
level |
Distância entre o cliente e o cliente. Para o autolink, o valor do nível será 0. Somente leitura. |
time |
Representação de string do Common Locale Data Repository (CLDR) do fuso horário do cliente, por exemplo, America/Los_Angeles. Somente leitura. |
test |
Identifica se o cliente é uma conta de teste. Somente leitura. |
manager |
Identifica se o cliente é um administrador. Somente leitura. |
descriptive |
Nome descritivo do cliente. Somente leitura. |
currency |
Código da moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura. |
id |
O ID do cliente cliente. Somente leitura. |
DynamicSearchAdsSearchTermView
Uma visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa.
Representação JSON |
---|
{ "resourceName": string, "landingPage": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de termos de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos de visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa têm o seguinte formato:
|
landing |
O URL da página de destino selecionada dinamicamente da impressão. Este campo é somente leitura. |
GenderView
Uma visualização de gênero. O recurso "genderView" reflete o estado de veiculação efetivo, e não os critérios que foram adicionados. Um grupo de anúncios sem critérios de gênero por padrão é veiculado para todos os gêneros, então todos os gêneros aparecem na visualização de gênero com estatísticas.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de gênero. Os nomes dos recursos da visualização de gênero têm o seguinte formato:
|
GeoTargetConstant
Uma constante de segmentação por área geográfica.
Representação JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da constante de segmentação por área geográfica. Os nomes dos recursos de constante de destino geográfico têm este formato:
|
status |
Status da constante de segmentação por área geográfica. |
id |
O ID da constante de destino geográfico. |
name |
Nome em inglês da constante de segmentação por área geográfica. |
country |
O código de país ISO-3166-1 alfa-2 associado à segmentação. |
target |
Tipo de segmentação constante da segmentação geográfica. |
canonical |
O nome em inglês completo, que consiste no nome da segmentação, da segmentação pai e do país. |
parent |
O nome do recurso da constante de segmentação por área geográfica principal. Os nomes das constantes de recursos de segmentação geográfica têm o seguinte formato:
|
GeoTargetConstantStatus
Os status possíveis de uma constante de segmentação por área geográfica.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta. |
ENABLED |
A constante de segmentação por área geográfica é válida. |
REMOVAL_PLANNED |
A constante de segmentação geográfica está obsoleta e será removida. |
KeywordView
Uma visualização de palavra-chave.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de palavra-chave. Os nomes dos recursos da visualização de palavras-chave têm o seguinte formato:
|
Rótulo
Um rótulo.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resource |
Nome do recurso. Os nomes dos recursos de rótulo têm o formato: |
status |
Status do rótulo. Somente leitura. |
text |
Um tipo de marcador que mostra texto em um plano de fundo colorido. |
id |
ID do rótulo. Somente leitura. |
name |
Nome do rótulo. Este campo é obrigatório e não deve ficar vazio ao criar um novo rótulo. Esta string conter entre 1 e 80 caracteres (valores inclusivos). |
LabelStatus
Status possíveis de um rótulo.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
O rótulo está ativado. |
REMOVED |
O rótulo foi removido. |
TextLabel
Um tipo de marcador que mostra texto em um plano de fundo colorido.
Representação JSON |
---|
{ "backgroundColor": string, "description": string } |
Campos | |
---|---|
background |
Cor de fundo do rótulo no formato HEX. Essa string precisa corresponder à expressão regular '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Observação: a cor de plano de fundo pode não estar visível para contas de administrador. |
description |
Uma breve descrição do rótulo. O comprimento não pode exceder 200 caracteres. |
LanguageConstant
Um idioma.
Representação JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Campos | |
---|---|
resource |
O nome do recurso da constante de idioma. Os nomes dos recursos de constantes de idioma têm o seguinte formato:
|
id |
O ID da constante de idioma. |
code |
O código do idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc. |
name |
O nome completo do idioma em inglês, por exemplo, "English (US)", "Spanish" etc. |
targetable |
Indica se o idioma é segmentável. |
LocationView
Uma visualização de local resume a performance das campanhas por um critério de local.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de local. Os nomes dos recursos de visualização do local têm o seguinte formato:
|
ProductBiddingCategoryConstant
Uma categoria de lances de produtos.
Representação JSON |
---|
{ "resourceName": string, "level": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da categoria de lances do produto. Os nomes dos recursos das categorias de lances de produtos têm o seguinte formato:
|
level |
Nível da categoria do lance do produto. |
status |
Status da categoria de lances do produto. |
id |
ID da categoria de lances do produto. Esse ID é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436. |
country |
Código de país com duas letras maiúsculas da categoria de lances do produto. |
product |
Nome do recurso da categoria de lances do produto principal. |
language |
Código de idioma da categoria de lances do produto. |
localized |
Valor de exibição da categoria de lances do produto localizada de acordo com o languageCode. |
ProductBiddingCategoryLevel
Enumeração que descreve o nível da categoria de lances do produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
LEVEL1 |
Nível 1. |
LEVEL2 |
Nível 2. |
LEVEL3 |
Nível 3. |
LEVEL4 |
Nível 4. |
LEVEL5 |
Nível 5. |
ProductBiddingCategoryStatus
Enumeração que descreve o status da categoria de lances do produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o 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 | |
---|---|
resource |
O nome do recurso da visualização do grupo de produtos. Os nomes dos recursos da visualização do grupo de produtos têm o seguinte formato:
|
ShoppingPerformanceView
Visualização de performance do Shopping. Fornece estatísticas agregadas das campanhas do Shopping em vários níveis de dimensão do produto. Os valores de dimensão do produto do Merchant Center, como marca, categoria, atributos personalizados, condição do produto e tipo de produto, refletem o estado de cada dimensão na data e hora em que o evento correspondente foi registrado.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de desempenho do Shopping. Os nomes dos recursos da visualização de performance de compras têm o formato: |
UserList
Uma lista de usuários. É uma lista de usuários que um cliente pode segmentar.
Representação JSON |
---|
{
"resourceName": string,
"type": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da lista de usuários. Os nomes dos recursos de lista de usuários têm o seguinte formato:
|
type |
Tipo desta lista. Este campo é somente leitura. |
id |
ID da lista de usuários. |
name |
Nome da lista de usuários. Dependendo de access_reason, o nome da lista de usuários pode não ser exclusivo (por exemplo, se access_reason=SHARED) |
UserListType
Enumeração que contém possíveis tipos de lista de usuários.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
REMARKETING |
UserList representada como uma coleção de tipos de conversão. |
LOGICAL |
Lista de usuários representada como uma combinação de outras listas/interesses de usuários. |
EXTERNAL_REMARKETING |
Lista de usuários criada na plataforma do Google Ad Manager. |
RULE_BASED |
Lista de usuários associada a uma regra. |
SIMILAR |
Lista de usuários com usuários semelhantes aos de outra lista. |
CRM_BASED |
Lista de usuários com dados próprios de CRM fornecidos pelo anunciante em forma de e-mails ou outros formatos. |
UserLocationView
Uma visualização de local do usuário.
A visualização de local do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele informa as métricas no local físico real do usuário por local segmentado ou não segmentado. Se outros campos de segmento forem usados, você poderá receber mais de uma linha por país.
Representação JSON |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
Campos | |
---|---|
resource |
O nome do recurso da visualização de local do usuário. Os nomes dos recursos da visualização "UserLocation" têm o seguinte formato:
|
country |
ID do critério do país. |
targeting |
Indica se o local foi segmentado ou não. |
WebpageView
Uma visualização de página da Web.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resource |
O nome do recurso da visualização da página da Web. Os nomes dos recursos de visualização de páginas da Web têm o seguinte formato:
|
Acesse
Uma visita.
Representação JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da visita. Os nomes dos recursos de visita têm o seguinte formato:
|
id |
O ID da visita. |
criterion |
ID de palavra-chave do Search Ads 360. Um valor de 0 indica que a palavra-chave não foi atribuída. |
merchant |
O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele. |
ad |
ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído. |
click |
Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL de ID de clique. |
visit |
O carimbo de data/hora do evento da visita. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
product |
O ID do produto clicado. |
product |
O canal de vendas do produto que foi clicado: on-line ou local. |
product |
O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto. |
product |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais. |
product |
O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado. |
asset |
ID do recurso com o qual houve interação durante o evento de visita. |
asset |
Tipo de campo do recurso do evento da visita. |
ProductChannel
Enumeração que descreve a localidade de uma oferta de produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ONLINE |
O item é vendido on-line. |
LOCAL |
O item é vendido em lojas locais. |
Conversão
Uma conversão.
Representação JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
Campos | |
---|---|
resource |
O nome do recurso da conversão. Os nomes dos recursos de conversão têm o seguinte formato:
|
id |
O ID da conversão. |
criterion |
ID do critério do Search Ads 360. Um valor de 0 indica que o critério não foi atribuído. |
merchant |
O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele. |
ad |
ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído. |
click |
Uma string única para a visita à qual a conversão é atribuída, que é transmitida para a página de destino como o parâmetro de URL do ID de clique. |
visit |
O ID de visita do Search Ads 360 a que a conversão é atribuída. |
advertiser |
Em conversões off-line, esse é um ID fornecido pelos anunciantes. Se um anunciante não especificar um ID, o Search Ads 360 vai gerar um. Em conversões on-line, ele é igual à coluna "id" ou à coluna "floodlightOrderId", dependendo das instruções do Floodlight fornecidas pelo anunciante. |
product |
O ID do produto clicado. |
product |
O canal de vendas do produto que foi clicado: on-line ou local. |
product |
O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto. |
product |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais. |
product |
O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado. |
attribution |
A que a conversão é atribuída: visita ou palavra-chave + anúncio. |
conversion |
O carimbo de data/hora do evento de conversão. |
conversion |
O carimbo de data/hora da última vez em que a conversão foi modificada. |
conversion |
O carimbo de data/hora da visita à qual a conversão é atribuída. |
conversion |
A quantidade de itens registrados pela conversão, conforme determinado pelo parâmetro "qty url". O anunciante é responsável por preencher o parâmetro de modo dinâmico (como o número de itens vendidos na conversão). Caso contrário, o padrão será 1. |
conversion |
A receita ajustada em micros para o evento de conversão. Estará sempre na moeda da conta de veiculação. |
floodlight |
A receita original e inalterada associada ao evento do Floodlight (na moeda do relatório atual), antes das modificações na instrução de moeda do Floodlight. |
floodlight |
O ID do pedido do Floodlight fornecido pelo anunciante para a conversão. |
status |
O status da conversão, que será ATIVADO ou REMOVIDO. |
asset |
ID do recurso com que houve interação durante o evento de conversão. |
asset |
Tipo de campo do recurso do evento de conversão. |
AttributionType
Tipo de atribuição de conversão no Search Ads 360
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
VISIT |
A conversão é atribuída a uma visita. |
CRITERION_AD |
A conversão é atribuída a um par de anúncios e critérios. |
ConversionStatus
Possíveis status de uma conversão.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
ENABLED |
A conversão está ativada. |
REMOVED |
A conversão foi removida. |
Métricas
Dados de métricas.
Representação JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Campos | |
---|---|
all |
Valor de todas as conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
all |
O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
conversion |
As métricas personalizadas de conversão. |
conversions |
A soma do valor das conversões que podem ser usadas para lances por data de conversão. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. |
conversions |
A soma de conversões por data de conversão para os tipos de conversão que recebem lances. Pode ser fracionário devido à modelagem de atribuição. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. |
historical |
O índice de qualidade histórico do criativo. |
historical |
A qualidade da experiência histórica na página de destino. |
historical |
A taxa de cliques (CTR) prevista da pesquisa histórica. |
interaction |
Os tipos de interação com pagamentos e sem custo. |
raw |
As métricas brutas de conversão de eventos. |
absolute |
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. |
all |
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. |
all |
Valor de todas as conversões. |
all |
O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. |
all |
O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). |
all |
O número de vezes que as pessoas clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. Essa métrica não informa se as chamadas foram atendidas nem a duração delas. Essa métrica se aplica apenas aos itens do feed. |
all |
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 apenas aos itens do feed. |
all |
O valor de todas as conversões de interações dividido pelo número total de interações. |
all |
Quantas vezes as pessoas clicaram em um link para ver o menu de uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas aos itens do feed. |
all |
Quantas vezes as pessoas fizeram um pedido em uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas aos itens do feed. |
all |
O número de outros tipos de conversão (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 apenas aos itens do feed. |
all |
Número estimado de vezes que os usuários visitaram uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas aos itens do feed. |
visits |
Os cliques que o Search Ads 360 registrou e encaminhou à página de destino de um anunciante |
all |
O número de vezes que os usuários foram direcionados ao URL de uma loja depois de clicar em um anúncio. Essa métrica se aplica apenas aos itens do feed. |
average |
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. |
average |
O custo total de todos os cliques dividido pelo número total de cliques recebidos. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average |
Custo médio por mil impressões (CPM médio). Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clicks |
O número de cliques. |
content |
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. |
content |
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. |
content |
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. |
conversions |
Conversões com lances possíveis (de interação) médias por interação qualificada. Mostra com que frequência, em média, uma interação com o anúncio leva a uma conversão que recebe lances. |
client |
O valor das conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo includeInClientAccountConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
conversions |
O valor da conversão que recebe lances dividido pelo custo total das interações qualificadas para conversão. |
conversions |
O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
client |
O número de conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo includeInClientAccountConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
cost |
A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
cost |
O custo das interações com anúncios dividido por todas as conversões. |
cost |
Custo médio de conversões qualificadas por conversão que pode ser usada em lances. |
cost |
O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
cross |
Conversões geradas quando um cliente clica em um anúncio usando um dispositivo e realiza a conversão em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em todas as conversões. |
cross |
O número de conversões em dispositivos diferentes por data. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
cross |
A soma do valor das conversões em dispositivos diferentes. |
cross |
A soma do valor das conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
ctr |
O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões). |
conversions |
O número de conversões. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
conversions |
A soma dos valores das conversões incluídas no campo "conversões". Essa métrica só será útil se você inserir um valor para suas ações de conversão. |
average |
O índice de qualidade médio. |
historical |
O índice de qualidade histórico. |
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. |
interaction |
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.). |
invalid |
A porcentagem de cliques filtrados do número total de cliques (cliques filtrados e não filtrados) durante o período do relatório. |
invalid |
Número de cliques que o Google considera ilegítimos e que não são cobrados de você. |
general |
A porcentagem de cliques que foram filtrados do número total de cliques (cliques filtrados e não filtrados) por serem inválidos. São cliques que o Google considera ilegais e que são detectados por meios de filtragem de rotina, como tráfego inválido conhecido de data centers, bots e indexadores ou outros rastreadores, padrões irregulares etc. Você não é cobrado por eles, e eles não afetam as estatísticas da sua conta. Consulte a página de ajuda em https://support.google.com/campaignmanager/answer/6076504 para mais detalhes. |
general |
Número de cliques inválidos gerais. São um subconjunto dos seus cliques inválidos detectados por meios de filtragem de rotina, como tráfego inválido conhecido de data centers, bots e indexadores ou outros rastreadores, padrões irregulares etc. Você não é cobrado por eles, e eles não afetam as estatísticas da sua conta. Consulte a página de ajuda em https://support.google.com/campaignmanager/answer/6076504 para mais detalhes. |
mobile |
A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis. |
search |
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/sa360/answer/9566729 para mais detalhes. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
search |
Número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte de cima da página 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. |
search |
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. |
search |
Número que estima a frequência com que seu anúncio não foi exibido perto dos principais resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
search |
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. |
search |
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. |
search |
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. |
search |
O número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte superior dos resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
search |
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. |
search |
Número que estima a frequência com que seu anúncio não foi exibido perto dos principais resultados da pesquisa orgânica devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
search |
As impressões que você recebeu entre os anúncios na parte de cima em comparação com o número estimado de impressões que você tinha qualificação para receber entre os anúncios nessa posição. Observação: a parcela de impressões na parte superior da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999. Esses anúncios geralmente ficam acima dos resultados orgânicos principais, embora possam aparecer abaixo desses resultados em determinadas consultas. |
top |
A porcentagem de impressões de anúncios exibidas ao lado dos principais resultados da pesquisa orgânica. |
value |
O valor de todas as conversões dividido pelo número de todas as conversões. |
value |
O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
value |
O valor da conversão que pode ser usada em lances dividido pelo número de conversões que podem ser usadas em lances. Mostra o valor médio de cada uma das conversões que podem receber lances. |
value |
Valor das conversões que podem ser veiculadas por data de conversão dividido pelas conversões que podem ser veiculadas por data de conversão. Mostra o valor médio de cada uma das conversões que podem receber lances (por data da conversão). Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. |
client |
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. |
client |
O custo dos produtos vendidos (CPV) da conta de cliente é o custo total dos itens vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos por venda cruzada é o valor total dos itens comercializados que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O custo dos produtos de venda cruzada desse pedido é de R $5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross |
O custo dos produtos vendidos (CPV) com venda cruzada é o valor total dos itens comercializados como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos por venda cruzada é o valor total dos itens comercializados que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O CPV com venda cruzada desse pedido é de R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
O lucro bruto de venda cruzada da conta do cliente é o lucro dos produtos vendidos como resultado da publicidade de um produto diferente, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído na compra é um produto vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O lucro bruto de venda cruzada é a receita gerada com a venda cruzada atribuída aos seus anúncios menos o custo dos produtos vendidos. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross |
O lucro bruto de venda cruzada é o lucro dos produtos vendidos como resultado da publicidade de um produto diferente, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído na compra é um produto vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O lucro bruto de venda cruzada é a receita gerada com a venda cruzada atribuída aos seus anúncios menos o custo dos produtos vendidos. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
A receita de venda cruzada da conta do cliente é o valor total que você ganhou com produtos vendidos como resultado da publicidade de um produto diferente. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
cross |
A receita de venda cruzada é o valor total que você ganha de produtos vendidos como resultado da publicidade de um produto diferente. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
As unidades vendidas em venda cruzada da conta do cliente são o número total de produtos vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. As unidades vendidas em venda cruzada são o número total de produtos de venda cruzada em todos os pedidos atribuídos aos anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas em venda cruzada neste pedido é 2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
cross |
As unidades vendidas em venda cruzada representam o número total de produtos vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. As unidades vendidas em venda cruzada são o número total de produtos de venda cruzada em todos os pedidos atribuídos aos anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas em venda cruzada neste pedido é 2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
client |
O custo dos produtos vendidos (CPV) de lead da conta do cliente é o custo total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead |
O custo dos produtos vendidos de lead (CPV) é o custo total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
O lucro bruto de lead da conta de cliente é o lucro dos produtos vendidos como resultado da publicidade do mesmo produto, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, a receita gerada por essas vendas menos o custo dos produtos vendidos será seu lucro bruto de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
lead |
O lucro bruto de lead é o lucro dos produtos vendidos como resultado da publicidade do mesmo produto, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, a receita gerada por essas vendas menos o custo dos produtos vendidos será seu lucro bruto de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
A receita de lead da conta de cliente é o valor total gerado com produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor total gerado com as vendas desses itens vai ser mostrado em "Receita de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead |
A receita de lead é o valor total gerado com produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor total gerado com as vendas desses itens vai ser mostrado em "Receita de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client |
As unidades vendidas de lead da conta do cliente representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas de lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
lead |
As unidades vendidas de lead representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas de lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
Valor
Um contêiner de dados genérico.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união value . um valor. value pode ser apenas de um dos tipos a seguir: |
|
boolean |
Um booleano. |
int64 |
Um int64. |
float |
Um ponto flutuante. |
double |
Um duplo. |
string |
Uma string. |
QualityScoreBucket
Enumeração que lista os possíveis buckets do Índice de qualidade.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
BELOW_AVERAGE |
A qualidade do criativo está abaixo da média. |
AVERAGE |
A qualidade do criativo é média. |
ABOVE_AVERAGE |
A qualidade do criativo está acima da média. |
InteractionEventType
Enumeração que descreve possíveis tipos de interações com pagamentos e sem custo.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o 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. Esse também é o InteractionEventType padrão para eventos de clique. |
ENGAGEMENT |
A intenção expressa do usuário de interagir com o anúncio no lugar. |
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. Isso é usado quando uma linha de conversão de anúncios NÃO indica que as interações sem custo financeiro (por exemplo, as conversões de anúncios) devem ser "promovidas" e informadas como parte das principais métricas. Trata-se simplesmente de outras conversões (de anúncios). |
Segmentos
Segmentar apenas campos.
Representação JSON |
---|
{ "adNetworkType": enum ( |
Campos | |
---|---|
ad |
Tipo de rede de publicidade. |
conversion |
Categoria de ação de conversão. |
conversion |
As dimensões personalizadas de conversão. |
day |
Dia da semana, por exemplo, SEGUNDA-FEIRA. |
device |
Dispositivo a que as métricas se aplicam. |
keyword |
Critério da palavra-chave. |
product |
Canal do produto. |
product |
Exclusividade do canal do produto. |
product |
Estado do produto. |
product |
Condição do produto vendido. |
raw |
As dimensões de conversão de eventos brutos. |
conversion |
Nome do recurso da ação de conversão. |
conversion |
Nome da ação de conversão. |
date |
Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17. |
geo |
Nome do recurso da constante de segmentação por área geográfica que representa uma cidade. |
geo |
Nome do recurso da constante de segmentação por área geográfica que representa um país. |
geo |
Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana. |
geo |
Nome do recurso da constante de segmentação por área geográfica que representa uma região. |
hour |
Hora do dia como um número entre 0 e 23. |
month |
Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd. |
product |
Categoria do lance (nível 1) do produto. |
product |
Categoria do lance (nível 2) do produto. |
product |
Categoria do lance (nível 3) do produto. |
product |
Categoria do lance (nível 4) do produto. |
product |
Categoria do lance (nível 5) do produto. |
product |
Marca do produto. |
product |
Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto. |
product |
Atributo personalizado 0 do produto. |
product |
Atributo personalizado 1 do produto. |
product |
Atributo personalizado 2 do produto. |
product |
Atributo personalizado 3 do produto. |
product |
Atributo personalizado 4 do produto. |
product |
ID do item do produto. |
product |
Nome do recurso da constante de idioma para o idioma do produto. |
product |
Categoria do lance (nível 1) do produto vendido. |
product |
Categoria do lance (nível 2) do produto vendido. |
product |
Categoria de lance (nível 3) do produto vendido. |
product |
Categoria do lance (nível 4) do produto vendido. |
product |
Categoria de lance (nível 5) do produto vendido. |
product |
Marca do produto vendido. |
product |
Atributo personalizado 0 do produto vendido. |
product |
Atributo personalizado 1 do produto vendido. |
product |
Atributo personalizado 2 do produto vendido. |
product |
Atributo personalizado 3 do produto vendido. |
product |
Atributo personalizado 4 do produto vendido. |
product |
ID do item vendido. |
product |
Título do produto vendido. |
product |
Tipo (nível 1) do produto vendido. |
product |
Tipo (nível 2) do produto vendido. |
product |
Tipo (nível 3) do produto vendido. |
product |
Tipo (nível 4) do produto vendido. |
product |
Tipo (nível 5) do produto vendido. |
product |
ID da loja do produto. |
product |
Título do produto. |
product |
Tipo (nível 1) do produto. |
product |
Tipo (nível 2) do produto. |
product |
Tipo (nível 3) do produto. |
product |
Tipo (nível 4) do produto. |
product |
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 2018-04-01. no formato aaaa-MM-dd. |
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. |
asset |
Usado apenas com as métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente. As interações (por exemplo, cliques) são contadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando elas são veiculadas em conjunto. Quando interactionOnThisAsset é verdadeiro, significa que as interações estão nesse recurso específico. Quando interactionOnThisAsset é falso, significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio veiculado com esse recurso. |
AdNetworkType
Enumera os tipos de rede do Google Ads.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nessa 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. |
Palavra-chave
Um segmento de critério de palavra-chave.
Representação JSON |
---|
{
"info": {
object ( |
Campos | |
---|---|
info |
Informações da palavra-chave. |
ad |
O nome do recurso name. |
ProductChannelExclusivity
Enumeração que descreve a disponibilidade de uma oferta de produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão. |
SINGLE_CHANNEL |
O item é vendido por um único canal, tanto em lojas locais quanto on-line, conforme indicado pelo ProductChannel. |
MULTI_CHANNEL |
O item é correspondente à versão das lojas on-line ou locais, indicando que ele está disponível para compra nos dois ShoppingProductChannels. |
ProductCondition
Enumeração que descreve a condição de uma oferta de produto.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
OLD |
O produto está velho. |
NEW |
O produto está em bom estado. |
REFURBISHED |
O produto está recondicionado. |
USED |
O estado do produto é "usado". |
AssetInteractionTarget
Um segmento de AssetInteractionTarget.
Representação JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Campos | |
---|---|
asset |
O nome do recurso do recurso. |
interaction |
Usado apenas com as métricas CustomerAsset, CampaignAsset e GroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente. |