API 維度與指標

您可以在 Data API Core Reporting 查詢中使用的維度和指標。

尺寸

您可以在任何資源的報表中要求下列維度。 在 Dimension 資源的 name 欄位中,為報表回應中的維度資料欄指定「API 名稱」。

API 名稱 使用者介面名稱 說明
achievementId 成就 ID 事件的遊戲成就 ID。由事件參數 achievement_id 填入。
adFormat 廣告格式 說明廣告的外觀和位置。一般格式包括 InterstitialBannerRewardedNative advanced
adSourceName 廣告來源 放送廣告的來源聯播網。常見來源包括 AdMob NetworkLiftoffFacebook Audience NetworkMediated house ads
adUnitName 廣告單元 您選擇用來描述這個廣告單元的名稱。「廣告單元」是您放在應用程式中的容器,可向使用者顯示廣告。
appVersion 應用程式版本 應用程式的 versionName (Android) 或簡短版軟體包版本編號 (iOS)。
audienceName 目標對象名稱 目標對象的指定名稱。在報表日期範圍內,使用者會記錄於所屬的目標對像中。目前的使用者行為不會影響報表中的歷來目標對象成員。
audienceResourceName 目標對象資源名稱 此目標對象的資源名稱。資源名稱包含集合和資源 ID,可做為資源的專屬識別。詳情請參閱「資源名稱」。
brandingInterest 興趣喜好 位於購物程序前端的使用者展現的興趣。使用者可能會歸入多個興趣類別,例如 ShoppersLifestyles & Hobbies/Pet LoversTravel/Travel Buffs/Beachbound Travelers
browser 瀏覽者 用來瀏覽您網站的瀏覽器。
campaignId 廣告活動 ID 行銷廣告活動的 ID。僅針對轉換事件顯示。包括 Google Ads 廣告活動、手動廣告活動和其他廣告活動。
campaignName 廣告活動 行銷廣告活動名稱。僅針對轉換事件顯示。包括 Google Ads 廣告活動、手動廣告活動和其他廣告活動。
character 字元 事件中玩家扮演的遊戲角色。由事件參數 character 填入。
city 城市 使用者活動的來源城市。
cityId 城市 ID 使用者活動的來源城市地理區域 ID (依 IP 位址推算)。
cohort 同類群組 要求中的同類群組名稱。「同類群組」是指一群連續幾天開始使用網站或應用程式的使用者。如果要求中未指定同類群組名稱,系統會按照零以索引為同類群組命名:同類群組_0、同類群組_1 等。
cohortNthDay 單日同類群組 與同類群組中 firstSessionDate 使用者的相對日差。舉例來說,如果同類群組選取的開始和結束日期是 2020 年 3 月 1 日,則 2020 年 3 月 2 日的同類群組將是 0001。
cohortNthMonth 單月同類群組 同類群組中使用者 firstSessionDate 的月份偏移值。月份邊界會與日曆月份的邊界對齊。舉例來說,如果同類群組選取的是 2020 年 3 月開始和結束日期,則 2020 年 4 月任一日期的同類群組都會顯示為 0001。
cohortNthWeek 單週同類群組 與同類群組中 firstSessionDate 使用者的相對週差。每週的起始日為星期日,星期六結束。舉例來說,如果同類群組選取的開始和結束日期落在 2020-11-08 到 2020-11-14 之間,則日期範圍介於 2020-11-15 至 2020-11-21 之間,同類群組 NthWeek 即為 0001。
contentGroup 內容分類 適用於已發布內容項目的類別。由事件參數 content_group 填入。
contentId Content ID 所選內容的 ID。由事件參數 content_id 填入。
contentType 內容類型 所選內容的類別。由事件參數 content_type 填入。
continent 大陸 使用者活動的來源洲別。例如 AmericasAsia
continentId 洲別 ID 使用者活動的來源洲別地理區域 ID (依 IP 位址推測)。
country 國家/地區 使用者活動的來源國家/地區。
countryId 國家/地區 ID 使用者活動的來源國家/地區地理區域 ID (依 IP 位址推測)。採用 ISO 3166-1 alpha-2 標準格式。
currencyCode 幣別 電子商務事件的當地幣別代碼 (以 ISO 4217 標準為依據)。例如,USDGBP。貨幣是由 currency 參數指定。使用多種貨幣交易的商家,可以在傳送電子商務事件給 Analytics (分析) 時指定當地貨幣代碼,並使用這個維度顯示這些貨幣。詳情請參閱「幣別參考資料」。
date 日期 事件日期,格式為 YYYYMMDD。
dateHour 日期 + 小時 (YYYYMMDDHH) 格式為 YYYYMMDDHH 的日期和小時總值。
dateHourMinute 日期小時和分鐘 日期、小時和分鐘的加總值,格式為 YYYYMMDDHHMM。
day 第幾天 每月第幾日,以 01 到 31 的兩位數表示。
dayOfWeek 星期幾 星期幾。它會傳回 [0,6] 範圍中的值,並以星期日做為一週的第一天。
dayOfWeekName 星期幾名稱 星期幾。這個維度的值包括星期日、星期一等。
defaultChannelGroup 預設管道群組 轉換的預設管道群組主要取決於來源和媒介。列舉,包括 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
deviceCategory 裝置類別 裝置類型:桌機、平板電腦或手機。
deviceModel 裝置型號 行動裝置型號 (例如:iPhone 10,6)。
eventName 事件名稱 事件的名稱。
fileExtension 副檔名 下載檔案的副檔名 (例如 pdftxt)。如果啟用加強型評估功能,則會自動填入。由事件參數 file_extension 填入。
fileName 「File name」 下載檔案的網頁路徑 (例如 /menus/dinner-menu.pdf)。如果啟用加強型評估功能,則會自動填入。由事件參數 file_name 填入。
firstSessionDate 最初工作階段日期 使用者初次工作階段的發生日期,格式為 YYYYMMDD。
firstUserCampaignId 最初使用者廣告活動 ID 最初招攬到使用者的行銷廣告活動 ID。包括 Google Ads 廣告活動、手動廣告活動和其他廣告活動。
firstUserCampaignName 最初使用者廣告活動 初次招攬到使用者的行銷廣告活動名稱;包括 Google Ads 廣告活動、手動廣告活動和其他廣告活動。
firstUserDefaultChannelGroup 最初招攬到使用者的預設管道群組 初次招攬到使用者的預設管道群組。預設管道群組主要是根據來源和媒介建立,列舉,包括 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
firstUserGoogleAdsAccountName 最初招攬到使用者的 Google Ads 帳戶名稱 初次招攬到使用者的 Google Ads 帳戶名稱。
firstUserGoogleAdsAdGroupId 最初招攬到使用者的 Google Ads 廣告群組 ID 最初招攬到使用者的 Google Ads 廣告群組 ID。
firstUserGoogleAdsAdGroupName 最初招攬到使用者的 Google Ads 廣告群組名稱 最初招攬到使用者的 Google Ads 廣告群組名稱。
firstUserGoogleAdsAdNetworkType 最初招攬到使用者的 Google Ads 廣告聯播網類型 初次招攬到使用者的廣告聯播網。列舉,包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
firstUserGoogleAdsCampaignId 最初招攬到使用者的 Google Ads 廣告活動 ID 最初招攬到使用者的 Google Ads 行銷廣告活動 ID。
firstUserGoogleAdsCampaignName 最初招攬到使用者的 Google Ads 廣告活動 初次招攬到使用者的 Google Ads 行銷廣告活動名稱;
firstUserGoogleAdsCampaignType 最初招攬到使用者的 Google Ads 廣告活動類型 最初招攬到使用者的 Google Ads 廣告活動類型。廣告活動類型決定了客戶看見廣告的位置,以及您在 Google Ads 中可用的設定和選項。廣告活動類型是一項列舉項目,包括搜尋、多媒體、購物、影片、需求開發、應用程式、智慧、飯店、地區和最高成效廣告活動。詳情請參閱選擇合適的廣告活動類型
firstUserGoogleAdsCreativeId 最初招攬到使用者的 Google Ads 廣告素材 ID 初次招攬到使用者的 Google Ads 廣告素材 ID。廣告素材 ID 可識別個別廣告。
firstUserGoogleAdsCustomerId 最初招攬到使用者的 Google Ads 客戶 ID 初次招攬到使用者的 Google Ads 客戶 ID。Google Ads 中的客戶 ID 是 Google Ads 帳戶的專屬識別資料。
firstUserGoogleAdsKeyword 最初招攬到使用者的 Google Ads 關鍵字文字 初次招攬到使用者的比對關鍵字。關鍵字是指您選擇用來描述所宣傳產品/服務的字詞或詞組,讓您向合適的客戶放送廣告。如要進一步瞭解關鍵字,請參閱「關鍵字:定義」一文。
firstUserGoogleAdsQuery 最初招攬到使用者的 Google Ads 查詢 初次招攬到使用者的搜尋查詢。
firstUserManualAdContent 最初使用者手動廣告素材 初次招攬到使用者的廣告素材。由 utm_content 參數填入。
firstUserManualTerm 最初使用者手動字詞 初次招攬到使用者的字詞。由 utm_term 參數填入。
firstUserMedium 最初招攬到使用者的媒介 初次招攬到使用者網站或應用程式的媒介。
firstUserSource 最初使用者來源 最初招攬到使用者網站或應用程式的來源。
firstUserSourceMedium 最初使用者來源/媒介 維度 firstUserSourcefirstUserMedium 的加總值。
firstUserSourcePlatform 最初使用者來源平台 初次招攬到使用者的來源平台,針對使用 Urchin 流量監視器 (UTM) 的流量,請勿仰賴傳回 Manual 的欄位。為即將推出的功能推出,這個欄位將從傳回 Manual 更新為傳回 (not set)
fullPageUrl 完整網頁網址 所造訪網頁的主機名稱、網頁路徑和查詢字串;舉例來說,https://www.example.com/store/contact-us?query_string=truefullPageUrl 部分是 www.example.com/store/contact-us?query_string=true
googleAdsAccountName Google Ads 帳戶名稱 Google Ads 中的帳戶名稱,適用於促成轉換事件的廣告活動。與 Google Ads API 中的客戶 descriptive_name 對應。
googleAdsAdGroupId Google Ads 廣告群組 ID 歸因於轉換事件的廣告群組 ID。
googleAdsAdGroupName Google Ads 廣告群組名稱 促成轉換事件的廣告群組名稱。
googleAdsAdNetworkType Google Ads 廣告聯播網類型 轉換的廣告聯播網類型。列舉,包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
googleAdsCampaignId Google Ads 廣告活動 ID 轉換事件的 Google Ads 廣告活動 ID。
googleAdsCampaignName Google Ads 廣告活動 促成轉換事件的 Google Ads 廣告活動名稱。
googleAdsCampaignType Google Ads 廣告活動類型 促成轉換事件的 Google Ads 廣告活動廣告活動類型。廣告活動類型決定了客戶看見廣告的位置,以及您在 Google Ads 中可用的設定和選項。廣告活動類型是一項列舉項目,包括搜尋、多媒體、購物、影片、需求開發、應用程式、智慧、飯店、地區和最高成效廣告活動。詳情請參閱選擇合適的廣告活動類型
googleAdsCreativeId Google Ads 廣告素材 ID 歸因於轉換事件的 Google Ads 廣告素材 ID。廣告素材 ID 可識別個別廣告。
googleAdsCustomerId Google Ads 客戶 ID Google Ads 中的客戶 ID,適用於促成轉換事件的廣告活動。Google Ads 中的客戶 ID 是 Google Ads 帳戶的專屬識別資料。
googleAdsKeyword Google Ads 關鍵字文字 促成轉換事件的相符關鍵字。關鍵字是指您選擇用來描述所宣傳產品/服務的字詞或詞組,讓您向合適的客戶放送廣告。如要進一步瞭解關鍵字,請參閱「關鍵字:定義」一文。
googleAdsQuery Google Ads 查詢 促成轉換事件的搜尋查詢。
groupId 群組 ID 事件中遊戲玩家的群組 ID。由事件參數 group_id 填入。
hostName 主機名稱 包括網址的子網域和網域名稱;例如,www.example.com/contact.html 的主機名稱為 www.example.com。
hour 小時 記錄事件當天的兩位數小時。這項維度的範圍介於 0 到 23 之間,以資源所在時區為準。
isConversionEvent 是轉換事件 如果事件是轉換,則字串 true。事件在收集時會標示為轉換;事件的轉換標記會在日後生效。您可以在 Google Analytics (分析) 中將任何事件標示為轉換,有些事件 (例如 first_open、purchase) 都會根據預設標示為轉換。詳情請參閱「關於轉換」一文。
isoWeek ISO 週次 ISO 週數,每週的開始日。詳情請參閱 http://en.wikipedia.org/wiki/ISO_week_date。範例值包括 01、02 和 53。
isoYear ISO 年度 活動的 ISO 年。詳情請參閱 http://en.wikipedia.org/wiki/ISO_week_date。範例值包括 2022 和 2023。
isoYearIsoWeek ISO 年度的 ISO 週次 isoWeek 和 isoYear 的總值。範例值包括 201652 和 201701。
itemAffiliation 商品聯盟 與個別商品相關的聯盟 (合作夥伴/供應商;如果有的話) 名稱或代碼。由 affiliation 項目參數填入。
itemBrand 商品品牌 商品的品牌名稱。
itemCategory 商品類別 商品所屬的階層分類類別。舉例來說,在「服飾/男性/夏季/上衣/T 恤」中,「服飾」是商品類別。
itemCategory2 商品類別 2 商品所屬的階層分類類別。舉例來說,在「服飾/男性/夏季/上衣/T 恤」中,「男性」是商品類別 2。
itemCategory3 商品類別 3 商品所屬的階層分類類別。舉例來說,在「服飾/男性/夏季/上衣/T 恤」中,「夏季」是商品類別 3。
itemCategory4 商品類別 4 商品所屬的階層分類類別。舉例來說,在「服飾/男性/夏季/上衣/T 恤」中,「上衣」是商品類別 4。
itemCategory5 商品類別 5 商品所屬的階層分類類別。舉例來說,在「服飾/男性/夏季/上衣/T 恤」中,「T 恤」是商品類別 5。
itemId 項目 ID 商品的 ID。
itemListId 商品清單 ID 商品清單的 ID。
itemListName 商品清單名稱 商品清單的名稱。
itemListPosition 商品清單位置 商品 (例如您銷售的產品) 在清單中的位置。系統會在商品陣列的 index 參數中填入這項維度。
itemLocationID 商品位置 ID 與商品相關聯的實體商店位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂地區 ID。這個欄位會由商品陣列中的 location_id 參數填入標記。
itemName 商品名稱 商品名稱。
itemPromotionCreativeName 商品促銷廣告素材名稱 商品促銷廣告素材的名稱。
itemPromotionCreativeSlot 商品促銷廣告素材版位 與商品相關聯的促銷廣告素材版位名稱。您可以在事件或商品層級的 creative_slot 參數中,透過標記指定這項維度。如果同時在事件和項目層級指定這個參數,系統會使用項目層級參數。
itemPromotionId 商品促銷 ID 商品促銷的 ID。
itemPromotionName 商品促銷名稱 商品促銷活動的名稱。
itemVariant 商品子類 特定產品的子類,例如XS、S、M、L 等尺寸;紅色、藍色、綠色、黑色代表顏色。由 item_variant 參數填入。
landingPage 到達網頁 與工作階段中第一次網頁瀏覽相關聯的網頁路徑。
landingPagePlusQueryString 到達網頁 + 查詢字串 與工作階段中第一次網頁瀏覽相關聯的網頁路徑 + 查詢字串。
language 語言 使用者瀏覽器或裝置的語言設定 (例如英文)
languageCode 語言代碼 使用者瀏覽器或裝置的語言設定 (ISO 639),例如「en-us」
level 等級 玩家在遊戲中的等級。由事件參數 level 填入。
linkClasses 連結類別 出站連結的 HTML 類別屬性。舉例來說,如果使用者點擊 <a class="center" href="www.youtube.com"> 連結,這項維度就會傳回 center。啟用加強型評估功能時自動填入功能。由事件參數 link_classes 填入。
linkDomain 連結網域 出站連結的目標網域。舉例來說,如果使用者點擊 <a href="www.youtube.com"> 連結,這項維度就會傳回 youtube.com。啟用加強型評估功能時自動填入功能。由事件參數 link_domain 填入。
linkId 連結 ID 出站連結或檔案下載的 HTML ID 屬性。舉例來說,如果使用者點擊 <a id="socialLinks" href="www.youtube.com"> 連結,這項維度就會傳回 socialLinks。啟用加強型評估功能時自動填入功能。由事件參數 link_id 填入。
linkText 連結文字 檔案下載的連結文字。啟用加強型評估功能時自動填入功能。由事件參數 link_text 填入。
linkUrl 連結網址 出站連結或檔案下載的完整網址。舉例來說,如果使用者點擊 <a href="https://www.youtube.com/results?search_query=analytics"> 連結,這項維度就會傳回 https://www.youtube.com/results?search_query=analytics。啟用加強型評估功能時自動填入功能。由事件參數 link_url 填入。
manualAdContent 手動廣告素材 促成轉換事件的廣告素材。由 utm_content 參數填入。
manualTerm 手動字詞 促成轉換事件的字詞。由 utm_term 參數填入。
medium 帶來轉換事件的媒介。
method 方法 事件觸發方式。由事件參數 method 填入。
minute 分鐘 記錄事件當天的兩位數 (以兩位數表示)。這項維度的範圍介於 0 到 59 之間,以資源所在時區為準。
mobileDeviceBranding 裝置品牌 製造商或品牌名稱 (例如:Samsung、HTC、Verizon 和 T-Mobile)。
mobileDeviceMarketingName 裝置 品牌裝置名稱 (例如 Galaxy S10 或 P30 Pro)。
mobileDeviceModel 行動裝置型號 行動裝置型號名稱 (例如 iPhone X 或 SM-G950F)。
month 月份 事件的月份,以 01 到 12 的兩位數整數表示。
newVsReturning 新使用者/回訪者 新使用者過去 0 個工作階段,而回訪者先前有 1 或多個工作階段。這個維度會傳回兩個值:newreturning
nthDay 第 N 天 自日期範圍開始日算起的天數。
nthHour 第 N 個小時 自日期範圍開始日算起的時數。開始時間為 0000。
nthMinute 第 N 分鐘 自日期範圍開始日算起的分鐘數。開始時間為 0000。
nthMonth 第 N 個月 自日期範圍開始日算起的月數。起始月份為 0000。
nthWeek 第 N 週 代表從日期範圍開始日算起的週數。
nthYear 第 N 年 自日期範圍開始日算起的年數。起始年份為 0000。
operatingSystem 作業系統 您的應用程式使用者/網站訪客使用的作業系統 包括電腦和行動作業系統,例如 Windows 和 Android。
operatingSystemVersion OS 版本 網站或應用程式訪客使用的作業系統版本。舉例來說,Android 10 版本為 10,iOS 13.5.1 版本為 13.5.1。
operatingSystemWithVersion 作業系統與版本 作業系統和版本。例如 Android 10 或 Windows 7。
orderCoupon 訂單優待券 訂單層級優待券的代碼編號。
outbound 出站 如果連結導向的網站不屬於資源的網域,則傳回 true。啟用加強型評估功能時自動填入功能。由事件參數 outbound 填入。
pageLocation 網頁位置 所造訪網頁的通訊協定、主機名稱、網頁路徑和查詢字串;舉例來說,https://www.example.com/store/contact-us?query_string=truepageLocation 部分是 https://www.example.com/store/contact-us?query_string=true。由事件參數 page_location 填入。
pagePath 網頁路徑 所造訪網頁主機名稱和查詢字串之間的部分,例如 https://www.example.com/store/contact-us?query_string=truepagePath 部分為 /store/contact-us
pagePathPlusQueryString 網頁路徑 + 查詢字串 網址中造訪網頁主機名稱後面的部分;舉例來說,https://www.example.com/store/contact-us?query_string=truepagePathPlusQueryString 部分為 /store/contact-us?query_string=true
pageReferrer 網頁參照網址 完整的參照網址,包含主機名稱和路徑。這個參照網址是指使用者先前所在的網址,可以是這個網站的網域或其他網域。由事件參數 page_referrer 填入。
pageTitle 網頁標題 您網站使用的網頁標題。
percentScrolled 已捲動的百分比 使用者向下捲動網頁的百分比 (例如 90)。如果已啟用加強型評估功能,則會自動填入。由事件參數 percent_scrolled 填入。
platform 平台 您應用程式或網站的運作平台,例如網路、iOS 或 Android。如要判斷報表中的串流類型,請同時使用 Platform 和 streamId。
platformDeviceCategory 平台/裝置類別 執行網站或行動應用程式的平台和裝置類型。(例如:Android / 行動裝置)
region 區域 使用者活動的來源地理區域 (依使用者的 IP 位址推算)。
screenResolution 螢幕解析度 使用者螢幕的解析度。例如 1920x1080。
searchTerm 搜尋字詞 使用者搜尋的字詞。舉例來說,如果使用者造訪 /some-page.html?q=some-term,這項維度就會傳回 some-term。啟用加強型評估功能時自動填入功能。由事件參數 search_term 填入。
sessionCampaignId 工作階段廣告活動 ID 工作階段的行銷廣告活動 ID。包括 Google Ads 廣告活動、手動廣告活動和其他廣告活動。
sessionCampaignName 工作階段廣告活動 工作階段的行銷廣告活動名稱。包括 Google Ads 廣告活動、手動廣告活動和其他廣告活動。
sessionDefaultChannelGroup 工作階段預設管道群組 工作階段的預設管道群組主要是以來源和媒介為依據。列舉,包括 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
sessionGoogleAdsAccountName 工作階段 Google Ads 帳戶名稱 促成工作階段的 Google Ads 帳戶名稱。對應 Google Ads API 中的 customer.descriptive_name。
sessionGoogleAdsAdGroupId 工作階段 Google Ads 廣告群組 ID 工作階段的 Google Ads 廣告群組 ID。
sessionGoogleAdsAdGroupName 工作階段 Google Ads 廣告群組名稱 工作階段的 Google Ads 廣告群組名稱。
sessionGoogleAdsAdNetworkType 工作階段 Google Ads 廣告聯播網類型 促成工作階段的廣告聯播網。列舉,包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
sessionGoogleAdsCampaignId 工作階段 Google Ads 廣告活動 ID 促成這個工作階段的 Google Ads 廣告活動廣告活動 ID。
sessionGoogleAdsCampaignName 工作階段 Google Ads 廣告活動 促成這個工作階段的 Google Ads 廣告活動名稱。
sessionGoogleAdsCampaignType 工作階段 Google Ads 廣告活動類型 促成這個工作階段的 Google Ads 廣告活動類型。廣告活動類型決定了客戶看見廣告的位置,以及您在 Google Ads 中可用的設定和選項。廣告活動類型是一項列舉項目,包括搜尋、多媒體、購物、影片、需求開發、應用程式、智慧、飯店、地區和最高成效廣告活動。詳情請參閱選擇合適的廣告活動類型
sessionGoogleAdsCreativeId 工作階段 Google Ads 廣告素材 ID 促成網站或應用程式工作階段的 Google Ads 廣告素材 ID。廣告素材 ID 可用來識別個別廣告。
sessionGoogleAdsCustomerId 工作階段 Google Ads 客戶 ID 促成工作階段的 Google Ads 客戶 ID。Google Ads 中的客戶 ID 是 Google Ads 帳戶的專屬識別資料。
sessionGoogleAdsKeyword 工作階段 Google Ads 關鍵字文字 促成工作階段的相符關鍵字。關鍵字是指您選擇用來描述所宣傳產品/服務的字詞或詞組,讓您向合適的客戶放送廣告。如要進一步瞭解關鍵字,請參閱「關鍵字:定義」一文。
sessionGoogleAdsQuery 工作階段 Google Ads 查詢 促成工作階段的搜尋查詢。
sessionManualAdContent 工作階段手動廣告素材 促成工作階段的廣告素材。由 utm_content 參數填入。
sessionManualTerm 工作階段手動字詞 促成工作階段的字詞。由 utm_term 參數填入。
sessionMedium 工作階段媒介 在網站或應用程式上啟動工作階段的媒介。
sessionSa360AdGroupName 工作階段 SA360 廣告群組名稱 促成這個工作階段的 Search Ads 360 廣告群組名稱。
sessionSa360CampaignId 工作階段 SA360 廣告活動 ID 促成這個工作階段的 Search Ads 360 廣告活動 ID。
sessionSa360CampaignName 工作階段 SA360 廣告活動 促成這個工作階段的 Search Ads 360 廣告活動名稱。
sessionSa360CreativeFormat 工作階段 SA360 廣告格式 促成這個工作階段的 Search Ads 360 廣告素材類型。例如,Responsive search adExpanded text ad。詳情請參閱「GA4 流量來源維度」一文。
sessionSa360EngineAccountId 工作階段 SA360 引擎帳戶 ID 促成這個工作階段的 SA360 引擎帳戶 ID。
sessionSa360EngineAccountName 工作階段 SA360 引擎帳戶名稱 促成這個工作階段的 SA360 引擎帳戶名稱。
sessionSa360EngineAccountType 工作階段 SA360 引擎帳戶類型 促成這個工作階段的 Search Ads 360 引擎帳戶類型。例如 google adsbingbaidu
sessionSa360Keyword 工作階段 SA360 關鍵字文字 促成這個工作階段的 Search Ads 360 搜尋引擎關鍵字。
sessionSa360Medium 工作階段 SA360 媒介 促成這個工作階段的 Search Ads 360 搜尋引擎關鍵字。例如 cpc
sessionSa360Query 工作階段 SA360 查詢 促成這個工作階段的 Search Ads 360 搜尋查詢。
sessionSa360Source 工作階段 SA360 來源 促成這個工作階段的 Search Ads 360 流量來源。例如 example.comgoogle
sessionSource 工作階段來源 在您的網站或應用程式上啟動工作階段的來源。
sessionSourceMedium 工作階段來源/媒介 維度 sessionSourcesessionMedium 的加總值。
sessionSourcePlatform 工作階段來源平台 工作階段廣告活動的來源平台。針對使用 Urchin 流量監視器 (UTM) 的流量,請勿仰賴傳回 Manual 的欄位。為即將推出的功能推出,這個欄位將從傳回 Manual 更新為傳回 (not set)
shippingTier 運送層級 為交付所購商品選取的運送層級 (例如「陸運」、「空運」、「次日送達」)。由 shipping_tier 事件參數填入。
signedInWithUserId 已使用 User ID 登入 如果使用者是以 User-ID 功能登入,則為 yes 字串。如要進一步瞭解 User-ID,請參閱「利用 User-ID 評估跨平台活動」一文
source 來源 帶來轉換事件的來源。
sourceMedium 來源/媒介 維度 sourcemedium 的加總值。
sourcePlatform 來源平台 轉換事件廣告活動的來源平台。針對使用 Urchin 流量監視器 (UTM) 的流量,請勿仰賴傳回 Manual 的欄位。為即將推出的功能推出,這個欄位將從傳回 Manual 更新為傳回 (not set)
streamId 串流 ID 應用程式或網站的數字 ID。
streamName 串流名稱 應用程式或網站的資料串流名稱。
testDataFilterId 測試資料篩選器 ID 處於測試狀態的資料篩選器數字 ID。您可以使用資料篩選器,在報表中根據事件參數值納入或排除事件資料。詳情請參閱「資料篩選器」一文。
testDataFilterName 測試資料篩選器名稱 處於測試狀態的資料篩選器名稱。您可以使用資料篩選器,在報表中根據事件參數值納入或排除事件資料。詳情請參閱「資料篩選器」一文。
transactionId 交易 ID 電子商務交易的 ID。
unifiedPagePathScreen 網頁路徑與畫面類別 記錄事件的網頁路徑 (網站) 或畫面類別 (應用程式)。
unifiedPageScreen 網頁路徑 + 查詢字串和畫面類別 記錄事件的網頁路徑和查詢字串 (網站) 或畫面類別 (應用程式)。
unifiedScreenClass 網頁標題與畫面類別 記錄事件的網頁標題 (網站) 或畫面類別 (應用程式)。
unifiedScreenName 網頁標題與畫面名稱 記錄事件的網頁標題 (網站) 或畫面名稱 (應用程式)。
userAgeBracket Age 使用者的年齡層。
userGender 性別 使用者的性別。
videoProvider 影片提供者 影片的來源 (例如 youtube)。如果啟用加強型評估功能,則會自動填入內嵌影片。由事件參數 video_provider 填入。
videoTitle 影片標題 影片的標題,如果啟用加強型評估功能,則會自動填入內嵌影片。由事件參數 video_title 填入。
videoUrl 影片網址 影片的網址。如果啟用加強型評估功能,則會自動填入內嵌影片。由事件參數 video_url 填入。
virtualCurrencyName 虛擬貨幣名稱 使用者進行互動的虛擬貨幣名稱,例如在遊戲中消費或購買寶石。由 virtual_currency_name 事件參數填入。
visible 可見 如果內容可見,則傳回 true。如果啟用加強型評估功能,則會自動填入內嵌影片。由事件參數 visible 填入。
week 事件當週,以 01 到 53 的兩位數表示。每週從星期日開始。1 月 1 日一律為第 1 週。每年第一週和最後一週,大多數年內都少於 7 天。一年中的第一週和最後一週除外的週總是 7 天。就 1 月 1 日為週日的年份,一年的第一週和上一年的最後一週有 7 天。
year 事件的四位數年份,例如 2020。
yearMonth 年度與月份 年和月份的加總值。範例值包含 202212 或 202301。
yearWeek 年度與週數 年和週的加總值。範例值包含 202253 或 202301。

