變更記錄

如需 Google Analytics (分析) API 官方公告，請訂閱 Google Analytics API Notify Group。

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

目前，每項資源在 15 分鐘內，每項專案每項專案最多只能有 10,000 個 API 伺服器錯誤。凡是產生回應為 500 或 200 以外程式碼的所有要求，也都包含在內。超出這個配額的錯誤範例：使用不相容的�����������標���合，以及所有驗證錯誤。

如果超過此上限，在 15 分鐘的時限結束前，系統會暫時禁止在相關聯的 Google Cloud 專案中對該屬性發出 API 呼叫。

2024-05-14 新增比較功能

您可以使用「比較項目」來對照評估資料子集。

Data API v1beta 的核心報表方法已更新為支援 comparisons 欄位。如果提供這個欄位，就會指定要求的比較設定。

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

getMetadata 方法會更新，在 comparisons 回應欄位下方，列出屬性可用的所有已儲存比較項目。

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

目前，您只能使用 Google Analytics (分析) UI 建立已儲存的比較項目。

2024-05-08 在 Data API v1alpha 中，報表工作是非同步報表功能。

透過報表工作，您可以發出長時間執行的非同步要求，為 Google Analytics (分析) 事件資料製作自訂報表。

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

• properties.reportTasks.create
• properties.reportTasks.get
• properties.reportTasks.list
• properties.reportTasks.query

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

目標對象匯出功能更有效支援匯出不活躍的使用者目標對象。使用者在沒有符合條件的事件的情況下進入這些目標對象；舉例來說，使用者可以在七天內不造訪您的網站，進入目標對象。已停用的使用者目標對象範例包括「7 天內閒置的購買者」、「7 天內的不活躍使用者」和「7 天內未收到通知的使用者」。如要進一步瞭解這些建議目標對象，請參閱「建議目標對象」一文。

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

即使資源已啟用使用者提供的資料，目標對象匯出功能現在也會傳回代碼中指定的使用者 ID。啟用「收集使用者提供的資料」功能後，使用者提供的資料和 User-ID 就能傳送至 Google Analytics (分析)，以利代碼進行評估。詳情請參閱「收集使用者提供的資料」一文。

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

