Changelog

如要查看 Google Analytics API 的官方公告，請訂閱 Google Analytics API 通知群組。

2024 年 10 月 20 日：新增 EmptyFilter 維度篩選條件類型

使用 EmptyFilter 維度篩選器，您可以建立篩選條件，與空白值進行比較。

2024 年 10 月 15 日：在 reportTasks 方法中新增取樣層級功能

您可以使用 properties.runReportTask 方法的 samplingLevel 欄位，控管報表的抽樣層級。

這項功能可讓 Google Analytics 360 資源使用高達 10 億筆事件的取樣上限。此外，如果未取樣的結果包含大量事件，可以設定取樣限制。UNSAMPLED

2024-09-18 新增「資源配額快照」功能

使用 properties.getPropertyQuotasSnapshot 方法，您可以取得特定資源的所有配額目前快照，並依配額類別整理。

2024 年 6 月 28 日：新增「每個資源的每個專案用戶端錯誤」配額

現在每個專案和資源在 15 分鐘內，最多只能發生 10,000 次 API 伺服器錯誤。這包括所有導致回應代碼不是 500 或 200 的要求。這項配額涵蓋的錯誤範例包括：使用不相容的維度和指標組合，以及所有驗證錯誤。

如果超過這項限制，系統會暫時封鎖相關聯 Google Cloud 專案對該資源的後續 API 呼叫，直到 15 分鐘的時段結束為止。

2024 年 5 月 14 日：新增比較功能

使用「比較」功能，即可對照評估不同的資料子集。

Data API v1beta 的核心報表方法已更新，可支援 comparisons 欄位。如果包含這個欄位，系統會指定所要求比較的設定。

在要求中，您可以提供含有要求的 dimensionFilter 運算式，指定基本比較，也可以在 comparison 欄位中提供比較資源名稱，使用已儲存的比較。

getMetadata 方法已更新，可列出資源在 comparisons 回應欄位中可用的所有已儲存比較項目。

如果在要求中指定至少一項比較，回應就會包含 comparison 欄，識別每項比較。

目前只能使用 Google Analytics 使用者介面建立已儲存的比較項目。

2024 年 5 月 8 日：在 Data API v1alpha 中新增報表工作，這項非同步報表功能。

您可以使用報表工作，啟動長時間執行的非同步要求，以建立 Google Analytics 事件資料的自訂報表。

Data API v1alpha 已新增下列報表工作操縱方法：

2024 年 5 月 6 日：重要事件的新維度

您現在可以查看重要事件的維度和指標。

請修改使用 isConversionEvent 維度的報表要求，改用 isKeyEvent 維度。

請修改所有使用下表「已淘汰指標」的報表要求，改用「重要事件指標」。

已淘汰的指標 重要事件指標
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

對報表要求中單一重要事件的重要事件指標，進行類似的修改。

properties/getMetadata 方法的回應會反映 DimensionMetadata 和 MetricMetadata 物件中導入的重要事件維度和指標，如下所示：

  • apiName、uiName 和 description 包含重要事件 API 名稱、使用者介面名稱和說明。
  • deprecatedApiNames 重複欄位含有已淘汰的轉換 API 名稱。

2024 年 3 月 25 日：新增主要管道群組、手動流量來源和整合專用維度。

主要管道群組、手動流量來源，以及 CM360、DV360、SA360 整合專用維度已新增至 Data API 結構定義。

目標對象維度：

  • audienceId目標對象 ID。目標對象的數字 ID。

主要管道群組維度：

  • firstUserPrimaryChannelGroup 最初招攬到使用者的主要管道群組

  • primaryChannelGroup 主要管道群組

  • sessionPrimaryChannelGroup 工作階段主要管道群組

手動流量來源維度：

  • manualCampaignId 手動廣告活動 ID

  • manualCampaignName 手動廣告活動名稱

  • manualCreativeFormat 手動廣告素材格式

  • manualMarketingTactic 手動行銷策略

  • manualMedium 手動媒介

  • manualSource 手動來源

  • manualSourceMedium 手動來源 / 媒介

  • manualSourcePlatform 手動來源平台

  • firstUserManualCampaignId 最初招攬到使用者的手動廣告活動 ID

  • firstUserManualCampaignName 最初招攬到使用者的手動廣告活動名稱

  • firstUserManualCreativeFormat 最初招攬到使用者的手動廣告素材格式

  • firstUserManualMarketingTactic 最初招攬到使用者的手動行銷策略

  • firstUserManualMedium 最初招攬到使用者的手動媒介

  • firstUserManualSource 最初招攬到使用者的手動來源

  • firstUserManualSourceMedium 最初招攬到使用者的手動來源 / 媒介

  • firstUserManualSourcePlatform 最初招攬到使用者的手動來源平台

  • sessionManualCampaignId 工作階段手動廣告活動 ID

  • sessionManualCampaignName 工作階段手動廣告活動名稱

  • sessionManualCreativeFormat 工作階段手動廣告素材格式

  • sessionManualMarketingTactic 工作階段手動行銷策略

  • sessionManualMedium 工作階段手動媒介

  • sessionManualSource 工作階段手動來源

  • sessionManualSourceMedium 工作階段手動來源 / 媒介

  • sessionManualSourcePlatform 工作階段手動來源平台

