Google Analytics (分析) - 所有 Reporting API 變更記錄

本頁面記錄了 Google Analytics (分析) Reporting API 的所有變更。包括 Core Reporting API 和多管道漏斗 Reporting API 的變更記錄。我們建議 API 開發人員定期查看此清單以掌握任何最新公告。您也可以透過下方「訂閱」專區下方的動態饋給來訂閱變更。

訂閱相關變更記錄

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

包含 Core Reporting API、多管道漏斗 Reporting API 和 Real Time Reporting API。

這是 User Activity API 的初始版本

  • User Activity API 可讓您擷取與特定日期範圍內的某個 Client-ID 或 User-ID 相關的所有資料。這項計畫的主要用途是協助房源擁有者直接存取使用者的資料,並自動授予該使用者資料存取權。詳情請參閱 User Activity API 指南

在這個版本中,所有 Analytics (分析) 360 (Premium) 客戶都可以使用 Google Analytics Reporting API v4 的資源型配額系統

這個版本加入了 Analytics (分析) Real Time API 配額與限制的異動。

Analytics Real Time Reporting API 呼叫可用來讓每次資料檢視 (設定檔) 每日 10,000 次呼叫的上限,與其他 Analytics (分析) API 呼叫相比。現在,Analytics (分析) Real Time Reporting API 呼叫會分開處理,也就是說,您可以使用 Analytics (分析) Real Time Reporting API 每天針對每次資料檢視 (設定檔) 進行 10,000 次呼叫,「而且」每天還能使用任何其他 Analytics (分析) API 進行 10,000 次呼叫。詳情請參閱限制與配額頁面。

這項變更提供更精細且不安全的配額管理方式,讓使用 Analytics Real Time Reporting API 頻繁呼叫的使用者不會意外完全封鎖個別設定檔的其餘 Analytics (分析) API 呼叫。

這個版本會提高 Analytics Reporting API v4 結果集傳回的資料列數量上限。

Analytics Reporting API v4 ReportData 物件中傳回的資料列數量上限從 10,000 個增加到 100,000 個。

這個版本針對 Google Analytics (分析) Reporting API v4 的資源型配額系統,新增預覽功能,讓 Analytics (分析) 360 (Premium) 客戶使用更高的取樣門檻。

這個版本淘汰了「相關產品」功能及相關的維度和指標;如需完整的定義清單,請參閱維度和指標參考資料。請參閱資料淘汰政策,進一步瞭解資料移除作業:

此版本淘汰了下列維度和指標:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

這個版本會在 API 中加入新維度;如需完整的定義清單,請參閱維度和指標參考資料。此外,這個版本也移除了幾個已淘汰的維度和指標。請參閱 Google Analytics (分析) API 資料淘汰政策,瞭解完整資料移除程序。

時間

  • 新維度 ga:dateHourMinute,可結合 ga:datega:hourga:minute

資料移除

這個版本移除下列已淘汰的維度和指標:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

這個版本更新 API 中現有的指標和維度。如需完整的定義清單,請參閱維度和指標參考文件

使用者指標

已更新「使用者」和「活躍使用者」指標的計算方式,以便更有效計算使用者人數。您可能會發現指標略有不同。詳情請參閱「使用者指標識別使用者的方式」一文。

受計算更新影響的使用者指標:

  • ga:users:指定時間範圍內的使用者總數。
  • ga:1dayusers:在指定時間範圍內,每日 1 天活躍使用者總數。
  • ga:7dayusers:在指定時間範圍內,每日 7 天內的活躍使用者總數。
  • ga:14dayusers:在指定時間範圍內,每日 14 天活躍使用者總數。
  • ga:30dayusers:在指定時間範圍內,每日 30 天活躍使用者總數。

不重複事件

ga:uniqueEvents」的淘汰時間即將結束。2017 年 3 月 26 日後,系統會更新 ga:uniqueEvents 的定義,並將私人 ga:uniqueEventsTemporary 指標從 API 中移除。詳情請參閱不重複事件說明文件

這個版本在 API 中加入新維度、改善錯誤訊息,並開始實施先前公告的 AdSense 維度和指標異動。

使用者維度

  • 維度 - ga:userBucket - 對於任一使用者,「使用者區間」維度 (值從 1 到 100) 代表使用者獲派的值區。詳情請參閱測試再行銷廣告活動

錯誤訊息

之前 API 會在要求的資料包含不符合的條件時,傳回錯誤的錯誤訊息 Unknown dimension(s):Unknown metric(s):,因此 API 現在會傳回以下訊息:Restricted metric(s): ... can only be queried under certain conditions.

AdSense 維度和指標

非 AdSense 連結的資料檢視則無法查詢 AdSense 維度和指標。如果使用非 AdSense 連結的資料檢視查詢這些維度和指標,就會發生錯誤。

本版本修正錯誤,修正了 AdSense 維度和指標的問題,並公告這些維度和指標的近期異動。

AdSense 維度和指標

此版本修正了 2017 年 1 月 7 日起,如果查詢 AdSense 維度和指標,非 AdSense 已連結資料檢視會傳回「不明指標」錯誤。

即將生效的異動

2017 年 1 月 31 日當天或之後,非 AdSense 已連結的資料檢視將無法查詢 AdSense 維度和指標。如果使用非 AdSense 連結的資料檢視查詢這些維度和指標,就會發生錯誤。

這個版本新增了下列新指標至 API。如需完整的定義清單,請參閱維度和指標參考文件

計算指標

這個版本開始支援計算指標

  • 指標 - ga:calcMetric_ - 要求計算指標的值,其中 是指計算指標的使用者定義名稱。請注意,ga:calcMetric_ 的資料類型可以是 FLOAT、INTEGER、CURRENCY、TIME 或 PERCENT。詳情請參閱「關於計算指標」。

這個版本會在 API 中加入新指標。它也會淘汰現有指標。如需完整的定義清單,請參閱維度和指標參考文件

事件追蹤

系統將變更 ga:uniqueEvents 的定義,以便更準確地反映不重複事件數量。為影響這項異動,我們將根據資料淘汰政策,從技術性淘汰目前的 ga:uniqueEvents 指標。如要試用新的定義,您可以參照私人指標 ga:uniqueEventsTemporary,這樣可以更準確地計算不重複事件數量。我們也將引進新的指標 ga:uniqueDimensionCombinations,以維持目前的「ga:uniqueEvents」定義。適當的淘汰時間範圍 (約 6 個月) 後,私人指標「ga:uniqueEventsTemporary」將會移除,而原始指標 ga:uniqueEvents 會正確代表不重複事件數量。詳情請參閱專屬事件說明文件

不重複事件

  • 指標 - ga:uniqueEvents - ga:uniqueEvents 的定義即將變更,以便更準確地反映不重複事件數量。如要保留現有的定義,請改用 ga:uniqueDimensionCombinations。詳情請參閱不重複事件說明文件
  • 指標 - ga:uniqueDimensionCombinations - 不重複維度組合會計算報表中每個維度的不重複維度/值組合數量。這樣就能在後續處理時建立組合 (串連式) 維度,提供更靈活的報表,無須更新追蹤導入設定或使用額外的自訂維度版位。詳情請參閱不重複事件說明文件

轉換測試 – 私人

  • 指標 - ga:uniqueEventsTemporary - 不重複事件的數量,成為 ga:uniqueEvents 的新定義。您可以在變更前透過這項指標瞭解新定義。請注意,這項指標為不公開,不會顯示在維度和指標參考資源中。

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考文件

