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. |