Package google.ads.searchads360.v0.resources

string

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

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

O ID da estratégia de lances.

string

É o nome da estratégia de lances.

BiddingStrategyType

É o tipo de estratégia de lances.

int64

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

string

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

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

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

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

double

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.

int64

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

int64

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

int64

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

TargetImpressionShareLocation

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

int64

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

int64

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.

double

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

int64

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

int64

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.

string

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

customers/{customer_id}/ads/{ad_id}

string

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

FinalAppUrl

É uma lista de URLs finais do aplicativo que serão usados em dispositivos móveis se o usuário tiver o aplicativo específico instalado.

string

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

AdType

O tipo de anúncio.

int64

O ID do anúncio.

string

O modelo de URL para criar um URL de rastreamento.

string

O sufixo a ser usado ao construir um URL final.

string

É o URL exibido na descrição de alguns formatos de anúncio.

string

É o nome do anúncio. Isso é usado apenas para identificar o anúncio. Ele não precisa ser único e não afeta o anúncio veiculado.

SearchAds360TextAdInfo

Detalhes relacionados a um anúncio de texto.

SearchAds360ExpandedTextAdInfo

Detalhes relacionados a um anúncio de texto expandido.

SearchAds360ResponsiveSearchAdInfo

Detalhes relacionados a um anúncio responsivo de pesquisa.

SearchAds360ProductAdInfo

Detalhes relacionados a um anúncio de produto.

SearchAds360ExpandedDynamicSearchAdInfo

Detalhes relacionados a um anúncio dinâmico expandido de pesquisa.

string

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

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

O status do grupo de anúncios.

AdGroupType

O tipo do grupo de anúncios.

AdGroupAdRotationMode

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

string

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

TargetingSetting

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

string

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

string

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

string

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

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

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

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

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

int64

O ID do grupo de anúncios.

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

string

O modelo de URL para criar um URL de rastreamento.

int64

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

AdGroupEngineStatus

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

string

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

string

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

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

O status do anúncio.

Ad

O anúncio.

string

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

string

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

string

Os nomes de recursos dos rótulos efetivos anexados a este anúncio. Um rótulo efetivo é herdado ou atribuído diretamente a este anúncio.

string

É o ID do anúncio na conta de mecanismo externo. Esse campo é exclusivo 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 "ad_group_ad.ad.id".

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.

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

int64

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

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

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

string

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

AssetLinkStatus

Status do recurso do grupo de anúncios.

string

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

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

string

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

string

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

AssetSetLinkStatus

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

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

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

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

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.

DeviceInfo

Um critério de dispositivo.

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

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

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

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

CriterionType

Tipo do critério.

string

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

string

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

PositionEstimates

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

string

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

string

A lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos de vários domínios.

CustomParameter

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

string

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

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

int64

ID do critério.

string

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

bool

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

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

double

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.

int64

Lance de CPC (custo por clique).

int64

O lance de CPC (custo por clique) efetivo.

AdGroupCriterionEngineStatus

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

string

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

string

O modelo de URL para criar um URL de rastreamento.

KeywordInfo

Palavra-chave.

ListingGroupInfo

Grupo de produtos anunciados.

AgeRangeInfo

Faixa etária.

GenderInfo

Gênero.

UserListInfo

Lista de usuários.

WebpageInfo

Página da Web

LocationInfo

Local.

int64

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.

int32

Índice de qualidade.

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

int64

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

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

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

customers/{customer_id}/assets/{asset_id}

AssetType

Tipo do recurso.

string

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

string

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

CustomParameter

Uma lista de mapeamentos a serem usados para substituir tags de parâmetros personalizados de URL em "tracking_url_template", "final_urls" e/ou "final_mobile_urls".

AssetStatus

O status do recurso.

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

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

int64

O ID do recurso.

string

Nome opcional do recurso.

string

Modelo de URL para criar um URL de rastreamento.

string

Modelo de URL para anexar parâmetros aos URLs da página de destino veiculados com acompanhamento paralelo.

AssetEngineStatus

O status do mecanismo de um recurso.

YoutubeVideoAsset

Um recurso de vídeo do YouTube.

ImageAsset

Um recurso de imagem.

TextAsset

Um recurso de texto.

UnifiedCalloutAsset

Um recurso de frase de destaque unificado.

UnifiedSitelinkAsset

Um recurso de sitelink unificado.

