SearchAds360Row

Uma linha retornada da consulta.

Representação JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "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)
  },
  "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)
  },
  "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.

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

O modificador de lance referenciado na consulta.

adGroupCriterion

object (AdGroupCriterion)

O critério referenciado na consulta.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

O rótulo do critério do grupo de anúncios mencionado 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 mencionado 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 superior do grupo de recursos mencionada na consulta.

assetGroup

object (AssetGroup)

O grupo de recursos referenciado na consulta.

assetSetAsset

object (AssetSetAsset)

O recurso do conjunto de recursos referenciado na consulta.

assetSet

object (AssetSet)

O conjunto de recursos referenciado na consulta.

biddingStrategy

object (BiddingStrategy)

Estratégia de lances referenciada na consulta.

campaignBudget

object (CampaignBudget)

O orçamento da campanha indicado na consulta.

campaign

object (Campaign)

A campanha referenciada na consulta.

campaignAsset

object (CampaignAsset)

O recurso da campanha referenciado na consulta.

campaignAssetSet

object (CampaignAssetSet)

O conjunto de recursos da campanha mencionado 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.

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 mencionada na consulta.

customerClient

object (CustomerClient)

O CustomerClient mencionado na consulta.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

A visualização do termo 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 geográfica referenciada na consulta.

keywordView

object (KeywordView)

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 do local referenciada na consulta.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

A categoria de lances do produto mencionada na consulta.

productGroupView

object (ProductGroupView)

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

shoppingPerformanceView

object (ShoppingPerformanceView)

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

userList

object (UserList)

A lista de usuários 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
  ],
  "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 este 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".

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.

engineId

string

ID do grupo de anúncios na conta de mecanismo externo. Este 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 "adGroup.id" como alternativa.

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 status possíveis 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

Enumeração que lista os possíveis tipos 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 para campanhas do Shopping que veiculam anúncios de produtos padrão.
SHOPPING_SHOWCASE_ADS O tipo de grupos de anúncios limitados a veicular 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 Tipo de grupo de anúncios nas campanhas inteligentes do Shopping.
VIDEO_BUMPER Anúncios em vídeo in-stream curtos não puláveis.
VIDEO_TRUE_VIEW_IN_STREAM Anúncios em vídeo in-stream TrueView (puláveis).
VIDEO_TRUE_VIEW_IN_DISPLAY Anúncios em vídeo TrueView in-display.
VIDEO_NON_SKIPPABLE_IN_STREAM Anúncios em vídeo in-stream não puláveis.
VIDEO_OUTSTREAM Anúncios em vídeo out-stream.
SEARCH_DYNAMIC_ADS Tipo de grupo para 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 para grupos de anúncios de hotel promovido.
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 modos possíveis de rotação de anúncios de um grupo de anúncios.

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 de anúncios 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 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á em exibição para esse grupo porque o grupo de anúncios associado ainda está em formato de rascunho.
AD_GROUP_PAUSED O grupo de anúncios foi pausado.
AD_GROUP_SERVING O grupo de anúncios está ativo e veiculando anúncios no momento.
AD_GROUP_SUBMITTED O grupo de anúncios foi enviado (status legado do Microsoft Bing Ads).
CAMPAIGN_PAUSED Nenhum anúncio está em exibição para esse grupo de anúncios, pois 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

A lista de configurações 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 a segmentação. Um valor de false significa que esses critérios restringirão a segmentação e aplicarão modificadores de lance.

TargetingDimension

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
KEYWORD Critérios de palavras-chave, por exemplo, "cruzeiro mars". KEYWORD pode ser usada como uma dimensão de lance personalizado. Como as palavras-chave são sempre uma dimensão de segmentação, elas podem não ser definidas como "TODAS" como segmentação. com TargetRestriction.
AUDIENCE Critérios de público-alvo, que incluem lista de usuários, interesse do usuário, afinidade personalizada e personalizado no mercado.
TOPIC Critérios de tópicos para segmentação por categorias de conteúdo, por exemplo, "category::Animais>Animais de estimação" Usado para segmentação de display e vídeo.
GENDER Critérios para segmentação por sexo.
AGE_RANGE Critérios para segmentação de faixas etárias.
PLACEMENT Critérios de posicionamento, que incluem sites como "www.flowers4sale.com", bem como aplicativos para dispositivos móveis, categorias de apps para dispositivos móveis, vídeos e canais do YouTube.
PARENTAL_STATUS Critérios para a segmentação por status parental.
INCOME_RANGE Critérios para a segmentação por faixa de renda.

AdGroupAd

Um anúncio de grupo de anúncios.

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

string

O nome de 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

O carimbo de data/hora em que este 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.

engineId

string

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

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 GroupAd.

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 um 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 É um anúncio de texto expandido.
CALL_ONLY_AD O anúncio é só para chamadas.
EXPANDED_DYNAMIC_SEARCH_AD É um anúncio dinâmico expandido de pesquisa.
HOTEL_AD É um anúncio de hotel.
SHOPPING_SMART_AD O anúncio é inteligente do Shopping.
SHOPPING_PRODUCT_AD O anúncio é padrão do Shopping.
VIDEO_AD O anúncio é em vídeo.
GMAIL_AD Este é um anúncio do Gmail.
IMAGE_AD Este é um anúncio gráfico.
RESPONSIVE_SEARCH_AD O anúncio é responsivo de pesquisa.
LEGACY_RESPONSIVE_DISPLAY_AD É um anúncio responsivo de display legado.
APP_AD É um anúncio de 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 é de 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 É 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 em vídeo in-stream não pulável.
VIDEO_OUTSTREAM_AD Anúncio em vídeo out-stream.
VIDEO_TRUEVIEW_DISCOVERY_AD Anúncio em vídeo TrueView in-display.
VIDEO_TRUEVIEW_IN_STREAM_AD Anúncio em vídeo TrueView in-stream.
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 universal para apps.
DISCOVERY_MULTI_ASSET_AD Anúncio Discovery com vários recursos
TRAVEL_AD Anúncio de viagens.
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 do 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 valor de retorno. Representa um valor desconhecido nesta versão.
AD_GROUP_AD_ELIGIBLE

Obsoleto. Não use.

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

Obsoleto. Não use. Usado anteriormente pelo Gemini

AD_GROUP_AD_PAUSED O criativo foi pausado.
AD_GROUP_AD_REMOVED O criativo foi removido.
AD_GROUP_AD_PENDING_REVIEW A revisão do criativo está pendente.
AD_GROUP_AD_UNDER_REVIEW O criativo está em revisão.
AD_GROUP_AD_APPROVED O criativo foi aprovado.
AD_GROUP_AD_DISAPPROVED O criativo foi reprovado.
AD_GROUP_AD_SERVING O criativo está sendo veiculado.
AD_GROUP_AD_ACCOUNT_PAUSED O criativo foi pausado porque a conta está em pausa.
AD_GROUP_AD_CAMPAIGN_PAUSED O criativo foi pausado porque a campanha também.
AD_GROUP_AD_AD_GROUP_PAUSED O criativo foi pausado porque o grupo de anúncios está em pausa.

AdGroupAdLabel

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

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

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.

AdGroupAsset

Um vínculo 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 GroupAsset 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

"Grupo de recursos de anúncios" é o vínculo entre um grupo de anúncios e um conjunto de recursos. A criação de um GroupAssetSet 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 que está vinculado ao grupo de anúncios.

status

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

Os status possíveis do vínculo entre o conjunto de recursos e o contêiner dele.

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 dele 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 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 no nível do público-alvo.

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

string

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

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

AdGroupBidModifier

