Google Analytics Management API 變更記錄

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

我們會定期更新 Google Analytics (分析) Management API,藉此提供新功能並修正先前版本中發現的瑕疵。在大多數情況下,API 開發人員將看到這些變更。然而,我們有時必須進行變更,需要開發人員修改現有應用程式。

本頁面說明對 Google Analytics (分析) Management API 所做的任何變更,都可能影響您的應用程式。我們建議 API 開發人員定期查看這份清單,檢查是否有任何新公告。您也可以透過下方「訂閱」部分中列出的動態饋給訂閱異動。

訂閱相關變更記錄

包含所有集合、設定和 Reporting API。

其中包括 Management API 和 佈建 API。

Management API 中的使用者資料保留設定

現在可以使用在 WebProperty 資源中新增的「dataKeepTtl」和「dataKeepResetOnNewActivity」欄位,以程式輔助的方式設定使用者資料保留設定。

在 Management API 中寫入作業

在管理 API、資料檢視 (設定檔) 和目標資源中,管理 Management API 中的寫入作業 (例如建立、更新、刪除、修補) 不再需要加入許可清單。Management API 中所有寫入作業的預設每日限制為每天 50 次寫入。詳情請參閱「限制和配額」頁面。

自訂指標

這是錯誤修正版本;修正了在未設定 min_value 時,TIME 類型自訂指標建立失敗的問題。不含 min_value 的要求現在會建立自訂指標,預設 min_value0

主演

這個版本會將 starred 資源加入「帳戶摘要」、「帳戶」、「網站資源」和「資料檢視 (設定檔)」

未取樣報表

未取樣報表 API 不再每天有 100 份報表。這個 API 與透過網頁介面建立未取樣報表時採用的每項資源、每日權杖系統相同。

未取樣報表

目前使用者無法存取的未取樣報表將不再透過 Management API 回應訊息顯示下載連結。這個行為現在與使用者介面資訊主頁功能一致,只有報表擁有者能夠查看所產生文件的下載連結。

瀏覽 (設定檔)

這個版本會將 botFilteringEnabled 屬性新增至資料檢視 (設定檔) 資源。這個屬性可表示資料檢視 (設定檔) 是否已啟用漫遊器篩選。詳情請參閱查看 (設定檔) 參考說明文件

未取樣報表

這個版本會將 delete 方法新增至未取樣報表。詳情請參閱未取樣報表刪除參考文件

區隔

這是錯誤修正版本。這個版本修正了呼叫區隔清單方法時,會造成定義值中含有區隔的區隔無法正確顯示的問題。

區隔

這是錯誤修正版本。這個版本修正了將私人區隔固定於多個檢視畫面 (設定檔) 的使用者,在呼叫區隔清單方法時會收到 500 錯誤回應的問題。

批次處理

在這個版本中,除了一般的批次支援外,我們也為 User Permissions API 新增了特殊支援。批次使用者權限要求會顯著提升效能,並減少配額用量。

瀏覽 (設定檔)

在這個版本中,若在 insert 作業期間未設定,則 View (Profile) currency 屬性將預設為 USD。此外,getlist 作業會針對先前沒有 currency 屬性的 View (設定檔) 傳回 USD

篩選器

這個版本會移除已淘汰的篩選器欄位 IS_MOBILEIS_TABLET,該欄位應替換成 DEVICE_CATEGORY=mobileDEVICE_CATEGORY=tablet。如果插入、更新和修補的要求將篩選器欄位設為使用 IS_MOBILEIS_TABLET,就會傳回錯誤。

篩選器

這個版本為所有篩選器詳細資料部分新增 fieldIndex 屬性,以支援對篩選器欄位使用自訂維度。舉例來說,您現在可以使用 "field": "CUSTOM_DIMENSION""fieldIndex": "1" 設定篩選器運算式,讓篩選器在第一個自訂維度上運作。

目標

這個版本也修正了透過 "comparisonValue": "0" 建立目標時會失敗的問題。

這個版本代表 dailyUpload 存放區的最終終止和移除作業。dailyUpload 資源已於 2014 年 6 月 20 日正式淘汰;現在可以透過上傳資源匯入所有費用資料。

所有集合的 list 方法回應現在包含 items 屬性的空白清單,其中集合不含資源。先前,系統會從回應中省略 items 屬性。如需 Google Analytics (分析) 設定資料查詢和回應的完整詳情,請參閱 API 參考資料

