Google Analytics (分析) Management API 變更記錄

我們會定期更新 Google Analytics (分析) Management API,以便提供新功能並修正在先前版本中發現的瑕疵。在大多數情況下,API 開發人員會公開這些異動。不過,我們有時需要進行變更,需要開發人員修改現有的應用程式。

這個頁面記錄了可能影響應用程式的 Google Analytics Management API 變更。我們建議 API 開發人員定期查看此清單以掌握任何最新公告。您也可以透過下方「訂閱」專區下方的動態饋給來訂閱變更。

訂閱相關變更記錄

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

包含 Management API 和 Provisioning API。

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

您現在可以使用新增至 WebProperty 資源的新「data 保留 Ttl」和「data 保留 ResetOnNewActivity」欄位,透過程式輔助方式設定使用者資料保留設定。

在 Management API 中寫入作業

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

自訂指標

這是錯誤修正版本,修正了在未設定 min_value 的情況下,建立 TIME 類型的自訂指標失敗的問題。不含 min_value 的要求現在會建立自訂指標,並將預設 min_value 設為 0

貨幣

這是錯誤修正版本,修正了 Analytics (分析) 網頁介面支援部分貨幣但 API 不支援貨幣的問題。這個版本支援以下貨幣:

  • 阿拉伯聯合大公國、阿拉伯聯合大公國、巴林、智利、哥倫比亞、埃及、克羅埃西亞、以色列、馬其頓、馬來西亞令吉、巴基斯坦、巴基斯坦、RON、RSD、SAR、SGD、VEF、LVL

詳情請參閱:資料檢視 (設定檔) 參考資料。- 貨幣參考資料說明中心文章。

未取樣報表

未取樣報表 API 不再有每日 100 份報表的限制。API 使用的每日每個資源權杖系統,與透過網頁介面建立未取樣報表時使用相同的權杖系統。

未取樣報表

目前使用者無法存取未取樣報表,系統不會再於 Management API 回應訊息中提供下載連結。這項行為現在與使用者介面資訊主頁功能一致,只有報表擁有者才能查看所產生文件的下載連結。

資料檢視 (設定檔)

這個版本會將 botFilteringEnabled 屬性新增至檢視畫面 (設定檔) 資源。這項屬性會指出資料檢視 (設定檔) 是否已啟用機器人篩選功能。詳情請參閱檢視 (個人資料) 參考說明文件

未取樣報表

這個版本會在未取樣報表中加入 delete 方法。詳情請參閱未取樣報表刪除參考文件

路段

本版本的目的在於修正錯誤。這個版本修正了在呼叫區隔清單方法時,定義中帶有貨幣值的區隔無法正確顯示的問題。

路段

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

批次處理

除了一般的批次支援功能外,這個版本也新增了 User Permissions API 的特別支援。使用者權限批次要求會大幅提升效能,並減少配額用量。

資料檢視 (設定檔)

這個版本推出後,如果 insert 作業期間沒有設定檢視畫面 (設定檔) currency,該屬性現在預設為 USD。此外,getlist 作業會針對先前在不含 currency 資源的情況下建立的資料檢視 (設定檔),傳回 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 中的 AdWords 連結,建立、列出、取得、更新、修補及刪除 Google AdWords 帳戶與 Google Analytics (分析) 資源之間的連結,以及管理連結至 AdWords 資料的資料檢視 (設定檔)。

篩選器

未取樣報表:Management API

Management API 即將加入一項新資源,名稱為未取樣報表。未取樣報表指的是 Google Analytics (分析) 報表,使用未取樣資料產生。「未取樣報表」目前只提供給 Google Analytics Premium 使用者使用。

區隔:Management API v2.4 和 3.0

我們已對區隔集合進行下列變更:

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

實驗

下列 AdSense 指標已可當做最佳化目標:

  • ga:adsenseAdsClicks:您網站上 AdSense 廣告的點擊次數。
  • ga:adsenseAdsViewed:AdSense 廣告瀏覽次數。一個廣告單元可以顯示多則廣告。
  • ga:adsenseRevenue:AdSense 廣告帶來的總收益。

新帳戶摘要集合

  • AccountSummaries 集合已新增至 Management API。這項工具會在單次快速要求中,列出授權使用者可存取的每個帳戶、資源和資料檢視 (設定檔) 的資訊摘要。詳情請參閱《帳戶摘要開發人員指南》。

由於 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 (分析) 管理員介面中的設定一致。

這個版本推出了網站資源、資料檢視 (設定檔) 和目標資源的寫入作業,以及一組啟用使用者權限管理功能的新資源組合。

帳戶設定和 Configuration API

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

Management API 中的使用者權限

隨著新區隔推出,我們也將對區隔集合推出下列變更:

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

這個版本會在網站資源資源中加入 2 項新資源:

  • profileCount - 傳回屬性的設定檔數量。這可讓您篩選沒有任何設定檔的資源 (例如 profileCount = 0)。
  • industryVertical - 傳回為資源選取的產業/類別。

修正錯誤:

  • 設定檔資源eCommerceTracking 屬性現在與網頁介面「管理」部分中的電子商務設定一致。如果啟用電子商務追蹤,會傳回 true,否則傳回 false
  • 網站資源現在包含 level 資源,可用於指出網站資源是 PREMIUM 還是 STANDARD
  • Management API v3 已新增端點,以便存取及修改實驗資源。
  • 設定檔資源現在包含 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 用戶端程式庫會繼續運作。

淘汰

  • 我們宣布即將淘汰 2.3 版 Management API。會繼續運作兩個月,之後所有 v2.3 要求都會傳回 v2.4 回應。

這是 Google Analytics (分析) Management API 的 Beta 版!

新動態饋給

更新後的用戶端程式庫

  • Management API 即將發布至 Google Analytics (分析) 資料匯出 API 所在的程式庫中。Google Data Java 和 JavaScript 程式庫皆已更新。您可以為程式庫 getManagementFeed() 方法指定適當的動態饋給 URI,藉此存取每個動態饋給。

新增說明文件

  • 我們推出了 Google Analytics (分析) 開發人員文件專區,說明新 Management API 的運作方式。