エンティティのパフォーマンス データにアクセスするためのメソッドが含まれています。
キャンペーンやキーワード (keyword)などのエンティティのパフォーマンス データを取得するには、エンティティの getStats メソッドを呼び出します。 ただし、エンティティの取得に使用したセレクターのチェーンにforDateRangeメソッドのいずれかが含まれている場合にのみ、getStats を呼び出すことができます。
次の キャンペーン セレクター は、LAST_WEEK や LAST_MONTH などの定義済みの日付範囲を使用する forDateRange のバージョンを使用します。 もう 1 つのバージョンでは、特定の日付を使用してデータ範囲を指定できます。
使用例:
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 | 1,000 インプレッションあたりの平均コストを取得します。 |
| 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
1,000 インプレッションあたりの平均コストを取得します。
戻り値
| 型 | 説明 |
|---|---|
| double | インプレッション 1,000 回あたりの平均単価。 |
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 | インプレッションの総数のうち、広告がメインライン (検索結果より上の広告掲載領域) に表示された割合。 |