Campaign Manager 360 (CM360) 整合維度：

  • cm360AccountId CM360 帳戶 ID

  • cm360AccountName CM360 帳戶名稱

  • cm360AdvertiserId CM360 廣告主 ID

  • cm360AdvertiserName CM360 廣告主名稱

  • cm360CampaignId CM360 廣告活動 ID

  • cm360CampaignName CM360 廣告活動名稱

  • cm360CreativeFormat CM360 廣告素材格式

  • cm360CreativeId CM360 廣告素材 ID

  • cm360CreativeName CM360 廣告素材名稱

  • cm360CreativeType CM360 廣告素材類型

  • cm360CreativeTypeId CM360 廣告素材類型 ID

  • cm360CreativeVersion CM360 廣告素材版本

  • cm360Medium CM360 媒介

  • cm360PlacementCostStructure CM360 刊登位置計費方式

  • cm360PlacementId CM360 刊登位置 ID

  • cm360PlacementName CM360 刊登位置名稱

  • cm360RenderingId CM360 顯示 ID

  • cm360SiteId CM360 網站 ID

  • cm360SiteName CM360 網站名稱

  • cm360Source CM360 來源

  • cm360SourceMedium CM360 來源 / 媒介

  • firstUserCm360AccountId 最初招攬到使用者的 CM360 帳戶 ID

  • firstUserCm360AccountName 最初招攬到使用者的 CM360 帳戶名稱

  • firstUserCm360AdvertiserId 最初招攬到使用者的 CM360 廣告主 ID

  • firstUserCm360AdvertiserName 最初招攬到使用者的 CM360 廣告主名稱

  • firstUserCm360CampaignId 最初招攬到使用者的 CM360 廣告活動 ID

  • firstUserCm360CampaignName 最初招攬到使用者的 CM360 廣告活動名稱

  • firstUserCm360CreativeFormat 最初招攬到使用者的 CM360 廣告素材格式

  • firstUserCm360CreativeId 最初招攬到使用者的 CM360 廣告素材 ID

  • firstUserCm360CreativeName 最初招攬到使用者的 CM360 廣告素材名稱

  • firstUserCm360CreativeType 最初招攬到使用者的 CM360 廣告素材類型

  • firstUserCm360CreativeTypeId 最初招攬到使用者的 CM360 廣告素材類型 ID

  • firstUserCm360CreativeVersion 最初招攬到使用者的 CM360 廣告素材版本

  • firstUserCm360Medium 最初招攬到使用者的 CM360 媒介

  • firstUserCm360PlacementCostStructure 最初招攬到使用者的 CM360 刊登位置計費方式

  • firstUserCm360PlacementId 最初招攬到使用者的 CM360 刊登位置 ID

  • firstUserCm360PlacementName 最初招攬到使用者的 CM360 刊登位置名稱

  • firstUserCm360RenderingId 最初招攬到使用者的 CM360 算繪 ID

  • firstUserCm360SiteId 最初招攬到使用者的 CM360 網站 ID

  • firstUserCm360SiteName 最初招攬到使用者的 CM360 網站名稱

  • firstUserCm360Source 最初招攬到使用者的 CM360 來源

  • firstUserCm360SourceMedium 最初招攬到使用者的 CM360 來源 / 媒介

  • sessionCm360AccountId 工作階段 CM360 帳戶 ID

  • sessionCm360AccountName 工作階段 CM360 帳戶名稱

  • sessionCm360AdvertiserId 工作階段 CM360 廣告主 ID

  • sessionCm360AdvertiserName 工作階段 CM360 廣告主名稱

  • sessionCm360CampaignId 工作階段 CM360 廣告活動 ID

  • sessionCm360CampaignName 工作階段 CM360 廣告活動名稱

  • sessionCm360CreativeFormat 工作階段 CM360 廣告素材格式

  • sessionCm360CreativeId 工作階段 CM360 廣告素材 ID

  • sessionCm360CreativeName 工作階段 CM360 廣告素材名稱

  • sessionCm360CreativeType 工作階段 CM360 廣告素材類型

  • sessionCm360CreativeTypeId 工作階段 CM360 廣告素材類型 ID

  • sessionCm360CreativeVersion 工作階段 CM360 廣告素材版本

  • sessionCm360Medium 工作階段 CM360 媒介

  • sessionCm360PlacementCostStructure 工作階段 CM360 刊登位置計費方式

  • sessionCm360PlacementId 工作階段 CM360 刊登位置 ID

  • sessionCm360PlacementName 工作階段 CM360 刊登位置名稱

  • sessionCm360RenderingId 工作階段 CM360 顯示 ID

  • sessionCm360SiteId 工作階段 CM360 網站 ID

  • sessionCm360SiteName 工作階段 CM360 網站名稱

  • sessionCm360Source 工作階段 CM360 來源

  • sessionCm360SourceMedium 工作階段 CM360 來源 / 媒介

