統計資料

包含存取實體效能資料的方法。

若要取得實體的成效資料，例如 廣告活動 或 關鍵字，請呼叫實體的方法 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	您的廣告在主線顯示的時間百分比，即廣告顯示在搜尋結果上方的頂端位置，占總印象的百分比。