Method: accounts.networkReport.generate

根據提供的報表規格產生 AdMob 聯播網報表。傳回伺服器端串流 RPC 的結果。結果會透過一系列回應傳回。

HTTP 要求

POST https://admob.googleapis.com/v1/{parent=accounts/*}/networkReport:generate

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

路徑參數

參數
parent

string

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

要求主體

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

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

object (NetworkReportSpec)

聯播網報表規格。

回應主體

AdMob 聯播網報表的串流回應，第一個回應包含報表標題，然後是資料列回應串流，最後一則做為最後一則回應訊息的頁尾。

例如：

[{
  "header": {
    "dateRange": {
      "startDate": {"year": 2018, "month": 9, "day": 1},
      "endDate": {"year": 2018, "month": 9, "day": 1}
    },
    "localizationSettings": {
      "currencyCode": "USD",
      "languageCode": "en-US"
    }
  }
},
{
  "row": {
    "dimensionValues": {
      "DATE": {"value": "20180918"},
      "APP": {
        "value": "ca-app-pub-8123415297019784~1001342552",
         displayLabel: "My app name!"
      }
    },
    "metricValues": {
      "ESTIMATED_EARNINGS": {"microsValue": 6500000}
    }
  }
},
{
  "footer": {"matchingRowCount": 1}
}]

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

JSON 表示法 
{

  // Union field payload can be only one of the following:
  "header": {
    object (ReportHeader)
  },
  "row": {
    object (ReportRow)
  },
  "footer": {
    object (ReportFooter)
  }
  // End of list of possible types for union field payload.
}
欄位
聯集欄位 payload。每個串流回應訊息都包含一種酬載。payload 只能是下列其中一項：
header

object (ReportHeader)

報表產生設定，說明報表內容，例如報表日期範圍和本地化設定。
row

object (ReportRow)

實際報表資料。
footer

object (ReportFooter)

所產生報表的其他相關資訊，例如關於資料的警告。

授權範圍

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

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

詳情請參閱 OAuth 2.0 總覽。

NetworkReportSpec

產生 AdMob 聯播網報表時需遵循的規格。舉例來說，只有「美國」和「中國」國家/地區獲得點擊和預估收益的規格可參考以下範例：

{
  'dateRange': {
    'startDate': {'year': 2021, 'month': 9, 'day': 1},
    'endDate': {'year': 2021, 'month': 9, 'day': 30}
  },
  'dimensions': ['DATE', 'APP', 'COUNTRY'],
  'metrics': ['CLICKS', 'ESTIMATED_EARNINGS'],
  'dimensionFilters': [
    {
      'dimension': 'COUNTRY',
      'matchesAny': {'values': [{'value': 'US', 'value': 'CN'}]}
    }
  ],
  'sortConditions': [
    {'dimension':'APP', order: 'ASCENDING'},
    {'metric':'CLICKS', order: 'DESCENDING'}
  ],
  'localizationSettings': {
    'currencyCode': 'USD',
    'languageCode': 'en-US'
  }
}

如要進一步瞭解，您可以依照上述規格處理上述規格，例如下列虛擬 SQL：

SELECT DATE, APP, COUNTRY, CLICKS, ESTIMATED_EARNINGS
FROM NETWORK_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY DATE, APP, COUNTRY
ORDER BY APP ASC, CLICKS DESC;
JSON 表示法 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "dimensionFilters": [
    {
      object (DimensionFilter)
    }
  ],
  "sortConditions": [
    {
      object (SortCondition)
    }
  ],
  "localizationSettings": {
    object (LocalizationSettings)
  },
  "maxReportRows": integer,
  "timeZone": string
}
欄位
dateRange

object (DateRange)

產生報表的日期範圍。
dimensions[]

enum (Dimension)

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

enum (Metric)

報表的指標清單。報表必須指定至少一個指標。
dimensionFilters[]

object (DimensionFilter)

根據報表列的維度值說明要比對哪些報表列，
sortConditions[]

object (SortCondition)

說明報表列的排序。清單中的條件順序定義了優先順序；條件越早，條件的優先順序越高。如果沒有指定排序條件，列順序不會定義。
localizationSettings

object (LocalizationSettings)

報表的本地化設定。
maxReportRows

integer

要傳回的報表資料列數量上限。如未設定值，API 會盡可能傳回最多的資料列，最多 100000 個。可接受的值為 1-100000 (含頭尾)。大於 100000 的值會傳回錯誤。
timeZone

string

報表時區。接受 IANA TZ 名稱值，例如「America/Los_Angeles」。如果沒有定義時區，帳戶預設值就會生效。查看取得帳戶動作的預設價值。

警告：「America/Los_Angeles」是目前唯一支援的值。