DoubleClick Bid Manager

  • 維度 - ga:dbmClickAdvertiser - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告主名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickAdvertiserId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告主 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickCreativeId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告素材 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickExchange - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告交易平台名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickExchangeId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告交易平台 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickInsertionOrder - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告訂單名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickInsertionOrderId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告訂單 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickLineItem - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 委刊項名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickLineItemId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 委刊項 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmClickSite - 在與 Google Analytics (分析) 工作階段相符的 DBM 點擊 (僅限 Analytics (分析) 360,需要與 DBM) 整合時,出現並點選的 DBM 網站名稱。
  • 維度 - ga:dbmClickSiteId - 在與 Google Analytics (分析) 工作階段相符的 DBM 點擊 (僅限 Analytics (分析) 360,需要與 DBM) 整合時,出現並點選的 DBM 網站 ID。
  • 維度 - ga:dbmLastEventAdvertiser - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 廣告主名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventAdvertiserId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 廣告主 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventCreativeId:與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內發生曝光或點擊) 的 DBM 廣告素材 ID (僅限 Analytics (分析) 360 必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventExchange - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 廣告交易平台名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventExchangeId:與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 廣告交易平台 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventInsertionOrder - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 廣告訂單名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventInsertionOrderId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 廣告訂單 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventLineItem - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內發生曝光或點擊) 的 DBM 委刊項名稱 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventLineItemId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (在 DBM 回溯期內的曝光或點擊) 的 DBM 委刊項 ID (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventSite - 在與 Google Analytics (分析) 工作階段相關的最終 DBM 事件 (僅限 Analytics (分析) 360 中的曝光或點擊) 觸發並點擊 DBM 廣告素材時點選的 DBM 網站名稱 (僅限 Analytics (分析) 360)。
  • 維度 - ga:dbmLastEventSiteId - DBM 網站 ID,在與 Google Analytics (分析) 工作階段相關的最終 DBM 事件 (僅限 Analytics (分析) 360 整合,且必須在 DBM 回溯期內發生曝光或點擊) 發生時,顯示並獲得點擊的 DBM 網站 ID。
  • 指標 - ga:dbmCPA - DBM 有效每次獲益成本收益 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmCPC - DBM 有效單次點擊出價收益 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmCPM - DBM 有效千次曝光出價收益 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmCTR - DBM 點閱率 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmClicks - DBM 點擊總數 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmConversions - DBM 轉換總數 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmCost - DBM 費用 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmImpressions - DBM 曝光總數 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 指標 - ga:dbmROAS - DBM 廣告投資報酬率 (僅限 Analytics (分析) 360,必須與 DBM 整合)。
  • 維度 - ga:dsAdGroup - DS 廣告群組 (僅限 Analytics (分析) 360,需要與 DS 整合)。
  • 維度 - ga:dsAdGroupId - DS 廣告群組 ID (僅限 Analytics (分析) 360,需要與 DS 整合)。
  • 維度 - ga:dsAdvertiser - DS 廣告主 (僅限 Analytics (分析) 360,需要與 DS 整合)。
  • 維度 - ga:dsAdvertiserId - DS 廣告主 ID (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • 維度 - ga:dsAgency - DS 代理商 (僅限 Analytics (分析) 360,需要與 DS 整合)。
  • 維度 - ga:dsAgencyId - DS 代理商 ID (僅限 Analytics (分析) 360,需要與 DS 整合)。
  • 維度 - ga:dsCampaign - DS 廣告活動 (僅限 Analytics (分析) 360,需要與 DS 整合)。
  • 維度 - ga:dsCampaignId - DS 廣告活動 ID (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • 維度 - ga:dsEngineAccount - DS 引擎帳戶 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • 維度 - ga:dsEngineAccountId - DS 引擎帳戶 ID (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • 維度 - ga:dsKeyword - DS 關鍵字 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • 維度 - ga:dsKeywordId - DS 關鍵字 ID (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsCPC - 廣告主的每次點擊費用 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsCTR - DS 點閱率 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsClicks - DS 點擊 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsCost - DS 費用 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsImpressions - DS 曝光 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsProfit - DS Profie (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsReturnOnAdSpend - DS 廣告投資報酬率 (僅限 Analytics (分析) 360,必須與 DS 整合)。
  • ga:dsRevenuePerClick - DS 單次點擊收益 (僅限 Analytics (分析) 360,必須與 DS 整合)。

這個版本會在 API 中加入新維度,如需完整的定義清單,請參閱維度和指標參考資料

交易 ID

  • 維度 - mcf:transactionId - 購物車中購物的交易 ID,由電子商務追蹤方式提供。

這個版本會在 API 中加入新維度,此外,這個版本也針對可同時競爭的維度組合增設特定限制。如需完整的定義清單,請參閱維度和指標參考文件

地理位置網路

  • 維度 - ga:continentId - 根據使用者的 IP 位址或地理區域 ID 推算的使用者洲別 ID。

限制

下列群組中的下列維度無法與其他群組中的維度一併使用:

  • 前往購物資訊群組
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO 實驗群組
    • ga:experimentVariant
    • ga:experimentId
  • 興趣群組
    • ga:interestOtherCategory
  • 市場興趣群組
    • ga:interestInMarketCategory
  • 內部促銷活動群組:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • 品牌興趣群組:
    • ga:interestAffinityCategory

這個版本推出新的限制和配額。詳情請參閱限制與配額說明文件。

回報錯誤

這個版本開始針對失敗的 (5XX) 報表要求強制執行限制。

  • 每項設定檔每小時 10 個失敗的要求。
  • 每個設定檔每天每項專案 50 個失敗的要求。

資料透視限制

這個版本開始對資料透視要求強制執行限制:

  • 一個報表要求現在最多可有 2 個資料透視
  • 資料透視最多可以有 4 個維度
  • 資料透視維度是要求中允許維度總數的一部分。
  • 資料透視metrics是要求中允許的指標總數限制的一部分。

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考文件

地理位置網路

  • 維度 - ga:metroId - 流量來源的三位數指定行銷區域 (DMA) 代碼,衍生自使用者的 IP 位址或地理區域 ID。

DoubleClick for Publishers

  • 指標 - ga:dfpImpressions - 每當網站上顯示個別廣告,系統就會記錄一次 DFP 廣告曝光。舉例來說,如果網頁上有兩個廣告單元,而使用者瀏覽了該網頁一次,就會顯示兩次曝光 (已啟用 DFP 連結和隱藏 DFP 收益功能)。
  • 指標 - ga:dfpCoverage - 涵蓋率是指有多少百分比的廣告請求傳回了至少一則廣告。一般來說,涵蓋率有助於找出 DFP 帳戶無法放送指定廣告的網站。(廣告曝光次數 / 廣告請求總數) * 100 (已啟用 DFP 連結並隱藏 DFP 收益)。」
  • 指標 - ga:dfpMonetizedPageviews:用來評估在已連結 DFP 帳戶中放送廣告時,該資源的總瀏覽量。請注意,一個網頁可以有多個廣告單元 (已啟用 DFP 連結和隱藏 DFP 收益的功能)。
  • 指標 - ga:dfpImpressionsPerSession - DFP 廣告曝光次數與 Analytics (分析) 工作階段數的比率 (廣告曝光次數 / Analytics (分析) 工作階段數) (已啟用 DFP 連結並隱藏 DFP 收益)。
  • 指標 - ga:dfpViewableImpressionsPercent:可視廣告曝光次數的百分比。如果曝光出現在使用者的瀏覽器中,並且有機會顯示 (已啟用 DFP 連結和隱藏 DFP 收益),就算是可視曝光。」
  • 指標 - ga:dfpClicks - 網站中 DFP 廣告的點擊次數 (已啟用 DFP 連結並隱藏 DFP 收益)。
  • 指標 - ga:dfpCTR:促成 DFP 廣告點擊的網頁瀏覽次數百分比 (已啟用 DFP 連結並隱藏 DFP 收益)。
  • 指標 - ga:dfpRevenue - DFP 收益是根據已放送的曝光次數 (已啟用 DFP 連結和隱藏 DFP 收益) 估算出的總廣告收益。」
  • 指標 - ga:dfpRevenuePer1000Sessions:每 1,000 個 Analytics (分析) 工作階段帶來的 DFP 廣告預估總收益。請注意,這項指標的依據是網站的工作階段,而不是廣告曝光次數 (已啟用 DFP 連結和隱藏 DFP 收益)。
  • 指標 - ga:dfpECPM:有效每千次網頁瀏覽費用。這是指每 1,000 次網頁瀏覽的 DFP 收益 (已啟用 DFP 連結並隱藏 DFP 收益)。
  • 指標 - ga:backfillImpressions - 候補廣告曝光次數是所有透過 DFP 當做候補廣告放送的 AdSense 或廣告展示廣告曝光次數總和。每當有個別廣告在網站上顯示,系統就會記錄一次廣告曝光。舉例來說,如果網頁上有兩個廣告單元,而使用者瀏覽了該網頁一次,就會顯示兩次曝光 (已啟用 DFP 連結和隱藏 DFP 收益功能)。
  • 指標 - ga:backfillCoverage - 候補廣告涵蓋率是指有多少百分比的候補廣告廣告請求傳回了至少一則廣告。一般來說,涵蓋率有助於找出發布商帳戶無法放送指定廣告的網站。(廣告曝光次數 / 廣告請求總數) * 100。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的加權平均值。」
  • 指標 - ga:backfillMonetizedPageviews:用來評估該資源總共包含來自已連結候補廣告帳戶中的至少一則廣告時,該資源總共獲得多少網頁瀏覽量。請注意,一次營利網頁瀏覽可能包含多次廣告曝光 (已啟用 DFP 連結和隱藏 DFP 收益功能)。
  • 指標 - ga:backfillImpressionsPerSession:候補廣告曝光次數與 Analytics (分析) 工作階段數的比率 (廣告曝光次數 / Analytics (分析) 工作階段數)。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的總和。」
  • 指標 - ga:backfillViewableImpressionsPercent - 候補廣告曝光中可見的百分比。使用者有可能在瀏覽器中看到的曝光,就算是可視曝光。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的加權平均值。」
  • 指標 - ga:backfillClicks:在網站上點按候補廣告的次數。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的總和。」
  • 指標 - ga:backfillCTR:促成廣告點擊的候補廣告曝光百分比。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的加權平均值。」
  • 指標 - ga:backfillRevenue:候補廣告帶來的預估總收益。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的總和。」
  • 指標 - ga:backfillRevenuePer1000Sessions:每 1,000 個 Analytics (分析) 工作階段的候補廣告預估總收益。請注意,這項指標的計算依據是網站的工作階段,而不是廣告曝光次數。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的總和。」
  • 指標 - ga:backfillECPM:有效每千次網頁瀏覽費用。這就是每 1,000 次網頁瀏覽的 DFP 候補廣告收益。如果 AdSense 和 Ad Exchange 都提供候補廣告,這項指標就會是兩個候補廣告帳戶 (已啟用 DFP 連結和隱藏 DFP 收益) 的總和。」

這個版本新增了 addedInApiVersion 屬性。

已新增至 API 版本

  • addedInApiVersion 是一個數值屬性,可用於檢查資料欄是否可在指定版本的 Reporting API 中使用;詳情請參閱 Metadata API - 開發人員指南

這個版本會推出新版 API,即 Analytics Reporting API 第 4 版。這種全新的 API 是最先進的程式輔助方法,可用來存取 Google Analytics (分析) 報表資料。

主要功能

Google Analytics (分析) 以強大的資料報表基礎架構為基礎,透過這個 API,開發人員可使用 Google Analytics (分析) 平台的強大功能。Analytics (分析) Reporting API 第 4 版中的部分重要功能包括:

  • 指標運算式 - API 可讓您要求內建指標及數學指標運算式。舉例來說,每工作階段的目標達成數可在請求中以 ga:goal1completions/ga:sessions 表示。
  • 多個日期範圍 - 支援要求兩個日期範圍,以便在單一要求中比較兩個時段的資料。
  • 同類群組和生命週期價值:API 具備豐富的詞彙,可用來索取同類群組和生命週期價值報表。
  • 多個區隔 - 您現在可以在單一要求中請求多個區隔。

入門課程

如要進一步瞭解如何開始使用這個 API,請參閱開發人員文件

配額政策

Analytics Reporting API 第 4 版有其配額與限制,由於這是新的 API,這些限制和配額隨時可能會有所變動。

遷移

除了遷移指南外,我們也在 GitHub 上提供 Python 相容性程式庫

維度和指標

此外,這個版本也加入了 Analytics (分析) Reporting API 第 4 版專用的維度和指標。如需完整的清單定義,請參閱維度和指標多層檢視一文。

  • 維度 - ga:cohort:根據同類群組定義,為使用者所屬的同類群組名稱。視同類群組的定義而定,使用者可以同時屬於多個同類群組,類似於使用者可屬於多個區隔的方式。

  • 維度 - ga:cohortNthDay - 以 0 天為單位的偏移量 (相對於同類群組定義日期)。舉例來說,如果同類群組的首次造訪日期為 2015 年 9 月 1 日,則日期 2015 年 9 月 4 日的 ga:cohortNthDay 會是 3。

  • ga:cohortNthMonth - 相對於同類群組定義日期的 0 個月補償。

  • 維度 - ga:cohortNthWeek - 0 週與同類群組定義日期的相對偏移值。

  • 維度 - ga:acquisitionTrafficChannel - 招攬到使用者的流量管道。系統會從使用者的第一個工作階段擷取出來。流量管道是根據使用者開發時的預設管道分組規則 (如有在資料檢視層級) 計算得出。

  • 維度 - ga:acquisitionSource - 招攬到使用者的來源。衍生自使用者的第一個工作階段。

  • 維度 - ga:acquisitionMedium - 招攬到使用者的媒介。衍生自使用者的第一個工作階段。

  • 維度 - ga:acquisitionSourceMedium - ga:user 獲取 Source 和 ga:CPAMedium 的總值。

  • 維度 - ga:acquisitionCampaign 招攬到使用者的廣告活動。衍生自使用者的第一個工作階段。

  • 指標 - ga:cohortActiveUsers - 這項指標與 0 開始的偏移維度 (ga:cohortNthDayga:cohortNthWeekga:cohortNthMonth) 相關,代表同類群組第 n 天/週/月的同類群組中活躍的使用者人數。例如,以 ga:cohortNthWeek = 1 為例,代表第二週的活躍使用者人數 (同類群組)。如果要求不含任何 ga:cohortNthDayga:cohortNthWeekga:cohortNthMonth,這項指標的值就會與 ga:cohortTotalUsers 相同。

  • 指標 - ga:cohortTotalUsers:屬於同類群組的使用者人數,也稱為同類群組規模。

  • 指標 - ga:cohortAppviewsPerUser - 同類群組中每位使用者的應用程式瀏覽次數。

  • 指標 - ga:cohortGoalCompletionsPerUser - 同類群組中每位使用者的目標達成數。

  • 指標 - ga:cohortPageviewsPerUser:同類群組的每位使用者網頁瀏覽量。

  • 指標 - ga:cohortRetentionRate - 同類群組留存率。

  • 指標 - ga:cohortRevenuePerUser:同類群組每位使用者的收益。

  • 指標 - ga:cohortVisitDurationPerUser:每個同類群組的工作階段持續時間。

  • 指標 - ga:cohortSessionsPerUser:特定同類群組每位使用者的工作階段數。

  • 指標 - ga:cohortTotalUsersWithLifetimeCriteria - 這與包含 ga:acquisitionTrafficChannelga:acquisitionSourcega:acquisitionMediumga:acquisitionCampaign 維度的要求相關。代表同類群組中透過目前管道、來源、媒介或廣告活動招攬到的使用者人數。舉例來說,ga:acquisitionTrafficChannel=Direct 代表同類群組中直接招攬到的使用者人數。如果上述維度都不存在,則表示其值等於 ga:cohortTotalUsers

  • 指標 - ga:cohortAppviewsPerUserWithLifetimeCriteria - 同類群組獲客維度的每位使用者應用程式瀏覽次數。

  • 指標 - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria:同類群組獲客維度的每位使用者目標達成數。

  • 指標 - ga:cohortPageviewsPerUserWithLifetimeCriteria - 同類群組獲客維度的每位使用者網頁瀏覽量。

  • 指標 - ga:cohortRevenuePerUserWithLifetimeCriteria:同類群組客戶開發維度的每位使用者收益。

  • 指標 - ga:cohortSessionsPerUserWithLifetimeCriteria:同類群組獲客維度的每位使用者工作階段持續時間。

社交資料中心的維度和指標已淘汰,只會記錄 2016 年 4 月 30 日之後的歷來資料報表,之後就不會再顯示新資料。根據資料淘汰政策,這些維度和指標將在 2016 年 9 月 30 日後移除。

如需完整的定義清單,請參閱維度和指標參考文件

社交活動

這些維度和指標已不適用,將在 2016 年 9 月 30 日後移除。請參閱資料淘汰政策,進一步瞭解資料移除作業:

  • 維度 - ga:socialActivityEndorsingUrl - 如果是社交資料中心活動,這是社交活動的網址 (例如 Google+ 訊息網址、網誌留言網址等)。
  • 維度 - ga:socialActivityDisplayName - 若是社群資料中心活動,這是指社群網路使用者張貼的社交活動標題。
  • 維度 - ga:socialActivityPost - 如果是社群資料中心活動,這是指社群網路使用者發布的社交活動內容 (例如在 Google+ 張貼的訊息內容)。
  • 維度 - ga:socialActivityTimestamp:如果是社群資料中心活動,這是指社交活動在社群網路上發生的時間。
  • 維度 - ga:socialActivityUserHandle - 如果是社群資料中心活動,這是指啟動社交活動的使用者在社交網路控制代碼 (例如名稱或 ID)。
  • 維度 - ga:socialActivityUserPhotoUrl - 如果是社交資料中心活動,這是指使用者社交網路個人資料所連結的相片網址。
  • 維度 - ga:socialActivityUserProfileUrl:如果是社交資料中心活動,這是相關使用者的社交網路個人資料網址。
  • 維度 - ga:socialActivityTagsSummary - 如果是社群資料中心活動,這是與社交活動相關的一組代碼,以半形逗號分隔。
  • 維度 - ga:socialActivityAction - 如果是社交資料中心活動,這代表與活動相關的社交動作類型 (例如投票、留言、+1 等),
  • 維度 - ga:socialActivityNetworkAction:如果是社群資料中心活動,這是指社交動作類型和帶來活動的社群網路。
  • 維度 - ga:socialActivityContentUrl:如果是社交資料中心活動,這是相關社交網路使用者分享的網址。
  • 指標 - ga:socialActivities:在社交資料中心夥伴聯播網上分享或提及內容網址的活動總數。

這個版本會在 API 中加入新維度,如需完整的定義清單,請參閱維度和指標參考文件

平台或裝置

  • 維度 - ga:browserSize:使用者瀏覽器的可視區域大小。瀏覽器大小是一種以工作階段為範圍的維度,會擷取可視區域的初始尺寸 (以像素為單位),且格式為「寬度 X 高度」。例如 1920x960。

這個版本會在 API 中加入新參數。

納入空白列

  • 這個版本加入了新的選用參數 include-empty-rows,當設為 false 列時,該列不含資料。預設值為 true,這是非破壞性變更,因此不需要更新程式碼。詳情請參閱 Core Reporting API 參考說明文件

這個版本會在 API 中加入新指標,如需完整的定義清單,請參閱維度和指標參考文件

使用者

  • 指標 - ga:1dayUsers:指定時間範圍內的每日 1 天活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度,才能查詢這項指標。以指定日期來說,傳回的值會是指定日期當天結束 1 天內的不重複使用者總數。
  • 指標 - ga:7dayUsers:在指定時間範圍內,每天 7 天的活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度,才能查詢這項指標。以指定日期來說,傳回的值會是指定日期前 7 天內的不重複使用者總數。
  • 指標 - ga:14dayUsers:在指定時間範圍內,每天 14 天的活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度,才能查詢這項指標。以指定日期來說,傳回的值會是指定日期當天結束的 14 天內不重複使用者總數。
  • 指標 - ga:30dayUsers:指定時間範圍內的每日 30 天活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度,才能查詢這項指標。在指定日期內,傳回的值會是指定日期前 30 天內的不重複使用者總數。

這個版本會在 API 中加入新指標,如需完整的定義清單,請參閱維度和指標參考文件

DoubleClick Ad Exchange (AdX)

  • 指標 - ga:adxCTR:促成 AdX 廣告點擊的網頁瀏覽量百分比。
  • 指標 - ga:adxClicks:您網站上的 AdX 廣告點擊次數。
  • 指標 - ga:adxCoverage - 涵蓋率是指有多少百分比的廣告請求傳回了至少一則廣告。一般來說,涵蓋率有助於找出 AdX 帳戶無法放送指定廣告的網站。(廣告曝光次數 / 廣告請求總數) * 100
  • 指標 - ga:adxECPM:有效每千次網頁瀏覽費用。這就是每 1,000 次網頁瀏覽的 AdX 收益。
  • 指標 - ga:adxImpressions - 每次有廣告在您的網站上顯示,系統就會記錄一次 AdX 廣告曝光。舉例來說,如果網頁上有兩個廣告單元,而使用者瀏覽了該網頁一次,就會顯示兩次曝光。
  • 指標 - ga:adxImpressionsPerSession - AdX 廣告曝光次數與 Analytics (分析) 工作階段數的比率 (廣告曝光次數 / Analytics (分析) 工作階段數)。
  • 指標 - ga:adxMonetizedPageviews -「營利網頁瀏覽」評估的是您資源上出現來自已連結 AdX 帳戶廣告的網頁瀏覽總次數。注意:單一網頁可以有多個廣告單元。
  • 指標 - ga:adxRevenue - AdX 廣告帶來的預估總收益。
  • 指標 - ga:adxRevenuePer1000Sessions - 每 1000 個 Analytics (分析) 工作階段的 AdX 廣告預估總收益。請注意,這個指標的計算方式是依照網站的工作階段,而不是廣告曝光。
  • 指標 - ga:adxViewableImpressionsPercent:可視廣告曝光的百分比。使用者有可能在瀏覽器中看到的曝光,就算是可見曝光。

這個版本淘汰了現有的維度或指標,如需完整的定義清單,請參閱維度和指標參考文件

已淘汰的維度

我們已淘汰這些維度。請參閱資料淘汰政策,進一步瞭解資料移除作業:

  • 維度 - ga:adSlotPosition - 請改用 ga:adSlot
  • 維度 - ga:nextPagePath - 請改用 ga:pagePath
  • 維度 - ga:nextContentGroupXX - 請改用 ga:contentGroupXX

這個版本會在 API 中加入新維度,如需維度和指標的完整清單,請參閱維度和指標參考文件

AdWords

  • 維度 - ga:adQueryWordCount:搜尋查詢中的字詞數量。

這個版本會在 API 中加入新維度,如需維度和指標的完整清單,請參閱維度和指標參考文件

平台或裝置

  • 維度 - ga:dataSource - 命中的資料來源。從 ga.js 和 analytics.js 傳送的命中會記錄為「網站」,而從行動 SDK 傳送的命中則會記錄為「應用程式」。這些值可能會遭到覆寫。
  • 維度 - ga:searchAfterDestinationPage:使用者在您的網站上執行內部搜尋後造訪的網頁。

以下為修正錯誤的版本:

  • 這個版本修正了在 Real Time Reporting API 查詢中強制執行篩選限制的問題。如果要求包含 rt:activeUsers 和事件層級維度的篩選器,會導致系統發生錯誤,並顯示 badRequest 原因及顯示 OR operator not supported for a hit level filter 的訊息。如要進一步瞭解查詢限制,請參閱《Real Time Reporting API 開發人員指南》。

這個版本會在 API 中加入新維度和指標,並淘汰兩項現有指標。如需完整的定義清單,請參閱維度和指標參考文件

ECommerce

  • 指標 - ga:transactionsPerUser:總交易次數除以使用者總人數。
  • 指標 - ga:revenuePerUser:交易中提供的總銷售收益 (不含運費和稅金) 除以使用者總人數。

使用者

  • 指標 - ga:sessionsPerUser:工作階段總數除以使用者總人數。

地理位置網路

  • 維度 - ga:cityId:使用者的城市 ID (衍生自 IP 位址或地理區域 ID)。
  • 維度 - ga:countryIsoCode - 使用者的國家/地區 ISO 代碼,衍生自 IP 位址或地理區域 ID。值的格式為 ISO-3166-1 alpha-2 代碼。
  • 維度 - ga:regionId:使用者的區域 ID (衍生自 IP 位址或地理區域 ID)。在美國,區域係指州,例如紐約州。  
  • 維度 - ga:regionIsoCode - 使用者的區域 ISO 代碼,衍生自 IP 位址或地理區域 ID。值的格式為 ISO-3166-2。
  • 維度 - ga:subContinentCode:使用者的子洲別代碼 (衍生自 IP 位址或地理區域 ID)。例如玻里尼西亞或北歐。值會以 UN M.49 代碼表示。

DoubleClick Campaign Manager

  • 指標 - ga:dcmROAS - DCM 廣告投資報酬率 (ROAS) (僅限 Premium)。

已淘汰的指標

這些指標已淘汰。請參閱資料淘汰政策,進一步瞭解資料移除作業:+ 指標 - ga:dcmROI - 請改用 ga:dcmROAS。+ 指標 - ga:dcmMargen - 請改用 ga:dcmROAS

這個版本會在 API 中加入新指標,並淘汰兩項現有指標。如需完整的定義清單,請參閱維度和指標參考資料

AdWords

  • 指標 - ga:ROAS - 廣告投資報酬率 (ROAS) 是指交易總收益和目標價值除以衍生的廣告費用。

已淘汰的維度和指標

已淘汰這些維度和指標。請參閱資料淘汰政策,進一步瞭解資料移除作業:+ 指標 - ga:ROI - 請改用 ga:ROAS。+ 指標 - ga:margin - 請改用 ga:ROAS

這個版本包含新維度。如需完整的定義清單,請參閱維度和指標參考文件

時間

  • 維度 - rt:minutesAgo:命中發生的時間 (分鐘)。

這個版本會在 API 中加入新指標,如需完整的定義清單,請參閱維度和指標參考資料

AdSense

  • 指標 - ga:adsenseCoverage:傳回至少一則廣告的廣告請求百分比,
  • 指標 - ga:adsenseViewableImpressionPercent:可見的曝光百分比。

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考資料

轉換路徑

  • 維度 - mcf:dcmAd - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) DCM 廣告名稱。
  • 維度 - mcf:dcmAdPath - DCM 廣告表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmAdType - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) DCM 廣告類型名稱。
  • 維度 - mcf:dcmAdvertiser - 與 Google Analytics (分析) 轉換相符 DCM 事件 (曝光或點擊) 的 DCM 廣告主名稱。
  • 維度 - mcf:dcmAdvertiserPath - DCM 廣告主表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmCampaign - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) DCM 廣告活動名稱。
  • 維度 - mcf:dcmCampaignPath - DCM 廣告活動表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmCreative - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) DCM 廣告素材名稱。
  • 維度 - mcf:dcmCreativePath - DCM 廣告素材表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmCreativeVersion - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) DCM 廣告素材版本。
  • 維度 - mcf:dcmCreativeVersionPath - 以 DCM 廣告素材版本表示互動的轉換路徑。
  • 維度 - mcf:dcmNetwork - 使用的聯播網。
  • 維度 - mcf:dcmPlacement - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 網站刊登位置名稱。
  • 維度 - mcf:dcmPlacementPath - DCM 刊登位置表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmSite - 針對與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊),顯示 DCM 廣告素材時顯示的 DCM 網站名稱。
  • 維度 - mcf:dcmSitePath - DCM 網站表示路徑上互動的轉換路徑。
  • 指標 - mcf:firstImpressionConversions:在 30 天回溯期內,DCM 廣告活動曝光為最初轉換互動的轉換次數。這個維度包含目標達成數和交易次數。
  • 指標 - mcf:firstImpressionValue:在 30 天的回溯期內,DCM 廣告活動曝光的最初轉換互動所帶來的轉換價值。這個維度包含目標達成數和交易次數。
  • 指標 - mcf:impressionAssistedConversions:在轉換路徑中出現 DCM 廣告活動曝光 (但並非最終轉換互動) 的轉換次數。這個維度包含目標達成數和交易次數。
  • 指標 - mcf:impressionAssistedValue:在轉換路徑上 (但不是最終轉換互動) 顯示 DCM 廣告活動曝光的轉換價值。這個維度包含目標達成數和交易次數。