UnifiedPageFeedAsset

Um recurso unificado do feed de páginas.

MobileAppAsset

Um recurso de app para dispositivos móveis.

UnifiedCallAsset

Um recurso de ligação unificado.

CallToActionAsset

Um recurso de call-to-action.

UnifiedLocationAsset

Um recurso de local unificado.

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

int64

O ID do grupo de recursos.

string

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

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.

string

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

string

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

AssetGroupStatus

O status do grupo de recursos.

string

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

string

Segunda parte do texto que pode aparecer anexada ao URL exibido no anúncio. Este campo só pode ser definido quando path1 é definido.

AdStrength

Qualidade geral do anúncio deste grupo de recursos.

string

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

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

O grupo de recursos a que o recurso do grupo está vinculado.

string

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

AssetFieldType

A descrição do posicionamento do recurso no grupo de recursos. Por exemplo: HEADLINE, YOUTUBE_VIDEO etc.

AssetLinkStatus

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

AssetUsage

Recursos veiculados.

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 formato:

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

string

O grupo de recursos a que este filtro do grupo de produtos anunciados de recursos pertence.

int64

O ID do ListingGroupFilter.

ListingGroupFilterType

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

ListingGroupFilterVertical

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

ListingGroupFilterDimension

Valor da dimensão com que este grupo de produtos anunciados da empresa está refinando o grupo principal. Indefinido para o grupo raiz.

string

Nome do recurso da subdivisão do grupo de listagens principal. Nulo para o nó raiz do filtro de grupo de produtos anunciados.

ListingGroupFilterDimensionPath

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

string

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

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

string

O grupo de recursos a que este indicador pertence.

AudienceInfo

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

string

O nome do recurso da visualização da principal combinação do grupo de recursos. Os nomes dos recursos da visualização da principal combinação do grupo de recursos têm o formato: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

AssetGroupAssetCombinationData

As principais combinações de recursos veiculados juntos.

int64

O ID do grupo de recursos.

string

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

customers/{customer_id}/assetSets/{asset_set_id}

string

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

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

O conjunto a que o recurso está vinculado.

string

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

AssetSetAssetStatus

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

string

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

customers/{customer_id}/audiences/{audience_id}

int64

ID do público-alvo.

string

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

string

Descrição do público-alvo.

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

É o status da estratégia de lances.

Este campo é somente leitura.

BiddingStrategyType

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

Este campo é somente leitura.

string

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

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

int64

O ID da estratégia de lances.

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

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 atender clientes, esse é o currency_code do cliente.

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

Este campo é somente leitura.

int64

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

Este campo é somente leitura.

int64

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

Este campo é somente leitura.

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 com menor probabilidade.

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

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

TargetImpressionShare

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

TargetOutrankShare

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

TargetRoas

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

TargetSpend

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

string

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

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

É o status da campanha.

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

CampaignServingStatus

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

BiddingStrategySystemStatus

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

AdServingOptimizationStatus

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

AdvertisingChannelType

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

Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas.

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

AdvertisingChannelSubType

Refinamento opcional para advertising_channel_type. 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.

CustomParameter

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

RealTimeBiddingSetting

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

NetworkSettings

As configurações de rede da campanha.

DynamicSearchAdsSetting

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

ShoppingSetting

A configuração para controlar campanhas do Shopping.

GeoTargetTypeSetting

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

string

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

string

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

BiddingStrategyType

É o tipo de estratégia de lances.

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

Este campo é somente leitura.

string

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

FrequencyCapEntry

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

SelectiveOptimization

Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimizar a campanha. 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

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

TrackingSetting

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

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

AssetFieldType

Os tipos de campos de recursos que precisam ser excluídos desta campanha. Os links de recursos com esses tipos de campo não serão herdados pela campanha do nível superior.

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". create_time será descontinuado na v1. Use creation_time.

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

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

AssetSetType

Tipos de feeds anexados diretamente a esta campanha.

int64

O ID da campanha.

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

string

O modelo de URL para criar um URL de rastreamento.

string

O nome do recurso do orçamento da campanha.

string

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

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.

string

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

bool

Representa a desativação da expansão de URL para URLs mais segmentados. Se a desativação estiver ativada (true), 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 (false), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "false".

string

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

ManualCpa

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

ManualCpc

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

ManualCpm

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

MaximizeConversions

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

