Partager via


Stats

Contient les méthodes permettant d’accéder aux données de performances d’une entité.

Pour obtenir des données de performances pour une entité telle qu’une campagne ou une mot clé, appelez la méthode de getStats l’entité. Mais vous ne pouvez appeler getStats que si le sélecteur que vous avez utilisé pour obtenir l’entité inclut l’une forDateRange des méthodes dans sa chaîne.

Le sélecteur de campagne suivant utilise la version de forDateRange qui utilise des plages de dates prédéfinies telles que LAST_WEEK ou LAST_MONTH. L’autre version vous permet de spécifier la plage de données à l’aide de dates spécifiques.

Exemple d’utilisation :

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

Méthodes

Nom de la méthode Type renvoyé Description
getAbsoluteTopImpressionRate double Obtient le pourcentage absolu du taux d’impression supérieur.
getAverageCpc double Obtient le coût moyen par clic.
getAverageCpm double Obtient le coût moyen par millier d’impressions.
getAveragePosition double Cette méthode n’est plus disponible depuis le 31 mars 2021.
getClickConversionRate double (Utilisez la méthode getConversionRate() à la place.)
getClicks long Obtient le nombre de clics.
getConversionRate double Obtient le taux de conversion des clics.
getConversions long Obtient le nombre de clics convertis.
getConvertedClicks long (Utilisez la méthode getConversions() à la place.)
getCost double Obtient le coût (dépense) dans la devise du compte.
getCtr double Obtient le taux de clics.
getImpressions long Obtient le nombre d’impressions.
getReturnOnAdSpend long Obtient le retour sur les dépenses publicitaires.
getRevenue long Obtient le chiffre d’affaires déclaré par l’annonceur.
getTopImpressionRate double Obtient le pourcentage de taux d’impression supérieur.

getAbsoluteTopImpressionRate

Obtient la fréquence à laquelle votre annonce était en première position de tous les résultats, en pourcentage de vos impressions totales.

Retourne

Type Description
double La fréquence à laquelle votre annonce était en première position de tous les résultats, en pourcentage de vos impressions totales.

getAverageCpc

Obtient le coût moyen par clic.

Retourne

Type Description
double Coût moyen par clic.

getAverageCpm

Obtient le coût moyen par millier d’impressions.

Retourne

Type Description
double Coût moyen par millier d’impressions.

getAveragePosition

Obtient la position moyenne où les annonces ont été placées.

Remarque

Cette méthode n’est plus disponible depuis le 31 mars 2021.

Retourne

Type Description
double Position moyenne où les annonces ont été placées.

getClickConversionRate

Obtient le taux de conversion des clics.

Remarque

Étant donné que cette méthode peut être déconseillée dans une version ultérieure, utilisez la méthode getConversionRate à la place.

Retourne

Type Description
double Taux de conversion des clics, dans la plage 0..1.

getClicks

Obtient le nombre de clics.

Retourne

Type Description
long Nombre de clics.

getConversionRate

Obtient le taux de conversion des clics.

Retourne

Type Description
double Taux de conversion des clics, dans la plage 0..1.

getConversions

Obtient le nombre de clics qui ont été convertis.

Retourne

Type Description
long Nombre de clics convertis.

getConvertedClicks

Obtient le nombre de clics convertis.

Remarque

Étant donné que cette méthode peut être déconseillée dans une version ultérieure, utilisez la méthode getConversions à la place.

Retourne

Type Description
long Nombre de clics convertis.

getCost

Obtient le coût (dépense) dans la devise du compte.

Retourne

Type Description
double Coût dans la devise du compte.

getCtr

Obtient le taux de clics.

Retourne

Type Description
double Taux de clics, dans la plage 0..1.

getImpressions

Obtient le nombre d’impressions.

Retourne

Type Description
long Nombre d’impressions.

getReturnOnAdSpend

Obtient le retour sur les dépenses publicitaires.

Retourne

Type Description
double Le retour sur les dépenses publicitaires, qui est calculé en tant que (recettes/dépenses) * 100.

getRevenue

Obtient le chiffre d’affaires déclaré par l’annonceur.

Retourne

Type Description
double Chiffre d’affaires déclaré par l’annonceur.

getTopImpressionRate

Obtient le pourcentage de fois où votre annonce a été affichée dans la ligne principale, le positionnement le plus élevé où les annonces apparaissent au-dessus des résultats de recherche, par rapport à vos impressions totales.

Retourne

Type Description
double Pourcentage de fois où votre annonce s’est affichée dans la ligne principale, l’emplacement le plus élevé où les annonces apparaissent au-dessus des résultats de la recherche, par rapport à vos impressions totales.