這個版本包含全新的工作階段指標、新的流量來源維度,以及新的 DoubleClick Campaign Manager 維度和指標。

維度和指標

如需完整的定義清單,請參閱維度和指標參考文件

議程

  • 指標 - ga:hits - 傳送至 Google Analytics (分析) 的命中總數。這項指標會統計所有命中類型 (例如網頁瀏覽、事件、時間等)

流量來源

  • 維度 - ga:campaignCode - 使用手動廣告活動追蹤時,utm_id 廣告活動追蹤參數值的值。

DoubleClick Campaign Manager

  • 維度 - ga:dcmClickAd - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告名稱 (僅限 Premium)。
  • 維度 - ga:dcmClickAdId - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告 ID (僅限 Premium)。
  • 維度 - ga:dcmClickAdType - 與 Google Analytics (分析) 工作階段相符 (僅限 Premium) 的 DCM 點擊 DCM 廣告類型名稱。
  • 維度 - ga:dcmClickAdTypeId - 與 Google Analytics (分析) 工作階段相符 (僅限 Premium) 的 DCM 點擊 DCM 廣告類型 ID。
  • 維度 - ga:dcmClickAdvertiser - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告主名稱 (僅限 Premium)。
  • 維度 - ga:dcmClickAdvertiserId - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告主 ID (僅限 Premium)。
  • 維度 - ga:dcmClickCampaign - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告活動名稱 (僅限 Premium)。
  • 維度 - ga:dcmClickCampaignId - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告活動 ID (僅限 Premium)。
  • 維度 - ga:dcmClickCreative - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告素材名稱 (僅限 Premium)。
  • 維度 - ga:dcmClickCreativeId - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告素材 ID (僅限 Premium)。
  • 維度 - ga:dcmClickCreativeType - 與 Google Analytics (分析) 工作階段相符 (僅限 Premium) 的 DCM 點擊 DCM 廣告素材類型名稱。
  • 維度 - ga:dcmClickCreativeTypeId - 與 Google Analytics (分析) 工作階段相符 (僅限 Premium) 的 DCM 點擊 DCM 廣告素材類型 ID。
  • 維度 - ga:dcmClickCreativeVersion - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 廣告素材版本 (僅限 Premium)。
  • 維度 - ga:dcmClickRenderingId - 與 Google Analytics (分析) 工作階段相符 DCM 點擊的 DCM 顯示 ID (僅限 Premium)。
  • 維度 - ga:dcmClickSite - 顯示及點選 DCM 廣告素材時,且與 Google Analytics (分析) 工作階段相符 (僅限 Premium) 點擊的網站名稱。
  • 維度 - ga:dcmClickSiteId - DCM 網站 ID,顯示與 Google Analytics (分析) 工作階段 (僅限 Premium) 相符的 DCM 點擊所顯示和點選的 DCM 網站 ID。
  • 維度 - ga:dcmClickSitePlacement - 與 Google Analytics (分析) 工作階段相符 (僅限 Premium) 的 DCM 點擊 DCM 網站刊登位置名稱。
  • 維度 - ga:dcmClickSitePlacementId - 與 Google Analytics (分析) 工作階段 (僅限 Premium) 相符 DCM 點擊的 DCM 網站刊登位置 ID。
  • 維度 - ga:dcmClickSpotId - 與 Google Analytics (分析) 工作階段 (僅限 Premium) 相符 DCM 點擊的 DCM Floodlight 設定 ID。
  • 維度 - ga:dcmFloodlightActivity - 與 Floodlight 轉換相關聯的 DCM Floodlight 活動名稱 (僅限 Premium)。
  • 維度 - ga:dcmFloodlightActivityAndGroup - 與 Floodlight 轉換相關聯的 DCM Floodlight 活動名稱和群組名稱 (僅限 Premium)。
  • 維度 - ga:dcmFloodlightActivityGroup - 與 Floodlight 轉換相關聯的 DCM Floodlight 活動群組名稱 (僅限 Premium)。
  • 維度 - ga:dcmFloodlightActivityGroupId - 與 Floodlight 轉換相關聯的 DCM Floodlight 活動群組 ID (僅限 Premium)。
  • 維度 - ga:dcmFloodlightActivityId - 與 Floodlight 轉換相關聯的 DCM Floodlight 活動 ID (僅限 Premium)。
  • 維度 - ga:dcmFloodlightAdvertiserId - 與 Floodlight 轉換相關聯的 DCM Floodlight 廣告主 ID (僅限 Premium)。
  • 維度 - ga:dcmFloodlightSpotId - 與 Floodlight 轉換相關聯的 DCM Floodlight 設定 ID (僅限 Premium)。
  • 維度 - ga:dcmLastEventAd:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告名稱。
  • 維度 - ga:dcmLastEventAdId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告 ID。
  • 維度 - ga:dcmLastEventAdType:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告類型名稱。
  • 維度 - ga:dcmLastEventAdTypeId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告類型 ID。
  • 維度 - ga:dcmLastEventAdvertiser:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告主名稱。
  • 維度 - ga:dcmLastEventAdvertiserId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告主 ID。
  • 維度 - ga:dcmLastEventAttributionType - 有兩種可能的值 (ClickThrough 和 ViewThrough),如果與 Google Analytics (分析) 工作階段相關聯的最終 DCM 事件是點擊,這個值會是 ClickThrough。如果與 Google Analytics (分析) 工作階段相關聯的最終 DCM 事件是廣告曝光,這個值會是 ViewThrough (僅限 Premium)。
  • 維度 - ga:dcmLastEventCampaign:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告活動名稱。
  • 維度 - ga:dcmLastEventCampaignId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告活動 ID。
  • 維度 - ga:dcmLastEventCreative:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材名稱。
  • 維度 - ga:dcmLastEventCreativeId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材 ID。
  • 維度 - ga:dcmLastEventCreativeType:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材類型名稱。
  • 維度 - ga:dcmLastEventCreativeTypeId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材類型 ID。
  • 維度 - ga:dcmLastEventCreativeVersion:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材版本。
  • 維度 - ga:dcmLastEventRenderingId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 顯示 ID。
  • 維度 - ga:dcmLastEventSite - 與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 顯示和點選 DCM 廣告素材的網站名稱。
  • 維度 - ga:dcmLastEventSiteId - DCM 網站 ID,即與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 顯示和點選的 DCM 網站 ID。
  • 維度 - ga:dcmLastEventSitePlacement:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最終 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 網站刊登位置名稱。
  • 維度 - ga:dcmLastEventSitePlacementId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM 網站刊登位置 ID。
  • 維度 - ga:dcmLastEventSpotId:與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (在 DCM 回溯期內的曝光或點擊) 的 DCM Floodlight 設定 ID。
  • 指標 - ga:dcmFloodlightQuantity - DCM Floodlight 轉換次數 (僅限 Premium)。
  • 指標 - dcmFloodlightRevenue - DCM Floodlight 收益 (僅限 Premium)。