Google Display & Video 360 (DV360) 整合維度：

  • dv360AdvertiserId DV360 廣告主 ID

  • dv360AdvertiserName DV360 廣告主名稱

  • dv360CampaignId DV360 廣告活動 ID

  • dv360CampaignName DV360 廣告活動名稱

  • dv360CreativeFormat DV360 廣告素材格式

  • dv360CreativeId DV360 廣告素材 ID

  • dv360CreativeName DV360 廣告素材名稱

  • dv360ExchangeId DV360 廣告交易平台 ID

  • dv360ExchangeName DV360 廣告交易平台名稱

  • dv360InsertionOrderId DV360 廣告訂單 ID

  • dv360InsertionOrderName DV360 廣告訂單名稱

  • dv360LineItemId DV360 委刊項 ID

  • dv360LineItemName DV360 委刊項名稱

  • dv360Medium DV360 媒介

  • dv360PartnerId DV360 合作夥伴 ID

  • dv360PartnerName DV360 合作夥伴名稱

  • dv360Source DV360 來源

  • dv360SourceMedium DV360 來源 / 媒介

  • firstUserDv360AdvertiserId 最初招攬到使用者的 DV360 廣告主 ID

  • firstUserDv360AdvertiserName 最初招攬到使用者的 DV360 廣告主名稱

  • firstUserDv360CampaignId 最初招攬到使用者的 DV360 廣告活動 ID

  • firstUserDv360CampaignName 最初招攬到使用者的 DV360 廣告活動名稱

  • firstUserDv360CreativeFormat 最初招攬到使用者的 DV360 廣告素材格式

  • firstUserDv360CreativeId 最初招攬到使用者的 DV360 廣告素材 ID

  • firstUserDv360CreativeName 最初招攬到使用者的 DV360 廣告素材名稱

  • firstUserDv360ExchangeId 最初招攬到使用者的 DV360 廣告交易平台 ID

  • firstUserDv360ExchangeName 最初招攬到使用者的 DV360 廣告交易平台名稱

  • firstUserDv360InsertionOrderId 最初招攬到使用者的 DV360 廣告訂單 ID

  • firstUserDv360InsertionOrderName 最初招攬到使用者的 DV360 廣告訂單名稱

  • firstUserDv360LineItemId 最初招攬到使用者的 DV360 委刊項 ID

  • firstUserDv360LinteItemName 最初招攬到使用者的 DV360 委刊項名稱

  • firstUserDv360Medium 最初招攬到使用者的 DV360 媒介

  • firstUserDv360PartnerId 最初招攬到使用者的 DV360 合作夥伴 ID

  • firstUserDv360PartnerName 最初招攬到使用者的 DV360 合作夥伴名稱

  • firstUserDv360Source 最初招攬到使用者的 DV360 來源

  • firstUserDv360SourceMedium 最初招攬到使用者的 DV360 來源 / 媒介

  • sessionDv360AdvertiserId 工作階段 DV360 廣告主 ID

  • sessionDv360AdvertiserName 工作階段 DV360 廣告主名稱

  • sessionDv360CampaignId 工作階段 DV360 廣告活動 ID

  • sessionDv360CampaignName 工作階段 DV360 廣告活動名稱

  • sessionDv360CreativeFormat 工作階段 DV360 廣告素材格式

  • sessionDv360CreativeId 工作階段 DV360 廣告素材 ID

  • sessionDv360CreativeName 工作階段 DV360 廣告素材名稱

  • sessionDv360ExchangeId 工作階段 DV360 廣告交易平台 ID

  • sessionDv360ExchangeName 工作階段 DV360 廣告交易平台名稱

  • sessionDv360InsertionOrderId 工作階段 DV360 廣告訂單 ID

  • sessionDv360InsertionOrderName 工作階段 DV360 廣告訂單名稱

  • sessionDv360LineItemId 工作階段 DV360 委刊項 ID

  • sessionDv360LineItemName 工作階段 DV360 委刊項名稱

  • sessionDv360Medium 工作階段 DV360 媒介

  • sessionDv360PartnerId 工作階段 DV360 合作夥伴 ID

  • sessionDv360PartnerName 工作階段 DV360 合作夥伴名稱

  • sessionDv360Source 工作階段 DV360 來源

  • sessionDv360SourceMedium 工作階段 DV360 來源 / 媒介

Google Search Ads 360 (SA360) 整合維度：

  • firstUserSa360AdGroupId 最初招攬到使用者的 SA360 廣告群組 ID

  • firstUserSa360AdGroupName 最初招攬到使用者的 SA360 廣告群組名稱

  • firstUserSa360CampaignId 最初招攬到使用者的 SA360 廣告活動 ID

  • firstUserSa360CampaignName 最初招攬到使用者的 SA360 廣告活動

  • firstUserSa360CreativeFormat 最初招攬到使用者的 SA360 廣告素材格式

  • firstUserSa360EngineAccountId 最初招攬到使用者的 SA360 引擎帳戶 ID

  • firstUserSa360EngineAccountName 最初招攬到使用者的 SA360 引擎帳戶名稱

  • firstUserSa360EngineAccountType 最初招攬到使用者的 SA360 引擎帳戶類型

  • firstUserSa360KeywordText 最初招攬到使用者的 SA360 關鍵字文字

  • firstUserSa360ManagerAccountId 最初招攬到使用者的 SA360 管理員帳戶 ID

  • firstUserSa360ManagerAccountName 最初招攬到使用者的 SA360 管理員帳戶名稱

  • firstUserSa360Medium 最初招攬到使用者的 SA360 媒介

  • firstUserSa360Query 最初招攬到使用者的 SA360 查詢

  • firstUserSa360Source 最初招攬到使用者的 SA360 來源

  • firstUserSa360SourceMedium 最初招攬到使用者的 SA360 來源 / 媒介

  • sa360AdGroupId SA360 廣告群組 ID

  • sa360CampaignId SA360 廣告活動 ID

  • sa360AdGroupName SA360 廣告群組名稱

  • sa360CampaignName SA360 廣告活動

  • sa360CreativeFormat SA360 廣告素材格式

  • sa360EngineAccountId SA360 引擎帳戶 ID

  • sa360EngineAccountName SA360 引擎帳戶名稱

  • sa360EngineAccountType SA360 引擎帳戶類型

  • sa360KeywordText SA360 關鍵字文字

  • sa360ManagerAccountId SA360 管理員帳戶 ID

  • sa360ManagerAccountName SA360 管理員帳戶名稱

  • sa360Medium SA360 媒介

  • sa360Query SA360 查詢

  • sa360Source SA360 來源

  • sa360SourceMedium SA360 來源 / 媒介

  • sessionSa360AdGroupId 工作階段 SA360 廣告群組 ID

  • sessionSa360CampaignId 工作階段 SA360 廣告活動 ID

  • sessionSa360ManagerAccountId 工作階段 SA360 管理員帳戶 ID

  • sessionSa360ManagerAccountName 工作階段 SA360 管理員帳戶名稱

  • sessionSa360SourceMedium 工作階段 SA360 來源 / 媒介

