统计

项目
11/13/2024

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

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

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

用法示例：

    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	广告在主线（广告显示在搜索结果上方的顶部位置）中占总展示次数的百分比。

通过

统计

方法