這個版本包含全新的內容分類維度和指標。

維度和指標

如需完整的定義清單,請參閱維度和指標參考文件

內容分類

  • 維度 - ga:landingContentGroupXX:使用者工作階段中第一個相符的內容群組。
  • 維度 - ga:nextContentGroupXX - 指的是其他內容群組之後造訪的內容群組,
  • 維度 - ga:contentGroupXX - 資源中的內容群組。內容分類是提供邏輯結構的內容集合,可由追蹤程式碼、網頁標題/網址規則運算式比對或預先定義的規則決定。
  • 維度 - ga:previousContentGroupXX - 是指在其他內容群組之前造訪的內容群組。
  • 指標 - ga:contentGroupUniqueViewsXX:針對指定內容群組,在一個工作階段中包含的不重複 (不重複) 網頁數量。系統會同時將 pagePath 和 pageTitle 列入考量,判斷不重複類別。

這個版本包含區隔的新 dateOfSession 條件,以及新的加強型電子商務維度和指標。

路段

區隔現在支援新的 dateOfSession 條件,可將區隔限制為在特定日期範圍內啟動工作階段的使用者群組。詳情請參閱《區隔開發人員指南》。

維度和指標

如需加強型電子商務的完整定義清單,請參閱維度和指標參考資料

加強型電子商務

  • 尺寸 - ga:internalPromotionCreative:專為促銷活動設計的廣告素材內容。
  • 維度 - ga:internalPromotionId:促銷活動所使用的 ID。
  • 維度 - ga:internalPromotionName:促銷活動的名稱。
  • 維度 - ga:internalPromotionPosition:促銷活動在網頁或應用程式畫面上的位置。
  • 維度 - ga:orderCouponCode - 訂單層級優待券的代碼。
  • 維度 - ga:productBrand - 產品的銷售品牌名稱。
  • 維度 - ga:productCategoryHierarchy - 產品的分類階層類別 (加強型電子商務)。
  • 維度 - ga:productCategoryLevelXX - 產品類別階層中的層級 (1-5),從頂端開始。
  • 維度 - ga:productCouponCode - 產品層級優待券的代碼。
  • 維度 - ga:productListName - 產品中顯示的產品清單名稱。
  • 維度 - ga:productListPosition - 產品在產品清單中的位置。
  • 維度 - ga:productVariant - 產品的具體變化版本,例如XS、S、M、L 等尺寸或紅色、藍色、綠色、黑色。
  • 維度 - ga:checkoutOptions - 結帳程序中指定的使用者選項,例如如選用 FedEx、DHL、UPS 或快遞提供的付款方式,或使用 Visa、MasterCard 和 AmEx 付款。這項維度應與購物階段搭配使用。
  • 維度 - ga:shoppingStage:使用者在工作階段內完成的各購物階段,例如「PRODUCT_VIEW」、「ADD_TO_CART」、「CheckOUT」等
  • 指標 - ga:internalPromotionCTR:使用者點閱內部宣傳活動時,點閱廣告的比率 (促銷活動點擊次數 / 促銷活動顯示次數)。
  • 指標 - ga:internalPromotionClicks:內部宣傳活動的點擊次數。
  • 指標 - ga:internalPromotionViews - 內部宣傳活動的觀看次數。
  • 指標 - ga:localProductRefundAmount - 以當地幣別購買特定產品的退款金額。
  • 指標 - ga:localRefundAmount - 以當地幣別計算的交易退款總金額。
  • 指標 - ga:productAddsToCart:產品加入購物車的次數。
  • 指標 - ga:productCheckouts:產品加入結帳流程的次數。
  • 指標 - ga:productDetailViews:使用者查看產品詳細資料頁面的次數。
  • 指標 - ga:productListClicks:當產品出現在產品清單中時,使用者點擊該產品的次數。
  • 指標 - ga:productListViews:產品出現在產品清單中的次數。
  • 指標 - ga:productListCTR:使用者點按產品清單中產品時的比率。
  • 指標 - ga:productRefunds:核發產品退款的次數。
  • 指標 - ga:productRefundAmount:與產品相關的退款總金額。
  • 指標 - ga:productRemovesFromCart:產品從購物車中移除的次數。
  • 指標 - ga:productRevenuePerPurchase - 每次購買的平均產品收益 (通常與「產品優待券代碼」搭配使用)。
  • 指標 - ga:buyToDetailRate - 不重複購買次數除以產品詳細資料頁面瀏覽次數。
  • 指標 - ga:cartToDetailRate - 產品新增次數除以產品詳細資料的瀏覽次數。
  • 指標 - ga:quantityAddedToCart:加入購物車的產品單位數量。
  • 指標 - ga:quantityCheckedOut - 結帳中列出的產品單位數量。
  • 指標 - ga:quantityRefunded - 已退款的產品單位數量。
  • 指標 - ga:quantityRemovedFromCart:從購物車中移除的產品單位數量。
  • 指標 - ga:refundAmount - 交易退款的貨幣金額。
  • 指標 - ga:totalRefunds:已核發退款的次數。