這個版本為 Google Analytics Management API 推出了新的範圍。- analytics.manage.users.readonly:查看 Google Analytics (分析) 使用者權限。

新增 DEVICE_CATEGORY 篩選器欄位,並淘汰 IS_MOBILEIS_TABLET。使用DEVICE_CATEGORY=mobileDEVICE_CATEGORY=tablet

資料檢視 (設定檔) 資源現在包含 enhancedECommerceTracking 屬性,指出是否已啟用加強型電子商務 (true) 或停用 (false)。

這個版本包含新的資料匯入類型,以及淘汰 dailyUpload 資源。

資料匯入

請參閱資料匯入開發人員指南,瞭解如何使用 Management API 將資料匯入 Google Analytics (分析) 帳戶。

上傳內容

  • upload 資源現在支援下列上傳類型:
    • 廣告活動資料
    • 內容資料
    • 費用資料
    • 產品資料
    • 退款資料
    • 使用者資料
  • upload 資源提供新的 migrateDataImport 方法,可用於遷移現有的費用資料 customDataSources

每日上傳淘汰

  • dailyUpload 資源現已淘汰!請參閱遷移指南,進一步瞭解如何遷移使用資料匯入功能。
  • dailyUpload 資源仍會繼續運作六個月,但在該時間點,uploadType 屬性analytics#dailyUploads 的所有 customDataSources 資源都會自動遷移,而且只能與 upload 資源搭配使用。
  • 目前 dailyUpload 資源的使用者應更新程式碼,並盡快遷移以使用上傳資源。

這個版本新增了兩個新的設定 API。

篩選器

未取樣報表:Management API

Management API 會新增一項資源,稱為「未取樣報表」。未取樣報表是利用未取樣資料產生的 Google Analytics (分析) (GA) 報表。「未取樣報表」目前僅適用於 Google Analytics (分析) 進階版使用者。

區隔:管理 API 2.4 版和 3.0 版

我們對區隔集合進行了以下變更:

  • API 現已支援使用者和序列區隔。
  • 區隔集合現在會傳回所有內建和自訂工作階段層級使用者層級區隔。
  • 區隔的 definition 屬性現在會使用新的區隔語法。這包括現有工作階段層級區隔的定義 (從 definition: "" 變更為 definition: "sessions::condition::")。
  • Segment 資源中加入新的 type 屬性,用來表示區隔是否為 CUSTOM (意即使用者在網頁介面中建立) 或 BUILT_IN (由 Google Analytics (分析) 提供)。

實驗

下列 AdSense 指標現在可做為最佳化目標:

  • ga:adsenseAdsClicks — 您網站上 AdSense 廣告的點擊次數。
  • ga:adsenseAdsViewed — 已檢視的 AdSense 廣告數量。單一廣告單元可以顯示多則廣告。
  • ga:adsenseRevenue:AdSense 廣告的總收益。

新帳戶摘要

由於淘汰ga:isMobilega:isTablet 維度,我們對預設區隔進行了下列變更:

  • 區隔「gaid::-11」已從「行動流量」重新命名為「行動裝置和平板電腦流量」。這個區隔的定義已從 ga:isMobile==Yes 改為 ga:deviceCategory==mobile,ga:deviceCategory==tablet。請注意,ga:isMobile 包含平板電腦流量,這會反映在新定義中。如果您只想使用行動裝置流量 (不含平板電腦),請改用新的行動流量區隔 (gaid::-14)。
  • 區隔「gaid::-13」的定義已從 ga:isTablet==Yes 變更為 ga:deviceCategory==tablet。這種情況持續代表平板電腦流量
  • 已新增區隔「gaid::-14」。區隔的名稱是「行動流量」,而定義是 ga:deviceCategory==mobile

修正錯誤:

  • 修正檢視區塊 (設定檔) 的時區資訊。詳細資料:在修正錯誤之前,在某些情況下在 Management API 中列出資料檢視 (設定檔),系統會傳回資料檢視 (設定檔) 的時區資訊。現在,資料檢視 (設定檔) 的時區資訊與 Google Analytics (分析) 管理介面設定的資訊一致。

這個版本介紹了網站資源、資料檢視 (設定檔) 和目標資源的寫入作業,以及一組 3 項可啟用使用者權限的新資源。

