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)

广告系列报告规范。

响应正文

广告系列报告 API 响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
字段
rows[]

object (ReportRow)

指定发布商的广告系列报告数据。API 最多会返回 10 万行。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 OAuth 2.0 Overview。

CampaignReportSpec

这指的是广告系列报告的生成规范。例如，下面是一个按 CAMPAIGN_ID 细分的 IMPRESSIONS 和 CLICKS 的规范示例，代码大致如下所示：

{
  "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。例如，Android 应用的 ID 为 com.goog.bar，iOS 应用的 ID 为 123456789。
PLACEMENT_NAME 放置广告的应用的名称。
PLACEMENT_PLATFORM 放置广告的应用的平台。
COUNTRY 目标国家/地区的名称。
FORMAT 广告单元的格式，例如“横幅广告”“原生广告”，这是一种广告投放维度。

指标

广告系列报告的指标。

枚举
METRIC_UNSPECIFIED 这是未设置字段的默认值。请勿使用。
IMPRESSIONS 向用户展示广告的次数。
CLICKS 用户点击广告的次数。
CLICK_THROUGH_RATE 广告获得的点击次数除以广告的展示次数所得的比值。
INSTALLS 应用下载到设备的次数。
ESTIMATED_COST 投放广告系列广告（而非创收广告）的估算费用。相应币种是广告系列的报告币种。
AVERAGE_CPI 每次安装的平均费用。也就是说，您为获取一位新用户所支出的平均金额。相应币种是广告系列的报告币种。
INTERACTIONS 用户与广告互动的次数。这包括点击和互动。