Representa um modificador de 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 de recursos do modificador de lances de 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 nas 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 nesta versão.
MOBILE Dispositivos móveis com navegadores completos.
TABLET Tablets com navegadores completos.
DESKTOP Computadores.
CONNECTED_TV Smart TVs e consoles de jogos.
OTHER Outros tipos de dispositivos.

AdGroupCriterion

Um critério de grupo de anúncios. O relatório adGroupcritério mostra somente critérios que foram explicitamente adicionados ao grupo de anúncios.

Representação JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    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 de 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.

positionEstimates

object (PositionEstimates)

Estimativas de 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. Este 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" como alternativa.

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

Define 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.

Exatamente um deve ser definido. 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 possíveis status de um gcr.

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 os possíveis tipos de critério.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
KEYWORD Palavra-chave, por exemplo, "cruzeiro mars".
PLACEMENT Canal, também conhecido como website, por exemplo, "www.flores4.com.br"
MOBILE_APP_CATEGORY Categorias de aplicativos para dispositivos móveis a serem segmentadas.
MOBILE_APPLICATION Aplicativos para dispositivos móveis a serem segmentados.
DEVICE Dispositivos a serem segmentados.
LOCATION Locais a serem segmentados.
LISTING_GROUP Grupos de produtos anunciados 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 da ficha da empresa a ser segmentado.
LANGUAGE e linguagem Hashicorp.
IP_BLOCK IpBlock.
CONTENT_LABEL Marcador de conteúdo para exclusão de categoria.
CARRIER Operadora.
USER_INTEREST Uma categoria em que o usuário está interessado.
WEBPAGE Critério de página da Web para anúncios dinâmicos de pesquisa.
OPERATING_SYSTEM_VERSION A versão do sistema operacional.
APP_PAYMENT_MODEL Modelo de pagamento do 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

PositionEstimates

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 gcr.

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

Obsoleto. Não use.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: lance ou qualidade muito baixos para 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: URL para dispositivos móveis em processo de revisão.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: a página de destino de um dispositivo é inválida, mas a de outro é 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 ativação.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: em processo de revisão pelo Baidu. Gemini: critério em análise.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: critério a ser revisado.
AD_GROUP_CRITERION_ON_HOLD

Obsoleto. Não use. Usado anteriormente pelo Gemini

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

KeywordInfo

Um critério de palavra-chave.