維度

聯播網報表的維度。維度是一種資料屬性，可按特定屬性 (例如廣告格式或廣告放送平台) 細分或修正量化評估資料 (指標)。

列舉
DIMENSION_UNSPECIFIED 未設定欄位的預設值。請勿使用。
DATE 以 YYYYMMDD 格式表示的日期 (例如「20210701」)。要求最多只能指定一個時間維度。
MONTH 月份，採用 YYYYMM 格式 (例如「202107」)。要求最多只能指定一個時間維度。
WEEK 一週的第一天，以 YYYYMMDD 格式表示 (例如「20210701」)。要求最多只能指定一個時間維度。
AD_UNIT 廣告單元的專屬 ID (例如「ca-app-pub-1234/1234」)。如果指定「AD_UNIT」維度，就會自動納入「APP」。
APP 行動應用程式的專屬 ID (例如「ca-app-pub-1234~1234」)。
AD_TYPE

廣告類型 (例如「文字」或「圖像」)，廣告放送維度。

警告：維度與 AD_REQUESTS、MATCH_RATE 和 IMPRESSION_RPM 指標不相容。
COUNTRY 廣告瀏覽/點擊位置的 CLDR 國家/地區代碼 (例如「US」或「FR」)。這是地理位置維度。
FORMAT 廣告單元的格式 (例如「橫幅」、「原生」)，即廣告放送維度。
PLATFORM 應用程式的行動作業系統平台 (例如「Android」或「iOS」)。
MOBILE_OS_VERSION 行動作業系統版本，例如「iOS 13.5.1」。
GMA_SDK_VERSION GMA SDK 版本，例如「iOS 7.62.0」。
APP_VERSION_NAME 如果是 Android，您可以在 PackageInfo 的 versionName 中找到應用程式版本名稱。如果是 iOS，您可以在 CFBundleShortVersionString 中找到應用程式版本名稱。
SERVING_RESTRICTION 廣告放送的限制模式 (例如「非個人化廣告」)。

指標

聯播網報表的指標。指標是量化的評估數據，用來表示發布商業務的成效。匯總自個別廣告事件，並按報表維度分組。指標值可以是整數或十進位 (不含四捨五入)。

列舉
METRIC_UNSPECIFIED 未設定欄位的預設值。請勿使用。
AD_REQUESTS

廣告請求次數。這個值是整數。

警告：指標與 AD_TYPE 維度不相容。
CLICKS 使用者點按廣告的次數。這個值是整數。
ESTIMATED_EARNINGS AdMob 發布商的預估收益。收益指標的貨幣單位 (美元、歐元或其他) 取決於幣別的本地化設定。金額以百萬分之一為單位。舉例來說，$6.50 美元會是 6500000。
IMPRESSIONS 廣告向使用者顯示的總次數。這個值是整數。
IMPRESSION_CTR 點擊次數除以曝光次數所得的比例。這個值是雙精度 (近似) 小數值。
IMPRESSION_RPM

每千次廣告曝光的預估收益。這個值以微秒為單位。例如，$1.03 會是 1030000。相當於 AdMob 使用者介面中的「有效千次曝光出價」。

警告：指標與 AD_TYPE 維度不相容。
MATCHED_REQUESTS 回應請求而傳回廣告的次數。這個值是整數。
MATCH_RATE

比對成功的廣告請求數量在廣告請求總數中所佔的比例。這個值是雙精度 (近似) 小數值。

警告：指標與 AD_TYPE 維度不相容。
SHOW_RATE 顯示在傳回的廣告上的廣告比例，計算方式為曝光次數 / 比對請求數。這個值是雙精度 (近似) 小數值。

DimensionFilter

根據報表列的維度值說明要比對哪些報表列，

JSON 表示法 
{
  "dimension": enum (Dimension),

  // Union field operator can be only one of the following:
  "matchesAny": {
    object (StringList)
  }
  // End of list of possible types for union field operator.
}
欄位
dimension

enum (Dimension)

將篩選器條件套用至指定維度。
聯集欄位 operator。要套用的篩選器運算子。operator 只能是下列其中一項：
matchesAny

object (StringList)

如果資料列的指定維度值位於此條件指定的其中一個值中，就會顯示相符資料列。

SortCondition

要套用至維度或指標的排序方向。

JSON 表示法 
{
  "order": enum (SortOrder),

  // Union field sort_on can be only one of the following:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of list of possible types for union field sort_on.
}
欄位
order

enum (SortOrder)

維度或指標的排序順序。
聯集欄位 sort_on。找出要排序的值。sort_on 只能是下列其中一項：
dimension

enum (Dimension)

按照指定維度排序。
metric

enum (Metric)

依指定指標排序。