2024 年 3 月 6 日：目標對象匯出功能支援無效使用者目標對象。

目標對象匯出功能可更完善地支援匯出不活躍使用者目標對象。 使用者無須符合特定事件條件即可加入這些目標對象，例如使用者只要七天未造訪您的網站，就能加入目標對象。閒置使用者目標對象的例子包括「7 天內未購物的使用者」、「7 天內未收到通知的使用者」和「7 天內未收到通知的使用者」。如要進一步瞭解這些建議目標對象，請參閱「建議目標對象」一文。

2024 年 2 月 28 日：目標對象匯出作業會傳回代碼中指定的使用者 ID。

即使資源已啟用「收集使用者提供的資料」功能，目標對象匯出作業現在也會傳回代碼中指定的使用者 ID。如果啟用「收集使用者提供的資料」功能，系統會在代碼中連同 User-ID 將使用者提供的資料傳送至 Google Analytics，以提升評估成效。詳情請參閱「收集使用者提供的資料」一文。

2024 年 1 月 30 日：在 Data API v1 Alpha 版中，支援目標對象名單和週期性目標對象名單的 Webhook 通知。

建立目標對象名單 (使用 properties.audienceLists.create) 或週期性目標對象名單 (使用 properties.recurringAudienceLists.create) 時，可以指定 AudienceList.webhookNotification 和 RecurringAudienceList.webhookNotification 欄位。

這項功能可讓您在目標對象名單可用時，非同步接收 Webhook 通知。

2024 年 1 月 18 日：改善包含查詢字串或分鐘元件的維度相容性。

包含查詢字串的維度現在與大多數欄位相容。 pagePathPlusQueryString、unifiedPageScreen、pageLocation 和 fullPageUrl 等維度現在可與許多其他欄位相容，包括 sessionSource、browser、city 和 landingPage。

包含分鐘部分的維度現在與大多數欄位相容。minute、nthMinute 和 dateHourMinute 等維度現在與一組類似的額外欄位相容。

如需完整的相容性資訊，請參閱 GA4 Dimensions & Metrics Explorer。

2023 年 12 月 13 日：以商品為範圍的自訂參數

您現在可以使用下列語法，在 Analytics Data API 查詢中加入以項目為範圍的自訂維度：

一般 API 名稱 說明
customItem:parameter_name 以商品為範圍的自訂維度 (參數名稱)

詳情請參閱 API 維度和指標。

2023 年 12 月 5 日：目標對象名單已在 Data API v1 Beta 版中以目標對象匯出功能的形式推出

「目標對象名單」功能已重新命名為「目標對象匯出」，並新增至 Data API v1 Beta 版。

在 Data API v1 Beta 版中新增下列方法：

2023 年 11 月 28 日：在報表回應中新增 samplingMetadatas

已將 samplingMetadatas 新增至 ResponseMetaData。這個集合會針對要求中結果經過取樣的每個日期範圍，包含一個 SampleMetadata。Google Analytics 只會在預期基數限制會降低資料品質時，才會套用取樣。

2023 年 11 月 28 日：在 Data API v1 Alpha 版中新增定期匯出目標對象名單的功能

在 Data API 第 1 版 Alpha 中新增 properties.recurringAudienceLists.create、properties.recurringAudienceLists.create、properties.recurringAudienceLists.list 方法。

這項功能可讓您在目標對象成員資格變更時，每天產生目標對象名單。定期更新目標對象名單，確保您使用的是最新的目標對象成員資格結果。

2023 年 10 月 13 日：新增支援再行銷效期為 1 天的目標對象

目標對象名單匯出功能現在支援會員效期為 1 天的目標對象。

2023 年 9 月 12 日：目標對象名單預設排序規則

根據預設，使用目標對象名單匯出功能建立的報表，會遵循與 Data API 其他報表方法相同的排序規則：先依第一欄遞減排序，再依第二欄遞減排序，依此類推。

這項異動前，您可能收到下列報表：

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

這項異動完成後，您會收到下列報表：

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

2023 年 8 月 15 日：在目標對象名單匯出架構中新增 isLimitedAdTracking 維度

  • isLimitedAdTracking 裝置的「限制廣告追蹤」設定。可能的值包括：true、false 和 (not set)。

    詳情請參閱「目標對象名單維度」一文。

2023 年 8 月 15 日：新增currencyCode維度、itemDiscountAmount指標

  • currencyCode 電子商務事件的當地貨幣代碼 (以 ISO 4217 標準為依據)。例如「USD」或「GBP」。

  • itemDiscountAmount 電子商務事件中商品折扣的金額。這項指標會在標記中由「discount」項目參數填入。

