正在取得成效資料

您可以執行每日查詢，查詢一天的資料，快速取得成效資料，且不會超過配額。

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

總覽

  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": "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
  },
...