變更記錄

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

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

在 Data 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 年 3 月 6 日：目標對象匯出支援停用使用者目標對象。

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

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

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

2024 年 1 月 30 日：Webhook 通知支援目標對象名單；Webhook 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 月 5 日 在 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 月 8 日 Data API v1 Alpha 版新增了將目標對象名單匯出到試算表功能

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

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

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

2023 年 9 月 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 年 7 月 10 日 目標對象名單

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

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

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

2023-05-19 自訂管道群組

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

2023 年 5 月 11 日：變更權杖配額。

Data API 的配額系統已更新，可提供更準確的費用。

系統已配合配額變更和重新平衡設定，更新每個要求收取的權杖數量，以支援大量簡單的報表查詢，並為大型日期報表收取更多配額憑證。

此變更之後，雖然部分要求的費用將維持不變，但較複雜查詢的費用將會明顯增加。舉例來說，如果要求的資料用量超過 6 個月，可能會收取 1,000 個以上的配額權杖。

標準資源

配額名稱	舊限制	新限制
每個資源每日的核心權杖	25,000	20 萬
每小時每項資源的核心權杖	5,000	4 萬
每項資源每小時每項專案的核心權杖	1,750 人	14,000 次
每個資源每日的即時權杖數量	25,000	20 萬
每小時每項資源的即時權杖數量	5,000	4 萬
每項資源每小時每項專案的即時權杖數	1,750 人	14,000 次
每個資源每日的漏斗權杖	25,000	20 萬
每小時每項資源的漏斗權杖	5,000	4 萬
每項資源每小時每項專案的漏斗權杖	1,750 人	14,000 次

Analytics (分析) 360 資源

配額名稱	舊限制	新限制
每個資源每日的核心權杖	250,000	200 萬
每小時每項資源的核心權杖	50,000 次	40 萬
每項資源每小時每項專案的核心權杖	17,500 人	140,000 次
每個資源每日的即時權杖數量	250,000	200 萬
每小時每項資源的即時權杖數量	50,000 次	40 萬
每項資源每小時每項專案的即時權杖數	17,500 人	140,000 次
每個資源每日的漏斗權杖	250,000	200 萬
每小時每項資源的漏斗權杖	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。

• ISO 年度的 isoYearIsoWeek 週。isoWeek 和 isoYear 的加總值。範例值包括 201652 和 201701。

• yearMonth 年。year 和 month 的加總值。範例值包括 202212 或 202301。

• yearWeek 週。year 和 week 的加總值。範例值包括 202253 或 202301。

2023-02-27 新增電子商務維度。

• itemListPosition商品清單位置。商品 (例如您銷售的產品) 在清單中的位置。系統會透過商品陣列中的「index」參數來標記這項維度。

• itemLocationID商品地區 ID。與商品相關聯的實體商店位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place 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廣告費用。您為廣告支付的總金額。
• advertiserAdCostPerClickGoogle 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 配額變更。

• 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 搜尋引擎關鍵字。例如「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 完成 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 類別屬性。

• 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 的流量，請勿仰賴傳回「手動」的欄位。為即將推出的功能推出，這個欄位將從「手動」傳回「(未設定)」狀態。

• sessionTrafficOrigin 工作階段廣告活動的流量來源。對於使用 UTM 的流量，請勿仰賴傳回「手動」的欄位。為即將推出的功能推出，這個欄位將從「手動」傳回「(未設定)」狀態。

• trafficOrigin 轉換事件廣告活動的流量來源。對於使用 UTM 的流量，請勿仰賴傳回「手動」的欄位。為即將推出的功能推出，這個欄位將從「手動」傳回「(未設定)」狀態。

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 年 4 月 9 日 推出 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-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 日總是是第 1 週

2021-01-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-08 getMetadata 方法已新增至 API。

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

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

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