詳情請參閱「Data API 報表結構定義」。

2023 年 8 月 10 日：在目標對象名單匯出架構中新增 isAdsPersonalizationAllowed 維度

  • isAdsPersonalizationAllowed 是否允許廣告個人化。如果使用者符合看到個人化廣告的資格， isAdsPersonalizationAllowed 就會傳回 true。如果使用者不符合廣告個人化資格，isAdsPersonalizationAllowed會傳回 false。

    詳情請參閱「目標對象名單維度」一文。

2023-07-10 目標對象名單

資料 API v1 alpha 版新增目標對象名單支援。目標對象名單包含建立時目標對象中的使用者快照。

資料 API 第 1 版 Alpha 版新增了下列方法：

2023 年 5 月 19 日：自訂管道群組

Data API 新增自訂管道群組支援功能。

2023 年 5 月 11 日：代幣配額異動。

我們更新了 Data API 的配額系統，現在可以更精確地計算費用。

我們已根據配額變更調整每項要求收取的權杖數量，並重新平衡，讓您能執行更多簡單的報表查詢，但如果報表日期範圍較大，則會收取更多配額權杖。

這項異動生效後，部分要求的費用維持不變，但較複雜查詢的費用會明顯增加。舉例來說，要求超過 6 個月的資料可能會收取 1,000 個以上的配額權杖。

標準屬性

配額名稱 舊限制 新限制
每天每項資源的核心權杖 25,000 200,000
每項資源每小時的核心權杖數 5,000 40,000
每項專案每項資源每小時的核心權杖數 1,750 14,000
每項資源每天的即時權杖數 25,000 200,000
每小時每個房源的即時權杖 5,000 40,000
每項專案每項資源每小時的即時權杖數 1,750 14,000
每個資源每天的漏斗權杖數 25,000 200,000
每個資源每小時的漏斗權杖 5,000 40,000
每個資源每項專案每小時的漏斗權杖 1,750 14,000

Analytics 360 資源

配額名稱 舊限制 新限制
每天每項資源的核心權杖 250,000 2,000,000
每項資源每小時的核心權杖數 50,000 次 400,000
每項專案每項資源每小時的核心權杖數 17,500 140,000
每項資源每天的即時權杖數 250,000 2,000,000
每小時每個房源的即時權杖 50,000 次 400,000
每項專案每項資源每小時的即時權杖數 17,500 140,000
每個資源每天的漏斗權杖數 250,000 2,000,000
每個資源每小時的漏斗權杖 50,000 次 400,000
每個資源每項專案每小時的漏斗權杖 17,500 140,000

2023 年 3 月 2 日：新增日期維度。

  • dayOfWeekName星期幾名稱。星期幾 (英文)。這項維度的值包括 Sunday、Monday 等。

  • isoWeek一年中的 ISO 週次。ISO 週次，每週從星期一開始。詳情請參閱 https://en.wikipedia.org/wiki/ISO_week_date。範例值包括 01、02 和 53。

  • isoYear ISO 年度。活動的 ISO 年份。詳情請參閱 https://en.wikipedia.org/wiki/ISO_week_date。範例值包括 2022 和 2023。

  • isoYearIsoWeek ISO 年度的 ISO 週次。isoWeek 和 isoYear 的合併值。範例值包括 201652 和 201701。

  • yearMonth 年月。year 和 month 的合併值。範例值包括 202212 或 202301。

  • yearWeek年度與週數。year 和 week 的合併值。範例值包括 202253 或 202301。

2023 年 2 月 27 日：新增電子商務維度。

  • itemListPosition 商品清單位置。商品 (例如您銷售的產品) 在清單中的位置。這項維度會在標記中，由商品陣列的「index」參數填入。

  • itemLocationID 項目地區 ID。與商品相關聯的實體地點 (例如實體商店位置)。建議使用與關聯項目相應的 Google 地點 ID。您也可以使用自訂位置 ID。這個欄位會在標記時，由商品陣列中的「location_id」參數填入。

  • itemPromotionCreativeSlot 商品促銷廣告素材版位。與商品相關聯的促銷廣告素材版位名稱。您可以在事件或項目層級，透過 creative_slot 參數在標記中指定這項維度。如果事件和項目層級都有指定參數，系統會使用項目層級的參數。

2023 年 2 月 21 日：新增「到達網頁 + 查詢字串」維度。

  • landingPagePlusQueryString到達網頁 + 查詢字串。與工作階段中第一次網頁瀏覽相關聯的網頁路徑 + 查詢字串。

這個欄位取代了已淘汰的「landingPage」維度，並將於 2023 年 5 月 14 日更新，不再傳回查詢字串。

2023 年 1 月 28 日：新增「每個使用者的觀看次數」和「捲動使用者人數」指標。

  • screenPageViewsPerUser 每位使用者的觀看次數。每位活躍使用者瀏覽的應用程式畫面或網頁數量。重複瀏覽同一個網頁或畫面也會列入計算。(screen_view + page_view events) / active users。

  • scrolledUsers已捲動的使用者。至少向下捲動 90% 網頁的不重複使用者人數。

2023 年 1 月 23 日：新增「洲別」和「洲別 ID」維度。

  • continent 洲別。使用者活動的來源洲別。例如 Americas 或 Asia。

  • continentId洲別 ID。使用者活動來源洲別的地理 ID，衍生自使用者的 IP 位址。