Representação JSON
{
  "matchType": enum (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

Tipos de correspondência de palavra-chave possíveis.

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

ListingGroupInfo

Um critério de grupo de fichas.

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

enum (ListingGroupType)

Tipo do grupo de produtos anunciados.

ListingGroupType

O tipo do grupo de fichas.

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 de 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 do grupo de produtos anunciados 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 grupo demográfico (por exemplo, feminino).

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

UserListInfo

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

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 esse parâmetro. O valor de 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 de páginas 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 da página da Web.

operator

enum (WebpageConditionOperator)

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

argument

string

Argumento da condição de segmentação da página 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 valor de retorno. Representa um valor desconhecido nesta versão.
URL Operando que indica uma condição de segmentação do URL da página da Web.
CATEGORY Operando que indica uma condição de segmentação por categoria de página da web.
PAGE_TITLE Operando que indica uma condição de segmentação do título da 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 da 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 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 local.

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

string

O nome do recurso constante de destino geográfico.

AdGroupCriterionLabel

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

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

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.

AdGroupLabel

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

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

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.

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 recursos 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. 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 ativo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
YOUTUBE_VIDEO recurso de vídeo do YouTube.
MEDIA_BUNDLE Recurso de pacote de mídia.
IMAGE recurso de imagem.
TEXT Recurso de texto.
LEAD_FORM Recurso de formulário de lead.
BOOK_ON_GOOGLE Recurso das Reservas no Google.
PROMOTION Recurso de promoção.
CALLOUT Recurso de frase de destaque.
STRUCTURED_SNIPPET Recurso de snippet estruturado.
PAGE_FEED recurso de 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 Hotéis e recursos de aluguel dinâmicos.
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 Recursos de jobs dinâmicos.
LOCATION Recurso de local.
HOTEL_PROPERTY Recurso de propriedade do hotel.

AssetStatus

Os status possíveis 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 está arquivado.
PENDING_SYSTEM_GENERATED O recurso é gerado pelo sistema com revisão pendente do usuário.

AssetEngineStatus

Próximo ID = 11

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SERVING O recurso está ativo.
SERVING_LIMITED O recurso está ativo 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 da 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 desta imagem em tamanho original.

fileSize

string (int64 format)

É o tamanho do arquivo do recurso 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 imagem/jpeg.
IMAGE_GIF Tipo MIME de imagem/gif.
IMAGE_PNG Tipo MIME de imagem/png.
FLASH Tipo MIME de aplicativo/x-shockwave-flash.
TEXT_HTML Tipo MIME de texto/html.
PDF Tipo MIME de aplicativo/pdf.
MSWORD Tipo MIME de aplicativo/msword.
MSEXCEL Tipo MIME de aplicativo/vnd.ms-excel.
RTF Tipo MIME de aplicativo/rtf.
AUDIO_WAV Tipo MIME de áudio/wav.
AUDIO_MP3 Tipo MIME de áudio/mp3.
HTML5_AD_ZIP Tipo MIME de application/x-html5-ad-zip.

ImageDimension

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

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

string (int64 format)

É a 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 de quando este recurso entra em vigor e pode começar a ser veiculado, 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.

adScheduleTargets[]

object (AdScheduleInfo)

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

useSearcherTimeZone

boolean

Indica se o recurso será mostrado no fuso horário do usuário da pesquisa. Aplicável ao Microsoft Ads.

AdScheduleInfo

Representa um critério AdSchedule.

O AdSchedule é especificado como o dia da semana e um intervalo de tempo em que os anúncios são exibidos.

Não é possível adicionar mais de seis AdSchedules 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 o horário 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 horário de término da programação. A programação exclui o minuto de término.

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

Hora de início no formato 24 horas. Este campo deve estar entre 0 e 23 (valores inclusivos).

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

endHour

integer

Hora de término no formato 24 horas. 24 significa o fim do dia. Este campo deve estar entre 0 e 24 (valores inclusivos).

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

MinuteOfHour

Enumera de quartos de horas. Por exemplo, "FIFTEEN"

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

DayOfWeek

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

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 de quando este recurso entra em vigor e pode começar a ser veiculado, 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.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especifica todos os intervalos 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 os cliques do recurso de sitelink. Esta é uma conta de mecanismo do Yahoo! Japan.

useSearcherTimeZone

boolean

Indica se o recurso de sitelink será mostrado no fuso horário do usuário da pesquisa. Aplicável ao Microsoft Ads.

mobilePreferred

boolean

Indica se a preferência é que o recurso de sitelink seja exibido em dispositivos móveis. Aplicável ao 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 aplicativo 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 o aplicativo específico.

MobileAppVendor

Tipo de fornecedor de app para dispositivos móveis

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
APPLE_APP_STORE Fornecedor de app para dispositivos móveis da Apple app store.
GOOGLE_APP_STORE Fornecedor de app para dispositivos móveis da Google app 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: 'BR', 'nós'.

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 será atribuída. Se ela não for definida, a ação de conversão padrão será usada. Este campo só terá efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

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

callTrackingEnabled

boolean

Se a chamada deve ser ativada no acompanhamento de chamadas. Aplicável ao Microsoft Ads.

useSearcherTimeZone

boolean

Indica se a extensão de chamada será exibida no fuso horário do usuário da pesquisa. Aplicável ao Microsoft Ads.

startDate

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, 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 da ação de conversão de chamada.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
DISABLED A ação de conversão de chamada está desativada.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION A ação de conversão de chamada 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 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 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 é "Solicite um orçamento".
APPLY_NOW O tipo de call-to-action agora é aplicado.
SIGN_UP O tipo de call-to-action é "Inscreva-se".
CONTACT_US O tipo de call-to-action é "Entre em contato".
SUBSCRIBE O tipo de call-to-action é "inscrever-se".
DOWNLOAD O tipo de call-to-action é download.
BOOK_NOW O tipo de call-to-action é "Reserve agora".
SHOP_NOW O tipo de call-to-action é "Compre agora".
BUY_NOW O tipo de call-to-action é "Compre agora".
DONATE_NOW O tipo de call-to-action é "Doe agora".
ORDER_NOW O tipo de call-to-action é "Peça agora".
PLAY_NOW O tipo de call-to-action é "reproduzir agora".
SEE_MORE O tipo de call-to-action é "ver mais".
START_NOW O tipo de call-to-action começa agora.
VISIT_SITE O tipo de call-to-action é "Visite o site".
WATCH_NOW O tipo de call-to-action é "Assista 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 da empresa 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 de local. Se o tipo for BUSINESS_OWNER, ele será veiculado como uma extensão de local. Se o tipo for AFILIADO, ele será veiculado como um local de afiliado.

BusinessProfileLocation

Os dados de local do Perfil da Empresa foram 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. A sincronização é feita com a conta do Perfil da Empresa.

storeCode

string

Código da loja do Perfil da Empresa deste local. A sincronização é feita com a conta do Perfil da Empresa.

listingId

string (int64 format)

ID da ficha da empresa desse local do Perfil da Empresa. Sincronizada na conta vinculada do Perfil da Empresa.

LocationOwnershipType

Possíveis tipos de propriedade de local.

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

AssetGroupAsset

AssetGroupAsset é o vínculo entre um recurso e um grupo de recursos. Adicionar 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 o seguinte formato:

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

assetGroup

string

O grupo a que este recurso está sendo vinculado.

asset

string

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

fieldType

enum (AssetFieldType)

A descrição da posição do recurso no grupo de recursos. 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 os possíveis posicionamentos 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 ser usado como título.
DESCRIPTION O recurso está vinculado para ser usado como uma descrição.
MANDATORY_AD_TEXT O recurso está vinculado para ser usado como texto de anúncio obrigatório.
MARKETING_IMAGE O recurso está vinculado para ser usado como imagem de marketing.
MEDIA_BUNDLE O recurso está vinculado para ser usado como um pacote de mídia.
YOUTUBE_VIDEO O recurso está vinculado para ser usado como um vídeo do YouTube.
BOOK_ON_GOOGLE O recurso é vinculado para indicar que uma campanha de hotel é "Reservas no Google". ativado.
LEAD_FORM O recurso está vinculado para ser usado como uma extensão de formulário de lead.
PROMOTION O recurso está vinculado para ser usado como uma extensão de promoção.
CALLOUT O recurso está vinculado para ser usado como uma extensão de frase de destaque.
STRUCTURED_SNIPPET O recurso está vinculado para ser usado como uma extensão de snippets estruturados.
MOBILE_APP O recurso está vinculado para ser usado como uma extensão de aplicativo 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 ser usado como uma extensão de chamada.
PRICE O recurso está vinculado para ser usado 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 ser usado como nome de empresa.
SQUARE_MARKETING_IMAGE O recurso está vinculado para ser usado como uma imagem de marketing quadrada.
PORTRAIT_MARKETING_IMAGE O recurso está vinculado para uso como imagem de marketing no modo retrato.
VIDEO O recurso está vinculado para ser usado como um logotipo que não é do YouTube.
CALL_TO_ACTION_SELECTION O recurso está vinculado para ser usado para selecionar uma call-to-action.
AD_IMAGE O recurso está vinculado para ser usado na seleção de uma imagem de anúncio.
HOTEL_PROPERTY O recurso está 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 está mais propenso a fazer uma conversão. A campanha Performance Max usa o indicador para procurar novas pessoas com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais.

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

  // Union field 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 a que esse 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 Audience.

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 do qual este filtro do grupo de produtos anunciados do grupo de recursos faz parte.

id

string (int64 format)

O ID do ListingGroupFilter.

type

enum (ListingGroupFilterType)

Tipo de nó de filtro do grupo de fichas.

vertical

enum (ListingGroupFilterVertical)

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

caseValue

object (ListingGroupFilterDimension)

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

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

O tipo de filtro do grupo de fichas.

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 do grupo de fichas da empresa incluído.
UNIT_EXCLUDED Um nó de folha de filtro do grupo de fichas excluído.

ListingGroupFilterVertical

O tipo de 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 indústria de compras. A indústria só é permitida em campanhas Performance Max para varejo.

ListingGroupFilterDimension

Listando dimensões 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 de 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 um 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, suas 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.

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

ListingGroupFilterBiddingCategoryLevel

O nível da categoria de lances 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.
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 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 valor de retorno. Representa um valor desconhecido nesta versão.
NEW A condição do produto é nova.
REFURBISHED O estado do produto foi recondicionado.
USED A condição do produto é usada.

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 valor de retorno. Representa um valor desconhecido nesta versão.
INDEX0 Atributo personalizado do filtro do primeiro grupo de produtos anunciados.
INDEX1 Segundo atributo personalizado do filtro de grupo de produtos anunciados.
INDEX2 Atributo personalizado do filtro do grupo de produtos anunciados do terceiro.
INDEX3 Quarto atributo personalizado do filtro do grupo de fichas.
INDEX4 Quinto atributo personalizado do filtro do grupo de fichas.

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 um produto.

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

enum (ListingGroupFilterProductTypeLevel)

Nível do tipo.

value

string

Valor do tipo.

ListingGroupFilterProductTypeLevel

Enumeração que descreve o nível do tipo de oferta de um produto.

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

ListingGroupFilterDimensionPath

O caminho que define as dimensões que definem um filtro do grupo de fichas.

Representação JSON
{
  "dimensions": [
    {
      object (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 da visualização de combinação principal de AssetGroup têm o seguinte formato: `"customers/{customerId}/assetGroupTopCollectionViews/{asset_group_id}~{asset_ callout_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

As principais combinações de recursos que foram 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.

AssetUsage

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

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

string

Nome do recurso.

servedAssetFieldType

enum (ServedAssetFieldType)

O tipo de campo veiculado do recurso.

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 essa opção apenas 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 em uma imagem em modo retrato.
LONG_HEADLINE O recurso foi usado em um título longo (usado em MultiAssetAssetAd).
DESCRIPTION O recurso foi usado em uma descrição. Use isso apenas 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 em uma imagem em modo retrato.
BUSINESS_NAME_IN_PORTRAIT O recurso foi usado como o 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 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 no 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 Este recurso é usado como uma ligação.
MOBILE_APP Este recurso é usado como um app para dispositivos móveis.
CALLOUT Esse recurso é usado como frase de destaque.
STRUCTURED_SNIPPET Esse recurso é usado como um snippet estruturado.
PRICE Este recurso é usado como um preço.
PROMOTION Este recurso é usado como uma promoção.
AD_IMAGE Este 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. 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 dos grupos 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 à qual esse grupo de recursos está associado. O recurso que está vinculado ao grupo de recursos.

name

string

Obrigatório. Nome do grupo de recursos. Obrigatório. Ele deve ter comprimento mínimo de 1 e comprimento máximo de 128. 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, por padrão, os URLs são qualificados para expansão, a menos que sejam desativados.

finalMobileUrls[]

string

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

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. Esse campo só pode ser definido quando "path1" está definido.

adStrength

enum (AdStrength)

Qualidade geral do anúncio desse grupo de recursos.

AssetGroupStatus

Os status possíveis 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

Enumeração que lista as possíveis qualidades do anúncio.

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

AssetSetAsset

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

Representação JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Campos
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}/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 recurso do conjunto de recursos. Somente leitura.

AssetSetAssetStatus

Os status possíveis de um recurso do 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 de três letras do ISO 4217).

Para estratégias de lances em clientes administradores, essa moeda pode ser definida na criação, e o padrão é a moeda do cliente administrador. Para clientes atendidos, este 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 para clientes administradores, essa é a moeda definida pelo anunciante ao criar a estratégia. Para atender clientes, 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.

Somente um pode ser definido. 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áticos para ajudar 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áticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder o orçamento.

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetOutrankShare

object (TargetOutrankShare)

Uma estratégia que define lances com base na fração desejada de leilões em que o anunciante deve superar um concorrente específico. 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. As mutações em 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 de lances que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

BiddingStrategyStatus

Os status possíveis de uma BiddingStrategy.

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 foi removida.

BiddingStrategyType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
COMMISSION A comissão é uma estratégia de lances automá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 em áreas com menor probabilidade.
INVALID Usado apenas para valor de retorno. Indica que uma campanha não tem uma estratégia de lances. Isso impede que a campanha seja veiculada. Por exemplo, uma campanha pode ser anexada a uma estratégia de lances de administrador e a conta de veiculação é desvinculada da conta de administrador. Nesse caso, a campanha vai ser automaticamente removida da estratégia de lances do administrador, agora inacessível, e passar para o tipo de estratégia de lances INVÁLIDA.
MANUAL_CPA Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante.
MANUAL_CPC Lances com base em cliques manuais nos quais o usuário paga por clique.
MANUAL_CPM Lance baseado na impressão manual, no qual o usuário para por mil impressões.
MANUAL_CPV Uma estratégia de lances que paga um valor configurável por exibição de vídeo.
MAXIMIZE_CONVERSIONS Uma estratégia de lances que maximiza automaticamente o número de conversões de acordo com um orçamento diário.
MAXIMIZE_CONVERSION_VALUE Uma estratégia de lances automáticos que define lances automaticamente para maximizar a receita sem exceder o orçamento disponível.
PAGE_ONE_PROMOTED Esquema de lances de primeira página promovida, que define lances máximos de CPC para segmentar impressões nos espaços promovidos na página um ou na página um no google.com. O uso desse valor de enumeração foi descontinuado.
PERCENT_CPC O CPC percentual é uma estratégia de lances na qual 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áticos que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu.
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 dos anúncios de pesquisa seja exibida na parte superior da primeira página (ou em outra região de segmentação).
TARGET_OUTRANK_SHARE A parcela de superação desejada é uma estratégia de lances automáticos que define lances com base na fração desejada de leilões em que o anunciante deve superar um concorrente específico. O uso desse valor de enumeração foi descontinuado.
TARGET_ROAS O ROAS desejado é uma estratégia de lances automáticos que ajuda você a maximizar a receita enquanto calcula a média de um retorno do investimento médio (ROAS) desejado específico.
TARGET_SPEND O gasto desejado é uma estratégia de lances automática que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

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 em áreas 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áticos para ajudar 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 somente 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áticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder 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 na moeda da estratégia de lances. Se definida, a estratégia de lances receberá o maior número possível de conversões sem exceder o custo por ação desejado. Se o CPA desejado não for definido, a estratégia de lances buscará o menor CPA possível considerando o orçamento.

TargetCpa

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

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 dos anúncios de pesquisa seja exibida na parte superior da primeira página (ou em outra região de segmentação).

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

A fração escolhida de anúncios a ser exibida na região de segmentação, 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 possíveis metas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ANYWHERE_ON_PAGE Qualquer local da página da Web.
TOP_OF_PAGE Caixa de anúncios na parte de cima.
ABSOLUTE_TOP_OF_PAGE Espaço superior na caixa superior dos 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 deve superar um concorrente específico. Essa 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áticos que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

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

string (int64 format)

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

CampaignBudget

Um orçamento de 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 entrega de um orçamento.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
STANDARD O servidor de orçamentos controlará o serviço de forma equilibrada durante todo o período.
ACCELERATED O servidor de orçamentos não controlará o serviç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 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 de orçamento para todo o período.

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)
  },
  "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 da 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 somente 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 da segmentação geográfica de anúncios.

labels[]

string

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

biddingStrategyType

enum (BiddingStrategyType)

É o tipo de estratégia de lances.

Para criar uma estratégia de lances, defina o esquema de lances para criar uma estratégia de lances padrão ou o campo biddingStrategy para gerar uma estratégia de lances de portfólio.

Este campo é somente leitura.

accessibleBiddingStrategy

string

Nome do recurso de AccessibleBiddingStrategy, 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 irrestritos de estratégia estão disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Por outro lado, os atributos restritos estão disponíveis apenas para o cliente proprietário da estratégia e seus gerentes. Os atributos restritos só podem ser lidos no recurso BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

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

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. As vinculações de recursos com esses tipos de campo não serão herdadas do nível superior por esta campanha.

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. Em vez disso, use createTime.

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 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 a páginas de destino veiculadas com o acompanhamento paralelo.

urlExpansionOptOut

boolean

Representa a desativação da expansão de URL para URLs mais segmentados. Se desativado (verdadeiro), somente os URLs finais do grupo de recursos ou os URLs especificados nos feeds de dados da empresa ou do Google Merchant Center do anunciante serão segmentados. Se a opção for 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 um portfólio (criado por meio do serviço BiddingStrategy) ou um padrão incorporado à campanha. campaign_bidding_strategy pode ser apenas de um dos tipos a seguir:

biddingStrategy

string

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 manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante. Compatível apenas com campanhas dos Serviços Locais.

manualCpc

object (ManualCpc)

Estratégia de lances manuais padrão de CPC. Lance baseado em clique manual, no qual o usuário paga por clique.

manualCpm

object (ManualCpm)

Estratégia de lances de CPM manual padrão. Lance baseado em impressão manual, no qual 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)

A estratégia de lances padrão "Maximizar o valor da conversão" que define automaticamente os lances para maximizar a receita gastando 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áticos que define lances para atingir uma determinada porcentagem de impressões.

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

A 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 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 Disponibilização.
NONE Nenhum.
ENDED Concluído.
PENDING Pendente.
SUSPENDED Suspenso.

BiddingStrategySystemStatus

Os possíveis status do sistema de uma BiddingStrategy.

Enums
UNSPECIFIED Sinaliza 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 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á aprendendo por causa de uma alteração recente no orçamento.
LEARNING_COMPOSITION_CHANGE A estratégia de lances está aprendendo devido a uma alteração recente no número de campanhas, grupos de anúncios ou palavras-chave associados a ela.
LEARNING_CONVERSION_TYPE_CHANGE A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão modificados recentemente pelo cliente que foram relevantes para a estratégia.
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 lance máximo.
LIMITED_BY_CPC_BID_FLOOR A estratégia de lances está limitada pelo lance mínimo.
LIMITED_BY_DATA A estratégia de lances está limitada porque não houve tráfego de conversão suficiente nas últimas semanas.
LIMITED_BY_BUDGET Uma fração significativa das palavras-chave nessa estratégia de lances está limitada pelo orçamento.
LIMITED_BY_LOW_PRIORITY_SPEND A estratégia de lances não pode atingir o gasto desejado porque a prioridade dele foi reduzida.
LIMITED_BY_LOW_QUALITY Uma fração 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 Não há acompanhamento de conversões (sem pings) e/ou listas de remarketing para CIS.
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 configuradas incorretamente.
MISCONFIGURED_SHARED_BUDGET Existem 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 ativos vinculados à estratégia de lances. ou não há orçamentos ativos conectados à estratégia de lances.
UNAVAILABLE No momento, esta estratégia de lances não é compatível com relatórios de status.
MULTIPLE_LEARNING Havia vários status do sistema LEARNING_* para essa estratégia de lances durante o período em questão.
MULTIPLE_LIMITED Havia vários status do sistema LIMITED_* para essa estratégia de lances durante o período em questão.
MULTIPLE_MISCONFIGURED Havia vários status de sistema MISCONFIGURED_* para essa estratégia de lances durante o período em questão.
MULTIPLE Havia vários status 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 do anúncio foi otimizada com base na CTR da campanha.
CONVERSION_OPTIMIZE A veiculação do anúncio é otimizada com base na CTR * Conversão da campanha. Se a campanha não estiver na estratégia de lances do otimizador de conversões, o padrão será OTIMIZADO.
ROTATE Os anúncios são rotacionados de maneira uniforme por 90 dias e, depois, otimizados para cliques.
ROTATE_INDEFINITELY Exiba anúncios com desempenho inferior de forma mais uniforme com anúncios de melhor desempenho e não otimize.
UNAVAILABLE O status de otimização do serviço de anúncios não está disponível.

AdvertisingChannelType

Enumeração que descreve os vários tipos de canal de publicidade.

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 Apenas na Rede de Display do Google.
SHOPPING As campanhas do Shopping são veiculadas na propriedade do Shopping e nos resultados da pesquisa do google.com.br.
HOTEL campanhas de anúncios de hotel.
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 Performance Max.
LOCAL_SERVICES Campanhas dos 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 valor de retorno. Representa um valor desconhecido nesta versão.
SEARCH_MOBILE_APP Campanhas de apps para dispositivos móveis da rede de pesquisa.
DISPLAY_MOBILE_APP campanhas de apps para dispositivos móveis da Rede de Display.
SEARCH_EXPRESS Campanhas do AdWords Express 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 de vídeo TrueView for Action.
VIDEO_NON_SKIPPABLE Campanhas de vídeo com anúncios em vídeo não puláveis.
APP_CAMPAIGN Campanha para apps que permite promover facilmente seu app Android ou iOS nos principais Serviços do Google, incluindo a Pesquisa, o Google Play, o YouTube e a Rede de Display do Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Campanha de apps para engajamento, com foco em gerar reengajamento com o app em várias das principais propriedades do Google, incluindo a Pesquisa, o YouTube e a Rede de Display do Google.
LOCAL_CAMPAIGN Campanhas especializadas para publicidade local.
SHOPPING_COMPARISON_LISTING_ADS campanhas 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 Acompanhamento do Facebook somente 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 somente 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 (exige 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 de 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 dos produtos a serem incluídos na campanha. Somente um feedLabel ou salesCountry pode ser definido. Se for usado em vez de salesCountry, o campo feedLabel aceitará códigos de país no mesmo formato, por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center.

useVehicleInventory

boolean

Define se o inventário de informações 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 não pode ser modificado nas campanhas do Shopping.

salesCountry

string

País de vendas 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. Este 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

Indica se produtos disponíveis na loja física 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 nesta campanha específica.

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PRESENCE_OR_INTEREST Especifica que um anúncio será acionado se o usuário mostrar interesse ou estiver nas regiões de segmentação do anunciante.
SEARCH_INTEREST Especifica que um anúncio será acionado se o usuário pesquisar as regiões de segmentação do anunciante. Esse recurso só pode ser usado em campanhas padrão do Shopping e de pesquisa.
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 por área geográfica negativa.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PRESENCE_OR_INTEREST Especifica que um usuário não verá o anúncio se ele estiver em, ou mostrar interesse, em locais excluídos do anunciante.
PRESENCE Especifica que um usuário não verá o anúncio se ele 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

O conjunto selecionado de ações de conversão para otimizar esta campanha.

OptimizationGoalSetting

Configuração da meta de otimização desta 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 valor de retorno. Representa um valor desconhecido nesta versão.
CALL_CLICKS Otimizar para cliques de chamada. As conversões de clique de chamada representam o número de vezes que as pessoas selecionaram "Ligação" para entrar em contato com uma loja depois de ver um anúncio.
DRIVING_DIRECTIONS Otimize para gerar rotas de carro. As conversões de rotas de carro são vezes que as pessoas selecionaram "Como chegar" como navegar até uma loja depois de visualizar um anúncio.
APP_PRE_REGISTRATION Otimizar para pré-registro. As conversões de pré-registro indicam 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 acompanhamento dinâmico.

ManualCpa

Esse tipo não tem campos.

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

ManualCpc

Lance baseado em clique manual, no qual 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.

Lance baseado em impressão manual, no qual 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. Este é um campo opcional inserido pelo anunciante e especificado em micros locais. Observação: o valor zero é interpretado da mesma maneira que "bid_threshold" 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 cpcBidCeilingMicros, mas o valor médio do lance de uma campanha não deve.

TargetCpm

Esse tipo não tem campos.

O CPM (custo por mil impressões) desejado é uma estratégia de lances automática que define lances para otimizar o desempenho de acordo com o CPM desejado que você definiu.

CampaignAsset

Um vínculo entre uma campanha e um recurso.

Representação JSON
{
  "resourceName": string,
  "status": enum (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

CampaignAssetSet é o vínculo entre uma campanha e um conjunto de recursos. Adicionar um CampaignAssetSet vincula um conjunto de recursos a uma campanha.

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

string

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

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

campaign

string

A campanha à qual esse conjunto de recursos está vinculado.

assetSet

string

O conjunto de recursos que está 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 do 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

Define 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 foi 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 linguagem.

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 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 compatíveis com as constantes da segmentação geográfica. Os milissegundos e metros são aceitos para conjuntos de itens do feed. Isso é obrigatório e deve ser definido nas 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. Este campo não pode ser usado com geoTargetConstants. Isso é opcional e só pode ser definido em operações CREATE.

radius

string (int64 format)

Distância em unidades que especificam o raio ao redor 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 locais (por exemplo, MILES)

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

CampaignLabel

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

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

string

Nome do recurso. Os nomes dos recursos do rótulo da 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.

CartDataSalesView

Visualização de vendas de dados do carrinho.

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

string

O nome do recurso da vista de vendas de dados do carrinho. Os nomes dos recursos da visualização de vendas dos dados do carrinho têm o seguinte 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 de recurso do público. 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 deve ser único para todos os públicos-alvo. Ele deve ter comprimento mínimo de 1 e comprimento máximo de 255.

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ção 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)

Categoria de conversões registradas para essa ação de conversã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 desta ação de conversão.

floodlightSettings

object (FloodlightSettings)

Configurações do Floodlight para os 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 "primaryForGoal". Portanto, se uma campanha tiver uma meta desse tipo configurada com uma "primaryForGoal = ação de conversão falsa", essa ação ainda poderá receber lances. Por padrão, primaryForGoal será verdadeiro se não for definido. Na V9, primaryForGoal só pode ser definido como falso após a criação por meio de uma 'atualização' porque ela não foi declarada 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

Se essa ação de conversão deve ser incluída na coluna "clientAccountConversions" métrica.

includeInConversionsMetric

boolean

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

clickThroughLookbackWindowDays

string (int64 format)

O número máximo de dias 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 aparecerá na interface.

ConversionActionType

Tipos possíveis 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.
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 pelo faturamento do Android.
UPLOAD_CALLS Conversões de chamada que são rastreadas pelo anunciante e enviadas.
UPLOAD_CLICKS Conversões que são rastreadas pelo anunciante e enviadas com cliques atribuídos.
WEBPAGE Conversões que ocorrem em uma página da Web.
WEBSITE_CALL Conversões que ocorrem quando um usuário liga para um número de telefone gerado dinamicamente a partir do site de um anunciante.
STORE_SALES_DIRECT_UPLOAD Conversão de vendas na loja com base em uploads de dados próprios ou de comerciantes de terceiros. Somente clientes na lista de permissões podem usar os tipos de upload direto de vendas na loja.
STORE_SALES Conversão de vendas na loja com base em uploads de dados próprios ou de terceiros e/ou de compras na loja usando cartões de redes de pagamento. Somente clientes na lista de permissões podem usar os tipos de vendas na loja. Somente leitura.
FIREBASE_ANDROID_FIRST_OPEN Conversões de primeiro acesso do app Android acompanhadas com o Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversões de compra no aplicativo para Android acompanhadas com o 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 com o Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversões de compra no aplicativo do app iOS acompanhadas com o 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 do app Android acompanhadas pela análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversões de compra no aplicativo de aplicativo Android acompanhadas por meio da análise de aplicativos 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 do app iOS acompanhadas pela análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversões de compra no aplicativo no aplicativo para iOS acompanhadas por meio da análise de aplicativos de terceiros.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversões personalizadas de aplicativos iOS acompanhadas por meio da análise de aplicativos de terceiros.
ANDROID_APP_PRE_REGISTRATION Conversões que ocorrem quando um usuário faz o pré-registro de um 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 acompanhados por um tipo específico de aplicativo. 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 pode 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 registradas 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 Conversões de chamada que ocorrem em anúncios da campanha inteligente sem configuração do acompanhamento de chamadas e usando critérios personalizados da campanha inteligente. Somente leitura.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL O usuário clica em um elemento de chamada no Google Maps. Apenas campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_MAP_DIRECTIONS O usuário solicita rotas para um local da empresa no Google Maps. Apenas campanhas inteligentes. Somente leitura.
SMART_CAMPAIGN_TRACKED_CALLS Conversões de chamada que ocorrem em anúncios da campanha inteligente com acompanhamento de chamadas configurado e usando critérios personalizados da campanha inteligente. Somente leitura.
STORE_VISITS Conversões que ocorrem quando um usuário visita a loja de varejo de um anunciante. Somente leitura.
WEBPAGE_CODELESS Conversões criadas com base em eventos do site (como envios de formulário ou carregamentos de página) que não usam snippets de evento codificados individualmente. Somente leitura.
UNIVERSAL_ANALYTICS_GOAL Conversões provenientes de metas vinculadas do Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Conversões que vêm de transações vinculadas do Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM Conversões que vêm de conversões de eventos personalizados vinculadas do Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE Conversões que vêm de conversões de compra vinculadas ao Google Analytics 4.

ConversionActionCategory

A categoria de conversões associadas a uma ConversionAction.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
DEFAULT Categoria padrão.
PAGE_VIEW Usuário acessando uma página.
PURCHASE Compra, vendas ou "pedido feito" evento.
SIGNUP Ação do usuário da inscrição.
LEAD Ação de geração de leads.
DOWNLOAD Ação de download de software (como de um app).
ADD_TO_CART A adição de itens a um carrinho de compras no site de um anunciante.
BEGIN_CHECKOUT Quando alguém inicia o processo de finalização da compra no site de um anunciante.
SUBSCRIBE_PAID O início de uma assinatura paga de um produto ou serviço.
PHONE_CALL_LEAD Uma chamada para indicar interesse na oferta de um anunciante.
IMPORTED_LEAD Uma conversão de lead importada de uma fonte externa para o Google Ads.
SUBMIT_LEAD_FORM Um envio de formulário no site de um 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 o site de um parceiro do anunciante.
CONTACT Uma ligação, SMS, e-mail, chat ou outro tipo de contato com o anunciante.
ENGAGEMENT Um evento de engajamento com o site, como um longo tempo no site ou uma meta inteligente do Google Analytics (GA). Destina-se ao uso para importações de metas de ouro do GA, Firebase e GA.
STORE_VISIT Uma visita a uma loja física.
STORE_SALE Uma venda que ocorre em uma loja física.
QUALIFIED_LEAD Uma conversão de lead importada de uma fonte externa para o Google Ads, que foi mais qualificada pelo anunciante (equipe de marketing/vendas). Na jornada do lead até a venda, os anunciantes obtêm leads e, em seguida, agem de acordo com eles entrando 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 origem 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 de conversã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 de conversão forem enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão estiver configurada para usar sempre o valor padrão.

alwaysUseDefaultValue

boolean

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

AttributionModelSettings

Configurações relacionadas ao modelo de atribuição desta 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 em várias interações anteriores possivelmente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EXTERNAL Usa atribuição externa.
GOOGLE_ADS_LAST_CLICK Atribui todo o crédito de uma conversão ao último clique.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Atribui todo o crédito de uma conversão ao primeiro clique usando a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Atribui crédito a uma conversão igualmente entre todos os cliques dela 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 (a meia-vida é de uma semana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Atribui 40% do crédito de uma conversão aos primeiros e últimos cliques dela. Os 20% restantes serão distribuídos de maneira uniforme entre todos os outros cliques. Isso usa a atribuição da Pesquisa Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Modelo flexível que usa aprendizado de máquina para determinar a distribuição apropriada de crédito entre 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 valor de retorno. Representa um valor desconhecido nesta versão.
AVAILABLE O modelo baseado em dados está disponível.
STALE O modelo baseado em dados está desatualizado. Ele não é atualizado há pelo menos sete dias. Ele ainda está sendo usado, mas vai expirar se não for atualizado por 30 dias.
EXPIRED O modelo baseado em dados expirou. Ele não é atualizado há pelo menos 30 dias e não pode ser usado. Isso geralmente ocorre porque não houve o número necessário de eventos nos últimos 30 dias.
NEVER_GENERATED O modelo baseado em dados nunca foi gerado. Isso geralmente ocorre porque nunca houve o número necessário de eventos em um período de 30 dias.

FloodlightSettings

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

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

string

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 deve ser exclusivo. O tamanho máximo do nome é de 100 caracteres. Não deve haver espaços adicionais antes e depois.

tag

string

Obrigatório. A tag da variável personalizada de conversão. A tag deve ser única e consistir em um "u" caractere diretamente seguido por um número menor que ormigual 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 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 das 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 está ativada e vai acumular estatísticas.
PAUSED A variável personalizada de conversão está pausada e não acumulará estatísticas até ser definida novamente como ATIVADO.

ConversionCustomVariableFamily

Família 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.
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 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 poderão acumular novos valores se estiver ativada.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT A variável personalizada de conversão tem uma cardinalidade que excede o limite de segmentação, mas não excede o limite de estatísticas. A segmentação será desativada, mas as estatísticas poderão acumular novos valores se a variável estiver ativada.
APPROACHES_STATS_LIMIT A variável personalizada de conversão excedeu os limites de segmentação e está se aproximando dos limites de estatísticas (> 90%). A segmentação será desativada, mas as estatísticas poderão acumular novos valores se a variável estiver ativada.
EXCEEDS_STATS_LIMIT A variável personalizada de conversão excedeu os limites de segmentação e de estatísticas. A segmentação será desativada, e as estatísticas das variáveis ativadas só poderão ser acumuladas se os valores atuais não aumentarem mais a cardinalidade da variável.

FloodlightConversionCustomVariableInfo

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

Representação JSON
{
  "floodlightVariableType": enum (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 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. Consulte https://support.google.com/searchads/answer/4397154?hl=en para saber mais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
NUMBER Representa uma variável do Floodlight de "Número" não é válido. Essa variável pode ser atribuída às variáveis do Floodlight dos tipos DIMENSION ou METRIC.
STRING Representa uma variável do Floodlight de "String" não é válido. Essa variável pode ser atribuída a variáveis do Floodlight do tipo DIMENSION.

Cliente

Um cliente.

Representação JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (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 de recurso do cliente. Os nomes de recursos dos clientes 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 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

Um conjunto de configurações de todo o 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ê estiver usando o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura. Para mais informações, consulte https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

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

enhancedConversionsForLeadsEnabled

boolean

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 onde 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 essa conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (o conversionAcompanhamentoStatus sim). Este campo é somente leitura.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

O ID de acompanhamento de conversões do gerente do cliente. É definido quando o cliente ativa o acompanhamento de conversões e substitui o conversionAcompanhamentoId. 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 gerente do cliente. É 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 valor de retorno. Representa um valor desconhecido nesta versão.
NOT_CONVERSION_TRACKED O cliente não usa acompanhamento de conversões.
CONVERSION_TRACKING_MANAGED_BY_SELF As ações de conversão são criadas e gerenciadas por esse cliente.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER As ações de conversão são criadas e gerenciadas pelo administrador especificado no login-customer-id da solicitação.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER As ações de conversão são criadas e gerenciadas por um administrador diferente do cliente ou administrador especificado no login-customer-id da solicitação.

AccountType

Possíveis tipos de conta de mecanismo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BAIDU conta do Baidu.
ENGINE_TRACK 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 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 ao cliente no formato do banco de dados de fuso horário IANA, como America/New_York.

AccountStatus

Possíveis status de uma conta.

Enums
UNSPECIFIED Valor padrão.
UNKNOWN Valor desconhecido.
ENABLED A conta pode veicular anúncios.
PAUSED A conta foi desativada pelo usuário.
SUSPENDED A conta é desativada por um processo interno.
REMOVED A conta é desativada de forma irrevogável.
DRAFT A conta ainda está 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 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 que uma conta suspensa não pode veicular anúncios. Pode ser ativado somente pelo Suporte do Google.
CLOSED Indica que uma conta encerrada não pode veicular anúncios. A conta de teste também terá o status CLOSED. O status é permanente e não pode ser reaberto.

CustomerAsset

Um vínculo entre um cliente e um recurso.

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

string

O nome do recurso do cliente. Os nomes dos recursos de 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 é o vínculo entre um cliente e um conjunto de recursos. Adicionar um CustomerAssetSet vincula um conjunto de recursos a um cliente.

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

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

O conjunto de recursos que está vinculado ao cliente.

customer

string

O cliente ao qual este conjunto de recursos está vinculado.

status

enum (AssetSetLinkStatus)

O status do recurso 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.

Em contraste com a BiddingStrategy, esse recurso inclui estratégias de propriedade dos gerentes do cliente e compartilhadas com ele, além das estratégias dele. Esse recurso não oferece métricas e expõe apenas um subconjunto limitado dos atributos BiddingStrategy.

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

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

string

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

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

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

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

maximizeConversionValue

object (MaximizeConversionValue)

Uma estratégia de lances automáticos para ajudar 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áticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder o orçamento.

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

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 de lances que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

MaximizeConversionValue

Uma estratégia de lances automáticos para ajudar 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áticos para ajudar a gerar o maior número de conversões para suas campanhas sem exceder 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áticos que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu.

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 dos anúncios de pesquisa seja exibida na parte superior da primeira página (ou em outra região de segmentação).

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

A fração escolhida de anúncios a ser exibida na região de segmentação, 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áticos que define seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

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

string (int64 format)

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

Os possíveis status de uma vinculação.

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

CustomerClient

Um link entre o cliente em questão e um cliente cliente. Os CustomerClients existem apenas para clientes administradores. Todos os clientes de clientes diretos e indiretos estão incluídos, bem como o próprio gerente.

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

string

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

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

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 determinado cliente e cliente. Para o self link, 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 gerente. Somente leitura.

descriptiveName

string

Nome descritivo do cliente. Somente leitura.

currencyCode

string

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

id

string (int64 format)

O ID do 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 dos 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 selecionado dinamicamente da impressão.

Este campo é somente leitura.

GenderView

Uma visualização de gênero. O recurso genderView reflete o estado de veiculação efetiva, em vez de quais critérios foram adicionados. Um grupo de anúncios sem critérios de gênero por padrão é exibido para todos os sexos, portanto, todos os sexos aparecem em genderView 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 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 geográfica. Os nomes das constantes de recursos de segmentação geográfica têm o seguinte formato:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Status da constante da segmentação geográfica.

id

string (int64 format)

O ID da constante de segmentação geográfica.

name

string

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

countryCode

string

O código do 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 totalmente qualificado, que consiste no nome da segmentação, da segmentação pai e do país.

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Os possíveis status de uma constante de segmentação 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 da segmentação geográfica é válida.
REMOVAL_PLANNED A constante de segmentação geográfica está obsoleta e será removida.

KeywordView

Uma visualização de palavras-chave.

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

string

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

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

Rótulo

Um marcador.

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 rótulo que exibe texto em um 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 valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED O rótulo está ativado.
REMOVED O rótulo foi removido.

TextLabel

Um tipo de rótulo que exibe texto em um 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 do plano de fundo pode não estar visível nas contas de administrador.

description

string

Uma breve descrição do rótulo. O tamanho não pode ultrapassar 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 linguagem. Os nomes de recursos de constantes de linguagem 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 pode ser segmentado.

LocationView

Uma visualização de local resume o desempenho das campanhas por critério de local.

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

string

O nome do recurso da visualização do 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 do produto.

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 de lances do produto.

status

enum (ProductBiddingCategoryStatus)

Status da categoria de lance do produto.

id

string (int64 format)

ID da categoria de lance do produto.

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

countryCode

string

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

productBiddingCategoryConstantParent

string

Nome do recurso da categoria de lances do produto principal.

languageCode

string

Código do 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 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 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 de visualização do grupo de produtos têm o seguinte formato:

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

ShoppingPerformanceView

Visualização do desempenho do Shopping. Fornece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores de dimensão de produto do Merchant Center, como marca, categoria, atributos personalizados, condição 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 desempenho do Shopping têm o seguinte formato: customers/{customerId}/shoppingPerformanceView

UserList

Uma lista de usuários. Esta é 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 da lista de usuários têm o seguinte formato:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Tipo dessa lista.

Este campo é somente leitura.

id

string (int64 format)

ID da lista de usuários.

name

string

Nome dessa 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 A lista de usuários é representada como um conjunto de tipos de conversão.
LOGICAL A lista de usuários é representada como uma combinação de outras listas/interesses de usuários.
EXTERNAL_REMARKETING A lista de usuários criada na plataforma do Google Ad Manager.
RULE_BASED A lista de usuários associada a uma regra.
SIMILAR PCollection com usuários semelhantes aos de outra lista de usuários.
CRM_BASED lista de usuários com dados próprios de CRM fornecidos pelo anunciante na forma de e-mails ou outros formatos.

WebpageView

Uma visualização de página da Web.

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

string

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

customers/{customerId}/webpageViews/{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 está 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 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 de 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. Para conversões on-line, é igual à coluna "ID" ou à coluna floodlightOrderId, dependendo das instruções do Floodlight do 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, ATIVADO ou REMOVIDO.

assetId

string (int64 format)

ID do recurso que recebeu uma 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 SearchAds360

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
VISIT A conversão é atribuída a uma visita.
CRITERION_AD A conversão é atribuída a um critério e um par de anúncios.

ConversionStatus

Possíveis status de uma conversão.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A conversão está ativada.
REMOVED A conversão foi removida.

Métricas

Dados de métricas.

Representação JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (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,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": 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 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.

conversionCustomMetrics[]

object (Value)

As métricas personalizadas de conversão.

conversionsValueByConversionDate

number

A soma do valor das conversões que recebem lances por data de conversão. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 do histórico de pesquisa.

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 os anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo).

allConversionsFromClickToCall

number

O número de vezes que as pessoas clicaram no botão "Ligar" para ligar para uma loja durante ou depois de clicar em um anúncio. Esse número não informa se as chamadas foram atendidas ou a duração delas.

Essa métrica se aplica somente a itens do feed.

allConversionsFromDirections

number

O número de vezes que as pessoas clicaram em um link de "Como chegar" para acessar uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromInteractionsValuePerInteraction

number

O valor de todas as conversões de interações dividido pelo número total de interações.

allConversionsFromMenu

number

Quantas vezes os usuários clicaram em um link para ver o menu de uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromOrder

number

Quantas vezes os usuários fizeram um pedido em uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromOtherEngagement

number

O número de outras conversões (por exemplo, postar uma avaliação ou salvar o local de uma loja) que ocorreram depois que os usuários clicaram em um anúncio.

Essa métrica se aplica somente a itens do feed.

allConversionsFromStoreVisit

number

Número estimado de vezes que os usuários visitaram uma loja depois de clicar em um anúncio.

Essa métrica se aplica somente a itens do feed.

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 somente a 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

Média de conversões que recebem lances (de interação) por interação qualificada para conversão. Mostra com que frequência, em média, uma interação com o anúncio leva a uma conversão que recebe lances.

clientAccountConversionsValue

number

O valor das conversões da conta de cliente. Isso inclui apenas as ações de conversão que incluem o atributo includeInClientAccountConversionsMetric definido como verdadeiro. 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 as ações de conversão que incluem o atributo includeInConversionsMetric como verdadeiro. 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 que incluem o atributo includeInClientAccountConversionsMetric definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

costMicros

string (int64 format)

A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período. 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 qualificado de conversão por conversão que pode receber lances.

costPerCurrentModelAttributedConversion

number

O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão que incluem o atributo includeInConversionsMetric como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

crossDeviceConversions

number

Conversões geradas quando um cliente clica em um anúncio usando um dispositivo e realiza a conversão em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em todas as conversões.

crossDeviceConversionsValue

number

A soma do valor das conversões em dispositivos diferentes.

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 as ações de conversão que incluem o atributo includeInConversionsMetric como verdadeiro. 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ê.

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

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 um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostImpressionShare

number

A porcentagem estimada de vezes que seu anúncio estava qualificado para exibição na rede de pesquisa, mas não foi exibido porque o orçamento era muito baixo. Observação: a parcela de impressões perdidas do orçamento de pesquisa é relatada no intervalo de 0 a 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostTopImpressionShare

number

O número que estima a frequência com que seu anúncio não apareceu ao lado 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

O número que estima a frequência com que seu anúncio não apareceu 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 recebidas entre os anúncios na parte superior em comparação com o número estimado de impressões que você tinha qualificação para receber entre esses anúncios. 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 das suas 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 recebe lances dividido pelo número de conversões que podem receber lances. Mostra quanto vale, em média, cada uma das conversões que recebem lances.

valuePerConversionsByConversionDate

number

Valor de conversões que recebem lances por data de conversão dividido pelas conversões que recebem lances por data de conversão. Mostra quanto vale, em média, cada uma das conversões que recebem lances (por data de conversão). Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de 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 com venda cruzada é o custo total dos produtos vendidos que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu 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 com venda cruzada é o custo total dos produtos vendidos que não foram anunciados. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu 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.

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 o mesmo chapéu e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellGrossProfitMicros

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 o mesmo chapéu e uma camisa. O preço da camisa é de R$ 20, e o custo dos produtos vendidos é de R$ 5. O lucro bruto de venda cruzada desse pedido é R$ 15 = R$ 20 - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellRevenueMicros

string (int64 format)

A receita de venda cruzada da conta de cliente é o valor total que você ganha de produtos vendidos como resultado da publicidade de outro produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. 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 o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellRevenueMicros

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 o mesmo chapéu e uma camisa. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. A receita de venda cruzada desse pedido é de R$ 20. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellUnitsSold

number

As unidades vendidas em venda cruzada da conta de cliente representam o número total de produtos vendidos como resultado da publicidade de outro produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. As unidades vendidas em venda cruzada são o número total de produtos de venda cruzada em todos os pedidos atribuídos aos anúncios. Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas em venda cruzada neste pedido é 2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.

crossSellUnitsSold

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 de lead (CPV) da conta de cliente é o custo total dos itens vendidos como resultado da publicidade do mesmo 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 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 o mesmo chapéu 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 o mesmo chapéu 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 o mesmo chapéu e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadGrossProfitMicros

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 o mesmo chapéu e uma camisa. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O lucro bruto de lead desse pedido é R$ 7 = R$ 10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadRevenueMicros

string (int64 format)

A receita de lead da conta de cliente é o valor total que você ganha 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.

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 de cliente representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte "Anúncios do Shopping"), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de unidades vendidas de lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho.

leadUnitsSold

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

Uma flutuação.

doubleValue

number

Um duplo.

stringValue

string

Uma string.

QualityScoreBucket

Enumeração que lista os possíveis intervalos do Índice de qualidade.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BELOW_AVERAGE A qualidade do criativo está abaixo da média.
AVERAGE A qualidade do criativo está na média.
ABOVE_AVERAGE A qualidade do criativo está acima da média.

InteractionEventType

Enumeração que descreve possíveis tipos de interações a pagar e sem custo financeiro.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CLICK Clique para acessar o site. Na maioria dos casos, essa interação leva a 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 local.
VIDEO_VIEW O usuário visualizou um anúncio em vídeo.
NONE O InteractionEventType padrão para eventos de conversão de anúncios. Usado quando uma linha de conversão de anúncio NÃO indica que as interações sem custo financeiro (por exemplo, as conversões de anúncio) precisam ser "promovidas". e relatado como parte das métricas principais. Trata-se simplesmente de outras conversões (de anúncios).

Segmentos

Campos somente para segmentos.

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, MONDAY.

device

enum (Device)

Dispositivo a que as métricas se aplicam.

keyword

object (Keyword)

Critério de 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 brutas de conversão de eventos.

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 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 de lance (nível 1) do produto vendido.

productSoldBiddingCategoryLevel2

string

Categoria de lance (nível 2) do produto vendido.

productSoldBiddingCategoryLevel3

string

Categoria de lance (nível 3) do produto vendido.

productSoldBiddingCategoryLevel4

string

Categoria de 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 para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. 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 IDFAAsset. 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" for verdadeiro, as interações estão nesse recurso específico. Quando "InteractionOnThisAsset" for falso, isso significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio veiculado com o qual esse recurso é veiculado.

AdNetworkType

Enumera os tipos de rede do Google Ads.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH Pesquisa do Google.
SEARCH_PARTNERS Parceiros de pesquisa.
CONTENT Rede de Display.
YOUTUBE_WATCH Vídeos do YouTube
MIXED Várias redes.

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 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 corresponde à versão dele nas lojas on-line e físicas, 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 A condição do produto é antiga.
NEW A condição do produto é nova.
REFURBISHED O estado do produto foi recondicionado.
USED A condição do produto é usada.

AssetInteractionTarget

Um segmento 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 IDFAAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente.