SearchAds360Row

Uma linha retornada da consulta.

Representação JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Campos
adGroup

object (AdGroup)

O grupo de anúncios referenciado na consulta.

adGroupAd

object (AdGroupAd)

O anúncio referenciado na consulta.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

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

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

O modificador de lances referenciado na consulta.

adGroupCriterion

object (AdGroupCriterion)

O critério referenciado na consulta.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

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

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

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

adGroupLabel

object (AdGroupLabel)

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

ageRangeView

object (AgeRangeView)

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

asset

object (Asset)

O recurso referenciado na consulta.

assetGroupAsset

object (AssetGroupAsset)

O recurso do grupo de recursos referenciado na consulta.

assetGroupSignal

object (AssetGroupSignal)

O indicador do grupo de recursos referenciado na consulta.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

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

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

A visualização da combinação principal do grupo de recursos referenciada na consulta.

assetGroup

object (AssetGroup)

O grupo de recursos referenciado na consulta.

assetSetAsset

object (AssetSetAsset)

O recurso do conjunto de recursos referenciado na consulta.

assetSet

object (AssetSet)

O conjunto de recursos referenciado na consulta.

biddingStrategy

object (BiddingStrategy)

A estratégia de lances referenciada na consulta.

campaignBudget

object (CampaignBudget)

O orçamento da campanha referenciado na consulta.

campaign

object (Campaign)

A campanha referenciada na consulta.

campaignAsset

object (CampaignAsset)

O recurso da campanha referenciado na consulta.

campaignAssetSet

object (CampaignAssetSet)

O grupo de recursos da campanha referenciado na consulta.

campaignAudienceView

object (CampaignAudienceView)

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

campaignCriterion

object (CampaignCriterion)

O critério da campanha referenciado na consulta.

campaignEffectiveLabel

object (CampaignEffectiveLabel)

O rótulo efetivo da campanha mencionado na consulta.

campaignLabel

object (CampaignLabel)

O rótulo da campanha referenciado na consulta.

cartDataSalesView

object (CartDataSalesView)

A visualização de vendas de dados do carrinho referenciada na consulta.

audience

object (Audience)

O público-alvo referenciado na consulta.

conversionAction

object (ConversionAction)

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

conversionCustomVariable

object (ConversionCustomVariable)

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

customer

object (Customer)

O cliente referenciado na consulta.

customerAsset

object (CustomerAsset)

O recurso do cliente referenciado na consulta.

customerAssetSet

object (CustomerAssetSet)

O conjunto de recursos do cliente referenciado na consulta.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

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

customerClient

object (CustomerClient)

O CustomerClient mencionado na consulta.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

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

genderView

object (GenderView)

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

geoTargetConstant

object (GeoTargetConstant)

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

keywordView

object (KeywordView)

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

label

object (Label)

O rótulo referenciado na consulta.

languageConstant

object (LanguageConstant)

A constante de linguagem referenciada na consulta.

locationView

object (LocationView)

A visualização de local referenciada na consulta.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

A categoria de lances do produto referenciada na consulta.

productGroupView

object (ProductGroupView)

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

shoppingPerformanceView

object (ShoppingPerformanceView)

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

userList

object (UserList)

A lista de usuários referenciada na consulta.

userLocationView

object (UserLocationView)

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

webpageView

object (WebpageView)

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

visit

object (Visit)

A visita no nível do evento referenciada na consulta.

conversion

object (Conversion)

A conversão no nível do evento referenciada na consulta.

metrics

object (Metrics)

As métricas.

segments

object (Segments)

Os segmentos.

customColumns[]

object (Value)

As colunas personalizadas.

Grupo de anúncios

Um grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Campos
resourceName

string

O nome de recurso do grupo de anúncios. Os nomes de recursos do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

O status do grupo de anúncios.

type

enum (AdGroupType)

O tipo do grupo de anúncios.

adRotationMode

enum (AdGroupAdRotationMode)

Modo de rotação de anúncios do grupo de anúncios.

creationTime

string

O carimbo de data/hora em que esse adGroup foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

targetingSetting

object (TargetingSetting)

Configuração para recursos relacionados à segmentação.

labels[]

string

Os nomes de recursos dos rótulos anexados a este grupo de anúncios.

effectiveLabels[]

string

Os nomes dos recursos dos rótulos efetivos anexados a este grupo de anúncios. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse grupo de anúncios.

engineId

string

ID do grupo de anúncios na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads (por exemplo, Yahoo Japan, Microsoft, Baidu etc.). Para a entidade do Google Ads, use "adGroup.id".

startDate

string

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

string

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

string

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

string

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

string (int64 format)

O ID do grupo de anúncios.

name

string

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

string (int64 format)

É o lance máximo de CPC (custo por clique).

engineStatus

enum (AdGroupEngineStatus)

O status do mecanismo para o grupo de anúncios.

AdGroupStatus

Os possíveis status de um grupo de anúncios.

Enums
UNSPECIFIED O status não foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

ENABLED O grupo de anúncios está ativado.
PAUSED O grupo de anúncios está pausado.
REMOVED O grupo de anúncios é removido.

AdGroupType

Enum que lista os tipos possíveis de um grupo de anúncios.

Enums
UNSPECIFIED O tipo não foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

SEARCH_STANDARD O tipo de grupo de anúncios padrão para campanhas de pesquisa.
DISPLAY_STANDARD O tipo de grupo de anúncios padrão para campanhas de display.
SHOPPING_PRODUCT_ADS O tipo de grupo de anúncios das campanhas do Shopping que veicula anúncios de produtos padrão.
SHOPPING_SHOWCASE_ADS O tipo de grupos de anúncios que são limitados à veiculação de anúncios de demonstração ou do comerciante nos resultados do Shopping.
HOTEL_ADS O tipo de grupo de anúncios padrão para campanhas de hotel.
SHOPPING_SMART_ADS O tipo de grupos de anúncios em campanhas inteligentes do Shopping.
VIDEO_BUMPER Anúncios em vídeo in-stream curtos e não puláveis.
VIDEO_TRUE_VIEW_IN_STREAM Anúncios em vídeo TrueView (puláveis) in-stream.
VIDEO_TRUE_VIEW_IN_DISPLAY Anúncios em vídeo TrueView in-display.
VIDEO_NON_SKIPPABLE_IN_STREAM Anúncios em vídeo in-stream não puláveis.
VIDEO_OUTSTREAM Anúncios em vídeo out-stream.
SEARCH_DYNAMIC_ADS Tipo de grupo de anúncios dinâmicos de pesquisa.
SHOPPING_COMPARISON_LISTING_ADS O tipo de grupos de anúncios nas campanhas de comparação do Shopping.
PROMOTED_HOTEL_ADS O tipo de grupo de anúncios para grupos de anúncios de hotéis promovidos.
VIDEO_RESPONSIVE Grupos de anúncios responsivos em vídeo.
VIDEO_EFFICIENT_REACH Grupos de anúncios de alcance eficiente de vídeo.
SMART_CAMPAIGN_ADS Tipo de grupo de anúncios para campanhas inteligentes.
TRAVEL_ADS Tipo de grupo de anúncios para campanhas de viagens.

AdGroupAdRotationMode

Os possíveis modos de rotação de anúncios de um grupo.

Enums
UNSPECIFIED O modo de rotação de anúncios não foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

OPTIMIZE Otimize os anúncios do grupo com base em cliques ou conversões.
ROTATE_FOREVER Alternar uniformemente.

AdGroupEngineStatus

Status do mecanismo do grupo de anúncios.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AD_GROUP_ELIGIBLE

Obsoleto. Não use.

AD_GROUP_EXPIRED Nenhum anúncio está sendo exibido para esse grupo de anúncios porque a data de término dele já passou.
AD_GROUP_REMOVED O grupo de anúncios foi excluído.
AD_GROUP_DRAFT Nenhum anúncio está sendo veiculado para esse grupo porque o grupo associado ainda está em rascunho.
AD_GROUP_PAUSED O grupo de anúncios foi pausado.
AD_GROUP_SERVING O grupo de anúncios está ativo e veiculando anúncios.
AD_GROUP_SUBMITTED O grupo de anúncios foi enviado (status legado do Microsoft Bing Ads).
CAMPAIGN_PAUSED Nenhum anúncio está sendo veiculado para esse grupo porque a campanha foi pausada.
ACCOUNT_PAUSED Nenhum anúncio está em exibição para esse grupo porque a conta foi pausada.

TargetingSetting

Configurações dos recursos relacionados à segmentação, nos níveis da campanha e do grupo de anúncios. Para mais detalhes sobre a configuração de segmentação, acesse https://support.google.com/google-ads/answer/7365594.

Representação JSON
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Campos
targetRestrictions[]

object (TargetRestriction)

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 (TargetingDimension),
  "bidOnly": boolean
}
Campos
targetingDimension

enum (TargetingDimension)

A dimensão de segmentação a que essas configurações se aplicam.

bidOnly

boolean

Indica se você deve restringir seus anúncios para serem exibidos somente para os critérios selecionados para essa segmentaçãoDimension ou para segmentar todos os valores para essa segmentaçãoDimension e exibir anúncios com base em sua segmentação em outras TargetingDimensions. Um valor de true significa que esses critérios aplicarão somente modificadores de lance e não afetarão a segmentação. Um valor de false significa que esses critérios vão restringir a segmentação e aplicar modificadores de lance.

TargetingDimension

Enumeração que descreve possíveis dimensões de segmentação.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
KEYWORD Critérios de palavra-chave, por exemplo, "mars cruise". KEYWORD pode ser usada como uma dimensão de lance personalizado. As palavras-chave são sempre uma dimensão de segmentação. Sendo assim, elas podem não ser definidas como uma dimensão "ALL" de destino com TargetRestriction.
AUDIENCE Os critérios de público-alvo, que incluem lista de usuários, interesse do usuário, afinidade personalizada e público-alvo personalizado no mercado.
TOPIC Critérios de tema para segmentar categorias de conteúdo, por exemplo, "category::Animals>Pets", usado para segmentação de display e vídeo.
GENDER Critérios para segmentação por gênero.
AGE_RANGE Critérios para segmentar faixas etárias.
PLACEMENT Critérios de canais, que incluem sites como "www.flowers4sale.com", além de aplicativos, categorias de apps para dispositivos móveis, vídeos e canais do YouTube.
PARENTAL_STATUS Critérios para segmentação por status parental.
INCOME_RANGE Critérios para segmentação por faixa de renda.

AdGroupAd

Um anúncio do grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Campos
resourceName

string

O nome do recurso do anúncio. Os nomes dos recursos de anúncios do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

O status do anúncio.

ad

object (Ad)

O anúncio.

creationTime

string

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[]

string

Os nomes dos recursos dos rótulos anexados ao anúncio do grupo de anúncios.

effectiveLabels[]

string

Os nomes dos recursos dos rótulos eficazes anexados a este anúncio. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse anúncio.

engineId

string

É o ID do anúncio na conta de mecanismo externo. Esse campo é somente para contas do Search Ads 360, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para entidades que não são do Search Ads 360, use "adGroupAd.ad.id".

engineStatus

enum (AdGroupAdEngineStatus)

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

string

A data e a hora em que o anúncio desse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

AdGroupAdStatus

Os status possíveis de um AdGroupAd.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

ENABLED O anúncio do grupo de anúncios está ativado.
PAUSED O anúncio do grupo de anúncios está pausado.
REMOVED O anúncio do grupo de anúncios é removido.

AdType

Os possíveis tipos de anúncio.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

TEXT_AD O anúncio é de texto.
EXPANDED_TEXT_AD O anúncio é um anúncio de texto expandido.
CALL_ONLY_AD O anúncio é só para chamadas.
EXPANDED_DYNAMIC_SEARCH_AD O anúncio é um anúncio dinâmico expandido de pesquisa.
HOTEL_AD O anúncio é de hotel.
SHOPPING_SMART_AD O anúncio é inteligente do Shopping.
SHOPPING_PRODUCT_AD O anúncio é um anúncio padrão do Shopping.
VIDEO_AD O anúncio é em vídeo.
GMAIL_AD Este anúncio é do Gmail.
IMAGE_AD Este anúncio é gráfico.
RESPONSIVE_SEARCH_AD O anúncio é um anúncio responsivo de pesquisa.
LEGACY_RESPONSIVE_DISPLAY_AD O anúncio é um anúncio responsivo de display legado.
APP_AD O anúncio é de um app.
LEGACY_APP_INSTALL_AD É um anúncio legado de instalação de apps.
RESPONSIVE_DISPLAY_AD O anúncio é responsivo de display.
LOCAL_AD O anúncio é local.
HTML5_UPLOAD_AD O anúncio é um upload de display com o tipo de produto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD O anúncio é de upload de display com um dos tipos de produto DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD O anúncio é de engajamento no app.
SHOPPING_COMPARISON_LISTING_AD O anúncio é um anúncio de comparação do Shopping.
VIDEO_BUMPER_AD Anúncio bumper em vídeo.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Anúncio in-stream não pulável em vídeo.
VIDEO_OUTSTREAM_AD Anúncio em vídeo out-stream.
VIDEO_TRUEVIEW_DISCOVERY_AD Anúncio em vídeo TrueView in-display.
VIDEO_TRUEVIEW_IN_STREAM_AD Anúncio in-stream TrueView em vídeo.
VIDEO_RESPONSIVE_AD Anúncio responsivo em vídeo.
SMART_CAMPAIGN_AD Anúncio da campanha inteligente.
APP_PRE_REGISTRATION_AD Anúncio de pré-registro do app universal.
DISCOVERY_MULTI_ASSET_AD Anúncio Discovery com vários recursos.
TRAVEL_AD Anúncio de viagem.
DISCOVERY_VIDEO_RESPONSIVE_AD Anúncio Discovery em vídeo responsivo.
MULTIMEDIA_AD Anúncio multimídia.

SearchAds360TextAdInfo

Um anúncio de texto do Search Ads 360.

Representação JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Campos
headline

string

O título do anúncio.

description1

string

A primeira linha da descrição do anúncio.

description2

string

Segunda linha da descrição do anúncio.

displayUrl

string

O URL exibido do anúncio.

displayMobileUrl

string

O URL para dispositivos móveis exibido no anúncio.

adTrackingId

string (int64 format)

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

string

O título do anúncio.

headline2

string

O segundo título do anúncio.

headline3

string

O terceiro título do anúncio.

description1

string

A primeira linha da descrição do anúncio.

description2

string

Segunda linha da descrição do anúncio.

path1

string

Texto anexado ao URL visível gerado automaticamente com um delimitador.

path2

string

Texto anexado a path1 com um delimitador.

adTrackingId

string (int64 format)

O ID de acompanhamento do anúncio.

SearchAds360ResponsiveSearchAdInfo

Um anúncio responsivo de pesquisa do Search Ads 360.

Representação JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista.

path1

string

Texto anexado ao URL visível gerado automaticamente com um delimitador.

path2

string

Texto anexado a path1 com um delimitador.

adTrackingId

string (int64 format)

O ID de acompanhamento do anúncio.

AdTextAsset

Um recurso de texto usado em um anúncio.

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

string

Texto do recurso.

SearchAds360ProductAdInfo

Esse tipo não tem campos.

Um anúncio de produto do Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Um anúncio dinâmico expandido de pesquisa.

Representação JSON
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Campos
description1

string

A primeira linha da descrição do anúncio.

description2

string

Segunda linha da descrição do anúncio.

adTrackingId

string (int64 format)

O ID de acompanhamento do anúncio.

AdGroupAdEngineStatus

Enumera os status do mecanismo GroupAd.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AD_GROUP_AD_ELIGIBLE

Obsoleto. Não use.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: o criativo não foi aprovado.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: o URL para dispositivos móveis está em processo de revisão.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: o criativo é inválido em dispositivos móveis, mas válido em computadores.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: o criativo está pronto para ativação.
AD_GROUP_AD_NOT_REVIEWED Baidu: o criativo não foi analisado.
AD_GROUP_AD_ON_HOLD

Obsoleto. Não use. Usado anteriormente pelo Gemini

AD_GROUP_AD_PAUSED O criativo foi pausado.
AD_GROUP_AD_REMOVED O criativo foi removido.
AD_GROUP_AD_PENDING_REVIEW O criativo está com análise pendente.
AD_GROUP_AD_UNDER_REVIEW O criativo está em análise.
AD_GROUP_AD_APPROVED O criativo foi aprovado.
AD_GROUP_AD_DISAPPROVED O criativo foi reprovado.
AD_GROUP_AD_SERVING O criativo está sendo veiculado.
AD_GROUP_AD_ACCOUNT_PAUSED O criativo foi pausado porque a conta está pausada.
AD_GROUP_AD_CAMPAIGN_PAUSED O criativo foi pausado porque a campanha está pausada.
AD_GROUP_AD_AD_GROUP_PAUSED O criativo foi pausado porque o grupo de anúncios está pausado.

AdGroupAdEffectiveLabel

Uma relação entre um anúncio de grupo de anúncios e um rótulo efetivo. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a este anúncio do grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

O nome do recurso do rótulo efetivo do anúncio do grupo de anúncios. Os nomes dos recursos de rótulo efetivo do anúncio do grupo de anúncios têm o seguinte formato: customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

O anúncio do grupo de anúncios ao qual o rótulo eficaz está anexado.

label

string

O rótulo efetivo atribuído ao anúncio do grupo de anúncios.

ownerCustomerId

string (int64 format)

O ID do cliente que possui o rótulo efetivo.

AdGroupAdLabel

Uma relação entre um anúncio de grupo de anúncios e um rótulo.

Representação JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo do anúncio do grupo de anúncios têm o formato: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

O anúncio de grupo de anúncios ao qual o rótulo está anexado.

label

string

Rótulo atribuído ao anúncio do grupo de anúncios.

ownerCustomerId

string (int64 format)

O ID do cliente que é proprietário do rótulo.

AdGroupAsset

Uma conexão entre um grupo de anúncios e um recurso.

Representação JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Campos
resourceName

string

O nome do recurso do grupo de anúncios. Os nomes dos recursos de AdGroupAsset têm o seguinte formato:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

Obrigatório. O grupo de anúncios ao qual o recurso está vinculado.