自訂維度

Data API 可以建立以「事件」和「以使用者為範圍」自訂維度的報表。如要進一步瞭解自訂維度,請參閱「事件範圍自訂維度和指標報表」和「自訂使用者屬性」這兩篇文章。自訂維度是根據維度的參數名稱和範圍,在 API 報表要求中指定。舉例來說,在 Data API 要求中加入 "customEvent:achievement_id",就能針對以事件為範圍的自訂維度 (參數名稱為 "achievement_id") 製作報表。 如果資源尚未註冊這個以事件為範圍的自訂維度,這個 API 要求就會失敗。

如果以事件為範圍的自訂維度在 2020 年 10 月前登錄,則必須在 API 要求中指定該維度,及其事件名稱。舉例來說,請為以事件為範圍的自訂維度 (參數名稱 "achievement_id") 和事件名稱 "level_up" 加入 "customEvent:achievement_id\[level_up\]"。 自 2020 年 10 月起,Analytics (分析) 以事件範圍自訂維度和指標報表取代自訂參數報表

以下是自訂維度的一般語法。 您可以查詢 Metadata API 方法,藉此列出資源的所有自訂維度;請參閱使用中繼資料 API 方法的範例

一般 API 名稱 說明
customEvent:parameter_name 「parameter_name」的以事件為範圍自訂維度
customEvent:parameter_name[event_name] 於 2020 年 10 月前註冊的參數_name 以事件為範圍的自訂維度
customUser:parameter_name 「parameter_name」的以使用者為範圍自訂維度
customItem:parameter_name 「parameter_name」的以商品為範圍自訂維度

