取得成效資料

您可以針對每天的資料量執行每日查詢,在不超出配額的情況下快速查詢效能資料。

您必須選擇您要在資料中加入哪些資訊:網頁、圖片、影片等搜尋類型。 以及哪些維度 (網頁、查詢、國家/地區或裝置),以及是否要依網頁或資源將結果分組。查詢網頁和/或查詢字串時,部分資料可能會遭到捨棄 (原因)。

總覽

  1. 我們建議您每天使用下方所述的查詢樣式,針對每天 1 天的資料執行查詢。針對某一天的資料執行每日查詢,不會超過每日配額。系統通常會在 2 至 3 天後提供資料;您可以查詢過去 10 天依日期分組的簡易查詢,藉此瞭解最近可用的資料。撰寫查詢:
    • 選擇要依網頁或資源分組結果。
    • 選擇您要在查詢中納入更完整的計數或維度。注意:您必須使用兩步驟程序來查詢搜尋外觀資料 (AMP、藍色連結、複合式搜尋結果等)。
  2. 重新執行相同的查詢即可瀏覽結果,並將要求中的 startRow 值提高 25,000,直到達到最後一頁 (含有 0 列的回應)。
  3. 視需要使用另一個 type 參數執行相同的查詢。

以下是單一查詢的虛擬程式碼範例。針對您要取得資料的每個 type,每天執行一次。

int maxRows = 25000; // Current max response size
int i = 0;
do {
  response = Request(startDate = 3_days_ago,
                     endDate = 3_days_ago,
                     ... add dimensions, type ...
                     rowLimit = maxRows,
                     startRow = i * maxRows);
  i++;
  …  // Do something with the response data.
} while (response.rows.count() != 0); // Page through all result rows

數據用量上限

除了 API 用量配額之外,Search Analytics (分析) 方法還顯示了每種搜尋類型 (網頁、圖片等) 每天最多 50,000 列的資料 (按點擊次數排序)。

查詢詳細資料

您可以查詢依網頁資源分類的資料。

依網頁分組

如為準確計數,您必須省略網頁和查詢維度,如下所示:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate:選取當天的日期,選擇一天。
  • dimensions:可選擇包含 country 和/或 device
  • type:視需要在個別查詢中列舉「每個 type」,
  • aggregationType:必須是 byPage

如需更詳盡的資訊 (包括網頁和/或查詢資訊),但會遺失部分資料,請執行以下查詢:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate:選取當天的日期,選擇一天。
  • dimensions:包含 page。您可以選擇加入 querycountrydevice 的任意組合。
  • type:視需要在個別查詢中列舉「每個 type」,

依資源分組

如為準確計數,您必須省略網頁和查詢維度,如下所示:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate:選取當天的日期,選擇一天。
  • dimensions:可選擇包含 country 和/或 device
  • type:視需要在個別查詢中,針對每個 type進行列舉。

如需更詳盡的資料 (包括查詢、國家/地區和/或裝置資訊),則可能會失去部分資料,這時請執行以下查詢:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate:選取當天的日期,選擇一天。
  • dimensions:可選擇包含 querycountrydevice 的任意組合。
  • type:視需要在個別查詢中列舉「每個 type」,

依網頁或資源將結果分組

按網頁 (而不是資源) 分組結果時,曝光次數、點擊次數、排名和點閱率的計算方式會有所不同。瞭解詳情

為什麼提交詳細資料時遺失資料?

當您依網頁和/或查詢進行分組時,系統可能會捨棄某些資料,以便在合理的時間內根據合理的運算資源計算結果。

取得搜尋外觀資料

搜尋外觀 不會以欄或其他維度的形式提供。因此,如果想查看網站的搜尋外觀資訊,您必須按照以下步驟操作:

  1. 指定 searchAppearance 為唯一維度,該維度會按搜尋外觀類型將所有資料分組,不會加入其他維度。
  2. 視需要執行第二個查詢,依照步驟 1 列出的搜尋外觀類型進行篩選,並在查詢中加入任何所需維度 (網頁、國家/地區、查詢等)。

如要擷取多種搜尋外觀類型的資料,您必須針對步驟 1 所列的每個搜尋外觀類型執行第二個步驟。

首次查詢:

取得您網站上搜尋外觀類型的清單。

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

成果:

您的網站屬於 INSTANT_APP、AMP_BLUE_LINK 類型,以此類推。

 "rows": [
  {
   "keys": [
    "INSTANT_APP"
   ],
   "clicks": 443024.0,
   "impressions": 4109826.0,
   "ctr": 0.10779629113251997,
   "position": 1.088168452873674
  },
  {
   "keys": [
    "AMP_BLUE_LINK"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090884E7,
   "ctr": 0.025152999692701676,
   "position": 7.313451603790653
  },...

第二個查詢:

按照步驟 1 中的搜尋外觀類型,以及所需的任何維度 (網頁、裝置等) 進行篩選,我們依照 AMP_BLUE_LINK 進行篩選。

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "device" // and/or page, country, ...
  ],
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "searchAppearance",
          "operator": "equals",
          "expression": "AMP_BLUE_LINK"
        }
      ]
    }
  ]
}

成果:

按裝置類型細分的 AMP_BLUE_LINK

"rows": [
  {
   "keys": [
    "MOBILE"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090783E7,
   "ctr": 0.025153148337323107,
   "position": 7.31339517914422
  },
  {
   "keys": [
    "DESKTOP"
   ],
   "clicks": 0.0,
   "impressions": 66.0,
   "ctr": 0.0,
   "position": 12.257575757575758
  },
...