Métricas de performance e atributos de configuração dos 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": "ad".
{
...
"reportType": "ad",
"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 anúncio: Active, Paused ou Removed. As campanhas, os grupos de anúncios, as palavras-chave e os anúncios têm status próprios. Consulte o status. |
atributo | Status |
Sim |
engineStatus |
Status adicional do anúncio na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem active, eligible, creative deleted, creative approved family safe etc. |
atributo | String |
Sim |
creationTimestamp |
Carimbo de data/hora da criação do anúncio, formatado em ISO 8601. | atributo | Timestamp |
Sim |
lastModifiedTimestamp |
Carimbo de data/hora da modificação mais recente do anúncio, 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 |
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 que contém esse item. | atributo | Status |
Sim |
ad |
Nome do anúncio. | atributo | String |
Sim |
adId |
ID do anúncio do DS. Um valor de 0 indica que o anúncio não foi atribuído. | atributo | ID |
Sim |
adEngineId |
É o ID do anúncio na conta de mecanismo externo. | atributo | ID |
Sim |
isUnattributedAd |
Indica se as métricas nessa linha não podem ser atribuídas a um anúncio específico. Por exemplo, um anúncio com um formato não compatível ou um URL de servidor de cliques incorreto pode impedir que o DS atribua métricas a um anúncio. | atributo | Boolean |
Sim |
adHeadline |
Título do anúncio. | atributo | String |
Sim |
adHeadline2 |
Título do anúncio 2: não disponível para alguns mecanismos. | atributo | String |
Sim |
adHeadline3 |
Título do anúncio 3: não disponível para alguns mecanismos. | atributo | String |
Sim |
adDescription1 |
Linha de descrição 1 do anúncio. | atributo | String |
Sim |
adDescription2 |
Linha de descrição 2 do anúncio: não disponível para alguns mecanismos. | atributo | String |
Sim |
adDisplayUrl |
URL de visualização do anúncio. | atributo | String |
Sim |
adLandingPage |
Página de destino do anúncio. Consulte URLs da página de destino e do servidor de cliques. | atributo | String |
Sim |
adType |
O tipo de anúncio: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text ou Expanded dynamic search. |
atributo | Ad type |
Sim |
adPromotionLine |
Linha de promoção de anúncios. Uma mensagem promocional curta para um anúncio de produto. | atributo | String |
Sim |
adLabels |
Nomes dos rótulos atribuídos diretamente a este anúncio. Os rótulos herdados não são incluídos. | atributo | String list |
Sim |
adPathField1 |
Campo de caminho do anúncio 1. Os campos do caminho 1 e 2 são combinados com adDisplayUrl para formar o URL exibido em um anúncio. | atributo | String |
Sim |
adPathField2 |
Campo de caminho do anúncio 2. Os campos do caminho 1 e 2 são combinados com adDisplayUrl para formar o URL exibido em um anúncio. | atributo | String |
Sim |
effectiveLabels |
Nomes de todos os rótulos herdados ou atribuídos diretamente a este anúncio. | atributo | String list |
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 |
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 |