統計
エンティティのパフォーマンス データにアクセスするためのメソッドが含まれています。
キャンペーンやキーワードなどのエンティティのパフォーマンス データを取得するには、エンティティのgetStatsメソッドを呼び出します。 ただし、 を呼び出 getStats すことができるのは、エンティティの取得に使用した セレクター に、そのチェーン内のいずれかのメソッドが forDateRange 含まれている場合のみです。
次の キャンペーン セレクター では、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 | 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 | メインラインに広告が表示された回数の割合(検索結果の上に広告が表示される上位の配置)は、総インプレッション数を上回ります。 |