Índice
AdScheduleInfo(mensagem)AdTextAsset(mensagem)AgeRangeInfo(mensagem)AssetInteractionTarget(mensagem)AssetUsage(mensagem)AudienceInfo(mensagem)BusinessProfileLocation(mensagem)CallToActionAsset(mensagem)CustomParameter(mensagem)DeviceInfo(mensagem)EnhancedCpc(mensagem)FinalAppUrl(mensagem)FrequencyCapEntry(mensagem)GenderInfo(mensagem)ImageAsset(mensagem)ImageDimension(mensagem)Keyword(mensagem)KeywordInfo(mensagem)LanguageInfo(mensagem)ListingGroupInfo(mensagem)LocationGroupInfo(mensagem)LocationInfo(mensagem)ManualCpa(mensagem)ManualCpc(mensagem)ManualCpm(mensagem)MaximizeConversionValue(mensagem)MaximizeConversions(mensagem)Metrics(mensagem)MobileAppAsset(mensagem)PercentCpc(mensagem)RealTimeBiddingSetting(mensagem)SearchAds360ExpandedDynamicSearchAdInfo(mensagem)SearchAds360ExpandedTextAdInfo(mensagem)SearchAds360ProductAdInfo(mensagem)SearchAds360ResponsiveSearchAdInfo(mensagem)SearchAds360TextAdInfo(mensagem)Segments(mensagem)SyntheticContentAttestation(mensagem)SyntheticContentInfo(mensagem)TargetCpa(mensagem)TargetCpm(mensagem)TargetImpressionShare(mensagem)TargetOutrankShare(mensagem)TargetRestriction(mensagem)TargetRoas(mensagem)TargetSpend(mensagem)TargetingSetting(mensagem)TextAsset(mensagem)TextLabel(mensagem)UnifiedCallAsset(mensagem)UnifiedCalloutAsset(mensagem)UnifiedLocationAsset(mensagem)UnifiedPageFeedAsset(mensagem)UnifiedSitelinkAsset(mensagem)UserListInfo(mensagem)Value(mensagem)WebpageConditionInfo(mensagem)WebpageInfo(mensagem)YoutubeVideoAsset(mensagem)
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 serão mostrados.
Não é possível adicionar mais de seis programações de anúncios para o mesmo dia.
| Campos | |
|---|---|
start_minute |
Minutos após a hora de início em que essa programação começa. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
end_minute |
Minutos após a hora de término da programação. O horário não inclui o minuto final. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE. |
day_of_week |
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 |
Hora 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 |
Hora de término em formato de 24 horas. 24 significa o fim do dia. Esse 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 |
Texto do recurso. |
AgeRangeInfo
Um critério de faixa etária.
| Campos | |
|---|---|
type |
Tipo de faixa etária. |
AssetInteractionTarget
Um segmento "AssetInteractionTarget".
| Campos | |
|---|---|
asset |
O nome do recurso de recurso. |
interaction_on_this_asset |
Usado apenas com métricas CustomerAsset, CampaignAsset e AdGroupAsset. Indica se as métricas de interação ocorreram no próprio recurso ou em um recurso ou bloco de anúncios diferente. |
AssetUsage
Contém as informações de uso do recurso.
| Campos | |
|---|---|
asset |
Nome do recurso do recurso. |
served_asset_field_type |
O tipo de campo veiculado do recurso. |
AudienceInfo
Um critério de público-alvo.
| Campos | |
|---|---|
audience |
O nome do recurso de público-alvo. |
BusinessProfileLocation
Dados de local do Perfil da Empresa sincronizados da conta vinculada.
| Campos | |
|---|---|
labels[] |
Rótulo especificado pelo anunciante para o local na conta do Perfil da Empresa. Esses dados são sincronizados com a conta do Perfil da Empresa. |
store_code |
O código da loja do Perfil da Empresa desse local. Esses dados são sincronizados com a conta do Perfil da Empresa. |
listing_id |
É o ID da ficha do local do Perfil da Empresa. Essas informações são sincronizadas com a conta vinculada do Perfil da Empresa. |
CallToActionAsset
Um recurso de call-to-action.
| Campos | |
|---|---|
call_to_action |
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 |
A chave que corresponde ao nome da tag de parâmetro. |
value |
O valor a ser substituído. |
DeviceInfo
Um critério de dispositivo.
| Campos | |
|---|---|
type |
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 diminui para cliques 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 "true" para uma funcionalidade equivalente.
FinalAppUrl
Um URL para links diretos em um app para o sistema operacional especificado.
| Campos | |
|---|---|
os_type |
O sistema operacional segmentado por este URL. Obrigatório. |
url |
O URL do link direto do app. Os links diretos especificam um local em um app que corresponde ao conteúdo que você quer mostrar e precisam estar no formato {scheme}://{host_path}. O esquema identifica qual app abrir. Para seu app, você pode usar um esquema personalizado que comece com o nome dele. O host e o caminho especificam o local exclusivo no app em que seu conteúdo está. Exemplo: "exampleapp://productid_1234". Obrigatório. |
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 |
Tipo de gênero. |
ImageAsset
Um recurso de imagem.
| Campos | |
|---|---|
mime_type |
Tipo MIME do recurso de imagem. |
full_size |
Metadados da imagem no tamanho original. |
file_size |
Tamanho do arquivo do recurso de imagem em bytes. |
ImageDimension
Metadados de uma imagem em um determinado tamanho, original ou redimensionada.
| Campos | |
|---|---|
height_pixels |
Altura da imagem. |
width_pixels |
Largura da imagem. |
url |
Um URL que retorna a imagem com essa altura e largura. |
Palavra-chave
Um segmento de critério de palavra-chave.
| Campos | |
|---|---|
info |
Informações de palavras-chave. |
ad_group_criterion |
O nome do recurso name. |
KeywordInfo
Um critério de palavra-chave.
| Campos | |
|---|---|
match_type |
Tipo de correspondência da palavra-chave. |
text |
O texto da palavra-chave (no máximo 80 caracteres e 10 palavras). |
LanguageInfo
Um critério de idioma.
| Campos | |
|---|---|
language_constant |
O nome do recurso da constante de idioma. |
ListingGroupInfo
Um critério de grupo de produtos anunciados.
| Campos | |
|---|---|
type |
Tipo do grupo de produtos anunciados. |
LocationGroupInfo
Um raio ao redor de uma lista de locais especificados por um feed.
| Campos | |
|---|---|
geo_target_constants[] |
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 |
Unidade do raio. Milhas e metros são aceitos para constantes de segmentação geográfica. Milimhas e milímetros são aceitos para conjuntos de itens do feed. É obrigatório e precisa ser definido em operações CREATE. |
feed_item_sets[] |
FeedItemSets 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 |
Distância em unidades que especificam o raio ao redor das regiões de segmentação. É obrigatório e precisa ser definido em operações CREATE. |
LocationInfo
Um critério de local.
| Campos | |
|---|---|
geo_target_constant |
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.
ManualCpc
Lances manuais baseados em cliques em que o usuário paga por clique.
| Campos | |
|---|---|
enhanced_cpc_enabled |
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 com base em impressões em que o usuário paga por mil impressões.
MaximizeConversionValue
Uma estratégia de lances automáticos para gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.
| Campos | |
|---|---|
cpc_bid_ceiling_micros |
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 |
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 |
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áticos para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.
| Campos | |
|---|---|
cpc_bid_ceiling_micros |
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 |
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 |
A opção de custo por ação (CPA) desejado. É 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 vai gerar o maior número possível de conversões sem ultrapassar o custo por ação desejado. Se o CPA desejado não estiver definido, a estratégia de lances tentará atingir o menor CPA possível para o orçamento. |
Métricas
Dados de métricas.
| Campos | |
|---|---|
all_conversions_value_by_conversion_date |
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 |
all_conversions_by_conversion_date |
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 a data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas |
conversion_custom_metrics[] |
As métricas personalizadas de conversão. |
conversions_value_by_conversion_date |
A soma do valor das conversões de 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 |
A soma das conversões por data de conversão para tipos de conversão que recebem lances. Pode ser fracionário devido à modelagem de atribuição. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. |
historical_creative_quality_score |
O índice de qualidade histórico do criativo. |
historical_landing_page_quality_score |
A qualidade da experiência histórica na página de destino. |
historical_search_predicted_ctr |
A taxa de cliques (CTR) prevista histórica da pesquisa. |
interaction_event_types[] |
Os tipos de interação com pagamentos e sem custo. |
raw_event_conversion_metrics[] |
As métricas de conversão de eventos brutos. |
absolute_top_impression_percentage |
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 |
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 |
Valor de todas as conversões. |
all_conversions |
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 |
O valor de todas as conversões dividido pelo custo total das interações com anúncios (como cliques em anúncios de texto ou visualizações de anúncios em vídeo). |
all_conversions_from_click_to_call |
O número de vezes que as pessoas clicaram no botão "Ligar" para ligar para uma empresa durante ou depois de clicar em um anúncio. Essa métrica não informa se as chamadas foram atendidas nem a duração delas. Essa métrica se aplica apenas a itens do feed. |
all_conversions_from_directions |
O número de vezes que as pessoas clicaram no botão "Como chegar" para ir a uma empresa depois de clicar em um anúncio. Essa métrica se aplica apenas a itens do feed. |
all_conversions_from_interactions_value_per_interaction |
O valor de todas as conversões de interações dividido pelo número total de interações. |
all_conversions_from_menu |
O número de vezes que as pessoas clicaram em um link para ver o menu de uma empresa depois de clicar em um anúncio. Essa métrica se aplica apenas a itens do feed. |
all_conversions_from_order |
O número de vezes que as pessoas fizeram um pedido em uma empresa depois de clicar em um anúncio. Essa métrica se aplica apenas a itens do feed. |
all_conversions_from_other_engagement |
O número de outros tipos de conversão (por exemplo, postar uma avaliação ou salvar o local de uma empresa) que ocorreram depois que os usuários clicaram em um anúncio. Essa métrica se aplica apenas a itens do feed. |
all_conversions_from_store_visit |
Número estimado de vezes que as pessoas visitaram uma empresa depois de clicar em um anúncio. Essa métrica se aplica apenas a itens do feed. |
visits |
Os cliques que o Search Ads 360 registrou e encaminhou à página de destino de um anunciante |
all_conversions_from_store_website |
O número de vezes que as pessoas foram direcionadas ao URL de uma empresa depois de clicar em um anúncio. Essa métrica se aplica apenas a itens do feed. |
average_cost |
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 |
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 |
average_cpm |
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 |
clicks |
O número de cliques. |
content_budget_lost_impression_share |
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 |
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 |
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 |
Média de conversões de lances (por interação) por interação qualificada para conversão. Mostra com que frequência, em média, uma interação com o anúncio gera uma conversão que recebe lances. |
client_account_conversions_value |
O valor das conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo |
conversions_value_per_cost |
O valor da conversão que recebe lances dividido pelo custo total das interações qualificadas para conversão. |
conversions_from_interactions_value_per_interaction |
O valor das conversões de interações dividido pelo número de interações com o anúncio. Isso inclui apenas as ações de conversão em que o atributo |
client_account_conversions |
O número de conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo |
cost_micros |
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 |
cost_per_all_conversions |
O custo das interações com anúncios dividido por todas as conversões. |
cost_per_conversion |
Custo médio por conversão qualificada para lances. |
cost_per_current_model_attributed_conversion |
O custo das interações com anúncios dividido pelas conversões atribuídas ao modelo atual. Isso inclui apenas as ações de conversão em que o atributo |
cross_device_conversions |
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 |
cross_device_conversions_by_conversion_date |
O número de conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas |
cross_device_conversions_value |
A soma do valor das conversões em dispositivos diferentes. |
cross_device_conversions_value_by_conversion_date |
A soma do valor das conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas |
ctr |
O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões). |
conversions |
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 |
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 |
O índice de qualidade médio. |
historical_quality_score |
O índice de qualidade histórico. |
impressions |
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 |
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 |
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 |
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 |
Número de cliques que o Google considera ilegítimos e que não são cobrados de você. |
general_invalid_click_rate |
A porcentagem de cliques que foram filtrados do número total de cliques (filtrados e não filtrados) por serem inválidos. São cliques que o Google considera ilegais e que são 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. Consulte Filtrar tráfego inválido para garantir a qualidade. |
general_invalid_clicks |
Número de cliques inválidos gerais. Eles 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. Consulte Filtrar tráfego inválido para garantir a qualidade. |
mobile_friendly_clicks_percentage |
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 |
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 Sobre métricas na parte superior e na primeira posição para mais detalhes. Qualquer valor abaixo de 0,1 é informado como 0,0999. |
search_budget_lost_absolute_top_impression_share |
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 |
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 |
A porcentagem estimada de vezes 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 |
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 |
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 |
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 |
Número que estima a frequência com que seu anúncio não foi o primeiro entre os anúncios na parte superior nos resultados da pesquisa 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_rank_lost_impression_share |
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 |
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 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 |
As impressões recebidas entre os anúncios na parte superior em comparação com o número estimado de impressões que você tinha qualificação para receber entre 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 |
A porcentagem de impressões de anúncios exibidas perto dos principais resultados da pesquisa orgânica. |
value_per_all_conversions |
O valor de todas as conversões dividido pelo número de todas as conversões. |
value_per_all_conversions_by_conversion_date |
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 |
value_per_conversion |
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 qualificadas para lances. |
value_per_conversions_by_conversion_date |
Valor das conversões qualificadas por data de conversão dividido por conversões qualificadas por data de conversão. Mostra quanto vale, em média, cada uma das conversões qualificadas para 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. |
client_account_view_through_conversions |
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. |
orders |
"Pedidos" é o número total de conversões de compra que você gerou e foram atribuídas aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se uma conversão for atribuída a interações anteriores com seus anúncios (cliques em anúncios de texto ou do Shopping, visualizações de anúncios em vídeo etc.), ela será contabilizada como um pedido. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou esse item e uma camisa em um pedido no seu site. Embora a pessoa tenha comprado dois produtos, apenas um pedido é registrado. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
average_order_value_micros |
O valor médio do pedido é a receita média por pedido atribuído aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. O valor médio do pedido é a receita total dos seus pedidos dividida pelo número total de pedidos. Exemplo: você recebeu três pedidos que geraram uma receita de R $10, R$ 15 e R $20. O valor médio do pedido é US$ 15 = (US$ 10 + US$ 15 + US$ 20)/3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
average_cart_size |
O tamanho médio do carrinho é o número médio de produtos em cada pedido atribuído aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. O tamanho médio do carrinho é o número total de produtos vendidos dividido pelo número total de pedidos que você recebeu. Exemplo: você recebeu dois pedidos, o primeiro incluía três produtos e o segundo incluía dois. O tamanho médio do carrinho é de 2,5 produtos = (3+2)/2. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
cost_of_goods_sold_micros |
O custo dos produtos vendidos (CPV) é o custo total dos produtos que você vendeu em pedidos atribuídos aos seus anúncios. Como funciona: é possível adicionar um custo de produtos vendidos a cada produto no Merchant Center. Se você informar conversões com os dados do carrinho, os produtos vendidos vão corresponder ao custo dos produtos vendidos, e esse valor poderá ser usado para calcular o lucro bruto de cada pedido. 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 para esse pedido é R$ 8 = R$ 3 + R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
gross_profit_micros |
O lucro bruto é aquele gerado por pedidos atribuídos aos seus anúncios menos o custo dos produtos vendidos (CPV). Como funciona: o lucro bruto é a receita gerada pelas vendas atribuídas aos seus anúncios menos o custo dos produtos vendidos. Os cálculos de lucro bruto incluem apenas produtos que têm valor de custo dos produtos vendidos no Merchant Center. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa em um pedido no seu site. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. O chapéu tem um custo de produtos vendidos de R$ 3, mas a camisa não tem esse custo. O lucro bruto desse pedido só vai considerar o chapéu, ou seja, R $7 = R $10 - R$ 3. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
gross_profit_margin |
A margem de lucro bruto é a porcentagem de lucro bruto gerada com os pedidos atribuídos aos seus anúncios após a dedução do custo dos produtos vendidos (CPV). Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. A margem de lucro bruto é o lucro bruto dividido pela receita total e multiplicado por 100%. Os cálculos de margem de lucro bruto incluem apenas itens que têm valor de custo dos produtos vendidos no Merchant Center. Exemplo: alguém comprou um chapéu e uma camisa em um pedido no seu site. O preço do chapéu é R$ 10, e o custo dos produtos vendidos é R$ 3. O preço da camisa é US$ 20, mas ela não tem custo dos produtos vendidos. Portanto, a margem de lucro bruto desse pedido vai considerar apenas o chapéu, que tem o valor de custo dos produtos vendidos: 70% = (R$ 10 - R$ 3)/R$ 10 x 100%. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
revenue_micros |
A receita é o valor total que você gerou pelos pedidos atribuídos aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. A receita é o valor total de todos os pedidos recebidos que são atribuídos aos seus anúncios, menos qualquer desconto. Exemplo: alguém clicou em um anúncio do Shopping de um chapéu e comprou o mesmo chapéu e uma camisa em um pedido no seu site. O chapéu tem o preço de R$ 10 e a camisa, R$ 20. Todo o pedido tem um desconto de R$ 5. A receita desse pedido é de R$ 25 = (R$ 10 + R$ 20) - R$ 5. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
units_sold |
As unidades vendidas são o número total de produtos vendidos dos pedidos atribuídos aos seus anúncios. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. As unidades vendidas são o número total de produtos vendidos de todos os pedidos atribuídos aos seus 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. Nesse pedido, há três unidades vendidas. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
client_account_cross_sell_cost_of_goods_sold_micros |
O custo dos produtos vendidos (CPV) com venda cruzada da conta de 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 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 |
cross_sell_cost_of_goods_sold_micros |
O custo dos produtos vendidos (CPV) com venda cruzada é o valor total dos itens comercializados como resultado da publicidade de outro item. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte anúncios do Shopping), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se esses produtos não forem iguais, isso será considerado venda cruzada. O custo dos produtos vendidos com venda cruzada é o 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 |
client_account_cross_sell_gross_profit_micros |
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 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 |
cross_sell_gross_profit_micros |
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 |
client_account_cross_sell_revenue_micros |
A receita de venda cruzada da conta de cliente é o valor total que você ganha 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 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 |
cross_sell_revenue_micros |
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 |
client_account_cross_sell_units_sold |
As unidades vendidas em venda cruzada da conta do cliente 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. |
cross_sell_units_sold |
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 |
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 |
lead_cost_of_goods_sold_micros |
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 |
client_account_lead_gross_profit_micros |
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 |
lead_gross_profit_micros |
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 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 |
client_account_lead_revenue_micros |
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 |
lead_revenue_micros |
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 |
client_account_lead_units_sold |
As unidades vendidas geradas por lead da conta de cliente representam o número total de produtos vendidos como resultado da publicidade desses mesmos itens. Como funciona: você informa conversões com dados do carrinho para compras concluídas no seu site. Se o anúncio que recebeu uma interação antes da compra tiver um produto associado (consulte anúncios do Shopping), esse item será considerado o anunciado. Qualquer produto incluído no pedido do cliente é um item vendido. Se os produtos anunciados e vendidos forem iguais, o número total desses produtos vendidos vai ser mostrado em "Unidades vendidas de lead". Exemplo: alguém clicou no anúncio de um chapéu no Shopping e comprou o mesmo chapéu, uma camisa e uma jaqueta. O total de Unidades vendidas geradas por lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
lead_units_sold |
As Unidades vendidas geradas por 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 geradas por lead nesse pedido é 1. Essa métrica só estará disponível se você informar as conversões com dados do carrinho. |
unique_users |
É o número de usuários únicos que viram seu anúncio durante o período solicitado. Essa métrica não pode ser agregada e só pode ser solicitada para períodos de até 92 dias. Essa métrica está disponível para os seguintes tipos de campanha: display, vídeo, Discovery e para apps. |
average_impression_frequency_per_user |
O número médio de vezes que um usuário único viu seu anúncio durante o período solicitado. Essa métrica não pode ser agregada e só pode ser solicitada para períodos de até 92 dias. Essa métrica está disponível para os seguintes tipos de campanha: display, vídeo, Discovery e para apps. |
MobileAppAsset
Um recurso que representa um app para dispositivos móveis.
| Campos | |
|---|---|
app_id |
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 |
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 |
Limite de lance máximo que pode ser definido pela estratégia de lances. É um campo opcional inserido pelo anunciante e especificado nos micros locais. Observação: um valor zero é interpretado da mesma forma que ter bid_ceiling indefinido. |
enhanced_cpc_enabled |
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 |
Indica se a campanha está ativada para lances em tempo real. |
SearchAds360ExpandedDynamicSearchAdInfo
Um anúncio dinâmico expandido de pesquisa.
| Campos | |
|---|---|
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
ad_tracking_id |
O ID de rastreamento do anúncio. |
SearchAds360ExpandedTextAdInfo
Um anúncio de texto expandido do Search Ads 360. Os anúncios de texto expandidos foram descontinuados. Use SearchAds360ResponsiveSearchAd.
| Campos | |
|---|---|
headline |
O título do anúncio. |
headline2 |
O segundo título do anúncio. |
headline3 |
O terceiro título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
path1 |
Texto anexado ao URL visível gerado automaticamente com um delimitador. |
path2 |
Texto anexado a path1 com um delimitador. |
ad_tracking_id |
O ID de rastreamento 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[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. |
path1 |
Texto anexado ao URL visível gerado automaticamente com um delimitador. |
path2 |
Texto anexado a path1 com um delimitador. |
ad_tracking_id |
O ID de rastreamento do anúncio. |
SearchAds360TextAdInfo
Um anúncio de texto do Search Ads 360.
| Campos | |
|---|---|
headline |
O título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
display_url |
O URL exibido do anúncio. |
display_mobile_url |
O URL para dispositivos móveis exibido do anúncio. |
ad_tracking_id |
O ID de rastreamento do anúncio. |
Segmentos
Campos somente de segmentos.
| Campos | |
|---|---|
ad_format_type |
Tipo de formato do anúncio. |
ad_network_type |
Tipo de rede de publicidade. |
conversion_action_category |
Categoria de ação de conversão. |
conversion_custom_dimensions[] |
As dimensões personalizadas de conversão. |
day_of_week |
Dia da semana, por exemplo, MONDAY. |
device |
Dispositivo a que as métricas se aplicam. |
keyword |
Critério de palavra-chave. |
product_channel |
Canal do produto. |
product_channel_exclusivity |
Exclusividade do canal do produto. |
product_condition |
Estado do produto. |
product_sold_condition |
Condição do produto vendido. |
raw_event_conversion_dimensions[] |
As dimensões de conversão de eventos brutos. |
conversion_action |
Nome do recurso da ação de conversão. |
conversion_action_name |
Nome da ação de conversão. |
date |
Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17. |
geo_target_city |
Nome do recurso da constante de segmentação por área geográfica que representa uma cidade. |
geo_target_country |
Nome do recurso da constante de segmentação por área geográfica que representa um país. |
geo_target_metro |
Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana. |
geo_target_postal_code |
Nome do recurso da constante de segmentação por área geográfica que representa um código postal. |
geo_target_region |
Nome do recurso da constante de segmentação por área geográfica que representa uma região. |
hour |
Hora do dia como um número entre 0 e 23. |
month |
Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd. |
product_bidding_category_level1 |
Categoria do lance (nível 1) do produto. |
product_bidding_category_level2 |
Categoria do lance (nível 2) do produto. |
product_bidding_category_level3 |
Categoria do lance (nível 3) do produto. |
product_bidding_category_level4 |
Categoria do lance (nível 4) do produto. |
product_bidding_category_level5 |
Categoria do lance (nível 5) do produto. |
product_brand |
Marca do produto. |
product_country |
Nome do recurso da constante de segmentação por área geográfica para o país de venda do produto. |
product_custom_attribute0 |
Atributo personalizado 0 do produto. |
product_custom_attribute1 |
Atributo personalizado 1 do produto. |
product_custom_attribute2 |
Atributo personalizado 2 do produto. |
product_custom_attribute3 |
Atributo personalizado 3 do produto. |
product_custom_attribute4 |
Atributo personalizado 4 do produto. |
product_item_id |
ID do item do produto. |
product_language |
Nome do recurso da constante de idioma para o idioma do produto. |
product_sold_bidding_category_level1 |
Categoria do lance (nível 1) do produto vendido. |
product_sold_bidding_category_level2 |
Categoria do lance (nível 2) do produto vendido. |
product_sold_bidding_category_level3 |
Categoria do lance (nível 3) do produto vendido. |
product_sold_bidding_category_level4 |
Categoria do lance (nível 4) do produto vendido. |
product_sold_bidding_category_level5 |
Categoria do lance (nível 5) do produto vendido. |
product_sold_brand |
Marca do produto vendido. |
product_sold_custom_attribute0 |
Atributo personalizado 0 do produto vendido. |
product_sold_custom_attribute1 |
Atributo personalizado 1 do produto vendido. |
product_sold_custom_attribute2 |
Atributo personalizado 2 do produto vendido. |
product_sold_custom_attribute3 |
Atributo personalizado 3 do produto vendido. |
product_sold_custom_attribute4 |
Atributo personalizado 4 do produto vendido. |
product_sold_item_id |
ID do item vendido. |
product_sold_title |
Título do produto vendido. |
product_sold_type_l1 |
Tipo (nível 1) do produto vendido. |
product_sold_type_l2 |
Tipo (nível 2) do produto vendido. |
product_sold_type_l3 |
Tipo (nível 3) do produto vendido. |
product_sold_type_l4 |
Tipo (nível 4) do produto vendido. |
product_sold_type_l5 |
Tipo (nível 5) do produto vendido. |
product_store_id |
ID da loja do produto. |
product_title |
Título do produto. |
product_type_l1 |
Tipo (nível 1) do produto. |
product_type_l2 |
Tipo (nível 2) do produto. |
product_type_l3 |
Tipo (nível 3) do produto. |
product_type_l4 |
Tipo (nível 4) do produto. |
product_type_l5 |
Tipo (nível 5) do produto. |
quarter |
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 2018-04-01. no formato aaaa-MM-dd. |
vertical_ads_event_participant_display_names |
Os nomes de exibição dos participantes em uma página de detalhes do evento, como artistas, palestrantes ou equipes. |
vertical_ads_hotel_class |
A classificação do hotel. Geralmente de 1 a 5 estrelas, mas totalmente personalizável no feed de hotéis. |
vertical_ads_listing |
As informações do produto associadas a uma impressão, um clique ou uma conversão. |
vertical_ads_listing_brand |
A marca associada a uma listagem específica em um contexto de anúncios verticais, por exemplo, a marca de uma locadora de carros, uma casa de férias ou um evento. |
vertical_ads_listing_city |
A cidade em que a listagem de anúncios verticais está localizada. |
vertical_ads_listing_country |
O país em que a listagem de anúncios verticais está localizada. |
vertical_ads_listing_region |
A região em que a lista de anúncios verticais está localizada. |
vertical_ads_partner_account |
Uma conta de parceiro específica em uma Central de parceiros (por exemplo, a Central para Hotéis) que fornece dados de feed de inventário para anúncios verticais. |
vertical_ads_vertical |
Tipo de anúncio vertical, como aluguéis por temporada, aluguel de carros ou eventos, usado para categorizar e segmentar dados no contexto dos anúncios verticais. |
week |
É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd. |
year |
Ano, formatado como aaaa. |
asset_interaction_target |
Usado apenas com métricas CustomerAsset, CampaignAsset e AdGroupAsset. 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" é "true", significa que as interações estão nesse recurso específico. Quando é "false", significa que as interações não estão nesse recurso específico, mas em outras partes do anúncio veiculado com ele. |
SyntheticContentAttestation
Representa uma atestação sobre conteúdo sintético de uma única fonte.
| Campos | |
|---|---|
status |
Indica se o conteúdo é considerado sintético por essa fonte. |
source |
A origem da declaração de conteúdo sintético. |
SyntheticContentInfo
Contêiner para declarações de conteúdo sintético de diferentes fontes, como o anunciante e os sistemas do Google.
| Campos | |
|---|---|
advertiser_attestation |
Entrada fornecida pelo anunciante. |
system_attestation |
Informações sobre conteúdo sintético gerado pelos sistemas do Google. |
TargetCpa
Uma estratégia de lances automáticos que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado definido.
| Campos | |
|---|---|
target_cpa_micros |
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 |
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 |
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 de acordo com o CPM desejado definido.
TargetRestriction
A lista de configurações de segmentação por dimensão de segmentação.
| Campos | |
|---|---|
targeting_dimension |
A dimensão de segmentação a que essas configurações se aplicam. |
bid_only |
Indica se os anúncios devem ser restritos para serem exibidos apenas de acordo com os critérios selecionados para essa targeting_dimension ou se devem segmentar todos os valores para essa targeting_dimension e mostrar anúncios com base na segmentação em outras TargetingDimensions. Um valor de |
TargetRoas
Uma estratégia de lances automáticos que ajuda a maximizar a receita, calculando um retorno do investimento em publicidade (ROAS) desejado específico.
| Campos | |
|---|---|
target_roas |
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 |
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 |
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 |
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 mais detalhes. |
cpc_bid_ceiling_micros |
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[] |
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 |
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 |
Cor do plano de fundo do rótulo em 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 ficar visível para contas de administrador. |
description |
Uma breve descrição do rótulo. O comprimento não pode ter mais de 200 caracteres. |
UnifiedCallAsset
Um recurso de ligação unificado.
| Campos | |
|---|---|
country_code |
Código do país com duas letras do número de telefone. Exemplos: "US", "us". |
phone_number |
O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890" |
call_conversion_reporting_state |
Indica se este CallAsset deve 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 |
A ação de conversão a que uma conversão de chamada será 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[] |
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, totalizando 42. |
call_only |
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 |
Indica se a chamada precisa ser ativada no rastreamento de chamadas. Válido para o Microsoft Ads. |
use_searcher_time_zone |
Se a extensão de chamada deve ser mostrada no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
start_date |
Data de início da vigência do recurso e quando ele pode começar a ser veiculado, no formato aaaa-MM-dd. |
end_date |
A última data em que este recurso está ativo e ainda sendo veiculado, no formato aaaa-MM-dd. |
UnifiedCalloutAsset
Um recurso de frase de destaque unificado.
| Campos | |
|---|---|
callout_text |
O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
start_date |
Data de início da vigência do recurso e quando ele pode começar a ser veiculado, no formato aaaa-MM-dd. |
end_date |
A última data em que este recurso está ativo e ainda sendo veiculado, no formato aaaa-MM-dd. |
ad_schedule_targets[] |
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, totalizando 42. |
use_searcher_time_zone |
Se o recurso vai aparecer no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
UnifiedLocationAsset
Um recurso de local unificado.
| Campos | |
|---|---|
place_id |
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 do 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[] |
A lista de locais da empresa para o 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 do Perfil da Empresa na mesma conta que apontam para o mesmo ID de lugar. |
location_ownership_type |
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 de afiliado. |
UnifiedPageFeedAsset
Um recurso de feed de páginas unificado.
| Campos | |
|---|---|
page_url |
A página da Web que os anunciantes querem segmentar. |
labels[] |
Rótulos usados para agrupar os URLs das páginas. |
UnifiedSitelinkAsset
Um recurso de sitelink unificado.
| Campos | |
|---|---|
link_text |
Texto de visualização do URL para o sitelink. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
description1 |
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 |
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 |
Data de início da vigência do recurso e quando ele pode começar a ser veiculado, no formato aaaa-MM-dd. |
end_date |
A última data em que este recurso está ativo e ainda sendo veiculado, no formato aaaa-MM-dd. |
ad_schedule_targets[] |
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, totalizando 42. |
tracking_id |
ID usado para rastrear cliques no recurso de sitelink. Este é um Yahoo! Campo somente para o Japão. |
use_searcher_time_zone |
Indica se o recurso de sitelink deve ser mostrado no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads. |
mobile_preferred |
Se a preferência é para que o recurso de sitelink seja exibido em dispositivos móveis. Válido para o Microsoft Ads. |
UserListInfo
Um critério de lista de usuários. Representa uma lista de usuários definida pelo anunciante para segmentação.
| Campos | |
|---|---|
user_list |
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 |
Um booleano. |
int64_value |
Um int64. |
float_value |
Um ponto flutuante. |
double_value |
Um duplo. |
string_value |
Uma string. |
WebpageConditionInfo
Expressão lógica para segmentar páginas da Web do site de um anunciante.
| Campos | |
|---|---|
operand |
Operando da condição de segmentação de página da Web. |
operator |
Operador da condição de segmentação de página da Web. |
argument |
Argumento da condição de segmentação de página da Web. |
WebpageInfo
Representa um critério para segmentação de páginas da Web do site de um anunciante.
| Campos | |
|---|---|
conditions[] |
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 |
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 |
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 |
Título do vídeo do YouTube. |
youtube_video_id |
ID do vídeo do YouTube. Esse é o valor da string de 11 caracteres usado no URL do vídeo do YouTube. |