Package google.ads.searchads360.v0.common

Índice

AdScheduleInfo

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

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

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

Campos
start_minute

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.

end_minute

MinuteOfHour

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

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

day_of_week

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.

start_hour

int32

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

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

end_hour

int32

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

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

AdTextAsset

Um recurso de texto usado em um anúncio.

Campos
text

string

Texto do recurso.

AgeRangeInfo

Um critério de faixa etária.

Campos
type

AgeRangeType

Tipo de faixa etária.

AssetInteractionTarget

Um segmento AssetInteractionTarget.

Campos
asset

string

O nome do recurso do recurso.

interaction_on_this_asset

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.

Uso de recursos

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

Campos
asset

string

Nome do recurso.

served_asset_field_type

ServedAssetFieldType

O tipo de campo veiculado do recurso.

AudienceInfo

Um critério de público-alvo.

Campos
audience

string

O nome do recurso de público-alvo.

BusinessProfileLocation

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

Campos
labels[]

string

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

store_code

string

Código da loja do Perfil da Empresa deste local. Isso é sincronizado com a conta do Perfil da Empresa.

listing_id

int64

É o ID da ficha do local do Perfil da Empresa. Sincronizada na conta vinculada do Perfil da Empresa.

CallToActionAsset

Um recurso de call-to-action.

Campos
call_to_action

CallToActionType

Call-to-action.

CustomParameter

Um mapeamento que pode ser usado por tags de parâmetro personalizadas em um tracking_url_template, final_urls ou mobile_final_urls.

Campos
key

string

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

value

string

O valor a ser substituído.

DeviceInfo

Um critério de dispositivo.

Campos
type

Device

Tipo de dispositivo.

EnhancedCpc

Esse tipo não tem campos.

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

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

FrequencyCapEntry

Esse tipo não tem campos.

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

GenderInfo

Um critério de gênero.

Campos
type

GenderType

Tipo de gênero.

ImageAsset

Um recurso de imagem.

Campos
mime_type

MimeType

Tipo MIME do recurso de imagem.

full_size

ImageDimension

Metadados da imagem no tamanho original.

file_size

int64

Tamanho do arquivo de imagem em bytes.

ImageDimension

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

Campos
height_pixels

int64

Altura da imagem.

width_pixels

int64

Largura da imagem.

url

string

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

Palavra-chave

Um segmento de critério de palavra-chave.

Campos
info

KeywordInfo

Informações da palavra-chave.

ad_group_criterion

string

O nome do recurso name.

KeywordInfo

Um critério de palavra-chave.

Campos
match_type

KeywordMatchType

Tipo de correspondência da palavra-chave.

text

string

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

LanguageInfo

Um critério de idioma.

Campos
language_constant

string

O nome do recurso da constante de idioma.

ListingGroupInfo

Um critério de grupo de fichas.

Campos
type

ListingGroupType

Tipo do grupo de produtos anunciados.

LocationGroupInfo

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

Campos
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

Unidade do raio. Milhas e metros são aceitos para constantes de segmentação por área geográfica. Os conjuntos de itens de feed têm suporte para milhas e metros. Isso é obrigatório e deve ser definido nas operações CREATE.

feed_item_sets[]

string

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

radius

int64

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

LocationInfo

Um critério de localização.

Campos
geo_target_constant

string

O nome do recurso constante de destino geográfico.

ManualCpa

Esse tipo não tem campos.

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

ManualCpc

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

Campos
enhanced_cpc_enabled

bool

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

ManualCpm

Esse tipo não tem campos.

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

MaximizeConversionValue

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

Campos
cpc_bid_ceiling_micros

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

cpc_bid_floor_micros

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

target_roas

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.

MaximizeConversions

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

Campos
cpc_bid_ceiling_micros

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

cpc_bid_floor_micros

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

target_cpa_micros

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 da 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 estiver definido, a estratégia de lances vai tentar alcançar o menor CPA possível com base no orçamento.

Métricas

Dados de métricas.

Campos
all_conversions_value_by_conversion_date

double

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

all_conversions_by_conversion_date

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.

conversion_custom_metrics[]

Value

As métricas personalizadas de conversão.

conversions_value_by_conversion_date

double

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

conversions_by_conversion_date

double

A soma das conversões por data para tipos de conversão que podem receber 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.

historical_creative_quality_score

QualityScoreBucket

O índice de qualidade histórico do criativo.

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

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

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

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

absolute_top_impression_percentage

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.

all_conversions_from_interactions_rate

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.

all_conversions_value

double

Valor de todas as conversões.

all_conversions

double

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

all_conversions_value_per_cost

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

all_conversions_from_click_to_call

double

O número de vezes que as pessoas clicaram no botão "Ligar" e telefonaram para uma loja durante ou depois de clicar em um anúncio. 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.

all_conversions_from_directions

double

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

Essa métrica se aplica apenas aos itens do feed.

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

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 apenas aos itens do feed.

all_conversions_from_order

double

Quantas vezes as pessoas fizeram um pedido em uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

all_conversions_from_other_engagement

double

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

Essa métrica se aplica apenas aos itens do feed.

all_conversions_from_store_visit

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 apenas aos itens do feed.

visits

double

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

all_conversions_from_store_website

double

O número de vezes que as pessoas foram direcionadas ao URL de uma loja depois de clicar em um anúncio.

Essa métrica se aplica apenas aos itens do feed.

average_cost

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.

average_cpc

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

average_cpm

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

clicks

int64

O número de cliques.

content_budget_lost_impression_share

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.

content_impression_share

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.

content_rank_lost_impression_share

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.

conversions_from_interactions_rate

double

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

client_account_conversions_value

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.

conversions_value_per_cost

double

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

conversions_from_interactions_value_per_interaction

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.

client_account_conversions

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.

cost_micros

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

cost_per_all_conversions

double

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

cost_per_conversion

double

Custo médio de conversões qualificadas por conversão que pode ser usada em lances.

cost_per_current_model_attributed_conversion

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.

cross_device_conversions

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.

cross_device_conversions_by_conversion_date

double

O número de conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

cross_device_conversions_value

double

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

cross_device_conversions_value_by_conversion_date

double

A soma do valor das conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.

ctr

double

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

conversions

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.

conversions_value

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.

average_quality_score

double

O índice de qualidade médio.

historical_quality_score

int64

O índice de qualidade histórico.

impressions

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.

interaction_rate

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.

interactions

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

invalid_click_rate

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.

invalid_clicks

int64

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

general_invalid_click_rate

double

A porcentagem de cliques que foram filtrados do número total de cliques (cliques filtrados e não filtrados) por serem inválidos. São cliques que o Google considera ilegítimos detectados por meios rotineiros de filtragem (isto é, tráfego inválido conhecido do data center, bots e indexadores ou outros rastreadores, padrões irregulares etc.). Você não é cobrado por eles, e eles não afetam as estatísticas da sua conta. Consulte a página de ajuda em https://support.google.com/campaignmanager/answer/6076504 para mais detalhes.

general_invalid_clicks

int64

Número de cliques inválidos gerais. São um subconjunto dos seus cliques inválidos detectados por meios de filtragem de rotina, como tráfego inválido conhecido de data centers, bots e indexadores ou outros rastreadores, padrões irregulares etc. Você não é cobrado por eles, e eles não afetam as estatísticas da sua conta. Veja mais detalhes na página de ajuda em https://support.google.com/campaignmanager/answer/6076504.

mobile_friendly_clicks_percentage

double

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

search_absolute_top_impression_share

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.

search_budget_lost_absolute_top_impression_share

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.

search_budget_lost_impression_share

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.

search_budget_lost_top_impression_share

double

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

search_click_share

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.

search_exact_match_impression_share

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.

search_impression_share

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.

search_rank_lost_absolute_top_impression_share

double

Número que estima a frequência com que seu anúncio não foi o primeiro entre os principais anúncios nos resultados da pesquisa devido à baixa classificação. 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.

search_rank_lost_impression_share

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.

search_rank_lost_top_impression_share

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.

search_top_impression_share

double

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

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

top_impression_percentage

double

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

value_per_all_conversions

double

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

value_per_all_conversions_by_conversion_date

double

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

value_per_conversion

double

O valor da conversão que pode ser usada em lances dividido pelo número de conversões que podem ser usadas em lances. Mostra o valor médio de cada uma das conversões que podem receber lances.

value_per_conversions_by_conversion_date

double

Valor das conversões que podem ser veiculadas por data de conversão dividido pelas conversões que podem ser veiculadas por data de conversão. Mostra o valor médio de cada uma das conversões que podem receber lances (por data da conversão). Quando esta coluna é selecionada com a data, os valores na coluna de data significam a data de conversão.

client_account_view_through_conversions

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.

client_account_cross_sell_cost_of_goods_sold_micros

int64

O custo dos produtos vendidos (CPV) com venda cruzada da conta do cliente é o custo total dos itens comercializados 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. 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 CPV com venda cruzada desse pedido é de R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_cost_of_goods_sold_micros

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

client_account_cross_sell_gross_profit_micros

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

cross_sell_gross_profit_micros

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

client_account_cross_sell_revenue_micros

int64

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

cross_sell_revenue_micros

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

client_account_cross_sell_units_sold

double

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

cross_sell_units_sold

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.

client_account_lead_cost_of_goods_sold_micros

int64

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

lead_cost_of_goods_sold_micros

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

client_account_lead_gross_profit_micros

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

lead_gross_profit_micros

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

client_account_lead_revenue_micros

int64

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

lead_revenue_micros

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

client_account_lead_units_sold

double

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

lead_units_sold

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.

MobileAppAsset

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

Campos
app_id

string

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

app_store

MobileAppVendor

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

PercentCpc

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

Campos
cpc_bid_ceiling_micros

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: um valor zero é interpretado da mesma forma que um bid_ceiling indefinido.

enhanced_cpc_enabled

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.

RealTimeBiddingSetting

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

Campos
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

Um anúncio dinâmico expandido de pesquisa.

Campos
description1

string

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

description2

string

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

ad_tracking_id

int64

O ID de acompanhamento do anúncio.

SearchAds360ExpandedTextAdInfo

Um anúncio de texto expandido do Search Ads 360.

Campos
headline

string

O título do anúncio.

headline2

string

O segundo título do anúncio.

headline3

string

O terceiro título do anúncio.

description1

string

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

description2

string

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

path1

string

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

path2

string

Texto anexado a path1 com um delimitador.

ad_tracking_id

int64

O ID de acompanhamento do anúncio.

SearchAds360ProductAdInfo

Esse tipo não tem campos.

Um anúncio de produto do Search Ads 360.

SearchAds360ResponsiveSearchAdInfo

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

Campos
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

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

path1

string

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

path2

string

Texto anexado a path1 com um delimitador.

ad_tracking_id

int64

O ID de acompanhamento do anúncio.

SearchAds360TextAdInfo

Um anúncio de texto do Search Ads 360.

Campos
headline

string

O título do anúncio.

description1

string

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

description2

string

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

display_url

string

O URL exibido do anúncio.

display_mobile_url

string

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

ad_tracking_id

int64

O ID de acompanhamento do anúncio.

Segmentos

Campos somente para segmentos.

Campos
ad_network_type

AdNetworkType

Tipo de rede de publicidade.

conversion_action_category

ConversionActionCategory

Categoria de ação de conversão.

conversion_custom_dimensions[]

Value

As dimensões personalizadas de conversão.

day_of_week

DayOfWeek

Dia da semana, por exemplo, SEGUNDA-FEIRA.

device

Device

Dispositivo a que as métricas se aplicam.

keyword

Keyword

Critério da palavra-chave.

product_channel

ProductChannel

Canal do produto.

product_channel_exclusivity

ProductChannelExclusivity

Exclusividade do canal do produto.

product_condition

ProductCondition

Estado do produto.

product_sold_condition

ProductCondition

Condição do produto vendido.

raw_event_conversion_dimensions[]

Value

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

conversion_action

string

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

conversion_action_name

string

Nome da ação de conversão.

date

string

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

geo_target_city

string

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

geo_target_country

string

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

geo_target_metro

string

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

geo_target_region

string

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

hour

int32

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

month

string

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

product_bidding_category_level1

string

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

product_bidding_category_level2

string

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

product_bidding_category_level3

string

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

product_bidding_category_level4

string

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

product_bidding_category_level5

string

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

product_brand

string

Marca do produto.

product_country

string

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

product_custom_attribute0

string

Atributo personalizado 0 do produto.

product_custom_attribute1

string

Atributo personalizado 1 do produto.

product_custom_attribute2

string

Atributo personalizado 2 do produto.

product_custom_attribute3

string

Atributo personalizado 3 do produto.

product_custom_attribute4

string

Atributo personalizado 4 do produto.

product_item_id

string

ID do item do produto.

product_language

string

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

product_sold_bidding_category_level1

string

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

product_sold_bidding_category_level2

string

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

product_sold_bidding_category_level3

string

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

product_sold_bidding_category_level4

string

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

product_sold_bidding_category_level5

string

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

product_sold_brand

string

Marca do produto vendido.

product_sold_custom_attribute0

string

Atributo personalizado 0 do produto vendido.

product_sold_custom_attribute1

string

Atributo personalizado 1 do produto vendido.

product_sold_custom_attribute2

string

Atributo personalizado 2 do produto vendido.

product_sold_custom_attribute3

string

Atributo personalizado 3 do produto vendido.

product_sold_custom_attribute4

string

Atributo personalizado 4 do produto vendido.

product_sold_item_id

string

ID do item vendido.

