Method: accounts.campaignReport.generate

指定された仕様に基づいてキャンペーン レポートを生成します。

HTTP リクエスト

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

レポートを生成するアカウントのリソース名。例: accounts/pub-9876543210987654

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
フィールド
reportSpec

object (CampaignReportSpec)

キャンペーン レポートの仕様。

レスポンスの本文

Campaign Report API レスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
フィールド
rows[]

object (ReportRow)

指定したパブリッシャーのキャンペーン レポートデータ。最大で 100,000 行が API から返されます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

詳しくは、OAuth 2.0 の概要をご覧ください。

CampaignReportSpec

キャンペーン レポートを生成するための仕様。たとえば、インプレッションとクリック数を CAMPAIGN_ID でスライスするための指定は次のようになります。

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
JSON 表現
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
フィールド
dateRange

object (DateRange)

レポートが生成される期間。最大期間は 30 日です。

dimensions[]

enum (Dimension)

レポートのディメンションのリスト。これらのディメンションの値の組み合わせによって、レポートの行が決まります。ディメンションが指定されていない場合は、アカウント全体でリクエストされた指標が 1 行で返されます。

metrics[]

enum (Metric)

レポートの指標のリスト。レポートには指標を少なくとも 1 つ指定する必要があります。

languageCode

string

適用可能な特定のディメンション値など、ローカライズされたテキストに使用される言語。言語タグは IETF BCP47 で定義されています。デフォルトは「en-US」指定します。

ディメンション

キャンペーン レポートのディメンション。

列挙型
DIMENSION_UNSPECIFIED 未指定のディメンションのデフォルト値。使用しないでください。
DATE YYYYMMDD 形式の日付(例: 20210701)。
CAMPAIGN_ID キャンペーンの一意の ID(例: 「123456789」)。キャンペーン リスト API のキャンペーン ID と一致します。
CAMPAIGN_NAME キャンペーンの名前です。
AD_ID 広告の一意の ID(例: 123456789)。
AD_NAME 広告の名前。一意ではありません。
PLACEMENT_ID 広告が配置されるアプリのベンダー固有の一意の ID。たとえば、Android アプリの場合は com.goog.bar、iOS アプリの場合は 123456789 になります。
PLACEMENT_NAME 広告が配置されるアプリの名前。
PLACEMENT_PLATFORM 広告が配置されるアプリのプラットフォーム。
COUNTRY 対象国の名前。
FORMAT 広告ユニットの形式(「バナー」、「ネイティブ」など)、広告配信ディメンション。

指標

キャンペーン レポートの指標。

列挙型
METRIC_UNSPECIFIED 未設定のフィールドのデフォルト値。使用しないでください。
IMPRESSIONS 広告がユーザーに表示された回数。
CLICKS ユーザーが広告をクリックした回数。
CLICK_THROUGH_RATE 広告のクリック数を表示回数で割った値。
INSTALLS デバイスにアプリがダウンロードされた回数です。
ESTIMATED_COST 収益を得る広告ではなく、キャンペーン広告を配信するための推定費用。この通貨は、キャンペーンのレポート通貨です。
AVERAGE_CPI 平均インストール単価。新規ユーザーの獲得にかかった平均金額。この通貨は、キャンペーンのレポート通貨です。
INTERACTIONS ユーザーが広告を操作した回数。クリック数とエンゲージメント数で構成されます。