Dados de relatório para anunciantes, incluindo:
- Métricas de desempenho em todas as contas de mecanismo e campanhas de um anunciante.
- São os atributos de configuração de um anunciante.
Trecho de solicitação
Envie um corpo de solicitação
Reports.request() ou
Reports.generate(), 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 |
É o carimbo de data/hora da criação do anunciante, formatado em ISO 8601. | atributo | Timestamp |
Sim |
lastModifiedTimestamp |
É o 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 |
É o 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 associado a este anunciante do DS no formato do banco de dados de fuso horário IANA, como America/New_York . |
atributo | String |
Sim |
advertiserCurrencyCode |
É o código da moeda do anunciante no formato ISO 4217. | atributo | String |
Sim |
googleAnalyticsTimeZone |
O fuso horário da vista do Google Analytics vinculada a este anunciante do DS. Usa o formato de banco de dados de fuso horário 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 por 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 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 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 |
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 contabilizar essas conversões na coluna "Relatórios 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 que você recebeu na rede de pesquisa dividido pelo número estimado de impressões que você estava qualificado 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 ao orçamento insuficiente. Retornado como um número entre 0 e 0,9 ou, se a parcela 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. Retornado como um número entre 0 e 0,9 ou, se a parcela for maior que 0,9, como uma string > 90% . |
métrica | Impression share |
Sim |
displayImpressionShare |
Somente Google Ads O número de impressões que você recebeu na Rede de Display dividido pelo número estimado de impressões que você estava qualificado 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 não foram exibidos na Rede de Display devido ao orçamento insuficiente. Retornado como um número entre 0 e 0,9 ou, se a parcela 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 parcela 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 do número de impressões do Índice de qualidade (QS) do mecanismo em todos os dias e todas as 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 exibidas como o primeiro anúncio acima dos resultados da pesquisa orgânica. | métrica | Impression share |
Sim |
searchAbsoluteTopImpressionShare |
As impressões que você recebeu 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ê estava qualificado 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 |
Impressões que você recebeu na parte superior (em 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 na primeira 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 |
Esse valor ajudará você a entender com que frequência seu anúncio não foi exibido 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 acima dos resultados da pesquisa orgânica devido à baixa classificação. | 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 à baixa classificação. | 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 mês. 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 mês. 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 trimestre. 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 trimestre. 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 (de domingo a sábado), e cada linha e as métricas agregadas dela 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 (de domingo a sábado), e cada linha e as métricas agregadas dela 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 as respectivas 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 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. Essa coluna retorna o código do grupo do 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. 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 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 ID da 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. Essa 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 |