A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google searchads-api-announcements para ficar por dentro das próximas melhorias e versões.
Os campos dos recursos acima podem ser selecionados junto com esse recurso nas cláusulas SELECT e WHERE. Esses campos não segmentam as métricas na cláusula SELECT.
O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores.
Categoria
ATTRIBUTE
Tipo de dados
DOUBLE
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.cpc_bid_micros
Descrição do campo
Lance de CPC (custo por clique).
Categoria
ATTRIBUTE
Tipo de dados
INT64
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.creation_time
Descrição do campo
A data e a hora em que esse critério do grupo de anúncios foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".
Categoria
ATTRIBUTE
Tipo de dados
DATE
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.criterion_id
Descrição do campo
ID do critério.
Categoria
ATTRIBUTE
Tipo de dados
INT64
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.effective_cpc_bid_micros
Descrição do campo
O lance de CPC (custo por clique) efetivo.
Categoria
ATTRIBUTE
Tipo de dados
INT64
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.effective_labels
Descrição do campo
Os nomes dos recursos dos rótulos efetivos anexados a este critério do grupo de anúncios. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse critério do grupo de anúncios.
Categoria
ATTRIBUTE
Tipo de dados
RESOURCE_NAME
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Falso
Repetida
Verdadeiro
ad_group_criterion.engine_id
Descrição do campo
ID do critério do grupo de anúncios na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads (por exemplo, Yahoo Japan, Microsoft, Baidu etc.). Para a entidade do Google Ads, use "ad_group_crin.crin_id".
Categoria
ATTRIBUTE
Tipo de dados
STRING
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.engine_status
Descrição do campo
O status do mecanismo para o critério do grupo de anúncios.
O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).
Categoria
ATTRIBUTE
Tipo de dados
STRING
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.labels
Descrição do campo
Os nomes dos recursos dos rótulos anexados a este critério do grupo de anúncios.
Categoria
ATTRIBUTE
Tipo de dados
RESOURCE_NAME
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Falso
Repetida
Verdadeiro
ad_group_criterion.last_modified_time
Descrição do campo
A data e a hora em que esse critério do grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".
O nome do recurso constante de destino geográfico.
Categoria
ATTRIBUTE
Tipo de dados
RESOURCE_NAME
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Falso
Repetida
Falso
ad_group_criterion.negative
Descrição do campo
Indica se o critério será segmentado (false) ou excluído (true). Este campo não pode ser modificado. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente.
A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página dos resultados de pesquisa.
Categoria
ATTRIBUTE
Tipo de dados
INT64
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.quality_info.quality_score
Descrição do campo
Índice de qualidade. Esse campo não será preenchido se o Google não tiver informações suficientes para determinar um valor.
Categoria
ATTRIBUTE
Tipo de dados
INT32
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.resource_name
Descrição do campo
O nome do recurso do critério do grupo de anúncios. Os nomes dos recursos do critério do grupo de anúncios têm o formato: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
Categoria
ATTRIBUTE
Tipo de dados
RESOURCE_NAME
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Falso
Repetida
Falso
ad_group_criterion.status
Descrição do campo
O status do critério. Este é o status da entidade do critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios da interface do usuário podem incorporar informações adicionais que afetam a qualificação de um critério para execução. Em alguns casos, um critério REMOVIDO na API ainda pode aparecer como ativado na IU. Por exemplo, as campanhas são exibidas por padrão para usuários de todas as faixas etárias, a menos que sejam excluídas. A interface vai mostrar cada faixa etária como "ativada", já que elas estão qualificadas para ver os anúncios. mas gclid.status mostrará "removido", já que nenhum critério positivo foi adicionado.
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.
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.
Categoria
ATTRIBUTE
Tipo de dados
DOUBLE
Digite o URL
N/A
Filtrável
Verdadeiro
Selecionável
Verdadeiro
Sortable
Verdadeiro
Repetida
Falso
ad_group_criterion.webpage.criterion_name
Descrição do campo
O nome do critério definido por este parâmetro. O valor de nome será usado para identificar, classificar e filtrar critérios com esse tipo de parâmetro. Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eThe Ad Group Criterion report provides insights into the performance, targeting settings, and status of explicitly added criteria within ad groups.\u003c/p\u003e\n"],["\u003cp\u003eIt covers a wide range of criterion types, including age range, gender, keywords, locations, and more, each with specific attributes.\u003c/p\u003e\n"],["\u003cp\u003eThe report includes fields for bidding, performance metrics, URLs, tracking, status, and relationships to other resources like the ad group and campaign.\u003c/p\u003e\n"],["\u003cp\u003eIt's important to note that the report only includes explicitly added criteria and might not reflect all information available in the UI.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers can utilize the report's data structure and field descriptions to analyze and optimize ad group criteria for improved campaign performance.\u003c/p\u003e\n"]]],["Ad group criteria are targeting methods added to ad groups, with attributes like `ad_group`, `campaign`, and `customer`. Key actions include defining conditions, setting `bid_modifier` and `cpc_bid_micros`, and specifying criteria types like `AGE_RANGE` or `KEYWORD`. Attributes define criterion details, like match types, text, status, and URLs. The data allows for filtering, selecting, and sorting across various fields and can specify if criteria target or exclude. Additional elements include the `user_list` and webpage targeting information.\n"],null,[]]
