统计

包含用于访问实体性能数据的方法。

若要获取市场活动或关键字 (keyword) 等实体的性能数据，请调用实体的方法getStats。 但是，仅当用于获取实体的选择器在其链中包含其中一个forDateRange方法时，才能调用getStats。

以下 市场活动选择器 使用的版本 forDateRange 使用预定义的日期范围（如 LAST_WEEK 或 LAST_MONTH）。 另一个版本允许使用特定日期指定数据范围。

示例用法：

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

方法

方法名称	返回类型	说明
getAbsoluteTopImpressionRate	double	获取绝对最高展示率百分比。
getAverageCpc	double	获取平均每点击成本。
getAverageCpm	double	获取每千次展示的平均成本。
getAveragePosition	double	自 2021 年 3 月 31 日起，此方法不再可用。
getClickConversionRate	double	(请改用 getConversionRate () 方法。)
getClicks	long	获取点击次数。
getConversionRate	double	获取点击的转换率。
getConversions	long	获取转化的点击次数。
getConvertedClicks	long	(请改用 getConversions () 方法。)
getCost	double	获取以帐户货币 () 支出的成本。
getCtr	double	获取点击率。
getImpressions	long	获取展示次数。
getReturnOnAdSpend	long	获取广告支出回报率。
getRevenue	long	获取广告商报告的收入。
getTopImpressionRate	double	获取最高展示率百分比。

getAbsoluteTopImpressionRate

获取您的广告出现在所有结果第一位置的频率，占总展示次数的百分比。

返回

类型	说明
double	您的广告出现在所有结果第一位置的频率（占总展示次数的百分比）。

getAverageCpc

获取平均每点击成本。

返回

类型	说明
double	平均每点击成本。

getAverageCpm

获取每千次展示的平均成本。

返回

类型	说明
double	每千次展示的平均成本。

getAveragePosition

获取投放广告的平均位置。

注意

自 2021 年 3 月 31 日起，此方法不再可用。

返回

类型	说明
double	投放广告的平均位置。

getClickConversionRate

获取点击的转换率。

注意

由于此方法在将来的版本中可能被弃用，因此请改用 getConversionRate 方法。

返回

类型	说明
double	点击的转换率，在 0 到 1 范围内。

getClicks

获取点击次数。

返回

类型	说明
long	点击次数。

getConversionRate

获取点击的转换率。

返回

类型	说明
double	点击的转换率，在 0 到 1 范围内。

getConversions

获取转换的点击次数。

返回

类型	说明
long	转换的点击次数。

getConvertedClicks

获取转化的点击次数。

注意

由于此方法在将来的版本中可能被弃用，因此请改用 getConversions 方法。

返回

类型	说明
long	转化的点击次数。

getCost

获取以帐户货币 () 支出的成本。

返回

类型	说明
double	以帐户货币表示的成本。

getCtr

获取点进率。

返回

类型	说明
double	点进率在 0 到 1 范围内。

getImpressions

获取展示次数。

返回

类型	说明
long	展示次数。

getReturnOnAdSpend

获取广告支出回报率。

返回

类型	说明
double	广告支出回报率，计算公式为 (收入/支出) * 100。

getRevenue

获取广告商报告的收入。

返回

类型	说明
double	广告商报告的收入。

getTopImpressionRate

获取您的广告在主线广告中展示的次数占总展示次数的百分比。

返回

类型	说明
double	您的广告在主线广告中展示的次数占总展示次数的百分比，即广告出现在搜索结果上方的顶部展示位置。