2023 年 1 月 23 日：新增「測試資料篩選器 ID」維度。

  • testDataFilterId 測試資料篩選器 ID。處於測試狀態的資料篩選器 ID (數字)。您可以使用資料篩選器，在報表中根據事件參數值納入或排除事件資料。詳情請參閱 https://support.google.com/analytics/answer/10108813。

2022 年 10 月 18 日：新增 Google Ads 指標。

  • advertiserAdClicks 廣告點擊次數。使用者點按廣告觸及資源的總次數。
  • advertiserAdCost 廣告費用。您為廣告支付的總金額。
  • advertiserAdCostPerClick Google Ads 單次點擊出價。廣告單次點擊出價是廣告費用除以廣告點擊次數，通常簡稱為單次點擊出價。
  • advertiserAdCostPerConversion 單次轉換費用。 單次轉換費用是廣告費用除以轉換次數。
  • advertiserAdImpressions 廣告曝光次數。曝光總數。
  • returnOnAdSpend廣告投資報酬率。廣告投資報酬率 (ROAS) 是指總收益除以廣告主廣告費用。

2022 年 10 月 17 日：新增以商品為範圍的指標。

  • itemsAddedToCart 已將商品加入購物車。加入購物車的單一商品數量。
  • 已結帳 itemsCheckedOut 項商品。單一商品的結帳數量。
  • itemsClickedInList 清單中點選過的商品數。在清單中點選單一商品的數量。
  • itemsClickedInPromotion 促銷活動中點選過的商品數。促銷活動中單一商品的點擊次數。
  • itemsViewed 已看過的商品數。單一商品的瀏覽次數。
  • itemsViewedInList 清單中已看過的商品數。在清單中瀏覽單一商品的數量。
  • itemsViewedInPromotion 促銷活動中已看過的商品數。促銷活動中單一商品的瀏覽次數。

2022 年 9 月 13 日：發布結構定義相容性異動公告。

下列重大異動將於 2022 年 12 月 1 日生效：

  1. 以商品為範圍的維度 (例如 itemName) 將無法與以事件為範圍的指標 (例如 eventCount) 搭配使用。以商品為範圍的維度仍會與以商品為範圍的指標 (例如 itemRevenue)、以使用者為準的指標 (例如 activeUsers) 和以工作階段為準的指標 (例如 sessions) 相容。

  2. 歸因維度 (例如 source) 與部分事件範圍指標 (例如 eventCount) 不相容。歸因維度仍可與可歸因指標 (例如 conversions)、以使用者為準的指標 (例如 activeUsers)，以及以工作階段為準的指標 (例如 sessions) 搭配使用。

  3. 包含查詢字串的維度 (例如 pagePathPlusQueryString ) 只能與特定維度和指標搭配使用。

2022 年 9 月 1 日：配額異動。

  • Requests per day、Requests Per Minute、Requests Per Minute Per User 配額已從 Data API 移除。

  • Tokens Per Project Per Property Per Hour 配額已新增至 API。

  • 每個要求都會耗用 Tokens Per Property Per Hour 和 Tokens Per Project Per Property Per Hour 的配額。

    如要瞭解新配額的詳細資訊，請參閱配額說明文件。

2022 年 8 月 3 日：新增工作階段範圍的 SA360 維度。

  • sessionSa360AdGroupName 工作階段 SA360 廣告群組名稱。促成這個工作階段的 Search Ads 360 廣告群組名稱。

  • sessionSa360CampaignName 工作階段 SA360 廣告活動。促成這個工作階段的 Search Ads 360 廣告活動名稱。

  • sessionSa360CreativeFormat 工作階段 SA360 廣告素材格式。Search Ads 360 中促成這個工作階段的廣告素材類型。例如「回應式搜尋廣告」或「延展型文字廣告」。

  • sessionSa360EngineAccountId 工作階段 SA360 引擎帳戶 ID。促成這個工作階段的 SA360 引擎帳戶 ID。

  • sessionSa360EngineAccountName 工作階段 SA360 引擎帳戶名稱。促成這個工作階段的 SA360 引擎帳戶名稱。

  • sessionSa360EngineAccountType 工作階段 SA360 引擎帳戶類型。促成這個工作階段的 Search Ads 360 引擎帳戶類型。例如「Google Ads」、「Bing」或「Baidu」。

  • sessionSa360Keyword 工作階段 SA360 關鍵字文字。促成這個工作階段的 Search Ads 360 搜尋引擎關鍵字。

  • sessionSa360Medium 工作階段 SA360 媒介。促成這個工作階段的 Search Ads 360 搜尋引擎關鍵字。例如「cpc」。

  • sessionSa360Query 工作階段 SA360 查詢。促成這個工作階段的 Search Ads 360 搜尋查詢。

  • sessionSa360Source 工作階段 SA360 來源。促成這個工作階段的 Search Ads 360 流量來源。例如「example.com」或「google」。

  • sessionCampaignId和sessionCampaignName維度現在支援 Search Ads 360 廣告活動。

2022 年 7 月 11 日：新增轉換率指標。

轉換率

  • sessionConversionRate 觸發任何轉換事件的工作階段百分比。

  • userConversionRate 觸發任何轉換事件的使用者百分比。

單一轉換的轉換率指標

  • sessionConversionRate:event_name 觸發特定轉換事件的工作階段百分比。

  • userConversionRate:event_name 觸發特定轉換事件的使用者百分比。

