正在取得成效資料

查詢每日的資料量，即可快速查詢效能資料，而且不會超過配額。

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

總覽

  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 方法每天最多能為每種搜尋類型 (網頁、圖片等) 顯示 5 萬列資料 (按點擊次數排序)。

查詢詳細資料

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

已依網頁分組

如要獲得準確的計數，您必須略過網頁和查詢維度，如下所示：

"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。視需要納入 query、country 或 device 的任意組合。
  • 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：視需要納入 query、country 或 device 的任意組合。
  • 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
  },
...