Package google.ads.searchads360.v0.common

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.

MinuteOfHour

Minutos após o horário de término da programação. A programação exclui o minuto de término.

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

DayOfWeek

Dia da semana ao qual se aplica a programação.

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

int32

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

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

int32

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.

AgeRangeType

Tipo de faixa etária.

string

O nome do recurso do recurso.

bool

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

string

Nome do recurso.

ServedAssetFieldType

O tipo de campo veiculado do recurso.

string

O nome do recurso Audience.

string

Rótulo especificado pelo anunciante para o local na conta do Perfil da Empresa. A sincronização é feita com a conta do Perfil da Empresa.

string

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

int64

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

CallToActionType

Call-to-action.

string

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

string

O valor a ser substituído.

Device

Tipo de dispositivo.

GenderType

Tipo de gênero.

MimeType

Tipo MIME do recurso de imagem.

ImageDimension

Metadados desta imagem em tamanho original.

int64

É o tamanho do arquivo do recurso de imagem em bytes.

int64

É a altura da imagem.

int64

É a largura da imagem.

string

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

KeywordInfo

Informações da palavra-chave.

string

O nome do recurso name.

KeywordMatchType

Tipo de correspondência da palavra-chave.

string

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

string

O nome do recurso da constante de linguagem.

ListingGroupType

Tipo do grupo de produtos anunciados.

string

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

LocationGroupRadiusUnits

Unidade do raio. Milhas e metros são compatíveis com as constantes da segmentação geográfica. Os milissegundos e metros são aceitos para conjuntos de itens do feed. Isso é obrigatório e deve ser definido nas operações CREATE.

string

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

int64

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

string

O nome do recurso constante de destino geográfico.

bool

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

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. Mutável somente para estratégias de lances de portfólio.

int64

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

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

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

int64

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

int64

A opção de custo por ação (CPA) desejado. Esse é o valor médio que você quer gastar por ação de conversão especificada em microunidades na moeda da estratégia de lances. Se definida, a estratégia de lances receberá o maior número possível de conversões sem exceder o custo por ação desejado. Se o CPA desejado não for definido, a estratégia de lances buscará o menor CPA possível considerando o orçamento.

double

Valor de todas as conversões. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

double

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

Value

As métricas personalizadas de conversão.

double

A soma do valor das conversões que recebem lances por data de conversão. Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão.

double

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

QualityScoreBucket

O índice de qualidade histórico do criativo.

QualityScoreBucket

A qualidade da experiência histórica na página de destino.

QualityScoreBucket

A taxa de cliques (CTR) prevista do histórico de pesquisa.

InteractionEventType

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

Value

As métricas brutas de conversão de eventos.

double

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.

double

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.

double

Valor de todas as conversões.

double

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

double

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

double

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

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

double

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

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

double

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

double

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

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

double

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.

double

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.

double

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.

double

Os cliques que o Search Ads 360 registrou e encaminhou à página de destino de um anunciante

double

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.

double

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.

double

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.

double

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.

int64

O número de cliques.

double

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.

double

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.

double

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.

double

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

double

O valor das conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo include_in_client_account_conversions_metric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

double

O valor da conversão que recebe lances dividido pelo custo total das interações qualificadas para conversão.

double

O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas ações de conversão em que o atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

double

O número de conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo include_in_client_account_conversions_metric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

int64

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.

double

O custo das interações com anúncios dividido por todas as conversões.

double

Custo médio qualificado de conversão por conversão que pode receber lances.

double

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

double

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

double

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

double

O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões).

double

O número de conversões. Isso inclui apenas ações de conversão em que o atributo include_in_conversions_metric está definido como verdadeiro. Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.

double

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.

double

O índice de qualidade médio.

int64

O índice de qualidade histórico.

int64

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.

double

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.

int64

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

double

A porcentagem de cliques filtrados do número total de cliques (cliques filtrados e não filtrados) durante o período do relatório.

int64

Número de cliques que o Google considera ilegítimos e que não são cobrados de você.

double

A porcentagem de cliques de dispositivos móveis que direcionam os usuários a uma página otimizada para dispositivos móveis.

double

A porcentagem de impressões de anúncios do Shopping ou de pesquisa do cliente exibidas na posição de maior destaque no Shopping. Consulte https://support.google.com/sa360/answer/9566729 para mais detalhes. Qualquer valor abaixo de 0,1 é informado como 0,0999.

double

O número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte superior dos resultados da pesquisa devido a um orçamento baixo. Observação: a parcela de impressões perdidas na primeira opção do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

double

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.

double

O número que estima a frequência com que seu anúncio não apareceu ao lado dos principais resultados da pesquisa orgânica devido a um orçamento baixo. Observação: a parcela de impressões perdidas na parte superior do orçamento de pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

double

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.

double

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.

double

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.

double

O número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte superior dos resultados da pesquisa devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

double

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.

double

O número que estima a frequência com que seu anúncio não apareceu perto dos principais resultados da pesquisa orgânica devido a uma classificação insatisfatória. Observação: a parcela de impressões perdidas na primeira posição da pesquisa é informada entre 0 e 0,9. Qualquer valor acima de 0,9 é informado como 0,9001.

double

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

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

double

A porcentagem das suas impressões de anúncios exibidas ao lado dos principais resultados da pesquisa orgânica.

double

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

double

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

double

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

double

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

int64

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.

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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.

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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.

string

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

MobileAppVendor

Obrigatório. A loja de aplicativos que distribui o aplicativo específico.