asset

string

Obrigatório. O recurso que está vinculado ao grupo de anúncios.

status

enum (AssetLinkStatus)

Status do recurso do grupo de anúncios.

AssetLinkStatus

Enumeração que descreve os status de um link de recurso.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED O link do recurso está ativado.
REMOVED O link do recurso foi removido.
PAUSED O link do recurso está pausado.

AdGroupAssetSet

O conjunto de recursos do grupo de anúncios é a vinculação entre um grupo de anúncios e um conjunto de recursos. A criação de um conjunto de recursos de grupo de anúncios vincula um conjunto de recursos a um grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Campos
resourceName

string

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:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

O grupo de anúncios ao qual esse conjunto de recursos está vinculado.

assetSet

string

O conjunto de recursos vinculado ao grupo de anúncios.

status

enum (AssetSetLinkStatus)

O status do conjunto de recursos do grupo de anúncios. Somente leitura.

AssetSetLinkStatus

Os possíveis status da vinculação entre o conjunto de recursos e o contêiner.

Enums
UNSPECIFIED O status não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta.
ENABLED A vinculação entre o conjunto de recursos e o contêiner está ativada.
REMOVED A vinculação entre o conjunto de recursos e o contêiner é removida.

AdGroupAudienceView

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

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

string

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

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

AdGroupBidModifier

Representa um modificador do lance de grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

O nome do recurso do modificador de lance do grupo de anúncios. Os nomes dos recursos do modificador de lance do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

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 criterion. O critério do modificador de lance do grupo de anúncios.

Obrigatório em operações de criação a partir da V5. criterion pode ser apenas de um dos tipos a seguir:

device

object (DeviceInfo)

Um critério de dispositivo.

DeviceInfo

Um critério de dispositivo.

Representação JSON
{
  "type": enum (Device)
}
Campos
type

enum (Device)

Tipo de dispositivo.

Dispositivo

Enumera os dispositivos do Google Ads disponíveis para segmentação.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
MOBILE Dispositivos móveis com navegadores completos.
TABLET Tablets com navegadores completos.
DESKTOP Computadores.
CONNECTED_TV Smart TVs e consoles de jogos.
OTHER Outros tipos de dispositivos.

AdGroupCriterion

Um critério do grupo de anúncios. O relatório "adGroupCriterion" só retorna critérios que foram adicionados explicitamente ao grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

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:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

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

enum (AdGroupCriterionStatus)

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

object (QualityInfo)

Informações sobre a qualidade do critério.

type

enum (CriterionType)

Tipo do critério.

labels[]

string

Os nomes dos recursos dos rótulos anexados a este critério do grupo de anúncios.

effectiveLabels[]

string

Os nomes dos recursos dos rótulos efetivos anexados a este critério do grupo de anúncios. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse critério do grupo de anúncios.

positionEstimates

object (PositionEstimates)

Estimativas para lances de critério em várias posições.

finalUrls[]

string

A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio.

engineId

string

ID do critério do grupo de anúncios na conta de mecanismo externo. Esse campo é apenas para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para a entidade do Google Ads, use "adGroupcri.criterion_id".

lastModifiedTime

string

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

string (int64 format)

ID do critério.

adGroup

string

O grupo de anúncios ao qual o critério pertence.

negative

boolean

Indica se o critério será segmentado (false) ou excluído (true).

Este campo não pode ser modificado. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente.

bidModifier

number

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

string (int64 format)

Lance de CPC (custo por clique).

effectiveCpcBidMicros

string (int64 format)

O lance de CPC (custo por clique) efetivo.

engineStatus

enum (AdGroupCriterionEngineStatus)

O status do mecanismo para o critério do grupo de anúncios.

finalUrlSuffix

string

Modelo de URL para anexar parâmetros ao URL final.

trackingUrlTemplate

string

O modelo de URL para criar um URL de rastreamento.

Campo de união criterion. O critério do grupo de anúncios.

É necessário definir exatamente um. criterion pode ser apenas de um dos tipos a seguir:

keyword

object (KeywordInfo)

Palavra-chave.

listingGroup

object (ListingGroupInfo)

Grupo de produtos anunciados.

ageRange

object (AgeRangeInfo)

Faixa etária.

gender

object (GenderInfo)

Gênero.

userList

object (UserListInfo)

Lista de usuários.

webpage

object (WebpageInfo)

Página da Web

location

object (LocationInfo)

Local.

AdGroupCriterionStatus

Os status possíveis de um AdGroupCriterion.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

ENABLED O critério do grupo de anúncios está ativado.
PAUSED O critério do grupo de anúncios está pausado.
REMOVED O critério do grupo de anúncios é removido.

QualityInfo

Um contêiner para informações de qualidade do critério do grupo de anúncios.

Representação JSON
{
  "qualityScore": integer
}
Campos
qualityScore

integer

Índice de qualidade.

Esse campo não será preenchido se o Google não tiver informações suficientes para determinar um valor.

CriterionType

Enumeração que descreve possíveis tipos de critérios.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
KEYWORD Palavra-chave, por exemplo, "mars cruise".
PLACEMENT Posição, também conhecida como site, por exemplo, "www.flowers4sale.com"
MOBILE_APP_CATEGORY Categorias de apps para dispositivos móveis a segmentar.
MOBILE_APPLICATION Aplicativos para dispositivos móveis a serem segmentados.
DEVICE Dispositivos a serem segmentados.
LOCATION Locais a serem segmentados.
LISTING_GROUP Grupos de produtos anunciados a serem segmentados.
AD_SCHEDULE Programação de anúncios.
AGE_RANGE Faixa etária.
GENDER Gênero.
INCOME_RANGE Faixa de renda.
PARENTAL_STATUS Status parental.
YOUTUBE_VIDEO Vídeo do YouTube.
YOUTUBE_CHANNEL Canal do YouTube.
USER_LIST Lista de usuários.
PROXIMITY Proximidade.
TOPIC Uma segmentação por tópico na Rede de Display (por exemplo, "Animais de estimação e animais").
LISTING_SCOPE Escopo do item para segmentação.
LANGUAGE e linguagem Hashicorp.
IP_BLOCK IpBlock.
CONTENT_LABEL Marcador de conteúdo para exclusão de categoria.
CARRIER Operadora.
USER_INTEREST Uma categoria em que o usuário tem interesse.
WEBPAGE Critério de página da Web para anúncios dinâmicos de pesquisa.
OPERATING_SYSTEM_VERSION A versão do sistema operacional.
APP_PAYMENT_MODEL Modelo de pagamento do app.
MOBILE_DEVICE Dispositivo móvel.
CUSTOM_AFFINITY Afinidade personalizada.
CUSTOM_INTENT Intenção personalizada.
LOCATION_GROUP Grupo por locais.
CUSTOM_AUDIENCE Público-alvo personalizado
COMBINED_AUDIENCE Público-alvo combinado
KEYWORD_THEME Tema de palavra-chave da campanha inteligente
AUDIENCE Público-alvo
LOCAL_SERVICE_ID ID do serviço dos anúncios dos Serviços Locais.
BRAND Marca
BRAND_LIST Lista de marcas
LIFE_EVENT Evento importante

Posição estimada

Estimativas de lances de critério em várias posições.

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

string (int64 format)

A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página dos resultados de pesquisa.

AdGroupCriterionEngineStatus

Enumera os status do mecanismo de AdGroupCriterion.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AD_GROUP_CRITERION_ELIGIBLE

Obsoleto. Não use.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: o lance ou a qualidade é muito baixo para exibição.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: pausado pelo Baidu devido ao baixo volume de pesquisas.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: o URL para dispositivos móveis está em processo de revisão.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: a página de destino de um dispositivo é inválida, enquanto a página de destino do outro dispositivo é válida.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: a palavra-chave foi criada e pausada pelo gerenciamento de conta do Baidu e agora está pronta para ser ativada.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: em processo de análise pelo Baidu. Gemini: critério em análise.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: critério a ser revisado.
AD_GROUP_CRITERION_ON_HOLD

Obsoleto. Não use. Usado anteriormente pelo Gemini

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Critério em análise
AD_GROUP_CRITERION_PAUSED O critério foi pausado.
AD_GROUP_CRITERION_REMOVED O critério foi removido.
AD_GROUP_CRITERION_APPROVED O critério foi aprovado.
AD_GROUP_CRITERION_DISAPPROVED O critério foi reprovado.
AD_GROUP_CRITERION_SERVING O critério está ativo e em veiculação.
AD_GROUP_CRITERION_ACCOUNT_PAUSED O critério foi pausado porque a conta está pausada.

KeywordInfo

Um critério de palavra-chave.

Representação JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Campos
matchType

enum (KeywordMatchType)

Tipo de correspondência da palavra-chave.

text

string

O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).

KeywordMatchType

Possíveis tipos de correspondência de palavra-chave.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
EXACT Correspondência exata.
PHRASE Correspondência de frase.
BROAD Correspondência ampla.

ListingGroupInfo

Um critério do grupo de produtos anunciados.

Representação JSON
{
  "type": enum (ListingGroupType)
}
Campos
type

enum (ListingGroupType)

Tipo do grupo de produtos anunciados.

ListingGroupType

O tipo do grupo de produtos anunciados.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SUBDIVISION Subdivisão de produtos em alguma dimensão da listagem. Esses nós não são usados para servir para segmentar entradas de listagem, mas servem meramente para definir a estrutura da árvore.
UNIT Unidade de grupo de listagem que define um lance.

AgeRangeInfo

Um critério de faixa etária.

Representação JSON
{
  "type": enum (AgeRangeType)
}
Campos
type

enum (AgeRangeType)

Tipo de faixa etária.

AgeRangeType

O tipo de faixa etária demográfica (por exemplo, entre 18 e 24 anos).

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
AGE_RANGE_18_24 Entre 18 e 24 anos.
AGE_RANGE_25_34 Entre 25 e 34 anos.
AGE_RANGE_35_44 Entre 35 e 44 anos.
AGE_RANGE_45_54 Entre 45 e 54 anos.
AGE_RANGE_55_64 Entre 55 e 64 anos.
AGE_RANGE_65_UP 65 anos ou mais.
AGE_RANGE_UNDETERMINED Faixa etária indeterminada.

GenderInfo

Um critério de gênero.

Representação JSON
{
  "type": enum (GenderType)
}
Campos
type

enum (GenderType)

Tipo de gênero.

GenderType

O tipo de gênero demográfico (por exemplo, feminino).

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
MALE Masculino.
FEMALE Feminino.
UNDETERMINED Gênero indeterminado.

UserListInfo

Um critério da lista de usuários. Representa uma lista de usuários definida pelo anunciante para ser segmentada.

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

string

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 (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Campos
conditions[]

object (WebpageConditionInfo)

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

number

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

string

O nome do critério definido por este parâmetro. O valor do nome será usado para identificar, classificar e filtrar critérios com esse tipo de parâmetro.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

WebpageConditionInfo

Expressão lógica para segmentação da página da web do site de um anunciante.

Representação JSON
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Campos
operand

enum (WebpageConditionOperand)

Operando da condição de segmentação de páginas da Web.

operator

enum (WebpageConditionOperator)

Operador da condição de segmentação de páginas da Web.

argument

string

Argumento da condição de segmentação de páginas da Web.

WebpageConditionOperand

O operando de condição da página da Web no critério da página da Web.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
URL Operando que denota uma condição de segmentação de URL de página da Web.
CATEGORY Operando que denota uma condição de segmentação de categoria de página da Web.
PAGE_TITLE Operando que indica uma condição de segmentação de título de página da Web.
PAGE_CONTENT Operando que indica uma condição de segmentação de conteúdo de página da Web.
CUSTOM_LABEL Operando que indica uma condição de segmentação de rótulo personalizado de uma página da Web.

WebpageConditionOperator

O operador de condição da página da Web no critério da página da Web.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
EQUALS A condição da Web do argumento é igual à condição da Web comparada.
CONTAINS A condição da Web do argumento faz parte da condição da Web comparada.

LocationInfo

Um critério de localização.

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

string

O nome do recurso constante de destino geográfico.

AdGroupCriterionEffectiveLabel

Uma relação entre um critério de grupo de anúncios e um rótulo efetivo. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a esse critério de grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

O nome do recurso do rótulo efetivo do critério do grupo de anúncios. Os nomes dos recursos do rótulo do critério do grupo de anúncios têm o formato: customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

O critério do grupo de anúncios ao qual o rótulo efetivo está anexado.

label

string

O rótulo efetivo atribuído ao critério do grupo de anúncios.

ownerCustomerId

string (int64 format)

O ID do Cliente proprietário do rótulo em vigor.

AdGroupCriterionLabel

Uma relação entre um critério de grupo de anúncios e um rótulo.

Representação JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nome do recurso do rótulo do critério do grupo de anúncios. Os nomes dos recursos do rótulo do critério do grupo de anúncios têm o formato: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

O critério do grupo de anúncios ao qual o rótulo está anexado.

label

string

Rótulo atribuído ao critério do grupo de anúncios.

ownerCustomerId

string (int64 format)

O ID do cliente que é proprietário do rótulo.

AdGroupEffectiveLabel

Uma relação entre um grupo de anúncios e um rótulo eficaz. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

O nome do recurso do rótulo eficaz do grupo de anúncios. Os nomes dos recursos do rótulo eficaz do grupo de anúncios têm o formato: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

adGroup

string

O grupo de anúncios ao qual o rótulo eficaz está anexado.

label

string

O rótulo efetivo atribuído ao grupo de anúncios.

ownerCustomerId

string (int64 format)

O ID do cliente que possui o rótulo efetivo.

AdGroupLabel

Uma relação entre um grupo de anúncios e um rótulo.

Representação JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nome do recurso do rótulo do grupo de anúncios. Os nomes dos recursos do rótulo do grupo de anúncios têm o formato: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

O grupo de anúncios ao qual o rótulo está anexado.

label

string

Rótulo atribuído ao grupo de anúncios.

ownerCustomerId

string (int64 format)

O ID do cliente que é proprietário do rótulo.

AgeRangeView

Uma visualização de faixa etária.

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

string

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

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

Recurso

O recurso faz parte de um anúncio que pode ser compartilhado entre vários anúncios. Pode ser uma imagem (ImageAsset), um vídeo (YoutubeVideoAsset) etc. Os recursos são imutáveis e não podem ser removidos. Para interromper a veiculação de um recurso, remova-o da entidade que o usa.

Representação JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Campos
resourceName

string

O nome do recurso. Os nomes dos recursos de ativos têm o seguinte formato:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Tipo do recurso.

finalUrls[]

string

Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios.

status

enum (AssetStatus)

O status do recurso.

creationTime

string

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

string

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

string (int64 format)

O ID do recurso.

name

string

Nome opcional do recurso.

trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento.

engineStatus

enum (AssetEngineStatus)

O status do mecanismo de um recurso.

Campo de união asset_data. O tipo específico do recurso. asset_data pode ser apenas de um dos tipos a seguir:
youtubeVideoAsset

object (YoutubeVideoAsset)

Um recurso de vídeo do YouTube.

imageAsset

object (ImageAsset)

Um recurso de imagem.

textAsset

object (TextAsset)

Um recurso de texto.

calloutAsset

object (UnifiedCalloutAsset)

Um recurso de frase de destaque unificado.

pageFeedAsset

object (UnifiedPageFeedAsset)

Um recurso de feed de páginas unificado.

mobileAppAsset

object (MobileAppAsset)

Um recurso de app para dispositivos móveis.

callAsset

object (UnifiedCallAsset)

Um recurso de ligação unificado.

callToActionAsset

object (CallToActionAsset)

Um recurso de call-to-action.

locationAsset

object (UnifiedLocationAsset)

Um recurso de local unificado.

AssetType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
YOUTUBE_VIDEO Recurso de vídeo do YouTube.
MEDIA_BUNDLE Recurso do pacote de mídia.
IMAGE Recurso de imagem.
TEXT Recurso de texto.
LEAD_FORM Recurso de formulário de lead.
BOOK_ON_GOOGLE Recurso "Reservas no Google".
PROMOTION Recurso de promoção.
CALLOUT Recurso de frase de destaque.
STRUCTURED_SNIPPET Recurso de snippet estruturado.
PAGE_FEED Recurso do feed de páginas.
DYNAMIC_EDUCATION Recurso de educação dinâmica.
MOBILE_APP Recurso de app para dispositivos móveis.
HOTEL_CALLOUT Recurso de frase de destaque de hotel.
CALL Recurso de ligação.
PRICE Recurso de preço.
CALL_TO_ACTION Recurso de call-to-action.
DYNAMIC_REAL_ESTATE Recurso imobiliário dinâmico.
DYNAMIC_CUSTOM Recurso personalizado dinâmico.
DYNAMIC_HOTELS_AND_RENTALS Recurso de hotéis e aluguéis dinâmico.
DYNAMIC_FLIGHTS Recurso de veiculação dinâmica de voos.
DYNAMIC_TRAVEL Recurso de viagem dinâmico.
DYNAMIC_LOCAL Recurso local dinâmico.
DYNAMIC_JOBS Recurso de tarefas dinâmicas.
LOCATION Recurso de local.
HOTEL_PROPERTY Recurso de propriedade do hotel.

AssetStatus

Os possíveis status de um recurso.

Enums
UNSPECIFIED O status não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta.
ENABLED O recurso está ativado.
REMOVED O recurso é removido.
ARCHIVED O recurso foi arquivado.
PENDING_SYSTEM_GENERATED O recurso foi gerado pelo sistema e está aguardando a revisão do usuário.

AssetEngineStatus

Próximo ID = 11

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
SERVING O recurso está ativo.
SERVING_LIMITED O recurso está limitado.
DISAPPROVED O recurso foi reprovado (não qualificado).
DISABLED O recurso está inativo (pendente).
REMOVED O recurso foi removido.

YoutubeVideoAsset

Um recurso do YouTube.

Representação JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Campos
youtubeVideoTitle

string

Título do vídeo do YouTube.

youtubeVideoId

string

ID do vídeo do YouTube. É o valor de string de 11 caracteres usado no URL do vídeo do YouTube.

ImageAsset

Um recurso de imagem.

Representação JSON
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Campos
mimeType

enum (MimeType)

Tipo MIME do recurso de imagem.

fullSize

object (ImageDimension)

Metadados da imagem no tamanho original.

fileSize

string (int64 format)

Tamanho do arquivo de imagem em bytes.

MimeType

O tipo MIME

Enums
UNSPECIFIED O tipo MIME não foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

IMAGE_JPEG Tipo MIME de image/jpeg.
IMAGE_GIF Tipo MIME de image/gif.
IMAGE_PNG Tipo MIME de image/png.
FLASH Tipo MIME de application/x-shockwave-flash.
TEXT_HTML Tipo MIME de text/html.
PDF Tipo MIME de application/pdf.
MSWORD Tipo MIME de aplicativo/msword.
MSEXCEL Tipo MIME de aplicativo/vnd.ms-excel.
RTF Tipo MIME de application/rtf.
AUDIO_WAV Tipo MIME de áudio/wav.
AUDIO_MP3 Tipo MIME de audio/mp3.
HTML5_AD_ZIP Tipo MIME de application/x-html5-ad-zip.

ImageDimension

Metadados de uma imagem em um determinado tamanho, original ou redimensionada.

Representação JSON
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Campos
heightPixels

string (int64 format)

Altura da imagem.

widthPixels

string (int64 format)

É a largura da imagem.

url

string

Um URL que retorna a imagem com essa altura e largura.

TextAsset

Um recurso de texto.

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

string

Conteúdo de texto do recurso de texto.

UnifiedCalloutAsset

Um recurso de frase de destaque unificado.

Representação JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Campos
calloutText

string

O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos).