自訂管道群組

Data API 可以建立自訂管道群組的報表。如要進一步瞭解自訂管道群組,請參閱 GA4 中的自訂管道群組文章。 您可在 API 報表請求中,按維度範圍和管道群組 ID 指定自訂管道群組。 例如在 Data API 要求中加入 "sessionCustomChannelGroup:9432931",就能針對 ID 為 9432931 的工作階段範圍自訂管道建立報表。 如果資源沒有使用此 ID 的自訂管道,這個 API 要求就會失敗。

以下是自訂管道群組的通用語法。您可以查詢 Metadata API 方法,藉此列出資源的所有自訂管道群組。

一般 API 名稱 說明
sessionCustomChannelGroup:custom_channel_id 促成這個工作階段的自訂管道。
firstUserCustomChannelGroup:custom_channel_id 初次招攬到這位使用者的自訂管道。
customChannelGroup:custom_channel_id 促成轉換事件的自訂管道。

指標

您可以在任何資源的報表中要求下列指標。 在 Metric 資源的 name 欄位中,為報表回應中的指標資料欄指定「API 名稱」。

API 名稱 使用者介面名稱 說明
active1DayUsers 過去 1 天活躍的使用者人數 網站或應用程式在 1 天內的不重複活躍使用者人數。這 1 天包含報表日期範圍的最後一天。注意:此定義等同於「活躍使用者」。
active1DayUsers 過去 1 天活躍的使用者人數 網站或應用程式在 1 天內的不重複活躍使用者人數。這 1 天包含報表日期範圍的最後一天。注意:此定義等同於「活躍使用者」。
active28DayUsers 28 天活躍使用者 網站或應用程式在 28 天內的不重複活躍使用者人數。這 28 天包含報表日期範圍內的最後一天。
active7DayUsers 過去 7 天活躍的使用者人數 網站或應用程式在 7 天內的不重複活躍使用者人數。這 7 天包含報表日期範圍內的最後一天。
activeUsers 活躍使用者 曾造訪您網站或應用程式的不重複使用者人數。
adUnitExposure 廣告單元曝光 使用者看到廣告單元的時間 (以毫秒為單位)。
addToCarts 加入購物車 使用者將商品加入購物車的次數。
advertiserAdClicks 廣告點擊次數 使用者點按廣告觸及資源的總次數。包含來自已連結整合服務的點擊次數,例如連結的 Search Ads 360 廣告主。此外,也包括透過資料匯入上傳的點擊次數。
advertiserAdCost 廣告費用 您為廣告支付的總金額。包含已連結整合服務的費用,例如連結的 Google Ads 帳戶。此外,也包括透過資料匯入上傳的費用;詳情請參閱匯入費用資料
advertiserAdCostPerClick Google Ads 單次點擊出價 廣告單次點擊出價是指廣告費用除以廣告點擊,而且通常是縮寫的單次點擊出價。
advertiserAdCostPerConversion 單次轉換費用 單次轉換費用是廣告費用除以轉換次數。
advertiserAdImpressions 廣告曝光次數 曝光總數。包含來自已連結整合服務 (例如連結的 Display & Video 360 廣告主) 的曝光次數。此外,也包括透過資料匯入上傳的曝光次數。
averagePurchaseRevenue 平均購買收益 事件交易群組的平均購買收益。
averagePurchaseRevenuePerPayingUser 單一付費使用者平均收益 (ARPPU) 單一付費使用者平均收益 (ARPPU) 是指記錄了購買事件的每位活躍使用者的總購買收益。這個摘要指標適用於指定的時間範圍。
averagePurchaseRevenuePerUser 每位使用者的平均購買收益 「每位活躍使用者的平均購買收益」是指記錄任何事件的每位活躍使用者的總購買收益。這個摘要指標適用於指定的時間範圍。
averageRevenuePerUser 每位使用者的平均收益 (ARPU) 每位活躍使用者的平均收益 (ARPU)。這個摘要指標適用於指定的時間範圍。每位使用者的平均收益 (ARPU) 採用總收益,並包含 AdMob 預估收益。
averageSessionDuration 平均工作階段持續時間 使用者工作階段的平均時間長度 (以秒為單位)。
bounceRate 跳出率 未互動的工作階段百分比 (「工作階段」減去互動工作階段數) 除以「工作階段」數。這項指標會以小數形式傳回;舉例來說,0.2761 表示有 27.61% 的工作階段遭到跳出。
cartToViewRate 觀看後加到購物車率 將產品放進購物車的使用者人數除以曾經瀏覽同一產品的使用者人數。這項指標會以小數形式傳回;舉例來說,0.1132 代表看過產品的使用者中,有 11.32% 也將相同產品加入購物車。
checkouts 結帳 使用者啟動結帳程序的次數。這項指標會計算 begin_checkout 事件的出現次數。
cohortActiveUsers 同類群組活躍使用者 根據同類群組第 n 天/週/月,在同類群組中屬於活躍的使用者人數。舉例來說,若同類群組 NthWeek = 0001 的資料列,這項指標就是第 1 週的活躍使用者人數 (同類群組中)。
cohortTotalUsers 同類群組使用者總數 同類群組中的使用者總數。在報表中,每個同類群組的這個指標都是相同的值。由於同類群組是按共用的獲客日期定義,因此在同類群組選取日期範圍內,PeerTotalUsers 與 PeerActiveUsers 相同。如為比週期選擇範圍更晚的報表列,同類群組 ActiveUsers 通常會小於 PeerTotalUsers。此差異代表該同類群組中不久後處於活躍狀態的使用者。IDTotalUsers 經常用在指標運算式同類群組 ActiveUsers/cohortTotalUsers 中,計算同類群組的使用者留存率。ActiveUsers 和 totalUsers 之間的關係不等於 GroupActiveUsers 和 rootTotalUsers 之間的關係。
conversions 轉換 轉換事件的數量。事件在收集時會標示為轉換;事件的轉換標記會在日後生效。您可以在 Google Analytics (分析) 中將任何事件標示為轉換,有些事件 (例如 first_open、purchase) 都會根據預設標示為轉換。詳情請參閱「關於轉換」一文。
crashAffectedUsers 遇到當機情形的使用者人數 在報告的這一列中記錄當機事件的使用者人數。舉例來說,如果報表是按日期顯示時間序列,這項指標會回報當天至少有一次當機的使用者總數。當機事件是名為「app_exception」的事件。
crashFreeUsersRate 不受當機影響的使用者比率 未發生當機事件的使用者人數 (列在報表這一列) 除以使用者總數。這項指標會以小數形式傳回;舉例來說,0.9243 代表 92.43% 的使用者未遇到當機情形。
dauPerMau 每日活躍使用者/每月活躍使用者 (DAU/MAU) 同時也是 1 天活躍使用者的 30 天活躍使用者百分比。這項指標會以小數形式傳回;舉例來說,0.113 代表 30 天活躍使用者中有 11.3% 也是 1 天活躍使用者。
dauPerWau 每日活躍使用者/每週活躍使用者 (DAU/WAU) 同時也是 1 天活躍使用者的 7 天活躍使用者百分比。這項指標會以小數形式傳回;舉例來說,0.082 代表 8.2% 的 7 天活躍使用者也是 1 天的活躍使用者。
ecommercePurchases 電子商務購買 使用者完成購買的次數。這項指標會計入 purchase 個事件,但這項指標不會計入 in_app_purchase 和訂閱事件。
engagedSessions 互動工作階段 持續超過 10 秒、曾發生轉換事件,或瀏覽過 2 次以上畫面的工作階段數。
engagementRate 參與度 互動工作階段的百分比 (互動工作階段除以工作階段數)。這項指標會以小數形式傳回;舉例來說,0.7239 代表 72.39% 的工作階段是互動工作階段。
eventCount 事件計數 事件數。
eventCountPerUser 每位使用者的事件計數 每位使用者的平均事件數 (事件計數除以活躍使用者人數)。
eventValue 事件價值 名為 value 的事件參數總和。
eventsPerSession 每個工作階段的事件 每個工作階段的平均事件數 (事件計數除以工作階段數)。
firstTimePurchaserConversionRate 初次購買者轉換 初次完成購買的活躍使用者百分比。這項指標會以小數形式傳回;舉例來說,0.092 代表 9.2% 的活躍使用者是初次購買者。
firstTimePurchasers 初次購買者人數 初次完成購買事件的使用者人數。
firstTimePurchasersPerNewUser 新使用者轉換為初次購買者的數量 新使用者轉換為初次購買者的平均人數。
grossItemRevenue 商品總收益 僅限商品的總收益。商品總收益是指價格和數量的產品。商品收益不含稅金和運費;請在事件 (而非商品層級) 指定稅金和運費。商品總收益不含退款。
grossPurchaseRevenue 總購買收益 在應用程式或網站中完成購買所帶來的收益總和。總購買收益是下列事件的收益總額:purchaseecommerce_purchasein_app_purchaseapp_store_subscription_convertapp_store_subscription_renew。購買收益是由標記中的 value 參數指定。
itemDiscountAmount 商品折扣金額 電子商務事件中商品折扣的金額。系統會透過 discount 項目參數填入這項指標。
itemListClickEvents 商品清單點擊事件數 使用者點按清單上某個商品的次數。這項指標會計算 select_item 事件的出現次數。
itemListClickThroughRate 商品清單點閱率 選取名單的使用者人數除以曾經瀏覽同一名單的使用者人數。這項指標會以小數形式傳回;舉例來說,0.2145 表示在查看名單的使用者中,有 21.45% 也選擇了這份名單。
itemListViewEvents 商品清單瀏覽事件數 商品清單的瀏覽次數。這項指標會計算 view_item_list 事件的出現次數。
itemPromotionClickThroughRate 商品促銷點閱率 選取促銷活動的使用者人數除以曾經瀏覽同一促銷活動的使用者人數。這項指標會以小數形式傳回;舉例來說,0.1382 代表觀看促銷活動的使用者中,有 13.82% 也選擇了促銷活動。
itemRefundAmount 商品退款金額 「商品退款金額」是指商品的退款交易總收益。商品退款金額是指 refund 事件的價格和數量產品。
itemRevenue 商品收益 購買所帶來的總收益減去退還商品的退款交易收益。「商品收益」是指價格和數量的產品。商品收益不含稅金和運費;請在事件 (而非商品層級) 指定稅金和運費。
itemViewEvents 商品瀏覽事件數 商品詳情的瀏覽次數。這項指標會計算 view_item 事件的出現次數。
itemsAddedToCart 加入購物車的商品數 單一商品在購物車中加入的單位數。這項指標會計算 add_to_cart 事件中的項目數量。
itemsCheckedOut 結帳商品數 單一商品的結帳單位數。這項指標會計算 begin_checkout 事件中的項目數量。
itemsClickedInList 清單中點選過的商品數 單一商品在清單中點選的單位數。這項指標會計算 select_item 事件中的項目數量。
itemsClickedInPromotion 促銷活動中點選過的商品數 單一商品的促銷活動中點選的單位數。這項指標會計算 select_promotion 事件中的項目數量。
itemsPurchased 購買商品數 購買事件中單一商品的單位數。這項指標會計算購買事件中的商品數量。
itemsViewed 已看過的商品數 單一商品獲得瀏覽的單位數。這項指標會計算 view_item 事件中的項目數量。
itemsViewedInList 清單中已看過的商品數 單一商品在清單中瀏覽的單位數。這項指標會計算 view_item_list 事件中的項目數量。
itemsViewedInPromotion 促銷活動中已看過的商品數 單一商品的促銷活動中看過的單位數量。這項指標會計算 view_promotion 事件中的項目數量。
newUsers 新使用者 與網站初次互動或初次啟動應用程式 (事件觸發:first_open 或 first_visit) 的使用者人數。
organicGoogleSearchAveragePosition 自然 Google 搜尋平均排序 查詢帶出網站網址時,網站網址獲得的平均排名,由 Search Console 回報。舉例來說,進行某項查詢時網站網址的排序是第 3,進行另一項查詢時則是排序第 7,平均排序就是第 5,計算方式為 (3+7)/2。這項指標需要有效的 Search Console 連結。
organicGoogleSearchClickThroughRate 自然 Google 搜尋點閱率 Search Console 回報的自然 Google 搜尋點閱率。點閱率是指每次曝光所獲得的點擊次數。這項指標會以小數形式傳回;舉例來說,0.0588 代表約 5.88% 的曝光促成了點擊。這項指標需要有效的 Search Console 連結。
organicGoogleSearchClicks 自然 Google 搜尋點擊次數 Search Console 回報的自然 Google 搜尋點擊次數。這項指標需要有效的 Search Console 連結。
organicGoogleSearchImpressions 自然 Google 搜尋曝光次數 Search Console 回報的自然 Google 搜尋曝光次數。這項指標需要有效的 Search Console 連結。
promotionClicks 促銷資訊點擊次數 商品促銷活動的點按次數。這項指標會計算 select_promotion 事件的出現次數。
promotionViews 促銷資訊瀏覽次數 商品促銷活動的瀏覽次數。這項指標會計算 view_promotion 事件的出現次數。
publisherAdClicks 發布商廣告點擊 ad_click 事件的數量。
publisherAdImpressions 發布商廣告曝光次數 ad_impression 事件數。
purchaseRevenue 購買收益 購買收益總和減去應用程式或網站中退還的交易收益後,購買收益會加總下列事件的收益:purchaseecommerce_purchasein_app_purchaseapp_store_subscription_convertapp_store_subscription_renew。購買收益是由標記中的 value 參數指定。
purchaseToViewRate 觀看後購買率 購買產品的使用者人數除以曾經瀏覽同一產品的使用者人數。這項指標會以小數形式傳回;舉例來說,0.128 代表看過產品的使用者中,有 12.8% 也購買了相同產品。
purchaserConversionRate 購買者轉換 完成一或多次購買交易的活躍使用者百分比。這項指標會以小數形式傳回;舉例來說,0.412 代表 41.2% 的使用者是購買者。
refundAmount 退款金額 退款交易總收益。退款金額是 refundapp_store_refund 事件的退款收益總和。
returnOnAdSpend 廣告投資報酬率 廣告投資報酬率 (ROAS) 是指總收益除以廣告客戶廣告費用所得的值。
screenPageViews 檢視表 使用者瀏覽的應用程式畫面或網頁數量。重複瀏覽同一個網頁或畫面也會列入計算。(screen_view 與 page_view 事件)。
screenPageViewsPerSession 每個工作階段的瀏覽次數 使用者在每個工作階段瀏覽的應用程式畫面或網頁數量。重複瀏覽同一個網頁或畫面也會列入計算。將 screen_view 與 page_view 事件的數量加總,然後除以工作階段數。
screenPageViewsPerUser 每位使用者的觀看次數 每位活躍使用者所瀏覽的應用程式畫面或網頁數量。重複瀏覽同一個網頁或畫面也會列入計算。將 screen_view 與 page_view 事件的數量加總,然後除以活躍使用者人數。
scrolledUsers 已捲動的使用者 向下捲動網頁至少 90% 的不重複使用者人數。
sessionConversionRate 工作階段轉換率 觸發轉換事件的工作階段百分比。
sessions 工作階段 在網站或應用程式上開始的工作階段數 (事件觸發:session_start)。
sessionsPerUser 每位使用者的工作階段 每位使用者的平均工作階段數 (工作階段數除以活躍使用者人數)。
shippingAmount 運費 與交易相關聯的運費。由 shipping 事件參數填入。
taxAmount 稅額 與交易相關聯的稅額。由 tax 事件參數填入。
totalAdRevenue 廣告收益總額 AdMob 和第三方來源帶來的廣告收益總額。
totalPurchasers 購買者總人數 指定時間範圍內記錄購買事件的使用者人數。
totalRevenue 總收益 購買、訂閱及廣告的收益總和 (購買收益加上訂閱收益加上廣告收益) 減去退款的交易收益。
totalUsers 使用者總數 記錄至少一項事件的不重複使用者人數 (不論該事件記錄時是否使用網站或應用程式)。
transactions 交易 含有購買收益的交易事件數量。交易事件包括 in_app_purchase、ecommerce_purchase、purchase、app_store_subscription_renew、app_store_subscription_convert 和 refund。
transactionsPerPurchaser 每個購買者的交易 每位購買者的平均交易次數。
userConversionRate 使用者轉換率 觸發任何轉換事件的使用者百分比。
userEngagementDuration 使用者參與 您網站或應用程式於使用者裝置前景運作的總時間 (以秒為單位)。
wauPerMau 每週活躍使用者/每月活躍使用者 (WAU/MAU) 同時也是 7 天活躍使用者的 30 天活躍使用者百分比。這項指標會以小數形式傳回;舉例來說,0.234 代表 30 天活躍使用者中有 23.4% 也是 7 天的活躍使用者。

