[UA→GA4] 從analytics.js 升級至gtag.js 的訣竅

事件; 自訂維度和指標. gtag.js 程式碼片段簡介. 如果您目前的通用Analytics (分析) 資源使用 ... 跳至主內容[UA→GA4]從analytics.js升級至gtag.js的訣竅本文旨在協助網站擁有者瞭解通用Analytics(分析)資源的analytics.js如何對應至GoogleAnalytics(分析)4資源的gtag.js，以及提供更詳盡的導入指南。

本文假設您已建立GoogleAnalytics(分析)4資源。

如果您只需在網頁中加入基本評估程式碼，請改為參閱這些操作說明。

本文內容： gtag.js程式碼片段簡介 基本資料收集 gtag.js的配置設定 事件 自訂維度和指標 gtag.js程式碼片段簡介 如果您目前的通用Analytics(分析)資源使用analytics.js，就需要為新的GoogleAnalytics(分析)4資源添加gtag.js程式碼片段。

gtag.js程式碼片段的結構如下： 01:"> 02: 第7行程式碼：gtag的「config」指令能為資源收集與相關聯的資料。

舉例來說，如果您在GoogleAnalytics(分析)4資源中加入這個含評估ID的指令，系統會將page_view事件傳送給該資源。

資源ID可用來代表不同Google產品的評估ID，包括通用Analytics(分析)資源(「UA-XXXXXXXX」)、GoogleAnalytics(分析)4資源(「G-XXXXXXXX)、GoogleAds(「AW-XXXXXXXX」)或Floodlight(「DC-XXXXXXXX」)。

第11行程式碼：gtag的「event」指令會傳送事件。

如果程式碼片段中有多個資源的「config」指令，系統會將事件傳送給「所有」資源。

以本例來說，「sign_up」參數是事件名稱，最後一個參數則是包含一組事件參數的物件；在本例中，「method」這個參數包含「email」值。

第13行程式碼：這裡的事件包含「send_to」這個特殊參數，可將相關事件「傳送」給特定資源。

換句話說，系統只會將這個事件傳送給由指示的資源。

GoogleAnalytics(分析)4資源的基本資料收集功能是透過gtag「config」指令啟用；啟用之後，gtag「config」指令於網頁中載入時，系統會收集page_view事件相關資料，並將該事件視為自動收集的事件。

您可以使用特定參數來修改/封鎖網頁瀏覽命中或page_view事件。

資源ID 通用Analytics(分析)資源ID的格式是「UA-XXXXXXXX」，有時也稱為追蹤ID。

在本指南中，我們稱之為「UA資源ID」。

GoogleAnalytics(分析)4資源網站資料串流使用的評估ID格式是「G-XXXXXXXX」。

某些程式碼範例和說明文件可能會將這兩種ID都稱為「GA_Measurement_ID」。

基本資料收集 為GoogleAnalytics(分析)4資源啟用基本資料收集功能後，您就能收集下列資料： page_view事件 自動收集的事件 加強型評估事件(必須先在使用者介面中啟用) 如要為GoogleAnalytics(分析)4資源啟用基本資料收集功能，請將gtag.js程式碼片段(全域網站代碼)加進每個網頁的部分。

gtag.js程式碼片段與analytics.js程式碼片段的差異 GoogleAnalytics(分析)4資源的gtag.js程式碼片段，以及通用Analytics(分析)資源的analytics.js程式碼片段，兩者用途類似。

這兩種程式碼片段最大的差異，在於analytics.js程式碼另含一個「sendpageview」呼叫，gtag.js程式碼則沒有。

在gtag.js中，網頁瀏覽是一項自動收集的事件，會隨著「config」指令一起傳送。

  通用Analytics(分析)資源(analytics.js) GoogleAnalytics(分析)4資源(gtag.js) gtag.js的配置設定 和analytics.js一樣，您可以藉由設定基本的gtag.js程式碼片段來控管IP去識別化、Cookie自訂項目和Google信號等資料收集設定；只要利用gtag.js中的「config」或「set」指令就能進行相關設定(在analytics.js中，則是透過「set」、「create」和「require」指令來設定)。

GoogleAnalytics(分析)4(「G-XXXXXXXX」)資源支援透過gtag.js導入類似的config設定，但這些設定在通用Analytics(分析)資源和GoogleAnalytics(分析)4資源中不太一樣。

以下列出幾點注意事項： IP去識別化的標準設定是「true」，且無法在GoogleAnalytics(分析)4資源中設定。

因此，系統會使用標準事件自動遮蓋IP位址後才傳送給GoogleAnalytics(分析)4資源(「G-XXXXXXXX」)。

如要將全域設定套用到所有已設定的資源，請使用gtag.js中的「set」指令將設定套用至所有的評估ID和/或資源ID。

請特別留意analytics.js中的「廣告」和「廣告個人化」功能，這類功能通常是用一行「set」指令導入。

如果您目前的analytics.js導入程式碼使用「set」、「create」和「require」指令，請查看有哪些指令是由系統自動在GoogleAnalytics(分析)4資源中設定，有哪些需要在GoogleAnalytics(分析)4資源的程式碼中指定(參數對應)。

