Estatísticas

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

Para obter dados de desempenho de uma entidade, como uma campanha ou palavra-chave, chame o método da getStats entidade. No entanto, só pode chamar getStats se o seletor que utilizou para obter a entidade incluir um dos forDateRange métodos na respetiva cadeia.

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

Utilização de exemplo:

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

Métodos

Nome do Método	Tipo de Devolução	Descrição
getAbsoluteTopImpressionRate	duplo	Obtém a percentagem de 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 milhar de impressões.
getAveragePosition	duplo	Este método já não está disponível a partir de 31 de março de 2021.
getClickConversionRate	duplo	(Em vez disso , utilize o método getConversionRate().
getClicks	long	Obtém o número de cliques.
getConversionRate	duplo	Obtém a taxa de conversão para cliques.
getConversions	long	Obtém o número de cliques convertidos.
getConvertedClicks	long	(Em alternativa , utilize o método getConversions().
getCost	duplo	Obtém o custo (gastos) na moeda da conta.
getCtr	duplo	Obtém o clique através da taxa.
getImpressions	long	Obtém o número de impressões.
getReturnOnAdSpend	long	Obtém a devolução dos gastos com anúncios.
getRevenue	long	Obtém a receita reportada pelo anunciante.
getTopImpressionRate	duplo	Obtém a percentagem de taxa de impressão superior.

getAbsoluteTopImpressionRate

Obtém a frequência com que o seu anúncio estava 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 estava 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 milhar de 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 a partir de 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 para cliques.

Nota

Uma vez que este método pode ser preterido numa versão futura, utilize o método getConversionRate .

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
long	O número de cliques.

getConversionRate

Obtém a taxa de conversão para 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
long	O número de cliques que foram convertidos.

getConvertedClicks

Obtém o número de cliques convertidos.

Nota

Uma vez que este método pode ser preterido numa versão futura, utilize o método getConversions .

Devoluções

Tipo	Descrição
long	O número de cliques convertidos.

getCost

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

Devoluções

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

getCtr

Obtém a taxa de clique-through.

Devoluções

Tipo	Descrição
duplo	A taxa click-through, no intervalo 0..1.

getImpressions

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

Devoluções

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

getReturnOnAdSpend

Obtém a devolução dos gastos com anúncios.

Devoluções

Tipo	Descrição
duplo	A rentabilidade dos gastos com anúncios, que é calculada como (receita/gasto) * 100.

getRevenue

Obtém a receita reportada pelo anunciante.

Devoluções

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

getTopImpressionRate

Obtém a percentagem de vezes que o seu anúncio foi apresentado na linha principal, a colocação superior onde os anúncios aparecem acima dos resultados da pesquisa, do total de impressões.

Devoluções

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