自訂指標

Data API 可以建立以事件為範圍的自訂指標製作報表。 如要進一步瞭解自訂指標,請參閱「事件範圍自訂維度和指標報表」一文。自訂指標是在 API 報表要求中按照指標的參數名稱和範圍指定。舉例來說,在 Data API 要求中加入 "customEvent:levels_unlocked",就能針對以事件為範圍的自訂指標 (參數名稱為 "levels_unlocked") 製作報表。 如果資源尚未註冊這個以事件為範圍的自訂指標,這個 API 要求就會失敗。

如果以事件為範圍的自訂指標在 2020 年 10 月前註冊,則必須在 API 要求中指定指標,且該指標的事件名稱。例如,請為以事件為範圍的自訂指標 (參數名稱 "levels_unlocked") 和事件名稱 "tutorial_start" 加入 "customEvent:levels_unlocked\[tutorial_start\]"。自 2020 年 10 月起,Analytics (分析) 以事件範圍自訂維度和指標報表取代自訂參數報表

以下是自訂指標的一般語法。您可以查詢 Metadata API 方法,藉此列出資源的所有自訂指標;請參閱使用 Metadata API 方法的範例

一般 API 名稱 說明
customEvent:parameter_name 「parameter_name」的以事件為範圍自訂指標
customEvent:parameter_name[event_name] 針對 2020 年 10 月前註冊的參數,「parameter_name」的以事件為範圍自訂指標