建立目標對象名單 (使用 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 查詢現在可以使用以下語法，納入以商品為範圍的自訂維度：

一般 API 名稱	說明
customItem:parameter_name	以商品為範圍的自訂維度的「parameter_name」

詳情請參閱「API 維度和指標」一文。

2023-12-05 目標對象名單會在 Data API v1 Beta 版中提供目標對象匯出功能

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

在 Data API v1 Beta 版中加入下列方法：

• properties.audienceExports.create

• properties.audienceExports.get

• properties.audienceExports.list

• properties.audienceExports.query

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

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

2023 年 11 月 28 日：Data API v1 Alpha 版新增了週期性目標對象名單匯出功能

將 properties.recurringAudienceLists.create、properties.recurringAudienceLists.create 和 properties.recurringAudienceLists.list 方法新增至 Data API v1 Alpha 版。

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

2023-11-08 使用 Data API v1 Alpha 版，將目標對象名單匯出至試算表功能

新增 properties.audienceLists.exportSheet 方法至 Data API v1 Alpha 版，方便您將目標對象名單匯出至 Google 試算表。

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

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

2023-09-12 目標對象名單預設排序規則

根據預設，透過目標對象名單匯出功能建立的報表，會遵循與 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 版中新增的方法：

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

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

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

2023-05-11 權杖配額變更。

Data API 的配額系統已更新，現採用更準確的收費標準。

每次要求收費的權杖數量隨著配額變動而重新調整，讓您可以進行更多簡單的報表查詢，同時針對大型日期報告收取更多配額符記。

這項變更生效後，雖然部分要求的收費方式保持不變，但進行較複雜的查詢，費用會明顯增加。舉例來說，要求超過 6 個月的資料可能會收取 1,000 個或更多配額權杖的費用。

標準資源

配額名稱	舊限制	新的限制
每天每資源的核心權杖數	25,000	20 萬
每小時每資源的核心權杖數	5,000	40,000 次
每項專案每小時每項資源的核心權杖數	1,750 次	14,000 個
每個資源每天的即時權杖	25,000	20 萬
每個資源每小時的即時權杖	5,000	40,000 次
每個專案每小時每個資源每小時的即時權杖	1,750 次	14,000 個
每個資源每日的程序權杖	25,000	20 萬
每小時每資源的程序權杖	5,000	40,000 次
每項專案每小時每項資源的程序權杖	1,750 次	14,000 個

Analytics (分析) 360 資源

配額名稱	舊限制	新的限制
每天每資源的核心權杖數	250,000	2,000,000 個
每小時每資源的核心權杖數	50,000 次	40 萬
每項專案每小時每項資源的核心權杖數	17,500 人	140,000 個
每個資源每天的即時權杖	250,000	2,000,000 個
每個資源每小時的即時權杖	50,000 次	40 萬
每個專案每小時每個資源每小時的即時權杖	17,500 人	140,000 個
每個資源每日的程序權杖	250,000	2,000,000 個
每小時每資源的程序權杖	50,000 次	40 萬
每項專案每小時每項資源的程序權杖	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 年 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 日：新增廣告指標。

• advertiserAdClicks 廣告點擊。使用者點按廣告觸及資源的總次數。
• advertiserAdCost 廣告費用。您為廣告支付的總金額。
• advertiserAdCostPerClick Google Ads 單次點擊出價。Google Ads 單次點擊出價是廣告費用除以廣告點擊數所得的值，通常是單次點擊出價。
• 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 配額變更。

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

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

• 每項要求都會耗用 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」或「百度」。

• 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-05-05 在 Alpha 版頻道中新增漏斗報表功能。

• runFunnelReport 方法加進 API v1alpha 版本，會傳回 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 DAU / WAU。同時也是 1 天活躍使用者的 7 天活躍使用者累計百分比。

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

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

• 每位購買者的交易金額：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 類別屬性。

• 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 最初招攬到使用者的流量來源。請勿仰賴此欄位為使用 Urchin 流量監視器 (UTM) 的流量傳回「手動」。即將推出的功能推出後，這個欄位會從「手動」改為傳回「(not set)」。

• sessionTrafficOrigin 工作階段廣告活動的流量來源。請勿仰賴此欄位為使用 Urchin 流量監視器 (UTM) 的流量傳回「手動」。即將推出的功能推出後，這個欄位會從「手動」改為傳回「(not set)」。

• trafficOrigin轉換事件廣告活動的流量來源。請勿仰賴此欄位為使用 Urchin 流量監視器 (UTM) 的流量傳回「手動」。即將推出的功能推出後，這個欄位會從「手動」改為傳回「(not set)」。

2021-09-07 checkCompatibility 方法已新增至 API。

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

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

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

2021 年 7 月 21 日 新增管道分組維度。

在 Data API 報表架構中加入新的管道分組維度：

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

• defaultChannelGrouping預設管道分組。

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

• minutesAgo 維度已新增至 Data API 即時結構定義，可用於對 runRealtimeReport 方法的查詢。這個維度包含收集事件的分鐘數。00 是目前分鐘，01 表示前一分鐘。

• 已將「googleAdsCreativeId」維度新增至 Data API 架構。這個維度包含歸給轉換事件的 Google Ads 廣告素材 ID。

• 已將「sessionGoogleAdsCreativeId」維度新增至 Data API 架構。這個維度包含可在網站或應用程式上促成工作階段的 Google Ads 廣告素材 ID。

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

2021-04-09 已推出 Google Analytics Data API v1 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 年 2 月 19 日分頁異動。

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

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

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

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-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 日一律在第 1 週

2021-01-28 為自訂指標新增匯總變化版本。

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

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

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

2021 年 1 月 28 日 Data API 減少了每次查詢計費的配額權杖，

Data API 會減少每次查詢計費的配額權杖。資源配額權杖的每小時和每日配額限制無法變更。

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

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

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

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

2020 年 10 月 19 日 用戶端程式庫構件更新。

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

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

2020-10-08 getMetadata 方法已新增至 API。

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

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

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