變更記錄

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

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

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

這項功能可讓 Google Analytics 360 資源存取更高取樣上限 (10 億個事件)。此外，您也可以將取樣限制設為 UNSAMPLED，以便取得大量事件計數的未取樣結果。

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

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

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

每個專案和資源在 15 分鐘內的 API 伺服器錯誤數量上限為 10,000 個。凡是產生回應為 500 或 200 以外程式碼的所有要求，也都包含在內。以下是屬於此配額的錯誤範例：使用不相容的維度和指標組合、所有驗證錯誤。

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

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：

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 新增主要管道群組、手動流量來源和整合專用維度。

將主要管道群組、手動流量來源，以及 CM360、DV360、SA360 整合專用維度新增至資料 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 支援 Data API v1 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 查詢中加入以項目為範圍的自訂維度：

通用 API 名稱 說明
customItem:parameter_name 以商品為範圍的自訂維度 (parameter_name)

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

2023-12-05 在 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 v1 alpha 中新增 properties.recurringAudienceLists.create、properties.recurringAudienceLists.create、properties.recurringAudienceLists.list 方法。

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

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

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

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 年 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-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 商品清單位置。商品 (例如您銷售的產品) 在清單中的位置。這個維度會在標記時，由商品陣列中的「index」參數填入。

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

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

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

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

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

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

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

  • scrolledUsers 已捲動的使用者。至少有一次網頁捲動深度達 90% 的不重複使用者人數。

2023 年 1 月 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 日：新增廣告指標。

  • 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 年 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-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 搜尋引擎關鍵字。例如「單次點擊出價」。

  • 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 每日活躍使用者 / 每週活躍使用者。同時也是 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 年 9 月 7 日：新增由事件參數填入的新維度。

  • 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-06-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 日一律在第 01 週。

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

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

2021-01-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 月 8 日：在 API 中新增 getMetadata 方法。

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

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

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