2022 年 5 月 5 日：在 Alpha 版管道中新增漏斗報表功能。

  • runFunnelReport 方法已新增至 API 的 v1alpha 版本，可傳回 Google Analytics 事件資料的自訂漏斗報表。

  • 這種方法在 Alpha 版穩定性階段推出，用意是在進入 Beta 版前，先收集有關語法和功能的意見回饋。歡迎填寫 Google Analytics Data API 程序報表意見回饋表 ，提出您對這個 API 的寶貴意見。

2022 年 2 月 16 日：新增維度。

手動輸入字詞和內容

  • firstUserManualAdContent 最初招攬到使用者的手動廣告素材。最初招攬到使用者的廣告素材。由 utm_content 參數填入。

  • firstUserManualTerm 最初招攬到使用者的手動字詞。最初招攬到使用者的字詞。由 utm_term 參數填入。

  • manualAdContent 手動廣告素材。這是指促成轉換事件的廣告素材，由 utm_content 參數填入。

  • manualTerm 手動字詞。促成轉換事件的字詞。 由 utm_term 參數填入。

  • sessionManualAdContent 工作階段手動廣告素材。促成工作階段的廣告素材。由 utm_content 參數填入。

  • sessionManualTerm工作階段手動字詞。促成工作階段的字詞。 由 utm_term 參數填入。

當機分析

  • crashAffectedUsers 遇到當機情形的使用者人數。報表這一列中記錄當機的使用者人數。

  • crashFreeUsersRate 未受當機情況影響的使用者比率。

應用程式/網站

  • averageSessionDuration 使用者工作階段的平均時間長度 (以秒為單位)。

  • newVsReturning 新使用者 / 回訪者。

  • screenPageViewsPerSession 每個工作階段的瀏覽次數。

  • landingPage到達網頁。與工作階段中第一次網頁瀏覽相關聯的網頁路徑 + 查詢字串。

  • platformDeviceCategory 網站或行動應用程式的運作平台和裝置類型。

行動應用程式

  • averagePurchaseRevenuePerUser 單一使用者的平均購買收益。

  • firstTimePurchaserConversionRate 初次完成購買的活躍使用者百分比。

  • firstTimePurchasersPerNewUser每位新使用者轉換為初次購買者的平均人數。

  • dauPerMau每日活躍使用者 / 每月活躍使用者。同時也是單日活躍使用者的 30 天活躍使用者百分比 (每日累計)。

  • dauPerWau 每日活躍使用者 / 每週活躍使用者。同時也是單日活躍使用者的 7 天活躍使用者百分比 (每日累計)。

  • wauPerMau每週活躍使用者 / 每月活躍使用者。同時也是 7 天活躍使用者的 30 天活躍使用者百分比 (每日累計)。

  • purchaserConversionRate 完成一或多次購買交易的活躍使用者百分比。

  • transactionsPerPurchaser 每位購買者的交易次數。

Google Ads 廣告活動

  • firstUserGoogleAdsCampaignType 最初招攬到使用者的 Google Ads 廣告活動類型。

  • googleAdsCampaignType 歸因於轉換事件的 Google Ads 廣告活動類型。

  • sessionGoogleAdsCampaignType 促成這個工作階段的 Google Ads 廣告活動類型。

2021 年 9 月 7 日：新增日期/時間維度。

  • dateHourMinute日期、小時和分鐘的合併值，格式為 YYYYMMDDHHMM。

  • minute 記錄事件時的小時數 (兩位數)。

  • nthMinute 自日期範圍開始日算起的分鐘數。

2021 年 9 月 7 日：新增由事件參數填入的新維度。

  • achievementId 事件中遊戲的成就 ID。

  • character 事件中玩家扮演的遊戲角色。

  • fileExtension：下載檔案的副檔名。

  • fileName 下載檔案的網頁路徑。

  • groupId 事件中遊戲玩家的群組 ID。

  • linkClasses 外連連結的 HTML class 屬性。

  • linkDomain 外連連結的目標網域。

  • linkId 外連連結或檔案下載的 HTML id 屬性。

  • linkText 檔案下載的連結文字。

  • linkUrl 外連連結或檔案下載的完整網址。

  • method 事件觸發方式。

  • outbound 如果連結通往的網站不在資源的網域內，則會傳回「true」。

  • pageLocation 所造訪網頁的通訊協定、主機名稱、網頁路徑和查詢字串。

  • pageReferrer 完整的參照網址，包括主機名稱和路徑。

  • percentScrolled 使用者向下捲動網頁的百分比 (例如「90」)。

  • searchTerm 使用者搜尋的字詞。

  • videoProvider 影片來源 (例如「youtube」)。

  • videoTitle 影片標題。

  • videoUrl 影片的網址。

  • visible 如果內容可見，則傳回「true」。

  • unifiedPagePathScreen 記錄事件的網頁路徑 (網站) 或畫面類別 (應用程式)。

2021 年 9 月 7 日：API 結構定義異動。

現有維度的變更：

  • unifiedPageScreen 針對網站產生的事件，這個維度現在會傳回記錄事件的網頁路徑和查詢字串。

即將推出的異動公告：

  • firstUserTrafficOrigin 最初招攬到使用者的流量來源。 請勿依據這個欄位傳回的「手動」值，判斷流量是否使用 UTM；這項欄位即將推出新功能，屆時會從傳回「手動」值改為傳回「(not set)」值。

  • sessionTrafficOrigin 工作階段廣告活動的流量來源。 請勿依據這個欄位傳回的「手動」值，判斷流量是否使用 UTM；這項欄位即將推出新功能，屆時會從傳回「手動」值改為傳回「(not set)」值。

  • trafficOrigin 轉換事件廣告活動的流量來源。 請勿依據這個欄位傳回的「手動」值，判斷流量是否使用 UTM；這項欄位即將推出新功能，屆時會從傳回「手動」值改為傳回「(not set)」值。