帳戶設定和設定 API

  • 你現在可以建立、更新、修補及刪除檢視畫面 (設定檔)。請參閱查看 (設定檔) 參考資料,進一步瞭解新方法。
  • 你現在可以建立、更新及修補網站資源和目標。請參閱網站資源參考資料目標參考資料,進一步瞭解這些新方法。
  • 您現在可以使用 get 方法要求單一網站資源、資料檢視 (設定檔) 或目標。
  • 這些功能目前仍為 Beta 版,僅供開發人員試用。如有意願申請加入,請申請使用 Beta 版

Management API 中的使用者權限

推出新區隔中,我們即將推出區隔集合功能異動:

  • 所有區隔 ID 都會從正整數改為英數字元。如果您儲存了使用者的區隔 ID,建議您更新為使用新 ID。
  • 「區隔集合」只會傳回現有的造訪層級區隔。API 目前不支援新的訪客、同類群組和序列區隔。
  • 「區隔集合」會繼續傳回具有相同負數 ID 的現有預設區隔,但目前不支援新的預設區隔。

這個版本為網站資源資源新增了 2 項新資源:

  • profileCount - 傳回房源的設定檔計數。這樣一來,您就能篩選不含任何設定檔的屬性 (例如 profileCount = 0)。
  • industryVertical - 傳回為資源選取的產業類別/類別。

修正錯誤:

  • 個人資料資源eCommerceTracking 屬性現在與網頁介面管理部分中的「電子商務設定」一致。啟用電子商務追蹤功能時會傳回 true,如未啟用,則傳回 false
  • 網站資源資源現在包含 level 資源,表示網站資源是 PREMIUM 還是 STANDARD
  • Management API 已新增新的端點,用於存取及修改實驗資源。
  • 設定檔資源現在包含 type 屬性,用於識別設定檔是否為網站或應用程式設定。可能的值為 WEBAPP

這個版本為 Management API 新增了實用的錯誤回應。

  • API 錯誤回應的內文中加入新的錯誤代碼、原因和說明。用於管理 API 版本 (2.4 版3.0 版) 的所有程式碼。

這個版本新增資料、變更現有功能並修正錯誤。

新資料

  • 「進階區隔」集合現在包含 segmentId,可用於資料匯出 API 區隔參數。

異動項目

  • max-results的資料類型已變更為 integer

  • max-results 的預設值和最大值已變更為 1000。

修正錯誤

  • Google 最佳化工具實驗的帳戶、資源和設定檔不再包含在對應的集合中。

這個版本包含兩個新的 API 版本,以及多項新功能,並淘汰舊版。這些異動會影響您向 API 要求及處理資料的方式。

3.0 版本

  • 這是我們最新的 API 主要版本,無法回溯相容。日後的 API 開發作業一律會在這個版本中完成。

  • 新資料

    • 完整呈現事件目標
    • 內部網站資源 ID,可用來深層連結至 Google Analytics (分析) 使用者介面
    • 預設網頁和網站搜尋查詢參數的設定檔設定
  • 異動項目

2.4 版本

  • 這個次要版本升級大多與現有 2.3 版本相容。

  • 異動項目

    • 新版配額政策
    • Google API 控制台整合,可管理 API 存取權和要求更多配額
    • 持續支援現有授權機制和 OAuth 2.0
    • 要提出要求的新網址:https://www.googleapis.com/analytics/v2.4/management/…
    • 僅限 XML 中的回應
    • 不支援 Google Data JavaScript 用戶端程式庫
    • XML 輸出版本與 2.3 版一致,因此其他現有的 Google Data 用戶端程式庫仍會繼續運作。

淘汰

  • 我們宣布要淘汰舊版 Management API 2.3 版。這個 API 會繼續運作兩個月,之後所有 2.3 版要求都會傳回 2.4 版回應。

這是 Google Analytics Management API 的 Beta 版!

新動態饋給

更新的用戶端程式庫

  • Management API 與 Google Analytics (分析) Data Export API 在同一個程式庫中發布。Google Data Java 和 JavaScript 程式庫皆已更新。如要存取動態饋給,請為程式庫 getManagementFeed() 方法指定適當的動態饋給 URI。

新增說明文件

  • Google Analytics (分析) 開發人員文件新增了一個新的章節,用於說明新版 Management API 的運作方式。