自訂指標變化版本

資源登錄的每個自訂指標會建立三個 API 指標變化版本:總和、平均值和計數。 大多數的要求會使用自訂指標的總和。自訂指標的平均值有助於取得統計資料摘要。 如果對參數出現的次數有幫助,自訂指標的數量就很有意義。

您可以查詢 Metadata API 方法,藉此列出資源中所有自訂指標的變化版本。請參閱使用 Metadata API 方法來自訂平均值的範例

一般 API 名稱 說明
customEvent:parameter_name 「parameter_name」的以事件為範圍自訂指標的總和
averageCustomEvent:parameter_name 「parameter_name」的以事件為範圍自訂指標的平均值
countCustomEvent:parameter_name 「parameter_name」的以事件為範圍自訂指標的出現次數

單次轉換的轉換率指標

您在資源上登錄的每個轉換事件都會建立轉換率指標,供您在報表中要求使用。每項轉換都有兩種轉換率指標:一次轉換的工作階段式轉換率和以使用者為準的轉換率。

您可以查詢 Metadata API 方法,藉此列出資源中特定轉換的所有轉換率指標。如果您嘗試為未登錄為轉換的事件要求轉換率,該要求就會失敗。以下舉例說明如何使用 Metadata API 方法計算單次轉換的轉換率指標

一般 API 名稱 說明
sessionConversionRate:event_name 特定轉換事件觸發的工作階段百分比。
userConversionRate:event_name 觸發特定轉換事件的使用者百分比。