Method: accounts.campaignReport.generate

根據提供的規格產生廣告活動報表。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

要產生報表的帳戶資源名稱。範例：accounts/pub-9876543210987654

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
欄位
reportSpec

object (CampaignReportSpec)

廣告活動報表規格。

回應主體

Campaign Report API 回應。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
欄位
rows[]

object (ReportRow)

指定發布商的廣告活動報表資料。API 最多會傳回 100,000 列。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

CampaignReportSpec

產生廣告活動報表時採用的規格。舉例來說，取得按 CAMPAIGN_ID 劃分的 IMPRESSIONS 和 點擊次數 規格如下例所示：

{
  "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)

報表的維度清單。這些維度的值組合會決定報表的資料列。如果沒有指定維度，報表會為整個帳戶傳回一列要求的指標。
metrics[]

enum (Metric)

報表的指標清單。報表必須指定至少一個指標。
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。例如 com.goog.bar (Android) 和 123456789 (iOS 應用程式)。
PLACEMENT_NAME 刊登廣告的應用程式名稱。
PLACEMENT_PLATFORM 刊登廣告的應用程式平台。
COUNTRY 指定國家/地區的名稱。
FORMAT 廣告單元的格式 (例如「橫幅」、「原生」)，即廣告放送維度。

指標

廣告活動報表的指標。

列舉
METRIC_UNSPECIFIED 未設定欄位的預設值。請勿使用。
IMPRESSIONS 廣告向使用者顯示的次數。
CLICKS 使用者點按廣告的次數。
CLICK_THROUGH_RATE 廣告獲得的點擊次數除以廣告顯示次數。
INSTALLS 應用程式下載到裝置上的次數。
ESTIMATED_COST 放送廣告活動廣告 (而非賺取收益的廣告) 的預估費用。幣別是廣告活動的報表帳面貨幣。
AVERAGE_CPI 平均單次安裝出價。也就是說，開發新使用者所需的平均金額。幣別是廣告活動的報表帳面貨幣。
INTERACTIONS 使用者與廣告互動的次數。當中包含點擊和參與。