Dados de relatório para contas de mecanismo, incluindo:
- Métricas de desempenho em todas as campanhas de uma conta de mecanismo.
- Atributos de configuração para uma conta de mecanismo.
Trecho da solicitação
Envie uma
Reports.request() ou
Reports.generate()
corpo da solicitação, mas especifique "reportType": "account".
{
...
"reportType": "account",
"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 da conta: Active, Paused ou Removed. |
atributo | Status |
Sim |
creationTimestamp |
Carimbo de data/hora da criação da conta, formatado em ISO 8601. | atributo | Timestamp |
Sim |
lastModifiedTimestamp |
Carimbo de data/hora da modificação mais recente da conta, 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 de mecanismo: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu ou Comparison Shopping. |
atributo | Engine type |
Sim |
accountCurrencyCode |
Código da moeda da conta de mecanismo no formato ISO 4217. | atributo | String |
Sim |
accountTimeZone |
Fuso horário da conta de mecanismo no 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 |