這個版本修正了欄標題名稱的錯誤,並新增維度和指標。

維度和指標

如需完整的定義清單,請參閱維度和指標參考文件

系統

  • 維度 - ga:sourcePropertyDisplayName - 綜覽資源的來源資源顯示名稱。這僅適用於綜覽資源。
  • 維度 - ga:sourcePropertyTrackingId - 綜覽資源的來源資源追蹤 ID。這僅適用於綜覽資源

管道分組

  • 維度 - ga:channelGrouping - 資料檢視 (設定檔) 中共用的預設管道分組。
  • 維度 - ga:correlationModelId:相關產品的關聯模型 ID。
  • 維度 - ga:queryProductId - 所查詢產品的 ID。
  • 維度 - ga:queryProductName - 所查詢產品名稱。
  • 維度 - ga:queryProductVariation - 所查詢產品的變化版本。
  • 維度 - ga:relatedProductId - 相關產品的 ID。
  • 維度 - ga:relatedProductName - 相關產品的名稱。
  • 維度 - ga:relatedProductVariation - 相關產品的變化版本。
  • 指標 - ga:correlationScore - 相關產品的關聯性分數。
  • 指標 - ga:queryProductQuantity - 所查詢產品的數量。
  • 指標 - ga:relatedProductQuantity - 相關產品的數量。

標題資料欄名稱修正

  • 2014-04-16 的版本有錯誤;如果您查詢了已淘汰的維度或指標,API 會傳回包含替代維度或指標的欄標題。現在,它可正確傳回請求中使用的維度或指標名稱。

這個版本包含 uiName 屬性的命名慣例異動。

變更 uiName

  • 範本資料欄的 uiName 屬性現在使用 XX 代表數字索引,而非 1。舉例來說,Goal 1 Value 現在是 Goal XX Value

這是 Embed API 的初始版本:

  • Google Analytics (分析) Embed API 是 JavaScript 程式庫,您只要花幾分鐘就能輕鬆建立資訊主頁,並嵌入第三方網站。詳情請參閱 Embed API 總覽
  • 內含元件:驗證、檢視選取器、資料和資料圖表。

這個版本包含淘汰 appUiName 屬性。請參閱資料淘汰政策,詳細瞭解移除屬性:

appUiName 淘汰

  • appUiName 已淘汰。中繼資料 API 不再需要這項設定,因為網頁和應用程式資料檢視 (設定檔) 的 UI 名稱已經過整合。您應移除使用 appUiName 屬性的所有程式碼,且只使用 uiName 屬性。

這個版本包括重新命名維度和指標。如需完整的定義清單,請參閱維度和指標參考文件

維度和指標重新命名

下列維度和指標已重新命名。請參閱資料淘汰政策,進一步瞭解如何重新命名資料:

使用者

  • 維度 - rt:visitorType - 請改用 rt:userType
  • 指標 - rt:activeVisitors - 改用 rt:activeUsers

這個版本包含新增及重新命名維度和指標。如需完整的定義清單,請參閱維度和指標參考文件

新的維度和指標

Core Reporting API 已新增下列維度:

AdWords

  • 維度 - ga:isTrueViewVideoAd - YesNo - 指出廣告是否為 AdWords TrueView 影片廣告。

時間

  • 維度 - ga:nthHour - 指定日期範圍內每小時的索引。日期範圍內第一天的索引 (例如開始日期) 是 0、1 代表下一個小時,依此類推。

維度和指標重新命名

所有以「訪客」和「造訪」為依據的維度和指標都已重新命名,改為使用「使用者」和「工作階段」

下列維度和指標已重新命名。請參閱資料淘汰政策,進一步瞭解如何重新命名資料:

適用對象

  • 維度 - ga:visitorAgeBracket - 請改用 ga:userAgeBracket
  • 維度 - ga:visitorGender - 請改用 ga:userGender

電子商務

  • 指標 - ga:transactionRevenuePerVisit - 改用 ga:transactionRevenuePerSession
  • 指標 - ga:transactionsPerVisit - 改用 ga:transactionsPerSession

事件追蹤

  • 指標 - ga:eventsPerVisitWithEvent - 改用 ga:eventsPerSessionWithEvent
  • 指標 - ga:visitsWithEvent - 改用 ga:sessionsWithEvent

目標轉換次數

  • 指標 - ga:goalValuePerVisit - 改用 ga:goalValuePerSession
  • 指標 - ga:percentVisitsWithSearch - 改用 ga:percentSessionsWithSearch
  • 指標 - ga:searchVisits - 改用 ga:searchSessions

網頁追蹤

  • 指標 - ga:pageviewsPerVisit - 改用 ga:pageviewsPerSession

議程

  • 維度 - ga:visitLength - 請改用 ga:sessionDurationBucket
  • 指標 - ga:avgTimeOnSite - 改用 ga:avgSessionDuration
  • 指標 - ga:timeOnSite - 改用 ga:sessionDuration
  • 指標 - ga:visitBounceRate - 改用 ga:bounceRate
  • 指標 - ga:visits - 改用 ga:sessions

社交互動

  • 維度 - ga:socialInteractionNetworkActionVisit - 請改用 ga:socialInteractionNetworkActionSession
  • 指標 - ga:socialInteractionsPerVisit - 改用 ga:socialInteractionsPerSession

使用者

  • 維度 - ga:daysSinceLastVisit - 請改用 ga:daysSinceLastSession
  • 維度 - ga:visitCount - 請改用 ga:sessionCount
  • 維度 - ga:visitorType - 請改用 ga:userType
  • 維度 - ga:visitsToTransaction - 請改用 ga:sessionsToTransaction
  • 指標 - ga:newVisits - 改用 ga:newUsers
  • 指標 - ga:percentNewVisits - 改用 ga:percentNewSessions
  • 指標 - ga:visitors - 改用 ga:users

區隔:Core Reporting API 2.4 版和 3.0 版

Core Reporting API 支援新區隔。

  • segment 參數現在支援使用者和序列區隔。在網頁介面中建立的使用者層級工作階段層級區隔,可使用 segment 參數進行查詢。
  • 新的動態區隔語法可與 segment 參數搭配使用。詳情請參閱區隔開發指南
  • dynamic:: 前置字串已淘汰。建議您盡快migrate新的語法。

已淘汰 ga: 個前置字元

所有即時維度和指標的 ga: 前置字元都已淘汰,並替換為新的 rt: 前置字元。使用 ga: 前置字串的 API 要求會繼續運作 6 個月,之後就會傳回錯誤。

新的維度和指標

這次更新會在 Real Time Reporting API 中加入新維度和指標。如需完整清單,請參閱維度和指標參考資料

事件追蹤

  • 維度 - rt:eventAction:事件的動作。
  • 維度 - rt:eventCategory - 事件的類別。
  • 維度 - rt:eventLabel - 事件的標籤。
  • 維度 - rt:totalEvents:所有類別中的設定檔事件總數。

目標追蹤

  • 維度 - rt:goalId - 與目標 ID 對應的字串。
  • 指標 - rt:goalXXValue - 所要求目標號碼的總數值,其中 XX 代表介於 1 到 20 之間的數字。
  • 指標 - rt:goalValueAll:為設定檔定義的所有目標的總數值。
  • 指標 - rt:goalXXCompletions:指定目標編號的達成總數,其中 XX 代表介於 1 到 20 之間的數字。
  • 指標 - rt:goalCompletionsAll:設定檔定義的所有目標的達成總數。

網頁追蹤

  • 指標 - rt:pageViews:網頁瀏覽次數的總次數。

應用程式追蹤

  • 指標 - rt:screenViews - 畫面瀏覽的總次數。

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考資料

轉換路徑

  • 維度 - mcf:adwordsCustomerIDPath - 轉換路徑中的 AdWords 客戶 ID 序列。

互動

  • 維度 - mcf:adwordsCustomerID - 對應 AdWords API Customer.id

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考資料

轉換路徑

  • 維度 - mcf:adwordsAdGroupIDPath:轉換路徑中的 AdWords 廣告群組 ID 序列。
  • 維度 - mcf:adwordsCampaignIDPath - 轉換路徑中的 AdWords 廣告活動 ID 序列。
  • 維度 - mcf:adwordsCreativeIDPath - 轉換路徑中的 AdWords 廣告素材 ID 序列。
  • 維度 - mcf:adwordsCriteriaIDPath - 轉換路徑中的 AdWords 條件 ID 序列。

互動

  • 維度 - mcf:adwordsAdGroupID - 對應 AdWords API AdGroup.id
  • 維度 - mcf:adwordsCampaignID - 對應 AdWords API Campaign.id
  • 維度 - mcf:adwordsCreativeID - 對應 AdWords API Ad.id
  • 維度 - mcf:adwordsCriteriaID - 對應 AdWords API Criterion.id

這個版本包含新的資料表回應格式,以及新增和淘汰維度和指標 (如需完整定義清單,請參閱維度和指標參考資料)。

資料表輸出內容

為了更輕鬆地使用 Google 圖表視覺化呈現 Google Analytics (分析) 資料,API 可以選擇在回應中傳回資料表物件。

  • API 已新增選用的 output 查詢參數。這個 ID 可用於在回應中選取 Analytics (分析) 資料的輸出格式 (預設為 JSON)。如果設為 datatable,則包含資料表物件的 dataTable 屬性會包含在回應中。這個物件可直接搭配 Google 圖表使用。詳情請參閱 Core Reporting API 參考資料

新的維度和指標

下列維度和指標已新增至 Core Reporting API:

時間

  • 維度 - ga:minute - 傳回小時中的分鐘。可能的值介於 0059 之間。
  • 維度 - ga:nthMinute - 指定日期範圍內每分鐘的索引。日期範圍內第一天 (例如開始日期) 的索引為 0,下一分鐘的索引為 1,依此類推。

適用對象

  • 維度 - ga:visitorAgeBracket - 訪客年齡層。
  • 維度 - ga:visitorGender - 訪客的性別。
  • 維度 - ga:interestAffinityCategory - 表示使用者較有可能想瞭解指定類別。
  • 維度 - ga:interestInMarketCategory - 表示使用者更有可能購買指定類別中的產品或服務。
  • 維度 - ga:interestOtherCategory - 代表使用者較有可能想瞭解指定類別,並更有可能準備購買。

區隔中允許的維度和指標

下列維度和指標現已可在區隔中使用:

  • 維度 - ga:sourceMedium - ga:sourcega:medium 的合併值。
  • 指標 - ga:localItemRevenue - 產品收益 (以當地幣別計算)。

已淘汰的維度和指標

