Métricas de performance e atributos de configuração dos grupos de anúncios.
Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, pelo método Reports.request()).
Solicitar trecho
Envie um corpo de solicitação
Reports.request()
regular, mas especifique "reportType": "adGroup".
{
...
"reportType": "adGroup",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Para cada coluna que você quer retornar ou filtrar no relatório,
especifique o columnName listado na tabela abaixo.
Também é possível especificar
headerText,
startDate
e endDate.
Algumas colunas não podem ser filtradas. Consulte "Filtrável" na tabela abaixo.
columnName | Descrição | Comportamento | Tipo | Filtrável |
|---|---|---|---|---|
status |
Um alias para o atributo adGroupStatus. |
atributo | Status |
Sim |
engineStatus |
Status adicional do grupo de anúncios na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem eligible, campaign ended etc. |
atributo | String |
Sim |
creationTimestamp |
Carimbo de data/hora da criação do grupo de anúncios, formatado em ISO 8601. | atributo | Timestamp |
Sim |
lastModifiedTimestamp |
Carimbo de data/hora da modificação mais recente do grupo de anúncios, formatado em ISO 8601. | atributo | Timestamp |
Sim |
agency |
Nome da agência. | atributo | String |
Sim |
agencyId |
ID da agência do DS. | atributo | ID |
Sim |
advertiser |
Nome do anunciante. | atributo | String |
Sim |
advertiserId |
ID do anunciante do DS. | atributo | ID |
Sim |
account |
Nome da conta de mecanismo. | atributo | String |
Sim |
accountId |
ID da conta de mecanismo do DS. | atributo | ID |
Sim |
accountEngineId |
ID da conta na conta de mecanismo externo. | atributo | String |
Sim |
accountType |
Tipo de conta do mecanismo: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu ou Comparison Shopping. |
atributo | Engine type |
Sim |
campaign |
Nome da campanha. | atributo | String |
Sim |
campaignId |
ID da campanha do DS. | atributo | ID |
Sim |
campaignStatus |
O status da campanha que contém o item. | atributo | Status |
Sim |
adRotation |
Rotação de veiculação de anúncios usada pelo grupo de anúncios: Optimize ou Rotate indefinitely. |
atributo | String |
Não |
adGroup |
Nome do grupo de anúncios. | atributo | String |
Sim |
adGroupId |
ID do grupo de anúncios do DS. | atributo | ID |
Sim |
adGroupStatus |
O status do grupo de anúncios: Active, Paused ou Removed. As campanhas, os grupos de anúncios, as palavras-chave, os anúncios e as segmentações têm status próprios. Consulte o status. |
atributo | Status |
Sim |
adGroupEngineId |
ID do grupo de anúncios na conta de mecanismo externo. | atributo | ID |
Sim |
adGroupStartDate |
Data de início do grupo de anúncios. | atributo | Date |
Sim |
adGroupEndDate |
Data de término do grupo de anúncios. | atributo | Date |
Sim |
adGroupSearchMaxCpc |
Lance padrão para palavras-chave de pesquisa neste grupo de anúncios. | atributo | Money |
Sim |
adGroupBroadMaxCpc |
Lance padrão para palavras-chave de correspondência ampla no grupo de anúncios (somente no Bing Ads). | atributo | Money |
Sim |
adGroupExactMaxCpc |
Lance padrão para palavras-chave de correspondência exata neste grupo de anúncios (somente Bing Ads). | atributo | Money |
Sim |
adGroupPhraseMaxCpc |
Lance padrão para palavras-chave de correspondência de frase em pesquisa neste grupo de anúncios (somente Bing Ads). | atributo | Money |
Sim |
adGroupContentMaxCpc |
Lance padrão para palavras-chave de conteúdo neste grupo de anúncios. | atributo | Money |
Sim |
adGroupMobileBidAdjustment |
A porcentagem pela qual os lances são ajustados para dispositivos móveis. Por exemplo, 0,2 significa um aumento de 20%, então os lances para dispositivos móveis são 1,2 vezes o lance padrão. O intervalo de valores válidos varia de acordo com o mecanismo externo. | atributo | Number |
Sim |
adGroupTabletBidAdjustment |
A porcentagem pela qual os lances são ajustados para tablets. Por exemplo, 0,2 significa um aumento de 20%, então os lances para tablets são 1,2 vezes o lance padrão. O intervalo de valores válidos varia de acordo com o mecanismo externo. | atributo | Number |
Sim |
adGroupDesktopBidAdjustment |
A porcentagem pela qual os lances são ajustados para computadores. Por exemplo, 0,2 significa um aumento de 20%, então os lances para computador são 1,2 vezes o lance padrão. O intervalo de valores válidos varia de acordo com o mecanismo externo. | atributo | Number |
Sim |
adGroupType |
(Aplicável apenas ao Google Ads) Indica o tipo de grupo de anúncios: Standard, Dynamic ou Showcase. |
atributo | Ad group type |
Sim |
bingAdsLanguage |
O idioma dos anúncios e das palavras-chave em um grupo de anúncios do Bing Ads. | atributo | Microsoft language code |
Sim |
bingAdsAdDistributions |
Canais de distribuição de anúncios usados pelos grupos de anúncios do Bing Ads, uma combinação de Search e Content. |
atributo | String |
Não |
adGroupLabels |
Nomes dos rótulos atribuídos diretamente a este grupo de anúncios. Os rótulos herdados não são incluídos. | atributo | String list |
Sim |
effectiveBidStrategyId |
ID do DS da estratégia de lance atribuída a essa entidade ou herdada por ela. | atributo | ID |
Sim |
effectiveBidStrategy |
O nome da estratégia de lances atribuída ou herdada por essa entidade. | atributo | String |
Sim |
bidStrategyInherited |
Indica se a estratégia de lances da entidade é herdada. | atributo | Boolean |
Sim |
deviceTargets |
Segmentações de dispositivo no nível do grupo de anúncios: uma combinação de Desktop, Mobile, Tablet ou Other. |
atributo | String |
Não |
effectiveDeviceTargets |
Segmentações de dispositivo no nível do grupo de anúncios ou herdadas da campanha, uma combinação de Desktop, Mobile, Tablet ou Other. |
atributo | String |
Não |
countryTargets |
País segmentado incluído no grupo de anúncios. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
provinceTargets |
Províncias segmentadas incluídas no grupo de anúncios. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
metroTargets |
Metas de metrô incluídas no grupo de anúncios. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
cityTargets |
Cidades segmentadas incluídas no grupo de anúncios. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
effectiveCountryTargets |
País de segmentação incluído no grupo de anúncios ou herdado da campanha. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
effectiveProvinceTargets |
As províncias segmentadas incluídas no grupo de anúncios ou herdadas da campanha. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
effectiveMetroTargets |
Segmentações de metrô incluídas no grupo de anúncios ou herdadas da campanha. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
effectiveCityTargets |
Cidades segmentadas incluídas no grupo de anúncios ou herdadas da campanha. Faça o download de modelos de upload e códigos de área geográfica/idioma. | atributo | String |
Não |
effectiveLabels |
Nomes de todos os rótulos herdados ou atribuídos diretamente a este grupo de anúncios. | atributo | String list |
Sim |
engineRemarketingListTargetAll |
Indica se o grupo de anúncios usa apenas segmentações de remarketing para ajustar lances. Valores possíveis:
|
atributo | Boolean |
Sim |
clicksWithFeedItemShowing |
Clique em qualquer link no anúncio enquanto o item do feed estava sendo mostrado. Essa coluna só retorna um valor em um relatório de item de feed ou em um relatório segmentado por uma coluna de item de feed. | métrica | Integer |
Sim |
costWithFeedItemShowing |
Custo de todos os anúncios quando o item do feed estava sendo mostrado. Essa coluna só retorna um valor em um relatório de item de feed ou em um relatório segmentado por uma coluna de item de feed. | métrica | Money |
Sim |
dfaActions |
O número total de ações do Campaign Manager. | métrica | Integer |
Sim |
dfaRevenue |
Receita agregada gerada pelas transações do Campaign Manager. | métrica | Money |
Sim |
dfaTransactions |
O número total de transações do Campaign Manager. | métrica | Integer |
Sim |
dfaWeightedActions |
Soma ponderada das ações do Campaign Manager. | métrica | Number |
Sim |
dfaActionsCrossEnv |
O número total de ações do Campaign Manager em vários ambientes. | métrica | Number |
Sim |
dfaRevenueCrossEnv |
Receita agregada gerada por transações do Campaign Manager em vários ambientes. | métrica | Money |
Sim |
dfaTransactionsCrossEnv |
O número total de transações do Campaign Manager em vários ambientes. | métrica | Number |
Sim |
dfaWeightedActionsCrossEnv |
Soma ponderada de ações do Campaign Manager em vários ambientes. | métrica | Number |
Sim |
avgCpc |
Custo médio por clique. | métrica | Money |
Sim |
avgCpm |
Custo médio por mil impressões | métrica | Money |
Sim |
avgPos |
Posição média. | métrica | Number |
Sim |
clicks |
Cliques agregados. | métrica | Integer |
Sim |
cost |
Custo agregado pago às contas de mecanismo. | métrica | Money |
Sim |
ctr |
Taxa de cliques média. | métrica | Number |
Sim |
impr |
É o número total de impressões. | métrica | Integer |
Sim |
adWordsConversions |
Os dados que o anunciante configurou para serem informados na coluna "Conversões" do Google Ads. Quando uma ação de conversão do Google Ads é criada, o anunciante pode escolher se quer contar essas conversões na coluna "Conversões" do relatório. | métrica | Number |
Sim |
adWordsConversionValue |
Valor agregado das conversões do Google Ads. | métrica | Number |
Sim |
adWordsViewThroughConversions |
O número total de conversões de visualização do Google Ads. | métrica | Integer |
Sim |
visits |
O número total de visitas de DS. | métrica | Integer |
Sim |
searchImpressionShare |
Somente Google Ads e Bing Ads. O número de impressões recebidas na rede de pesquisa dividido pelo número estimado de impressões que você estava qualificado para receber. Retorna como um número entre 0,1 e 1 ou, se a ação for menor que 0,1, a string < 10%. |
métrica | Impression share |
Sim |
searchRankLostImpressionShare |
Somente Google Ads e Bing Ads. A porcentagem de tempo em que seus anúncios não foram exibidos na rede de pesquisa devido à baixa classificação do anúncio. Retornado como um número entre 0 e 0,9 ou, se a participação for maior que 0,9, como uma string > 90%. |
métrica | Impression share |
Sim |
displayImpressionShare |
Somente Google Ads. As impressões recebidas na Rede de Display divididas pelo número estimado de impressões que você estava qualificado para receber. Retorna como um número entre 0,1 e 1 ou, se a ação for menor que 0,1, a string < 10%. |
métrica | Impression share |
Sim |
displayRankLostImpressionShare |
Somente Google Ads. A porcentagem de tempo em que seus anúncios não foram exibidos na Rede de Display devido à classificação insatisfatória do anúncio. Retornado como um número entre 0 e 0,9 ou, se a participação for maior que 0,9, como uma string > 90%. |
métrica | Impression share |
Sim |
qualityScoreAvg |
Somente Google Ads e Bing Ads. A média ponderada por impressões do Índice de qualidade (IQ) do mecanismo em todos os dias e palavras-chave no escopo do relatório. | métrica | Number |
Sim |
topOfPageBidAvg |
Somente Google Ads. Aproxima o lance de CPC médio necessário durante o período do relatório para que seus anúncios apareçam regularmente nas primeiras posições acima dos resultados da pesquisa. | métrica | Money |
Sim |
absoluteTopImpressionPercentage |
Porcentagem de impressões de anúncios exibidas como o primeiro anúncio acima dos resultados da pesquisa orgânica. | métrica | Impression share |
Sim |
searchAbsoluteTopImpressionShare |
As impressões recebidas na primeira posição (o primeiro anúncio acima dos resultados da pesquisa orgânica) divididas pelo número estimado de impressões que você tinha qualificação para receber nessa posição. | métrica | Impression share |
Sim |
topImpressionPercentage |
Porcentagem de impressões de anúncios exibidas em qualquer lugar acima dos resultados da pesquisa orgânica. | métrica | Impression share |
Sim |
searchTopImpressionShare |
É o número de impressões recebidas na posição superior (qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você tinha qualificação para receber nessa posição. | métrica | Impression share |
Sim |
searchRankLostAbsoluteTopImpressionShare |
Estima a frequência com que seu anúncio não apareceu na primeira posição acima dos resultados da pesquisa orgânica devido a uma classificação insatisfatória. | métrica | Impression share |
Sim |
searchRankLostTopImpressionShare |
Estima a frequência com que seu anúncio não foi exibido acima dos resultados da pesquisa orgânica devido a uma classificação insatisfatória. | métrica | Impression share |
Sim |
date |
Segmenta o relatório por dias. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada dia. Essa coluna retorna a data de cada linha. | segmentar | Date |
Sim |
monthStart |
Segmenta o relatório por meses. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada mês. Essa coluna retorna o primeiro dia do mês de cada linha. | segmentar | Date |
Sim |
monthEnd |
Segmenta o relatório por meses. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada mês. Essa coluna retorna o último dia do mês de cada linha. | segmentar | Date |
Sim |
quarterStart |
Segmenta o relatório por trimestres. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada trimestre. Essa coluna retorna o primeiro dia do trimestre de cada linha. | segmentar | Date |
Sim |
quarterEnd |
Segmenta o relatório por trimestres. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada trimestre. Essa coluna retorna o último dia do trimestre de cada linha. | segmentar | Date |
Sim |
weekStart |
Segmenta o relatório por semanas (domingo a sábado). Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada semana. Essa coluna retorna o primeiro dia (domingo) de cada linha. | segmentar | Date |
Sim |
weekEnd |
Segmenta o relatório por semanas (domingo a sábado). Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada semana. Essa coluna retorna o último dia (sábado) de cada linha. | segmentar | Date |
Sim |
yearStart |
Segmenta o relatório por anos. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada ano. Essa coluna retorna o primeiro dia do ano de cada linha. | segmentar | Date |
Sim |
yearEnd |
Segmenta o relatório por anos. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada ano. Essa coluna retorna o último dia do ano de cada linha. | segmentar | Date |
Sim |
deviceSegment |
Segmenta o relatório por dispositivo. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada segmento de dispositivo. Essa coluna retorna o segmento do dispositivo de cada linha. | segmentar | Device segment |
Sim |
floodlightGroup |
Segmenta o relatório por grupos do Floodlight. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Essa coluna retorna o nome do grupo do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
floodlightGroupId |
Segmenta o relatório por grupos do Floodlight. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Essa coluna retorna o ID do grupo do DS Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | ID |
Sim |
floodlightGroupTag |
Segmenta o relatório por grupos do Floodlight. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Essa coluna retorna a tag do grupo do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
floodlightActivity |
Segmenta o relatório por atividades do Floodlight. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Essa coluna retorna o nome da atividade do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
floodlightActivityId |
Segmenta o relatório por atividades do Floodlight. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Essa coluna retorna o ID da atividade do DS Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | ID |
Sim |
floodlightActivityTag |
Segmenta o relatório por atividades do Floodlight. Cada linha e as métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Esta coluna retorna a tag da atividade do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |
sitelinkDisplayText |
Segmenta o relatório por sitelinks. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna o texto de visualização do sitelink de cada linha. | segmentar | String |
Sim |
sitelinkDescription1 |
Segmenta o relatório por sitelinks. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna a descrição 1 do sitelink de cada linha. | segmentar | String |
Sim |
sitelinkDescription2 |
Segmenta o relatório por sitelinks. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna a descrição 2 do sitelink de cada linha. | segmentar | String |
Sim |
sitelinkLandingPageUrl |
Segmenta o relatório por sitelinks. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna o URL da página de destino do sitelink de cada linha. | segmentar | String |
Sim |
sitelinkClickserverUrl |
Segmenta o relatório por sitelinks. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna o URL do servidor de cliques do sitelink de cada linha. | segmentar | String |
Sim |
locationBusinessName |
Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da Empresa. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna o nome da empresa do local para cada linha. | segmentar | String |
Sim |
locationCategory |
Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da Empresa. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna a categoria do local para cada linha. | segmentar | String |
Sim |
locationDetails |
Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da Empresa. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna os detalhes de um local para cada linha. | segmentar | String |
Sim |
locationFilter |
Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da Empresa. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna o filtro do local para cada linha. | segmentar | String |
Não |
callPhoneNumber |
Segmenta o relatório por extensão de chamada. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o número de telefone de uma extensão de chamada. | segmentar | String |
Sim |
callCountryCode |
Segmenta o relatório por extensão de chamada. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o código do país da extensão de chamada de cada linha. | segmentar | String |
Sim |
callIsTracked |
Segmenta o relatório por extensão de chamada. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna "true" se as chamadas da extensão de chamada forem rastreadas. Caso contrário, retorna "false". | segmentar | Boolean |
Sim |
callCallOnly |
Segmenta o relatório por extensão de chamada. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna "verdadeiro" se a extensão de chamada mostra apenas um número de telefone ou "falso" se a extensão mostra um número de telefone e um link. | segmentar | Boolean |
Sim |
callConversionTracker |
Segmenta o relatório por extensões de chamada. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o nome do rastreador de conversões associado ao item do feed, se houver. | segmentar | String |
Sim |
callConversionTrackerId |
Segmenta o relatório por extensões de chamada. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o ID do rastreador de conversões associado à extensão de chamada, se houver. | segmentar | ID |
Sim |
appId |
Segmenta o relatório por extensão de app. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão. Essa coluna retorna o ID do app, se houver. | segmentar | String |
Sim |
appStore |
Segmenta o relatório por extensão de app. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada extensão. Essa coluna retorna o tipo de app store (Apple App Store, Google Play Store), se houver. | segmentar | App store |
Sim |
feedItemId |
Segmenta o relatório por itens de feed. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada item de feed. Essa coluna retorna o ID da linha do item do feed do DS para cada linha. | segmentar | ID |
Sim |
feedId |
Segmenta o relatório por itens de feed. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada item de feed. Essa coluna retorna o ID da tabela de feed do DS para cada linha. | segmentar | ID |
Sim |
feedType |
Segmenta o relatório por itens de feed. Cada linha e as métricas agregadas são divididas em várias linhas, uma para cada item de feed. Essa coluna retorna o tipo de item do feed para cada linha. | segmentar | Feed type |
Sim |