變更記錄

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

2026-09-14：在 v1 alpha 中新增對話式查詢支援

新增 properties.chat 方法，可使用自然語言查詢與 Google Analytics 資料互動。

2026-09-14：在報表回應中新增資料截斷原因

在 v1 beta 和 v1 alpha 的 ResponseMetaData 中新增 dataTruncationReasons 欄位。如果報表資料遭到截斷，這個欄位會包含 DataTruncationReason 物件清單，其中包含截斷類型、說明訊息和受影響的日期。

2026-04-23：新增 v1 Alpha 版轉換報表支援

新增支援，可使用 Data API v1 Alpha 版中的 runReport 方法，從轉換成效報表擷取資料。這樣一來，您就能存取 Google Analytics 使用者介面中「廣告」>「轉換成效」下的相同轉換資料。

更新 Data API 第 1 版 Alpha 版中的 getMetadata 方法，提供轉換報表資訊：

2024-10-20 新增 EmptyFilter 維度篩選條件類型

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

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

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

這項功能可讓 Google Analytics 360 資源享有更高的取樣上限 (10 億筆事件)。此外，如果事件數量龐大，可將取樣限制設為 UNSAMPLED，取得未取樣結果。

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

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

2024-06-28 新增「每個專案每項資源的用戶端錯誤」配額

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

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

2024-05-14：新增比較功能

使用比較項目，就能對照評估不同的資料子集。

Data API v1beta 的核心報表方法已更新，可支援 comparisons 欄位。加入這個欄位後，即可指定要求的比較設定。

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

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

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

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

2024-05-08：在 Data API v1alpha 中新增報表工作 (非同步報表功能)。

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

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

2024-05-06：重要事件的新維度

重要事件的維度和指標現已推出。

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

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

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

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

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

  • apiName、uiName 和 description 包含重要事件 API 名稱、UI 名稱和說明。
  • deprecatedApiNames 重複欄位含有已淘汰的轉換 API 名稱項目。

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

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

目標對象維度：

  • 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-03-06：目標對象匯出功能支援不活躍使用者目標對象。

目標對象匯出功能更適合匯出不活躍使用者目標對象。使用者不需觸發符合條件的事件，即可加入這類目標對象；舉例來說，使用者只要七天內未造訪網站，就能加入目標對象。不活躍使用者目標對象的例子包括「7 天內未購物的使用者」、「7 天內未活躍的使用者」和「7 天內未收到通知的使用者」。如要進一步瞭解這些建議目標對象，請參閱「建議目標對象」一文。

2024-02-28：目標對象匯出功能會傳回代碼中指定的使用者 ID。

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

2024-01-30：Data API 第 1 版 Alpha 版支援目標對象名單和週期性目標對象名單的 Webhook 通知。

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

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

2024-01-18：改善包含查詢字串或分鐘元件的維度相容性。

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

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

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

2023-12-13 自訂以商品為範圍的參數

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

Generic API 名稱 說明
customItem:parameter_name parameter_name 的以商品為範圍的自訂維度

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

2023-12-05：Data API 第 1 版 Beta 版提供目標對象名單，稱為「目標對象匯出」

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

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

2023-11-28：在報表回應中新增 samplingMetadatas

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

2023-11-28：在 Data API 第 1 版 Alpha 版中，新增定期匯出目標對象名單的功能

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

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

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

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

2023-09-12 AudienceList 預設排序規則

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

在這項異動前，您可能會收到以下報表：

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

這項異動生效後，您會收到下列報表：

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

2023-08-15：在目標對象名單匯出結構定義中新增 isLimitedAdTracking 維度

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

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

2023-08-15 新增currencyCode維度和itemDiscountAmount指標

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

  • itemDiscountAmount 電子商務事件中商品折扣的金額價值。 這項指標的資料，是透過標記中的「discount」商品參數填入。

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

2023-08-10：在目標對象名單匯出結構定義中新增 isAdsPersonalizationAllowed 維度

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

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

2023-07-10 目標對象名單

Data API v1 Alpha 版新增目標對象名單支援。目標對象名單包含建立目標對象名單時，目標對象中使用者的數據匯報。

Data API v1 Alpha 版新增下列方法：

2023-05-19 自訂管道群組

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

2023-05-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-03-02：新增日期維度。

  • 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-02-27：新增電子商務維度。

  • itemListPosition 作品清單位置。商品 (例如您銷售的產品) 在清單中的位置。這個維度是透過代碼中 items 陣列的「index」參數填入。

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

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

2023-02-21：新增「到達網頁 + 查詢字串」維度。

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

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

2023-01-28 新增「每個使用者的觀看次數」和「捲動網頁的使用者」指標。

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

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

