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)

Grupo de anúncios referenciado na consulta.

adGroupAd

object (AdGroupAd)

O anúncio mencionado na consulta.

adGroupAdLabel

object (AdGroupAdLabel)

O rótulo do 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 mencionada na consulta.

adGroupBidModifier

object (AdGroupBidModifier)

O modificador de lance mencionado na consulta.

adGroupCriterion

object (AdGroupCriterion)

O critério indicado 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 mencionado na consulta.

ageRangeView

object (AgeRangeView)

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

asset

object (Asset)

O recurso referenciado na consulta.

assetGroupAsset

object (AssetGroupAsset)

O recurso do grupo de recursos referenciado na consulta.

assetGroupSignal

object (AssetGroupSignal)

O indicador do grupo de recursos referenciado na consulta.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

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

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

A visualização de 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 mencionada na consulta.

campaignBudget

object (CampaignBudget)

Orçamento da campanha mencionado na consulta.

campaign

object (Campaign)

A campanha mencionada na consulta.

campaignAsset

object (CampaignAsset)

O recurso da campanha mencionado na consulta.

campaignAssetSet

object (CampaignAssetSet)

O conjunto de recursos da campanha referenciado na consulta.

campaignAudienceView

object (CampaignAudienceView)

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

campaignCriterion

object (CampaignCriterion)

O critério de campanha indicado na consulta.

campaignLabel

object (CampaignLabel)

O rótulo da campanha mencionado na consulta.

cartDataSalesView

object (CartDataSalesView)

Visualização de vendas de dados do carrinho mencionada na consulta.

audience

object (Audience)

O público-alvo mencionado na consulta.

conversionAction

object (ConversionAction)

Ação de conversão mencionada na consulta.

conversionCustomVariable

object (ConversionCustomVariable)

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

customer

object (Customer)

O cliente mencionado na consulta.

customerAsset

object (CustomerAsset)

O recurso do cliente mencionado na consulta.

customerAssetSet

object (CustomerAssetSet)

O conjunto de recursos do cliente mencionado 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)

Visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa mencionada 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 mencionada 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)

Colunas personalizadas

AdGroup

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 do recurso do grupo de anúncios. Os nomes dos 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 o adGroup foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

targetingSetting

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. Esse campo é somente para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para entidades do Google Ads, use "adGroup.id".

startDate

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.

Tipos enumerados
UNSPECIFIED O status não foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

AdGroupType

Enumeração que lista os tipos possíveis de um grupo de anúncios.

Tipos enumerados
UNSPECIFIED O tipo não foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

AdGroupAdRotationMode

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

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

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

Esse é um valor apenas de resposta.

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

AdGroupEngineStatus

Status do mecanismo do grupo de anúncios.

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

Obsoleto. Não use.

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

TargetingSetting

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

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

object (TargetRestriction)

A configuração de dimensão por segmentação para restringir o alcance da campanha ou do grupo de anúncios.

TargetRestriction

Lista de configurações de segmentação por dimensão de segmentação.

Representação JSON
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Campos
targetingDimension

enum (TargetingDimension)

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

bidOnly

boolean

Indica se os anúncios devem ser restritos apenas para os critérios que você selecionou para essa segmentaçãoDimension ou todos os valores para essa segmentaçãoDimension e mostrar anúncios com base na sua segmentação em outras TargetingDimensões. Um valor de true significa que esses critérios só vão aplicar modificadores de lance, sem afetar a segmentação. Um valor de false significa que esses critérios restringirão a segmentação e a aplicação de modificadores de lance.

TargetingDimension

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
KEYWORD Critérios de palavra-chave, por exemplo, "cruzeiro em Marte". KEYWORD pode ser usada como uma dimensão de lance personalizada. Palavras-chave são sempre uma dimensão de segmentação. Por isso, não é possível definir como uma dimensão "ALL" de destino com a TargetRestriction.
AUDIENCE Critérios de público-alvo, que incluem lista de usuários, interesse do usuário, afinidade personalizada e personalização no mercado.
TOPIC Critérios de tópicos para segmentação de categorias de conteúdo, por exemplo, "category::Animais>Animais de estimação" usado para segmentação de display e vídeo.
GENDER Critérios para a segmentação de sexo.
AGE_RANGE Critérios para segmentar faixas etárias.
PLACEMENT Critérios de posicionamento, que incluem websites como "www.flowers4sale.com", bem como aplicativos para dispositivos móveis, categorias de aplicativos para dispositivos móveis, vídeos e canais do YouTube.
PARENTAL_STATUS Critérios para a segmentação do status parental.
INCOME_RANGE Critérios para a segmentação por faixa de renda.

AdGroupAd

Um anúncio do grupo de anúncios.

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

string

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

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

status

enum (AdGroupAdStatus)

O status do anúncio.

ad

object (Ad)

O anúncio.

creationTime

string

A data e a hora em que o adGroupAd foi criado. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

labels[]

string

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

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

engineStatus

enum (AdGroupAdEngineStatus)

Status adicional do anúncio na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem ativa, qualificada, revisão pendente etc.

lastModifiedTime

string

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

AdGroupAdStatus

Os status possíveis de um adgroupAd.

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

AdType

Os tipos possíveis de um anúncio.

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

SearchAds360TextAdInfo

Um anúncio de texto do Search Ads 360.

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

string

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 do anúncio exibido.

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

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
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Campos
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.

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

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

Obsoleto. Não use.

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

Obsoleto. Não use. Usado anteriormente pelo Gemini

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

AdGroupAdLabel

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

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

string

Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo de anúncio do grupo de anúncios têm o seguinte formato: 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 do grupo de anúncios 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.

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

AdGroupAssetSet

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

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

string

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

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

adGroup

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

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

Tipos enumerados
UNSPECIFIED O status não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta.
ENABLED O vínculo entre o conjunto de recursos e o contêiner está ativado.
REMOVED A vinculação entre o conjunto de recursos e o contêiner é removida.

AdGroupAudienceView

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

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

string

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

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 dos recursos dos modificadores de lances do grupo de anúncios têm o seguinte formato:

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

bidModifier

number

O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. O intervalo é de 1,0 a 6,0 para PreferredContent. Use 0 para desativar um tipo de dispositivo.

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

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

device

object (DeviceInfo)

Um critério de dispositivo.

DeviceInfo

Um critério de dispositivo.

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

enum (Device)

Tipo de dispositivo.

Dispositivo

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

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

AdGroupCriterion

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

