Tipo de relatório: anúncio

Métricas de desempenho e atributos de configuração para anúncios.

Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, pelo método Reports.request()).

Trecho de solicitação

Envie um corpo de solicitação Reports.request(), 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.

columnNameDescriçãoComportamentoTipoFiltrável
status É o status do anúncio: Active, Paused ou Removed. Tanto campanhas, grupos de anúncios, palavras-chave quanto anúncios têm o próprio status. 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 É o carimbo de data/hora da criação do anúncio, formatado em ISO 8601. atributo Timestamp Sim
lastModifiedTimestamp É o 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 externa. 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
campaign Nome da campanha. atributo String Sim
campaignId ID da campanha do DS. atributo ID Sim
campaignStatus Status da campanha que contém este 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 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 está atribuído. atributo ID Sim
adEngineId ID do anúncio na conta de mecanismo externo. atributo ID Sim
isUnattributedAd Indica se as métricas nessa linha não são atribuíveis a um anúncio específico. Por exemplo, um anúncio com um formato incompatível ou um URL do 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 do anúncio. Uma mensagem promocional curta para um anúncio de produto. atributo String Sim
adLabels São os nomes dos rótulos atribuídos diretamente a esse 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 1 e 2 de caminho 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 1 e 2 de caminho são combinados com adDisplayUrl para formar o URL exibido em um anúncio. atributo String Sim
effectiveLabels São os 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 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
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