2023-01-23：新增「洲別」和「洲別 ID」維度。

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

  • continentId 洲別 ID。使用者活動來源洲別的地理 ID，根據使用者的 IP 位址推算而得。

2023-01-23：新增「測試資料篩選器 ID」維度。

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

2022-10-18：新增 Google Ads 指標。

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

2022-10-17 新增以商品為範圍的指標。

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

2022-09-13 結構定義相容性異動公告。

2022 年 12 月 1 日起，下列破壞性變更將生效：

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

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

  3. 包含查詢字串 (例如 pagePathPlusQueryString) 的維度，只會與一組有限的維度和指標相容。

2022-09-01 配額變更。

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

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

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

    如要進一步瞭解新配額，請參閱配額說明文件。

2022-08-03 新增工作階段範圍 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-07-11 新增轉換率指標。

轉換率

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

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

單一轉換的轉換率指標

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

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

2022-05-05：在 Alpha 版管道中新增漏斗報表功能。

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

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

2022-02-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 DAU/MAU。同時也是 1 天活躍使用者的 30 天活躍使用者百分比 (累計)。

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

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

  • purchaserConversionRate 完成 1 筆以上購買交易的活躍使用者百分比。

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

Google Ads 廣告活動

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

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

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

2021-09-07：新增日期/時間維度。

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

  • minute 記錄事件的分鐘 (兩位數)。

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

2021-09-07 新增由事件參數填入的新維度。

  • 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-09-07 API 架構異動。

現有維度的異動：

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

近期異動公告：

  • firstUserTrafficOrigin：最初招攬到使用者的流量來源。請勿依賴這個欄位為使用 UTM 的流量傳回「Manual」；這個欄位將在近期功能推出後，從傳回「Manual」更新為傳回「(not set)」。

  • sessionTrafficOrigin 工作階段廣告活動的流量來源。請勿依賴這個欄位為使用 UTM 的流量傳回「Manual」；這個欄位將在近期功能推出後，從傳回「Manual」更新為傳回「(not set)」。

  • trafficOrigin 轉換事件廣告活動的流量來源。 請勿依賴這個欄位為使用 UTM 的流量傳回「Manual」；這個欄位將在近期推出新功能時，從傳回「Manual」更新為傳回「(not set)」。

2021-09-07：API 新增 checkCompatibility 方法。

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

2021-07-21：即時報表異動。

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

2021-07-21 新增管道分組維度。

Data API 報表架構新增了管道分組維度：

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

  • defaultChannelGrouping 預設管道分組。

2021-06-10 API 架構變更。

  • minutesAgo 維度已新增至 Data API 即時結構定義，可用於查詢 runRealtimeReport 方法。這個維度包含收集事件的時間 (以分鐘為單位)。00 代表目前的分鐘，01 代表前一分鐘。

  • Data API 架構新增了googleAdsCreativeId維度。這項維度包含促成轉換事件的 Google Ads 廣告素材 ID。

  • Data API 架構新增了「sessionGoogleAdsCreativeId」維度。這個維度包含 Google Ads 廣告素材的 ID，該廣告素材會導向網站或應用程式的工作階段。

  • Data API 架構中的 firstUserCreativeId 維度已重新命名為 firstUserGoogleAdsCreativeId。這項維度包含最初招攬到使用者的 Google Ads 廣告素材 ID。

2021-04-09：Google Analytics Data API 第 1 版 Beta 版已發布。

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

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

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

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

2021-02-19 分頁變更。

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

  • RunReportRequest 不再支援用來表示嘗試擷取所有資料列的 "limit" : -1 值。

  • limit 欄位的最大值設為 100000。如要擷取超過 100,000 列的報表，請使用分頁功能。

2021-02-08：新增電子商務維度和指標。

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-02-08：新增廣告活動維度。

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-01-28：新增自訂指標的匯總變化版本。

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

2021-01-28：新增日期/時間維度。

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

2021-01-28：Data API 降低了每次查詢收取的配額權杖。

Data API 降低了每項查詢收取的配額權杖數量。資源配額權杖每小時和每日的配額限制維持不變。

2020-11-09：getUniversalMetadata 方法已刪除。

getUniversalMetadata 方法已刪除。請改用 getMetadata。每項 API 要求的日期範圍上限已不再限於一年。

2020-11-02 新增即時報表方法。

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

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

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

2020-10-13「應用程式 + 網站」資源已更名為 Google Analytics 4 (GA4)。

2020-10-08：API 新增 getMetadata 方法。

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

2020-10-08：報表提供自訂維度和指標。

如需自訂維度和指標的說明文件，請參閱 API 架構說明文件。這項更新包括以事件為範圍的自訂維度和指標，以及以使用者為範圍的自訂維度。