Tipo de relatório: anunciante

Geração de relatórios para anunciantes, incluindo:

  • Métricas de desempenho em todas as contas de mecanismo e campanhas de um anunciante.
  • Atributos de configuração de um anunciante.

Solicitar trecho

Envie um corpo de solicitação Reports.request() ou Reports.generate() regular, mas especifique "reportType": "advertiser".

{
...
 
"reportType": "advertiser",
 
"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.

columnNameDescriçãoComportamentoTipoFiltrável
status O status do anunciante: Active, Paused ou Removed. atributo Status Sim
creationTimestamp Carimbo de data/hora da criação do anunciante, formatado em ISO 8601. atributo Timestamp Sim
lastModifiedTimestamp Carimbo de data/hora da modificação mais recente do anunciante, 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
dfaAdvertiserId ID do anunciante do Campaign Manager associado a este anunciante do DS. atributo ID Sim
dfaNetworkId ID da rede do Campaign Manager associada a este anunciante do DS. atributo ID Sim
dfaNetworkTimeZone Fuso horário da rede do Campaign Manager associada a esse anunciante de DS no formato do banco de dados de fuso horário IANA, como America/New_York. atributo String Sim
advertiserCurrencyCode Código de moeda do anunciante no formato ISO 4217. atributo String Sim
googleAnalyticsTimeZone O fuso horário da vista do Google Analytics vinculada a esse anunciante do DS. Usa o formato do banco de dados de fuso horário da IANA, como America/New_York. atributo String 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 360 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
searchBudgetLostImpressionShare Somente Google Ads e Bing Ads. A porcentagem de tempo em que seus anúncios não foram exibidos na rede de pesquisa devido a um orçamento insuficiente. 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
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
displayBudgetLostImpressionShare Somente Google Ads. A porcentagem de tempo em que seus anúncios deixaram de ser exibidos na Rede de Display devido a um orçamento insuficiente. 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
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
searchBudgetLostAbsoluteTopImpressionShare Estima a frequência com que seu anúncio não foi o primeiro acima dos resultados da pesquisa orgânica devido a um orçamento baixo. métrica Impression share Sim
searchBudgetLostTopImpressionShare Ajuda a entender a frequência com que o anúncio não apareceu acima dos resultados de pesquisa orgânica devido a um orçamento baixo. 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