以下透過幾組範例，說明如何在analytics.js(通用Analytics(分析)資源)和gtag.js(GoogleAnalytics(分析)4資源)中設定程式碼： 啟用基本資料收集功能；設定User-ID analytics.js ga('create','GA_MEASUREMENT_ID','auto',{ userId:USER_ID }); ga('send','pageview'); gtag.js gtag('config','GA_MEASUREMENT_ID',{ 'user_id':'USER_ID' }); 進行Cookie設定 analytics.js ga('create','GA_MEASUREMENT_ID',{ 'cookieName':'gaCookie', 'cookieDomain':'blog.example.co.uk', 'cookieExpires':60*60*24*28//以秒做為時間單位。

}); gtag.js gtag('config','GA_MEASUREMENT_ID',{ 'cookie_prefix':'MyCookie', 'cookie_domain':'blog.example.com', 'cookie_expires':28*24*60*60//28天，以秒數表示 }); 封鎖page_view事件 如果您不需要在載入config程式碼時傳送page_view事件(例如載入的是iframe)，可以調整config設定來封鎖page_view事件。

舉例來說，假設在傳送page_view事件後有使用者登入網站，您針對「登入」這項互動使用「config」指令設定了使用者ID，但不想再傳送一次page_view事件。

請參閱下列程式碼範例，瞭解如何指明不傳送page_view事件。

gtag('config','MEASUREMENT_ID',{ 'user_id':'USER_ID', 'send_page_view':false }); 代碼名稱 在analytics.js中，如要傳送資料給不同的通用Analytics(分析)資源，就需要使用代碼名稱。

這些名稱又稱為「追蹤程式」，在analytics.js中用來定義該將資料傳送給哪個資源。

針對初始「create」命中後發生的命中，不用再指定通用Analytics(分析)資源ID，只需要指定追蹤程式的名稱。

在gtag.js中，GoogleAnalytics(分析)4和通用Analytics(分析)資源都無法使用追蹤程式，因此若想將所有的命中傳送給多個資源(同一個GoogleAnalytics(分析)4資源中的不同資料串流)，請在「config」這行程式碼中指定所有的評估ID或資源ID。

事件 請參閱事件遷移指南。

自訂維度和指標 您可以使用自訂維度和指標來取得更豐富的網站評估數據，以及從客戶關係管理系統等來源匯入離線資料。

在通用Analytics(分析)資源(「UA-XXXXXXXX」)中，您必須先在使用者介面中建立自訂維度和指標並指派ID，然後才能導入或匯入這類維度和指標。

建立自訂維度和指標時，您可以根據命中、工作階段、使用者或產品界定其資料範圍。

在GoogleAnalytics(分析)4資源(「G-XXXXXXXX」)中導入自訂維度和指標的方式不同；因此，在通用Analytics(分析)資源中透過analytics.js導入的自訂維度和指標評估資料，在GoogleAnalytics(分析)4資源中必須以參數的形式重新導入。

透過analytics.js為通用Analytics(分析)資源導入自訂維度的程式碼範例如下： ga('send','event','category_value','action_name',{'dimension5':'customdata' }); 或 ga('set','dimension5','customdata');   這些自訂維度可透過gtag.js轉譯供GoogleAnalytics(分析)4資源使用，示範如下： gtag('event','action_name',{'eventCategory':'category_value', 'dimension5':'customdata' }); 或 gtag('set',{'dimension5':'customdata'}); 請注意以下兩件事： 參數在使用者介面中完成登錄後，才會顯示在報表中。

這個程序與在通用Analytics(分析)中登錄自訂維度相似(有數量上限)。

如果只是想查看匯出的資料或使用參數來啟用目標對象，則不需要登錄參數。

自訂參數的範圍一律位於事件層級(與命中範圍相似)。

這個範圍限制也適用於自動轉譯為參數的自訂參數(gtag.js「UA-XXXXXXXX」導入)，不受原始自訂維度範圍設定的影響。

自訂指標也適用相同的對應方式和注意事項，只不過登錄供報表使用的自訂指標不是文字參數，因此會從數字參數上限中扣除。

從概念上來說，通用Analytics(分析)資源中不同範圍的自訂維度和指標，在GoogleAnalytics(分析)4資源中可對應至下列項目： 命中界定範圍自訂維度：參數(在資料收集期間，每個事件可記錄最多25個參數，另可登錄最多50個自訂維度/50個自訂指標) 注意事項：自動收集的事件與參數可能已涵蓋原本需要用命中界定範圍自訂維度評估的部分事件與參數 使用者界定範圍自訂維度：使用者屬性(可透過使用者介面登錄最多25個參數供製作報表)。

自動收集的使用者屬性不計入這個數量上限。

工作階段界定範圍自訂維度：GoogleAnalytics(分析)4資源中沒有對應項目，請改用自訂參數或使用者屬性。

使用者屬性的最佳做法 使用者屬性與使用者界定範圍自訂維度相似，意即「無論在哪個平台上」(例如所有的資料串流類型)，這些屬性都會與使用者相連結，因此只適用於需要在使用者層級套用資料的情況。

使用者屬性不應用於工作階段層級資料或裝置層級資料(例如螢幕大小)。

GoogleAnalytics(分析)4資源範例 gtag('set','user_properties',{ favorite_composer:'馬勒', favorite_instrument:'低音提琴', season_ticketholder:'true' }); 這對您有幫助嗎？我們應如何改進呢？是否送出true[UA→GA4]資料收集和標記[UA→GA4]通用Analytics(分析)與GoogleAnalytics(分析)4的資料比較[UA→GA4]使用Google代碼管理工具導入GA4的訣竅[UA→GA4]通用Analytics(分析)與GA4的gtag.js對照比較[UA→GA4]從analytics.js升級至gtag.js的訣竅[UA→GA4]將電子商務資料收集設定從通用Analytics(分析)遷移至GA4[UA→GA4]將analytics.js事件、時間和例外狀況命中傳送至GoogleAnalytics(分析)4搜尋清除搜尋內容關閉搜尋Google應用程式主選單搜尋說明中心true69256false