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