Representação JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (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 dos recursos do critério do grupo de anúncios têm o seguinte formato:

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

creationTime

string

A data e a hora em que esse critério do grupo de anúncios foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

status

enum (AdGroupCriterionStatus)

O status do critério.

Este é o status da entidade do critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios da interface do usuário podem incorporar informações adicionais que afetam a qualificação de um critério para execução. Em alguns casos, um critério REMOVIDO na API ainda pode aparecer como ativado na IU. Por exemplo, as campanhas são exibidas por padrão para usuários de todas as faixas etárias, a menos que sejam excluídas. A interface vai mostrar cada faixa etária como "ativada", já que elas estão qualificadas para ver os anúncios. mas gclid.status mostrará "removido", já que nenhum critério positivo foi adicionado.

qualityInfo

object (QualityInfo)

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

type

enum (CriterionType)

Tipo do critério.

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

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

lastModifiedTime

string

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

criterionId

string (int64 format)

ID do critério.

adGroup

string

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

negative

boolean

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

ageRange

object (AgeRangeInfo)

Faixa etária.

gender

object (GenderInfo)

Sexo.

userList

object (UserListInfo)

Lista de usuários.

webpage

object (WebpageInfo)

Página da Web

location

object (LocationInfo)

Local.

AdGroupCriterionStatus

Os status possíveis de um ficam.

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

QualityInfo

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

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

integer

Índice de qualidade.

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

CriterionType

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

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

PositionEstimates

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

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

string (int64 format)

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

AdGroupCriterionEngineStatus

Enumera os status do mecanismo de ficam.

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

Obsoleto. Não use.

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

Obsoleto. Não use. Usado anteriormente pelo Gemini

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

KeywordInfo

Um critério de palavra-chave.

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

enum (KeywordMatchType)

Tipo de correspondência da palavra-chave.

text

string

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

KeywordMatchType

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

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

ListingGroupInfo

Um critério do grupo de fichas.

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

enum (ListingGroupType)

Tipo do grupo de produtos anunciados.

ListingGroupType

O tipo do grupo de fichas.

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SUBDIVISION Subdivisão de produtos com algumas dimensões de listagem. Esses nós não são usados para veiculação em entradas da listagem, mas servem apenas para definir a estrutura da árvore.
UNIT Unidade do grupo de produtos anunciados que define um lance.

AgeRangeInfo

Um critério de faixa etária.

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

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

GenderInfo

Um critério de gênero.

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

enum (GenderType)

Tipo de gênero.

GenderType

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

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

UserListInfo

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

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

string

O nome do recurso da lista de usuários.

WebpageInfo

Representa um critério para segmentar páginas da Web do site de um anunciante.

Representação JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Campos
conditions[]

object (WebpageConditionInfo)

Condições, ou expressões lógicas, para a segmentação de páginas da Web. A lista de condições de segmentação de páginas da Web é adicionada e combinada quando avaliada. Uma lista vazia de condições indica que todas as páginas do site da campanha estão segmentadas.

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

coveragePercentage

number

Porcentagem de cobertura dos critérios do site. Essa é a porcentagem calculada da cobertura do site com base na segmentação do site e das palavras-chave negativas no grupo de anúncios e na campanha. Por exemplo, quando a cobertura retorna como 1, isso indica que tem 100% de cobertura. Este campo é somente leitura.

criterionName

string

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

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

WebpageConditionInfo

Expressão lógica para segmentar páginas da Web do site de um anunciante.

Representação JSON
{
  "operand": enum (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 da condição da página da Web no critério da página da Web.

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

WebpageConditionOperator

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

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

LocationInfo

Um critério de local.

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

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 de critério do grupo de anúncios têm o seguinte 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 de rótulos do grupo de anúncios têm o seguinte 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 por faixa etária.

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

string

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

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

Recurso

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

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Tipo do recurso.

finalUrls[]

string

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

status

enum (AssetStatus)

O status do recurso.

creationTime

string

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

lastModifiedTime

string

A data e a hora em que este recurso foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

id

string (int64 format)

O ID do recurso.

name

string

Nome opcional do recurso.

trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento.

engineStatus

enum (AssetEngineStatus)

O status do mecanismo de um recurso.

Campo de união asset_data. O tipo específico do recurso. asset_data só pode ser de um dos seguintes tipos:
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 link para 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 ativos.

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

AssetStatus

Os status possíveis de um recurso.

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

AssetEngineStatus

Próximo ID = 11

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

YoutubeVideoAsset

Um recurso do YouTube.

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

string

Título do vídeo do YouTube.

youtubeVideoId

string

ID do vídeo do YouTube. Este é um valor de string de 11 caracteres usado no URL do vídeo do YouTube.

ImageAsset

Um recurso de imagem.

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

enum (MimeType)

Tipo MIME do recurso de imagem.

fullSize

object (ImageDimension)

Metadados desta imagem no tamanho original.

fileSize

string (int64 format)

Tamanho do arquivo do recurso de imagem em bytes.

MimeType

O tipo MIME

Tipos enumerados
UNSPECIFIED O tipo MIME não foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

ImageDimension

Metadados de uma imagem em determinado tamanho, original ou redimensionado.

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

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 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 do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd.

endDate

string

Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total.

useSearcherTimeZone

boolean

Define se o recurso será exibido no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads.

AdScheduleInfo

Representa um critério de AdSchedule.

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

Não é possível adicionar mais de seis AdSchedules para o mesmo dia.

Representação JSON
{
  "startMinute": enum (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 a hora de término em que esta programação termina. A programação exclui os minutos de término.

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

dayOfWeek

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 de 24 horas. Este campo deve estar entre 0 e 23 (valores inclusivos).

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

endHour

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

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

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

DayOfWeek

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
MONDAY segunda-feira.
TUESDAY terça-feira.
WEDNESDAY quarta-feira.
THURSDAY quinta-feira.
FRIDAY na sexta-feira.
SATURDAY sábado.
SUNDAY domingo.

UnifiedSitelinkAsset

Um recurso de sitelink unificado.

Representação JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (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 do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd.

endDate

string

Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total.

trackingId

string (int64 format)

Código usado para rastrear cliques do recurso de sitelink. Esta é uma conta do Yahoo! Japan.

useSearcherTimeZone

boolean

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

mobilePreferred

boolean

Indica se a preferência é que o recurso de sitelink seja exibido em dispositivos móveis. Válido para o Microsoft Ads.

UnifiedPageFeedAsset

Um recurso de feed de páginas unificado.

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

string

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

labels[]

string

Rótulos usados para agrupar os URLs da página.

MobileAppAsset

Um recurso que representa um app 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 deve 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

O tipo de fornecedor de app para dispositivos móveis

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

UnifiedCallAsset

Um recurso de ligação unificado.

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

string

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

phoneNumber

string

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

callConversionReportingState

enum (CallConversionReportingState)

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

callConversionAction

string

A ação de conversão à qual atribuir uma conversão de chamada. Se deixada sem definição, a ação de conversão padrão vai ser usada. Esse campo só terá efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total.

callOnly

boolean

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

callTrackingEnabled

boolean

Indica se a chamada deve ser ativada no acompanhamento de chamadas. Válido para o Microsoft Ads.

useSearcherTimeZone

boolean

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

startDate

string

Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd.

endDate

string

Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd.

CallConversionReportingState

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

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

CallToActionAsset

Um recurso de call-to-action.

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

enum (CallToActionType)

Call-to-action

CallToActionType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
LEARN_MORE O tipo de call-to-action é "Saiba mais".
GET_QUOTE O tipo de call-to-action é "Receber cotação".
APPLY_NOW O tipo de call-to-action foi aplicado agora.
SIGN_UP O tipo de call-to-action é "Inscreva-se".
CONTACT_US O tipo de call-to-action é "Entre em contato".
SUBSCRIBE O tipo de call-to-action é "Inscreva-se".
DOWNLOAD O tipo de call-to-action é download.
BOOK_NOW O tipo de call-to-action é "Reserve agora".
SHOP_NOW O tipo de call-to-action é "compre agora".
BUY_NOW O tipo de call-to-action é "Compre agora".
DONATE_NOW O tipo de call-to-action é "Doe agora".
ORDER_NOW O tipo de call-to-action é "Peça agora".
PLAY_NOW O tipo de call-to-action é "Reproduzir agora".
SEE_MORE O tipo de call-to-action é "Saiba mais".
START_NOW O tipo de call-to-action está "Começar agora".
VISIT_SITE O tipo de call-to-action é "Acesse o site".
WATCH_NOW O tipo de call-to-action é "Assistir agora".

UnifiedLocationAsset

Um recurso de local unificado.

Representação JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (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. Isso só será retornado se o recurso de local estiver sendo sincronizado da conta do Perfil da Empresa. É possível ter várias fichas de empresas do Perfil da Empresa na mesma conta que apontam para o mesmo ID de lugar.

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

Os dados de local do Perfil da Empresa foram sincronizados da conta vinculada do Perfil da Empresa.

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

string

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

storeCode

string

É o código da loja do Perfil da Empresa desse local. Isso é sincronizado na conta do Perfil da Empresa.

listingId

string (int64 format)

ID da ficha desse local do Perfil da Empresa. Isso é sincronizado na conta vinculada do Perfil da Empresa.

LocationOwnershipType

Possíveis tipos de propriedade de local.

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

AssetGroupAsset

AssetGroupAsset é o vínculo entre um recurso e um grupo. Adicionar um AssetGroupAsset vincula um recurso a um grupo.

Representação JSON
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (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 de recursos a que este recurso do grupo está vinculando.

asset

string

O recurso que este recurso do grupo de recursos está vinculando.

fieldType

enum (AssetFieldType)

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

status

enum (AssetLinkStatus)

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

AssetFieldType

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

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

AssetGroupSignal

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

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

  // Union field 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 de grupo pertence.

Campo de união signal. O indicador do grupo de recursos. signal só pode ser de um dos seguintes tipos:
audience

object (AudienceInfo)

O indicador de público-alvo a ser usado pela campanha Performance Max.

AudienceInfo

Um critério de público-alvo.

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

string

O nome do recurso de público-alvo.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter representa um nó da árvore de filtros do grupo de fichas em um grupo de recursos.

Representação JSON
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Campos
resourceName

string

O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos. O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos tem o seguinte formato:

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

assetGroup

string

O grupo de recursos de que esse 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 um nó de filtro do grupo de fichas.

vertical

enum (ListingGroupFilterVertical)

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

caseValue

object (ListingGroupFilterDimension)

É o valor de dimensão com que esse grupo de fichas está refinando o principal. Indefinido para o grupo raiz.

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

Tipo de filtro do grupo de fichas.

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

ListingGroupFilterVertical

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SHOPPING Representa a indústria de compras. Essa indústria só é permitida em campanhas Performance Max para varejo.

ListingGroupFilterDimension

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

Representação JSON
{

  // Union field 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 só pode ser de um dos seguintes tipos:
productBiddingCategory

object (ProductBiddingCategory)

Categoria de lances 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)

Código do item de uma oferta de produto.

productType

object (ProductType)

Tipo de uma oferta de produto.

ProductBiddingCategory

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

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

enum (ListingGroupFilterBiddingCategoryLevel)

Indica o nível da categoria na taxonomia.

id

string (int64 format)

ID da categoria de lances do produto.

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

ListingGroupFilterBiddingCategoryLevel

O nível da categoria de lances de filtro do grupo de fichas.

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

ProductBrand

Marca do produto.

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

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.

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

ProductCondition

Condição de uma oferta de produto.

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

enum (ListingGroupFilterProductCondition)

Valor da condição.

ListingGroupFilterProductCondition

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
NEW A condição do produto é nova.
REFURBISHED O estado do produto é recondicionado.
USED A condição do produto é usada.

ProductCustomAttribute

Atributo personalizado de uma oferta de produto.

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
INDEX0 Atributo personalizado do filtro do primeiro grupo de fichas.
INDEX1 Segundo atributo personalizado de filtro do grupo de fichas.
INDEX2 Terceiro atributo personalizado de filtro do grupo de fichas.
INDEX3 Quarto atributo personalizado de filtro do grupo de fichas.
INDEX4 Quinto atributo personalizado do filtro do grupo de fichas.

ProductItemId

Código do item de uma oferta de produto.

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

string

Valor do ID.

ProductType

Tipo de uma oferta de produto.

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

enum (ListingGroupFilterProductTypeLevel)

Nível do tipo.

value

string

Valor do tipo.

ListingGroupFilterProductTypeLevel

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

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

ListingGroupFilterDimensionPath

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

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

object (ListingGroupFilterDimension)

O caminho completo das dimensões na hierarquia de filtros do grupo de fichas (excluindo o nó raiz) para este filtro do grupo de fichas.

AssetGroupTopCombinationView

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

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

string

O nome do recurso da visualização de combinação superior do grupo de recursos. Os nomes dos recursos da visualização de principais combinações de recursos têm o seguinte formato: `"customers/{customerId}/assetGroupTopCombineViews/{asset_group_id}~{asset_adjust_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

As principais combinações de recursos que foram veiculados em conjunto.

AssetGroupAssetCombinationData

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

Representação JSON
{
  "assetCombinationServedAssets": [
    {
      object (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 recursos.

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

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. Os nomes dos recursos do grupo de recursos têm o seguinte formato:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

O ID do grupo de recursos.

campaign

string

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

name

string

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

finalUrls[]

string

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

finalMobileUrls[]

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 estão qualificados para expansão, a menos que estejam 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. Este 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.

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

AdStrength

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

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

AssetSetAsset

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

Representação JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (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 de conjunto de recursos.

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

AssetSet

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

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

string (int64 format)

O ID do conjunto de recursos.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Uma estratégia de lances.

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

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

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

É o status da estratégia de lances.

Este campo é somente leitura.

type

enum (BiddingStrategyType)

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

Este campo é somente leitura.

currencyCode

string

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

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

id

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 ISO 4217 de três letras).

Para estratégias de lances em clientes administradores, essa é a moeda definida pelo anunciante ao criar a estratégia. Para veiculação de clientes, este é o currencyCode do cliente.

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

Este campo é somente leitura.

campaignCount

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 que a probabilidade é menor.

maximizeConversionValue

object (MaximizeConversionValue)

Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.

maximizeConversions

object (MaximizeConversions)

Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.

targetCpa

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

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. O uso desse campo foi descontinuado. Não será possível criar uma nova estratégia de lances com este campo ou anexar estratégias de lances com este campo a uma campanha. São permitidas modificações em estratégias que já têm esse esquema preenchido.

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento.

BiddingStrategyStatus

Os status possíveis de uma BiddingStrategy.

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

BiddingStrategyType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
COMMISSION A comissão é uma estratégia de lances automática em que o anunciante paga uma determinada parte do valor da conversão.
ENHANCED_CPC O CPC otimizado é uma estratégia de lances que aumenta os lances para cliques com maior probabilidade de resultar em uma conversão e os diminui para cliques em que a probabilidade é menor.
INVALID Usado apenas para valor de retorno. Indica que uma campanha não tem uma estratégia de lances. Isso impede que a campanha seja veiculada. Por exemplo, uma campanha pode ser associada a uma estratégia de lances de administrador, e a conta de veiculação em seguida é desvinculada da conta de administrador. Nesse caso, a campanha será removida automaticamente da estratégia de lances do administrador, que agora é inacessível, e passará para o tipo de estratégia de lances INVÁLIDA.
MANUAL_CPA Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante.
MANUAL_CPC Lances com base em cliques manuais nos quais o usuário paga por clique.
MANUAL_CPM Lance baseado na impressão manual, no qual o usuário para por mil impressões.
MANUAL_CPV Uma estratégia de lances que paga um valor configurável por exibição de vídeo.
MAXIMIZE_CONVERSIONS Uma estratégia de lances que maximiza automaticamente o número de conversões considerando um orçamento diário.
MAXIMIZE_CONVERSION_VALUE Uma estratégia que define lances automaticamente para maximizar a receita gastando o orçamento automaticamente.
PAGE_ONE_PROMOTED Esquema de lances promovidos da página um, que define lances máximos de CPC para segmentar impressões nos espaços promovidos da página um ou da página um em google.com. Esse valor de enumeração foi descontinuado.
PERCENT_CPC CPC percentual é a estratégia de lances em que os lances são uma fração do preço anunciado para algum produto ou serviço.
TARGET_CPA O CPA desejado é uma estratégia de lances automática que define lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado estabelecido.
TARGET_CPM O CPM desejado é uma estratégia de lances automática que define lances para gerar o maior número possível de impressões sem exceder o custo desejado por mil impressões (CPM) que você definiu.
TARGET_IMPRESSION_SHARE Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja exibida na parte superior da primeira página (ou em outra região de segmentação).
TARGET_OUTRANK_SHARE A Parcela de superação desejada é uma estratégia de lances automática que define lances com base na fração desejada de leilões em que o anunciante deve superar um concorrente específico. O uso desse valor de tipo enumerado foi descontinuado.
TARGET_ROAS O ROAS desejado é uma estratégia de lances automática que ajuda a maximizar a receita enquanto obtém uma média de retorno do investimento médio (ROAS) desejado.
TARGET_SPEND O gasto desejado é uma estratégia que define lances automáticos para você gerar o máximo de cliques possível com o orçamento definido.

EnhancedCpc

Esse tipo não tem campos.

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

Esta estratégia de lances foi descontinuada e não pode mais ser criada. Use "ManualCpc" com "enhancedCpcEnabled" definido como "true" para a funcionalidade equivalente.

MaximizeConversionValue

Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.

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

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 apenas para estratégias de lances de portfólio.

cpcBidFloorMicros

string (int64 format)

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

targetRoas

number

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

MaximizeConversions

Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.

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

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 apenas para estratégias de lances de portfólio.

cpcBidFloorMicros

string (int64 format)

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

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 especificado em microunidades da moeda da estratégia de lances. Se definida, a estratégia de lances vai gerar o maior número possível de conversões sem exceder o custo por ação desejado. Se o CPA desejado não for definido, a estratégia de lances vai ter como objetivo alcançar o menor CPA possível de acordo com o orçamento.

TargetCpa

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetImpressionShare

Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja 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 de anúncios escolhida para 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.

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

TargetOutrankShare

Uma estratégia de lances automáticos que define lances com base na fração desejada de leilões em que o anunciante 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 alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.

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

number

Obrigatório. Receita escolhida (com base nos dados de conversão) por unidade de gasto. O valor deve estar entre 0,01 e 1.000,0, incluído.

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetSpend

Uma estratégia de lances automática que define 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 (link em inglês) 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 exibição de um orçamento.

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

BudgetPeriod

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
DAILY Orçamento diário.
FIXED_DAILY Orçamento diário fixo.
CUSTOM_PERIOD O orçamento personalizado pode ser usado com total_amount para especificar o limite do orçamento da vida útil.

Campanha

Uma campanha.

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

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 dos 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 criar 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 "biddingStrategy". Vazio se a campanha não usa uma estratégia de portfólio. Os atributos de estratégia irrestritos ficam disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Por outro lado, os atributos restritos só estão disponíveis para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos no recurso BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

Configuração da meta de otimização para esta 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 essa 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 está no formato "aaaa-MM-dd HH:mm:ss". O createTime será descontinuado na v1. 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 acompanhamento paralelo.

urlExpansionOptOut

boolean

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

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

Precisa ser um portfólio (criado por meio do serviço BiddingStrategy) ou 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 padrão de lances manuais de CPA. Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante. Compatível apenas com campanhas dos Serviços Locais.

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

Estratégia padrão de lances manuais de CPM. Lance manual baseado em impressão, no qual o usuário paga por mil impressões.

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

A estratégia padrão "Maximizar o valor da conversão" define lances automaticamente para maximizar a receita gastando o orçamento automaticamente.

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para atingir uma determinada porcentagem de impressões.

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

targetCpm

object (TargetCpm)

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

CampaignStatus

Possíveis status de uma campanha.

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

CampaignServingStatus

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

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

SERVING Disponibilização.
NONE Nenhum.
ENDED Finalizada.
PENDING Pendente.
SUSPENDED Suspenso.

BiddingStrategySystemStatus

Os possíveis status do sistema de uma BiddingStrategy.

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

AdServingOptimizationStatus

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

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

AdvertisingChannelType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SEARCH Rede de pesquisa. Inclui campanhas de display empacotadas e Search+.
DISPLAY Apenas na Rede de Display do Google.
SHOPPING As campanhas do Shopping são veiculadas na propriedade do Shopping e nos resultados da pesquisa do google.com.br.
HOTEL campanhas de Anúncios de hotéis.
VIDEO Campanhas de vídeo.
MULTI_CHANNEL e campanhas de apps para engajamento veiculadas em vários canais.
LOCAL Campanhas de anúncios locais
SMART Campanhas inteligentes.
PERFORMANCE_MAX das campanhas Performance Max.
LOCAL_SERVICES Campanhas dos Serviços Locais.
DISCOVERY Campanhas Discovery.
TRAVEL campanhas de viagem.

AdvertisingChannelSubType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão.
SEARCH_MOBILE_APP Campanhas de apps para dispositivos móveis na rede de pesquisa.
DISPLAY_MOBILE_APP Campanhas de apps para dispositivos móveis para a Rede de Display.
SEARCH_EXPRESS Campanhas do AdWords Express para pesquisa.
DISPLAY_EXPRESS Campanhas do AdWords Express para a Rede de Display.
SHOPPING_SMART_ADS com as campanhas inteligentes do Shopping.
DISPLAY_GMAIL_AD Campanhas publicitárias do Gmail.
DISPLAY_SMART_CAMPAIGN Campanhas inteligentes da Rede de Display: Não é possível criar novas campanhas desse subtipo.
VIDEO_OUTSTREAM Campanhas de vídeo out-stream.
VIDEO_ACTION Campanhas de vídeo TrueView for Action.
VIDEO_NON_SKIPPABLE Campanhas de vídeo com anúncios em vídeo não puláveis.
APP_CAMPAIGN Com uma campanha para apps, você promove facilmente seu app Android ou iOS nos principais Serviços do Google, incluindo a Pesquisa, o Google Play, o YouTube e a Rede de Display.
APP_CAMPAIGN_FOR_ENGAGEMENT Campanha de apps para engajamento com foco em gerar reengajamento com o aplicativo em vários dos principais Serviços do Google, incluindo Pesquisa, YouTube e a Rede de Display.
LOCAL_CAMPAIGN Campanhas especializadas em publicidade local.
SHOPPING_COMPARISON_LISTING_ADS campanhas de comparadores do Shopping.
SMART_CAMPAIGN campanhas inteligentes padrão.
VIDEO_SEQUENCE Campanhas de vídeo com anúncios em vídeo em sequência.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campanha de apps para pré-registro, especializada em divulgar o pré-registro de apps para dispositivos móveis e que segmenta vários canais de publicidade no Google Play, no YouTube e na Rede de Display.
VIDEO_REACH_TARGET_FREQUENCY Campanha de alcance de vídeo com a estratégia de lances de frequência desejada.
TRAVEL_ACTIVITIES campanhas de atividades de viagem.

CustomParameter

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

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

string

A chave que corresponde ao nome da tag do 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 os lances em tempo real estão ativados na campanha.

NetworkSettings

As configurações de rede da campanha.

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

boolean

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

targetContentNetwork

boolean

Indica se os anúncios serão veiculados em canais específicos na Rede de Display do Google. Os canais são especificados usando o critério Canal.

targetPartnerSearchNetwork

boolean

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

DynamicSearchAdsSetting

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

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 dos atributos "feedLabel" ou "salesCountry" pode ser definido. Se usado em vez de salesCountry, o campo feedLabel aceitará códigos de país no mesmo formato, por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center.

useVehicleInventory

boolean

Indica 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

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

campaignPriority

integer

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

enableLocal

boolean

Indica se produtos disponíveis na loja física devem ser incluídos.

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PRESENCE_OR_INTEREST Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou se ele demonstrar interesse nelas.
SEARCH_INTEREST Especifica que um anúncio será acionado se o usuário pesquisar as regiões de segmentação do anunciante. Essa opção só pode ser usada em campanhas padrão do Shopping e de pesquisa.
PRESENCE Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou regularmente.

NegativeGeoTargetType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PRESENCE_OR_INTEREST Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante ou tiver interesse neles.
PRESENCE Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante.

FrequencyCapEntry

Esse tipo não tem campos.

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

SelectiveOptimization

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

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

string

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

OptimizationGoalSetting

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

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

enum (OptimizationGoalType)

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

OptimizationGoalType

O tipo de meta de otimização

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

TrackingSetting

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

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

string

O URL usado para rastreamento dinâmico.

ManualCpa

Esse tipo não tem campos.

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

ManualCpc

Lance manual baseado em clique, no qual o usuário paga por clique.

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

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 manual baseado em impressão, no qual o usuário paga por mil impressões.

PercentCpc

Estratégia de lances em que os lances são uma fração do preço anunciado para algum produto ou serviço.

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

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: um valor zero é interpretado da mesma maneira que ter 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 do lance médio de uma campanha não deve.

TargetCpm

Esse tipo não tem campos.

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

CampaignAsset

Um vínculo entre uma campanha e um recurso.

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

string

O nome do recurso da campanha. Os nomes dos recursos "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 a que esse conjunto de recursos está vinculado.

assetSet

string

O conjunto de recursos vinculado à campanha.

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

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

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

string

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

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

CampaignCriterion

Um critério de campanha.

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

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

string

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

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

displayName

string

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

Este campo é ignorado para mutações.

type

enum (CriterionType)

Tipo do critério.

status

enum (CampaignCriterionStatus)

O status do critério.

lastModifiedTime

string

A data e a hora em que esse critério de campanha foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

criterionId

string (int64 format)

ID do critério.

Este campo é ignorado durante a modificação.

bidModifier

number

O modificador dos lances quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores. Use 0 para desativar um tipo de dispositivo.

negative

boolean

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)

Sexo.

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

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

LanguageInfo

Um critério de idioma.

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

string

O nome do recurso da constante de linguagem.

LocationGroupInfo

Um raio ao redor de uma lista de locais especificados por um feed.

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

string

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

radiusUnits

enum (LocationGroupRadiusUnits)

Unidade do raio. Milhas e metros são suportados para constantes de segmentação geográfica. Milímetros e metros são aceitos para conjuntos de itens de feed. Isso é obrigatório e precisa ser definido nas operações CREATE.

feedItemSets[]

string

GBPSets cujos ViewModels são segmentados. Se vários IDs forem especificados, todos os itens que aparecem em pelo menos um conjunto serão segmentados. Este campo não pode ser usado com geoTargetConstants. Isso é opcional e só pode ser definido em operações CREATE.

radius

string (int64 format)

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

LocationGroupRadiusUnits

A unidade de distância do raio no grupo de locais (por exemplo, MILES)

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
METERS Metros
MILES Milhas
MILLI_MILES Milímetros

CampaignLabel

Representa uma relação entre uma campanha e um rótulo.

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

string

Nome do recurso. Os nomes dos recursos de rótulos de campanhas têm o seguinte 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 visualização de vendas de dados do carrinho. Os nomes dos recursos de visualização de vendas de dados do carrinho têm o seguinte formato: customers/{customerId}/cartDataSalesView

Público

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

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

string

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

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID do público-alvo.

name

string

Obrigatório. Nome do público-alvo. Ele precisa ser único para todos os públicos-alvo. Ele precisa ter comprimento mínimo de 1 e máximo de 255.

description

string

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

A categoria de conversões registrada para esta ação de conversão.

valueSettings

object (ValueSettings)

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

attributionModelSettings

object (AttributionModelSettings)

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

floodlightSettings

object (FloodlightSettings)

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

id

string (int64 format)

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

name

string

Nome da ação de conversão.

Este campo é obrigatório e não deve ficar em branco ao criar novas ações de conversão.

primaryForGoal

boolean

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

ownerCustomer

string

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

includeInClientAccountConversionsMetric

boolean

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

includeInConversionsMetric

boolean

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

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

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

ConversionActionStatus

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

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

ConversionActionType

Tipos possíveis de uma ação de conversão.

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

ConversionActionCategory

A categoria de conversões associada a uma ConversionAction.

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

ValueSettings

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

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

number

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

defaultCurrencyCode

string

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

alwaysUseDefaultValue

boolean

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

AttributionModelSettings

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

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

Modelo de atribuição que descreve como distribuir crédito de uma determinada conversão entre várias interações anteriores.

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

DataDrivenModelStatus

Enumera os status do modelo baseado em dados.

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

FloodlightSettings

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

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

string

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 métricas e dimensões personalizadas do Floodlight no novo Search Ads 360" em https://support.google.com/sa360/answer/13567857

Representação JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (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 da variável personalizada 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 da conversão. O nome deve ser exclusivo. O nome pode ter, no máximo, 100 caracteres. Não deve haver espaços extras antes e depois.

tag

string

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

status

enum (ConversionCustomVariableStatus)

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

ownerCustomer

string

O nome do recurso do cliente que tem a variável personalizada de conversão.

family

enum (ConversionCustomVariableFamily)

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

cardinality

enum (ConversionCustomVariableCardinality)

Cardinalidade da variável personalizada de conversão.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Campos para as 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

Possíveis status de uma variável personalizada de conversão.

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

A ativação da variável personalizada de conversão está pendente e só vai acumular estatísticas depois que ela for definida como ATIVADA.

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

ENABLED A variável personalizada de conversão está ativada e vai acumular estatísticas.
PAUSED A variável personalizada de conversão está pausada e só vai acumular estatísticas quando for definida como ATIVADA novamente.

ConversionCustomVariableFamily

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

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

ConversionCustomVariableCardinality

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

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

FloodlightConversionCustomVariableInfo

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

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

enum (FloodlightVariableType)

Tipo de variável do Floodlight definido 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.

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

FloodlightVariableDataType

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

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

Cliente

Um cliente.

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

string

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

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

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

accountType

enum (AccountType)

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

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Configuração do DoubleClick Campaign Manager (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 sem parâmetros.

finalUrlSuffix

string

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

autoTaggingEnabled

boolean

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

manager

boolean

Se o cliente é um gerente.

ConversionTrackingSetting

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

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

boolean

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

conversionTrackingStatus

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 desse recurso. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai ser diferente com base no login-customer-id da solicitação.

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

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

googleAdsCrossAccountConversionTrackingId

string (int64 format)

O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente usa o acompanhamento de conversões e substitui o conversionTrackingId. Esse campo só pode ser gerenciado na interface do Google Ads. Este campo é somente leitura.

crossAccountConversionTrackingId

string (int64 format)

O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente usa o acompanhamento de conversões de várias contas e substitui o conversionTrackingId.

ConversionTrackingStatus

Status do acompanhamento de conversões do cliente.

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

AccountType

Possíveis tipos de conta de mecanismo.

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

DoubleClickCampaignManagerSetting

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

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

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 associado a esse cliente no formato do banco de dados de fuso horário IANA, como América/Nova_York.

AccountStatus

Possíveis status de uma conta.

Tipos enumerados
UNSPECIFIED Valor padrão.
UNKNOWN Valor desconhecido.
ENABLED tem permissão para veicular anúncios.
PAUSED A conta é desativada pelo usuário.
SUSPENDED A conta é desativada por um processo interno.
REMOVED A conta é desativada de forma irrevogável.
DRAFT A conta ainda está no processo de configuração e ainda não está ATIVADA.

CustomerStatus

Possíveis status de um cliente.

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

CustomerAsset

Um vínculo entre um cliente e um recurso.

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

string

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

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

asset

string

Obrigatório. O recurso vinculado ao cliente.

status

enum (AssetLinkStatus)

Status do recurso do cliente.

CustomerAssetSet

CustomerAssetSet é 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 vinculado ao cliente.

customer

string

O cliente a que esse 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 de BiddingStrategies que pertencem e são compartilhadas com o cliente.

Em contraste com a BiddingStrategy, esse recurso inclui estratégias que pertencem aos gerentes do cliente e são compartilhadas com ele, além das estratégias que pertencem a ele. Esse recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos BiddingStrategy.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (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ática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.

maximizeConversions

object (MaximizeConversions)

Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.

targetCpa

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

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 alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.

targetSpend

object (TargetSpend)

Uma estratégia que define seus lances para conseguir o máximo de cliques possível dentro do orçamento.

MaximizeConversionValue

Uma estratégia de lances automática que ajuda a conseguir o maior valor de conversão para suas campanhas dentro do orçamento disponível.

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

number

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

MaximizeConversions

Uma estratégia de lances automática que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.

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

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja 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 de anúncios escolhida para 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 alcança uma média de retorno do investimento em publicidade (ROAS) desejado específico.

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

number

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

TargetSpend

Uma estratégia de lances automática que define 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 (link em inglês) 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

Possíveis status de uma vinculação.

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ACTIVE Indica a relação atual em vigor
INACTIVE Indica relacionamento encerrado
PENDING Indica que a relação foi solicitada pelo gerente, mas o cliente ainda não aceitou.
REFUSED A relação foi solicitada pelo gerente, mas o cliente se recusou.
CANCELED Indica que a relação foi solicitada pelo administrador, mas foi cancelada.

CustomerClient

Um link entre um determinado cliente e um cliente cliente. Os CustomerClients só existem para clientes administradores. Todos os clientes diretos e indiretos estão incluídos, além do próprio gerente.

Representação JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (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 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 do recurso cliente-cliente vinculado ao cliente em questão. Somente leitura.

hidden

boolean

Especifica se a conta é oculta.

Somente leitura.

level

string (int64 format)

A distância entre o cliente e o cliente. Para "self link", o valor do nível será 0. Somente leitura.

timeZone

string

Representação da string 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 para o cliente. Somente leitura.

currencyCode

string

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

id

string (int64 format)

O ID do cliente. Somente leitura.

DynamicSearchAdsSearchTermView

Visualização do termo de pesquisa em anúncios dinâmicos de pesquisa.

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

string

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

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 da impressão selecionado dinamicamente.

Este campo é somente leitura.

GenderView

Uma visualização de gênero. O recurso "genderView" reflete o estado de exibição efetivo, em vez dos critérios que foram adicionados. Por padrão, um grupo de anúncios sem critérios de sexo é exibido para todos os sexos. Assim, todos os sexos aparecem na genderView com estatísticas.

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

string

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

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 dos recursos constantes da segmentação geográfica têm o seguinte formato:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

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

id

string (int64 format)

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

name

string

Nome em inglês da constante de segmentação por área 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, do nome pai e do país.

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

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

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor apenas de resposta.

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

KeywordView

Uma visualização de palavras-chave.

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

string

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

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 seguinte 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 plano de fundo colorido.

id

string (int64 format)

ID do rótulo. Somente leitura.

name

string

Nome do rótulo.

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

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

LabelStatus

Possíveis status de um rótulo.

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

TextLabel

Um tipo de rótulo que exibe texto em um plano de fundo colorido.

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

string

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

description

string

Uma breve descrição do rótulo. O comprimento deve ser de, no máximo, 200 caracteres.

LanguageConstant

Um idioma.

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

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

code

string

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

name

string

O nome completo do idioma em inglês, por exemplo, "Inglês (EUA)", "Espanhol" etc.

targetable

boolean

Indica se o idioma pode ser segmentado.

LocationView

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

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

string

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

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

ProductBiddingCategoryConstant

Uma categoria de lances de produtos.

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

string

O nome do recurso da categoria de lances do produto. Os nomes dos recursos da categoria 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 lances do produto.

id

string (int64 format)

ID da categoria de lances do produto.

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

countryCode

string

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

productBiddingCategoryConstantParent

string

Nome do recurso da categoria de lances do produto pai.

languageCode

string

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

localizedName

string

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

ProductBiddingCategoryLevel

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

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

ProductBiddingCategoryStatus

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

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

ProductGroupView

Uma visualização do grupo de produtos.

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

string

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

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

ShoppingPerformanceView

Visualização de desempenho do Google Shopping. Oferece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores das dimensões de produto do Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto, vão refletir o estado de cada dimensão a partir da data e hora em que o evento correspondente foi registrado.

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

string

O nome do recurso da visualização de desempenho do Google Shopping. Os nomes dos recursos de visualização de desempenho do Shopping têm o seguinte formato: 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 talvez não seja exclusivo (por exemplo, se access_reason=SHARED)

UserListType

Enumeração contendo possíveis tipos de lista de usuários.

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

WebpageView

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

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

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 foi atribuída.

merchantId

string (int64 format)

O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele.

adId

string (int64 format)

ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído.

clickId

string

Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL de ID de clique.

visitDateTime

string

O carimbo de data/hora do evento da visita. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

productId

string

O ID do produto clicado.

productChannel

enum (ProductChannel)

O canal de vendas do produto que foi clicado: on-line ou local.

productLanguageCode

string

O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto.

productStoreId

string

A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais.

productCountryCode

string

O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado.

assetId

string (int64 format)

Código do recurso com o qual houve interação durante o evento da visita.

assetFieldType

enum (AssetFieldType)

Tipo de campo do recurso do evento de visita.

ProductChannel

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

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

Conversão

Uma conversão.

Representação JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
resourceName

string

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

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

O ID da conversão.

criterionId

string (int64 format)

ID do critério do Search Ads 360. Um valor de 0 indica que o critério não foi atribuído.

merchantId

string (int64 format)

O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele.

adId

string (int64 format)

ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído.

clickId

string

Uma string única para a visita à qual a conversão é atribuída, que é transmitida para a página de destino como o parâmetro de URL do ID de clique.

visitId

string (int64 format)

O ID da visita do Search Ads 360 ao qual 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, ele é 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 com o qual houve interação durante o evento de conversão.

assetFieldType

enum (AssetFieldType)

Tipo de campo do recurso do evento de conversão.

AttributionType

Tipo de atribuição de conversões no SearchAds360

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

ConversionStatus

Possíveis status de uma conversão.

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

Métricas

Dados de métricas.

Representação JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (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,
  "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 essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

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 essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão.

conversionsByConversionDate

number

A soma das conversões por data de conversão para tipos de conversão que recebem lances. Pode ser fracionário devido ao modelo de atribuição. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão.

historicalCreativeQualityScore

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 de pesquisa histórica.

interactionEventTypes[]

enum (InteractionEventType)

Os tipos de interação com pagamentos e sem custo.

rawEventConversionMetrics[]

object (Value)

As métricas brutas de conversão de eventos

absoluteTopImpressionPercentage

number

A parcela de impressões na primeira posição da pesquisa é a porcentagem de impressões de anúncios de pesquisa que são exibidas na posição de maior destaque da rede.

allConversionsFromInteractionsRate

number

Todas as conversões de interações (como opostas a conversões de visualização) divididas pelo número de interações com anúncios.

allConversionsValue

number

Valor de todas as conversões.

allConversions

number

O número total de conversões. Isso inclui todas as conversões, independentemente do valor de includeInConversionsMetric.

allConversionsValuePerCost

number

O valor de todas as conversões dividido pelo custo total das interações com 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 os usuários clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. Esse número não indica se as ligações foram ou não completadas nem a duração delas.

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

allConversionsFromDirections

number

O número de vezes que os usuários clicaram no botão "Como chegar" para ir a uma loja depois de clicar em um anúncio.

Essa métrica se aplica 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

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

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

allConversionsFromOrder

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 podem receber lances (da interação) por interação qualificada de conversão. Mostra com que frequência, em média, uma interação com o anúncio leva a uma conversão que recebe lances.

clientAccountConversionsValue

number

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

clientAccountConversions

number

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

crossDeviceConversions

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 em que o atributo includeInConversionsMetric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

conversionsValue

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.

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. Para mais detalhes, consulte https://support.google.com/sa360/answer/9566729. 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 principais anúncios nos resultados de pesquisa devido a um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchBudgetLostImpressionShare

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 foi exibido ao lado dos principais resultados de pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchClickShare

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 principais resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchRankLostImpressionShare

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 foi exibido ao lado dos principais resultados da pesquisa orgânica devido a uma classificação do anúncio insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

searchTopImpressionShare

number

As impressões que você recebeu entre os principais anúncios em comparação com o número estimado de impressões que você estava qualificado para receber entre eles. Observação: a parcela de impressões na parte superior da pesquisa é informada no intervalo de 0,1 a 1. Qualquer valor abaixo de 0,1 é informado como 0,0999.

Esses anúncios geralmente ficam acima dos resultados orgânicos principais, embora possam aparecer abaixo desses resultados em determinadas consultas.

topImpressionPercentage

number

A porcentagem de impressões de anúncios que são 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 essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

O valor da conversão que recebe lances dividido pelo número de conversões que recebem lances. Mostra quanto vale, em média, cada uma das conversões que recebem lances.

valuePerConversionsByConversionDate

number

Valor das conversões que podem receber lances por data de conversão dividido pelas conversões que recebem lances por data de conversão. Mostra quanto vale, em média, cada uma das conversões que recebem lances (por data de conversão). Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão.

clientAccountViewThroughConversions

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

crossSellCostOfGoodsSoldMicros

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 de venda cruzada é o custo total dos produtos vendidos que não foram anunciados. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos de venda cruzada desse pedido é de R $5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellGrossProfitMicros

string (int64 format)

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

crossSellGrossProfitMicros

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

clientAccountCrossSellRevenueMicros

string (int64 format)

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

crossSellRevenueMicros

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

clientAccountCrossSellUnitsSold

number

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

crossSellUnitsSold

number

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

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

O custo dos produtos vendidos (CPV) da conta de cliente é o valor total dos produtos vendidos como resultado da publicidade do mesmo produto. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação tiver um produto associado (consulte "Anúncios do Shopping"), esse produto será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadCostOfGoodsSoldMicros

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 produto será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o valor deles será contabilizado no custo dos produtos vendidos de lead. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa. O valor de custo dos produtos vendidos do chapéu é R$ 3, e o da camiseta é R$ 5. O custo dos produtos vendidos de lead nesse pedido é R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadGrossProfitMicros

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

leadGrossProfitMicros

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

clientAccountLeadRevenueMicros

string (int64 format)

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

leadRevenueMicros

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

clientAccountLeadUnitsSold

number

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

leadUnitsSold

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 só pode ser de um dos seguintes tipos:
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 buckets do índice de qualidade.

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

InteractionEventType

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CLICK Clique para acessar o site. Na maioria dos casos, essa interação navega para um local externo, geralmente a página de destino do anunciante. Também é o InteractionEventType padrão para eventos de clique.
ENGAGEMENT A intenção expressa do usuário de interagir com o anúncio.
VIDEO_VIEW O usuário visualizou um anúncio em vídeo.
NONE O InteractionEventType padrão para eventos de conversão de anúncios. Usado quando uma linha de conversão de anúncios NÃO indica que as interações sem custo financeiro (por exemplo, conversões de anúncios) precisam ser "promovidas" e informadas como parte das métricas principais. Essas são simplesmente outras conversões (anúncios).

Segmentos

Campos apenas para segmentos.

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

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 civil 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 somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios. As interações (por exemplo, cliques) são contabilizadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando são veiculadas juntas. Quando interatividadeOnThisAsset é definido como verdadeiro, isso significa que as interações estão nesse recurso específico. Se o "InteractionOnThisAsset" é falso, isso significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio com que ele é veiculado.

AdNetworkType

Enumera os tipos de rede do Google Ads.

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
SEARCH Pesquisa do Google.
SEARCH_PARTNERS Parceiros de pesquisa.
CONTENT Rede de Display.
YOUTUBE_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.

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SINGLE_CHANNEL O item é vendido somente em um canal, em lojas locais ou on-line, conforme indicado pelo ProductChannel.
MULTI_CHANNEL O item corresponde ao item correspondente em lojas on-line ou locais, indicando que ele está disponível para compra nos dois ShoppingProductChannels.

ProductCondition

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

Tipos enumerados
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
OLD A condição do produto é antiga.
NEW A condição do produto é nova.
REFURBISHED O estado do produto é recondicionado.
USED A condição do produto é usada.

AssetInteractionTarget

Um segmento AssetInteractionTarget.

Representação JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Campos
asset

string

O nome do recurso do recurso.

interactionOnThisAsset

boolean

Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.