2021 年 9 月 7 日：API 新增 checkCompatibility 方法。

checkCompatibility 方法會列出可加入報表要求的維度和指標，並維持相容性。

2021 年 7 月 21 日：即時報表異動。

現在可以使用 runRealtimeReport 方法的 minuteRanges 參數，指定要讀取事件資料的分鐘範圍。

2021 年 7 月 21 日：推出新的管道分組維度。

Data API 報表結構定義新增了管道分組維度：

  • firstUserDefaultChannelGrouping 最初招攬到使用者的預設管道分組。

  • defaultChannelGrouping 預設管道分組。

2021 年 6 月 10 日：API 結構定義異動。

  • minutesAgo 維度已新增至 Data API 即時架構，可用於 runRealtimeReport 方法的查詢。這個維度包含事件收集時間前幾分鐘的資料。00 是目前的分鐘，01 則代表前一分鐘。

  • 資料 API 架構中新增 googleAdsCreativeId 維度。這個維度包含歸因於轉換事件的 Google Ads 廣告素材 ID。

  • 資料 API 架構中新增 sessionGoogleAdsCreativeId 維度。這個維度包含 Google Ads 廣告素材的 ID，該廣告素材會將使用者帶往網站或應用程式的工作階段。

  • 資料 API 結構定義中的 firstUserCreativeId 維度已重新命名為 firstUserGoogleAdsCreativeId。這個維度包含最初招攬到使用者的 Google Ads 廣告素材 ID。

2021 年 4 月 9 日：Google Analytics Data API 第 1 版 Beta 版已發布。

  • API 端點已更新為 https://analyticsdata.googleapis.com/v1beta。

  • runReport、runPivotReport、batchRunReports、batchRunPivotReports 方法現在接受 URL 路徑的 property 參數中的 Google Analytics 4 資源 ID，而非要求主體的 entity 欄位：

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • API 用戶端程式庫已更新為使用新的 API 端點。

2021-02-19 分頁變更。

  • 報表回應的預設大小已從 10 個事件資料列增加至 10,000 個。

  • "limit" : -1 值，用於表示嘗試擷取所有資料列，但 RunReportRequest 不再支援這個值。

  • limit 欄位的最大值設為 100000。如要擷取超過 10 萬列的報表，請使用分頁。

2021 年 2 月 8 日：推出新的電子商務維度和指標。

API 結構定義新增了下列電子商務維度和指標：

維度： adFormat、adSourceName、adUnitName、itemBrand、itemCategory、itemCategory2、itemCategory3、itemCategory4、itemCategory5、itemId、itemListId、itemListName、itemName、itemPromotionCreativeName、itemPromotionId、itemPromotionName、orderCoupon、transactionId。

指標： adUnitExposure、addToCarts、cartToViewRate、checkouts、ecommercePurchases、firstTimePurchasers、itemListClickThroughRate、itemListClicks、itemListViews、itemPromotionClickThroughRate、itemPromotionClicks、itemPromotionViews、itemPurchaseQuantity、itemRevenue、itemViews、publisherAdClicks、publisherAdImpressions、totalPurchasers。

2021 年 2 月 8 日：新增廣告活動維度。

API 結構定義新增了下列廣告活動維度：campaignId、campaignName、googleAdsAccountName、googleAdsAdGroupId、googleAdsAdGroupName、googleAdsAdNetworkType、source、trafficOrigin

2021-02-08 dayOfWeek、week 維度異動。

  • dayOfWeek 維度的值現在從 0 開始，而非 1。

  • week 維度的值現在會從 01 開始，並傳回 01 到 53 的兩位數。每週的起始日是星期日，1 月 1 日一律在第 01 週。

2021 年 1 月 28 日：新增自訂指標的匯總變數。

資源註冊的每個自訂指標都會建立三種 API 指標變體：總和、平均值和計數。

2021 年 1 月 28 日：新增日期/時間維度。

API 結構定義新增了下列維度：hour、nthHour、nthYear、dateHour。

2021 年 1 月 28 日：Data API 降低了每次查詢的配額權杖費用。

Data API 降低了每次查詢的配額權杖費用。每小時和每日的資源配額權杖配額限制維持不變。

2020 年 11 月 9 日：已刪除 getUniversalMetadata 方法。

方法 getUniversalMetadata 已刪除。請使用 getMetadata。已移除每個 API 要求的日期範圍上限 (一年)。

2020 年 11 月 2 日：新增即時報表方法。

如需範例，請參閱「建立即時報表」，如需 REST 參考說明文件，請參閱「runRealtimeReport」。

2020-10-19：更新用戶端程式庫構件。

用戶端程式庫構件已更新，並提供使用說明和程式碼範例。

2020 年 10 月 13 日：「應用程式 + 網站」資源已重新命名為 Google Analytics 4 (GA4)。

2020 年 10 月 8 日：API 新增 getMetadata 方法。

getMetadata 方法會傳回指定 GA4 資源 ID 可用的自訂維度和指標，以及通用中繼資料。

2020 年 10 月 8 日：報表提供自訂維度和指標。

如需自訂維度和指標的說明文件，請參閱 API 結構定義說明文件。本次更新包含事件範圍自訂維度和指標，以及使用者範圍自訂維度。