Tipo de relatório: palavra-chave

Métricas de desempenho e atributos de configuração para palavras-chave.

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

Trecho da solicitação

Envie uma Reports.request() corpo da solicitação, mas especifique "reportType": "keyword".

{
...
  "reportType": "keyword",
  "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 da palavra-chave: Active, Paused ou Removed. Cada campanha, grupo de anúncios, palavra-chave e anúncio tem seu próprio status. Consulte o status. atributo Status Sim
engineStatus Status adicional da palavra-chave na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused etc. atributo String Sim
creationTimestamp Carimbo de data/hora da criação da palavra-chave, formatado em ISO 8601. atributo Timestamp Sim
lastModifiedTimestamp Carimbo de data/hora da modificação mais recente da palavra-chave, 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
campaign Nome da campanha. atributo String Sim
campaignId ID da campanha do DS. atributo ID Sim
campaignStatus O status da campanha que contém esse 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
keywordId ID de palavra-chave do DS. Um valor de 0 indica que a palavra-chave não está atribuída. atributo ID Sim
keywordMatchType Tipo de correspondência de palavra-chave: Broad, Exact, Phrase ou Content. atributo Match type Sim
keywordText O texto da palavra-chave. atributo String Sim
keywordEngineId ID da palavra-chave na conta de mecanismo externo. atributo ID Sim
keywordMaxCpc Modifica o CPC máx. do grupo de anúncios e define o valor máximo que você quer pagar se alguém clicar em um anúncio para essa palavra-chave específica. Se esse campo estiver vazio, a palavra-chave usará o CPC máximo do grupo de anúncios. atributo Money Sim
effectiveKeywordMaxCpc O CPC (custo por clique máximo) máximo em vigor para a palavra-chave em questão. Esse valor será igual ao CPC máx. do grupo de anúncios ou, se a palavra-chave estiver substituindo a configuração do grupo de anúncios, o CPC máx. da própria palavra-chave. atributo Money Sim
keywordLandingPage O URL final que um usuário acessaria depois de clicar no seu anúncio. Consulte URLs da página de destino e do servidor de cliques. atributo String Sim
keywordClickserverUrl O URL que o DS usa para rastrear a atividade. Um usuário que clica em um anúncio visita primeiro o URL do servidor de cliques e depois é redirecionado para a página de destino final. Consulte URLs da página de destino e do servidor de cliques. atributo String Sim
isDisplayKeyword Indica se esta é uma palavra-chave de marcador de posição usada para relatórios de display e posição. atributo Boolean Sim
keywordMaxBid Se essa palavra-chave for gerenciada por uma estratégia de lances do DS, a estratégia nunca aumentará os lances acima desse limite. Consulte Aplicar uma estratégia de lances a palavras-chave. atributo Money Sim
keywordMinBid Se essa palavra-chave for gerenciada por uma estratégia de lances do DS, a estratégia nunca diminuirá os lances abaixo desse limite. Consulte Aplicar uma estratégia de lances a palavras-chave. atributo Money Sim
keywordUrlParams Parâmetros de URL extras adicionados à página de destino. Consulte Adicionar parâmetros de URL. atributo String Sim
bingKeywordParam2 Param2 de uma palavra-chave do Bing Ads. atributo String Sim
bingKeywordParam3 Param3 de uma palavra-chave do Bing Ads. atributo String Sim
keywordLabels Nomes de rótulos atribuídos diretamente a essa palavra-chave. e os rótulos herdados não são incluídos. atributo String list Sim
qualityScoreCurrent Somente Google Ads e Bing Ads. O valor mais recente do Índice de qualidade (QS, na sigla em inglês) do mecanismo para uma palavra-chave. Essa coluna sempre informa o QS mais recente de uma palavra-chave, independentemente do período do relatório. atributo Integer Sim
topOfPageBidCurrent Somente Google Ads. Aproxima o lance de CPC atual necessário para que seu anúncio seja exibido regularmente nas primeiras posições acima dos resultados de pesquisa. Essa coluna sempre informa o CPC necessário no momento, independentemente do período do relatório. atributo Money Sim
effectiveBidStrategyId ID do DS da estratégia de lances atribuída a essa 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 desta entidade é herdada. atributo Boolean Sim
effectiveLabels Nomes de todos os rótulos herdados ou atribuídos diretamente a esta palavra-chave. atributo String list 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
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
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
ad Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Esta coluna retorna o nome do anúncio em cada linha. segmentar String Sim
adId Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna o código do DS do anúncio em cada linha. segmentar ID Sim
isUnattributedAd Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna indica se as métricas na linha não podem ser atribuídas a um anúncio específico. segmentar Boolean Sim
adHeadline Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna o título do anúncio em cada linha. segmentar String Sim
adHeadline2 Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna o título 2 do anúncio em cada linha. Indisponível para alguns mecanismos. segmentar String Sim
adHeadline3 Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna o título 3 do anúncio em cada linha. Indisponível para alguns mecanismos. segmentar String Sim
adDescription1 Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna a linha de descrição 1 do anúncio em cada linha. segmentar String Sim
adDescription2 Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna a linha de descrição 2 do anúncio em cada linha. segmentar String Sim
adDisplayUrl Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna o URL de visualização do anúncio em cada linha. segmentar String Sim
adLandingPage Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna a página de destino do anúncio em cada linha. segmentar String Sim
adType Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Essa coluna retorna o tipo de anúncio em cada linha: Text ou Product. segmentar Ad type Sim
adPromotionLine Segmenta o relatório por anúncios. cada linha e suas métricas agregadas são divididas em várias linhas, até uma para cada anúncio. Esta coluna retorna a linha de promoção do anúncio do produto em cada linha. segmentar String Sim