Statistiques

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

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

Le sélecteur de campagne suivant utilise la version qui utilise des plages de forDateRange 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 de taux d’impressions maximum absolu.
getAverageCpc double Obtient le coût moyen par clic.
getAverageCpm double Obtient le coût moyen pour mille 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 signalé par l’annonceur.
getTopImpressionRate double Obtient le pourcentage du taux d’impression le plus élevé.

getAbsoluteTopImpressionRate

Indique la fréquence d’apparition de votre annonce en première position de l’ensemble des résultats, sous forme de pourcentage du nombre total de vos impressions.

Retourne

Type Description
double Fréquence d’apparition de votre annonce en première position de l’ensemble des résultats, exprimée sous forme de pourcentage du nombre total de vos impressions.

getAverageCpc

Obtient le coût moyen par clic.

Retourne

Type Description
double Coût moyen par clic.

getAverageCpm

Obtient le coût moyen pour mille impressions.

Retourne

Type Description
double Coût moyen pour mille impressions.

getAveragePosition

Obtient la position moyenne à laquelle les annonces ont été placées.

Remarque

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

Retourne

Type Description
double La position moyenne à laquelle les annonces ont été placées.

getClickConversionRate

Obtient le taux de conversion des clics.

Remarque

Cette méthode pouvant être déconseillée dans une version ultérieure, utilisez plutôt la méthode getConversionRate .

Retourne

Type Description
double Taux de conversion des clics, de l’ordre de 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, de l’ordre de 0..1.

getConversions

Obtient le nombre de clics convertis.

Retourne

Type Description
long Nombre de clics convertis.

getConvertedClicks

Obtient le nombre de clics convertis.

Remarque

Cette méthode pouvant être déconseillée dans une version ultérieure, utilisez plutôt la méthode getConversions .

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, de l’ordre de 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 Retour sur dépense publicitaire, calculé comme suit : (revenu / dépenses) * 100.

getRevenue

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

Retourne

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

getTopImpressionRate

Obtient le pourcentage de fois où votre annonce s’est affichée en lien Premium, l’emplacement principal où les annonces apparaissent au-dessus des résultats de recherche, sur le nombre total de vos impressions.

Retourne

Type Description
double Pourcentage de fois que votre annonce s’est affichée en ligne principale, l’emplacement le plus haut où les annonces apparaissent au-dessus des résultats de recherche, par rapport au nombre total de vos impressions.
  • Last updated on