MaximizeConversionValue

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

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.

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

PercentCpc

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

TargetCpm

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

string

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

string

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

bool

Indica se a campanha usa exclusivamente URLs fornecidos pelo anunciante.

PositiveGeoTargetType

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

NegativeGeoTargetType

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

bool

Se os anúncios serão veiculados com os resultados da pesquisa do google.com.br.

bool

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

bool

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.

bool

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.

OptimizationGoalType

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

string

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

string

Rótulo do feed de produtos a serem incluídos na campanha. Apenas um dos campos feed_label ou sales_country pode ser definido. Se usado em vez de "sales_country", o campo "feed_label" aceita códigos de país no mesmo formato. Por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center.

bool

Indica se o inventário de anúncios de veículos deve ser segmentado.

int64

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

string

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

int32

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, inclusive. Esse campo é opcional para campanhas inteligentes do Shopping, mas precisa ser igual a 3 se definido.

bool

Se os produtos locais devem ser incluídos.

string

O URL usado para rastreamento dinâmico.

string

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

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

Status do recurso da campanha.

string

A campanha à qual o recurso está vinculado.

string

O recurso que está vinculado à campanha.

string

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

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

string

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

string

O conjunto de recursos vinculado à campanha.

AssetSetLinkStatus

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

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

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/{customer_id}/campaignBudgets/{campaign_budget_id}

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.

BudgetPeriod

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

int64

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

string

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

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

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

Este campo é ignorado para mutações.

CriterionType

Tipo do critério.

CampaignCriterionStatus

O status do critério.

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

int64

ID do critério.

Este campo é ignorado durante a modificação.

float

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.

bool

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

KeywordInfo

Palavra-chave.

LocationInfo

Local.

DeviceInfo

Dispositivo.

AgeRangeInfo

Faixa etária.

GenderInfo

Gênero.

UserListInfo

Lista de usuários.

LanguageInfo

e linguagem Hashicorp.

WebpageInfo

Página da Web.

LocationGroupInfo

Grupo por locais

string

Nome do recurso. Os nomes de recursos "CampaignEffectivelabel" têm o formato: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

string

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

string

O rótulo efetivo atribuído à campanha.

int64

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

string

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

string

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

string

Rótulo atribuído à campanha.

int64

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

string

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

string

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

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

O ID da conversão.

int64

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

int64

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.

int64

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

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.

int64

O ID da visita do Search Ads 360 ao qual a conversão é atribuída.

string

Em conversões off-line, esse é um ID fornecido pelos anunciantes. Se um anunciante não especificar um ID, o Search Ads 360 vai gerar um. Em conversões on-line, ele é igual à coluna "id" ou à coluna floodlight_order_id, dependendo das instruções do Floodlight fornecidas pelo anunciante.

string

O ID do produto clicado.

ProductChannel

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

string

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

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.

string

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

AttributionType

A que a conversão é atribuída: visita ou palavra-chave + anúncio.

string

O carimbo de data/hora do evento de conversão.

string

O carimbo de data/hora da última vez em que a conversão foi modificada.

string

O carimbo de data/hora da visita à qual a conversão é atribuída.

int64

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.

int64

A receita ajustada em micros para o evento de conversão. Estará sempre na moeda da conta de veiculação.

int64

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.

string

O ID do pedido do Floodlight fornecido pelo anunciante para a conversão.

ConversionStatus

O status da conversão, que será ATIVADO ou REMOVIDO.

int64

ID do recurso com que houve interação durante o evento de conversão.

AssetFieldType

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

string

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

customers/{customer_id}/conversionActions/{conversion_action_id}

string

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

ConversionActionStatus

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

ConversionActionType

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

ConversionActionCategory

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

ValueSettings

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

AttributionModelSettings

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

FloodlightSettings

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

int64

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

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.

bool

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

string

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

bool

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

bool

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

int64

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

string

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

AttributionModel

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

DataDrivenModelStatus

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

string

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

string

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

int64

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

double

O valor a ser usado quando os eventos de conversão para essa 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 sempre usar o valor padrão.

string

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

bool

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

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

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

string

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

string

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

ConversionCustomVariableStatus

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

string

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

ConversionCustomVariableFamily

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

ConversionCustomVariableCardinality

Cardinalidade da variável personalizada de conversão.

FloodlightConversionCustomVariableInfo

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

int64

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

