- Representação JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Anúncio
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo.
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- Dispositivo
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo (em inglês)
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- Recurso
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset (link em inglês)
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- 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 (em inglês)
- 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
- CampaignLabel
- CartDataSalesView
- Público-alvo
- 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 (em inglês)
- TargetSpend
- CustomerManagerLink (em inglês)
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- Rótulo
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- Acesse
- ProductChannel
- Conversão
- 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 | |
---|---|
adGroup |
Grupo de anúncios referenciado na consulta. |
adGroupAd |
O anúncio mencionado na consulta. |
adGroupAdLabel |
O rótulo do anúncio do grupo de anúncios mencionado na consulta. |
adGroupAsset |
O recurso do grupo de anúncios mencionado na consulta. |
adGroupAssetSet |
O conjunto de recursos do grupo de anúncios mencionado na consulta. |
adGroupAudienceView |
A visualização do público-alvo do grupo de anúncios mencionada na consulta. |
adGroupBidModifier |
O modificador de lance mencionado na consulta. |
adGroupCriterion |
O critério indicado na consulta. |
adGroupCriterionLabel |
O rótulo do critério do grupo de anúncios mencionado na consulta. |
adGroupLabel |
O rótulo do grupo de anúncios mencionado na consulta. |
ageRangeView |
A visualização de faixa etária referenciada na consulta. |
asset |
O recurso referenciado na consulta. |
assetGroupAsset |
O recurso do grupo de recursos referenciado na consulta. |
assetGroupSignal |
O indicador do grupo de recursos referenciado na consulta. |
assetGroupListingGroupFilter |
O filtro do grupo de produtos anunciados do grupo de recursos mencionado na consulta. |
assetGroupTopCombinationView |
A visualização de combinação superior do grupo de recursos mencionada na consulta. |
assetGroup |
O grupo de recursos referenciado na consulta. |
assetSetAsset |
O recurso do conjunto de recursos referenciado na consulta. |
assetSet |
O conjunto de recursos referenciado na consulta. |
biddingStrategy |
Estratégia de lances mencionada na consulta. |
campaignBudget |
Orçamento da campanha mencionado na consulta. |
campaign |
A campanha mencionada na consulta. |
campaignAsset |
O recurso da campanha mencionado na consulta. |
campaignAssetSet |
O conjunto de recursos da campanha referenciado na consulta. |
campaignAudienceView |
A visualização do público-alvo da campanha mencionada na consulta. |
campaignCriterion |
O critério de campanha indicado na consulta. |
campaignLabel |
O rótulo da campanha mencionado na consulta. |
cartDataSalesView |
Visualização de vendas de dados do carrinho mencionada na consulta. |
audience |
O público-alvo mencionado na consulta. |
conversionAction |
Ação de conversão mencionada na consulta. |
conversionCustomVariable |
A variável personalizada de conversão referenciada na consulta. |
customer |
O cliente mencionado na consulta. |
customerAsset |
O recurso do cliente mencionado na consulta. |
customerAssetSet |
O conjunto de recursos do cliente mencionado na consulta. |
accessibleBiddingStrategy |
A estratégia de lances acessível mencionada na consulta. |
customerManagerLink |
O CustomerManagerLink mencionado na consulta. |
customerClient |
O CustomerClient mencionado na consulta. |
dynamicSearchAdsSearchTermView |
Visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa mencionada na consulta. |
genderView |
A visualização de gênero referenciada na consulta. |
geoTargetConstant |
A constante de segmentação geográfica referenciada na consulta. |
keywordView |
Visualização de palavra-chave referenciada na consulta. |
label |
O rótulo referenciado na consulta. |
languageConstant |
A constante de linguagem referenciada na consulta. |
locationView |
A visualização do local referenciada na consulta. |
productBiddingCategoryConstant |
A categoria de lances do produto mencionada na consulta. |
productGroupView |
A visualização do grupo de produtos referenciada na consulta. |
shoppingPerformanceView |
A visualização de desempenho de compras referenciada na consulta. |
userList |
A lista de usuários referenciada na consulta. |
webpageView |
A visualização da página da Web mencionada 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. |
customColumns[] |
Colunas personalizadas |
AdGroup
Um grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do grupo de anúncios. Os nomes dos 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. |
adRotationMode |
Modo de rotação de anúncios do grupo de anúncios. |
creationTime |
O carimbo de data/hora em que o adGroup foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". |
targetingSetting |
Configuração para recursos relacionados à segmentação. |
labels[] |
Os nomes de recursos dos rótulos anexados a este grupo de anúncios. |
engineId |
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 entidades do Google Ads, use "adGroup.id". |
startDate |
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 |
endDate |
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 |
languageCode |
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 |
lastModifiedTime |
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). |
cpcBidMicros |
É o lance máximo de CPC (custo por clique). |
engineStatus |
O status do mecanismo para o grupo de anúncios. |
AdGroupStatus
Os status possíveis de um grupo de anúncios.
Tipos enumerados | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas 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
Enumeração que lista os tipos possíveis de um grupo de anúncios.
Tipos enumerados | |
---|---|
UNSPECIFIED |
O tipo não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
SEARCH_STANDARD |
É o tipo de grupo de anúncios padrão para campanhas de pesquisa. |
DISPLAY_STANDARD |
É o tipo padrão de grupo de anúncios para campanhas de display. |
SHOPPING_PRODUCT_ADS |
O tipo de grupo de anúncios para as campanhas do Shopping que veiculam anúncios de produto padrão. |
SHOPPING_SHOWCASE_ADS |
O tipo de grupos de anúncios que só podem veicular anúncios de demonstração ou do comerciante nos resultados do Shopping. |
HOTEL_ADS |
É o tipo padrão de grupo de anúncios para campanhas de hotel. |
SHOPPING_SMART_ADS |
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 in-stream TrueView (puláveis). |
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 comparadores do Shopping. |
PROMOTED_HOTEL_ADS |
Tipo de grupo de anúncios para os 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 para vídeos. |
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 de anúncios.
Tipos enumerados | |
---|---|
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 apenas de resposta. |
OPTIMIZE |
Otimize os anúncios do grupo de anúncios com base em cliques ou conversões. |
ROTATE_FOREVER |
Alternar uniformemente para sempre. |
AdGroupEngineStatus
Status do mecanismo do grupo de anúncios.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 exibido para esse grupo de anúncios porque o grupo de anúncios associado ainda está em formato de 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 exibido para esse grupo de anúncios porque a campanha foi pausada. |
ACCOUNT_PAUSED |
Nenhum anúncio está sendo exibido para esse grupo de anúncios 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 | |
---|---|
targetRestrictions[] |
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 | |
---|---|
targetingDimension |
A dimensão de segmentação a que essas configurações se aplicam. |
bidOnly |
Indica se os anúncios devem ser restritos apenas para os critérios que você selecionou para essa segmentaçãoDimension ou todos os valores para essa segmentaçãoDimension e mostrar anúncios com base na sua segmentação em outras TargetingDimensões. Um valor de |
TargetingDimension
Enumeração que descreve possíveis dimensões de segmentação.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
KEYWORD |
Critérios de palavra-chave, por exemplo, "cruzeiro em Marte". KEYWORD pode ser usada como uma dimensão de lance personalizada. Palavras-chave são sempre uma dimensão de segmentação. Por isso, não é possível definir como uma dimensão "ALL" de destino com a TargetRestriction. |
AUDIENCE |
Critérios de público-alvo, que incluem lista de usuários, interesse do usuário, afinidade personalizada e personalização no mercado. |
TOPIC |
Critérios de tópicos para segmentação de categorias de conteúdo, por exemplo, "category::Animais>Animais de estimação" usado para segmentação de display e vídeo. |
GENDER |
Critérios para a segmentação de sexo. |
AGE_RANGE |
Critérios para segmentar faixas etárias. |
PLACEMENT |
Critérios de posicionamento, que incluem websites como "www.flowers4sale.com", bem como aplicativos para dispositivos móveis, categorias de aplicativos para dispositivos móveis, vídeos e canais do YouTube. |
PARENTAL_STATUS |
Critérios para a segmentação do status parental. |
INCOME_RANGE |
Critérios para a segmentação por faixa de renda. |
AdGroupAd
Um anúncio do grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
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. |
creationTime |
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. |
engineId |
É o ID do anúncio na conta de mecanismo externo. Este 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". |
engineStatus |
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. |
lastModifiedTime |
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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas 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 | |
---|---|
resourceName |
O nome do recurso do anúncio. Os nomes dos recursos de anúncios têm o seguinte formato:
|
finalUrls[] |
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. |
displayUrl |
É 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. Exatamente um valor deve ser definido. ad_data só pode ser de um dos seguintes tipos: |
|
textAd |
Detalhes relacionados a um anúncio de texto. |
expandedTextAd |
Detalhes relacionados a um anúncio de texto expandido |
responsiveSearchAd |
Detalhes relacionados a um anúncio responsivo de pesquisa |
productAd |
Detalhes relacionados a um anúncio de produto. |
expandedDynamicSearchAd |
Detalhes relacionados a um anúncio dinâmico expandido de pesquisa |
AdType
Os tipos possíveis de um anúncio.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
TEXT_AD |
Esse é um anúncio de texto. |
EXPANDED_TEXT_AD |
Este é um anúncio de texto expandido. |
CALL_ONLY_AD |
É um anúncio só para chamadas. |
EXPANDED_DYNAMIC_SEARCH_AD |
É um anúncio dinâmico expandido de pesquisa. |
HOTEL_AD |
O anúncio é de hotel. |
SHOPPING_SMART_AD |
Esse é um anúncio inteligente do Shopping. |
SHOPPING_PRODUCT_AD |
Este é um anúncio padrão do Shopping. |
VIDEO_AD |
Este é um anúncio em vídeo. |
GMAIL_AD |
Este é um anúncio do Gmail. |
IMAGE_AD |
Este é um anúncio gráfico. |
RESPONSIVE_SEARCH_AD |
Este é um anúncio responsivo de pesquisa. |
LEGACY_RESPONSIVE_DISPLAY_AD |
É um anúncio responsivo de display legado. |
APP_AD |
Esse é um anúncio de app. |
LEGACY_APP_INSTALL_AD |
Trata-se de um anúncio legado de instalação de apps. |
RESPONSIVE_DISPLAY_AD |
Esse é um anúncio responsivo de display. |
LOCAL_AD |
Este é um anúncio local. |
HTML5_UPLOAD_AD |
Este é um anúncio de upload de display com o tipo de produto HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
Este é um anúncio gráfico de upload com um dos tipos de produto DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
Trata-se de um anúncio de engajamento no app. |
SHOPPING_COMPARISON_LISTING_AD |
Este é um anúncio de comparadores do Shopping. |
VIDEO_BUMPER_AD |
Anúncio bumper em vídeo. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Anúncio em vídeo in-stream não pulável. |
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 TrueView in-stream em vídeo. |
VIDEO_RESPONSIVE_AD |
Anúncio responsivo em vídeo. |
SMART_CAMPAIGN_AD |
Anúncio da campanha inteligente. |
APP_PRE_REGISTRATION_AD |
É o anúncio universal de pré-registro do app. |
DISCOVERY_MULTI_ASSET_AD |
Anúncio Discovery com vários recursos. |
DISCOVERY_CAROUSEL_AD |
Anúncio Discovery de carrossel. |
TRAVEL_AD |
Anúncio de viagens. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Anúncio Discovery em vídeo. |
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 |
Título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
displayUrl |
O URL exibido do anúncio. |
displayMobileUrl |
O URL para dispositivos móveis do anúncio exibido. |
adTrackingId |
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 |
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. |
adTrackingId |
O ID de acompanhamento do anúncio. |
SearchAds360ResponsiveSearchAdInfo
Um anúncio responsivo de pesquisa do Search Ads 360.
Representação JSON |
---|
{ "path1": string, "path2": string, "adTrackingId": string } |
Campos | |
---|---|
path1 |
Texto anexado ao URL visível gerado automaticamente com um delimitador. |
path2 |
Texto anexado a "path1" com um delimitador. |
adTrackingId |
O ID de acompanhamento do anúncio. |
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. |
adTrackingId |
O ID de acompanhamento do anúncio. |
AdGroupAdEngineStatus
Enumera os status do mecanismo do adgroupAd.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
Usado apenas para 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: URL para dispositivos móveis em processo de revisão. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: o criativo é inválido em um dispositivo móvel, 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: criativo não revisado. |
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 |
A revisão do criativo está pendente. |
AD_GROUP_AD_UNDER_REVIEW |
O criativo está em revisão. |
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 também. |
AD_GROUP_AD_AD_GROUP_PAUSED |
O criativo foi pausado porque o grupo de anúncios também está. |
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 } |
Campos | |
---|---|
resourceName |
Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo de anúncio do grupo de anúncios têm o seguinte formato: |
adGroupAd |
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. |
AdGroupAsset
Um vínculo entre um grupo de anúncios e um recurso.
Representação JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do grupo de anúncios. Os nomes dos recursos do grupo de anúncios têm o seguinte formato:
|
adGroup |
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.
Tipos enumerados | |
---|---|
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 grupo de anúncios do grupo de anúncios é o vínculo entre um grupo de anúncios e um conjunto de recursos. A criação de um adgroupAssetSet vincula um conjunto de recursos a um grupo de anúncios.
Representação JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
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:
|
adGroup |
O grupo de anúncios ao qual esse conjunto de recursos está vinculado. |
assetSet |
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 status possíveis do vínculo entre o conjunto de recursos e o contêiner dele.
Tipos enumerados | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
O vínculo entre o conjunto de recursos e o contêiner está ativado. |
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 desempenho dos interesses e das listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios da rede de pesquisa (RLSA), agregados no nível do público-alvo.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização do público-alvo do grupo de anúncios. Os nomes dos recursos de visualização de público-alvo do grupo de anúncios têm o seguinte formato:
|
AdGroupBidModifier
Representa um modificador de lance de grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Campos | |
---|---|
resourceName |
O nome do recurso do modificador de lance do grupo de anúncios. Os nomes dos recursos dos modificadores de lances do grupo de anúncios têm o seguinte formato:
|
bidModifier |
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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta 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 de grupo de anúncios. O relatório adGroupcriterio retorna somente critérios que foram explicitamente adicionados ao grupo de anúncios.
Representação JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campos | |
---|---|
resourceName |
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:
|
creationTime |
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. |
qualityInfo |
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. |
positionEstimates |
Estimativas para lances de critério em várias posições. |
finalUrls[] |
A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio. |
engineId |
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 entidades do Google Ads, use "adGroupCriteria.criterion_id". |
lastModifiedTime |
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". |
criterionId |
ID do critério. |
adGroup |
O grupo de anúncios ao qual o critério pertence. |
negative |
Define 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. |
bidModifier |
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. |
cpcBidMicros |
Lance de CPC (custo por clique). |
effectiveCpcBidMicros |
O lance de CPC (custo por clique) efetivo. |
engineStatus |
O status do mecanismo para o critério do grupo de anúncios. |
finalUrlSuffix |
Modelo de URL para anexar parâmetros ao URL final. |
trackingUrlTemplate |
O modelo de URL para criar um URL de rastreamento. |
Campo de união Exatamente um deve ser definido. |
|
keyword |
Palavra-chave. |
listingGroup |
Grupo de fichas. |
ageRange |
Faixa etária. |
gender |
Sexo. |
userList |
Lista de usuários. |
webpage |
Página da Web |
location |
Local. |
AdGroupCriterionStatus
Os status possíveis de um ficam.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
O critério do grupo de anúncios está ativado. |
PAUSED |
O critério do grupo de anúncios foi pausado. |
REMOVED |
O critério do grupo de anúncios foi removido. |
QualityInfo
Um contêiner para as informações de qualidade do critério do grupo de anúncios.
Representação JSON |
---|
{ "qualityScore": integer } |
Campos | |
---|---|
qualityScore |
Í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ério.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
KEYWORD |
A palavra-chave, por exemplo, "cruzeiro em Marte". |
PLACEMENT |
O canal, também conhecido como website, por exemplo, "www.flores4vendas.com.br" |
MOBILE_APP_CATEGORY |
Categorias de aplicativos para dispositivos móveis a serem segmentadas. |
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 para segmentar. |
AD_SCHEDULE |
Programação de anúncios. |
AGE_RANGE |
Faixa etária. |
GENDER |
Sexo. |
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 da listagem a ser segmentado. |
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 está interessado. |
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 aplicativo. |
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 |
LOCAL_SERVICE_ID |
ID de serviço dos anúncios dos Serviços Locais. |
BRAND |
Marca |
BRAND_LIST |
Lista de marcas |
LIFE_EVENT |
Evento importante |
PositionEstimates
Estimativas para lances de critério em várias posições.
Representação JSON |
---|
{ "topOfPageCpcMicros": string } |
Campos | |
---|---|
topOfPageCpcMicros |
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 ficam.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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: lance ou qualidade muito baixos para serem exibidos. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: lance ou qualidade muito baixos para dispositivos móveis, mas qualificados para exibição em computadores. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: lance ou qualidade muito baixos para computadores, mas qualificados para exibição em dispositivos móveis. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: lance ou qualidade muito baixos para serem exibidos. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: pausado pelo Baidu devido ao baixo volume de pesquisas. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: URL para dispositivos móveis em processo de revisão. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: a página de destino de um dispositivo é inválida, enquanto a de outro é válida. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: a palavra-chave foi criada e pausada pelo gerenciamento de contas do Baidu e agora está pronta para ser ativada. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: em processo de revisão 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 : análise de critério pendente |
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 desde que a conta foi pausada. |
KeywordInfo
Um critério de palavra-chave.
Representação JSON |
---|
{
"matchType": enum ( |
Campos | |
---|---|
matchType |
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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 fichas.
Representação JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo do grupo de produtos anunciados. |
ListingGroupType
O tipo do grupo de fichas.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SUBDIVISION |
Subdivisão de produtos com algumas dimensões de listagem. Esses nós não são usados para veiculação em entradas da listagem, mas servem apenas para definir a estrutura da árvore. |
UNIT |
Unidade do grupo de produtos anunciados 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).
Tipos enumerados | |
---|---|
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 de idade. |
AGE_RANGE_55_64 |
Entre 55 e 64 anos. |
AGE_RANGE_65_UP |
acima de 65 anos. |
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
Tipo de gênero demográfico (por exemplo, feminino).
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
MALE |
Macho. |
FEMALE |
Fêmea. |
UNDETERMINED |
Gênero indeterminado. |
UserListInfo
Um critério da lista de usuários. Representa uma lista de usuários definida pelo anunciante a ser segmentada.
Representação JSON |
---|
{ "userList": string } |
Campos | |
---|---|
userList |
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. |
coveragePercentage |
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. |
criterionName |
O nome do critério definido por este parâmetro. O valor de nome é 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 segmentar páginas da Web do site de um anunciante.
Representação JSON |
---|
{ "operand": enum ( |
Campos | |
---|---|
operand |
Operando da condição de segmentação da página da Web. |
operator |
Operador da condição de segmentação da página da Web. |
argument |
Argumento da condição de segmentação da página da Web. |
WebpageConditionOperand
O operando da condição da página da Web no critério da página da Web.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
URL |
Operand que indica uma condição de segmentação do URL da página da Web. |
CATEGORY |
Operand que indica uma condição de segmentação por categoria de página da Web. |
PAGE_TITLE |
Operand que indica uma condição de segmentação do título da página da Web. |
PAGE_CONTENT |
Operand que indica uma condição de segmentação por conteúdo da página da Web. |
CUSTOM_LABEL |
Operand que indica uma condição de segmentação de rótulo personalizado da página da Web. |
WebpageConditionOperator
O operador da condição da página da Web no critério da página da Web.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
EQUALS |
O argumento condição da Web é igual à condição da Web comparada. |
CONTAINS |
O argumento condição web faz parte da condição web comparada. |
LocationInfo
Um critério de local.
Representação JSON |
---|
{ "geoTargetConstant": string } |
Campos | |
---|---|
geoTargetConstant |
O nome do recurso constante de destino geográfico. |
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 } |
Campos | |
---|---|
resourceName |
Nome do recurso do rótulo do critério do grupo de anúncios. Os nomes dos recursos do rótulo de critério do grupo de anúncios têm o seguinte formato: |
adGroupCriterion |
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. |
AdGroupLabel
Uma relação entre um grupo de anúncios e um rótulo.
Representação JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
Campos | |
---|---|
resourceName |
Nome do recurso do rótulo do grupo de anúncios. Os nomes dos recursos de rótulos do grupo de anúncios têm o seguinte formato: |
adGroup |
O grupo de anúncios ao qual o rótulo está anexado. |
label |
Rótulo atribuído ao grupo de anúncios. |
AgeRangeView
Uma visualização por faixa etária.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização por faixa etária. Os nomes dos recursos de visualização de faixa etária têm o seguinte formato:
|
Recurso
O recurso é uma parte de um anúncio que pode ser compartilhado entre vários anúncios. Ele 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 utiliza.
Representação JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso. Os nomes dos recursos de recursos têm a seguinte forma:
|
type |
Tipo do recurso. |
finalUrls[] |
Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. |
status |
O status do recurso. |
creationTime |
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". |
lastModifiedTime |
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. |
trackingUrlTemplate |
Modelo de URL para criar um URL de rastreamento. |
engineStatus |
O status do mecanismo de um recurso. |
Campo de união asset_data . O tipo específico do recurso. asset_data só pode ser de um dos seguintes tipos: |
|
youtubeVideoAsset |
Um recurso de vídeo do YouTube. |
imageAsset |
Um recurso de imagem. |
textAsset |
Um recurso de texto. |
calloutAsset |
Um recurso de frase de destaque unificado. |
sitelinkAsset |
Um recurso de sitelink unificado. |
pageFeedAsset |
Um recurso de feed de páginas unificado. |
mobileAppAsset |
Um recurso de link para app para dispositivos móveis. |
callAsset |
Um recurso de ligação unificado. |
callToActionAsset |
Um recurso de call-to-action. |
locationAsset |
Um recurso de local unificado. |
AssetType
Enumeração que descreve possíveis tipos de ativos.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 do 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 |
do Dynamic Education. |
MOBILE_APP |
Recurso de link para 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âmicos. |
DYNAMIC_FLIGHTS |
Recurso de voos dinâmicos. |
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 vagas dinâmicas. |
LOCATION |
Recurso de local. |
HOTEL_PROPERTY |
Recurso de propriedade do hotel. |
AssetStatus
Os status possíveis de um recurso.
Tipos enumerados | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
O recurso está ativado. |
REMOVED |
O recurso foi removido. |
ARCHIVED |
O recurso está arquivado. |
PENDING_SYSTEM_GENERATED |
O recurso é gerado pelo sistema e está aguardando a avaliação do usuário. |
AssetEngineStatus
Próximo ID = 11
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SERVING |
O recurso está ativo. |
SERVING_LIMITED |
O recurso está com o status limitado ativo. |
DISAPPROVED |
O recurso é 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 | |
---|---|
youtubeVideoTitle |
Título do vídeo do YouTube. |
youtubeVideoId |
ID do vídeo do YouTube. Este é um 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 | |
---|---|
mimeType |
Tipo MIME do recurso de imagem. |
fullSize |
Metadados desta imagem no tamanho original. |
fileSize |
Tamanho do arquivo do recurso de imagem em bytes. |
MimeType
O tipo MIME
Tipos enumerados | |
---|---|
UNSPECIFIED |
O tipo MIME não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
IMAGE_JPEG |
Tipo MIME de imagem/jpeg. |
IMAGE_GIF |
Tipo MIME de imagem/gif. |
IMAGE_PNG |
Tipo MIME de imagem/png. |
FLASH |
Tipo MIME de aplicativo/x-shockwave-flash. |
TEXT_HTML |
Tipo MIME de texto/html. |
PDF |
Tipo MIME de aplicativo/pdf. |
MSWORD |
Tipo MIME de aplicativo/msword. |
MSEXCEL |
Tipo MIME de application/vnd.ms-excel. |
RTF |
Tipo MIME de aplicativo/rtf. |
AUDIO_WAV |
Tipo MIME de áudio/wav. |
AUDIO_MP3 |
Tipo MIME de áudio/mp3. |
HTML5_AD_ZIP |
Tipo MIME de application/x-html5-ad-zip. |
ImageDimension
Metadados de uma imagem em determinado tamanho, original ou redimensionado.
Representação JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Campos | |
---|---|
heightPixels |
É a altura da imagem. |
widthPixels |
É 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 do recurso de texto. |
UnifiedCalloutAsset
Um recurso de frase de destaque unificado.
Representação JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
calloutText |
O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
useSearcherTimeZone |
Define se o recurso será exibido no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
AdScheduleInfo
Representa um critério de AdSchedule.
O AdSchedule é especificado como o dia da semana e um intervalo de tempo em que os anúncios são mostrados.
Não é possível adicionar mais de seis AdSchedules para o mesmo dia.
Representação JSON |
---|
{ "startMinute": enum ( |
Campos | |
---|---|
startMinute |
Minutos após o horário de início da programação. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
endMinute |
Minutos após a hora de término em que esta programação termina. A programação exclui os minutos de término. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
dayOfWeek |
Dia da semana ao qual se aplica a programação. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
startHour |
Hora de início no formato de 24 horas. Este campo deve estar entre 0 e 23 (valores inclusivos). Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
endHour |
Hora de término no formato 24 horas. 24 significa o fim do dia. Este campo deve estar entre 0 e 24 (valores inclusivos). Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
MinuteOfHour
Enumerados de quartos de horas. Por exemplo, "FIFTEEN"
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta 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".
Tipos enumerados | |
---|---|
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 |
na 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 | |
---|---|
linkText |
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. |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
trackingId |
Código usado para rastrear cliques do recurso de sitelink. Esta é uma conta do Yahoo! Japan. |
useSearcherTimeZone |
Indica se o recurso de sitelink será exibido no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
mobilePreferred |
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 | |
---|---|
pageUrl |
A página da Web que os anunciantes querem segmentar. |
labels[] |
Rótulos usados para agrupar os URLs da página. |
MobileAppAsset
Um recurso que representa um app para dispositivos móveis.
Representação JSON |
---|
{
"appId": string,
"appStore": enum ( |
Campos | |
---|---|
appId |
Obrigatório. Uma string que identifica exclusivamente um aplicativo para dispositivos móveis. Ele deve conter apenas o ID nativo da plataforma, como "com.android.ebay" para Android ou "12345689" para iOS. |
appStore |
Obrigatório. A loja de aplicativos que distribui o aplicativo específico. |
MobileAppVendor
O tipo de fornecedor de app para dispositivos móveis
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
APPLE_APP_STORE |
Fornecedor de aplicativo para dispositivos móveis da Apple App Store. |
GOOGLE_APP_STORE |
Fornecedor de aplicativo para dispositivos móveis da Google App Store. |
UnifiedCallAsset
Um recurso de ligação unificado.
Representação JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Campos | |
---|---|
countryCode |
Código do país de duas letras do número de telefone. Exemplos: "BR", "us". |
phoneNumber |
O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890" |
callConversionReportingState |
Indica se esse CallAsset deve usar uma configuração própria de conversão de chamada, seguir a configuração no nível da conta ou desativar a conversão de chamada. |
callConversionAction |
A ação de conversão à qual atribuir uma conversão de chamada. Se deixada sem definição, a ação de conversão padrão vai ser usada. Esse campo só terá efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
callOnly |
Indica se a chamada mostra apenas o número de telefone sem um link para o site. Válido para o Microsoft Ads. |
callTrackingEnabled |
Indica se a chamada deve ser ativada no acompanhamento de chamadas. Válido para o Microsoft Ads. |
useSearcherTimeZone |
Define se a extensão de chamada será exibida no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
CallConversionReportingState
Possíveis tipos de dados para um estado de ação de conversão de chamada.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 vai 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 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 | |
---|---|
callToAction |
Call-to-action |
CallToActionType
Enumeração que descreve os possíveis tipos de call-to-action.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 é "Receber cotação". |
APPLY_NOW |
O tipo de call-to-action foi aplicado agora. |
SIGN_UP |
O tipo de call-to-action é "Inscreva-se". |
CONTACT_US |
O tipo de call-to-action é "Entre em contato". |
SUBSCRIBE |
O tipo de call-to-action é "Inscreva-se". |
DOWNLOAD |
O tipo de call-to-action é 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 é "Reproduzir agora". |
SEE_MORE |
O tipo de call-to-action é "Saiba mais". |
START_NOW |
O tipo de call-to-action está "Começar agora". |
VISIT_SITE |
O tipo de call-to-action é "Acesse 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 | |
---|---|
placeId |
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. |
businessProfileLocations[] |
A lista de locais da empresa do cliente. Isso só será retornado se o recurso de local estiver sendo sincronizado da conta do Perfil da Empresa. É possível ter várias fichas de empresas do Perfil da Empresa na mesma conta que apontam para o mesmo ID de lugar. |
locationOwnershipType |
O tipo de propriedade de local. Se o tipo for BUSINESS_OWNER, ele será exibido como uma extensão de local. Se o tipo for AFILIADO, ele será exibido como um local de afiliado. |
BusinessProfileLocation
Os dados de local do Perfil da Empresa foram sincronizados da conta vinculada do Perfil da Empresa.
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 na conta do Perfil da Empresa. |
storeCode |
É o código da loja do Perfil da Empresa desse local. Isso é sincronizado na conta do Perfil da Empresa. |
listingId |
ID da ficha desse local do Perfil da Empresa. Isso é sincronizado na conta vinculada do Perfil da Empresa. |
LocationOwnershipType
Possíveis tipos de propriedade de local.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 de afiliado(extensão de local de terceiros – ALE). |
AssetGroupAsset
AssetGroupAsset é o vínculo entre um recurso e um grupo. Adicionar um AssetGroupAsset vincula um recurso a um grupo.
Representação JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do grupo de recursos. O nome do recurso do grupo de recursos tem o seguinte formato:
|
assetGroup |
O grupo de recursos a que este recurso do grupo está vinculando. |
asset |
O recurso que este recurso do grupo de recursos está vinculando. |
fieldType |
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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
HEADLINE |
O recurso está vinculado para ser usado como título. |
DESCRIPTION |
O recurso é vinculado para ser usado como uma descrição. |
MANDATORY_AD_TEXT |
O recurso está vinculado para ser usado como texto de anúncio obrigatório. |
MARKETING_IMAGE |
O recurso está vinculado para ser usado como imagem de marketing. |
MEDIA_BUNDLE |
O recurso está vinculado para ser usado como um pacote de mídia. |
YOUTUBE_VIDEO |
O recurso está vinculado para ser usado como vídeo do YouTube. |
BOOK_ON_GOOGLE |
O recurso está vinculado para indicar que a opção "Reservas no Google" está ativada em uma campanha de hotel. |
LEAD_FORM |
O recurso está vinculado para ser usado 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 ser usado como uma extensão de frase de destaque. |
STRUCTURED_SNIPPET |
O recurso está vinculado para ser usado como uma extensão de snippets estruturados. |
SITELINK |
O recurso está vinculado para ser usado como sitelink. |
MOBILE_APP |
O recurso é vinculado para ser usado como uma extensão de aplicativo para dispositivos móveis. |
HOTEL_CALLOUT |
O recurso está vinculado para ser usado como uma extensão de frase de destaque de hotel. |
CALL |
O recurso é vinculado para ser usado como uma extensão de chamada. |
PRICE |
O recurso está vinculado para ser usado como extensão de preço. |
LONG_HEADLINE |
O recurso está vinculado para ser usado como título longo. |
BUSINESS_NAME |
O recurso está vinculado para ser usado como um nome de empresa. |
SQUARE_MARKETING_IMAGE |
O recurso está vinculado para ser usado como uma imagem de marketing quadrada. |
PORTRAIT_MARKETING_IMAGE |
O recurso está vinculado para ser usado como uma imagem de marketing em modo retrato. |
LOGO |
O recurso está vinculado para ser usado como logotipo. |
LANDSCAPE_LOGO |
O recurso está vinculado para ser usado como um logotipo em modo paisagem. |
VIDEO |
O recurso está vinculado para ser usado como um logotipo de terceiros. |
CALL_TO_ACTION_SELECTION |
O recurso está vinculado para selecionar uma call-to-action. |
AD_IMAGE |
O recurso é vinculado para que seja usado para selecionar uma imagem de anúncio. |
BUSINESS_LOGO |
O recurso está vinculado para ser usado como logo da empresa. |
HOTEL_PROPERTY |
O recurso está vinculado para ser usado como uma propriedade de hotel em uma campanha Performance Max para metas de turismo. |
DISCOVERY_CAROUSEL_CARD |
O recurso está vinculado para ser usado como um card do Discovery de carrossel. |
AssetGroupSignal
AssetGroupSignal representa um indicador em um grupo de recursos. A existência de um indicador informa à campanha Performance Max quem tem maior probabilidade de conversão. A campanha Performance Max usa o indicador para procurar novas 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 | |
---|---|
resourceName |
O nome do recurso do indicador do grupo de recursos. O nome do recurso do indicador do grupo de recursos tem o seguinte formato:
|
assetGroup |
O grupo de recursos a que esse indicador de grupo pertence. |
Campo de união signal . O indicador do grupo de recursos. signal só pode ser de um dos seguintes tipos: |
|
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 | |
---|---|
resourceName |
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:
|
assetGroup |
O grupo de recursos de que esse filtro do grupo de produtos anunciados do grupo de recursos faz parte. |
id |
O ID do ListingGroupFilter. |
type |
Tipo de um nó de filtro do grupo de fichas. |
vertical |
A vertical que a árvore de nós atual representa. Todos os nós da mesma árvore precisam pertencer à mesma indústria. |
caseValue |
É o valor de dimensão com que esse grupo de fichas está refinando o principal. Indefinido para o grupo raiz. |
parentListingGroupFilter |
Nome do recurso da subdivisão do grupo de fichas da empresa pai. Nulo para o nó de filtro do grupo de fichas da raiz. |
path |
O caminho das dimensões que definem o filtro do grupo de fichas. |
ListingGroupFilterType
Tipo de filtro do grupo de fichas.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SUBDIVISION |
Subdivisão de produtos com algumas dimensões de listagem. |
UNIT_INCLUDED |
Um nó de folha de filtro do grupo de fichas da empresa incluído. |
UNIT_EXCLUDED |
Um nó de folha de filtro do grupo de fichas excluído. |
ListingGroupFilterVertical
O tipo da indústria de filtros do grupo de fichas.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SHOPPING |
Representa a indústria de compras. Essa indústria só é permitida em campanhas Performance Max para varejo. |
ListingGroupFilterDimension
Dimensões da ficha 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 só pode ser de um dos seguintes tipos: |
|
productBiddingCategory |
Categoria de lances de uma oferta de produto. |
productBrand |
Marca de uma oferta de produto. |
productChannel |
Localidade de uma oferta de produto. |
productCondition |
Condição de uma oferta de produto. |
productCustomAttribute |
Atributo personalizado de uma oferta de produto. |
productItemId |
Código do item de uma oferta de produto. |
productType |
Tipo de uma 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 lances 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 de lances de filtro do grupo de fichas.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
NEW |
A condição do produto é nova. |
REFURBISHED |
O estado do produto é recondicionado. |
USED |
A condição do produto é usada. |
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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
INDEX0 |
Atributo personalizado do filtro do primeiro grupo de fichas. |
INDEX1 |
Segundo atributo personalizado de filtro do grupo de fichas. |
INDEX2 |
Terceiro atributo personalizado de filtro do grupo de fichas. |
INDEX3 |
Quarto atributo personalizado de filtro do grupo de fichas. |
INDEX4 |
Quinto atributo personalizado do filtro do grupo de fichas. |
ProductItemId
Código do item de uma oferta de produto.
Representação JSON |
---|
{ "value": string } |
Campos | |
---|---|
value |
Valor do ID. |
ProductType
Tipo de uma oferta de produto.
Representação JSON |
---|
{
"level": enum ( |
Campos | |
---|---|
level |
Nível do tipo. |
value |
Valor do tipo. |
ListingGroupFilterProductTypeLevel
Enumeração que descreve o nível do tipo de uma oferta de produto.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 que define as dimensões que definem um filtro do grupo de fichas.
Representação JSON |
---|
{
"dimensions": [
{
object ( |
Campos | |
---|---|
dimensions[] |
O caminho completo das dimensões na hierarquia de filtros do grupo de fichas (excluindo o nó raiz) para este filtro do grupo de fichas. |
AssetGroupTopCombinationView
Uma visualização sobre o uso da combinação de recursos de anúncio do grupo de anúncios.
Representação JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização de combinação superior do grupo de recursos. Os nomes dos recursos da visualização de principais combinações de recursos têm o seguinte formato: `"customers/{customerId}/assetGroupTopCombineViews/{asset_group_id}~{asset_adjust_category}" |
assetGroupTopCombinations[] |
As principais combinações de recursos que foram veiculados em conjunto. |
AssetGroupAssetCombinationData
Dados de combinação de recursos do grupo de recursos
Representação JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Campos | |
---|---|
assetCombinationServedAssets[] |
Recursos veiculados. |
AssetUsage
Contém as informações de uso do recurso.
Representação JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Campos | |
---|---|
asset |
Nome do recurso. |
servedAssetFieldType |
O tipo de campo veiculado do recurso. |
ServedAssetFieldType
Os possíveis tipos de campo de recursos.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas 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-o somente se houver apenas um título no anúncio. Caso contrário, use os enums 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 (em MultiAssetResponsiveAd). |
DESCRIPTION |
O recurso foi usado em uma descrição. Use-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 uma 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 em 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 sitelink. |
CALL |
Este recurso é usado como uma chamada. |
MOBILE_APP |
Este recurso é usado como um app para dispositivos móveis. |
CALLOUT |
Esse recurso é usado como frase de destaque. |
STRUCTURED_SNIPPET |
Esse recurso é usado como um snippet estruturado. |
PRICE |
Esse recurso é usado como preço. |
PROMOTION |
Este recurso é usado como promoção. |
AD_IMAGE |
Este recurso é usado como imagem. |
LEAD_FORM |
O recurso é usado como formulário de lead. |
BUSINESS_LOGO |
O recurso é usado como logotipo da empresa. |
AssetGroup
Um grupo de recursos. AssetGroupAsset é usado para vincular um recurso ao grupo. 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 | |
---|---|
resourceName |
O nome do recurso do grupo. Os nomes dos recursos do grupo de recursos têm o seguinte formato:
|
id |
O ID do grupo de recursos. |
campaign |
A campanha a que esse grupo de recursos está associado. O recurso vinculado ao grupo de recursos. |
name |
Obrigatório. Nome do grupo de recursos. Obrigatório. Ele precisa ter um comprimento mínimo de 1 e máximo de 128. Ele precisa ser exclusivo em uma campanha. |
finalUrls[] |
Uma lista de URLs finais após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, por padrão, os URLs estão qualificados para expansão, a menos que estejam desativados. |
finalMobileUrls[] |
Uma lista de URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, por padrão, os URLs estão qualificados para expansão, a menos que estejam desativados. |
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. |
adStrength |
Qualidade geral do anúncio desse grupo de recursos. |
AssetGroupStatus
Os status possíveis de um grupo de recursos.
Tipos enumerados | |
---|---|
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 foi removido. |
AdStrength
Enumeração que lista as possíveis qualidades do anúncio.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
PENDING |
A qualidade do anúncio está pendente no momento. |
NO_ADS |
Não foi possível gerar nenhum anúncio. |
POOR |
Baixa força. |
AVERAGE |
Força média. |
GOOD |
Boa força. |
EXCELLENT |
Força excelente. |
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 | |
---|---|
resourceName |
O nome do recurso do conjunto de recursos. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
assetSet |
O conjunto a que o recurso está vinculado. |
asset |
O recurso a que o recurso do conjunto está vinculado. |
status |
O status do recurso do conjunto de recursos. Somente leitura. |
AssetSetAssetStatus
Os status possíveis de um recurso de conjunto de recursos.
Tipos enumerados | |
---|---|
UNSPECIFIED |
O status não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
O recurso do conjunto de recursos está ativado. |
REMOVED |
O recurso do conjunto de recursos foi removido. |
AssetSet
Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso ao conjunto.
Representação JSON |
---|
{ "id": string, "resourceName": string } |
Campos | |
---|---|
id |
O ID do conjunto de recursos. |
resourceName |
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 | |
---|---|
resourceName |
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. |
currencyCode |
A moeda usada pela estratégia de lances (código ISO 4217 de três letras). No caso de estratégias de lances em clientes administradores, essa moeda pode ser definida na criação e o padrão é a moeda do cliente administrador. Para clientes de veiculação, este campo não pode ser definido. Todas as estratégias de 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). |
effectiveCurrencyCode |
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 é a moeda definida pelo anunciante ao criar a estratégia. Para veiculação de clientes, este é o currencyCode do cliente. As métricas da estratégia de lances são informadas nesta moeda. Este campo é somente leitura. |
campaignCount |
O número de campanhas vinculadas a essa estratégia de lances. Este campo é somente leitura. |
nonRemovedCampaignCount |
O número de campanhas não removidas anexadas a essa estratégia de lances. Este campo é somente leitura. |
Campo de união Somente um pode ser definido. |
|
enhancedCpc |
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 que a probabilidade é menor. |
maximizeConversionValue |
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível. |
maximizeConversions |
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível. |
targetCpa |
Uma estratégia que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido. |
targetImpressionShare |
Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões. |
targetOutrankShare |
Uma estratégia que define lances com base na fração desejada de leilões em que o anunciante deve superar um concorrente específico. O uso desse campo foi descontinuado. Não será possível criar uma nova estratégia de lances com este campo ou anexar estratégias de lances com este campo a uma campanha. São permitidas modificações em estratégias que já têm esse esquema preenchido. |
targetRoas |
Uma estratégia de lances que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico. |
targetSpend |
Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento. |
BiddingStrategyStatus
Os status possíveis de uma BiddingStrategy.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
A estratégia de lances está ativada. |
REMOVED |
A estratégia de lances foi removida. |
BiddingStrategyType
Enumeração que descreve possíveis tipos de estratégia de lances.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
COMMISSION |
A comissão é uma estratégia de lances automática 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 resultar em uma conversão e os diminui para cliques em que a probabilidade é menor. |
INVALID |
Usado apenas para valor de retorno. Indica que uma campanha não tem uma estratégia de lances. Isso impede que a campanha seja veiculada. Por exemplo, uma campanha pode ser associada a uma estratégia de lances de administrador, e a conta de veiculação em seguida é desvinculada da conta de administrador. Nesse caso, a campanha será removida automaticamente da estratégia de lances do administrador, que agora é inacessível, e passará para o tipo de estratégia de lances INVÁLIDA. |
MANUAL_CPA |
Estratégia de lances manuais 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 considerando um orçamento diário. |
MAXIMIZE_CONVERSION_VALUE |
Uma estratégia que define lances automaticamente para maximizar a receita gastando o orçamento automaticamente. |
PAGE_ONE_PROMOTED |
Esquema de lances promovidos da página um, que define lances máximos de CPC para segmentar impressões nos espaços promovidos da página um ou da página um em google.com. Esse valor de enumeração foi descontinuado. |
PERCENT_CPC |
CPC percentual é a estratégia de lances em que os lances são uma fração do preço anunciado para algum produto ou serviço. |
TARGET_CPA |
O CPA desejado é uma estratégia de lances automática que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido. |
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 desejado por mil impressões (CPM) 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 exibida na parte superior da primeira página (ou em outra região de segmentação). |
TARGET_OUTRANK_SHARE |
A Parcela de superaçã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 deve superar um concorrente específico. O uso desse valor de tipo enumerado foi descontinuado. |
TARGET_ROAS |
O ROAS desejado é uma estratégia de lances automática que ajuda a maximizar a receita enquanto obtém uma média de retorno do investimento médio (ROAS) desejado. |
TARGET_SPEND |
O gasto desejado é uma estratégia que define lances automáticos para você gerar o máximo de cliques possível com o orçamento definido. |
EnhancedCpc
Esse tipo não tem campos.
Uma estratégia de lances automática que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques em que a probabilidade é menor.
Esta estratégia de lances foi descontinuada e não pode mais ser criada. Use "ManualCpc" com "enhancedCpcEnabled" definido como "true" para a funcionalidade equivalente.
MaximizeConversionValue
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Campos | |
---|---|
cpcBidCeilingMicros |
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 apenas para estratégias de lances de portfólio. |
cpcBidFloorMicros |
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. |
targetRoas |
Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento. |
MaximizeConversions
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Campos | |
---|---|
cpcBidCeilingMicros |
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 apenas para estratégias de lances de portfólio. |
cpcBidFloorMicros |
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. |
targetCpaMicros |
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 especificado 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 for definido, a estratégia de lances vai ter como objetivo alcançar o menor CPA possível de acordo com o orçamento. |
TargetCpa
Uma estratégia de lances automática que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido.
Representação JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campos | |
---|---|
targetCpaMicros |
Meta de CPA médio. Essa meta deve ser maior ou igual ao mínimo de unidades faturáveis baseadas na moeda da conta. |
cpcBidCeilingMicros |
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. |
cpcBidFloorMicros |
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 alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.
Representação JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campos | |
---|---|
targetRoas |
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. |
cpcBidCeilingMicros |
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. |
cpcBidFloorMicros |
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 seus lances para conseguir o máximo de cliques possível com o orçamento disponível.
Representação JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Campos | |
---|---|
targetSpendMicros |
A meta de gastos na qual maximizar os cliques. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html (link em inglês) para mais detalhes. |
cpcBidCeilingMicros |
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 de campanha.
Representação JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento da campanha têm o seguinte formato:
|
deliveryMethod |
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. |
amountMicros |
É 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 controlará 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 da vida útil. |
Campanha
Uma campanha.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso da campanha. Os nomes dos recursos da campanha têm o seguinte formato:
|
status |
É o status da campanha. Quando uma nova campanha é adicionada, o status é ATIVADO. |
servingStatus |
O status de veiculação de anúncios da campanha. |
biddingStrategySystemStatus |
O status do sistema da estratégia de lances da campanha. |
adServingOptimizationStatus |
O status de otimização da veiculação de anúncios da campanha. |
advertisingChannelType |
É 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. |
advertisingChannelSubType |
Refinamento opcional para Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado. |
urlCustomParameters[] |
A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um |
realTimeBiddingSetting |
Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange. |
networkSettings |
As configurações de rede da campanha. |
dynamicSearchAdsSetting |
Configuração para controlar os anúncios dinâmicos de pesquisa (DSA). |
shoppingSetting |
A configuração para controlar as campanhas do Shopping. |
geoTargetTypeSetting |
A configuração da segmentação geográfica dos anúncios. |
labels[] |
Os nomes dos recursos dos rótulos anexados a esta campanha. |
biddingStrategyType |
É o tipo de estratégia de lances. Para criar uma estratégia de lances, defina o esquema de lances para criar uma estratégia de lances padrão ou o campo Este campo é somente leitura. |
accessibleBiddingStrategy |
Nome do recurso de AccessibleBiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada, identificada por "biddingStrategy". Vazio se a campanha não usa uma estratégia de portfólio. Os atributos de estratégia irrestritos ficam disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Por outro lado, os atributos restritos só estão disponíveis para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos no recurso BiddingStrategy. |
frequencyCaps[] |
Uma lista que limita a frequência com que cada usuário verá os anúncios dessa campanha. |
selectiveOptimization |
Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimização dela. 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. |
optimizationGoalSetting |
Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização. |
trackingSetting |
Configurações no nível da campanha para informações de acompanhamento. |
engineId |
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". |
excludedParentAssetFieldTypes[] |
Os tipos de campo de recurso que devem ser excluídos dessa campanha. As vinculações de recursos com esses tipos de campo não serão herdadas do nível superior por essa campanha. |
createTime |
O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e está no formato "aaaa-MM-dd HH:mm:ss". O createTime será descontinuado na v1. Use createTime. |
creationTime |
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". |
lastModifiedTime |
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). |
trackingUrlTemplate |
O modelo de URL para criar um URL de rastreamento. |
campaignBudget |
O orçamento da campanha. |
startDate |
A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD. |
endDate |
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. |
finalUrlSuffix |
Sufixo usado para anexar parâmetros de consulta a páginas de destino veiculadas com acompanhamento paralelo. |
urlExpansionOptOut |
Representa a desativação da expansão de URL para URLs mais segmentados. Se a opção estiver desativada (verdadeiro), somente os URLs finais no grupo de recursos ou os URLs especificados no Google Merchant Center ou nos feeds de dados da empresa do anunciante serã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 é "falso". |
Campo de união Precisa ser um portfólio (criado por meio do serviço BiddingStrategy) ou padrão incorporado à campanha. |
|
biddingStrategy |
Estratégia de lances de portfólio usada pela campanha. |
manualCpa |
Estratégia padrão de lances manuais de CPA. Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante. Compatível apenas com campanhas dos Serviços Locais. |
manualCpc |
Estratégia padrão de lances manuais de CPC. Lance manual baseado em clique, no qual o usuário paga por clique. |
manualCpm |
Estratégia padrão de lances manuais de CPM. Lance manual baseado em impressão, no qual o usuário paga por mil impressões. |
maximizeConversions |
A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões dentro do seu orçamento. |
maximizeConversionValue |
A estratégia padrão "Maximizar o valor da conversão" define lances automaticamente para maximizar a receita gastando o orçamento automaticamente. |
targetCpa |
Estratégia de lances de CPA desejado padrão que define automaticamente os lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu. |
targetImpressionShare |
Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para atingir uma determinada porcentagem de impressões. |
targetRoas |
A estratégia de lances de ROAS desejado padrão que maximiza automaticamente a receita, encontrando uma média de retorno do investimento em publicidade (ROAS) desejado específico. |
targetSpend |
Estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível dentro do seu orçamento. |
percentCpc |
Estratégia de lances de CPC de porcentagem padrão em que os lances são uma fração do preço anunciado para algum produto ou serviço. |
targetCpm |
Uma estratégia de lances que otimiza automaticamente o custo por mil impressões. |
CampaignStatus
Possíveis status de uma campanha.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
SERVING |
Disponibilização. |
NONE |
Nenhum. |
ENDED |
Finalizada. |
PENDING |
Pendente. |
SUSPENDED |
Suspenso. |
BiddingStrategySystemStatus
Os possíveis status do sistema de uma BiddingStrategy.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Indica que um erro inesperado ocorreu, por exemplo, nenhum tipo de estratégia de lances foi encontrado ou nenhuma informação de status foi encontrada. |
UNKNOWN |
Usado apenas para 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á em aprendizado porque foi criada ou reativada recentemente. |
LEARNING_SETTING_CHANGE |
A estratégia de lances está aprendendo devido a uma alteração recente na configuração. |
LEARNING_BUDGET_CHANGE |
A estratégia de lances está aprendendo devido a uma alteração recente no orçamento. |
LEARNING_COMPOSITION_CHANGE |
A estratégia de lances está aprendendo devido a uma alteração recente no número de campanhas, grupos de anúncios ou palavras-chave anexadas a ela. |
LEARNING_CONVERSION_TYPE_CHANGE |
A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão que o cliente modificou recentemente e que eram relevantes para a estratégia de lances. |
LEARNING_CONVERSION_SETTING_CHANGE |
A estratégia de lances depende dos relatórios de conversão, e o cliente mudou as configurações de conversão recentemente. |
LIMITED_BY_CPC_BID_CEILING |
A estratégia de lances está limitada pelo lance máximo. |
LIMITED_BY_CPC_BID_FLOOR |
A estratégia de lances está 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 fração significativa das palavras-chave nesta estratégia de lances está limitada pelo orçamento. |
LIMITED_BY_LOW_PRIORITY_SPEND |
A estratégia de lances não pode alcançar o gasto desejado porque a prioridade do gasto foi removida. |
LIMITED_BY_LOW_QUALITY |
Uma fração significativa das palavras-chave nesta 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 |
Não há acompanhamento de conversões (não há pings) e/ou listas de remarketing para as CISs. |
MISCONFIGURED_CONVERSION_TYPES |
A estratégia de lances depende dos relatórios de conversão, e o cliente não tem tipos de conversão que possam ser informados sobre essa 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 configuradas incorretamente. |
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, palavras-chave ou grupos de anúncios ativos vinculados à estratégia de lances. ou não há orçamentos ativos associados à estratégia de lances. |
UNAVAILABLE |
No momento, essa estratégia de lances não é compatível com relatórios de status. |
MULTIPLE_LEARNING |
Havia vários status de sistema LEARNING_* para essa estratégia de lances no período em questão. |
MULTIPLE_LIMITED |
Havia vários status de sistema LIMITED_* 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 |
Havia vários status de sistema para essa estratégia de lances durante o período em questão. |
AdServingOptimizationStatus
Enumeração que descreve possíveis status de exibição.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
OPTIMIZE |
A veiculação do anúncio é otimizada com base na CTR da campanha. |
CONVERSION_OPTIMIZE |
A veiculação do anúncio é 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 maneira uniforme por 90 dias e depois otimizados para cliques. |
ROTATE_INDEFINITELY |
Exiba anúncios de menor desempenho de forma mais uniforme com anúncios de melhor desempenho e não otimize. |
UNAVAILABLE |
O status de otimização do serviço de anúncios não está disponível. |
AdvertisingChannelType
Enumeração que descreve os vários tipos de canal de publicidade.
Tipos enumerados | |
---|---|
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 empacotadas e Search+. |
DISPLAY |
Apenas 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 |
e campanhas de apps para engajamento veiculadas em vários canais. |
LOCAL |
Campanhas de anúncios locais |
SMART |
Campanhas inteligentes. |
PERFORMANCE_MAX |
das campanhas Performance Max. |
LOCAL_SERVICES |
Campanhas dos Serviços Locais. |
DISCOVERY |
Campanhas Discovery. |
TRAVEL |
campanhas de viagem. |
AdvertisingChannelSubType
Enumeração que descreve os diferentes subtipos de canal.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão. |
SEARCH_MOBILE_APP |
Campanhas de apps para dispositivos móveis na rede de pesquisa. |
DISPLAY_MOBILE_APP |
Campanhas de apps para dispositivos móveis para a Rede de Display. |
SEARCH_EXPRESS |
Campanhas do AdWords Express para pesquisa. |
DISPLAY_EXPRESS |
Campanhas do AdWords Express para a Rede de Display. |
SHOPPING_SMART_ADS |
com as 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 de vídeo TrueView for Action. |
VIDEO_NON_SKIPPABLE |
Campanhas de vídeo com anúncios em vídeo não puláveis. |
APP_CAMPAIGN |
Com uma campanha para apps, você promove facilmente 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 de apps para engajamento com foco em gerar reengajamento com o aplicativo em vários dos principais Serviços do Google, incluindo Pesquisa, YouTube e a Rede de Display. |
LOCAL_CAMPAIGN |
Campanhas especializadas em publicidade local. |
SHOPPING_COMPARISON_LISTING_ADS |
campanhas de comparadores 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 em divulgar o pré-registro de apps para dispositivos móveis e 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. |
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 do parâmetro. |
value |
O valor a ser substituído. |
RealTimeBiddingSetting
Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange.
Representação JSON |
---|
{ "optIn": boolean } |
Campos | |
---|---|
optIn |
Indica se os lances em tempo real estão ativados na campanha. |
NetworkSettings
As configurações de rede da campanha.
Representação JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Campos | |
---|---|
targetGoogleSearch |
Se os anúncios serão veiculados com os resultados da pesquisa do google.com.br. |
targetSearchNetwork |
Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que |
targetContentNetwork |
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. |
targetPartnerSearchNetwork |
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
Configuração para controlar os anúncios dinâmicos de pesquisa (DSA).
Representação JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Campos | |
---|---|
domainName |
Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com". |
languageCode |
Obrigatório. O código de idioma que especifica o idioma do domínio, por exemplo, "en". |
useSuppliedUrlsOnly |
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 | |
---|---|
feedLabel |
Rótulo do feed dos produtos a serem incluídos na campanha. Somente um dos atributos "feedLabel" ou "salesCountry" pode ser definido. Se usado em vez de salesCountry, o campo feedLabel aceitará 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. |
useVehicleInventory |
Indica se o inventário de informações de veículos será segmentado. |
merchantId |
ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo não pode ser modificado nas campanhas do Shopping. |
salesCountry |
O país de venda dos produtos a serem incluídos na campanha. |
campaignPriority |
Prioridade da campanha. As campanhas com prioridades numericamente mais altas têm precedência sobre aquelas 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. |
enableLocal |
Indica se produtos disponíveis na loja física devem ser incluídos. |
GeoTargetTypeSetting
Representa um conjunto de configurações relacionadas à segmentação geográfica dos anúncios.
Representação JSON |
---|
{ "positiveGeoTargetType": enum ( |
Campos | |
---|---|
positiveGeoTargetType |
A configuração usada para a segmentação geográfica positiva nessa campanha específica. |
negativeGeoTargetType |
A configuração usada para a segmentação geográfica negativa nessa campanha específica. |
PositiveGeoTargetType
Os possíveis tipos positivos de segmentação geográfica.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
PRESENCE_OR_INTEREST |
Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou se ele demonstrar interesse nelas. |
SEARCH_INTEREST |
Especifica que um anúncio será acionado se o usuário pesquisar as regiões de segmentação do anunciante. Essa opção só pode ser usada em campanhas padrão do Shopping e de pesquisa. |
PRESENCE |
Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou regularmente. |
NegativeGeoTargetType
Os possíveis tipos de segmentação geográfica negativa.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
PRESENCE_OR_INTEREST |
Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante ou tiver interesse neles. |
PRESENCE |
Especifica que um usuário não poderá ver o anúncio se estiver nos 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 a um usuário em determinado período.
SelectiveOptimization
Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimização dela. 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 | |
---|---|
conversionActions[] |
O conjunto selecionado de ações de conversão para otimizar esta campanha. |
OptimizationGoalSetting
Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização.
Representação JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Campos | |
---|---|
optimizationGoalTypes[] |
A lista de tipos de meta de otimização. |
OptimizationGoalType
O tipo de meta de otimização
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão. |
CALL_CLICKS |
Otimizar para cliques de chamada. As conversões de cliques de chamada são vezes em que as pessoas selecionaram "Ligar" para entrar em contato com uma loja depois de ver um anúncio. |
DRIVING_DIRECTIONS |
Otimizar para rotas de carro. As conversões de rotas de carro são os momentos em que as pessoas selecionaram "Como chegar" para ir a uma loja depois de visualizar um anúncio. |
APP_PRE_REGISTRATION |
Otimizar para pré-registro. As conversões de pré-registro são o número de inscrições de pré-registro 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 | |
---|---|
trackingUrl |
O URL usado para rastreamento dinâmico. |
ManualCpa
Esse tipo não tem campos.
Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante.
ManualCpc
Lance manual baseado em clique, no qual o usuário paga por clique.
Representação JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
enhancedCpcEnabled |
Indica se os lances devem ser otimizados com base nos dados do otimizador de conversões. |
ManualCpm
Esse tipo não tem campos.
Lance manual baseado em impressão, no qual o usuário paga por mil impressões.
PercentCpc
Estratégia de lances em que os lances são uma fração do preço anunciado para algum produto ou serviço.
Representação JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
cpcBidCeilingMicros |
Limite de lance máximo que pode ser definido pela estratégia de lances. Este é um campo opcional inserido pelo anunciante e especificado em micros locais. Observação: um valor zero é interpretado da mesma maneira que ter bid_threshold indefinido. |
enhancedCpcEnabled |
Ajusta o lance para cada leilão para cima ou para baixo, dependendo da probabilidade de uma conversão. Os lances individuais podem exceder cpcBidCeilingMicros, mas o valor do lance médio de uma campanha não deve. |
TargetCpm
Esse tipo não tem campos.
O CPM (custo por mil impressões) desejado é uma estratégia de lances automáticos que define lances para otimizar a performance de acordo com o CPM desejado que você definiu.
CampaignAsset
Um vínculo entre uma campanha e um recurso.
Representação JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso da campanha. Os nomes dos recursos "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
CampaignAssetSet é o vínculo entre uma campanha e um conjunto de recursos. Adicionar um CampaignAssetSet vincula um conjunto de recursos a uma campanha.
Representação JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do conjunto de recursos da campanha. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
campaign |
A campanha a que esse conjunto de recursos está vinculado. |
assetSet |
O conjunto de recursos vinculado à campanha. |
status |
O status do recurso do conjunto de recursos da campanha. Somente leitura. |
CampaignAudienceView
Visualização do público-alvo da campanha Inclui dados de desempenho dos interesses e das listas de remarketing para anúncios das Redes de Display e do YouTube, além de listas de remarketing para anúncios da rede de pesquisa (RLSA), agregadas por critério de campanha e público-alvo. Essa visualização só inclui públicos-alvo anexados no nível da campanha.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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 | |
---|---|
resourceName |
O nome do recurso do critério da campanha. Os nomes dos recursos de critério da campanha têm o seguinte formato:
|
displayName |
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. |
lastModifiedTime |
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". |
criterionId |
ID do critério. Este campo é ignorado durante a modificação. |
bidModifier |
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 |
Define se o critério será segmentado ( |
Campo de união Exatamente um deve ser definido. |
|
keyword |
Palavra-chave. |
location |
Local. |
device |
Dispositivo. |
ageRange |
Faixa etária. |
gender |
Sexo. |
userList |
Lista de usuários. |
language |
e linguagem Hashicorp. |
webpage |
Página da Web. |
locationGroup |
Grupo por locais |
CampaignCriterionStatus
Os status possíveis de um CampaignCriteria.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
O critério da campanha está ativado. |
PAUSED |
O critério da campanha foi pausado. |
REMOVED |
O critério da campanha foi removido. |
LanguageInfo
Um critério de idioma.
Representação JSON |
---|
{ "languageConstant": string } |
Campos | |
---|---|
languageConstant |
O nome do recurso da constante de linguagem. |
LocationGroupInfo
Um raio ao redor de uma lista de locais especificados por um feed.
Representação JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Campos | |
---|---|
geoTargetConstants[] |
Constantes de segmentação por área geográfica que restringem o escopo da área geográfica no feed. No momento, apenas uma constante de segmentação geográfica é permitida. |
radiusUnits |
Unidade do raio. Milhas e metros são suportados para constantes de segmentação geográfica. Milímetros e metros são aceitos para conjuntos de itens de feed. Isso é obrigatório e precisa ser definido nas operações CREATE. |
feedItemSets[] |
GBPSets cujos ViewModels são segmentados. Se vários IDs forem especificados, todos os itens que aparecem em pelo menos um conjunto serão segmentados. Este campo não pode ser usado com geoTargetConstants. Isso é 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 precisa ser definido nas operações CREATE. |
LocationGroupRadiusUnits
A unidade de distância do raio no grupo de locais (por exemplo, MILES)
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
METERS |
Metros |
MILES |
Milhas |
MILLI_MILES |
Milímetros |
CampaignLabel
Representa uma relação entre uma campanha e um rótulo.
Representação JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
Campos | |
---|---|
resourceName |
Nome do recurso. Os nomes dos recursos de rótulos de campanhas têm o seguinte formato: |
campaign |
A campanha a que o rótulo está anexado. |
label |
Rótulo atribuído à campanha. |
CartDataSalesView
Visualização de vendas de dados do carrinho.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização de vendas de dados do carrinho. Os nomes dos recursos de visualização de vendas de dados do carrinho têm o seguinte formato: |
Público
O público-alvo é uma opção de segmentação eficiente que permite cruzar diferentes atributos de segmento, como afinidades e informações demográficas detalhadas, para criar públicos-alvo que representem seções dos segmentos.
Representação JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Campos | |
---|---|
resourceName |
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 único para todos os públicos-alvo. Ele precisa ter comprimento mínimo de 1 e máximo de 255. |
description |
Descrição deste público-alvo. |
ConversionAction
Uma ação de conversão.
Representação JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso da ação de conversão. Os nomes dos recursos de ação de conversão têm o seguinte formato:
|
creationTime |
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 registrada para esta ação de conversão. |
valueSettings |
Configurações relacionadas ao valor dos eventos de conversão associados a esta ação de conversão. |
attributionModelSettings |
Configurações relacionadas ao modelo de atribuição dessa ação de conversão. |
floodlightSettings |
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. |
primaryForGoal |
Se o bit "primaryForGoal" de uma ação de conversão for "false", a ação de conversão não poderá receber lances em todas as campanhas, independentemente da meta de conversão do cliente ou da campanha. No entanto, as metas de conversão personalizadas não respeitam "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á verdadeiro se não for definido. Na V9, o primaryForGoal só pode ser definido como false após a criação por meio de uma operação "update", pois não é declarado como opcional. |
ownerCustomer |
O nome do recurso do cliente proprietário da ação de conversão ou "null" se for uma ação definida pelo sistema. |
includeInClientAccountConversionsMetric |
Indica se essa ação de conversão deve ser incluída na métrica "clientAccountConversions". |
includeInConversionsMetric |
Indica se essa ação de conversão deve ser incluída na métrica "conversões". |
clickThroughLookbackWindowDays |
É o número máximo de dias decorridos entre uma interação (por exemplo, um clique) e um evento de conversão. |
appId |
ID do aplicativo para uma ação de conversão de app. |
ConversionActionStatus
Possíveis status de uma ação de conversão.
Tipos enumerados | |
---|---|
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
Tipos possíveis de uma ação de conversão.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 da 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 |
Conversões de chamada que são rastreadas 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 a partir do site de um anunciante. |
STORE_SALES_DIRECT_UPLOAD |
Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros. Somente 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 nos uploads de dados próprios ou de terceiros e/ou de compras na loja usando cartões de redes de pagamentos. Somente 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 pelo Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Conversões de compra no app 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 compra no app iOS acompanhadas pelo Firebase. |
FIREBASE_IOS_CUSTOM |
Conversões personalizadas do app iOS acompanhadas pelo Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
Conversões de primeiro acesso de aplicativos Android acompanhadas pela análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Conversões de compra no aplicativo Android acompanhadas por meio da análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Conversões personalizadas do app Android acompanhadas pela análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Conversões de primeiro acesso de aplicativos iOS acompanhadas por meio da análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Conversões de compra no aplicativo iOS acompanhadas por meio da análise de aplicativos de terceiros. |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Conversões personalizadas de aplicativos iOS acompanhadas por meio da análise de aplicativos de terceiros. |
ANDROID_APP_PRE_REGISTRATION |
Conversões que ocorrem quando um usuário faz o pré-registro de um app 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 do 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 visualizar ou clicar em um dos anúncios de um anunciante. Somente leitura. |
FLOODLIGHT_TRANSACTION |
Atividade do Floodlight que rastreia o número de vendas feitas ou 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 no Search Ads 360. Somente leitura. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
Conversões de chamada que ocorrem em anúncios da campanha inteligente sem configuração do acompanhamento de chamadas usando critérios personalizados da campanha inteligente. Somente leitura. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
O usuário clica em um elemento de chamada no Google Maps. Somente campanha inteligente. Somente leitura. |
SMART_CAMPAIGN_MAP_DIRECTIONS |
O usuário solicita rotas para o local de uma empresa no Google Maps. Somente campanha inteligente. Somente leitura. |
SMART_CAMPAIGN_TRACKED_CALLS |
Conversões de chamada que ocorrem em anúncios da campanha inteligente com a configuração de acompanhamento de chamadas usando critérios personalizados da campanha inteligente. 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 com base em eventos do site (como envios de formulário ou carregamentos de página) que não usam snippets de evento codificados individualmente. Somente leitura. |
UNIVERSAL_ANALYTICS_GOAL |
Conversões provenientes de metas vinculadas do Universal Analytics. |
UNIVERSAL_ANALYTICS_TRANSACTION |
Conversões provenientes de transações vinculadas do Universal Analytics. |
GOOGLE_ANALYTICS_4_CUSTOM |
Conversões que vêm de conversões de eventos personalizados do Google Analytics 4 vinculadas. |
GOOGLE_ANALYTICS_4_PURCHASE |
Conversões de conversões de compra vinculadas do Google Analytics 4. |
ConversionActionCategory
A categoria de conversões associada a uma ConversionAction.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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, venda 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 |
A adição de itens a um carrinho ou sacola no site do anunciante. |
BEGIN_CHECKOUT |
Quando alguém inicia o processo de finalização da 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 origem externa para o Google Ads. |
SUBMIT_LEAD_FORM |
O envio de um formulário no site de um anunciante indicando o interesse comercial. |
BOOK_APPOINTMENT |
Um 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 |
A pesquisa pelo local da empresa de um anunciante com intenção de visitar. |
OUTBOUND_CLICK |
Um clique para acessar o site de um parceiro do anunciante. |
CONTACT |
Uma ligação, SMS, e-mail, chat ou outro tipo de contato com um anunciante. |
ENGAGEMENT |
Um evento de engajamento com o site, como um longo tempo no site ou uma meta inteligente do Google Analytics (GA). Destinado a ser usado para importações de metas ouro do GA, Firebase e GA. |
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 novamente pelo anunciante (equipe de marketing/vendas). Na jornada do lead até a venda, os anunciantes obtêm leads e agem sobre eles entrando em contato com o consumidor. Se o consumidor tiver interesse e puder comprar o produto dele, o anunciante marca esses leads como "leads qualificados". |
CONVERTED_LEAD |
Uma conversão de lead importada de uma origem externa para o Google Ads que concluiu uma fase escolhida, conforme definido pelo anunciante de geração de leads. |
ValueSettings
Configurações relacionadas ao valor dos eventos de conversão associados a esta ação de conversão.
Representação JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Campos | |
---|---|
defaultValue |
O valor a ser usado quando os eventos de conversão 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. |
defaultCurrencyCode |
O código de moeda a ser usado quando os eventos de conversão para esta ação de conversão são enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão está configurada para usar sempre o valor padrão. |
alwaysUseDefaultValue |
Controla se o valor padrão e o código da moeda padrão são usados no lugar daqueles especificados nos eventos de conversão para esta ação de conversão. |
AttributionModelSettings
Configurações relacionadas ao modelo de atribuição dessa ação de conversão.
Representação JSON |
---|
{ "attributionModel": enum ( |
Campos | |
---|---|
attributionModel |
O tipo de modelo de atribuição dessa ação de conversão. |
dataDrivenModelStatus |
O status do modelo de atribuição baseada em dados para a ação de conversão. |
AttributionModel
Modelo de atribuição que descreve como distribuir crédito de uma determinada conversão entre várias interações anteriores.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 |
Usa a atribuição da Pesquisa Google para atribuir crédito por uma conversão igualmente entre todos os cliques dela. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Atribui exponencialmente mais crédito por uma conversão aos cliques mais recentes usando a atribuição da Pesquisa Google (a meia-vida é de 1 semana). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Atribui 40% do crédito de uma conversão ao primeiro e ao último clique. Os 20% restantes são distribuídos de maneira uniforme entre todos os outros cliques. Para isso, a atribuição da Pesquisa Google é usada. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Modelo flexível que usa aprendizado de máquina para determinar a distribuição adequada de crédito entre cliques usando a atribuição da Pesquisa Google. |
DataDrivenModelStatus
Enumera os status do modelo baseado em dados.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 é atualizado há pelo menos sete dias. Ele ainda está sendo usado, mas vai expirar se não for atualizado por 30 dias. |
EXPIRED |
O modelo baseado em dados expirou. Ele não é atualizado há pelo menos 30 dias e não pode ser usado. Geralmente, isso ocorre porque não houve o número necessário de eventos nos últimos 30 dias. |
NEVER_GENERATED |
O modelo baseado em dados nunca foi gerado. Geralmente, isso ocorre 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 | |
---|---|
activityGroupTag |
String usada para identificar um grupo de atividades do Floodlight ao registrar as conversões. |
activityTag |
String usada para identificar uma atividade do Floodlight ao registrar conversões. |
activityId |
ID da atividade do Floodlight no DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
Uma variável personalizada de conversão. Consulte "Sobre métricas e dimensões 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 | |
---|---|
resourceName |
O nome do recurso da variável personalizada de conversão. Os nomes dos recursos da variável personalizada 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 da conversão. O nome deve ser exclusivo. O nome pode ter, no máximo, 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 deve ser única e consistir em um caractere "u" seguido diretamente por um número menor que 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. |
ownerCustomer |
O nome do recurso do cliente que tem a 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. |
floodlightConversionCustomVariableInfo |
Campos para as variáveis personalizadas de conversão do Floodlight no Search Ads 360. |
customColumnIds[] |
Os IDs das colunas personalizadas que usam essa variável personalizada de conversão. |
ConversionCustomVariableStatus
Possíveis status de uma variável personalizada de conversão.
Tipos enumerados | |
---|---|
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 só vai acumular estatísticas depois que ela for definida como ATIVADA. Esse status não pode ser usado em solicitações CREATE e UPDATE. |
ENABLED |
A variável personalizada de conversão está ativada e vai acumular estatísticas. |
PAUSED |
A variável personalizada de conversão está pausada e só vai acumular estatísticas quando for definida como ATIVADA novamente. |
ConversionCustomVariableFamily
Família de uma variável personalizada de conversão.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 uma 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 acumular 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 acumular 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 de estatísticas. A segmentação será desativada, e as estatísticas das variáveis ativadas só poderão ser acumuladas se os valores existentes não aumentarem ainda mais 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 | |
---|---|
floodlightVariableType |
Tipo de variável do Floodlight definido no Search Ads 360. |
floodlightVariableDataType |
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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
DIMENSION |
Tipo de variável do Floodlight de dimensão. |
METRIC |
Tipo de variável de 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. Consulte https://support.google.com/searchads/answer/4397154?hl=en para saber mais.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 DIMENSION ou METRIC. |
STRING |
Representa uma variável do Floodlight do tipo "String". Essa variável pode ser atribuída a variáveis do Floodlight do tipo DIMENSION. |
Cliente
Um cliente.
Representação JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Campos | |
---|---|
resourceName |
O nome do recurso do cliente. Os nomes dos recursos do cliente têm o seguinte formato:
|
conversionTrackingSetting |
Configuração do acompanhamento de conversões de um cliente. |
accountType |
Tipo de conta de mecanismo, por exemplo: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track etc. |
doubleClickCampaignManagerSetting |
Configuração do DoubleClick Campaign Manager (Campaign Manager) para um cliente administrador. |
accountStatus |
Status da conta, como "Ativada", "Pausada", "Removida" etc. |
lastModifiedTime |
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". |
engineId |
ID da conta na conta de mecanismo externo. |
status |
O status do cliente. |
creationTime |
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. |
descriptiveName |
Nome descritivo opcional e não exclusivo do cliente. |
currencyCode |
A moeda em que a conta opera. É compatível com um subconjunto dos códigos de moeda do padrão ISO 4217. |
timeZone |
O ID de fuso horário local do cliente. |
trackingUrlTemplate |
O modelo de URL para criar um URL de rastreamento sem parâmetros. |
finalUrlSuffix |
O modelo de URL para anexar parâmetros ao URL final. |
autoTaggingEnabled |
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 gerais do cliente relacionadas ao acompanhamento de conversões do Search Ads 360.
Representação JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Campos | |
---|---|
acceptedCustomerDataTerms |
Se o cliente aceitou os termos de dados do cliente. Se você usa o acompanhamento de conversões de várias contas, esse valor é herdado do administrador. Este campo é somente leitura. Para mais informações, consulte https://support.google.com/adspolicy/answer/7475709. |
conversionTrackingStatus |
Status do acompanhamento de conversões. Ela indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário desse recurso. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai ser diferente com base no |
enhancedConversionsForLeadsEnabled |
Indica se o cliente ativou as conversões otimizadas para leads. Se você usa o acompanhamento de conversões de várias contas, esse valor é herdado do administrador. Este campo é somente leitura. |
googleAdsConversionCustomer |
O nome do recurso do cliente onde as conversões são criadas e gerenciadas. Este campo é somente leitura. |
conversionTrackingId |
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 usa). Este campo é somente leitura. |
googleAdsCrossAccountConversionTrackingId |
O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente usa o acompanhamento de conversões e substitui o conversionTrackingId. Esse campo só pode ser gerenciado na interface do Google Ads. Este campo é somente leitura. |
crossAccountConversionTrackingId |
O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente usa o acompanhamento de conversões de várias contas e substitui o conversionTrackingId. |
ConversionTrackingStatus
Status do acompanhamento de conversões do cliente.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
NOT_CONVERSION_TRACKED |
O cliente não usa 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 no login-customer-id da solicitação. |
AccountType
Possíveis tipos de conta de mecanismo.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 |
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 (Campaign Manager) para um cliente administrador.
Representação JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
Campos | |
---|---|
advertiserId |
ID do anunciante do Campaign Manager associado a esse cliente. |
networkId |
ID da rede do Campaign Manager associada a esse cliente. |
timeZone |
Fuso horário da rede do Campaign Manager associado a esse cliente no formato do banco de dados de fuso horário IANA, como América/Nova_York. |
AccountStatus
Possíveis status de uma conta.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Valor padrão. |
UNKNOWN |
Valor desconhecido. |
ENABLED |
tem permissão para veicular anúncios. |
PAUSED |
A conta é desativada pelo usuário. |
SUSPENDED |
A conta é desativada por um processo interno. |
REMOVED |
A conta é desativada de forma irrevogável. |
DRAFT |
A conta ainda está no processo de configuração e ainda não está ATIVADA. |
CustomerStatus
Possíveis status de um cliente.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 reativada por um usuário administrador. |
SUSPENDED |
Indica que uma conta suspensa não pode veicular anúncios. Só podem ser ativados pelo Suporte do Google. |
CLOSED |
Indica que uma conta encerrada não pode veicular anúncios. A conta de teste também terá o status FECHADO. O status é permanente e não pode ser reaberto. |
CustomerAsset
Um vínculo entre um cliente e um recurso.
Representação JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
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 é o vínculo entre um cliente e um conjunto de recursos. Adicionar um CustomerAssetSet vincula um conjunto de recursos a um cliente.
Representação JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do conjunto de recursos do cliente. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:
|
assetSet |
O conjunto de recursos vinculado ao cliente. |
customer |
O cliente a que esse conjunto de recursos está vinculado. |
status |
O status do recurso do conjunto de recursos do cliente. Somente leitura. |
AccessibleBiddingStrategy
Representa uma visualização de BiddingStrategies que pertencem e são compartilhadas com o cliente.
Em contraste com a BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e são compartilhadas com ele, além das estratégias que pertencem a ele. Esse recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos BiddingStrategy.
Representação JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Campos | |
---|---|
resourceName |
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. |
ownerCustomerId |
O ID do cliente proprietário da estratégia de lances. |
ownerDescriptiveName |
descriptionName do cliente proprietário da estratégia de lances. |
Campo de união Somente um pode ser definido. |
|
maximizeConversionValue |
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível. |
maximizeConversions |
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível. |
targetCpa |
Uma estratégia que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido. |
targetImpressionShare |
Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões. |
targetRoas |
Uma estratégia de lances que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico. |
targetSpend |
Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento. |
MaximizeConversionValue
Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.
Representação JSON |
---|
{ "targetRoas": number } |
Campos | |
---|---|
targetRoas |
Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento. |
MaximizeConversions
Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.
Representação JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Campos | |
---|---|
targetCpa |
A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição. |
targetCpaMicros |
A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição. |
TargetCpa
Uma estratégia de lances automática que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido.
Representação JSON |
---|
{ "targetCpaMicros": string } |
Campos | |
---|---|
targetCpaMicros |
Meta de CPA médio. Essa meta deve ser maior ou igual ao mínimo de unidades faturáveis baseadas na moeda da conta. |
TargetRoas
Uma estratégia de lances automáticos que ajuda a maximizar a receita enquanto alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.
Representação JSON |
---|
{ "targetRoas": number } |
Campos | |
---|---|
targetRoas |
Receita escolhida (com base nos dados de conversão) por unidade de gasto. |
TargetSpend
Uma estratégia de lances automática que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.
Representação JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Campos | |
---|---|
targetSpendMicros |
A meta de gastos na qual maximizar os cliques. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html (link em inglês) para mais detalhes. |
cpcBidCeilingMicros |
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 cliente-gerente.
Representação JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
Nome do recurso. Os nomes dos recursos do CustomerManagerLink têm o seguinte formato: |
status |
Status do vínculo entre o cliente e o gerente. |
managerCustomer |
O cliente administrador vinculado ao cliente. |
managerLinkId |
ID do link entre clientes e gerentes. Este campo é somente leitura. |
ManagerLinkStatus
Possíveis status de uma vinculação.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ACTIVE |
Indica a relação atual em vigor |
INACTIVE |
Indica relacionamento encerrado |
PENDING |
Indica que a relação foi solicitada pelo gerente, mas o cliente ainda não aceitou. |
REFUSED |
A relação foi solicitada pelo gerente, mas o cliente se recusou. |
CANCELED |
Indica que a relação foi solicitada pelo administrador, mas foi cancelada. |
CustomerClient
Um link entre um determinado cliente e um cliente cliente. Os CustomerClients só existem para clientes administradores. Todos os clientes diretos e indiretos estão incluídos, além do próprio gerente.
Representação JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso do cliente do cliente. Os nomes dos recursos do CustomerClient têm o formato: |
appliedLabels[] |
Os nomes dos recursos dos rótulos de propriedade do cliente solicitante que são aplicados ao cliente do cliente. Os nomes dos recursos de rótulo têm o seguinte formato:
|
status |
O status do cliente. Somente leitura. |
clientCustomer |
O nome do recurso cliente-cliente vinculado ao cliente em questão. Somente leitura. |
level |
A distância entre o cliente e o cliente. Para "self link", o valor do nível será 0. Somente leitura. |
timeZone |
Representação da string Common Locale Data Repository (CLDR) do fuso horário do cliente, por exemplo, America/Los_Angeles. Somente leitura. |
testAccount |
Identifica se o cliente é uma conta de teste. Somente leitura. |
manager |
Identifica se o cliente é um gerente. Somente leitura. |
descriptiveName |
Nome descritivo para o cliente. Somente leitura. |
currencyCode |
Código da moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura. |
id |
O ID do cliente. Somente leitura. |
DynamicSearchAdsSearchTermView
Visualização do termo de pesquisa em anúncios dinâmicos de pesquisa.
Representação JSON |
---|
{ "resourceName": string, "landingPage": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos para visualização de termos de pesquisa nos anúncios dinâmicos de pesquisa têm a seguinte forma:
|
landingPage |
O URL da página de destino da impressão selecionado dinamicamente. Este campo é somente leitura. |
GenderView
Uma visualização de gênero. O recurso "genderView" reflete o estado de exibição efetivo, em vez dos critérios que foram adicionados. Por padrão, um grupo de anúncios sem critérios de sexo é exibido para todos os sexos. Assim, todos os sexos aparecem na genderView com estatísticas.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização de gênero. Os nomes dos recursos de visualização de gênero têm o seguinte formato:
|
GeoTargetConstant
Uma constante de segmentação geográfica.
Representação JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso da constante de segmentação geográfica. Os nomes dos recursos constantes da segmentação geográfica têm o seguinte formato:
|
status |
Status constante da segmentação por área geográfica. |
id |
O ID da constante da segmentação por área geográfica. |
name |
Nome em inglês da constante de segmentação por área geográfica. |
countryCode |
O código do país ISO-3166-1 alfa-2 associado à segmentação. |
targetType |
Tipo de segmentação constante da segmentação geográfica. |
canonicalName |
O nome em inglês totalmente qualificado, que consiste no nome da segmentação, do nome pai e do país. |
parentGeoTarget |
O nome do recurso da constante mãe de segmentação geográfica. Os nomes dos recursos constantes da segmentação geográfica têm o seguinte formato:
|
GeoTargetConstantStatus
Os status possíveis de uma constante de segmentação geográfica.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
ENABLED |
A constante da segmentação geográfica é válida. |
REMOVAL_PLANNED |
A constante de segmentação geográfica está obsoleta e será removida. |
KeywordView
Uma visualização de palavras-chave.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização da palavra-chave. Os nomes dos recursos de visualização de palavras-chave têm o seguinte formato:
|
Rótulo
Um marcador.
Representação JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
Nome do recurso. Os nomes dos recursos de rótulo têm o seguinte formato: |
status |
Status do rótulo. Somente leitura. |
textLabel |
Um tipo de rótulo que exibe 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
Possíveis status de um rótulo.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 rótulo que exibe texto em um plano de fundo colorido.
Representação JSON |
---|
{ "backgroundColor": string, "description": string } |
Campos | |
---|---|
backgroundColor |
Cor do plano de fundo do rótulo no formato RGB. Essa string precisa corresponder à expressão regular "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$". Observação: a cor do plano de fundo pode não ser visível para contas de administrador. |
description |
Uma breve descrição do rótulo. O comprimento deve ser de, no máximo, 200 caracteres. |
LanguageConstant
Um idioma.
Representação JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Campos | |
---|---|
resourceName |
O nome do recurso da constante de linguagem. Os nomes de recursos de constantes de linguagem têm o seguinte formato:
|
id |
O ID da constante de linguagem. |
code |
O código de idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc. |
name |
O nome completo do idioma em inglês, por exemplo, "Inglês (EUA)", "Espanhol" etc. |
targetable |
Indica se o idioma pode ser segmentado. |
LocationView
Uma visualização de local resume a performance das campanhas por um critério de local.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização do local. Os nomes dos recursos de visualização de local têm o seguinte formato:
|
ProductBiddingCategoryConstant
Uma categoria de lances de produtos.
Representação JSON |
---|
{ "resourceName": string, "level": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso da categoria de lances do produto. Os nomes dos recursos da categoria de lances de produtos têm o seguinte formato:
|
level |
Nível da categoria de lances do produto. |
status |
Status da categoria de lances do produto. |
id |
ID da categoria de lances do produto. Ele é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436. |
countryCode |
Código do país com duas letras maiúsculas da categoria de lances do produto. |
productBiddingCategoryConstantParent |
Nome do recurso da categoria de lances do produto pai. |
languageCode |
Código do idioma da categoria de lances do produto. |
localizedName |
Valor de exibição da categoria de lances do produto localizado de acordo com languageCode. |
ProductBiddingCategoryLevel
Enumeração que descreve o nível da categoria de lances do produto.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
ACTIVE |
A categoria está ativa e pode ser usada para lances. |
OBSOLETE |
A categoria está obsoleta. Usado apenas para fins de relatório. |
ProductGroupView
Uma visualização do grupo de produtos.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização do grupo de produtos. Os nomes dos recursos da visualização de grupo de produtos têm o seguinte formato:
|
ShoppingPerformanceView
Visualização de desempenho do Google Shopping. Oferece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores das dimensões de produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, vão refletir o estado de cada dimensão a partir da data e hora em que o evento correspondente foi registrado.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização de desempenho do Google Shopping. Os nomes dos recursos de visualização de desempenho do Shopping têm o seguinte formato: |
UserList
Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar.
Representação JSON |
---|
{
"resourceName": string,
"type": enum ( |
Campos | |
---|---|
resourceName |
O nome do recurso da lista de usuários. Os nomes dos recursos da lista de usuários têm o seguinte formato:
|
type |
Tipo dessa lista. Este campo é somente leitura. |
id |
ID da lista de usuários. |
name |
Nome dessa lista de usuários. Dependendo de access_reason, o nome da lista de usuários talvez não seja exclusivo (por exemplo, se access_reason=SHARED) |
UserListType
Enumeração contendo possíveis tipos de lista de usuários.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
REMARKETING |
serviceAccount representado como uma coleção de tipos de conversão. |
LOGICAL |
Lista de usuários representado 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 usuários de outro. |
CRM_BASED |
Lista de usuários de dados de CRM primários fornecidos pelo anunciante na forma de e-mails ou outros formatos. |
WebpageView
Uma visualização de página da Web.
Representação JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
O nome do recurso da visualização da página da Web. Os nomes dos recursos de visualização de página da Web têm o seguinte formato:
|
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 | |
---|---|
resourceName |
O nome do recurso da visita. Os nomes dos recursos de visita têm o seguinte formato:
|
id |
O ID da visita. |
criterionId |
ID de palavra-chave do Search Ads 360. Um valor de 0 indica que a palavra-chave não foi atribuída. |
merchantId |
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. |
adId |
ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído. |
clickId |
Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL de ID de clique. |
visitDateTime |
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". |
productId |
O ID do produto clicado. |
productChannel |
O canal de vendas do produto que foi clicado: on-line ou local. |
productLanguageCode |
O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto. |
productStoreId |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais. |
productCountryCode |
O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado. |
assetId |
Código do recurso com o qual houve interação durante o evento da visita. |
assetFieldType |
Tipo de campo do recurso do evento de visita. |
ProductChannel
Enumeração que descreve a localidade de uma oferta de produto.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 | |
---|---|
resourceName |
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. |
criterionId |
ID do critério do Search Ads 360. Um valor de 0 indica que o critério não foi atribuído. |
merchantId |
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. |
adId |
ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído. |
clickId |
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. |
visitId |
O ID da visita do Search Ads 360 ao qual a conversão é atribuída. |
advertiserConversionId |
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. Para conversões on-line, ele é igual à coluna ID ou à coluna floodlightOrderId, dependendo das instruções do Floodlight do anunciante. |
productId |
O ID do produto clicado. |
productChannel |
O canal de vendas do produto que foi clicado: on-line ou local. |
productLanguageCode |
O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto. |
productStoreId |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais. |
productCountryCode |
O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado. |
attributionType |
A que a conversão é atribuída: visita ou palavra-chave + anúncio. |
conversionDateTime |
O carimbo de data/hora do evento de conversão. |
conversionLastModifiedDateTime |
O carimbo de data/hora da última vez em que a conversão foi modificada. |
conversionVisitDateTime |
O carimbo de data/hora da visita à qual a conversão é atribuída. |
conversionQuantity |
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. |
conversionRevenueMicros |
A receita ajustada em micros para o evento de conversão. Estará sempre na moeda da conta de veiculação. |
floodlightOriginalRevenue |
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. |
floodlightOrderId |
O ID do pedido do Floodlight fornecido pelo anunciante para a conversão. |
status |
O status da conversão, ATIVADO ou REMOVIDO. |
assetId |
ID do recurso com o qual houve interação durante o evento de conversão. |
assetFieldType |
Tipo de campo do recurso do evento de conversão. |
AttributionType
Tipo de atribuição de conversões no SearchAds360
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 critério e um par de anúncios. |
ConversionStatus
Possíveis status de uma conversão.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 | |
---|---|
allConversionsValueByConversionDate |
Valor de todas as conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
conversionCustomMetrics[] |
As métricas personalizadas de conversão. |
conversionsValueByConversionDate |
A soma do valor das conversões que recebem lances por data de conversão. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. |
conversionsByConversionDate |
A soma das conversões por data de conversão para tipos de conversão que recebem lances. Pode ser fracionário devido ao modelo de atribuição. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. |
historicalCreativeQualityScore |
O índice de qualidade histórico do criativo. |
historicalLandingPageQualityScore |
A qualidade da experiência histórica na página de destino. |
historicalSearchPredictedCtr |
A taxa de cliques (CTR) prevista de pesquisa histórica. |
interactionEventTypes[] |
Os tipos de interação com pagamentos e sem custo. |
rawEventConversionMetrics[] |
As métricas brutas de conversão de eventos |
absoluteTopImpressionPercentage |
A parcela de impressões na primeira posição da pesquisa é a porcentagem de impressões de anúncios de pesquisa que são exibidas na posição de maior destaque da rede. |
allConversionsFromInteractionsRate |
Todas as conversões de interações (como opostas a conversões de visualização) divididas pelo número de interações com anúncios. |
allConversionsValue |
Valor de todas as conversões. |
allConversions |
O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. |
allConversionsValuePerCost |
O valor de todas as conversões dividido pelo custo total das interações com os anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). |
allConversionsFromClickToCall |
O número de vezes que os usuários clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. Esse número não indica se as ligações foram ou não completadas nem a duração delas. Essa métrica se aplica somente a itens do feed. |
allConversionsFromDirections |
O número de vezes que os usuários clicaram no botão "Como chegar" para ir a uma loja depois de clicar em um anúncio. Essa métrica se aplica somente a itens do feed. |
allConversionsFromInteractionsValuePerInteraction |
O valor de todas as conversões de interações dividido pelo número total de interações. |
allConversionsFromMenu |
O número de vezes que os usuários clicaram em um link para ver o menu de uma loja depois de clicar em um anúncio. Essa métrica se aplica somente a itens do feed. |
allConversionsFromOrder |
Quantas vezes os usuários fizeram um pedido em uma loja depois de clicar em um anúncio. Essa métrica se aplica somente a itens do feed. |
allConversionsFromOtherEngagement |
O número de outras conversões (por exemplo, postar uma avaliação ou salvar o local de uma loja) que ocorreram depois que os usuários clicaram em um anúncio. Essa métrica se aplica somente a itens do feed. |
allConversionsFromStoreVisit |
Número estimado de vezes que os usuários visitaram uma loja depois de clicar em um anúncio. Essa métrica se aplica somente a itens do feed. |
visits |
Os cliques que o Search Ads 360 registrou e encaminhou à página de destino de um anunciante |
allConversionsFromStoreWebsite |
O número de vezes que os usuários foram direcionados ao URL de uma loja depois de clicar em um anúncio. Essa métrica se aplica somente a itens do feed. |
averageCost |
Valor médio que você paga por interação. Esse valor é o custo total dos seus anúncios dividido pelo número total de interações. |
averageCpc |
O custo total de todos os cliques dividido pelo número total de cliques recebidos. 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. |
averageCpm |
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. |
contentBudgetLostImpressionShare |
A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de Display, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
contentImpressionShare |
As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você pode receber. Observação: a parcela de impressões de conteúdo é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
contentRankLostImpressionShare |
A porcentagem estimada de impressões na rede de Display que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas do conteúdo é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
conversionsFromInteractionsRate |
Média de conversões que podem receber lances (da interação) por interação qualificada de conversão. Mostra com que frequência, em média, uma interação com o anúncio leva a uma conversão que recebe lances. |
clientAccountConversionsValue |
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 verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
conversionsValuePerCost |
O valor da conversão que recebe lances dividido pelo custo total das interações qualificadas de conversão. |
conversionsFromInteractionsValuePerInteraction |
O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
clientAccountConversions |
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 verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
costMicros |
A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período. 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. |
costPerAllConversions |
O custo das interações com anúncios dividido por todas as conversões. |
costPerConversion |
Custo médio qualificado de conversão por conversão que recebe lances. |
costPerCurrentModelAttributedConversion |
O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
crossDeviceConversions |
Conversões 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. |
crossDeviceConversionsValue |
A soma do valor das conversões em dispositivos diferentes. |
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 as ações de conversão em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões. |
conversionsValue |
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. |
historicalQualityScore |
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. |
interactionRate |
A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido. |
interactions |
O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio (cliques em anúncios de texto e do Shopping, visualizações de anúncios em vídeo etc.). |
invalidClickRate |
A porcentagem de cliques filtrados do número total de cliques (cliques filtrados e não filtrados) durante o período do relatório. |
invalidClicks |
Número de cliques que o Google considera ilegítimos e que não são cobrados de você. |
mobileFriendlyClicksPercentage |
A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis. |
searchAbsoluteTopImpressionShare |
A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente exibidas na posição de maior destaque no Shopping. Para mais detalhes, consulte https://support.google.com/sa360/answer/9566729. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
searchBudgetLostAbsoluteTopImpressionShare |
O número que estima a frequência com que seu anúncio não foi o primeiro entre os principais anúncios nos resultados de pesquisa devido a um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
searchBudgetLostImpressionShare |
A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de pesquisa, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
searchBudgetLostTopImpressionShare |
O número que estima a frequência com que seu anúncio não foi exibido ao lado dos principais resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
searchClickShare |
O número de cliques que você recebeu na rede de pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
searchExactMatchImpressionShare |
As impressões recebidas divididas pelo número estimado de impressões que você tinha qualificação para receber na rede de pesquisa para termos de pesquisa que corresponderam exatamente às suas palavras-chave (ou eram variações aproximadas da sua palavra-chave), independentemente dos tipos de correspondência de palavra-chave. Observação: a parcela de impressões de correspondência exata de pesquisa é informada entre 0,1 e 1. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
searchImpressionShare |
O número de impressões recebidas na rede de pesquisa dividido pelo número estimado de impressões que você está qualificado para receber. Observação: a parcela de impressões da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
searchRankLostAbsoluteTopImpressionShare |
O número que estima a frequência com que seu anúncio não foi o primeiro entre os principais resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
searchRankLostImpressionShare |
A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
searchRankLostTopImpressionShare |
O número que estima a frequência com que seu anúncio não foi exibido ao lado dos principais resultados da pesquisa orgânica devido a uma classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001. |
searchTopImpressionShare |
As impressões que você recebeu entre os principais anúncios em comparação com o número estimado de impressões que você estava qualificado para receber entre eles. Observação: a parcela de impressões na parte superior da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999. Esses anúncios geralmente ficam acima dos resultados orgânicos principais, embora possam aparecer abaixo desses resultados em determinadas consultas. |
topImpressionPercentage |
A porcentagem de impressões de anúncios que são exibidas ao lado dos principais resultados da pesquisa orgânica. |
valuePerAllConversions |
O valor de todas as conversões dividido pelo número de todas as conversões. |
valuePerAllConversionsByConversionDate |
O valor de todas as conversões dividido pelo número de todas as conversões. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
O valor da conversão que recebe lances dividido pelo número de conversões que recebem lances. Mostra quanto vale, em média, cada uma das conversões que recebem lances. |
valuePerConversionsByConversionDate |
Valor das conversões que podem receber lances por data de conversão dividido pelas conversões que recebem lances por data de conversão. Mostra quanto vale, em média, cada uma das conversões que recebem lances (por data de conversão). Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. |
clientAccountViewThroughConversions |
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. |
clientAccountCrossSellCostOfGoodsSoldMicros |
O custo dos produtos vendidos (CPV) de venda cruzada da conta de cliente é o valor 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 de venda cruzada é o custo total dos produtos vendidos que não foram anunciados. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos de venda cruzada desse pedido é de R $5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
crossSellCostOfGoodsSoldMicros |
O custo dos produtos vendidos (CPV) com venda cruzada é o valor total dos itens comercializados como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos de venda cruzada é o custo total dos produtos vendidos que não foram anunciados. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos de venda cruzada desse pedido é de R $5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
clientAccountCrossSellGrossProfitMicros |
O lucro bruto de venda cruzada da conta de 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 em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
crossSellGrossProfitMicros |
O lucro bruto de venda cruzada é o lucro dos produtos vendidos como resultado da publicidade de um produto diferente, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído na compra é um produto vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O lucro bruto de venda cruzada é a receita gerada com a venda cruzada atribuída aos seus anúncios menos o custo dos produtos vendidos. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
clientAccountCrossSellRevenueMicros |
A receita de venda cruzada da conta de cliente é o valor total gerado com produtos vendidos como resultado da publicidade de outro 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 antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
crossSellRevenueMicros |
A receita de venda cruzada é o valor total que você ganha de produtos vendidos como resultado da publicidade de um produto diferente. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
clientAccountCrossSellUnitsSold |
As unidades vendidas em venda cruzada da conta do cliente representam o número total de produtos vendidos como resultado da publicidade de outro 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 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. |
crossSellUnitsSold |
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. |
clientAccountLeadCostOfGoodsSoldMicros |
O custo dos produtos vendidos (CPV) da conta de cliente é o valor total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse produto será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
leadCostOfGoodsSoldMicros |
O custo dos produtos vendidos de lead (CPV) é o custo total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse produto será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
clientAccountLeadGrossProfitMicros |
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 em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
leadGrossProfitMicros |
O lucro bruto de lead é o lucro dos produtos vendidos como resultado da publicidade do mesmo produto, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, a receita gerada por essas vendas menos o custo dos produtos vendidos será seu lucro bruto de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
clientAccountLeadRevenueMicros |
A receita de lead da conta do 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 em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
leadRevenueMicros |
A receita de lead é o valor total gerado com produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor total gerado com as vendas desses itens vai ser mostrado em "Receita de lead". Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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. |
clientAccountLeadUnitsSold |
As unidades vendidas da conta de 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. |
leadUnitsSold |
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 só pode ser de um dos seguintes tipos: |
|
booleanValue |
Um booleano. |
int64Value |
Um int64. |
floatValue |
Uma flutuação. |
doubleValue |
Um duplo. |
stringValue |
Uma string. |
QualityScoreBucket
Enumeração que lista os possíveis buckets do índice de qualidade.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para 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 os tipos possíveis de interações a pagar e sem custo financeiro.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
CLICK |
Clique para acessar o site. Na maioria dos casos, essa interação navega para um local externo, geralmente a página de destino do anunciante. Também é o InteractionEventType padrão para eventos de clique. |
ENGAGEMENT |
A intenção expressa do usuário de interagir com o anúncio. |
VIDEO_VIEW |
O usuário visualizou um anúncio em vídeo. |
NONE |
O InteractionEventType padrão para eventos de conversão de anúncios. Usado quando uma linha de conversão de anúncios NÃO indica que as interações sem custo financeiro (por exemplo, conversões de anúncios) precisam ser "promovidas" e informadas como parte das métricas principais. Essas são simplesmente outras conversões (anúncios). |
Segmentos
Campos apenas para segmentos.
Representação JSON |
---|
{ "adNetworkType": enum ( |
Campos | |
---|---|
adNetworkType |
Tipo de rede de publicidade. |
conversionActionCategory |
Categoria de ação de conversão. |
conversionCustomDimensions[] |
As dimensões personalizadas de conversão. |
dayOfWeek |
Dia da semana, por exemplo, MONDAY. |
device |
Dispositivo a que as métricas se aplicam. |
keyword |
Critério de palavra-chave. |
productChannel |
Canal do produto. |
productChannelExclusivity |
Exclusividade do canal do produto. |
productCondition |
Estado do produto. |
productSoldCondition |
Condição do produto vendido. |
rawEventConversionDimensions[] |
As dimensões brutas de conversão de eventos. |
conversionAction |
Nome do recurso da ação de conversão. |
conversionActionName |
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. |
month |
Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd. |
productBiddingCategoryLevel1 |
Categoria do lance (nível 1) do produto. |
productBiddingCategoryLevel2 |
Categoria do lance (nível 2) do produto. |
productBiddingCategoryLevel3 |
Categoria do lance (nível 3) do produto. |
productBiddingCategoryLevel4 |
Categoria do lance (nível 4) do produto. |
productBiddingCategoryLevel5 |
Categoria do lance (nível 5) do produto. |
productBrand |
Marca do produto. |
productCountry |
Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto. |
productCustomAttribute0 |
Atributo personalizado 0 do produto. |
productCustomAttribute1 |
Atributo personalizado 1 do produto. |
productCustomAttribute2 |
Atributo personalizado 2 do produto. |
productCustomAttribute3 |
Atributo personalizado 3 do produto. |
productCustomAttribute4 |
Atributo personalizado 4 do produto. |
productItemId |
ID do item do produto. |
productLanguage |
Nome do recurso da constante de idioma para o idioma do produto. |
productSoldBiddingCategoryLevel1 |
Categoria de lance (nível 1) do produto vendido. |
productSoldBiddingCategoryLevel2 |
Categoria de lance (nível 2) do produto vendido. |
productSoldBiddingCategoryLevel3 |
Categoria de lance (nível 3) do produto vendido. |
productSoldBiddingCategoryLevel4 |
Categoria de lance (nível 4) do produto vendido. |
productSoldBiddingCategoryLevel5 |
Categoria de lance (nível 5) do produto vendido. |
productSoldBrand |
Marca do produto vendido. |
productSoldCustomAttribute0 |
Atributo personalizado 0 do produto vendido. |
productSoldCustomAttribute1 |
Atributo personalizado 1 do produto vendido. |
productSoldCustomAttribute2 |
Atributo personalizado 2 do produto vendido. |
productSoldCustomAttribute3 |
Atributo personalizado 3 do produto vendido. |
productSoldCustomAttribute4 |
Atributo personalizado 4 do produto vendido. |
productSoldItemId |
ID do item vendido. |
productSoldTitle |
Título do produto vendido. |
productSoldTypeL1 |
Tipo (nível 1) do produto vendido. |
productSoldTypeL2 |
Tipo (nível 2) do produto vendido. |
productSoldTypeL3 |
Tipo (nível 3) do produto vendido. |
productSoldTypeL4 |
Tipo (nível 4) do produto vendido. |
productSoldTypeL5 |
Tipo (nível 5) do produto vendido. |
productStoreId |
ID da loja do produto. |
productTitle |
Título do produto. |
productTypeL1 |
Tipo (nível 1) do produto. |
productTypeL2 |
Tipo (nível 2) do produto. |
productTypeL3 |
Tipo (nível 3) do produto. |
productTypeL4 |
Tipo (nível 4) do produto. |
productTypeL5 |
Tipo (nível 5) do produto. |
quarter |
Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. no formato aaaa-MM-dd. |
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. |
assetInteractionTarget |
Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios. As interações (por exemplo, cliques) são contabilizadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando são veiculadas juntas. Quando interatividadeOnThisAsset é definido como verdadeiro, isso significa que as interações estão nesse recurso específico. Se o "InteractionOnThisAsset" é falso, isso significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio com que ele é veiculado. |
AdNetworkType
Enumera os tipos de rede do Google Ads.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
SEARCH |
Pesquisa do Google. |
SEARCH_PARTNERS |
Parceiros de pesquisa. |
CONTENT |
Rede de Display. |
YOUTUBE_SEARCH |
Pesquisa do YouTube. |
YOUTUBE_WATCH |
Vídeos do YouTube |
MIXED |
Várias redes. |
Palavra-chave
Um segmento de critério de palavra-chave.
Representação JSON |
---|
{
"info": {
object ( |
Campos | |
---|---|
info |
Informações da palavra-chave |
adGroupCriterion |
O nome do recurso name. |
ProductChannelExclusivity
Enumeração que descreve a disponibilidade de uma oferta de produto.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
SINGLE_CHANNEL |
O item é vendido somente em um canal, em lojas locais ou on-line, conforme indicado pelo ProductChannel. |
MULTI_CHANNEL |
O item corresponde ao item correspondente em 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.
Tipos enumerados | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
OLD |
A condição do produto é antiga. |
NEW |
A condição do produto é nova. |
REFURBISHED |
O estado do produto é recondicionado. |
USED |
A condição do produto é usada. |
AssetInteractionTarget
Um segmento AssetInteractionTarget.
Representação JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Campos | |
---|---|
asset |
O nome do recurso do recurso. |
interactionOnThisAsset |
Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios. |