int64

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

bool

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

bool

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

string

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

string

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

int64

O ID de acompanhamento do anúncio.

string

O título do anúncio.

string

O segundo título do anúncio.

string

O terceiro título do anúncio.

string

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

string

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

string

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

string

Texto anexado a path1 com um delimitador.

int64

O ID de acompanhamento do anúncio.

string

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

string

Texto anexado a path1 com um delimitador.

int64

O ID de acompanhamento do anúncio.

string

O título do anúncio.

string

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

string

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

string

O URL exibido do anúncio.

string

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

int64

O ID de acompanhamento do anúncio.

AdNetworkType

Tipo de rede de publicidade.

ConversionActionCategory

Categoria de ação de conversão.

Value

As dimensões personalizadas de conversão.

DayOfWeek

Dia da semana, por exemplo, MONDAY.

Device

Dispositivo a que as métricas se aplicam.

Keyword

Critério de palavra-chave.

ProductChannel

Canal do produto.

ProductChannelExclusivity

Exclusividade do canal do produto.

ProductCondition

Estado do produto.

ProductCondition

Condição do produto vendido.

Value

As dimensões brutas de conversão de eventos.

string

Nome do recurso da ação de conversão.

string

Nome da ação de conversão.

string

Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17.

string

Nome do recurso da constante de segmentação por área geográfica que representa uma cidade.

string

Nome do recurso da constante de segmentação geográfica que representa um país.

string

Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana.

string

Nome do recurso da constante de segmentação por área geográfica que representa uma região.

int32

Hora do dia como um número entre 0 e 23.

string

Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd.

string

Categoria do lance (nível 1) do produto.

string

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

string

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

string

Categoria do lance (nível 4) do produto.

string

Categoria do lance (nível 5) do produto.

string

Marca do produto.

string

Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto.

string

Atributo personalizado 0 do produto.

string

Atributo personalizado 1 do produto.

string

Atributo personalizado 2 do produto.

string

Atributo personalizado 3 do produto.

string

Atributo personalizado 4 do produto.

string

ID do item do produto.

string

Nome do recurso da constante de idioma para o idioma do produto.

string

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

string

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

string

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

string

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

string

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

string

Marca do produto vendido.

string

Atributo personalizado 0 do produto vendido.

string

Atributo personalizado 1 do produto vendido.

string

Atributo personalizado 2 do produto vendido.

string

Atributo personalizado 3 do produto vendido.

string

Atributo personalizado 4 do produto vendido.

string

ID do item vendido.

string

Título do produto vendido.

string

Tipo (nível 1) do produto vendido.

string

Tipo (nível 2) do produto vendido.

string

Tipo (nível 3) do produto vendido.

string

Tipo (nível 4) do produto vendido.

string

Tipo (nível 5) do produto vendido.

string

ID da loja do produto.

string

Título do produto.

string

Tipo (nível 1) do produto.

string

Tipo (nível 2) do produto.

string

Tipo (nível 3) do produto.

string

Tipo (nível 4) do produto.

string

Tipo (nível 5) do produto.

string

Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. no formato aaaa-MM-dd.

string

É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd.

int32

Ano, formatado como aaaa.

AssetInteractionTarget

Usado apenas com as métricas CustomerAsset, CampaignAsset e IDFAAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente. As interações (por exemplo, cliques) são contadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando elas são veiculadas em conjunto. Quando a interação_on_this_asset é verdadeira, as interações ocorrem nesse recurso específico. Quando a interação_on_this_asset é falsa, as interações não estão nesse recurso específico, mas em outras partes do anúncio veiculado com o qual esse recurso é veiculado.

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.

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. Isso só deve ser definido para estratégias de lances de portfólio.

int64

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.

TargetImpressionShareLocation

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

int64

A fração escolhida de anúncios a ser exibida na região de segmentação, em micros. Por exemplo, 1% é igual a 10.000.

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.

Int64Value

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.

TargetingDimension

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

bool

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

double

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.

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. Isso só deve ser definido para estratégias de lances de portfólio.

int64

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.

int64

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

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.

TargetRestriction

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

string

Conteúdo de texto do recurso de texto.

string

Cor 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 estar visível nas contas de administrador.

string

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

string

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

string

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

CallConversionReportingState

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

string

A ação de conversão a que uma conversão de chamada será atribuída. Se ela não for definida, a ação de conversão padrão será usada. Este campo só terá efeito se call_conversion_reporting_state estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

AdScheduleInfo

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

bool

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

bool

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

bool

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

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.

string

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

string

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

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.

string

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

AdScheduleInfo

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

bool

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

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.

BusinessProfileLocation

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

LocationOwnershipType

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

string

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

string

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

string

Texto de visualização do URL para o sitelink. Esta string conter entre 1 e 25 caracteres (valores inclusivos).

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.

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.

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.

string

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

AdScheduleInfo

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

int64

ID usado para rastrear os cliques do recurso de sitelink. Esta é uma conta de mecanismo do Yahoo! Japan.

bool

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

bool

Indica se a preferência é que o recurso de sitelink seja exibido em dispositivos móveis. Aplicável ao Microsoft Ads.

string

O nome do recurso da lista de usuários.

bool

Um booleano.

int64

Um int64.

float

Uma flutuação.

double

Um duplo.

string

Uma string.

WebpageConditionOperand

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

WebpageConditionOperator

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

string

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

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.

double

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.

string

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

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

string

Título do vídeo do YouTube.

string

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