FloodlightVariableType

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

FloodlightVariableDataType

Tipo de dados da variável do Floodlight definido no Search Ads 360.

bool

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, acesse https://support.google.com/adspolicy/answer/7475709.

ConversionTrackingStatus

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

bool

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.

string

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

int64

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 (conversion_tracking_status indica). Este campo é somente leitura.

int64

O ID de acompanhamento de conversões do gerente do cliente. Definido quando o cliente ativa o acompanhamento de conversões e substitui conversion_tracking_id. Esse campo só pode ser gerenciado pela interface do Google Ads. Este campo é somente leitura.

int64

O ID de acompanhamento de conversões do gerente do cliente. Definido quando o cliente ativa o acompanhamento de conversões de várias contas e substitui conversion_tracking_id.

string

O nome do recurso da coluna personalizada. Os nomes de recursos de colunas personalizadas têm o seguinte formato:

customers/{customer_id}/customColumns/{custom_column_id}

int64

ID da coluna personalizada.

string

Nome definido pelo usuário da coluna personalizada.

string

Descrição definida pelo usuário da coluna personalizada.

CustomColumnValueType

O tipo do valor do resultado da coluna personalizada.

bool

Verdadeiro quando a coluna personalizada se refere a um ou mais atributos.

bool

Verdadeiro quando a coluna personalizada se refere a uma ou mais métricas.

bool

Verdadeiro quando a coluna personalizada está disponível para uso na consulta de "SearchAds360Service.Search" e "SearchAds360Service.SearchStream".

string

A lista das colunas do sistema referenciadas dessa coluna personalizada. Por exemplo, uma coluna personalizada "soma de impressões e cliques" faz referência às colunas do sistema {"metrics.clicks", "metrics.impressions"}.

CustomColumnRenderType

Como o valor do resultado da coluna personalizada deve ser interpretado.

string

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

customers/{customer_id}

ConversionTrackingSetting

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

AccountType

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

DoubleClickCampaignManagerSetting

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

AccountStatus

Status da conta, por exemplo, "Ativada", "Pausada", "Removida" etc.

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

string

ID da conta na conta de mecanismo externo.

CustomerStatus

O status do cliente.

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

int64

O ID de cliente do administrador. Um valor 0 indica que o cliente não tem um administrador do SA360.

string

O nome descritivo do gerente.

int64

O ID de cliente do subadministrador. Um valor 0 indica que o cliente não tem um subgerente do SA360.

string

O nome descritivo do subadministrador.

int64

O ID de cliente do administrador associado. Um valor 0 indica que o cliente não tem um gerente associado do SA360.

string

O nome descritivo do gerente associado.

AccountLevelType

O nível da conta do cliente: administrador, subadministrador, administrador associado, conta de serviço.

int64

O ID do cliente.

string

Nome descritivo opcional e não exclusivo do cliente.

string

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

string

O ID de fuso horário local do cliente.

string

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

string

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

bool

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

bool

Se o cliente é um gerente.

string

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

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

Obrigatório. O recurso vinculado ao cliente.

AssetLinkStatus

Status do recurso do cliente.

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

O conjunto de recursos vinculado ao cliente.

string

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

AssetSetLinkStatus

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

string

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

string

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

customers/{customer_id}/labels/{label_id}

CustomerStatus

O status do cliente. Somente leitura.

string

O nome do recurso do cliente vinculado ao cliente especificado. Somente leitura.

bool

Especifica se esta é uma conta oculta.

Somente leitura.

int64

Distância entre o cliente e o cliente especificado. Para um link próprio, o valor do nível será 0. Somente leitura.

string

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

bool

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

bool

Identifica se o cliente é um gerente. Somente leitura.

string

Nome descritivo do cliente. Somente leitura.

string

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

int64

O ID do cliente. Somente leitura.

string

Nome do recurso. Os nomes de recursos CustomerManagerLink têm o formato: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}

ManagerLinkStatus

Status da vinculação entre o cliente e o gerente.

string

O cliente administrador vinculado ao cliente.

int64

ID da vinculação entre cliente e administrador. Este campo é somente leitura.

string

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

int64

ID do anunciante do Campaign Manager associado a este cliente.

int64

ID da rede do Campaign Manager associada a este cliente.

string

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

string

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

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

string

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

Este campo é somente leitura.

string

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

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

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

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

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

int64

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