startDate

string

Data de início da vigência do recurso e início da veiculação, no formato AAAA-MM-DD.

endDate

string

Última data em que este recurso está em vigor e ainda sendo veiculado, no formato aaaa-mm-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especifica todos os intervalos em que o recurso pode ser veiculado. É possível criar até seis programações por dia, 42 no total.

useSearcherTimeZone

boolean

Indica se o recurso vai ser mostrado no fuso horário do usuário de pesquisa. Válido para o Microsoft Ads.

AdScheduleInfo

Representa um critério de programação de anúncios.

A programação de anúncios é especificada como o dia da semana e um intervalo de tempo em que os anúncios vão ser veiculados.

Não é possível adicionar mais de seis programações de anúncios para o mesmo dia.

Representação JSON
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Campos
startMinute

enum (MinuteOfHour)

Minutos após a hora de início da programação.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

endMinute

enum (MinuteOfHour)

Minutos após o término da programação. A programação é exclusiva do minuto final.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

dayOfWeek

enum (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

integer

Horário de início no formato de 24 horas. Este campo precisa estar entre 0 e 23, inclusive.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

endHour

integer

Hora de término no formato 24 horas, sendo que 24 significa o fim do dia. Este campo precisa estar entre 0 e 24, inclusive.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

MinuteOfHour

Enumera quartos de hora. Por exemplo, "FIFTEEN"

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
ZERO Zero minutos após a hora.
FIFTEEN Quinze minutos após a hora.
THIRTY Trinta minutos após a hora.
FORTY_FIVE Quarenta e cinco minutos após a hora.

DayOfWeek

Enumera os dias da semana, por exemplo, "Segunda-feira".

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
MONDAY Segunda-feira.
TUESDAY Terça-feira.
WEDNESDAY Quarta-feira.
THURSDAY quinta-feira.
FRIDAY Sexta-feira.
SATURDAY sábado.
SUNDAY Domingo.

UnifiedSitelinkAsset

Um recurso de sitelink unificado.

Representação JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Campos
description1

string

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

string

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

string

Data de início da vigência do recurso e início da veiculação, no formato AAAA-MM-DD.

endDate

string

Última data em que este recurso está em vigor e ainda sendo veiculado, no formato aaaa-mm-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Cada dia pode ter no máximo 6 programações, com 42 no total.

trackingId

string (int64 format)

ID usado para rastrear cliques no recurso de sitelink. Esta é uma conta do Yahoo! Campo exclusivo do Japão.

useSearcherTimeZone

boolean

Indica se o recurso de sitelink será mostrado no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads.

mobilePreferred

boolean

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

string

A página da Web que os anunciantes querem segmentar.

labels[]

string

Rótulos usados para agrupar os URLs das páginas.

MobileAppAsset

Um recurso que representa um aplicativo para dispositivos móveis.

Representação JSON
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Campos
appId

string

Obrigatório. Uma string que identifica exclusivamente um app para dispositivos móveis. Ele precisa conter apenas o ID nativo da plataforma, como "com.android.ebay" para Android ou "12345689" para iOS.

appStore

enum (MobileAppVendor)

Obrigatório. A loja de aplicativos que distribui esse app específico.

MobileAppVendor

O tipo de fornecedor de apps para dispositivos móveis

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
APPLE_APP_STORE Fornecedor de apps para dispositivos móveis da Apple App Store.
GOOGLE_APP_STORE Fornecedor de apps para dispositivos móveis para a Google Play Store.

UnifiedCallAsset

Um recurso de ligação unificado.

Representação JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Campos
countryCode

string

Código de país de duas letras do número de telefone. Exemplos: "US", "us".

phoneNumber

string

O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890"

callConversionReportingState

enum (CallConversionReportingState)

Indica se este CallAsset deve usar sua própria configuração de conversões de chamada, seguir a configuração no nível da conta ou desativar a conversão de chamada.

callConversionAction

string

A ação de conversão a que uma conversão de chamada é atribuída. Se não for definido, a ação de conversão padrão será usada. Esse campo só tem efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. É possível criar até seis programações por dia, 42 no total.

callOnly

boolean

Se a chamada mostra apenas o número de telefone sem um link para o site. Válido para o Microsoft Ads.

callTrackingEnabled

boolean

Se a chamada precisa ser ativada no acompanhamento de chamadas. Válido para o Microsoft Ads.

useSearcherTimeZone

boolean

Define se a extensão de chamada vai ser mostrada no fuso horário do usuário de pesquisa. Válido para o Microsoft Ads.

startDate

string

Data de início da vigência do recurso e início da veiculação, no formato AAAA-MM-DD.

endDate

string

Última data de quando este recurso entra em vigor e ainda está sendo veiculado, no formato aaaa-MM-dd.

CallConversionReportingState

Possíveis tipos de dados para um estado de ação de conversão de chamada.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
DISABLED A ação de conversão de chamada está desativada.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION A ação de conversão de chamada usará o tipo de conversão de chamada definido no nível da conta.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION A ação de conversão de chamada vai usar o tipo de conversão de chamada definido no nível do recurso (anúncios só para chamadas/extensões de chamada).

CallToActionAsset

Um recurso de call-to-action.

Representação JSON
{
  "callToAction": enum (CallToActionType)
}
Campos
callToAction

enum (CallToActionType)

Call-to-action.

CallToActionType

Enumeração que descreve possíveis tipos de call-to-action.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
LEARN_MORE O tipo de call-to-action é "Saiba mais".
GET_QUOTE O tipo de call-to-action é "pedir orçamento".
APPLY_NOW O tipo de call-to-action é "Inscrever-se agora".
SIGN_UP O tipo de call-to-action é "Inscrever-se".
CONTACT_US O tipo de call-to-action é "Entre em contato".
SUBSCRIBE O tipo de call-to-action é "Assinar".
DOWNLOAD O tipo de call-to-action é "Fazer o download".
BOOK_NOW O tipo de call-to-action é "Reserve agora".
SHOP_NOW O tipo de call-to-action é "Compre agora".
BUY_NOW O tipo de call-to-action é "Compre agora".
DONATE_NOW O tipo de call-to-action é "Doe agora".
ORDER_NOW O tipo de call-to-action é "Peça agora".
PLAY_NOW O tipo de call-to-action é "ouvir agora".
SEE_MORE O tipo de call-to-action é "Saiba mais".
START_NOW O tipo de call-to-action é "Comece agora".
VISIT_SITE O tipo de call-to-action é "Visite o site".
WATCH_NOW O tipo de call-to-action é "Assistir agora".

UnifiedLocationAsset

Um recurso de local unificado.

Representação JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Campos
placeId

string

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[]

object (BusinessProfileLocation)

A lista de locais comerciais do cliente. Ele só vai ser retornado se o recurso de local estiver sendo sincronizado com a conta do Perfil da Empresa. É possível ter várias fichas na mesma conta que apontam para o mesmo ID de lugar.

locationOwnershipType

enum (LocationOwnershipType)

O tipo de propriedade do local. Se o tipo for BUSINESS_OWNER, ele será veiculado como uma extensão de local. Se o tipo for AFFILIATE, ele será veiculado como um local afiliado.

BusinessProfileLocation

Dados de local do Perfil da Empresa sincronizados da conta vinculada.

Representação JSON
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Campos
labels[]

string

Rótulo especificado pelo anunciante para o local na conta do Perfil da Empresa. Isso é sincronizado com a conta do Perfil da Empresa.

storeCode

string

O código da loja do Perfil da Empresa desse local. Isso é sincronizado com a conta do Perfil da Empresa.

listingId

string (int64 format)

ID da ficha da empresa desse local do Perfil da Empresa. A sincronização é feita pela conta vinculada do Perfil da Empresa.

LocationOwnershipType

Possíveis tipos de propriedade de local.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
BUSINESS_OWNER Proprietário da empresa do local(extensão de local legada - LE).
AFFILIATE Local do afiliado(extensão de local de terceiros: ALE).

AssetGroupAsset

AssetGroupAsset é o vínculo entre um recurso e um grupo de recursos. A adição de um AssetGroupAsset vincula um recurso a um grupo.

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

string

O nome do recurso do grupo de recursos. O nome do recurso do grupo de recursos tem este formato:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

O grupo de recursos a que este recurso está vinculado.

asset

string

O recurso que está vinculado a este grupo de recursos.

fieldType

enum (AssetFieldType)

A descrição da posição do recurso no grupo. Por exemplo: HEADLINE, YOUTUBE_VIDEO etc.

status

enum (AssetLinkStatus)

O status da vinculação entre um recurso e um grupo de recursos.

AssetFieldType

Enumeração que descreve as possíveis posições de um recurso.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
HEADLINE O recurso está vinculado para uso como título.
DESCRIPTION O recurso está vinculado para uso como descrição.
MANDATORY_AD_TEXT O recurso está vinculado para uso como texto obrigatório do anúncio.
MARKETING_IMAGE O recurso está vinculado para uso como imagem de marketing.
MEDIA_BUNDLE O recurso está vinculado para uso como um pacote de mídia.
YOUTUBE_VIDEO O recurso está vinculado para uso como um vídeo do YouTube.
BOOK_ON_GOOGLE O recurso é vinculado para indicar que uma campanha de hotel está com a opção "Reservas no Google" ativada.
LEAD_FORM O recurso está vinculado para uso como uma extensão de formulário de lead.
PROMOTION O recurso está vinculado para ser usado como uma extensão de promoção.
CALLOUT O recurso está vinculado para uso como uma extensão de frase de destaque.
STRUCTURED_SNIPPET O recurso é vinculado para uso como uma extensão de snippet estruturado.
MOBILE_APP O recurso está vinculado para uso como uma extensão de app para dispositivos móveis.
HOTEL_CALLOUT O recurso está vinculado para uso como uma extensão de frase de destaque de hotel.
CALL O recurso está vinculado para uso como uma extensão de chamada.
PRICE O recurso está vinculado para uso como uma extensão de preço.
LONG_HEADLINE O recurso está vinculado para ser usado como um título longo.
BUSINESS_NAME O recurso está vinculado para uso como nome de empresa.
SQUARE_MARKETING_IMAGE O recurso está vinculado para uso como uma imagem de marketing quadrada.
PORTRAIT_MARKETING_IMAGE O recurso está vinculado para uso como uma imagem de marketing em modo retrato.
VIDEO O recurso está vinculado para uso como um logotipo que não é do YouTube.
CALL_TO_ACTION_SELECTION O recurso está vinculado para uso ao selecionar uma call-to-action.
AD_IMAGE O recurso está vinculado para uso na seleção de uma imagem de anúncio.
HOTEL_PROPERTY O recurso é vinculado para uso como uma propriedade de hotel em uma campanha Performance Max para metas de turismo.

AssetGroupSignal

AssetGroupSignal representa um indicador em um grupo de recursos. A existência de um indicador informa à campanha Performance Max quem tem mais chances de fazer uma conversão. A campanha Performance Max usa o indicador para procurar outras pessoas com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais.

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

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Campos
resourceName

string

O nome do recurso do indicador do grupo de recursos. O nome do recurso do indicador do grupo de recursos tem o seguinte formato:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

O grupo de recursos ao qual o indicador pertence.

Campo de união signal. O indicador do grupo de recursos. signal pode ser apenas de um dos tipos a seguir:
audience

object (AudienceInfo)

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

string

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 (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Campos
resourceName

string

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:

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

assetGroup

string

O grupo de recursos ao qual esse filtro pertence.

id

string (int64 format)

O ID do ListingGroupFilter.

type

enum (ListingGroupFilterType)

Tipo de nó de filtro de grupo de produtos anunciados.

vertical

enum (ListingGroupFilterVertical)

A vertical que a árvore de nós atual representa. Todos os nós na mesma árvore precisam pertencer à mesma vertical.

caseValue

object (ListingGroupFilterDimension)

Valor da dimensão com que esse grupo de produtos anunciados está refinando o pai/mãe. Não definido para o grupo raiz.

parentListingGroupFilter

string

Nome do recurso da subdivisão do grupo de listagens pai. Nulo para o nó do filtro do grupo de fichas da empresa raiz.

path

object (ListingGroupFilterDimensionPath)

O caminho das dimensões que definem esse filtro de grupo de fichas.

ListingGroupFilterType

O tipo do filtro do grupo de produtos anunciados.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SUBDIVISION Subdivisão de produtos em algumas dimensões de detalhes.
UNIT_INCLUDED Um nó de folha de filtro de grupo de fichas incluído.
UNIT_EXCLUDED Um nó de folha de filtro do grupo de fichas excluído.

ListingGroupFilterVertical

O tipo da indústria do filtro do grupo de fichas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SHOPPING Representa a vertical de compras. A categoria só é permitida em campanhas Performance Max para varejo.

ListingGroupFilterDimension

Dimensões de listagem para o filtro do grupo de produtos anunciados do grupo de recursos.

Representação JSON
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Campos
Campo de união dimension. A dimensão de um dos tipos abaixo está sempre presente. dimension pode ser apenas de um dos tipos a seguir:
productBiddingCategory

object (ProductBiddingCategory)

Categoria do lance de uma oferta de produto.

productBrand

object (ProductBrand)

Marca de uma oferta de produto.

productChannel

object (ProductChannel)

Localidade de uma oferta de produto.

productCondition

object (ProductCondition)

Condição de uma oferta de produto.

productCustomAttribute

object (ProductCustomAttribute)

Atributo personalizado de uma oferta de produto.

productItemId

object (ProductItemId)

ID do item de uma oferta de produto.

productType

object (ProductType)

Tipo de oferta de produto.

ProductBiddingCategory

Um elemento de uma categoria de lances em um determinado nível. As categorias de nível superior estão no nível 1, as filhas no nível 2 e assim por diante. No momento, oferecemos suporte a até cinco níveis. O usuário precisa especificar um tipo de dimensão que indique o nível da categoria. Todos os casos da mesma subdivisão precisam ter o mesmo tipo de dimensão (nível de categoria).

Representação JSON
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Campos
level

enum (ListingGroupFilterBiddingCategoryLevel)

Indica o nível da categoria na taxonomia.

id

string (int64 format)

ID da categoria de lance do produto.

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

ListingGroupFilterBiddingCategoryLevel

O nível da categoria do lance do filtro do grupo de produtos anunciados.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
LEVEL1 Nível 1.
LEVEL2 Nível 2.
LEVEL3 Nível 3.
LEVEL4 Nível 4.
LEVEL5 Nível 5.

ProductBrand

Marca do produto.

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

string

Valor de string da marca do produto.

ProductChannel

Localidade de uma oferta de produto.

Representação JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Campos
channel

enum (ListingGroupFilterProductChannel)

Valor da localidade.

ListingGroupFilterProductChannel

Enumeração que descreve a localidade de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ONLINE O item é vendido on-line.
LOCAL O item é vendido em lojas locais.

ProductCondition

Condição de uma oferta de produto.

Representação JSON
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Campos
condition

enum (ListingGroupFilterProductCondition)

Valor da condição.

ListingGroupFilterProductCondition

Enumeração que descreve a condição de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
NEW O produto está em bom estado.
REFURBISHED O produto está recondicionado.
USED O estado do produto é "usado".

ProductCustomAttribute

Atributo personalizado de uma oferta de produto.

Representação JSON
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Campos
index

enum (ListingGroupFilterCustomAttributeIndex)

Indica o índice do atributo personalizado.

value

string

Valor de string do atributo personalizado do produto.

ListingGroupFilterCustomAttributeIndex

O índice de atributos do cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
INDEX0 Atributo personalizado do primeiro filtro do grupo de produtos anunciados.
INDEX1 Atributo personalizado do segundo filtro do grupo de produtos anunciados.
INDEX2 Terceiro atributo personalizado do filtro do grupo de produtos anunciados.
INDEX3 Atributo personalizado do filtro do quarto grupo de produtos anunciados.
INDEX4 Quinto atributo personalizado do filtro do grupo de produtos anunciados.

ProductItemId

ID do item de uma oferta de produto.

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

string

Valor do ID.

ProductType

Tipo de oferta de produto.

Representação JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Campos
level

enum (ListingGroupFilterProductTypeLevel)

Nível do tipo.

value

string

Valor do tipo.

ListingGroupFilterProductTypeLevel

Enum que descreve o nível do tipo de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
LEVEL1 Nível 1.
LEVEL2 Nível 2.
LEVEL3 Nível 3.
LEVEL4 Nível 4.
LEVEL5 Nível 5.

ListingGroupFilterDimensionPath

O caminho de definição das dimensões que definem um filtro de grupo de listagens.

Representação JSON
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Campos
dimensions[]

object (ListingGroupFilterDimension)

O caminho completo das dimensões na hierarquia do filtro do grupo de fichas (excluindo o nó raiz) até o filtro desse grupo.

AssetGroupTopCombinationView

Uma visão do uso da combinação de recursos de anúncio do grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Campos
resourceName

string

O nome do recurso da visualização de combinação da parte superior do grupo de recursos. Os nomes dos recursos de visualização de combinação mais usada do grupo de ativos têm o formato: "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

As principais combinações de recursos veiculados juntos.

AssetGroupAssetCombinationData

Dados de combinação de recursos do grupo de recursos

Representação JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Campos
assetCombinationServedAssets[]

object (AssetUsage)

Recursos veiculados.

Uso de recursos

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

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

string

Nome do recurso.

servedAssetFieldType

enum (ServedAssetFieldType)

O tipo de campo veiculado do recurso.

ServedAssetFieldType

Os possíveis tipos de campo de recurso.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

HEADLINE_1 O recurso é usado no título 1.
HEADLINE_2 O recurso é usado no título 2.
HEADLINE_3 O recurso é usado no título 3.
DESCRIPTION_1 O recurso é usado na descrição 1.
DESCRIPTION_2 O recurso é usado na descrição 2.
HEADLINE O recurso foi usado em um título. Use esse campo somente se houver apenas um título no anúncio. Caso contrário, use os tipos enumerados HEADLINE_1, HEADLINE_2 ou HEADLINE_3
HEADLINE_IN_PORTRAIT O recurso foi usado como título na imagem em modo retrato.
LONG_HEADLINE O recurso foi usado em um título longo (usado em MultiAssetResponsiveAd).
DESCRIPTION O recurso foi usado em uma descrição. Use essa opção somente se houver apenas uma descrição no anúncio. Caso contrário, use os tipos enumerados DESCRIPTION_1 ou DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT O recurso foi usado como descrição na imagem em modo retrato.
BUSINESS_NAME_IN_PORTRAIT O recurso foi usado como nome da empresa na imagem em modo retrato.
BUSINESS_NAME O recurso foi usado como nome da empresa.
MARKETING_IMAGE O recurso foi usado como imagem de marketing.
MARKETING_IMAGE_IN_PORTRAIT O recurso foi usado como uma imagem de marketing em modo retrato.
SQUARE_MARKETING_IMAGE O recurso foi usado como uma imagem de marketing quadrada.
PORTRAIT_MARKETING_IMAGE O recurso foi usado como uma imagem de marketing em modo retrato.
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.
CALL Esse recurso é usado como uma chamada.
MOBILE_APP Esse recurso é usado como um app para dispositivos móveis.
CALLOUT Esse recurso é usado como um call-out.
STRUCTURED_SNIPPET Esse recurso é usado como um snippet estruturado.
PRICE Este recurso é usado como um preço.
PROMOTION Este recurso é usado como uma promoção.
AD_IMAGE Esse recurso é usado como uma imagem.
LEAD_FORM O recurso é usado como um formulário de lead.

AssetGroup

Um grupo de recursos. AssetGroupAsset é usado para vincular um recurso ao grupo. O AssetGroupSignal é usado para associar um indicador a um grupo de recursos.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Campos
resourceName

string

O nome do recurso do grupo de recursos. Os nomes dos recursos do grupo de recursos têm o seguinte formato:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

O ID do grupo de recursos.

campaign

string

A campanha associada a esse grupo de recursos. O recurso que está vinculado ao grupo.

name

string

Obrigatório. Nome do grupo de recursos. Obrigatório. Precisa ter no mínimo 1 e no máximo 128 caracteres. Ele precisa ser exclusivo em uma campanha.

finalUrls[]

string

Uma lista de URLs finais após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, os URLs são qualificados para expansão por padrão, a menos que a expansão seja desativada.

finalMobileUrls[]

string

Uma lista de URLs finais para dispositivos móveis após todos os redirecionamentos de vários domínios. Nas campanhas Performance Max, os URLs são qualificados para expansão por padrão, a menos que a expansão seja desativada.

status

enum (AssetGroupStatus)

O status do grupo de recursos.

path1

string

Primeira parte do texto que pode aparecer anexado ao URL exibido no anúncio.

path2

string

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

enum (AdStrength)

Qualidade geral do anúncio desse grupo de recursos.

AssetGroupStatus

Os possíveis status de um grupo de recursos.

Enums
UNSPECIFIED O status não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão.
ENABLED O grupo de recursos está ativado.
PAUSED O grupo de recursos está pausado.
REMOVED O grupo de recursos é removido.

AdStrength

Enum que lista as possíveis qualidades do anúncio.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
PENDING A qualidade do anúncio está pendente.
NO_ADS Não foi possível gerar anúncios.
POOR Baixa qualidade.
AVERAGE Força média.
GOOD Força boa.
EXCELLENT Excelente força.

AssetSetAsset

AssetSetAsset é o vínculo entre um recurso e um conjunto de recursos. Adicionar um AssetSetAsset vincula um recurso a um conjunto de recursos.

Representação JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Campos
resourceName

string

O nome do recurso do conjunto de recursos. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

O conjunto a que o recurso está vinculado.

asset

string

O recurso a que o recurso do conjunto está vinculado.

status

enum (AssetSetAssetStatus)

O status do conjunto de recursos. Somente leitura.

AssetSetAssetStatus

Os possíveis status de um recurso de conjunto de recursos.

Enums
UNSPECIFIED O status não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta.
ENABLED O recurso do conjunto de recursos está ativado.
REMOVED O recurso do conjunto de recursos é removido.

AssetSet

Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso ao conjunto de recursos.

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

string (int64 format)

O ID do conjunto de recursos.

resourceName

string

O nome do recurso do conjunto de recursos. Os nomes dos recursos do conjunto de recursos têm o seguinte formato:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Uma estratégia de lances.

Representação JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

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

string

O nome do recurso da estratégia de lances. Os nomes dos recursos da estratégia de lances têm o seguinte formato:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

É o status da estratégia de lances.

Este campo é somente leitura.

type

enum (BiddingStrategyType)

É o tipo de estratégia de lances. Cria uma estratégia de lances definindo o esquema de lance.

Este campo é somente leitura.

currencyCode

string

A moeda usada pela estratégia de lances (código ISO 4217 de três letras).

Para estratégias de lances em clientes administradores, essa moeda pode ser definida na criação e é padrão para a moeda do cliente administrador. Para clientes de veiculação, esse campo não pode ser definido. Todas as estratégias em um cliente de veiculação usam implicitamente a moeda desse cliente. Em todos os casos, o campo "effectiveCurrencyCode" retorna a moeda usada pela estratégia.

id

string (int64 format)

O ID da estratégia de lances.

name

string

É 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

string

A moeda usada pela estratégia de lances (código de três letras do ISO 4217).

Para estratégias de lances em clientes do Gerenciador, essa é a moeda definida pelo anunciante ao criar a estratégia. Para clientes atendidos, esse é o currencyCode do cliente.

As métricas da estratégia de lances são informadas nessa moeda.

Este campo é somente leitura.

campaignCount

string (int64 format)

O número de campanhas vinculadas a essa estratégia de lances.

Este campo é somente leitura.

nonRemovedCampaignCount

string (int64 format)

O número de campanhas não removidas anexadas a essa estratégia de lances.

Este campo é somente leitura.

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

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

enhancedCpc

object (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 áreas com menor probabilidade.

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

targetCpa

object (TargetCpa)

Uma estratégia de lances que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.

targetImpressionShare

object (TargetImpressionShare)

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

targetOutrankShare

object (TargetOutrankShare)

Uma estratégia de lances que define lances com base na fração de lances de leilões em que o anunciante precisa superar um concorrente específico. Este campo está obsoleto. Não será possível criar uma nova estratégia de lances com esse campo ou anexar estratégias de lances com ele a uma campanha. Mutações para estratégias que já têm esse esquema preenchido são permitidas.

targetRoas

object (TargetRoas)

Uma estratégia de lances que ajuda a maximizar a receita enquanto calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.

targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

Os status possíveis de uma estratégia de lances.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

ENABLED A estratégia de lances está ativada.
REMOVED A estratégia de lances é removida.

BiddingStrategyType

Enumeração que descreve os possíveis tipos de estratégia de lances.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
COMMISSION A comissão é uma estratégia de lances automáticos em que o anunciante paga uma determinada parte do valor da conversão.
ENHANCED_CPC O CPC otimizado é uma estratégia de lances que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques com menor probabilidade.
INVALID Usado apenas para valor de retorno. Indica que uma campanha não tem uma estratégia de lances. Isso impede a veiculação da campanha. Por exemplo, uma campanha pode ser anexada a uma estratégia de lances de administrador e a conta de veiculação é desvinculada da conta de administrador. Nesse caso, a campanha será automaticamente desvinculada da estratégia de lances do gerenciador agora inacessível e vai passar para o tipo INVALID.
MANUAL_CPA Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante.
MANUAL_CPC Lances com base em cliques manuais nos quais o usuário paga por clique.
MANUAL_CPM Lance baseado na impressão manual, no qual o usuário para por mil impressões.
MANUAL_CPV Uma estratégia de lances que paga um valor configurável por exibição de vídeo.
MAXIMIZE_CONVERSIONS Uma estratégia de lances que maximiza automaticamente o número de conversões com um orçamento diário.
MAXIMIZE_CONVERSION_VALUE Uma estratégia de lances automática que define lances automaticamente para maximizar a receita enquanto você gasta seu orçamento.
PAGE_ONE_PROMOTED Esquema de lances promovidos na primeira página, que define lances de CPC máx. para segmentar impressões na primeira página ou nos espaços promovidos da primeira página no google.com. Este valor de tipo enumerado foi descontinuado.
PERCENT_CPC O CPC percentual é uma estratégia de lances em que os lances são uma fração do preço anunciado de um produto ou serviço.
TARGET_CPA O CPA desejado é uma estratégia de lances automática que define lances para ajudar a gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado.
TARGET_CPM O CPM desejado é uma estratégia de lances automática que define lances para gerar o maior número possível de impressões sem exceder o custo por mil impressões (CPM) desejado que você definiu.
TARGET_IMPRESSION_SHARE Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja mostrada na parte de cima da primeira página (ou em outro local segmentado).
TARGET_OUTRANK_SHARE A Parcela de classificação desejada é uma estratégia de lances automática que define lances com base na fração desejada de leilões em que o anunciante precisa superar um concorrente específico. Esse valor de tipo enumerado foi descontinuado.
TARGET_ROAS O ROAS desejado é uma estratégia de lances automatizada que ajuda a maximizar a receita e calcular uma média de retorno do investimento médio (ROAS) desejado.
TARGET_SPEND O gasto desejado é uma estratégia de lances automática que define os lances para conseguir o máximo de cliques possível com o orçamento disponível.

EnhancedCpc

Esse tipo não tem campos.

Uma estratégia de lances automáticos que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques com menor probabilidade.

Essa estratégia de lances foi descontinuada e não pode mais ser criada. Use ManualCpc com EnhancedCpcEnabled definido como verdadeiro para uma funcionalidade equivalente.

MaximizeConversionValue

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

Representação JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Campos
cpcBidCeilingMicros

string (int64 format)

Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável somente para estratégias de lances de portfólio.

cpcBidFloorMicros

string (int64 format)

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

number

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

MaximizeConversions

Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

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

string (int64 format)

Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável somente para estratégias de lances de portfólio.

cpcBidFloorMicros

string (int64 format)

Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Mutável somente para estratégias de lances de portfólio.

targetCpaMicros

string (int64 format)

A opção de custo por ação (CPA) desejado. Esse é o valor médio que você quer gastar por ação de conversão especificada em microunidades da moeda da estratégia de lances. Se definida, a estratégia de lances vai gerar o maior número possível de conversões sem exceder o custo por ação desejado. Se o CPA desejado não estiver definido, a estratégia de lances vai tentar alcançar o menor CPA possível com base no orçamento.

TargetCpa

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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.

TargetImpressionShare

Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja mostrada na parte de cima da primeira página (ou em outro local segmentado).

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

A fração escolhida de anúncios a serem exibidos no local segmentado em micros. Por exemplo, 1% é igual a 10.000.

cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Enumeração que descreve metas possíveis.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ANYWHERE_ON_PAGE Qualquer local na página da Web.
TOP_OF_PAGE Caixa superior de anúncios.
ABSOLUTE_TOP_OF_PAGE Posição superior na caixa superior de anúncios.

TargetOutrankShare

Uma estratégia de lances automáticos que define lances com base na fração desejada de leilões em que o anunciante precisa superar um concorrente específico. Esta estratégia foi descontinuada.

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

string (Int64Value format)

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.

TargetRoas

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

Representação JSON
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Campos
targetRoas

number

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

string (int64 format)

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

string (int64 format)

Limite de lance mínimo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia. Isso só deve ser definido para estratégias de lances de portfólio.

TargetSpend

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

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

string (int64 format)

Descontinuado: é a meta de gastos em que os cliques serão maximizados. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para saber mais.

cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

Um orçamento da campanha.

Representação JSON
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Campos
resourceName

string

O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento da campanha têm o seguinte formato:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

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

enum (BudgetPeriod)

Período em que o orçamento será usado. O padrão será DIÁRIO se não for especificado.

amountMicros

string (int64 format)

É o valor do orçamento, na moeda local da conta. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária. O gasto mensal é limitado a 30,4 vezes esse valor.

BudgetDeliveryMethod

Possíveis métodos de exibição de um orçamento.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
STANDARD O servidor de orçamentos controlará o serviço de forma equilibrada durante todo o período.
ACCELERATED O servidor de orçamento não vai limitar a veiculação, e os anúncios serão veiculados o mais rápido possível.

BudgetPeriod

Período possível de um orçamento.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
DAILY Orçamento diário.
FIXED_DAILY Orçamento diário fixo.
CUSTOM_PERIOD O orçamento personalizado pode ser usado com total_amount para especificar o limite do orçamento vitalício.

Campanha

Uma campanha.

Representação JSON
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Campos
resourceName

string

O nome do recurso da campanha. Os nomes dos recursos de campanha têm o seguinte formato:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

É o status da campanha.

Quando uma nova campanha é adicionada, o status é ATIVADO.

servingStatus

enum (CampaignServingStatus)

O status de veiculação de anúncios da campanha.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

O status do sistema da estratégia de lances da campanha.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

O status da otimização da veiculação de anúncios da campanha.

advertisingChannelType

enum (AdvertisingChannelType)

É a principal meta de veiculação de anúncios na campanha. As opções de segmentação podem ser refinadas em networkSettings.

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

enum (AdvertisingChannelSubType)

Refinamento opcional para advertisingChannelType. Precisa ser um subtipo válido do tipo de canal principal.

Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado.

urlCustomParameters[]

object (CustomParameter)

A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um trackingUrlTemplate, finalUrls ou mobile_final_urls.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Configurações para lances em tempo real, um recurso disponível apenas para campanhas que segmentam a rede do Ad Exchange.

networkSettings

object (NetworkSettings)

As configurações de rede da campanha.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

A configuração para controlar os anúncios dinâmicos de pesquisa (DSA).

shoppingSetting

object (ShoppingSetting)

A configuração para controlar as campanhas do Shopping.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

A configuração de segmentação geográfica de anúncios.

effectiveLabels[]

string

Os nomes dos recursos dos rótulos efetivos anexados a esta campanha. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a essa campanha.

labels[]

string

Os nomes dos recursos dos rótulos anexados a esta campanha.

biddingStrategyType

enum (BiddingStrategyType)

É o tipo de estratégia de lances.

Uma estratégia de lances pode ser criada definindo o esquema de lances para criar uma estratégia de lances padrão ou o campo biddingStrategy para criar uma estratégia de lances de portfólio.

Este campo é somente leitura.

accessibleBiddingStrategy

string

Nome do recurso de Accessible BiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada identificada por "lanceStrategy". Deixar em branco se a campanha não usar uma estratégia de portfólio. Os atributos de estratégia irrestrita estão disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Já os atributos restritos estão disponíveis apenas para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos do recurso BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

Uma lista que limita a frequência com que cada usuário vai ver os anúncios da campanha.

selectiveOptimization

object (SelectiveOptimization)

Configuração de otimização seletiva para essa campanha, que inclui um conjunto de ações de conversão para otimização. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

Configuração da meta de otimização desta campanha, que inclui um conjunto de tipos de meta de otimização.

trackingSetting

object (TrackingSetting)

Configurações no nível da campanha para informações de acompanhamento.

engineId

string

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[]

enum (AssetFieldType)

Os tipos de campo de recurso que devem ser excluídos dessa campanha. Os links de recursos com esses tipos de campo não serão herdados por essa campanha do nível superior.

createTime

string

O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". O createTime será descontinuado na v1. Use creationTime.

creationTime

string

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

string

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

string (int64 format)

O ID da campanha.

name

string

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

string

O modelo de URL para criar um URL de rastreamento.

campaignBudget

string

O nome do recurso do orçamento da campanha.

startDate

string

A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD.

endDate

string

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

string

Sufixo usado para anexar parâmetros de consulta às páginas de destino veiculadas com o acompanhamento paralelo.

urlExpansionOptOut

boolean

Representa a desativação da expansão de URLs para mais URLs segmentados. Se desativada (verdadeiro), apenas os URLs finais no grupo de recursos ou especificados no Google Merchant Center ou nos feeds de dados da empresa do anunciante são segmentados. Se a opção estiver ativada (falso), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "false".

Campo de união campaign_bidding_strategy. A estratégia de lances da campanha.

Precisa ser de portfólio (criado pelo serviço BiddingStrategy) ou padrão, que é incorporado à campanha. campaign_bidding_strategy pode ser apenas de um dos tipos a seguir:

biddingStrategy

string

O nome do recurso da estratégia de lances de portfólio usada pela campanha.

manualCpa

object (ManualCpa)

Estratégia de lances de CPA manual padrão. Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante. Disponível apenas para campanhas de Serviços locais.

manualCpc

object (ManualCpc)

Estratégia de lances manuais padrão de CPC. Lances manuais com base em cliques, em que o usuário paga por clique.

manualCpm

object (ManualCpm)

Estratégia de lances de CPM manual padrão. Lances manuais com base nas impressões em que o usuário paga por mil impressões.

maximizeConversions

object (MaximizeConversions)

A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões sem exceder o orçamento.

maximizeConversionValue

object (MaximizeConversionValue)

Estratégia de lances padrão que maximiza o valor da conversão e define lances automaticamente para maximizar a receita sem exceder o orçamento.

targetCpa

object (TargetCpa)

Estratégia de lances de CPA desejado padrão que define lances automaticamente para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu.

targetImpressionShare

object (TargetImpressionShare)

Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para alcançar uma porcentagem de impressões escolhida.

targetRoas

object (TargetRoas)

Estratégia de lances padrão de ROAS desejado que maximiza automaticamente a receita e calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.

targetSpend

object (TargetSpend)

Estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

percentCpc

object (PercentCpc)

Estratégia de lances de porcentagem padrão de CPC em que os lances são uma fração do preço anunciado de um produto ou serviço.

targetCpm

object (TargetCpm)

Uma estratégia de lances que otimiza automaticamente o custo por mil impressões.

CampaignStatus

Possíveis status de uma campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A campanha está ativa e pode exibir anúncios.
PAUSED A campanha foi pausada pelo usuário.
REMOVED A campanha foi removida.

CampaignServingStatus

Possíveis status de veiculação de uma campanha.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

SERVING Veiculação.
NONE Nenhum.
ENDED Finalizado.
PENDING Pendente.
SUSPENDED Suspenso.

BiddingStrategySystemStatus

Os possíveis status do sistema de uma estratégia de lances.

Enums
UNSPECIFIED Indica que ocorreu um erro inesperado, por exemplo, nenhum tipo de estratégia de lances foi encontrado ou nenhuma informação de status foi encontrada.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A estratégia de lances está ativa, e o Google AdWords não encontrou nenhum problema específico com a estratégia.
LEARNING_NEW A estratégia de lances está aprendendo porque foi criada ou reativada recentemente.
LEARNING_SETTING_CHANGE A estratégia de lances está aprendendo por causa de uma mudança recente na configuração.
LEARNING_BUDGET_CHANGE A estratégia de lances está em processo de aprendizado devido a uma mudança recente no orçamento.
LEARNING_COMPOSITION_CHANGE A estratégia de lances está aprendendo devido a uma mudança recente no número de campanhas, grupos de anúncios ou palavras-chave associadas a ela.
LEARNING_CONVERSION_TYPE_CHANGE A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão relevantes para a estratégia que o cliente modificou recentemente.
LEARNING_CONVERSION_SETTING_CHANGE A estratégia de lances depende dos relatórios de conversão, e o cliente alterou as configurações de conversão recentemente.
LIMITED_BY_CPC_BID_CEILING A estratégia de lances é limitada pelo teto de lances.
LIMITED_BY_CPC_BID_FLOOR A estratégia de lances é limitada pelo lance mínimo.
LIMITED_BY_DATA A estratégia de lances está limitada porque não houve tráfego de conversão suficiente nas últimas semanas.
LIMITED_BY_BUDGET Uma parte significativa das palavras-chave nessa estratégia de lances está limitada pelo orçamento.
LIMITED_BY_LOW_PRIORITY_SPEND A estratégia de lances não consegue atingir o gasto desejado porque a prioridade dele foi removida.
LIMITED_BY_LOW_QUALITY Uma parte significativa das palavras-chave nessa estratégia de lances tem um Índice de qualidade baixo.
LIMITED_BY_INVENTORY A estratégia de lances não pode gastar todo o orçamento devido à segmentação restrita.
MISCONFIGURED_ZERO_ELIGIBILITY Acompanhamento de conversões ausente (sem pings) e/ou listas de remarketing para a SSC.
MISCONFIGURED_CONVERSION_TYPES A estratégia de lances depende dos relatórios de conversão, e o cliente não tem os tipos de conversão que podem ser incluídos nos relatórios dessa estratégia.
MISCONFIGURED_CONVERSION_SETTINGS A estratégia de lances depende dos relatórios de conversão, e as configurações de conversão do cliente estão incorretas.
MISCONFIGURED_SHARED_BUDGET Há campanhas fora da estratégia de lances que compartilham orçamentos com as campanhas incluídas na estratégia.
MISCONFIGURED_STRATEGY_TYPE A campanha tem um tipo de estratégia inválido e não está sendo veiculada.
PAUSED A estratégia de lances não está ativa. Não há campanhas, grupos de anúncios ou palavras-chave ativas vinculadas à estratégia de lances. Ou não há orçamentos ativos conectados à estratégia de lances.
UNAVAILABLE No momento, essa estratégia de lances não é compatível com relatórios de status.
MULTIPLE_LEARNING Houve vários status do sistema LEARNING_* para essa estratégia de lances durante o período em questão.
MULTIPLE_LIMITED Houve vários status LIMITED_* do sistema para essa estratégia de lances durante o período em questão.
MULTIPLE_MISCONFIGURED Havia vários status de sistema MISCONFIGURED_* para essa estratégia de lances durante o período em questão.
MULTIPLE Houve vários status do sistema para essa estratégia de lances durante o período em questão.

AdServingOptimizationStatus

Enumeração que descreve possíveis status de veiculação.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

OPTIMIZE A veiculação de anúncios é otimizada com base na CTR da campanha.
CONVERSION_OPTIMIZE A veiculação de anúncios é otimizada com base na CTR * conversão da campanha. Se a campanha não estiver na estratégia de lances do Otimizador de conversões, o padrão será "OTIMIZADO".
ROTATE Os anúncios são alternados de forma uniforme por 90 dias e, em seguida, otimizados para cliques.
ROTATE_INDEFINITELY Mostrar anúncios com desempenho inferior de maneira mais uniforme com anúncios de desempenho superior e não otimizar.
UNAVAILABLE O status de otimização do serviço de anúncios não está disponível.

AdvertisingChannelType

Enum que descreve os vários tipos de canais de publicidade.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SEARCH Rede de pesquisa. Inclui campanhas de display agrupadas e de pesquisa+.
DISPLAY Somente na Rede de Display do Google.
SHOPPING As campanhas do Shopping são veiculadas na propriedade do Shopping e nos resultados da pesquisa do google.com.br.
HOTEL Campanhas de anúncios de hotéis.
VIDEO Campanhas de vídeo.
MULTI_CHANNEL campanhas de apps e campanhas de apps para engajamento, que são exibidas em vários canais.
LOCAL Campanhas de anúncios locais.
SMART Campanhas inteligentes.
PERFORMANCE_MAX campanhas Performance Max.
LOCAL_SERVICES Campanhas de serviços locais.
DISCOVERY Campanhas Discovery.
TRAVEL Campanhas de viagens.
SOCIAL Campanhas sociais.

AdvertisingChannelSubType

Enumeração que descreve os diferentes subtipos de canal.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas como um valor de retorno. Representa um valor desconhecido nesta versão.
SEARCH_MOBILE_APP Campanhas de apps para dispositivos móveis na Pesquisa.
DISPLAY_MOBILE_APP campanhas de apps para dispositivos móveis da Rede de Display.
SEARCH_EXPRESS Campanhas Express do Google Ads para pesquisa.
DISPLAY_EXPRESS Campanhas do AdWords Express para display.
SHOPPING_SMART_ADS Campanhas inteligentes do Shopping.
DISPLAY_GMAIL_AD Campanhas publicitárias do Gmail.
DISPLAY_SMART_CAMPAIGN Campanhas inteligentes da Rede de Display: Não é possível criar novas campanhas desse subtipo.
VIDEO_OUTSTREAM Campanhas de vídeo out-stream.
VIDEO_ACTION Campanhas TrueView for Action de vídeo.
VIDEO_NON_SKIPPABLE Campanhas de vídeo com anúncios em vídeo não puláveis.
APP_CAMPAIGN Campanha para apps que permite promover seu app Android ou iOS nos principais serviços do Google, incluindo a Pesquisa, o Google Play, o YouTube e a Rede de Display.
APP_CAMPAIGN_FOR_ENGAGEMENT Campanha para apps para engajamento, focada em gerar mais engajamento com o app em várias das principais propriedades do Google, incluindo a Pesquisa, o YouTube e a Rede de Display.
LOCAL_CAMPAIGN Campanhas especializadas em publicidade local.
SHOPPING_COMPARISON_LISTING_ADS Campanhas de lista de comparação do Shopping.
SMART_CAMPAIGN Campanhas inteligentes padrão.
VIDEO_SEQUENCE Campanhas de vídeo com anúncios em vídeo em sequência.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campanha de apps para pré-registro, especializada para anunciar o pré-registro de apps para dispositivos móveis, que segmenta vários canais de publicidade no Google Play, no YouTube e na Rede de Display.
VIDEO_REACH_TARGET_FREQUENCY Campanha de alcance de vídeo com a estratégia de lances de frequência desejada.
TRAVEL_ACTIVITIES campanhas de atividades de viagem.
SOCIAL_FACEBOOK_TRACKING_ONLY O rastreamento do Facebook só é feito em campanhas sociais.

CustomParameter

Um mapeamento que pode ser usado por tags de parâmetros personalizados em um trackingUrlTemplate, finalUrls ou mobile_final_urls.

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

string

A chave que corresponde ao nome da tag de parâmetro.

value

string

O valor a ser substituído.

RealTimeBiddingSetting

Configurações para lances em tempo real, um recurso disponível apenas para campanhas que segmentam a rede do Ad Exchange.

Representação JSON
{
  "optIn": boolean
}
Campos
optIn

boolean

Indica se a campanha está ativada para lances em tempo real.

NetworkSettings

As configurações de rede da campanha.

Representação JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Campos
targetSearchNetwork

boolean

Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que targetGoogleSearch também seja true).

targetContentNetwork

boolean

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

boolean

Indica se os anúncios serão veiculados na rede de parceiros do Google. Esse recurso está disponível apenas para algumas contas de parceiros do Google selecionadas.

DynamicSearchAdsSetting

A configuração para controlar os anúncios dinâmicos de pesquisa (DSA).

Representação JSON
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Campos
domainName

string

Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com".

languageCode

string

Obrigatório. O código do idioma que especifica o idioma do domínio, por exemplo, "en".

useSuppliedUrlsOnly

boolean

Indica se a campanha usa exclusivamente URLs fornecidos pelo anunciante.

ShoppingSetting

A configuração das campanhas do Shopping. Define o universo de produtos que podem ser anunciados pela campanha e como ela interage com outras campanhas do Shopping.

Representação JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Campos
feedLabel

string

Rótulo do feed de produtos a serem incluídos na campanha. Só é possível definir um dos dois campos "feedLabel" ou "salesCountry". Se usado em vez de "salesCountry", o campo "feedLabel" aceita códigos de país no mesmo formato, por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center.

useVehicleInventory

boolean

Indica se o inventário de listagem de veículos será segmentado.

merchantId

string (int64 format)

ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo é imutável para campanhas do Shopping.

salesCountry

string

País de venda dos produtos a serem incluídos na campanha.

campaignPriority

integer

Prioridade da campanha. As campanhas com prioridades numericamente maiores têm precedência sobre as com prioridades mais baixas. Esse campo é obrigatório para campanhas do Shopping, com valores entre 0 e 2. Esse campo é opcional para campanhas inteligentes do Shopping, mas precisa ser igual a 3 se definido.

enableLocal

boolean

Se os produtos locais serão incluídos.

GeoTargetTypeSetting

Representa um conjunto de configurações relacionadas à segmentação geográfica de anúncios.

Representação JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Campos
positiveGeoTargetType

enum (PositiveGeoTargetType)

A configuração usada para a segmentação geográfica positiva nessa campanha específica.

negativeGeoTargetType

enum (NegativeGeoTargetType)

A configuração usada para a segmentação geográfica negativa nessa campanha específica.

PositiveGeoTargetType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
PRESENCE_OR_INTEREST Especifica que um anúncio é acionado se o usuário está ou demonstra interesse nos locais segmentados do anunciante.
SEARCH_INTEREST Especifica que um anúncio é acionado se o usuário pesquisar os locais segmentados do anunciante. Esse recurso só pode ser usado com campanhas de pesquisa e padrão do Shopping.
PRESENCE Especifica que um anúncio será acionado se o usuário estiver na região de segmentação do anunciante ou regularmente nessas regiões.

NegativeGeoTargetType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
PRESENCE_OR_INTEREST Especifica que um usuário não vai receber o anúncio se estiver em um local excluído do anunciante ou demonstrar interesse por ele.
PRESENCE Especifica que um usuário não vai ver o anúncio se estiver em locais excluídos do anunciante.

FrequencyCapEntry

Esse tipo não tem campos.

Uma regra que especifica o número máximo de vezes que um anúncio (ou algum conjunto de anúncios) pode ser exibido para um usuário em um determinado período.

SelectiveOptimization

Configuração de otimização seletiva desta campanha, que inclui um conjunto de ações de conversão que serão otimizadas. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

Representação JSON
{
  "conversionActions": [
    string
  ]
}
Campos
conversionActions[]

string

Conjunto selecionado de nomes de recursos para ações de conversão para otimizar esta campanha.

OptimizationGoalSetting

Configuração da meta de otimização para essa campanha, que inclui um conjunto de tipos de meta de otimização.

Representação JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Campos
optimizationGoalTypes[]

enum (OptimizationGoalType)

A lista de tipos de meta de otimização.

OptimizationGoalType

O tipo de meta de otimização

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas como um valor de retorno. Representa um valor desconhecido nesta versão.
CALL_CLICKS Otimizar para cliques em botões de chamada. As conversões de cliques em ligações são as vezes que as pessoas selecionaram "Ligar" para entrar em contato com uma loja depois de visualizar um anúncio.
DRIVING_DIRECTIONS Otimizar para rotas de carro. As conversões de direções para chegar de carro são as vezes que as pessoas selecionaram "Como chegar" para ir a uma loja depois de ver um anúncio.
APP_PRE_REGISTRATION Otimizar para pré-registro. As conversões de pré-registro são o número de inscrições para receber uma notificação quando o app for lançado.

TrackingSetting

Configurações no nível da campanha para informações de acompanhamento.

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

string

O URL usado para o acompanhamento dinâmico.

ManualCpa

Esse tipo não tem campos.

Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante.

ManualCpc

Lances manuais com base no clique, em que o usuário paga por clique.

Representação JSON
{
  "enhancedCpcEnabled": boolean
}
Campos
enhancedCpcEnabled

boolean

Indica se os lances devem ser otimizados com base nos dados do otimizador de conversões.

ManualCpm

Esse tipo não tem campos.

Lances manuais com base nas impressões em que o usuário paga por mil impressões.

PercentCpc

Uma estratégia de lances em que os lances são uma fração do preço anunciado de um produto ou serviço.

Representação JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Campos
cpcBidCeilingMicros

string (int64 format)

Limite de lance máximo que pode ser definido pela estratégia de lances. É um campo opcional inserido pelo anunciante e especificado nos micros locais. Observação: um valor zero é interpretado da mesma forma que um bid_ceiling indefinido.

enhancedCpcEnabled

boolean

Ajusta o lance para cada leilão para cima ou para baixo, dependendo da probabilidade de uma conversão. Os lances individuais podem exceder cpcBidCeuringMicros, mas o valor médio do lance de uma campanha não deve.

TargetCpm

Esse tipo não tem campos.

O CPM desejado (custo por mil impressões) é uma estratégia de lances automática que define lances para otimizar a performance com base no CPM desejado.

CampaignAsset

Uma vinculação entre uma campanha e um recurso.

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

string

O nome do recurso da campanha. Os nomes dos recursos de CampaignAsset têm o seguinte formato:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

Status do recurso da campanha.

campaign

string

A campanha à qual o recurso está vinculado.

asset

string

O recurso que está vinculado à campanha.

CampaignAssetSet

O CampaignAssetSet é a vinculação entre uma campanha e um conjunto de recursos. A adição de um CampaignAssetSet vincula um conjunto de recursos a uma campanha.

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

string

O nome do recurso do grupo de recursos da campanha. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

A campanha a que este conjunto de recursos está vinculado.

assetSet

string

O conjunto de recursos vinculado à campanha.

status

enum (AssetSetLinkStatus)

O status do recurso do conjunto de recursos da campanha. Somente leitura.

CampaignAudienceView

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

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

string

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

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

CampaignCriterion

Um critério de campanha.

Representação JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

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

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

O nome de exibição do critério.

Este campo é ignorado para mutações.

type

enum (CriterionType)

Tipo do critério.

status

enum (CampaignCriterionStatus)

O status do critério.

lastModifiedTime

string

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

string (int64 format)

ID do critério.

Este campo é ignorado durante a modificação.

bidModifier

number

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

boolean

Indica se o critério será segmentado (false) ou excluído (true).

Campo de união criterion. O critério da campanha.

Exatamente um deve ser definido. criterion pode ser apenas de um dos tipos a seguir:

keyword

object (KeywordInfo)

Palavra-chave.

location

object (LocationInfo)

Local.

device

object (DeviceInfo)

Dispositivo.

ageRange

object (AgeRangeInfo)

Faixa etária.

gender

object (GenderInfo)

Gênero.

userList

object (UserListInfo)

Lista de usuários.

language

object (LanguageInfo)

e linguagem Hashicorp.

webpage

object (WebpageInfo)

página da Web.

locationGroup

object (LocationGroupInfo)

Grupo por locais

CampaignCriterionStatus

Os status possíveis de um CampaignCritério.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

ENABLED O critério da campanha está ativado.
PAUSED O critério da campanha está pausado.
REMOVED O critério da campanha é removido.

LanguageInfo

Um critério de idioma.

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

string

O nome do recurso da constante de idioma.

LocationGroupInfo

Um raio em torno de uma lista de locais especificados em um feed.

Representação JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Campos
geoTargetConstants[]

string

Constantes de segmentação por área geográfica que restringem o escopo da área geográfica no feed. No momento, só é permitida uma constante de segmentação geográfica.

radiusUnits

enum (LocationGroupRadiusUnits)

Unidade do raio. Milhas e metros são aceitos para constantes de segmentação por área geográfica. Os milissegundos e metros são aceitos para conjuntos de itens do feed. Isso é obrigatório e precisa ser definido em operações CREATE.

feedItemSets[]

string

São os itens de grupo com os quais os itens de feed são segmentados. Se vários IDs forem especificados, todos os itens que aparecerem em pelo menos um conjunto serão segmentados. Esse campo não pode ser usado com geoTargetConstants. Esse campo é opcional e só pode ser definido em operações CREATE.

radius

string (int64 format)

Distância em unidades que especifica o raio em torno das regiões de segmentação. Isso é obrigatório e deve ser definido nas operações CREATE.

LocationGroupRadiusUnits

A unidade de distância do raio no grupo por local (por exemplo, MILHAS)

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
METERS Metros
MILES Milhas
MILLI_MILES Milli Miles

CampaignEffectiveLabel

Representa uma relação entre uma campanha e um rótulo eficaz. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a essa campanha.

Representação JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nome do recurso. Os nomes dos recursos do CampaignEffectivelabel têm o seguinte formato: customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

A campanha à qual o rótulo efetivo está anexado.

label

string

O rótulo efetivo atribuído à campanha.

ownerCustomerId

string (int64 format)

O ID do Cliente proprietário do rótulo em vigor.

CampaignLabel

Representa um relacionamento entre uma campanha e um rótulo.

Representação JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nome do recurso. Os nomes dos recursos de rótulo de campanha têm o formato: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

A campanha a que o rótulo está anexado.

label

string

Rótulo atribuído à campanha.

ownerCustomerId

string (int64 format)

O ID do cliente proprietário do rótulo.

CartDataSalesView

Visualização de vendas de dados do carrinho.

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

string

O nome do recurso da visualização de vendas de dados do carrinho. Os nomes dos recursos da visualização de vendas de dados do carrinho têm o formato: customers/{customerId}/cartDataSalesView

Público-alvo

O público-alvo é uma opção de segmentação eficaz que permite cruzar diferentes atributos de segmentos, como informações demográficas e afinidades detalhadas, para criar públicos-alvo que representam seções dos seus segmentos.

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

string

O nome do recurso do público-alvo. Os nomes de público-alvo têm o seguinte formato:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID do público-alvo.

name

string

Obrigatório. Nome do público-alvo. Ele precisa ser exclusivo em todos os públicos-alvo. Precisa ter no mínimo 1 e no máximo 255 caracteres.

description

string

Descrição desse público-alvo.

ConversionAction

Uma ação de conversão

Representação JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Campos
resourceName

string

O nome do recurso da ação de conversão. Os nomes dos recursos de ações de conversão têm o seguinte formato:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Carimbo de data/hora da criação da atividade do Floodlight, formatado em ISO 8601.

status

enum (ConversionActionStatus)

É o status desta ação de conversão para acúmulo de eventos de conversão.

type

enum (ConversionActionType)

O tipo dessa ação de conversão.

category

enum (ConversionActionCategory)

A categoria de conversões informada para essa ação.

valueSettings

object (ValueSettings)

Configurações relacionadas ao valor dos eventos de conversão associados a essa ação de conversão.

attributionModelSettings

object (AttributionModelSettings)

Configurações relacionadas ao modelo de atribuição da ação de conversão.

floodlightSettings

object (FloodlightSettings)

Configurações do Floodlight para tipos de conversão do Floodlight.

id

string (int64 format)

O ID da ação de conversão.

name

string

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

boolean

Se o bit primaryForGoal de uma ação de conversão for falso, ela não poderá receber lances para todas as campanhas, independentemente da meta de conversão do cliente ou da meta de conversão da campanha. No entanto, as metas de conversão personalizadas não respeitam a propriedade "primaryForGoal". Portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão "primaryForGoal = false", essa ação de conversão ainda poderá receber lances. Por padrão, primaryForGoal será "true" se não for definido. Na V9, o atributo primaryForGoal só pode ser definido como "false" após a criação por uma operação de "update" porque ele não é declarado como opcional.

ownerCustomer

string

O nome do recurso do cliente proprietário da ação de conversão ou nulo se essa for uma ação de conversão definida pelo sistema.

includeInClientAccountConversionsMetric

boolean

Indica se essa ação de conversão precisa ser incluída na métrica "clientAccountConversions".

includeInConversionsMetric

boolean

Se essa ação de conversão precisa ser incluída na métrica "conversões".

clickThroughLookbackWindowDays

string (int64 format)

É o número máximo de dias que pode transcorrer entre uma interação (por exemplo, um clique) e um evento de conversão.

appId

string

ID do app para uma ação de conversão de app.

ConversionActionStatus

Possíveis status de uma ação de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED As conversões serão registradas.
REMOVED As conversões não serão registradas.
HIDDEN As conversões não serão registradas, e a ação de conversão não vai aparecer na interface.

ConversionActionType

Possíveis tipos de uma ação de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AD_CALL Conversões que ocorrem quando um usuário clica na extensão de chamada de um anúncio.
CLICK_TO_CALL Conversões que ocorrem quando um usuário em um dispositivo móvel clica em um número de telefone.
GOOGLE_PLAY_DOWNLOAD Conversões que ocorrem quando um usuário faz o download de um app para dispositivos móveis na Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversões que ocorrem quando um usuário faz uma compra em um app usando o Faturamento do Android.
UPLOAD_CALLS As conversões de chamada que são acompanhadas pelo anunciante e enviadas.
UPLOAD_CLICKS Conversões que são rastreadas pelo anunciante e enviadas com cliques atribuídos.
WEBPAGE Conversões que ocorrem em uma página da Web.
WEBSITE_CALL Conversões que ocorrem quando um usuário liga para um número de telefone gerado dinamicamente no site de um anunciante.
STORE_SALES_DIRECT_UPLOAD Conversão de vendas na loja com base em uploads de dados próprios ou de comerciantes de terceiros. Somente os clientes na lista de permissões podem usar os tipos de upload direto de vendas na loja.
STORE_SALES Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros do comerciante e/ou de compras na loja usando cartões de redes de pagamento. Somente os clientes na lista de permissões podem usar os tipos de vendas na loja. Somente leitura.
FIREBASE_ANDROID_FIRST_OPEN Conversões de primeiro acesso do app Android acompanhadas com o Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversões de compras no app de apps Android acompanhadas pelo Firebase.
FIREBASE_ANDROID_CUSTOM Conversões personalizadas de apps Android acompanhadas com o Firebase.
FIREBASE_IOS_FIRST_OPEN Conversões de primeiro acesso do app iOS acompanhadas pelo Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversões de compras no app de um app iOS rastreadas pelo Firebase.
FIREBASE_IOS_CUSTOM Conversões personalizadas de apps iOS acompanhadas com o Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversões de primeiro acesso de apps Android acompanhadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversões de compras no app Android acompanhadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversões personalizadas de apps Android acompanhadas pela análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversões de primeiro acesso de apps iOS rastreadas pela análise de apps de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversões de compra no aplicativo no aplicativo iOS acompanhadas por meio da análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversões personalizadas de apps para iOS rastreadas usando a análise de apps de terceiros.
ANDROID_APP_PRE_REGISTRATION Conversões que ocorrem quando um usuário faz o pré-registro de um aplicativo para dispositivos móveis na Google Play Store. Somente leitura.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversões que acompanham todos os downloads do Google Play que não são rastreados por um tipo específico de app. Somente leitura.
FLOODLIGHT_ACTION Atividade do Floodlight que conta o número de vezes que os usuários visitaram uma página da Web específica após ver ou clicar em um dos anúncios de um anunciante. Somente leitura.
FLOODLIGHT_TRANSACTION Atividade do Floodlight que rastreia o número de vendas realizadas ou o número de itens comprados. Também é possível capturar o valor total de cada venda. Somente leitura.
GOOGLE_HOSTED Conversões que acompanham ações locais de produtos e serviços do Google depois de interagir com um anúncio. Somente leitura.
LEAD_FORM_SUBMIT Conversões informadas quando um usuário envia um formulário de lead. Somente leitura.
SALESFORCE Conversões que vêm do Salesforce. Somente leitura.
SEARCH_ADS_360 Conversões importadas dos dados do Floodlight do Search Ads 360. Somente leitura.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL As conversões de chamada que ocorrem em anúncios de campanhas inteligentes sem a configuração do acompanhamento de chamadas usando os critérios personalizados das campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL O usuário clica em um elemento de chamada no Google Maps. Apenas campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_MAP_DIRECTIONS O usuário solicita rotas para um local da empresa no Google Maps. Apenas para campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_TRACKED_CALLS As conversões de chamada que ocorrem em anúncios de campanhas inteligentes com configuração de acompanhamento de chamadas usando critérios personalizados. Somente leitura.
STORE_VISITS Conversões que ocorrem quando um usuário visita a loja de varejo de um anunciante. Somente leitura.
WEBPAGE_CODELESS Conversões criadas a partir de eventos do site (como envios de formulários ou carregamentos de página) que não usam snippets de eventos codificados individualmente. Somente leitura.
UNIVERSAL_ANALYTICS_GOAL Conversões provenientes de metas vinculadas do Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Conversões que vêm de transações vinculadas do Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM Conversões que vêm de eventos personalizados vinculados do Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE Conversões que vêm das conversões de compra vinculadas do Google Analytics 4.

ConversionActionCategory

A categoria de conversões associadas a uma ConversionAction.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
DEFAULT Categoria padrão.
PAGE_VIEW Usuário acessando uma página.
PURCHASE Evento de compra, vendas ou "pedido feito".
SIGNUP Ação do usuário de inscrição.
LEAD Ação de geração de leads.
DOWNLOAD Ação de download de software (como para um app).
ADD_TO_CART Adição de itens a um carrinho de compras ou sacola no site de um anunciante.
BEGIN_CHECKOUT Quando alguém inicia o fluxo de finalização de compra no site de um anunciante.
SUBSCRIBE_PAID O início de uma assinatura paga de um produto ou serviço.
PHONE_CALL_LEAD Uma chamada para indicar interesse na oferta de um anunciante.
IMPORTED_LEAD Uma conversão de lead importada de uma fonte externa para o Google Ads.
SUBMIT_LEAD_FORM O envio de um formulário em um site do anunciante indicando interesse comercial.
BOOK_APPOINTMENT O agendamento de um horário com a empresa de um anunciante.
REQUEST_QUOTE Uma solicitação de cotação ou estimativa de preço.
GET_DIRECTIONS Uma pesquisa pelo local da empresa de um anunciante com a intenção de visitar.
OUTBOUND_CLICK Um clique para acessar o site do parceiro de um anunciante.
CONTACT Uma chamada, SMS, e-mail, chat ou outro tipo de contato com um anunciante.
ENGAGEMENT Um evento de engajamento no site, como tempo de permanência no site ou uma meta inteligente do Google Analytics (GA). Destinado a ser usado para importações de metas do GA, Firebase e GA Gold.
STORE_VISIT Uma visita a uma loja física.
STORE_SALE Uma venda que ocorre em uma loja física.
QUALIFIED_LEAD Uma conversão de lead importada de uma fonte externa para o Google Ads, que foi qualificada pelo anunciante (equipe de marketing/vendas). Na jornada de lead a venda, os anunciantes recebem leads e, em seguida, entram em contato com o consumidor. Se o consumidor tiver interesse e puder comprar o produto dele, o anunciante vai marcar esses leads como "leads qualificados".
CONVERTED_LEAD Uma conversão de lead importada de uma fonte externa para o Google Ads que concluiu uma etapa escolhida conforme definido pelo anunciante de geração de leads.

ValueSettings

Configurações relacionadas ao valor dos eventos de conversão associados a essa ação.

Representação JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Campos
defaultValue

number

O valor a ser usado quando os eventos dessa ação de conversão forem enviados com um valor inválido, não permitido ou ausente, ou quando essa ação de conversão estiver configurada para usar sempre o valor padrão.

defaultCurrencyCode

string

O código da moeda a ser usado quando os eventos de conversão dessa ação forem enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão estiver configurada para sempre usar o valor padrão.

alwaysUseDefaultValue

boolean

Controla se o valor padrão e o código de moeda padrão são usados no lugar do valor e do código de moeda especificados nos eventos de conversão para essa ação de conversão.

AttributionModelSettings

Configurações relacionadas ao modelo de atribuição da ação de conversão.

Representação JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Campos
attributionModel

enum (AttributionModel)

O tipo de modelo de atribuição dessa ação de conversão.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

O status do modelo de atribuição baseada em dados para a ação de conversão.

AttributionModel

O modelo de atribuição que descreve como distribuir o crédito de uma conversão específica entre muitas interações anteriores.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
EXTERNAL Usa atribuição externa.
GOOGLE_ADS_LAST_CLICK Atribui todo o crédito de uma conversão ao último clique.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Atribui todo o crédito de uma conversão ao primeiro clique usando a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Atribui o crédito de uma conversão igualmente a todos os cliques usando a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Atribui exponencialmente mais crédito de uma conversão aos cliques mais recentes usando a atribuição da Pesquisa Google (metade da vida útil é de uma semana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Atribui 40% do crédito de uma conversão ao primeiro e ao último clique. Os 20% restantes serão distribuídos de maneira uniforme entre todos os outros cliques. Essa opção usa a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Modelo flexível que usa o aprendizado de máquina para determinar a distribuição adequada de crédito entre os cliques usando a atribuição da Pesquisa Google.

DataDrivenModelStatus

Enumera os status do modelo baseado em dados.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AVAILABLE O modelo baseado em dados está disponível.
STALE O modelo baseado em dados está desatualizado. Ele não foi atualizado há pelo menos sete dias. Ele ainda está em uso, mas vai expirar se não for atualizado em 30 dias.
EXPIRED O modelo baseado em dados expirou. Ele não foi atualizado há pelo menos 30 dias e não pode ser usado. Isso geralmente acontece porque não houve o número necessário de eventos em um período recente de 30 dias.
NEVER_GENERATED O modelo baseado em dados nunca foi gerado. Isso geralmente acontece porque nunca houve o número necessário de eventos em um período de 30 dias.

FloodlightSettings

Configurações relacionadas a uma ação de conversão do Floodlight.

Representação JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Campos
activityGroupTag

string

String usada para identificar um grupo de atividades do Floodlight ao registrar as conversões.

activityTag

string

String usada para identificar uma atividade do Floodlight ao registrar conversões.

activityId

string (int64 format)

ID da atividade do Floodlight no DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Uma variável personalizada de conversão. Consulte "Sobre dimensões e métricas personalizadas do Floodlight no novo Search Ads 360" em https://support.google.com/sa360/answer/13567857.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Campos
resourceName

string

O nome do recurso da variável personalizada de conversão. Os nomes dos recursos de variáveis personalizadas de conversão têm o seguinte formato:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

O ID da variável personalizada de conversão.

name

string

Obrigatório. O nome da variável personalizada de conversão. O nome precisa ser exclusivo. O nome pode ter até 100 caracteres. Não deve haver espaços extras antes e depois.

tag

string

Obrigatório. A tag da variável personalizada de conversão. A tag precisa ser exclusiva e consistir em um caractere "u" seguido diretamente por um número menor ou igual a 100. Por exemplo: "u4".

status

enum (ConversionCustomVariableStatus)

O status da variável personalizada de conversão para o acúmulo de eventos de conversão.

ownerCustomer

string

O nome do recurso do cliente que é proprietário da variável personalizada de conversão.

family

enum (ConversionCustomVariableFamily)

Família da variável personalizada de conversão.

cardinality

enum (ConversionCustomVariableCardinality)

Cardinalidade da variável personalizada de conversão.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Campos para variáveis personalizadas de conversão do Floodlight no Search Ads 360.

customColumnIds[]

string (int64 format)

Os IDs das colunas personalizadas que usam essa variável personalizada de conversão.

ConversionCustomVariableStatus

Status possíveis de uma variável personalizada de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ACTIVATION_NEEDED

A ativação da variável personalizada de conversão está pendente e não acumulará estatísticas até ser definida como ATIVADO.

Esse status não pode ser usado em solicitações CREATE e UPDATE.

ENABLED A variável personalizada de conversão é ativada e acumula estatísticas.
PAUSED A variável personalizada de conversão é pausada e não acumula estatísticas até ser definida como ATIVADA novamente.

ConversionCustomVariableFamily

Família de uma variável personalizada de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
STANDARD A variável personalizada de conversão padrão. Os clientes precisam fazer a ativação antes do uso.
FLOODLIGHT A variável personalizada de conversão importada de uma variável personalizada do Floodlight.

ConversionCustomVariableCardinality

Cardinalidade de uma variável personalizada de conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
BELOW_ALL_LIMITS A variável personalizada de conversão tem cardinalidade abaixo de todos os limites. A variável pode ser usada para segmentação, e as estatísticas podem acumular novos valores se a variável estiver ativada.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT A variável personalizada de conversão tem cardinalidade que excede o limite de segmentação, mas não excede o limite de estatísticas. A segmentação será desativada, mas as estatísticas poderão ser acumuladas para novos valores se a variável estiver ativada.
APPROACHES_STATS_LIMIT A variável personalizada de conversão excedeu os limites de segmentação e está se aproximando dos limites de estatísticas (> 90%). A segmentação será desativada, mas as estatísticas poderão ser acumuladas para novos valores se a variável estiver ativada.
EXCEEDS_STATS_LIMIT A variável personalizada de conversão excedeu os limites de segmentação e estatísticas. A segmentação será desativada, e as estatísticas das variáveis ativadas só poderão ser acumuladas se os valores atuais não aumentarem a cardinalidade da variável.

FloodlightConversionCustomVariableInfo

Informações sobre as variáveis personalizadas de conversão do Floodlight no Search Ads 360.

Representação JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Campos
floodlightVariableType

enum (FloodlightVariableType)

Tipo de variável do Floodlight definida no Search Ads 360.

floodlightVariableDataType

enum (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.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
DIMENSION Tipo de variável de dimensão do Floodlight.
METRIC Tipo de variável métrica do Floodlight.
UNSET O tipo de variável do Floodlight não está definido.

FloodlightVariableDataType

O tipo de dados da variável do Floodlight, conforme definido no Search Ads 360. Acesse https://support.google.com/searchads/answer/4397154?hl=en para saber mais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
NUMBER Representa uma variável do Floodlight do tipo "Número". Essa variável pode ser atribuída a variáveis do Floodlight dos tipos DIMENSÃO ou MÉTRICA.
STRING Representa uma variável do Floodlight do tipo "String". Essa variável pode ser atribuída a variáveis do Floodlight do tipo DIMENSÃO.

Cliente

Um cliente.

Representação JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Campos
resourceName

string

O nome do recurso do cliente. Os nomes dos recursos do cliente têm o seguinte formato:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Configuração do acompanhamento de conversões de um cliente.

accountType

enum (AccountType)

Tipo de conta de mecanismo, por exemplo: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track etc.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Configuração do DoubleClick Campaign Manager (DCM) para um cliente administrador.

accountStatus

enum (AccountStatus)

Status da conta, como "Ativada", "Pausada", "Removida" etc.

lastModifiedTime

string

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

string

ID da conta na conta de mecanismo externo.

status

enum (CustomerStatus)

O status do cliente.

creationTime

string

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

string (int64 format)

O ID do cliente.

descriptiveName

string

Nome descritivo opcional e não exclusivo do cliente.

currencyCode

string

A moeda em que a conta opera. É compatível com um subconjunto dos códigos de moeda do padrão ISO 4217.

timeZone

string

O ID de fuso horário local do cliente.

trackingUrlTemplate

string

O modelo de URL para criar um URL de rastreamento com base em parâmetros.

finalUrlSuffix

string

O modelo de URL para anexar parâmetros ao URL final.

autoTaggingEnabled

boolean

Indica se a codificação automática está ativada para o cliente.

manager

boolean

Se o cliente é um gerente.

ConversionTrackingSetting

Uma coleção de configurações do cliente relacionadas ao acompanhamento de conversões do Search Ads 360.

Representação JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Campos
acceptedCustomerDataTerms

boolean

Se o cliente aceitou os termos de dados do cliente. Se você usar o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura. Para mais informações, acesse https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Status do acompanhamento de conversões. Ele indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário desse acompanhamento. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai variar com base no login-customer-id da solicitação.

enhancedConversionsForLeadsEnabled

boolean

Indica se o cliente ativou as conversões otimizadas para leads. Se você estiver usando o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura.

googleAdsConversionCustomer

string

O nome do recurso do cliente em que as conversões são criadas e gerenciadas. Este campo é somente leitura.

conversionTrackingId

string (int64 format)

O ID de acompanhamento de conversões usado para esta conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (o conversionTrackingStatus sim). Este campo é somente leitura.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

O ID de acompanhamento de conversões do administrador do cliente. Esse valor é definido quando o cliente ativa o acompanhamento de conversões e substitui o conversionTrackingId. Só é possível gerenciar esse campo na interface do Google Ads. Este campo é somente leitura.

crossAccountConversionTrackingId

string (int64 format)

O ID de acompanhamento de conversões do administrador do cliente. Isso é definido quando o cliente ativa o acompanhamento de conversões de várias contas e substitui o conversionAcompanhamentoId.

ConversionTrackingStatus

Status do acompanhamento de conversões do cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
NOT_CONVERSION_TRACKED O cliente não usa o acompanhamento de conversões.
CONVERSION_TRACKING_MANAGED_BY_SELF As ações de conversão são criadas e gerenciadas por esse cliente.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER As ações de conversão são criadas e gerenciadas pelo administrador especificado na login-customer-id da solicitação.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER As ações de conversão são criadas e gerenciadas por um administrador diferente do cliente ou administrador especificado na login-customer-id da solicitação.

AccountType

Possíveis tipos de conta de mecanismo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
BAIDU Conta do Baidu.
ENGINE_TRACK Conta de rastreamento por mecanismo.
FACEBOOK Conta do Facebook.
FACEBOOK_GATEWAY Conta do Facebook gerenciada pelo gateway.
GOOGLE_ADS conta do Google Ads.
MICROSOFT conta do Microsoft Advertising.
SEARCH_ADS_360 Conta de administrador do Search Ads 360.
YAHOO_JAPAN do Yahoo! Japan.

DoubleClickCampaignManagerSetting

Configuração do DoubleClick Campaign Manager (DCM) para um cliente administrador.

Representação JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Campos
advertiserId

string (int64 format)

ID do anunciante do Campaign Manager associado a esse cliente.

networkId

string (int64 format)

ID da rede do Campaign Manager associada a esse cliente.

timeZone

string

Fuso horário da rede do Campaign Manager associada a esse cliente no formato do banco de dados de fusos horários da IANA, como America/New_York.

AccountStatus

Status possíveis de uma conta.

Enums
UNSPECIFIED Valor padrão.
UNKNOWN Valor desconhecido.
ENABLED A conta pode veicular anúncios.
PAUSED A conta é desativada pelo usuário.
SUSPENDED A conta é desativada por um processo interno.
REMOVED A conta é desativada de forma irreversível.
DRAFT A conta ainda está em processo de configuração e ainda não está ATIVADA.

CustomerStatus

Possíveis status de um cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED Indica uma conta ativa capaz de veicular anúncios.
CANCELED Indica que uma conta cancelada não pode veicular anúncios. Pode ser reativado por um usuário administrador.
SUSPENDED Indica uma conta suspensa que não pode veicular anúncios. Pode ser ativado somente pelo Suporte do Google.
CLOSED Indica uma conta fechada que não pode veicular anúncios. A conta de teste também terá o status CLOSED. O status é permanente e não pode ser reaberto.

CustomerAsset

Uma conexão entre um cliente e um recurso.

Representação JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Campos
resourceName

string

O nome do recurso do cliente. Os nomes dos recursos CustomerAsset têm o seguinte formato:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Obrigatório. O recurso vinculado ao cliente.

status

enum (AssetLinkStatus)

Status do recurso do cliente.

CustomerAssetSet

CustomerAssetSet é a vinculação entre um cliente e um conjunto de recursos. A adição de um CustomerAssetSet vincula um conjunto de recursos a um cliente.

Representação JSON
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Campos
resourceName

string

O nome do recurso do conjunto de recursos do cliente. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

O conjunto de recursos vinculado ao cliente.

customer

string

O cliente a que este conjunto de recursos está vinculado.

status

enum (AssetSetLinkStatus)

O status do conjunto de recursos do cliente. Somente leitura.

AccessibleBiddingStrategy

Representa uma visualização das estratégias de lances que pertencem ao cliente e foram compartilhadas com ele.

Ao contrário de BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e que foram compartilhadas com ele, além das estratégias dele. Esse recurso não fornece métricas e apenas expõe um subconjunto limitado dos atributos da estratégia de lances.

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

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

string

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

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

O ID da estratégia de lances.

name

string

É o nome da estratégia de lances.

type

enum (BiddingStrategyType)

É o tipo de estratégia de lances.

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

DescriptiveName do cliente proprietário da estratégia de lances.

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

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

targetCpa

object (TargetCpa)

Uma estratégia de lances que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.

targetImpressionShare

object (TargetImpressionShare)

Uma estratégia de lances que otimiza automaticamente para uma porcentagem escolhida de impressões.

targetRoas

object (TargetRoas)

Uma estratégia de lances que ajuda a maximizar a receita e calcular o retorno do investimento em publicidade (ROAS) desejado.

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

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

MaximizeConversions

Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

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

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja mostrada na parte de cima da primeira página (ou em outro local segmentado).

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

A fração escolhida de anúncios a serem exibidos no local segmentado em micros. Por exemplo, 1% é igual a 10.000.

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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.

ManagerLinkStatus

Status possíveis de um link.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ACTIVE Indica a relação atual em efeito
INACTIVE Indica relacionamento encerrado
PENDING Indica que a relação foi solicitada pelo gerente, mas o cliente ainda não aceitou.
REFUSED O gerente solicitou o relacionamento, mas o cliente se recusou.
CANCELED Indica que a relação foi solicitada pelo gerente, mas ele a cancelou.

ClienteCliente

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

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

string

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

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

O status do cliente. Somente leitura.

clientCustomer

string

O nome de recurso do cliente-cliente que está vinculado ao cliente em questão. Somente leitura.

hidden

boolean

Especifica se esta é uma conta oculta.

Somente leitura.

level

string (int64 format)

Distância entre o cliente e o cliente. Para o autolink, o valor do nível será 0. Somente leitura.

timeZone

string

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

testAccount

boolean

Identifica se o cliente é uma conta de teste. Somente leitura.

manager

boolean

Identifica se o cliente é um administrador. Somente leitura.

descriptiveName

string

Nome descritivo do cliente. Somente leitura.

currencyCode

string

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

id

string (int64 format)

O ID do cliente cliente. Somente leitura.

DynamicSearchAdsSearchTermView

Uma visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa.

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

string

O nome do recurso da visualização de termos de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos de visualização dos termos de pesquisa dos anúncios dinâmicos de pesquisa têm o seguinte formato:

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

landingPage

string

O URL da página de destino selecionada dinamicamente da impressão.

Este campo é somente leitura.

GenderView

Uma visualização de gênero. O recurso "genderView" reflete o estado de veiculação efetivo, e não os critérios que foram adicionados. Um grupo de anúncios sem critérios de gênero por padrão é veiculado para todos os gêneros, então todos os gêneros aparecem na visualização de gênero com estatísticas.

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

string

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

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

GeoTargetConstant

Uma constante de segmentação por área geográfica.

Representação JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Campos
resourceName

string

O nome do recurso da constante de segmentação por área geográfica. Os nomes dos recursos de constante de destino geográfico têm este formato:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Status da constante de segmentação por área geográfica.

id

string (int64 format)

O ID da constante de destino geográfico.

name

string

Nome em inglês da constante de segmentação por área geográfica.

countryCode

string

O código de país ISO-3166-1 alfa-2 associado à segmentação.

targetType

string

Tipo de segmentação constante da segmentação geográfica.

canonicalName

string

O nome em inglês completo, que consiste no nome da segmentação, da segmentação pai e do país.

parentGeoTarget

string

O nome do recurso da constante de segmentação por área geográfica principal. Os nomes das constantes de recursos de segmentação geográfica têm o seguinte formato:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Os status possíveis de uma constante de segmentação por área geográfica.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor somente de resposta.

ENABLED A constante de segmentação por área geográfica é válida.
REMOVAL_PLANNED A constante de segmentação geográfica está obsoleta e será removida.

KeywordView

Uma visualização de palavra-chave.

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

string

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

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

Rótulo

Um rótulo.

Representação JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Campos
resourceName

string

Nome do recurso. Os nomes dos recursos de rótulo têm o formato: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Status do rótulo. Somente leitura.

textLabel

object (TextLabel)

Um tipo de marcador que mostra texto em um plano de fundo colorido.

id

string (int64 format)

ID do rótulo. Somente leitura.

name

string

Nome do rótulo.

Este campo é obrigatório e não deve ficar vazio ao criar um novo rótulo.

Esta string conter entre 1 e 80 caracteres (valores inclusivos).

LabelStatus

Status possíveis de um rótulo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED O rótulo está ativado.
REMOVED O rótulo foi removido.

TextLabel

Um tipo de marcador que mostra texto em um plano de fundo colorido.

Representação JSON
{
  "backgroundColor": string,
  "description": string
}
Campos
backgroundColor

string

Cor de fundo do rótulo no formato HEX. Essa string precisa corresponder à expressão regular '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Observação: a cor de plano de fundo pode não estar visível para contas de administrador.

description

string

Uma breve descrição do rótulo. O comprimento não pode exceder 200 caracteres.

LanguageConstant

Um idioma.

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

string

O nome do recurso da constante de idioma. Os nomes dos recursos de constantes de idioma têm o seguinte formato:

languageConstants/{criterionId}

id

string (int64 format)

O ID da constante de idioma.

code

string

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

name

string

O nome completo do idioma em inglês, por exemplo, "English (US)", "Spanish" etc.

targetable

boolean

Indica se o idioma é segmentável.

LocationView

Uma visualização de local resume a performance das campanhas por um critério de local.

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

string

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

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

ProductBiddingCategoryConstant

Uma categoria de lances de produtos.

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

string

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

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

level

enum (ProductBiddingCategoryLevel)

Nível da categoria do lance do produto.

status

enum (ProductBiddingCategoryStatus)

Status da categoria de lances do produto.

id

string (int64 format)

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.

countryCode

string

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

productBiddingCategoryConstantParent

string

Nome do recurso da categoria de lances do produto principal.

languageCode

string

Código de idioma da categoria de lances do produto.

localizedName

string

Valor de exibição da categoria de lances do produto localizada de acordo com o languageCode.

ProductBiddingCategoryLevel

Enumeração que descreve o nível da categoria de lances do produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
LEVEL1 Nível 1.
LEVEL2 Nível 2.
LEVEL3 Nível 3.
LEVEL4 Nível 4.
LEVEL5 Nível 5.

ProductBiddingCategoryStatus

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

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

ProductGroupView

Uma visualização do grupo de produtos.

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

string

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

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

ShoppingPerformanceView

Visualização de performance do Shopping. Fornece estatísticas agregadas das campanhas do Shopping em vários níveis de dimensão do produto. Os valores de dimensão do produto do Merchant Center, como marca, categoria, atributos personalizados, condição do produto e tipo de produto, refletem o estado de cada dimensão na data e hora em que o evento correspondente foi registrado.

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

string

O nome do recurso da visualização de desempenho do Shopping. Os nomes dos recursos da visualização de performance de compras têm o formato: customers/{customerId}/shoppingPerformanceView

UserList

Uma lista de usuários. É uma lista de usuários que um cliente pode segmentar.

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

string

O nome do recurso da lista de usuários. Os nomes dos recursos de lista de usuários têm o seguinte formato:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Tipo desta lista.

Este campo é somente leitura.

id

string (int64 format)

ID da lista de usuários.

name

string

Nome da lista de usuários. Dependendo de access_reason, o nome da lista de usuários pode não ser exclusivo (por exemplo, se access_reason=SHARED)

UserListType

Enumeração que contém possíveis tipos de lista de usuários.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
REMARKETING UserList representada como uma coleção de tipos de conversão.
LOGICAL Lista de usuários representada como uma combinação de outras listas/interesses de usuários.
EXTERNAL_REMARKETING Lista de usuários criada na plataforma do Google Ad Manager.
RULE_BASED Lista de usuários associada a uma regra.
SIMILAR Lista de usuários com usuários semelhantes aos de outra lista.
CRM_BASED Lista de usuários com dados próprios de CRM fornecidos pelo anunciante em forma de e-mails ou outros formatos.

UserLocationView

Uma visualização de local do usuário.

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

Representação JSON
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Campos
resourceName

string

O nome do recurso da visualização de local do usuário. Os nomes dos recursos da visualização "UserLocation" têm o seguinte formato:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

ID do critério do país.

targetingLocation

boolean

Indica se o local foi segmentado ou não.

WebpageView

Uma visualização de página da Web.

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

string

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

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

Acesse

Uma visita.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
resourceName

string

O nome do recurso da visita. Os nomes dos recursos de visita têm o seguinte formato:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

O ID da visita.

criterionId

string (int64 format)

ID de palavra-chave do Search Ads 360. Um valor de 0 indica que a palavra-chave não foi atribuída.

merchantId

string (int64 format)

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

string (int64 format)

ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído.

clickId

string

Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL de ID de clique.

visitDateTime

string

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

string

O ID do produto clicado.

productChannel

enum (ProductChannel)

O canal de vendas do produto que foi clicado: on-line ou local.

productLanguageCode

string

O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto.

productStoreId

string

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

string

O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado.

assetId

string (int64 format)

ID do recurso com o qual houve interação durante o evento de visita.

assetFieldType

enum (AssetFieldType)

Tipo de campo do recurso do evento da visita.

ProductChannel

Enumeração que descreve a localidade de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ONLINE O item é vendido on-line.
LOCAL O item é vendido em lojas locais.

Conversão

Uma conversão.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
resourceName

string

O nome do recurso da conversão. Os nomes dos recursos de conversão têm o seguinte formato:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

O ID da conversão.

criterionId

string (int64 format)

ID do critério do Search Ads 360. Um valor de 0 indica que o critério não foi atribuído.

merchantId

string (int64 format)

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

string (int64 format)

ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído.

clickId

string

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

string (int64 format)

O ID de visita do Search Ads 360 a que a conversão é atribuída.

advertiserConversionId

string

Em conversões off-line, esse é um ID fornecido pelos anunciantes. Se um anunciante não especificar um ID, o Search Ads 360 vai gerar um. Em conversões on-line, ele é igual à coluna "id" ou à coluna "floodlightOrderId", dependendo das instruções do Floodlight fornecidas pelo anunciante.

productId

string

O ID do produto clicado.

productChannel

enum (ProductChannel)

O canal de vendas do produto que foi clicado: on-line ou local.

productLanguageCode

string

O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto.

productStoreId

string

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

string

O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado.

attributionType

enum (AttributionType)

A que a conversão é atribuída: visita ou palavra-chave + anúncio.

conversionDateTime

string

O carimbo de data/hora do evento de conversão.

conversionLastModifiedDateTime

string

O carimbo de data/hora da última vez em que a conversão foi modificada.

conversionVisitDateTime

string

O carimbo de data/hora da visita à qual a conversão é atribuída.

conversionQuantity

string (int64 format)

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

string (int64 format)

A receita ajustada em micros para o evento de conversão. Estará sempre na moeda da conta de veiculação.

floodlightOriginalRevenue

string (int64 format)

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

string

O ID do pedido do Floodlight fornecido pelo anunciante para a conversão.

status

enum (ConversionStatus)

O status da conversão, que será ATIVADO ou REMOVIDO.

assetId

string (int64 format)

ID do recurso com que houve interação durante o evento de conversão.

assetFieldType

enum (AssetFieldType)

Tipo de campo do recurso do evento de conversão.

AttributionType

Tipo de atribuição de conversão no Search Ads 360

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
VISIT A conversão é atribuída a uma visita.
CRITERION_AD A conversão é atribuída a um par de anúncios e critérios.

ConversionStatus

Possíveis status de uma conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A conversão está ativada.
REMOVED A conversão foi removida.

Métricas

Dados de métricas.

Representação JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Campos
allConversionsValueByConversionDate

number

Valor de todas as conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

As métricas personalizadas de conversão.

conversionsValueByConversionDate

number

A soma do valor das conversões que podem ser usadas para lances por data de conversão. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão.

conversionsByConversionDate

number

A soma de conversões por data de conversão para os tipos de conversão que recebem lances. Pode ser fracionário devido à modelagem de atribuição. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão.

historicalCreativeQualityScore

enum (QualityScoreBucket)

O índice de qualidade histórico do criativo.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

A qualidade da experiência histórica na página de destino.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

A taxa de cliques (CTR) prevista da pesquisa histórica.

interactionEventTypes[]

enum (InteractionEventType)

Os tipos de interação com pagamentos e sem custo.

rawEventConversionMetrics[]

object (Value)

As métricas brutas de conversão de eventos.

absoluteTopImpressionPercentage

number

A parcela de impressões na primeira posição da pesquisa é a porcentagem de impressões de anúncios de pesquisa que são exibidas na posição de maior destaque da rede.

allConversionsFromInteractionsRate

number

Todas as conversões de interações (como opostas a conversões de visualização) divididas pelo número de interações com anúncios.

allConversionsValue

number

Valor de todas as conversões.

allConversions

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric.

allConversionsValuePerCost

number

O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).

allConversionsFromClickToCall

number

O número de vezes que as pessoas clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. Essa métrica não informa se as chamadas foram atendidas nem a duração delas.

Essa métrica se aplica apenas aos itens do feed.

allConversionsFromDirections

number

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

Essa métrica se aplica apenas aos itens do feed.

allConversionsFromInteractionsValuePerInteraction

number

O valor de todas as conversões de interações dividido pelo número total de interações.

allConversionsFromMenu

number

Quantas vezes as pessoas clicaram em um link para ver o menu de uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

allConversionsFromOrder

number

Quantas vezes as pessoas fizeram um pedido em uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

allConversionsFromOtherEngagement

number

O número de outros tipos de conversão (por exemplo, postar uma avaliação ou salvar o local de uma loja) que ocorreram depois que os usuários clicaram em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

allConversionsFromStoreVisit

number

Número estimado de vezes que os usuários visitaram uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

visits

number

Os cliques que o Search Ads 360 registrou e encaminhou à página de destino de um anunciante

allConversionsFromStoreWebsite

number

O número de vezes que os usuários foram direcionados ao URL de uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

averageCost

number

Valor médio que você paga por interação. Esse valor é o custo total dos seus anúncios dividido pelo número total de interações.

averageCpc

number

O custo total de todos os cliques dividido pelo número total de cliques recebidos. 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

number

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

string (int64 format)

O número de cliques.

contentBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de Display, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de conteúdo é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

contentImpressionShare

number

As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você pode receber. Observação: a parcela de impressões de conteúdo é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

contentRankLostImpressionShare

number

A porcentagem estimada de impressões na rede de Display que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas do conteúdo é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

conversionsFromInteractionsRate

number

Conversões com lances possíveis (de interação) médias por interação qualificada. Mostra com que frequência, em média, uma interação com o anúncio leva a uma conversão que recebe lances.

clientAccountConversionsValue

number

O valor das conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo includeInClientAccountConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

conversionsValuePerCost

number

O valor da conversão que recebe lances dividido pelo custo total das interações qualificadas para conversão.

conversionsFromInteractionsValuePerInteraction

number

O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

clientAccountConversions

number

O número de conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo includeInClientAccountConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

costMicros

string (int64 format)

A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período. 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

number

O custo das interações com anúncios dividido por todas as conversões.

costPerConversion

number

Custo médio de conversões qualificadas por conversão que pode ser usada em lances.

costPerCurrentModelAttributedConversion

number

O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

crossDeviceConversions

number

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.

crossDeviceConversionsByConversionDate

number

O número de conversões em dispositivos diferentes por data. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

crossDeviceConversionsValue

number

A soma do valor das conversões em dispositivos diferentes.

crossDeviceConversionsValueByConversionDate

number

A soma do valor das conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

ctr

number

O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões).

conversions

number

O número de conversões. Isso inclui apenas ações de conversão em que o atributo includeInConversionsMetric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

conversionsValue

number

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.

averageQualityScore

number

O índice de qualidade médio.

historicalQualityScore

string (int64 format)

O índice de qualidade histórico.

impressions

string (int64 format)

Contagem da frequência com que seu anúncio foi exibido em uma página de resultados de pesquisa ou em um site na Rede do Google.

interactionRate

number

A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.

interactions

string (int64 format)

O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio (cliques em anúncios de texto e do Shopping, visualizações de anúncios em vídeo etc.).

invalidClickRate

number

A porcentagem de cliques filtrados do número total de cliques (cliques filtrados e não filtrados) durante o período do relatório.

invalidClicks

string (int64 format)

Número de cliques que o Google considera ilegítimos e que não são cobrados de você.

generalInvalidClickRate

number

A porcentagem de cliques que foram filtrados do número total de cliques (cliques filtrados e não filtrados) por serem inválidos. São cliques que o Google considera ilegais e que são detectados por meios de filtragem de rotina, como tráfego inválido conhecido de data centers, bots e indexadores ou outros rastreadores, padrões irregulares etc. Você não é cobrado por eles, e eles não afetam as estatísticas da sua conta. Consulte a página de ajuda em https://support.google.com/campaignmanager/answer/6076504 para mais detalhes.

generalInvalidClicks

string (int64 format)

Número de cliques inválidos gerais. São um subconjunto dos seus cliques inválidos detectados por meios de filtragem de rotina, como tráfego inválido conhecido de data centers, bots e indexadores ou outros rastreadores, padrões irregulares etc. Você não é cobrado por eles, e eles não afetam as estatísticas da sua conta. Consulte a página de ajuda em https://support.google.com/campaignmanager/answer/6076504 para mais detalhes.

mobileFriendlyClicksPercentage

number

A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis.

searchAbsoluteTopImpressionShare

number

A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente exibidas na posição de maior destaque no Shopping. Consulte https://support.google.com/sa360/answer/9566729 para mais detalhes. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte de cima da página devido a um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de pesquisa, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostTopImpressionShare

number

Número que estima a frequência com que seu anúncio não foi exibido perto dos principais resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchClickShare

number

O número de cliques que você recebeu na rede de pesquisa dividido pelo número estimado de cliques que você estava qualificado para receber. Observação: a parcela de cliques da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchExactMatchImpressionShare

number

As impressões recebidas divididas pelo número estimado de impressões que você tinha qualificação para receber na rede de pesquisa para termos de pesquisa que corresponderam exatamente às suas palavras-chave (ou eram variações aproximadas da sua palavra-chave), independentemente dos tipos de correspondência de palavra-chave. Observação: a parcela de impressões de correspondência exata de pesquisa é informada entre 0,1 e 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchImpressionShare

number

O número de impressões recebidas na rede de pesquisa dividido pelo número estimado de impressões que você está qualificado para receber. Observação: a parcela de impressões da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

O número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte superior dos resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchRankLostImpressionShare

number

A porcentagem estimada de impressões na rede de pesquisa que seus anúncios não receberam devido à baixa classificação. Observação: a parcela de impressões perdidas da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchRankLostTopImpressionShare

number

Número que estima a frequência com que seu anúncio não foi exibido perto dos principais resultados da pesquisa orgânica devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchTopImpressionShare

number

As impressões que você recebeu entre os anúncios na parte de cima em comparação com o número estimado de impressões que você tinha qualificação para receber entre os anúncios nessa posição. Observação: a parcela de impressões na parte superior da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Esses anúncios geralmente ficam acima dos resultados orgânicos principais, embora possam aparecer abaixo desses resultados em determinadas consultas.

topImpressionPercentage

number

A porcentagem de impressões de anúncios exibidas ao lado dos principais resultados da pesquisa orgânica.

valuePerAllConversions

number

O valor de todas as conversões dividido pelo número de todas as conversões.

valuePerAllConversionsByConversionDate

number

O valor de todas as conversões dividido pelo número de todas as conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

O valor da conversão que pode ser usada em lances dividido pelo número de conversões que podem ser usadas em lances. Mostra o valor médio de cada uma das conversões que podem receber lances.

valuePerConversionsByConversionDate

number

Valor das conversões que podem ser veiculadas por data de conversão dividido pelas conversões que podem ser veiculadas por data de conversão. Mostra o valor médio de cada uma das conversões que podem receber lances (por data da conversão). Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão.

clientAccountViewThroughConversions

string (int64 format)

O número total de conversões de visualização. Elas acontecem quando um cliente vê um anúncio gráfico ou rich media e depois conclui uma conversão no seu site sem interagir (por exemplo, clicar) com outro anúncio.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos (CPV) da conta de cliente é o custo total dos itens vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos por venda cruzada é o valor total dos itens comercializados que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O custo dos produtos de venda cruzada desse pedido é de R $5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos (CPV) com venda cruzada é o valor total dos itens comercializados como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos por venda cruzada é o valor total dos itens comercializados que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O CPV com venda cruzada desse pedido é de R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

O lucro bruto de venda cruzada da conta do cliente é o lucro dos produtos vendidos como resultado da publicidade de um produto diferente, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído na compra é um produto vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O lucro bruto de venda cruzada é a receita gerada com a venda cruzada atribuída aos seus anúncios menos o custo dos produtos vendidos. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

O lucro bruto de venda cruzada é o lucro dos produtos vendidos como resultado da publicidade de um produto diferente, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído na compra é um produto vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O lucro bruto de venda cruzada é a receita gerada com a venda cruzada atribuída aos seus anúncios menos o custo dos produtos vendidos. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

A receita de venda cruzada da conta do cliente é o valor total que você ganhou com produtos vendidos como resultado da publicidade de um produto diferente. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellRevenueMicros

string (int64 format)

A receita de venda cruzada é o valor total que você ganha de produtos vendidos como resultado da publicidade de um produto diferente. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. A receita de venda cruzada é o valor total gerado pela venda cruzada atribuída aos seus anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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

number

As unidades vendidas em venda cruzada da conta do cliente são o número total de produtos vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. As unidades vendidas em venda cruzada são o número total de produtos de venda cruzada em todos os pedidos atribuídos aos anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas em venda cruzada neste pedido é 2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.

crossSellUnitsSold

number

As unidades vendidas em venda cruzada representam o número total de produtos vendidos como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. As unidades vendidas em venda cruzada são o número total de produtos de venda cruzada em todos os pedidos atribuídos aos anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas em venda cruzada neste pedido é 2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos (CPV) de lead da conta do cliente é o custo total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos de lead (CPV) é o custo total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O valor de custo dos produtos vendidos do chapéu é US$ 3, e o da camiseta é US$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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

string (int64 format)

O lucro bruto de lead da conta de cliente é o lucro dos produtos vendidos como resultado da publicidade do mesmo produto, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, a receita gerada por essas vendas menos o custo dos produtos vendidos será seu lucro bruto de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadGrossProfitMicros

string (int64 format)

O lucro bruto de lead é o lucro dos produtos vendidos como resultado da publicidade do mesmo produto, menos o custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, a receita gerada por essas vendas menos o custo dos produtos vendidos será seu lucro bruto de lead. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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

string (int64 format)

A receita de lead da conta de cliente é o valor total gerado com produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor total gerado com as vendas desses itens vai ser mostrado em "Receita de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou esse item e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

A receita de lead é o valor total gerado com produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor total gerado com as vendas desses itens vai ser mostrado em "Receita de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de lead desse pedido é de R $10. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. 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

number

As unidades vendidas de lead da conta do cliente representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas de lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.

leadUnitsSold

number

As unidades vendidas de lead representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas de lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.

Valor

Um contêiner de dados genérico.

Representação JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Campos
Campo de união value. um valor. value pode ser apenas de um dos tipos a seguir:
booleanValue

boolean

Um booleano.

int64Value

string (int64 format)

Um int64.

floatValue

number

Um ponto flutuante.

doubleValue

number

Um duplo.

stringValue

string

Uma string.

QualityScoreBucket

Enumeração que lista os possíveis buckets do Índice de qualidade.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
BELOW_AVERAGE A qualidade do criativo está abaixo da média.
AVERAGE A qualidade do criativo é média.
ABOVE_AVERAGE A qualidade do criativo está acima da média.

InteractionEventType

Enumeração que descreve possíveis tipos de interações com pagamentos e sem custo.

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

Segmentos

Segmentar apenas campos.

Representação JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Campos
adNetworkType

enum (AdNetworkType)

Tipo de rede de publicidade.

conversionActionCategory

enum (ConversionActionCategory)

Categoria de ação de conversão.

conversionCustomDimensions[]

object (Value)

As dimensões personalizadas de conversão.

dayOfWeek

enum (DayOfWeek)

Dia da semana, por exemplo, SEGUNDA-FEIRA.

device

enum (Device)

Dispositivo a que as métricas se aplicam.

keyword

object (Keyword)

Critério da palavra-chave.

productChannel

enum (ProductChannel)

Canal do produto.

productChannelExclusivity

enum (ProductChannelExclusivity)

Exclusividade do canal do produto.

productCondition

enum (ProductCondition)

Estado do produto.

productSoldCondition

enum (ProductCondition)

Condição do produto vendido.

rawEventConversionDimensions[]

object (Value)

As dimensões de conversão de eventos brutos.

conversionAction

string

Nome do recurso da ação de conversão.

conversionActionName

string

Nome da ação de conversão.

date

string

Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17.

geoTargetCity

string

Nome do recurso da constante de segmentação por área geográfica que representa uma cidade.

geoTargetCountry

string

Nome do recurso da constante de segmentação por área geográfica que representa um país.

geoTargetMetro

string

Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana.

geoTargetRegion

string

Nome do recurso da constante de segmentação por área geográfica que representa uma região.

hour

integer

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

month

string

Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd.

productBiddingCategoryLevel1

string

Categoria do lance (nível 1) do produto.

productBiddingCategoryLevel2

string

Categoria do lance (nível 2) do produto.

productBiddingCategoryLevel3

string

Categoria do lance (nível 3) do produto.

productBiddingCategoryLevel4

string

Categoria do lance (nível 4) do produto.

productBiddingCategoryLevel5

string

Categoria do lance (nível 5) do produto.

productBrand

string

Marca do produto.

productCountry

string

Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto.

productCustomAttribute0

string

Atributo personalizado 0 do produto.

productCustomAttribute1

string

Atributo personalizado 1 do produto.

productCustomAttribute2

string

Atributo personalizado 2 do produto.

productCustomAttribute3

string

Atributo personalizado 3 do produto.

productCustomAttribute4

string

Atributo personalizado 4 do produto.

productItemId

string

ID do item do produto.

productLanguage

string

Nome do recurso da constante de idioma para o idioma do produto.

productSoldBiddingCategoryLevel1

string

Categoria do lance (nível 1) do produto vendido.

productSoldBiddingCategoryLevel2

string

Categoria do lance (nível 2) do produto vendido.

productSoldBiddingCategoryLevel3

string

Categoria de lance (nível 3) do produto vendido.

productSoldBiddingCategoryLevel4

string

Categoria do lance (nível 4) do produto vendido.

productSoldBiddingCategoryLevel5

string

Categoria de lance (nível 5) do produto vendido.

productSoldBrand

string

Marca do produto vendido.

productSoldCustomAttribute0

string

Atributo personalizado 0 do produto vendido.

productSoldCustomAttribute1

string

Atributo personalizado 1 do produto vendido.

productSoldCustomAttribute2

string

Atributo personalizado 2 do produto vendido.

productSoldCustomAttribute3

string

Atributo personalizado 3 do produto vendido.

productSoldCustomAttribute4

string

Atributo personalizado 4 do produto vendido.

productSoldItemId

string

ID do item vendido.

productSoldTitle

string

Título do produto vendido.

productSoldTypeL1

string

Tipo (nível 1) do produto vendido.

productSoldTypeL2

string

Tipo (nível 2) do produto vendido.

productSoldTypeL3

string

Tipo (nível 3) do produto vendido.

productSoldTypeL4

string

Tipo (nível 4) do produto vendido.

productSoldTypeL5

string

Tipo (nível 5) do produto vendido.

productStoreId

string

ID da loja do produto.

productTitle

string

Título do produto.

productTypeL1

string

Tipo (nível 1) do produto.

productTypeL2

string

Tipo (nível 2) do produto.

productTypeL3

string

Tipo (nível 3) do produto.

productTypeL4

string

Tipo (nível 4) do produto.

productTypeL5

string

Tipo (nível 5) do produto.

quarter

string

Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano civil para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 2018-04-01. no formato aaaa-MM-dd.

week

string

É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd.

year

integer

Ano, formatado como aaaa.

assetInteractionTarget

object (AssetInteractionTarget)

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

AdNetworkType

Enumera os tipos de rede do Google Ads.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
SEARCH Pesquisa do Google.
SEARCH_PARTNERS Parceiros de pesquisa.
CONTENT Rede de Display.
YOUTUBE_WATCH Vídeos do YouTube
MIXED Várias redes.

Palavra-chave

Um segmento de critério de palavra-chave.

Representação JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Campos
info

object (KeywordInfo)

Informações da palavra-chave.

adGroupCriterion

string

O nome do recurso name.

ProductChannelExclusivity

Enumeração que descreve a disponibilidade de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
SINGLE_CHANNEL O item é vendido por um único canal, tanto em lojas locais quanto on-line, conforme indicado pelo ProductChannel.
MULTI_CHANNEL O item é correspondente à versão das lojas on-line ou locais, indicando que ele está disponível para compra nos dois ShoppingProductChannels.

ProductCondition

Enumeração que descreve a condição de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
OLD O produto está velho.
NEW O produto está em bom estado.
REFURBISHED O produto está recondicionado.
USED O estado do produto é "usado".

AssetInteractionTarget

Um segmento de AssetInteractionTarget.

Representação JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Campos
asset

string

O nome do recurso do recurso.

interactionOnThisAsset

boolean

Usado apenas com as métricas CustomerAsset, CampaignAsset e GroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente.