Package google.ads.searchads360.v0.common

Índice

AdScheduleInfo

Representa um critério de AdSchedule.

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

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

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 a hora de término em que esta programação termina. A programação exclui os minutos de término.

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

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

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

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

end_hour

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.

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 somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios.

AssetUsage

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 do Perfil da Empresa.

Campos
labels[]

string

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

store_code

string

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

listing_id

int64

ID da ficha desse local do Perfil da Empresa. Isso é sincronizado 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âmetros personalizados 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ática que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques em que a probabilidade é menor.

Esta estratégia de lances foi descontinuada e não pode mais ser criada. Use ManualCpc comenhanced_cpc_enabled definido como "true" para a 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 algum conjunto de anúncios) pode ser exibido a um usuário em 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 desta imagem no tamanho original.

file_size

int64

Tamanho do arquivo do recurso de imagem em bytes.

ImageDimension

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

Campos
height_pixels

int64

É a altura da imagem.

width_pixels

int64

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

ListingGroupInfo

Um critério do grupo de fichas.

Campos
type

ListingGroupType

Tipo do grupo de produtos anunciados.

LocationGroupInfo

Um raio ao redor de uma lista de locais especificados por 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, apenas uma constante de segmentação geográfica é permitida.

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

GBPSets cujos ViewModels são segmentados. Se vários IDs forem especificados, todos os itens que aparecem em pelo menos um conjunto serão segmentados. Não é possível usar este campo com geo_target_constants. Isso é 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 nas operações CREATE.

LocationInfo

Um critério de local.

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

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

Lance manual baseado em impressão, no qual o usuário paga por mil impressões.

MaximizeConversionValue

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

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 que ajuda a gerar o maior número de conversões para suas campanhas dentro do orçamento disponível.

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

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

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 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 de conversão para tipos de conversão que recebem lances. Pode ser fracionário devido ao modelo de atribuição. Quando essa coluna é selecionada com data, os valores na coluna de data significam a data da conversão.

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

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

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

all_conversions_from_directions

double

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

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

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

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

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

all_conversions_from_order

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.

all_conversions_from_other_engagement

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.

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

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

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

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 recebe lances dividido pelo custo total das interações qualificadas de 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 qualificado de conversão por conversão que recebe 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_value

double

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

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.

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

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

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

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

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

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

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

search_top_impression_share

double

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

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

top_impression_percentage

double

A porcentagem de impressões de anúncios que são 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 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 recebe lances dividido pelo número de conversões que recebem lances. Mostra quanto vale, em média, cada uma das conversões que recebem lances.

value_per_conversions_by_conversion_date

double

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

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

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

client_account_cross_sell_gross_profit_micros

int64

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

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

client_account_cross_sell_revenue_micros

int64

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

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

client_account_cross_sell_units_sold

double

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

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

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

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

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

client_account_lead_revenue_micros

int64

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

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

client_account_lead_units_sold

double

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

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 aplicativo para dispositivos móveis. Ele deve 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 o aplicativo específico.

PercentCpc

Estratégia de lances em que os lances são uma fração do preço anunciado para algum 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 maneira que ter bid_threshold 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 somente para campanhas que segmentam a rede do Ad Exchange.

Campos
opt_in

bool

Indica se os lances em tempo real estão ativados na campanha.

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

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

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

ad_tracking_id

int64

O ID de acompanhamento do anúncio.

Segmentos

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

device

Device

Dispositivo a que as métricas se aplicam.

keyword

Keyword

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

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.

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

product_sold_bidding_category_level2

string

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

product_sold_bidding_category_level3

string

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

product_sold_bidding_category_level4

string

Categoria de 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 civil para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. no formato aaaa-MM-dd.

week

string

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

year

int32

Ano, formatado como aaaa.

asset_interaction_target

AssetInteractionTarget

Usado somente com as métricas CustomerAsset, CampaignAsset e adgroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em outro recurso ou bloco de anúncios. As interações (por exemplo, cliques) são contabilizadas em todas as partes do anúncio veiculado (por exemplo, o próprio anúncio e outros componentes, como sitelinks) quando são veiculadas juntas. Quando "Interaction_on_this_asset" é verdadeiro, as interações são nesse recurso específico. Já quando "Interaction_on_this_asset" é falso, isso significa que as interações não estão nesse recurso, mas em outras partes do anúncio com que esse recurso é veiculado.

TargetCpa

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

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 (custo por mil impressões) desejado é uma estratégia de lances automáticos que define lances para otimizar a performance de acordo com o CPM desejado que você definiu.

TargetImpressionShare

Uma estratégia de lances automáticos que define lances para que uma determinada porcentagem de anúncios de pesquisa seja exibida na parte superior da primeira página (ou em outra região de segmentação).

Campos
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

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

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 deve superar um concorrente específico. Essa 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 devem ser exibidos somente para os critérios selecionados para essa segmentação_dimension ou todos os valores para essa segmentação_dimension e mostrar anúncios com base na sua segmentação em outras "Segmentação". Um valor de true significa que esses critérios só vão aplicar modificadores de lance, sem afetar a segmentação. Um valor de false significa que esses critérios restringirão a segmentação e a aplicação de modificadores de lance.

TargetRoas

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

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ática 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

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

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, nos níveis da campanha e do grupo de anúncios. Para mais detalhes sobre a configuração de segmentação, acesse https://support.google.com/google-ads/answer/7365594

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 do recurso de texto.

TextLabel

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

Campos
background_color

string

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

description

string

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

UnifiedCallAsset

Um recurso de ligação unificado.

Campos
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

A ação de conversão à qual atribuir uma conversão de chamada. Se deixada sem definição, a ação de conversão padrão vai ser usada. Esse campo só terá efeito se 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. Pode haver no máximo seis programações por dia, 42 no total.

call_only

bool

Indica 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

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

use_searcher_time_zone

bool

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

start_date

string

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

end_date

string

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

end_date

string

Última data de quando esse recurso entra em vigor e ainda é 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. Pode haver no máximo seis programações por dia, 42 no total.

use_searcher_time_zone

bool

Define se o recurso será exibido 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 da empresa do cliente. Isso só será retornado se o recurso de local estiver sendo sincronizado da conta do Perfil da Empresa. É possível ter várias fichas de empresas do Perfil da Empresa na mesma conta que apontam para o mesmo ID de lugar.

location_ownership_type

LocationOwnershipType

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

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 da página.

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

end_date

string

Última data de quando esse recurso entra em vigor e ainda é 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. Pode haver no máximo seis programações por dia, 42 no total.

tracking_id

int64

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

use_searcher_time_zone

bool

Indica se o recurso de sitelink será exibido no fuso horário do usuário da pesquisa. Válido para o 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 a 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 da página da Web.

operator

WebpageConditionOperator

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

argument

string

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

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 de nome é usado para identificar, classificar e filtrar critérios com esse tipo de parâmetro.

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

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. Este é um valor de string de 11 caracteres usado no URL do vídeo do YouTube.