統計

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

若要取得活動或關鍵字等實體的效能資料，請呼叫實體的 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	廣告在主線中顯示的次數百分比，廣告出現在搜尋結果上方的最上層位置，超出您總曝光數。