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 位址)。 |
| 同類群組 | 同類群組 | 否 | 要求中的同類群組名稱。同類群組是指連續幾天開始使用您網站或應用程式的一組使用者。如未在要求中指定同類群組名稱，系統會按照其零為基準的索引來命名同類群組，例如：groups_0、groups_1。 |
| cohortNthDay | 單日同類群組 | 否 | 同類群組中使用者首次工作階段日期的相對日期偏移值。舉例來說，如果選取的同類群組的開始和結束日期為 2020-03-01，那麼 2020-03-02 日期就會是 groupsNthDay 的 0001。 |
| cohortNthMonth | 單月同類群組 | 否 | 同類群組中使用者首次工作階段日期的月份偏移值。月邊界與日曆月份界線一致。舉例來說，如果選取的同類群組在 2020 年 3 月的開始和結束日期，則 2020 年 4 月的任何日期同類群組為 0001。 |
| cohortNthWeek | 單週同類群組 | 否 | 同類群組中使用者最初工作階段日期的相對週偏移量。一週是從星期日開始，到星期六結束。舉例來說，如果選取的同類群組的開始和結束日期介於 2020-11-08 至 2020-11-14，則 2020-11-15 至 2020-11-21 之間的同類群組將為 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，則這個維度會在完成第 i 步驟後傳回下一個事件的名稱；此動作不含進行 i'th 步驟的事件，且包含完成 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。如要在報表中判斷串流類型，請同時使用平台和 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 關鍵字文字 | 否 | 促成工作階段的相符關鍵字。關鍵字是描述產品或服務的字詞或詞組，用來向合適的客戶放送廣告。如要進一步瞭解關鍵字，請參閱「關鍵字：定義」一文。 |
| sessionGoogleAdsQuery | 工作階段 Google Ads 查詢 | 否 | 促成工作階段的搜尋查詢。 |
| sessionManualAdContent | 工作階段手動廣告素材 | 可 | 促成工作階段的廣告素材。由 utm_content 參數填入。 |
| sessionManualTerm | 工作階段手動字詞 | 可 | 促成工作階段的字詞。由 utm_term 參數填入。 |
| sessionMedium | 工作階段媒介 | 可 | 在網站或應用程式中啟動工作階段的媒介。 |
| sessionSa360AdGroupName | 工作階段 SA360 廣告群組名稱 | 否 | 促成此工作階段的 Search Ads 360 廣告群組名稱。 |
| sessionSa360CampaignName | 工作階段 SA360 廣告活動 | 否 | 促成這個工作階段的 Search Ads 360 廣告活動名稱。 |
| sessionSa360CreativeFormat | 工作階段 SA360 廣告格式 | 否 | 促成這個工作階段的 Search Ads 360 廣告素材類型。例如，Responsive search ad 或 Expanded text ad。詳情請參閱「GA4 流量來源維度」一文。 |
| sessionSa360EngineAccountId | 工作階段 SA360 引擎帳戶 ID | 否 | 促成這個工作階段的 SA360 引擎帳戶 ID。 |
| sessionSa360EngineAccountName | 工作階段 SA360 引擎帳戶名稱 | 否 | 促成這個工作階段的 SA360 引擎帳戶名稱。 |
| sessionSa360EngineAccountType | 工作階段 SA360 引擎帳戶類型 | 否 | 促成此工作階段的 Search Ads 360 引擎帳戶類型。例如 google ads、bing 或 baidu。 |
| sessionSa360Keyword | 工作階段 SA360 關鍵字文字 | 否 | 促成此工作階段的 Search Ads 360 搜尋引擎關鍵字。 |
| sessionSa360Medium | 工作階段 SA360 媒介 | 否 | 促成此工作階段的 Search Ads 360 搜尋引擎關鍵字。例如 cpc。 |
| sessionSa360Query | 工作階段 SA360 查詢 | 否 | 促成這個工作階段的 Search Ads 360 搜尋查詢。 |
| sessionSa360Source | 工作階段 SA360 來源 | 否 | 促成這個工作階段的 Search Ads 360 流量來源。例如 example.com 或 google |
| sessionSource | 工作階段來源 | 可 | 在網站或應用程式中啟動工作階段的來源。 |
| sessionSourceMedium | 工作階段來源/媒介 | 否 | sessionSource 和 sessionMedium 維度的加總值。 |
| sessionSourcePlatform | 工作階段來源平台 | 否 | 工作階段廣告活動的來源平台。如為使用 Urchin 流量監視器 (UTM) 的流量，請勿仰賴這個欄位傳回 Manual。即將推出功能發布，這個欄位會從傳回 Manual 更新為傳回 (not set)。 |
| shippingTier | 運送層級 | 否 | 為交付所購買商品而選取的運送層級 (例如「陸運」、「空運」、「次日送達」)。由 shipping_tier 事件參數填入。 |
| signedInWithUserId | 已使用 User ID 登入 | 可 | 如果使用者透過 User-ID 功能登入，字串 yes。如要進一步瞭解 User-ID，請參閱「使用 User-ID 評估跨平台活動」一文。 |
| 來源 | 來源 | 否 | 帶來轉換事件的來源。 |
| sourceMedium | 來源/媒介 | 否 | source 和 medium 維度的加總值。 |
| sourcePlatform | 來源平台 | 否 | 轉換事件廣告活動的來源平台。如為使用 Urchin 流量監視器 (UTM) 的流量，請勿仰賴這個欄位傳回 Manual。即將推出功能發布，這個欄位會從傳回 Manual 更新為傳回 (not set)。 |
| streamId | 串流 ID | 可 | 應用程式或網站的資料串流 ID (數字)。 |
| streamName | 串流名稱 | 可 | 應用程式或網站的資料串流名稱。 |
| 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 事件參數填入。 |
| 顯示 | 可見 | 可 | 如果顯示內容，則傳回 true。啟用加強型評估功能後，系統會自動填入內嵌影片的資料。由事件參數 visible 填入。 |
| 週 | 週 | 可 | 事件當週，以 01 到 53 的兩位數表示。每週從星期日開始。1 月 1 日一律在第 01 週。每年首週和上週的最後一週都少於 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\]"。Analytics (分析) 於 2020 年 10 月將自訂參數報表替換為以事件為範圍的自訂維度和指標報表。
以下是自訂維度的一般語法。您可以查詢 Metadata API 方法，列出某個資源的所有自訂維度。請參考使用 Metadata API 方法的範例。
| 一般 API 名稱 | 可在區隔中使用 | 說明 |
|---|---|---|
| customEvent:parameter_name | 可 | 以事件為範圍的自訂維度 (param_name) |
| customEvent:parameter_name[event_name] | 可 | 以事件為範圍的自訂維度 (僅限 2020 年 10 月前註冊) |
| 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% 的使用者完成這個漏斗步驟。 |