Dados de relatórios para anunciantes, incluindo:
- Métricas de performance em todas as contas de mecanismo e campanhas de um anunciante.
- Atributos de configuração de um anunciante.
Trecho da solicitação
Envie uma
Reports.request() ou
Reports.generate()
corpo da solicitação, 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.
columnName | Descrição | Comportamento | Tipo | Filtrá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 esse 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 este anunciante do 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 IANA, como America/New_York . |
atributo | String |
Sim |
dfaActions |
O número total de ações do Campaign Manager. | métrica | Integer |
Sim |
dfaRevenue |
A 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 |
A 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 das 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 |
Agregar cliques. | 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 contabilizar essas conversões na coluna "Relatório de conversões". | 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 do 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ê tinha qualificação para receber. Retornado como um número entre 0,1 e 1 ou, se o compartilhamento 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 o compartilhamento 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 a uma classificação do anúncio ruim. Retornado como um número entre 0 e 0,9 ou, se o compartilhamento for maior que 0,9, como uma string > 90% . |
métrica | Impression share |
Sim |
displayImpressionShare |
Somente Google Ads. O número de impressões recebidas na Rede de Display dividido pelo número estimado de impressões que você tinha qualificação para receber. Retornado como um número entre 0,1 e 1 ou, se o compartilhamento 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 o compartilhamento 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 a uma classificação do anúncio ruim. Retornado como um número entre 0 e 0,9 ou, se o compartilhamento 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 (QS, na sigla em inglês) 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 sejam exibidos regularmente nas primeiras posições acima dos resultados da pesquisa. | métrica | Money |
Sim |
absoluteTopImpressionPercentage |
Porcentagem das suas impressões de anúncios que são 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 das suas impressões de anúncios exibidas em qualquer lugar acima dos resultados da pesquisa orgânica. | métrica | Impression share |
Sim |
searchTopImpressionShare |
As impressões recebidas na parte superior (qualquer lugar acima dos resultados da pesquisa orgânica) em comparação com o número estimado de impressões que você estava qualificado 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 a aparecer acima dos resultados da pesquisa orgânica devido a um orçamento baixo. | métrica | Impression share |
Sim |
searchBudgetLostTopImpressionShare |
Esse valor ajuda a entender a frequência com que seu anúncio não apareceu acima dos resultados da 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 foi o primeiro a aparecer 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 em nenhum lugar 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 suas 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 suas 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 suas 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 suas 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 suas 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 suas 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 suas 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 suas 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 suas 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 suas métricas agregadas são divididas em várias linhas, até uma para cada segmento de dispositivo. Essa coluna retorna o segmento de dispositivo de cada linha. | segmentar | Device segment |
Sim |
floodlightGroup |
Segmenta o relatório por grupos do Floodlight. cada linha e suas 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 suas métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Esta coluna retorna o código do grupo do Floodlight no DS 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 suas métricas agregadas são divididas em várias linhas, até uma para cada grupo do Floodlight. Esta coluna retorna a tag de 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 suas 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 suas métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Esta coluna retorna o código de atividade do Floodlight do DS 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 suas métricas agregadas são divididas em várias linhas, até uma para cada atividade do Floodlight. Esta coluna retorna a tag de atividade do Floodlight de cada linha. Algumas métricas não têm valores segmentados do Floodlight, como cliques e visitas. | segmentar | String |
Sim |