Analytics (分析) Data API 漏斗報表支援下列維度和指標。
尺寸
您可以在任何資源的漏斗報表中要求下列維度。
在 Dimension 資源的 name 欄位中指定「API 名稱」。
| API 名稱 | 使用者介面名稱 | 可在區隔中使用 | 說明 |
|---|---|---|---|
| achievementId | 成就 ID | 可 | 事件在遊戲中的成就 ID。由事件參數 achievement_id 填入。 |
| adFormat | 廣告格式 | 可 | 說明廣告的外觀和位置。一般格式包括 Interstitial、Banner、Rewarded 和 Native advanced。 |
| adSourceName | 廣告來源 | 否 | 放送廣告的來源聯播網。常見來源包括 AdMob Network、Liftoff、Facebook Audience Network 和 Mediated house ads。 |
| adUnitName | 廣告單元 | 否 | 您選擇用來描述這個廣告單元的名稱。「廣告單元」是您放在應用程式中的容器，可向使用者顯示廣告。 |
| appVersion | 應用程式版本 | 可 | 應用程式的 versionName (Android) 或簡短版軟體包版本編號 (iOS)。 |
| audienceId | 目標對象 ID | 否 | 目標對象的數字 ID。在報表日期範圍內，使用者會記錄於所屬的目標對像中。目前的使用者行為不會影響報表中的歷來目標對象成員。 |
| audienceName | 目標對象名稱 | 否 | 目標對象的指定名稱。在報表日期範圍內，使用者會記錄於所屬的目標對像中。目前的使用者行為不會影響報表中的歷來目標對象成員。 |
| brandingInterest | 興趣喜好 | 否 | 位於購物程序前端的使用者展現的興趣。使用者可能會歸入多個興趣類別，例如 Shoppers、Lifestyles & Hobbies/Pet Lovers 或 Travel/Travel Buffs/Beachbound Travelers。 |
| browser | 瀏覽器 | 可 | 用來瀏覽您網站的瀏覽器。 |
| campaignId | 廣告活動 ID | 否 | 行銷廣告活動的 ID。僅針對轉換事件顯示。 |
| campaignName | 廣告活動 | 否 | 行銷廣告活動名稱。僅針對轉換事件顯示。 |
| 個字元 | 字元 | 可 | 事件中玩家扮演的遊戲角色。由事件參數 character 填入。 |
| city | 城市 | 可 | 使用者活動的來源城市。 |
| cityId | 城市 ID | 可 | 使用者活動的來源城市地理區域 ID (依 IP 位址推算)。 |
| 同類群組 | 同類群組 | 否 | 要求中的同類群組名稱。「同類群組」是指一群連續幾天開始使用網站或應用程式的使用者。如果要求中未指定同類群組名稱，系統會按照零以索引為同類群組命名，例如同類群組_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 填入。 |
| country | 國家/地區 | 可 | 使用者活動的來源國家/地區。 |
| countryId | 國家/地區 ID | 可 | 使用者活動的來源國家/地區地理區域 ID (依 IP 位址推測)。採用 ISO 3166-1 alpha-2 標準格式。 |
| 日期 | 日期 | 可 | 事件日期，格式為 YYYYMMDD。 |
| dateHour | 日期 + 小時 (YYYYMMDDHH) | 否 | 格式為 YYYYMMDDHH 的日期和小時總值。 |
| dateHourMinute | 日期小時和分鐘 | 否 | 日期、小時和分鐘的加總值，格式為 YYYYMMDDHHMM。 |
| 天 | 第幾天 | 可 | 每月第幾日，以 01 到 31 的兩位數表示。 |
| dayOfWeek | 星期幾 | 可 | 星期幾。此方法會以星期日為一週的第一天，傳回 [0,6] 範圍中的值。 |
| defaultChannelGrouping | 預設管道分組 | 否 | 轉換的預設管道分組主要取決於來源和媒介。列舉，包括 Direct、Organic Search、Paid Social、Organic Social、Email、Affiliates、Referral、Paid Search、Video 和 Display。 |
| deviceCategory | 裝置類別 | 可 | 裝置類型：桌機、平板電腦或手機。 |
| deviceModel | 裝置型號 | 可 | 行動裝置型號 (例如：iPhone 10,6)。 |
| eventName | 事件名稱 | 可 | 事件的名稱。 |
| fileExtension | 副檔名 | 可 | 下載檔案的副檔名 (例如 pdf 或 txt)。如果啟用加強型評估功能，則會自動填入。由事件參數 file_extension 填入。 |
| fileName | 「File name」 | 可 | 下載檔案的網頁路徑 (例如 /menus/dinner-menu.pdf)。如果啟用加強型評估功能，則會自動填入。由事件參數 file_name 填入。 |
| firstSessionDate | 最初工作階段日期 | 可 | 使用者初次工作階段的發生日期，格式為 YYYYMMDD。 |
| firstUserCampaignId | 最初使用者廣告活動 ID | 否 | 最初招攬到使用者的行銷廣告活動 ID。包括 Google Ads 廣告活動。 |
| firstUserCampaignName | 最初使用者廣告活動 | 可 | 初次招攬到使用者的行銷廣告活動名稱；包括 Google Ads 和手動廣告活動。 |
| firstUserDefaultChannelGrouping | 最初使用者預設管道分組 | 可 | 初次招攬到使用者的預設管道分組。預設管道分組主要取決於來源和媒介。列舉，包括 Direct、Organic Search、Paid Social、Organic Social、Email、Affiliates、Referral、Paid Search、Video 和 Display。 |
| firstUserGoogleAdsAccountName | 最初招攬到使用者的 Google Ads 帳戶名稱 | 否 | 初次招攬到使用者的 Google Ads 帳戶名稱。 |
| firstUserGoogleAdsAdGroupId | 最初招攬到使用者的 Google Ads 廣告群組 ID | 否 | 最初招攬到使用者的 Google Ads 廣告群組 ID。 |
| firstUserGoogleAdsAdGroupName | 最初招攬到使用者的 Google Ads 廣告群組名稱 | 否 | 最初招攬到使用者的 Google Ads 廣告群組名稱。 |
| firstUserGoogleAdsAdNetworkType | 最初招攬到使用者的 Google Ads 廣告聯播網類型 | 可 | 初次招攬到使用者的廣告聯播網。列舉，包含 Google search、Search partners、Google Display Network、Youtube Search、Youtube Videos、Cross-network、Social 和 (universal campaign)。 |
| 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 | 最初使用者來源/媒介 | 否 | 維度 firstUserSource 和 firstUserMedium 的加總值。 |
| firstUserSourcePlatform | 最初使用者來源平台 | 否 | 初次招攬到使用者的來源平台，針對使用 Urchin 流量監視器 (UTM) 的流量，請勿使用傳回 Manual 的欄位。為即將推出的功能推出，這個欄位將從傳回 Manual 更新為傳回 (not set)。 |
| fullPageUrl | 完整網頁網址 | 否 | 所造訪網頁的主機名稱、網頁路徑和查詢字串；舉例來說，https://www.example.com/store/contact-us?query_string=true 的 fullPageUrl 部分是 www.example.com/store/contact-us?query_string=true。 |
| funnelStepName | 步驟 | 否 | 為漏斗步驟指定的描述性名稱。舉例來說，如果在要求的第三個漏斗步驟中指定 name = Purchase，即可在漏斗報表回應中針對這個funnelStepName維度產生 3. Purchase。 |
| funnelStepNewVsContinuing | 新與現有維度比較 | 否 | 如果使用者出現在前段漏斗步驟，就要繼續進入漏斗步驟。否則，該使用者是新使用者。這個維度只適用於開放式漏斗，且會傳回兩個值：new 和 continuing。 |
| funnelStepNextAction | 漏斗後續操作 | 否 | 下一個動作是使用者完成目前步驟後獲得的下一個維度值，包括完成後續步驟。舉例來說，如果要求的下一個動作維度是 eventName，這個維度會在完成第 1 個步驟後傳回下一個事件的名稱；這個下一個動作不包含完成第 1 步的事件，且包含完成 i+1 步驟的事件。 |
| googleAdsAccountName | Google Ads 帳戶名稱 | 否 | Google Ads 中的帳戶名稱，適用於促成轉換事件的廣告活動。對應 Google Ads API 中的 customer.descriptive_name。 |
| googleAdsAdGroupId | Google Ads 廣告群組 ID | 否 | 歸因於轉換事件的廣告群組 ID。 |
| googleAdsAdGroupName | Google Ads 廣告群組名稱 | 否 | 促成轉換事件的廣告群組名稱。 |
| googleAdsAdNetworkType | Google Ads 廣告聯播網類型 | 否 | 轉換的廣告聯播網類型。列舉，包含 Google search、Search partners、Google Display Network、Youtube Search、Youtube Videos、Cross-network、Social 和 (universal campaign)。 |
| 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。 |
| 小時 | 小時 | 可 | 記錄事件當天的兩位數小時。這項維度的範圍介於 0 到 23 之間，以資源所在時區為準。 |
| isConversionEvent | 是轉換事件 | 可 | 如果事件是轉換，則字串 true。事件在收集時會標示為轉換；事件的轉換標記會在日後生效。您可以在 Google Analytics (分析) 中將任何事件標示為轉換，有些事件 (例如 first_open、purchase) 都會根據預設標示為轉換。詳情請參閱「關於轉換」一文。 |
| 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 | 商品清單名稱 | 否 | 商品清單的名稱。 |
| itemName | 商品名稱 | 否 | 商品名稱。 |
| itemPromotionCreativeName | 商品促銷廣告素材名稱 | 否 | 商品促銷廣告素材的名稱。 |
| itemPromotionId | 商品促銷 ID | 否 | 商品促銷的 ID。 |
| itemPromotionName | 商品促銷活動名稱 | 否 | 商品促銷活動的名稱。 |
| itemVariant | 商品子類 | 否 | 產品的特定子類，例如 XS、S、M、L 等尺寸，或紅色、藍色、綠色、黑色等顏色。由 item_variant 參數填入。 |
| landingPage | 到達網頁 | 可 | 與工作階段中第一次網頁瀏覽相關聯的網頁路徑 + 查詢字串。 |
| 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 參數填入。 |
| 媒介 | 中 | 否 | 帶來轉換事件的媒介。 |
| method | 方法 | 可 | 事件觸發方式。由事件參數 method 填入。 |
| 分鐘 | 分鐘 | 否 | 記錄事件當天的兩位數 (以兩位數表示)。這項維度的範圍介於 0 到 59 之間，以資源所在時區為準。 |
| mobileDeviceBranding | 裝置品牌 | 可 | 製造商或品牌名稱 (例如：Samsung、HTC、Verizon 和 T-Mobile)。 |
| mobileDeviceMarketingName | 裝置 | 可 | 品牌裝置名稱 (例如 Galaxy S10 或 P30 Pro)。 |
| mobileDeviceModel | 行動裝置型號 | 可 | 行動裝置型號名稱 (例如 iPhone X 或 SM-G950F)。 |
| 個月 | 月份 | 可 | 事件的月份，以 01 到 12 的兩位數整數表示。 |
| newVsReturning | 新使用者/回訪者 | 可 | 新使用者過去 0 個工作階段，而回訪者先前有 1 或多個工作階段。這個維度會傳回兩個值：new 或 returning。 |
| 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 | 訂單優待券 | 可 | 訂單層級優待券的代碼編號。 |
| 出城 | 出城 | 可 | 如果連結導向的網站不屬於資源的網域，則傳回 true。啟用加強型評估功能時自動填入功能。由事件參數 outbound 填入。 |
| pageLocation | 網頁位置 | 可 | 所造訪網頁的通訊協定、主機名稱、網頁路徑和查詢字串；舉例來說，https://www.example.com/store/contact-us?query_string=true 的 pageLocation 部分是 https://www.example.com/store/contact-us?query_string=true。由事件參數 page_location 填入。 |
| pagePath | 網頁路徑 | 否 | 所造訪網頁主機名稱和查詢字串之間的部分，例如 https://www.example.com/store/contact-us?query_string=true 的 pagePath 部分是 /store/contact-us。 |
| pagePathPlusQueryString | 網頁路徑 + 查詢字串 | 可 | 網址中造訪網頁主機名稱後面的部分；舉例來說，https://www.example.com/store/contact-us?query_string=true 的 pagePathPlusQueryString 部分是 /store/contact-us?query_string=true。 |
| pageReferrer | 網頁參照網址 | 可 | 完整的參照網址，包含主機名稱和路徑。這個參照網址是指使用者先前所在的網址，可以是這個網站的網域或其他網域。由事件參數 page_referrer 填入。 |
| pageTitle | 網頁標題 | 可 | 您網站使用的網頁標題。 |
| percentScrolled | 已捲動的百分比 | 可 | 使用者向下捲動網頁的百分比 (例如 90)。如果已啟用加強型評估功能，則會自動填入。由事件參數 percent_scrolled 填入。 |
| platform | 平台 | 可 | 您應用程式或網站的運作平台，例如網路、iOS 或 Android。如要判斷報表中的串流類型，請同時使用 Platform 和 streamId。 |
| platformDeviceCategory | 平台/裝置類別 | 可 | 執行網站或行動應用程式的平台和裝置類型。(例如：Android / 行動裝置) |
| 地區 | 單一區域 | 可 | 使用者活動的來源地理區域 (依使用者的 IP 位址推算)。 |
| screenResolution | 螢幕解析度 | 可 | 使用者螢幕的解析度。例如 1920x1080。 |
| searchTerm | 搜尋字詞 | 可 | 使用者搜尋的字詞。舉例來說，如果使用者造訪 /some-page.html?q=some-term，這項維度就會傳回 some-term。啟用加強型評估功能時自動填入功能。由事件參數 search_term 填入。 |
| 區隔 | 區隔 | 否 | 區隔是 Analytics (分析) 中的一小部分資料。以您的整個使用者群為例，某個區隔可能是來自特定國家/地區或城市的使用者，詳情請參閱「區隔建立工具」一文。區隔維度會傳回要求中的區隔名稱，其中包含以 1 開頭的前置字元 (也就是說，如果要求中第一個區隔的名稱為 Paid Traffic，則這個區隔在回應中就會是 1. Paid Traffic)。如果要求中未指定區隔名稱，區隔會以 1 為主的名稱命名 (例如 1. Segment、2. Segment 等)。 |
| sessionCampaignId | 工作階段廣告活動 ID | 否 | 工作階段的行銷廣告活動 ID。包括手動廣告活動和來自 Google Ads 和 Search Ads 360 等整合連結產生的手動廣告活動和廣告活動。 |
| sessionCampaignName | 工作階段廣告活動 | 可 | 工作階段的行銷廣告活動名稱。包括手動廣告活動和來自 Google Ads 和 Search Ads 360 等整合連結產生的手動廣告活動和廣告活動。 |
| sessionDefaultChannelGrouping | 工作階段預設管道分組 | 可 | 工作階段的預設管道分組主要取決於來源和媒介。列舉，包括 Direct、Organic Search、Paid Social、Organic Social、Email、Affiliates、Referral、Paid Search、Video 和 Display。 |
| 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 search、Search partners、Google Display Network、Youtube Search、Youtube Videos、Cross-network、Social 和 (universal campaign)。 |
| 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 關鍵字文字 | 否 | 促成工作階段的相符關鍵字。關鍵字是指您選擇用來描述所宣傳產品/服務的字詞或詞組，讓您向合適的客戶放送廣告。若要進一步瞭解「關鍵字」，請參閱 [關鍵字：定義 |
](//support.google.com/google-ads/answer/6323).
sessionGoogleAdsQuery | 工作階段 Google Ads 查詢 | 否 | 促成工作階段的搜尋查詢。
sessionManualAdContent | 工作階段手動廣告素材 | 是 | 促成工作階段的廣告內容。由 utm_content 參數填入。sessionManualTerm | 工作階段手動字詞 | 是 | 促成工作階段的字詞。由 utm_term 參數填入。sessionMedium | 工作階段 媒介 | 是 | 在網站或應用程式上啟動工作階段的媒介。
sessionSa360 廣告群組名稱 | 工作階段 SA360 廣告群組名稱 | 否 | 這個工作階段的 Search Ads 360 廣告群組名稱，促成這個工作階段。
sessionSa360CampaignName | Session 360CampaignName例如，Responsive search ad 或 Expanded text ad。詳情請參閱「GA4 流量來源維度」一文。
sessionSa360EngineAccountId | 工作階段 SA360 引擎帳戶 ID | 否 | 促成這個工作階段的 SA360 引擎帳戶 ID。
sessionSa360EngineAccountName | SA360 引擎帳戶名稱的工作階段 SA360 引擎帳戶名稱 | SA360 引擎帳戶名稱。
例如 google ads、bing 或 baidu。
sessionSa360Keyword | Session SA360 關鍵字文字 | 否 | 促成這個工作階段的 Search Ads 360 搜尋引擎關鍵字。
sessionSa360Medium | Session SA360 medium | 否 | 促成這個工作階段的 Search Ads 360 搜尋引擎關鍵字。例如 cpc。sessionSa360Query | Session SA360 查詢 | 否 | 促成這個工作階段的 Search Ads 360 搜尋查詢。
sessionSa360Source | 工作階段 SA360 來源 | 否 | 促成這個工作階段的 Search Ads 360 流量來源。例如 example.com 或 google。sessionSource | 工作階段來源 | 是 | 在您的網站或應用程式上啟動工作階段的來源。sessionSourceMedium | 工作階段來源 / 媒介 | 否 | 維度 sessionSource 和 sessionMedium 的加總值。sessionSourcePlatform | 工作階段來源平台 | 否 | 工作階段廣告活動的來源平台。針對使用 Urchin 流量監視器 (UTM) 的流量，請勿依賴傳回 Manual 的欄位；為即將推出的功能推出，這個欄位將從 Manual 傳回為傳回 (not set)。運送層級 | 運送層級 | 否 | 選擇送貨商品的運送層級 (例如「陸運」、「空運」、「次日」)。由 shipping_tier 事件參數填入。
signedInWithUserId | 以 User-ID 登入 | 是 | 如果使用者透過 User-ID 功能登入，則為 yes 字串。如要進一步瞭解 User-ID，請參閱「利用 User-ID 評估跨平台活動」。來源 | 來源 | 否 | 歸因於轉換事件的來源。來源媒介 | 來源 / 媒介 | 否 | 維度 source 和 medium 的合併值。sourcePlatform | 來源平台 | 否 | 轉換事件廣告活動的來源平台。針對使用 Urchin 流量監視器 (UTM) 的流量，請勿使用傳回 Manual 的欄位；這個欄位將從 Manual 更新為傳回 (not set)，以推出即將推出的功能。
streamId | 串流 ID | 是 | 您應用程式的數字資料串流 ID。
streamName | 串流名稱 | 是 | 應用程式或網站的資料串流名稱。
testDataFilterName | 測試資料篩選器名稱 | 否 | 測試狀態中資料篩選器的名稱。您可以使用資料篩選器，在報表中根據事件參數值納入或排除事件資料。詳情請參閱「資料篩選器」一文。
transactionId | 交易 ID | 是 | 電子商務交易的「是」條件 (影片) |「是」影片類別使用者。
youtube由事件參數 video_provider 填入。videoTitle | 影片標題 | 是 | 影片標題。如果啟用加強型評估功能，則會自動填入內嵌影片。由事件參數 video_title 填入。videoUrl | 影片網址 | 是 | 影片網址。如果啟用加強型評估功能，則會自動填入內嵌影片。由事件參數 video_url 填入。虛擬貨幣名稱 | 虛擬貨幣名稱 | 是 | 使用者互動時使用的虛擬貨幣名稱。例如在遊戲中消費或購買寶石。由 virtual_currency_name 事件參數填入。顯示 | 顯示 | 是 | 如果內容顯示，則傳回 true。如果啟用加強型評估功能，則會自動填入內嵌影片。由事件參數 visible 填入。週 | 週 | 是 | 活動當週 (01 到 53 的兩位數)。每週從星期日開始。1 月 1 日一律為第 1 週。每年第一週和最後一週，大多數年內都少於 7 天。一年中的第一週和最後一週除外的週總是 7 天。就 1 月 1 日為週日的年份，該年第一週和上一年的最後一週有 7 天。
年 | 年 | 是 | 活動的四位數年份，例如 2020。
自訂維度
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 方法，藉此列出資源的所有自訂維度；以下是使用 Metadata API 方法的範例。
| 一般 API 名稱 | 可在區隔中使用 | 說明 |
|---|---|---|
| customEvent:parameter_name | 可 | 「parameter_name」的以事件為範圍自訂維度 |
| customEvent:parameter_name[event_name] | 可 | 於 2020 年 10 月前註冊的參數_name 以事件為範圍的自訂維度 |
| customUser: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 | 促成轉換事件的自訂管道。 |
指標
您可以在任何資源的漏斗報表中，查看下列指標。
| API 名稱 | 使用者介面名稱 | 說明 |
|---|---|---|
| activeUsers | 活躍使用者 | 曾造訪您網站或應用程式的不重複使用者人數。 |
| funnelStepAbandonmentRate | 放棄率 | 在這個步驟中放棄漏斗的使用者百分比。這項指標會以小數形式傳回；舉例來說，0.412 代表 41.2% 的使用者在這個步驟中放棄程序。 |
| funnelStepAbandonments | 放棄 | 在這個步驟中放棄漏斗的絕對使用者人數。 |
| funnelStepCompletionRate | 播放完成率 | 完成這個漏斗步驟的使用者百分比。這項指標會以小數形式傳回；舉例來說，0.588 代表 58.8% 的使用者完成這個漏斗步驟。 |