Estatísticas

Contém os métodos para acessar os dados de desempenho de uma entidade.

Para obter dados de desempenho para uma entidade, como uma campanha ou palavra-chave, chame o método da getStats entidade. Mas você só pode chamar getStats se o seletor que você usou para obter a entidade inclui um dos forDateRange métodos em sua cadeia.

O seletor de campanha seguinte utiliza a versão que utiliza intervalos de forDateRange datas predefinidos, como LAST_WEEK ou LAST_MONTH. A outra versão permite-lhe especificar o intervalo de dados através de datas específicas.

Exemplo de utilização:

    var campaign = AdsApp.campaigns()
        .forDateRange("LAST_WEEK")
        .get()
        .next();
    var stats = campaign.getStats();
    var conversionRate = stats.getConversionRate();
    var convertedClicks = stats.getConversions();
    // etc.

Metodologia

Nome do método	Tipo de Devolução	Descrição
getAbsoluteTopImpressionRate	duplo	Obtém a percentagem da taxa de impressão máxima absoluta.
getAverageCpc	duplo	Obtém o custo médio por clique.
getAverageCpm	duplo	Obtém o custo médio por mil impressões.
getAveragePosition	duplo	Este método já não está disponível desde 31 de março de 2021.
getClickConversionRate	duplo	(Use o método getConversionRate() em vez disso.)
getClicks	longo	Obtém o número de cliques.
getConversionRate	duplo	Obtém a taxa de conversão de cliques.
getConversions	longo	Obtém o número de cliques que foi convertido.
getConvertedClicks	longo	(Use o método getConversions() em vez disso.)
getCost	duplo	Obtém o custo (gasto) na moeda da conta.
getCtr	duplo	Obtém a taxa de cliques.
getImpressions	longo	Obtém o número de impressões.
getReturnOnAdSpend	longo	Obtém o retorno dos gastos com anúncios.
getRevenue	longo	Obtém a receita relatada pelo anunciante.
getTopImpressionRate	duplo	Obtém a percentagem da taxa de impressão máxima.

getAbsoluteTopImpressionRate

Obtém a frequência com que o seu anúncio esteve na primeira posição de todos os resultados, como uma percentagem do total de impressões.

Devoluções

Tipo	Descrição
duplo	Com que frequência o seu anúncio esteve na primeira posição de todos os resultados, como uma percentagem do total de impressões.

getAverageCpc

Obtém o custo médio por clique.

Devoluções

Tipo	Descrição
duplo	O custo médio por clique.

getAverageCpm

Obtém o custo médio por mil impressões.

Devoluções

Tipo	Descrição
duplo	O custo médio por mil impressões.

getAveragePosition

Obtém a posição média onde os anúncios foram colocados.

Nota

Este método já não está disponível desde 31 de março de 2021.

Devoluções

Tipo	Descrição
duplo	A posição média onde os anúncios foram colocados.

getClickConversionRate

Obtém a taxa de conversão de cliques.

Nota

Como esse método pode ser preterido em uma versão futura, use o método getConversionRate em vez disso.

Devoluções

Tipo	Descrição
duplo	A taxa de conversão para cliques, no intervalo 0..1.

getClicks

Obtém o número de cliques.

Devoluções

Tipo	Descrição
longo	É o número de cliques.

getConversionRate

Obtém a taxa de conversão de cliques.

Devoluções

Tipo	Descrição
duplo	A taxa de conversão para cliques, no intervalo 0..1.

getConversions

Obtém o número de cliques que foram convertidos.

Devoluções

Tipo	Descrição
longo	O número de cliques que foram convertidos.

getConvertedClicks

Obtém o número de cliques que foi convertido.

Nota

Como esse método pode ser preterido em uma versão futura, use o método getConversions em vez disso.

Devoluções

Tipo	Descrição
longo	O número de cliques que foram convertidos.

getCost

Obtém o custo (gasto) na moeda da conta.

Devoluções

Tipo	Descrição
duplo	O custo na moeda da conta.

getCtr

Obtém a taxa de cliques.

Devoluções

Tipo	Descrição
duplo	A taxa de cliques, no intervalo 0..1.

getImpressions

Obtém o número de impressões.

Devoluções

Tipo	Descrição
longo	O número de impressões.

getReturnOnAdSpend

Obtém o retorno dos gastos com anúncios.

Devoluções

Tipo	Descrição
duplo	O retorno sobre os gastos com anúncios, que é calculado como (receita / gasto) * 100.

getRevenue

Obtém a receita relatada pelo anunciante.

Devoluções

Tipo	Descrição
duplo	A receita relatada pelo anunciante.

getTopImpressionRate

Obtém a porcentagem de vezes que seu anúncio foi exibido na linha principal, o posicionamento superior onde os anúncios são exibidos acima dos resultados da pesquisa, do total de impressões.

Devoluções

Tipo	Descrição
duplo	A percentagem de vezes que o anúncio foi apresentado na linha principal, o posicionamento principal onde os anúncios são apresentados acima dos resultados de pesquisa, do total de impressões.