Tipo de relatório: campanha

Métricas de performance e atributos de configuração para campanhas.

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": "campaign". 

{
...
  "reportType": "campaign",
  "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 Um alias para o atributo campaignStatus. atributo Status Sim
engineStatus Status adicional da campanha na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem disapproved, budget constrained etc. atributo String Sim
creationTimestamp Carimbo de data/hora da criação da campanha, formatado em ISO 8601. atributo Timestamp Sim
lastModifiedTimestamp Carimbo de data/hora da modificação mais recente da campanha no formato 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 É o status da campanha: Active, Paused ou Removed. Tanto campanhas, grupos de anúncios, palavras-chave, anúncios e segmentações têm seus próprios status. Consulte o status. atributo Status Sim
campaignEngineId ID da campanha na conta de mecanismo externo. atributo ID Sim
campaignStartDate Data de início da campanha. atributo Date Sim
campaignEndDate Data de término da campanha. atributo Date Sim
bingAdsBudgetType Como o orçamento é controlado para campanhas do Bing Ads: Daily budget, Monthly even spend, Monthly accelerated spend, Daily accelerated spend ou Daily even spend. atributo Microsoft Advertising budget type Sim
dailyBudget Orçamento diário da campanha. atributo Money Sim
monthlyBudget Orçamento mensal da campanha. atributo Money Sim
deliveryMethod Método de exibição de orçamento da campanha: Standard ou Accelerated. atributo Budget delivery method Sim
adWordsBidStrategy A estratégia de lances do Google Ads para esta campanha: Manual cpc, Manual cpm, Percent cpa, Budget optimizer ou Conversion optimizer. As campanhas que usam estratégias de lances do DS são definidas como Manual cpc ou Manual cpm. atributo AdWords bid strategy Sim
yahooJapanBidStrategy A estratégia de lances do Yahoo! Japan usa para esta campanha: Manual cpc ou Budget optimizer. As campanhas que usam estratégias de lances do DS estão definidas como Manual cpc. atributo Yahoo! JAPAN bid strategy Sim
keywordNearMatchEnabled Indica se a palavra-chave com correspondência próxima está ativada para a campanha: Enabled ou Disabled. atributo Keyword match setting Sim
campaignMobileBidAdjustment A porcentagem de ajuste dos lances para dispositivos móveis. Por exemplo, 0,2 significa um aumento de 20%, portanto, os lances para dispositivos móveis são 1,2 vez o lance padrão. O intervalo de valores válidos varia de acordo com o mecanismo externo. atributo Number Sim
campaignTabletBidAdjustment A porcentagem pela qual os lances são ajustados para tablet. Por exemplo, 0,2 significa um aumento de 20%, de modo que os lances para tablets são 1,2 vez o lance padrão. O intervalo de valores válidos varia de acordo com o mecanismo externo. atributo Number Sim
campaignDesktopBidAdjustment A porcentagem de ajuste dos lances para computadores. Por exemplo, 0,2 significa um aumento de 20%, de modo que os lances para computador são 1,2 vez o lance padrão. O intervalo de valores válidos varia de acordo com o mecanismo externo. atributo Number Sim
networkTarget O tipo de rede em que a campanha anuncia. atributo String Não
yahooGeoTargets Segmentações por área geográfica para campanhas de marketing de busca do Yahoo. Consulte Fazer o download de modelos de upload e códigos de local e idioma. atributo String Não
campaignLabels Os nomes dos rótulos atribuídos diretamente a essa campanha. Rótulos herdados não estão incluídos. atributo String list Sim
campaignType Indica o tipo de campanha: Manual, Inventory, Inventory - PLA, Shopping, Comparison shopping, Mobile app install, Universal app ou Smart shopping. atributo Campaign type Sim
effectiveBidStrategyId ID do DS da estratégia de lances atribuída a esta entidade ou herdada por ela. atributo ID Sim
effectiveBidStrategy É o nome da estratégia de lances atribuída a essa entidade ou herdada por ela. atributo String Sim
bidStrategyInherited Indica se a estratégia de lances dessa entidade é herdada. atributo Boolean Sim
deviceTargets Segmentação por dispositivo no nível da campanha, uma combinação de Desktop, Mobile, Tablet ou Other. atributo String Não
effectiveDeviceTargets Segmentação por dispositivo no nível da campanha, uma combinação de Desktop, Mobile, Tablet ou Other. atributo String Não
languageTargets Segmentações por idioma no nível da campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
countryTargets Segmentações por país incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
provinceTargets Segmentações por província incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
metroTargets Segmentações de área metropolitana incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
cityTargets Segmentações por cidade incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
effectiveCountryTargets Segmentações por país incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
effectiveProvinceTargets Segmentações por província incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
effectiveMetroTargets Segmentações de área metropolitana incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
effectiveCityTargets Segmentações por cidade incluídas na campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
excludedCountryTargets Segmentações por país excluídas da campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
excludedProvinceTargets As segmentações por província foram excluídas da campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
excludedMetroTargets As segmentações por área metropolitana foram excluídas da campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
excludedCityTargets As segmentações por cidade foram excluídas da campanha. Faça o download de modelos de upload e códigos de local/idioma. atributo String Não
effectiveLabels Nomes de todos os rótulos herdados ou atribuídos diretamente a essa campanha. atributo String list Sim
clicksWithFeedItemShowing Clica em qualquer link no anúncio enquanto o item do feed era exibido. Esta coluna só retorna um valor em um relatório de item do feed ou em um relatório segmentado por uma coluna de item do feed. métrica Integer Sim
costWithFeedItemShowing Custo de todos os anúncios quando o item do feed foi exibido. Esta coluna só retorna um valor em um relatório de item do feed ou em um relatório segmentado por uma coluna de item do feed. métrica Money 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
sitelinkDisplayText Segmenta o relatório por sitelinks. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna o texto de exibição de sitelink de cada linha. segmentar String Sim
sitelinkDescription1 Segmenta o relatório por sitelinks. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna a descrição 1 de sitelink de cada linha. segmentar String Sim
sitelinkDescription2 Segmenta o relatório por sitelinks. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna a descrição 2 de cada linha do sitelink. segmentar String Sim
sitelinkLandingPageUrl Segmenta o relatório por sitelinks. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna o URL da página de destino do sitelink de cada linha. segmentar String Sim
sitelinkClickserverUrl Segmenta o relatório por sitelinks. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada sitelink. Essa coluna retorna o URL do servidor de cliques do sitelink de cada linha. segmentar String Sim
locationBusinessName Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da empresa. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna o nome da empresa do local em cada linha. segmentar String Sim
locationCategory Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da empresa. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna a categoria do local para cada linha. segmentar String Sim
locationDetails Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da empresa. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna os detalhes de um local para cada linha. segmentar String Sim
locationFilter Segmenta o relatório por extensões de local atualizadas vinculadas a uma conta do Perfil da empresa. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada local com métricas disponíveis. Essa coluna retorna o filtro do local para cada linha. segmentar String Não
callPhoneNumber Segmenta o relatório por extensão de chamada. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o número de telefone de uma extensão de chamada. segmentar String Sim
callCountryCode Segmenta o relatório por extensão de chamada. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o código de país da extensão de chamada de cada linha. segmentar String Sim
callIsTracked Segmenta o relatório por extensão de chamada. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retornará "true" se as chamadas da extensão de chamada forem rastreadas. Caso contrário, o valor será "false". segmentar Boolean Sim
callCallOnly Segmenta o relatório por extensão de chamada. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retornará "true" se a extensão de chamada mostrar apenas um número de telefone ou "false" se a extensão mostrar um número de telefone e um link. segmentar Boolean Sim
callConversionTracker Segmenta o relatório por extensões de chamada. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o nome do rastreador de conversões associado ao item do feed, se houver. segmentar String Sim
callConversionTrackerId Segmenta o relatório por extensões de chamada. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de chamada. Essa coluna retorna o ID do rastreador de conversões associado à extensão de chamada, se houver. segmentar ID Sim
appId Segmenta o relatório por extensão de aplicativo. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de aplicativo. Essa coluna retorna o ID do app, se houver. segmentar String Sim
appStore Segmenta o relatório por extensão de aplicativo. Cada linha e suas métricas agregadas são divididas em várias linhas, uma para cada extensão de aplicativo. Essa coluna retorna o tipo de app store (Apple App Store, Google Play Store), se houver. segmentar App store Sim
feedItemId Segmenta o relatório por itens de feed. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada item do feed. Essa coluna retorna o código da linha do item do feed do DS de cada linha. segmentar ID Sim
feedId Segmenta o relatório por itens de feed. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada item do feed. Essa coluna retorna o ID da tabela de feed do DS para cada linha. segmentar ID Sim
feedType Segmenta o relatório por itens de feed. Cada linha e as métricas agregadas dela são divididas em várias linhas, uma para cada item do feed. Essa coluna retorna o tipo de item do feed de cada linha. segmentar Feed type Sim