Estadísticas
Contiene los métodos para acceder a los datos de rendimiento de una entidad.
Para obtener datos de rendimiento de una entidad, como una campaña o una palabra clave, llame al método de getStats la entidad. Pero solo puede llamar si getStats el selector que usó para obtener la entidad incluye uno de los forDateRange métodos de su cadena.
El siguiente selector de campaña usa la versión de forDateRange que usa intervalos de fechas predefinidos, como LAST_WEEK o LAST_MONTH. La otra versión le permite especificar el intervalo de datos mediante fechas específicas.
Ejemplo de uso:
var campaign = AdsApp.campaigns()
.forDateRange("LAST_WEEK")
.get()
.next();
var stats = campaign.getStats();
var conversionRate = stats.getConversionRate();
var convertedClicks = stats.getConversions();
// etc.
Métodos
| Nombre del método | Tipo de valor devuelto | Descripción |
|---|---|---|
| getAbsoluteTopImpressionRate | double | Obtiene el porcentaje de tasa de impresiones superior absoluta. |
| getAverageCpc | double | Obtiene el costo medio por clic. |
| getAverageCpm | double | Obtiene el costo medio por cada mil impresiones. |
| getAveragePosition | double | Este método ya no está disponible a partir del 31 de marzo de 2021. |
| getClickConversionRate | double | (Use el método getConversionRate() en su lugar). |
| getClicks | largo | Obtiene el número de clics. |
| getConversionRate | double | Obtiene la tasa de conversión de clics. |
| getConversions | largo | Obtiene el número de clics convertidos. |
| getConvertedClicks | largo | (Use el método getConversions() en su lugar). |
| getCost | double | Obtiene el costo (gasto) en la moneda de la cuenta. |
| getCtr | double | Obtiene la velocidad de clic. |
| getImpressions | largo | Obtiene el número de impresiones. |
| getReturnOnAdSpend | largo | Obtiene el retorno del gasto en anuncios. |
| getRevenue | largo | Obtiene los ingresos notificados por el anunciante. |
| getTopImpressionRate | double | Obtiene el porcentaje de tasa de impresiones superior. |
getAbsoluteTopImpressionRate
Obtiene la frecuencia con la que el anuncio estaba en la primera posición de todos los resultados, como porcentaje del total de impresiones.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Con qué frecuencia el anuncio estaba en la primera posición de todos los resultados, como porcentaje de las impresiones totales. |
getAverageCpc
Obtiene el costo medio por clic.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Costo medio por clic. |
getAverageCpm
Obtiene el costo medio por cada mil impresiones.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Costo medio por cada mil impresiones. |
getAveragePosition
Obtiene la posición media en la que se colocaron los anuncios.
Nota:
Este método ya no está disponible a partir del 31 de marzo de 2021.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | La posición media en la que se colocaron los anuncios. |
getClickConversionRate
Obtiene la tasa de conversión de clics.
Nota:
Dado que este método puede estar en desuso en una versión futura, use el método getConversionRate en su lugar.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Tasa de conversión de clics, en el intervalo 0..1. |
getClicks
Obtiene el número de clics.
Valores devueltos
| Tipo | Descripción |
|---|---|
| largo | Número de clics. |
getConversionRate
Obtiene la tasa de conversión de clics.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Tasa de conversión de clics, en el intervalo 0..1. |
getConversions
Obtiene el número de clics que se han convertido.
Valores devueltos
| Tipo | Descripción |
|---|---|
| largo | Número de clics que se han convertido. |
getConvertedClicks
Obtiene el número de clics convertidos.
Nota:
Dado que este método puede estar en desuso en una versión futura, use el método getConversions en su lugar.
Valores devueltos
| Tipo | Descripción |
|---|---|
| largo | Número de clics que se han convertido. |
getCost
Obtiene el costo (gasto) en la moneda de la cuenta.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Costo en la moneda de la cuenta. |
getCtr
Obtiene la tasa de clics.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | La velocidad de click-through, en el intervalo 0...1. |
getImpressions
Obtiene el número de impresiones.
Valores devueltos
| Tipo | Descripción |
|---|---|
| largo | Número de impresiones. |
getReturnOnAdSpend
Obtiene el retorno del gasto en anuncios.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | La rentabilidad del gasto en anuncios, que se calcula como (ingresos/gastos) * 100. |
getRevenue
Obtiene los ingresos notificados por el anunciante.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | Los ingresos notificados por el anunciante. |
getTopImpressionRate
Obtiene el porcentaje de veces que el anuncio se mostró en la línea principal, la ubicación superior donde aparecen anuncios por encima de los resultados de búsqueda, de las impresiones totales.
Valores devueltos
| Tipo | Descripción |
|---|---|
| double | El porcentaje de veces que el anuncio se mostró en la línea principal, la ubicación superior donde aparecen anuncios por encima de los resultados de la búsqueda, de las impresiones totales. |