string

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

string

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

string

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

string

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

string

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

geoTargetConstants/{parent_geo_target_constant_id}

string

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

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

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

LabelStatus

Status do rótulo. Somente leitura.

TextLabel

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

int64

ID do rótulo. Somente leitura.

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

string

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

languageConstants/{criterion_id}

int64

O ID da constante de idioma.

string

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

string

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

bool

Se o idioma pode ser segmentado.

ProductBiddingCategory

Categoria de lance de uma oferta de produto.

ProductBrand

Marca de uma oferta de produto.

ProductChannel

Localidade de uma oferta de produto.

ProductCondition

Condição de uma oferta de produto.

ProductCustomAttribute

Atributo personalizado de uma oferta de produto.

ProductItemId

ID do item de uma oferta de produto.

ProductType

Tipo de uma oferta de produto.

ListingGroupFilterBiddingCategoryLevel

Indica o nível da categoria na taxonomia.

int64

ID da categoria de lances do produto.

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

string

Valor da string da marca do produto.

ListingGroupFilterProductChannel

Valor da localidade.

ListingGroupFilterProductCondition

Valor da condição.

ListingGroupFilterCustomAttributeIndex

Indica o índice do atributo personalizado.

string

Valor da string do atributo personalizado do produto.

string

Valor do ID.

ListingGroupFilterProductTypeLevel

Nível do tipo.

string

Valor do tipo.

ListingGroupFilterDimension

O caminho completo das dimensões na hierarquia de filtros do grupo de produtos anunciados (excluindo o nó raiz) até esse filtro.

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

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

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

Nível da categoria de lances do produto.

ProductBiddingCategoryStatus

Status da categoria de lances do produto.

int64

ID da categoria de lances do produto.

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

string

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

string

Nome do recurso da categoria de lances do produto principal.

string

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

string

Mostra o valor da categoria de lances do produto localizada de acordo com o language_code.

string

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

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

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

SearchAds360Fields/{name}

SearchAds360FieldCategory

A categoria do artefato.

string

Os nomes de todos os recursos, segmentos e métricas que podem ser selecionados com o artefato descrito.

string

Os nomes de todos os recursos que podem ser selecionados com o artefato descrito. Os campos desses recursos não segmentam métricas quando incluídos em consultas de pesquisa.

Esse campo só é definido para artefatos cuja categoria é RESOURCE.

string

Esse campo lista os nomes de todas as métricas que podem ser selecionadas com o artefato descrito quando ele é usado na cláusula FROM. Ele só é definido para artefatos cuja categoria é RESOURCE.

string

Esse campo lista os nomes de todos os artefatos, sejam um segmento ou outro recurso, que segmentam as métricas quando incluídos em consultas de pesquisa e quando o artefato descrito é usado na cláusula FROM. Ele só é definido para artefatos cuja categoria é RESOURCE.

string

Valores que o artefato pode assumir se for um campo do tipo ENUM.

Esse campo só é definido para artefatos da categoria SEGMENT ou ATTRIBUTE.

SearchAds360FieldDataType

Esse campo determina os operadores que podem ser usados com o artefato em cláusulas WHERE.

string

O nome do artefato.

bool

Se o artefato pode ser usado em uma cláusula SELECT em consultas de pesquisa.

bool

Se o artefato pode ser usado em uma cláusula WHERE em consultas de pesquisa.

bool

Se o artefato pode ser usado em uma cláusula ORDER BY em consultas de pesquisa.

string

O URL do proto que descreve o tipo de dados do artefato.

bool

Indica se o artefato de campo é repetido.

string

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

string

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

customers/{customer_id}/userLists/{user_list_id}

UserListType

Tipo desta lista.

Este campo é somente leitura.

int64

ID da lista de usuários.

string

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

string

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

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

int64

ID do critério do país.

bool

Indica se o local foi segmentado ou não.

string

O nome do recurso da visita. Os nomes de recursos de visitas têm o formato:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

O ID da visita.

int64

ID de palavra-chave do Search Ads 360. Um valor 0 indica que a palavra-chave não foi atribuída.

int64

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.

int64

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

string

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

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

string

O ID do produto clicado.

ProductChannel

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

string

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

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.

string

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

int64

ID do recurso com que houve interação durante o evento de visita.

AssetFieldType

Tipo de campo do recurso do evento de visita.

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 formato:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}