product_sold_title

string

Título do produto vendido.

product_sold_type_l1

string

Tipo (nível 1) do produto vendido.

product_sold_type_l2

string

Tipo (nível 2) do produto vendido.

product_sold_type_l3

string

Tipo (nível 3) do produto vendido.

product_sold_type_l4

string

Tipo (nível 4) do produto vendido.

product_sold_type_l5

string

Tipo (nível 5) do produto vendido.

product_store_id

string

ID da loja do produto.

product_title

string

Título do produto.

product_type_l1

string

Tipo (nível 1) do produto.

product_type_l2

string

Tipo (nível 2) do produto.

product_type_l3

string

Tipo (nível 3) do produto.

product_type_l4

string

Tipo (nível 4) do produto.

product_type_l5

string

Tipo (nível 5) do produto.

quarter

string

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

week

string

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

year

int32

Ano, formatado como aaaa.

asset_interaction_target

AssetInteractionTarget

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. As interações (por exemplo, cliques) são contabilizadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando são veiculadas juntas. Quando interaction_on_this_asset é verdadeiro, significa que as interações estão nesse recurso específico. Quando interaction_on_this_asset é falso, significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio veiculado com esse recurso.

TargetCpa

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

Campos
target_cpa_micros

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.

cpc_bid_ceiling_micros

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.

cpc_bid_floor_micros

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.

TargetCpm

Esse tipo não tem campos.

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

TargetImpressionShare

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

Campos
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

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.

TargetOutrankShare

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

Campos
cpc_bid_ceiling_micros

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.

TargetRestriction

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

Campos
targeting_dimension

TargetingDimension

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

bid_only

bool

Indica se os anúncios serão restritos para exibição apenas nos critérios selecionados para essa dimensão de segmentação ou se serão segmentados para todos os valores dela e exibidos com base na segmentação em outras dimensões de segmentação. Um valor de true significa que esses critérios só vão aplicar modificadores de lances e não vão afetar a segmentação. Um valor de false significa que esses critérios restringirão a segmentação e aplicarão modificadores de lance.

TargetRoas

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

Campos
target_roas

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.

cpc_bid_ceiling_micros

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.

cpc_bid_floor_micros

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.

TargetSpend

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

Campos
target_spend_micros
(deprecated)

int64

Descontinuado: 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 saber mais.

cpc_bid_ceiling_micros

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.

TargetingSetting

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

Campos
target_restrictions[]

TargetRestriction

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

TextAsset

Um recurso de texto.

Campos
text

string

Conteúdo de texto do recurso de texto.

TextLabel

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

Campos
background_color

string

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

description

string

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

UnifiedCallAsset

Um recurso de ligação unificado.

Campos
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

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

call_only

bool

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

call_tracking_enabled

bool

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

use_searcher_time_zone

bool

Define se a extensão de chamada vai ser mostrada no fuso horário do usuário de pesquisa. Aplicável ao Microsoft Ads.

start_date

string

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

end_date

string

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

UnifiedCalloutAsset

Um recurso de frase de destaque unificado.

Campos
callout_text

string

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

start_date

string

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

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

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

use_searcher_time_zone

bool

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

UnifiedLocationAsset

Um recurso de local unificado.

Campos
place_id

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.

business_profile_locations[]

BusinessProfileLocation

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

location_ownership_type

LocationOwnershipType

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

UnifiedPageFeedAsset

Um recurso de feed de páginas unificado.

Campos
page_url

string

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

labels[]

string

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

UnifiedSitelinkAsset

Um recurso de sitelink unificado.

Campos
description1

string

Primeira linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusivo, e a description2 também precisa ser definida.

description2

string

Segunda linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, sendo inclusivo, e a description1 também precisa ser definida.

start_date

string

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

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

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

tracking_id

int64

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

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

UserListInfo

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

Campos
user_list

string

O nome do recurso da lista de usuários.

Valor

Um contêiner de dados genérico.

Campos
Campo de união value. um valor. value pode ser apenas de um dos tipos a seguir:
boolean_value

bool

Um booleano.

int64_value

int64

Um int64.

float_value

float

Uma flutuação.

double_value

double

Um duplo.

string_value

string

Uma string.

WebpageConditionInfo

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

Campos
operand

WebpageConditionOperand

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

operator

WebpageConditionOperator

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

argument

string

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

WebpageInfo

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

Campos
conditions[]

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.

coverage_percentage

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.

criterion_name

string

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

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

YoutubeVideoAsset

Um recurso do YouTube.

Campos
youtube_video_title

string

Título do vídeo do YouTube.

youtube_video_id

string

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