Estadísticas

Contiene los métodos para acceder a los datos de rendimiento de una entidad.

Para obtener los 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 getStats si el selector que usó para obtener la entidad incluye uno de los forDateRange métodos en su cadena.

El siguiente selector de campañas usa la versión que usa intervalos de forDateRange fechas predefinidos, como LAST_WEEK o LAST_MONTH. La otra versión le permite especificar el rango 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	Description
getAbsoluteTopImpressionRate	double	Obtiene el porcentaje de la tasa de impresiones máxima absoluta.
getAverageCpc	double	Obtiene el coste medio por clic.
getAverageCpm	double	Obtiene el coste 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 que se han convertido.
getConvertedClicks	largo	(Use el método getConversions() en su lugar).
getCost	double	Obtiene el coste (gasto) en la moneda de la cuenta.
getCtr	double	Obtiene la tasa click-through.
getImpressions	largo	Obtiene el número de impresiones.
getReturnOnAdSpend	largo	Obtiene el retorno de la inversión en publicidad.
getRevenue	largo	Obtiene los ingresos informados por el anunciante.
getTopImpressionRate	double	Obtiene el porcentaje de la tasa de impresiones más alto.

getAbsoluteTopImpressionRate

Obtiene la frecuencia en la que tu anuncio estaba en la primera posición de todos los resultados, como porcentaje del total de impresiones.

Valores devueltos

Tipo	Description
double	La frecuencia en la que tu anuncio estaba en la primera posición de todos los resultados, como porcentaje del total de impresiones.

getAverageCpc

Obtiene el coste medio por clic.

Valores devueltos

Tipo	Description
double	El coste medio por clic.

getAverageCpm

Obtiene el coste medio por cada mil impresiones.

Valores devueltos

Tipo	Description
double	El coste 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	Description
double	La posición media en la que se han colocado los anuncios.

getClickConversionRate

Obtiene la tasa de conversión de clics.

Nota:

Dado que este método puede quedar en desuso en una versión futura, use el método getConversionRate en su lugar.

Valores devueltos

Tipo	Description
double	La tasa de conversión de clics, en el intervalo 0..1.

getClicks

Obtiene el número de clics.

Valores devueltos

Tipo	Description
largo	El número de clics.

getConversionRate

Obtiene la tasa de conversión de clics.

Valores devueltos

Tipo	Description
double	La 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	Description
largo	El número de clics que se han convertido.

getConvertedClicks

Obtiene el número de clics que se han convertido.

Nota:

Dado que este método puede quedar en desuso en una versión futura, use el método getConversions en su lugar.

Valores devueltos

Tipo	Description
largo	El número de clics que se han convertido.

getCost

Obtiene el coste (gasto) en la moneda de la cuenta.

Valores devueltos

Tipo	Description
double	El costo en la moneda de la cuenta.

getCtr

Obtiene la tasa click-through.

Valores devueltos

Tipo	Description
double	La tasa click-through, en el rango 0..1.

getImpressions

Obtiene el número de impresiones.

Valores devueltos

Tipo	Description
largo	El número de impresiones.

getReturnOnAdSpend

Obtiene el retorno de la inversión en publicidad.

Valores devueltos

Tipo	Description
double	El rendimiento de la inversión en publicidad, que se calcula como (ingresos / gasto) * 100.

getRevenue

Obtiene los ingresos informados por el anunciante.

Valores devueltos

Tipo	Description
double	Los ingresos reportados por el anunciante.

getTopImpressionRate

Obtiene el porcentaje de veces que tu anuncio se ha mostrado en posiciones principales, que es el emplazamiento superior, donde los anuncios aparecen por encima de los resultados de la búsqueda, del total de impresiones.

Valores devueltos

Tipo	Description
double	El porcentaje de veces que tu anuncio se ha mostrado en posiciones principales, que es el emplazamiento superior donde los anuncios aparecen por encima de los resultados de la búsqueda, del total de impresiones.