已淘汰這些維度和指標。請參閱資料淘汰政策,進一步瞭解資料移除作業:

  • 維度 - ga:isMobile:請改用 ga:deviceCategory (例如ga:deviceCategory==mobile).
  • 維度 - ga:isTablet:請改用 ga:deviceCategory (例如ga:deviceCategory==tablet).
  • 指標 - ga:entranceBounceRate - 改用 ga:visitBounceRate

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考資料

AdSense

  • 已新增對 AdSense 資料的存取權:

    • Met - ga:adsenseRevenue - AdSense 廣告的總收益。
    • MET - ga:adsenseAdUnitsViewed:AdSense 廣告單元瀏覽次數。廣告單元是指在網站內加進一段 AdSense 廣告程式碼後,所顯示的一組廣告。詳情:https://support.google.com/adsense/answer/32715
    • 梅因 - ga:adsenseAdsViewed - AdSense 廣告瀏覽次數。一個廣告單元可以顯示多則廣告。
    • MEt - ga:adsenseAdsClicks:您網站上 AdSense 廣告的點擊次數。
    • MEt - ga:adsensePageImpressions - 顯示 AdSense 廣告的網頁瀏覽量。一次網頁曝光可以有多個廣告單元。
    • MET - ga:adsenseCTR:促成點擊 AdSense 廣告的網頁曝光次數百分比。(ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • MET - ga:adsenseECPM - 每千次網頁曝光的預估費用。這就是每 1,000 次網頁曝光的「AdSense 收益」。(ga:adsenseRevenue/(ga:adsensePageImpressions/1000)。
    • MET - ga:adsenseExits:因為使用者點擊 AdSense 廣告而結束的工作階段數。

時間

  • 調暗 - ga:isoYear - 造訪的 ISO 年。詳情:http://en.wikipedia.org/wiki/ISO_week_datega:isoYear 只能與 ga:isoWeek 搭配使用,因為 ga:week 代表公曆。
  • 調暗 - ga:isoYearIsoWeek - ga:isoYearga:isoWeek 的合併值。

AdWords

  • 您可在 AdWords 報表中找到以下資料:

    • 調暗 - ga:adKeywordMatchType - 套用至關鍵字的比對類型 (詞組比對、完全比對、廣泛比對)。詳細說明:解讀搜尋字詞報表

新的樣本大小控制項和相對日期功能

相對日期
  • MCF Reporting API 新增了相對日期的支援。todayyesterdayNdaysAgo 現在是 start-dateend-date 查詢參數的有效值。
  • 使用這些值會自動根據查詢時的目前日期以及查詢中指定的資料檢視 (設定檔) 時區,決定日期範圍。詳情請參閱 API 參考資料
取樣層級
  • 我們推出了新的參數 samplingLevel,可讓您設定報表查詢的取樣層級 (也就是用於計算結果的造訪次數)。有效值為 DEFAULTFASTERHIGHER_PRECISION
  • 在 API 回應中新增了 2 個欄位:sampleSizesampleSpace。您可以利用這些值,計算取樣回應使用的造訪次數百分比。
  • 詳情請參閱 API 參考資料取樣

新的樣本大小控制項和相對日期功能

相對日期
  • Core Reporting API 已新增相對日期的支援。todayyesterdayNdaysAgo 現在是 start-dateend-date 查詢參數的有效值。
  • 使用這些值會自動根據查詢時的目前日期以及查詢中指定的資料檢視 (設定檔) 時區,決定日期範圍。詳情請參閱 API 參考資料
取樣層級
  • 我們推出了新的參數 samplingLevel,可讓您設定報表查詢的取樣層級 (也就是用於計算結果的造訪次數)。有效值為 DEFAULTFASTERHIGHER_PRECISION
  • 在 API 回應中新增了 2 個欄位:sampleSizesampleSpace。您可以利用這些值,計算取樣回應使用的造訪次數百分比。
  • 詳情請參閱 API 參考資料取樣

這是 Metadata API 的初始版本:

  • Metadata API 會傳回 Google Analytics (分析) 報表 API 中顯示的維度和指標相關資訊。傳回的中繼資料包括使用者介面名稱、說明、進階區隔支援等屬性。只要使用 Metadata API,您的應用程式就能自動取得報表查詢相關維度和指標的最新資料。詳情請參閱 Metadata API 總覽

這是 Real Time Reporting API 的初始版本,僅提供部分測試版:

  • 您可以運用 Real Time Reporting API,針對目前在資源上發生的活動製作報表。你可以使用即時報表 API 查詢維度和指標,以便建立向客戶顯示的網頁小工具和資訊主頁。詳情請參閱 Real Time Reporting API 總覽

修正錯誤

  • ga:adwordsCustomerID 現在可正確傳回與 AdWords API AccountInfo.customerId 對應的 10 位數 AdWords 客戶 ID。修正完畢後,您就能將 Analytics (分析) 資料與多個 AdWords 帳戶合併。

隨著新區隔推出,我們將對 Core Reporting API 推出下列變更。

  • segment 參數現在支援自訂進階區隔的新英數字元 ID,這項資訊會在 Management API 區隔集合傳回。
  • 自訂區隔目前使用的數字 ID 現已淘汰。這些舊版 ID 會繼續支援 6 個月。我們建議應用程式儲存使用者區隔 ID,以便改用新的英數字元 ID。淘汰期結束後,所有使用舊數字 ID 的查詢都會傳回錯誤。
  • 目前,您只能透過 segment 參數查詢在網頁介面中建立的造訪層級區隔。
  • 現有的預設區隔使用負數數字 ID 則不受影響。但目前不支援新的預設區隔。

這個版本在 API 中加入了新維度和指標,如需完整的定義清單,請參閱維度和指標參考資料

應用程式追蹤

  • 這些資料位於應用程式設定檔報表中:
    • 調暗 - ga:appId - 應用程式的 ID。
    • 調暗 - ga:appInstallerId - 安裝程式的 ID (例如Google Play 商店)。根據預設,應用程式安裝工具 ID 是根據 PackageManager#getInstallerPackageName 方法設定。
    • 調暗 - ga:appName - 應用程式的名稱。
    • Dim - ga:appVersion - 應用程式的版本。
    • 調暗 - ga:exitScreenName - 使用者退出應用程式時的畫面名稱。
    • 調暗 - ga:landingScreenName - 查看的第一個畫面名稱。
    • 調暗 - ga:screenDepth - 以字串的形式記錄的單次工作階段畫面瀏覽次數。可用於長條圖。
    • 調暗 - ga:screenName - 畫面的名稱。
    • MET - ga:avgScreenviewDuration:使用者在畫面上停留的平均時間 (以秒為單位)。
    • MET - ga:timeOnScreen - 檢視目前畫面所花費的時間。
    • MET - ga:screenviews - 畫面瀏覽的總次數。請使用此 API 而不是 ga:appviews
    • MET - ga:uniqueScreenviews - 工作階段中的不同 (不重複) ga:screenviews 數量。請使用此 API 而不是 ga:uniqueAppviews
    • MET - ga:screenviewsPerSession - 每個工作階段的平均 ga:screenviews 數。請使用此 API 而不是 ga:appviewsPerVisit

已淘汰

下列指標已淘汰。請改用新的指標名稱。

  • MET - ga:appviews - 請改用 ga:screenviews
  • MET - ga:uniqueAppviews - 請改用 ga:uniqueScreenviews
  • MET - ga:appviewsPerVisit - 請改用 ga:screenviewsPerSession

自訂變數或自訂欄

  • 存取自訂維度和指標:

    • 調暗 - ga:dimensionXX - 要求的自訂維度名稱,其中 XX 代表自訂維度的數量/索引。
    • Met - ga:metricXX - 要求的自訂指標名稱,其中 XX 是指自訂指標的數量/索引。

說明文件變更

下列自訂變數維度與指標已重新命名。此文件僅變更,不需更新查詢。

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

電子商務

  • 調暗 - ga:currencyCode - 以 ISO 4217 標準為依據的交易當地幣別代碼。
  • 聯賽 - ga:localItemRevenue - 產品收益 (以當地幣別計算)。
  • 符合 - ga:localTransactionRevenue - 以當地幣別計算的交易收益。
  • 符合 - ga:localTransactionShipping - 以當地幣別計算的交易運費。
  • 符合 - ga:localTransactionTax - 以當地幣別計算的交易稅。

例外狀況

  • 這項資料來自例外狀況追蹤。
    • 調暗 - ga:exceptionDescription - 例外狀況的說明。
    • Met - ga:exceptionsPerScreenview - 擲回的例外狀況數量除以畫面瀏覽數。
    • MEt - ga:fatalExceptionsPerScreenview:將擲回的嚴重例外狀況數除以畫面瀏覽數。

目標轉換次數

  • 調暗 - ga:goalCompletionLocation - 符合任何實際連結類型目標達成的網頁路徑或畫面名稱。
  • 暗度 - ga:goalPreviousStep1 - 符合任何實際連結類型目標的網頁路徑或畫面名稱 (距離目標達成位置前一步驟)。
  • 暗度 - ga:goalPreviousStep2 - 符合任何實際連結類型目標的網頁路徑或畫面名稱 (距離目標達成位置前兩個步驟)。
  • 暗度 - ga:goalPreviousStep3 - 符合任何實際連結類型目標的網頁路徑或畫面名稱 (距離目標達成位置前三個步驟)。

說明文件變更

下列「目標轉換」維度和指標已重新命名。此文件僅變更,不需更新查詢。

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • 觸及 - ga:percentSearchRefinements:工作階段內內部搜尋關鍵字之間進行修正 (亦即轉換) 的次數百分比。

網頁追蹤

  • MET - ga:pageValue - 網頁或一組網頁的平均價值。「網頁價值」是指 (交易收益 + 目標總價值) 除以該網頁或一組網頁的不重複瀏覽量。

平台或裝置

  • 這項資料是從 HTTP 使用者代理程式字串衍生而來。

    • 調暗 - ga:deviceCategory - 裝置類型:電腦、平板電腦或手機。
    • 調暗 - ga:isTablet - 表示平板電腦訪客。可能的值為 YesNo
    • 調暗 - ga:mobileDeviceMarketingName - 行動裝置使用的行銷名稱。

社交互動

  • 這項資料來自網站社交互動追蹤。

    • 調暗 - ga:socialEngagementType - 參與類型。可能的值為 Socially EngagedNot Socially Engaged

時間

  • 調暗 - ga:dateHour - ga:datega:hour 的合併值。
  • 調暗 - ga:dayOfWeekName - 星期幾 (英文)。
  • 調暗 - ga:isoWeek - 每個 ISO 週數,每週從星期一開始。詳情:http://en.wikipedia.org/wiki/ISO_week_date
  • 調暗 - ga:yearMonth - ga:yearga:month 的合併值。
  • 調暗 - ga:yearWeek - ga:yearga:week 的合併值。

流量來源

  • 暗灰色 - ga:fullReferrer - 包含主機名稱和路徑的完整參照網址。
  • 調暗 - ga:sourceMedium - ga:sourcega:medium 的加總值。
  • 這個版本新增 2 個新的實驗指標:- ga:experimentId - ga:experimentVariant
  • 這個版本新增了 5 項網站速度指標:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • 這個版本會為平板電腦流量新增 gaid::-13 這個預設區隔。

這個版本在 API 中加入了新維度和指標,如需瞭解定義,請參閱維度和指標參考資料

應用程式追蹤

  • 您可以在行動應用程式追蹤 SDK 報表中找到這項資料:
    • MET - ga:uniqueAppviews - 每個工作階段的應用程式瀏覽次數。
    • MET - 'ga:appviews - 應用程式檢視的總次數。
    • MET - ga:appviewsPerVisit - 每個工作階段的平均應用程式瀏覽次數。

流量來源

  • 調暗 - ga:socialNetwork - 代表社群網路名稱的字串。這可能與流量來源的參照社群網路相關,或是與社群資料中心活動的社群網路相關。例如 Google+、Blogger、reddit 等。
  • 暗水 - ga:hasSocialSourceReferral - 表示透過社交來源 (如 Google+、Facebook、Twitter 等) 到達網站的造訪次數。可能的值為「Yes」或「No」,其中第一個字母必須大寫。

社交活動

  • 這項資料取自從社交資料中心夥伴匯入的站外活動。
    • 調暗 - ga:socialActivityDisplayName - 若是社群資料中心活動,這個字串代表社群網路使用者張貼的社交活動標題。
    • 暗化 - ga:socialActivityEndorsingUrl - 如果是社交資料中心活動,這個字串代表社交活動的網址 (例如 Google+ 訊息網址、網誌留言網址等)。
    • 暗化 - ga:socialActivityPost - 如果是社群資料中心活動,這個字串代表社群網路使用者張貼的社交活動內容 (例如 Google+ 貼文的訊息內容)
    • 調暗 - ga:socialActivityTimestamp - 以社群資料中心活動來說,這個字串代表社交活動在社群網路上發生的時間。
    • 調暗 - ga:socialActivityUserPhotoUrl - 如果是社交資料中心活動,這個字串代表與使用者社交網路個人資料相關聯的相片網址。
    • 暗色 - ga:socialActivityUserProfileUrl - 如果是社群資料中心活動,這個字串代表相關使用者的社群網路個人資料網址。
    • 暗色 - ga:socialActivityContentUrl - 若是社群資料中心活動,這個字串代表相關社群網路使用者分享的網址。
    • 調暗 - ga:socialActivityTagsSummary - 針對社交資料中心活動,這是一組與社交活動相關的代碼,以半形逗號分隔。
    • 暗色 - ga:socialActivityUserHandle - 如果是社群資料中心活動,這個字串代表啟動社交活動的使用者所屬社交網路帳號代碼 (即名稱)。
    • 調暗 - ga:socialActivityAction - 如果是社群資料中心活動,這個字串代表與活動相關的社交動作類型 (例如投票、留言、+1 等)。
    • 調暗 - ga:socialActivityNetworkAction - 若是社群資料中心活動,這個字串代表社交動作類型和發生活動的社群網路。
    • Met - ga:socialActivities - 在社交資料中心夥伴網路上分享/提及內容網址的活動數。

社交互動

  • 這項資料來自網站社交互動追蹤。
    • 暗化 - ga:socialInteractionAction - 針對社交互動,這個字串代表系統追蹤的社交動作 (例如 +1、喜歡、書籤)
    • Dim - ga:socialInteractionNetwork - 針對社群互動,這個字串代表系統追蹤的社群網路 (例如 Google、Facebook、Twitter、LinkedIn)
    • 暗化 - ga:socialInteractionNetworkAction - 針對社交互動,這個字串代表所追蹤 ga:socialInteractionNetworkga:socialInteractionAction 的串連 (例如 Google:+1、Facebook:讚)
    • 暗化 - ga:socialInteractionTarget - 針對社群互動,這個字串代表收到社群網路動作的網址 (或資源)。
    • MET - ga:socialInteractions - 網站上的社交互動總數。
    • MET - ga:uniqueSocialInteractions - 您網站上不重複社交互動的總數。根據值組合 ga:socialInteractionNetworkga:socialInteractionAction
    • 符合 - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions。每次造訪您網站的平均社交互動次數。

地理區域 / 聯播網

  • 調暗 - ga:metro - 流量來源的指定行銷區域 (DMA)。

網頁追蹤

  • 調暗 - ga:pagePathLevel1 - 這個維度會累計 pagePath 中第一階層的所有網頁路徑。
  • 調暗 - ga:pagePathLevel2 - 這個維度會累計 pagePath 中第二階層的所有網頁路徑。
  • 調暗 - ga:pagePathLevel3 - 這個維度會累計 pagePath 中第三個階層的所有網頁路徑。
  • 調暗 - ga:pagePathLevel4 - 這個維度會累計 pagePath 中第 4 層級的所有網頁路徑。pagePath 階層中的所有額外層級也會在這項維度中彙整。

例外狀況追蹤

  • 這項資料來自例外狀況追蹤資料。

    • Met - ga:exceptions - 傳送至 Google Analytics (分析) 的例外狀況數量。
    • Met - ga:fatalExceptions:isFatal 設為 true 的例外狀況數量。

使用者載入時間

  • 這項資料來源為使用者計時資料。

    • 調暗 - ga:userTimingCategory - 將所有使用者計時變數分類為邏輯群組的字串,便於製作報表。
    • 調暗 - ga:userTimingLabel - 用來表示所追蹤資源動作名稱的字串。
    • 調暗 - ga:userTimingVariable - 用於在報表中以視覺化方式呈現使用者時間的字串。
    • 調暗 - ga:userTimingValue 傳送至 Google Analytics (分析) 的經過毫秒數。
    • MEt - ga:userTimingSample:傳送的樣本數量。
    • MET - ga:avgUserTimingValue - 使用者平均花費時間。ga:userTimiingValue / ga:userTimiingSample

裝置 / 平台

  • 這項資料來自收集資料的使用者代理程式。
    • 調暗 - ga:mobileDeviceBranding - 行動製造商或品牌名稱 (例如 Samsung、HTC、Verizon、T-Mobile)。
    • 調暗 - ga:mobileDeviceModel - 行動裝置型號 (例如 Nexus S)
    • 調暗 - ga:mobileInputSelector - 行動裝置使用的選取器 (例如:觸控螢幕、搖桿、點擊滾輪、觸控筆)
    • Dim - ga:mobileDeviceInfo - 用來識別行動裝置的品牌、型號和行銷名稱。

這是「多管道漏斗 Reporting API」的初始版本:

  • 這個新的 API 可讓您要求已驗證使用者的「多管道漏斗」資料。資料來源為轉換路徑資料,其中顯示轉換前多次造訪中與各種流量來源的使用者互動。這可讓您分析多個行銷通路在一段時間內對轉換的影響。如要進一步瞭解可用的資料以及 API 的使用方式,請參閱 多管道漏斗 Reporting API

修正錯誤

  • 現在,這個 API 可正確處理篩選器或動態區隔中的 UTF-8 字元。

這個版本可讓 Google Analytics Premium 帳戶存取最多 50 個自訂變數。

這個版本修正了 2 個錯誤:

修正錯誤

  • 包含規則運算式的查詢篩選器不會再傳回伺服器錯誤。

  • 將指標篩選器與進階區隔合併使用時,不會再傳回錯誤。

這個版本在 API 中加入新的網站速度指標,

新指標

  • 並新增下列網站速度指標:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

如需瞭解定義,請參閱維度和指標參考資料

API 2.3 版淘汰提醒

  • Data Export API 2.3 版已淘汰 2 個月。這項服務將在大約 4 個月後停用,並僅支援新的 Core Reporting API 3.0 版2.4 版

  • 我們強烈建議您將應用程式遷移至 3.0 版。

  • 在 4 個月內,向舊版 2.3 XML 資料動態饋給提出要求,會轉送至 2.4 版,並傳回 2.4 版 XML 回應。屆時,所有 2.4 版本的配額政策都將套用至 2.3 版要求。

  • 針對 2.3 JSON 版本或使用 2.3 JSON 輸出的 Google Data JavaScript 用戶端程式庫的所有要求,都會傳回 404 狀態碼。

  • 如要獲得完整配額,3.0 版和 2.4 版都規定您必須在 Google API 控制台中註冊應用程式,並在每個要求中使用 API 金鑰 (或 OAuth 2.0 權杖)。

我們修正了 ga:visitLength 的小錯誤。這個維度現在傳回正確的資料。

此版本會影響所有 Google Analytics (分析) API 開發人員。它會公告兩個新版 API,應用程式必須註冊、導入新的配額政策,並將 API 名稱變更為 Core Reporting API。最後將淘汰現行的資料匯出 API 2.3 版。

3.0 版

  • Core Reporting API 3.0 版是 Google API 的最新主要版本,與舊版不相容。未來所有的 API 開發作業都將在這個版本中完成。

  • 新功能

  • 更新

    • 發出要求的新網址:https://www.googleapis.com/analytics/v3/data/ga…
    • 需要註冊和開發人員權杖。
    • 所有設定資料要求都應透過 Management API 完成。

2.4 版

  • Core Reporting API 2.4 版是子版本升級,與現行資料匯出 API 2.3 版回溯相容。

  • 更新

    • 提出要求的新網址:https://www.googleapis.com/analytics/v2.4/data…
    • 需要註冊和開發人員權杖。
    • XML 輸出與 2.3 版一致,因此其他現有的 Google Data 用戶端程式庫會繼續運作。
    • 配額錯誤的錯誤代碼已從 503 變更為 403
    • 系統不支援 JSON 回應。
    • 不支援 Google Data JavaScript 用戶端程式庫。
    • 沒有帳戶動態饋給。所有設定資料要求都應透過 Management API 完成。

註冊

  • 使用 Google Analytics API 建構的所有應用程式都必須透過 Google API 控制台註冊為專案。

  • 每個對 API 發出的要求都必須包含 API 金鑰或 OAuth 2.0,也就是用戶端 ID 和用戶端密碼。

配額政策

  • 下列配額適用於 Anlaytics API (Management API 和 Data Export API)

    • 每個專案每日 50,000 個要求
    • 每個 IP 位址每秒 10 次查詢 (QPS)
  • 下列配額適用於 Data Export API

    • 每個設定檔每天 10,000 個要求
    • 每個設定檔 10 個並行要求
  • 針對未註冊的應用程式,我們提供極低的寬限期,以便容納少量的測試。

淘汰項目

  • 此外,這個版本還宣布淘汰 2.3 版,以及即將停用資料匯出 API 中的「帳戶動態饋給」。6 個月後:

    • 傳送給 2.3 版 XML 資料動態饋給的要求會轉送至 2.4 版,並傳回 2.4 版回應。屆時,所有 2.4 版本的配額政策都將套用至 2.3 版要求。

    • 2.4 版的回應不支援傳送至 2.3 版 JSON 輸出的要求,且會傳回 404 Not Found 狀態碼。如果您需要 JSON 回應,請升級至 3.0 版。

    • 凡是在資料匯出 API 中向帳戶動態饋給發出的請求,都會傳回 404 Not Found 狀態碼。所有設定資料要求都應透過 Management API 完成。

此版本增加新的 AdWords 資料和更多 AdWords 維度和指標的組合。

  • AdWords 資料現在會在一小時內更新完成。資料每天更新之前。

  • 我們為 AdWords 資料放寬了有效的數字組合限制。

幾週前,我們變更為禁止使用 ga:impressions 要求 ga:adGroupga:adContent 的 API 查詢,因為這個組合傳回 0。經過這次異動後,我們現在回歸了這個組合並傳回正確的資料。

此版本修正了一些無效的維度和指標組合

修正無效指標/維度組合

  • 上個月,我們宣布即將對 API 進行一些調整,藉此禁止資料動態饋給中的某些無效查詢,不會傳回任何資料。我們已對 API 進行這些變更,下列組合現已失效:

    • 產品維度無法與交易指標合併。
    • ga:adContentga:adGroup 無法與 ga:impressions 合併使用。

    現在 API 不會傳回任何結果的回應,而是會針對要求這些組合的所有查詢傳回 400 錯誤代碼。

這個版本淘汰了指標中的信賴區間值。

淘汰信賴區間

  • 如果您尚未採用指標的信賴區間值,請先停止使用。在這個版本中,資料匯出 API 資料動態饋給會針對所有信賴區間值傳回 0.0。我們會在一個月左右期間從所有指標元素中完全移除這項屬性。

    如要判斷回應是否已取樣,請在回應中使用 includeSampledData 欄位。

這個版本加入了 3 個新指標,並更新兩個傳回值。

新資料更新

  • 我們為 API 新增了 3 項可處理網站速度效能的指標:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

指標更新

  • 如要在篩選器中指定貨幣值,您必須指定透過追蹤程式碼傳送的實際值 (例如,1 個單位現在會指定為 1)。

  • ga:CTR 現在會傳回實際百分比 (例如,將 2% 的值傳回為 2)。

這個版本改善了資料動態饋給的成效,並新增資料:

效能提升

  • 此版本將資料動態饋給的延遲時間縮短 30% 至 35%。

新資料更新

  • 我們更新了「進階區隔」可使用的維度和指標清單,請參閱更新後的清單,確認您的要求有效。

近期異動

  • 目前,您需要以微單位指定貨幣篩選器值 (例如,1 個貨幣單位指定為 1000000)。不久之後,您必須指定透過追蹤程式碼傳送的實際值 (例如,1 個單位現在會指定為 1)。

  • 目前,ga:CTRpercent,且會傳回值 0.02。在不久的未來,這個方法會改成傳回實際百分比 (例如 2)。

這個版本會在資料動態饋給中加入更多資料:

新資料更新

  • 已新增下列「時間」維度:ga:dayOfWeek

  • 已新增下列內部搜尋指標:ga:percentVisitsWithSearch

  • 已新增下列事件追蹤指標:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

近期異動

目前 API 會針對各種授權問題傳回 401 狀態碼。接下來幾週內,401 狀態只會用於無效權杖,讓開發人員能處理此特定例外狀況的錯誤。

這個版本為資料動態饋給增加更多資料:

新資料更新

  • ga:visitors 的計算已變更,以傳回指定日期範圍內的不重複訪客人數,且現在支援更多維度和指標組合。

  • 已新增 10 個 AdWords 維度:ga:adDistributionNetworkga:adMatchTypega:adMatchedQueryga:adPlacementDomainga:adPlacementUrlga:adFormatga:adTargetingTypega:adTargetingOptionga:adDisplayUrlga:adDestinationUrl

  • ga:organicSearches」指標已新增至廣告活動群組。

  • 已將「ga:searchResultViews」指標加入內部網站搜尋群組。

  • 已新增 3 個以時間為準的維度:ga:nthDayga:nthWeekga:nthMonth

  • 維度和指標分組經過調整,能更準確地反映兩者所代表的功能。

新的計算指標

以下計算指標衍生自使用基本指標的計算結果。注意:每個含 (n) 的名稱都支援值 1 至 20。

  • 以目標為導向:ga:costPerConversionga:costPerGoalConversionga:costPerTransactionga:goal(n)AbandonRatega:goal(n)Abandonsga:goal(n)ConversionRatega:goalAbandonRateAllga:goalAbandonsAllga:goalConversionRateAllga:goalValueAllPerSearchga:goalValuePerVisit

  • 內容式:ga:entranceBounceRatega:visitBounceRatega:entranceRatega:exitRatega:pageviewsPerVisitga:avgTimeOnPagega:avgTimeOnSitega:avgEventValue

  • 內部網站搜尋:ga:avgSearchDepthga:avgSearchDurationga:avgSearchResultViewsga:searchGoalConversionRateAllga:searchGoal(n)ConversionRatega:searchExitRate

  • 電子商務:ga:itemsPerPurchasega:marginga:percentNewVisitsga:revenuePerItemga:revenuePerTransactionga:ROIga:RPCga:totalValuega:transactionRevenuePerVisitga:transactionsPerVisit

這個版本新增了一項功能至資料動態饋給:

新功能

  • 新增的 XML 元素會讓使用者知道資料是否已取樣。true。無論資料是否已取樣,此元素一律會傳回 truefalse。Java 和 JavaScript 程式庫也已更新,提供用於存取此元素的輔助方法。

這個版本修正了 2 個錯誤:

修正錯誤

  • 先前在含有維度 (即ga:keyword==store,ga:keyword==bar) 所產生的值,可能會與單獨套用於多項查詢中的各個篩選器不同。這項問題已經解決,現在使用 OR 運算子會傳回一致的值。

  • 部分無效篩選器的 API 錯誤訊息已改為「不」納入錯誤是否為造成錯誤的維度或指標篩選器 (不過實際的違規篩選器運算式仍會傳回)。

這個版本修正 3 個錯誤:

修正錯誤

  • 已修正 JavaScript 用戶端程式庫的編碼問題。Analytics (分析) Issue Tracker

  • 先前設定錯誤,例如目標名稱、目標路徑、目標比較值或目標比較類型設定錯誤,會導致帳戶動態饋給無法傳回的錯誤。

  • 無效的資料動態饋給查詢篩選器參數中的「或」維度和指標。例如:ga:source==google,ga:visits>5。這個無效查詢的錯誤訊息已更新為:Cannot OR dimension filter(s) with metric filter

這個版本會新增資料並修正錯誤:

新功能

  • 新類別「D8. Adwords」新增了下列 5 個維度:

修正錯誤

  • 修正問題:如果其中一個設定檔的目標或步驟設定錯誤,帳戶動態饋給不會傳回資料。

這個版本加入了幾項新功能並修正了一項錯誤:

新功能

  • iPhone 預設區隔 (gaid::-11) 已經過強化,現在可放送所有行動裝置的報表。ID 與之前相同 (-11),但區隔名稱現在是:Mobile Traffic

  • API 採用的取樣率現在與網頁介面相同。如此一來,取樣報表的資料就會內嵌在網頁介面中,並提高兩者之間的一致性。

  • 已更新配額政策,確保所有使用者都能享有同等的資源存取權。詳情請參閱配額政策說明文件。新的政策如下:

    • 一個網站資源每 24 小時最多只能提出 10,000 個請求。
    • 應用程式在任何指定的 1 秒內只能提出 10 個要求。
    • 每個應用程式一次只能有 4 個待處理的要求。
  • 我們已放寬維度和指標組合的部分限制。ga:nextPagePathga:previousPagePath現已加入 D3. Content 群組。D8. Custom Variable 群組現已改稱 D6. Custom Variable 群組。請參閱這些新組合的新版參考指南

修正錯誤

  • 已修正 API 如何回報指標 confidenceInterval 值的錯誤。之前信賴區間的值為 INF 或介於 0 至 1 之間的數字。現在,所有信賴區間都會有 INF 的值,或是大於或等於 0 的數字。

  • ga:itemQuantityga:uniquePurchases 先前已替換並傳回彼此的值。並修正了問題,讓系統傳回正確的資料。

維度和指標淘汰提醒

  • 如果您尚未使用先前淘汰的維度和指標,請停止使用

這個版本加入了幾項新功能:

這個版本會將主要版本號碼增加為 2

  • 部分功能須使用最新的用戶端程式庫。我們正式支援:JavaJavaScript。第三方程式庫可能尚未更新。

    • 如要索取第 2 版,您可以在每個帳戶或資料動態饋給要求中加入 GData-Version: 2 標頭。詳情請參閱說明文件
    • 新的 XML 命名空間已同時新增至帳戶和資料動態饋給:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • 這個 API 現已支援 Google Data 通訊協定第 2 版

支援進階區隔

  • 動態區隔查詢參數:

    • ...&segment=dynamic::運算式
    • 能夠「即時」建立進階區隔。
    • 運算式可以是任何維度或指標,且必須遵守與篩選器相同的語法。
  • 預設和自訂區隔查詢參數:

    • ...&segment=gaid::數字
    • 其中數字代表 Google Analytics (分析) 網頁介面中定義的進階區隔。
    • 您可以在帳戶動態饋給中找到 ID。
  • 帳戶動態饋給會透過下列 XML 元素和屬性說明區隔資料:

    • ga:visitorType==Returning Visitor
  • 資料動態饋給也會提供 XML 元素,指出 API 要求中是否已套用區隔。

  • 若要進一步瞭解進階區隔,請參閱說明文件

有新的目標資料可用

  • 帳戶動態饋給提供的目的地和參與度類型目標:

  • 目標 5-20 已新增 48 個目標指標,全部都遵循 goal(n)Completions 慣例,其中 (n) 是介於 1 到 20 之間的數字。

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll」、「GoalStartsAll」和「GoalValueAll」已更新為說明新目標資料。

新增自訂變數資料

  • 每個設定檔收集的所有自訂變數都已新增為帳戶動態饋給的 XML 元素:

  • 自訂變數新增了 10 個維度。並且遵循 customVar(n) 慣例,其中 (n) 可以是介於 1 到 5 之間的數字。

    • ga:customVarName(n)
    • ga:customVarValue(n)

即將移除已淘汰的維度和指標!

  • 如果您尚未使用先前淘汰的維度和指標,請停止使用。我們會盡快移除這些限制,並視情況從 API 傳回錯誤。

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • 下列維度已重新命名:

    • ga:countOfVisits 現在是 ga:visitCount
    • ga:countOfVisitsToATransaction 現在是 ga:visitsToTransaction

此版本加入新功能,並淘汰部分舊功能:

  • 下列維度和指標現已淘汰。我們會在一個月內從 API 中永久移除這些元素。請務必更新您的程式碼,以免應用程式無法運作:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • 下列維度已重新命名:

    • ga:countOfVisits 現在是 ga:visitCount
    • ga:countOfVisitsToATransaction 現已更名為 ga:visitsToTransaction
  • 所有事件追蹤資料現在都會顯示為 2 個新群組:

    D7:事件 (維度) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7:事件 (指標) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • 整體網站瀏覽資料現在會透過下列維度顯示:

    D6:導覽 * ga:previousPagePath * ga:nextPagePath

  • 到達網頁導覽現在會透過下列維度顯示:

    D3:內容 * ga:landingPagePath * ga:secondPagePath

  • 資料動態饋給的篩選查詢參數中規則運算式的長度上限已從 32 個字元增加到 128 個字元。

  • 「造訪時間長度」報表 (在使用者介面的「訪客」->「訪客忠誠度」下可查看),現在則是透過新維度顯示:

    • ga:visitLength

這個版本更新 Google Analytics (分析) 資料匯出 API,如下所示:

  • 我們已放寬維度和指標組合的部分限制。您現在可以同時查詢大部分的內容和訪客層級維度,例如 ga:pagePathga:source 現在是有效的組合。請參閱新版參考指南,瞭解這些新組合:http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • 每項要求最多可要求的資料列總數已增加為 10,000 個。預設傳回的資料列數仍為 1,000 列,但現在可以透過設定 max-results 查詢參數來提高列數。

  • 帳戶動態饋給現在會為每個資料表 ID 傳回兩個新的資料元素 (貨幣和時區)。

  • 並強制規定資料查詢至少要包含一個有效指標。

  • 所有先前的淘汰異動已生效。

這個版本從非公開 Beta 版中移除已淘汰的功能:

  • 帳戶動態饋給要求將不再支援當中的使用者名稱。而只接受以下格式的要求:
    https://www.google.com/analytics/feeds/accounts/default

  • 下列指標即將移除且停止運作。不過,我們在以下網址提供瞭如何計算這些值的指示:http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • 下列維度和指標已重新命名。舊名稱將會失效。請確認您使用的是以下連結所列的正式名稱:http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    維度 * ga:subContinentRegion 篇 ga:subContinent * ga:organization 刪除您的 ga:networkLocation * ga:domain 刪除您的 ga:networkDomain * ga:visitNumber 資料保護 * ga:platform 提醒您 ga:operatingSystem * ga:platformVersion 歷

    指標 * ga:新訪客數 獲得 ga:newvisits * ga:pageDuration: 空格 前 篇