[UA→GA4] 通用 Analytics (分析) 與 GA4 的 gtag.js 對照比較

這份導入指南旨在協助使用 gtag.js 程式庫的網站擁有者，瞭解通用 Analytics (分析) 的 gtag.js 如何對應至 Google Analytics (分析) 4。本文假設您已建立 Google Analytics (分析) 4 資源。如果您只需在網站中加入基本評估程式碼，請改為閱讀這篇文章。

本文內容：

• gtag.js 程式碼片段簡介
• 基本資料收集
• gtag.js 的配置設定
• 事件
• 自訂維度和指標

gtag.js 程式碼片段和資源 ID 簡介

通用 Analytics (分析) 資源和 Google Analytics (分析) 4 資源的 gtag.js 程式碼片段基本上是相同的，兩者都具備以下結構：

01: <script async src="https://www.googletagmanager.com/gtag/js?id=<特定資源 ID A>"></script>

02: <script>

03: window.dataLayer = window.dataLayer || [];

04: function gtag(){dataLayer.push(arguments);}

05: gtag('js', new Date());

06:

07: gtag('config', '<特定資源 ID A>');

08:

09: gtag('config', '<特定資源 ID B>');

10:

11: gtag('event', 'sign_up', { 'method': 'email' });

12:

13: gtag('event', 'view_video', { 'send_to': '<特定資源 ID B>' });

14:

15: </script>

第 1 行程式碼：如果您已透過 gtag.js 導入通用 Analytics (分析) 資源，網站上可能已經有這一行程式碼，但其中的 <特定資源 ID A> 這行字將替換成「UA-」(連字號後會加上一串數字)。如果您已導入 Google Ads 或其他 Google Marketing Platform 產品的 gtag.js，網站上也可能出現這行程式碼，但 <特定資源 ID A> 部分則會替換成「AW-」或「DC-」開頭的字串。

以 <特定資源 ID A> 表示的資源 ID (在 Google Analytics (分析) 4 資源中則是「代碼 ID」) 用來「控管」這個 gtag.js 程式碼片段。這行程式碼很重要，因為：

1. 如果網站上已有這行程式碼，您就不需要再花時間導入程式碼，只要添加一行「config」來指定代碼 ID 即可。
2. 這行程式碼中的資源 ID 用來「控管」gtag.js 程式碼片段；有了控管代碼的通用 Analytics (分析) 資源 ID (「UA-XXXXXXXX」)，您就能使用已連結的網站代碼將評估資料傳送給 Google Analytics (分析) 4 資源，不需要在網頁上新增任何程式碼。

第 7 行程式碼：gtag 的「config」指令能為資源收集與 <特定資源 ID A> 相關聯的資料。舉例來說，如果您在 Google Analytics (分析) 4 資源中加入這個含代碼 ID 的指令，系統會將 page_view 事件傳送給該資源。

資源 ID 可用來代表針對不同 Google 產品收集到的評估資料，包括通用 Analytics (分析) 資源 (「UA-XXXXXXXX」)、Google Analytics (分析) 4 資源 (「G-XXXXXXXX」)、Google Ads (「AW-XXXXXXXX」) 及 Floodlight (「DC-XXXXXXXX」)。

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

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

第 13 行程式碼：這裡的事件包含「send_to」這個特殊參數，可將相關事件傳送給特定資源。換句話說，系統只會將這個事件傳送給由 <特定資源 ID B> 指示的資源。

gtag 的 config 指令能讓您進行基本評估。

• 如果是通用 Analytics (分析) 資源，含通用 Analytics (分析) 資源 ID 的「config」指令會傳送網頁瀏覽命中。
• 如果是 Google Analytics (分析) 4 資源，含代碼 ID 的「config」指令於網頁中載入時，系統會收集 page_view 事件相關資料，並將該事件視為自動收集的事件。

資源 ID

通用 Analytics (分析) 資源 ID 的格式是「UA-XXXXXXXX」，有時也稱為追蹤 ID。在本指南中，我們稱之為「UA 資源 ID」。

Google Analytics (分析) 4 資源網站資料串流會使用代碼 ID，其格式為「G-XXXXXXXX」。

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

基本資料收集

為 Google Analytics (分析) 4 資源啟用基本資料收集功能後，您就能收集下列資料：

• page_view 事件
• 自動收集的事件
• 加強型評估事件 (必須先在使用者介面中啟用)

如果您現有的通用 Analytics (分析) 資源使用 gtag.js 程式碼導入，可以透過下列方法為 Google Analytics (分析) 4 資源啟用基本資料收集功能：

• 方法 1：新增內含相關代碼 ID 的「config」指令
  或是
• 方法 2：啟用已連結的網站代碼 (前提是目前的 gtag.js 程式碼符合條件)

無論您選用哪一個方法，現有的通用 Analytics (分析) 資源都會繼續收集資料，完全不受影響。

方法 1：加入新的「config」指令

如果網頁上已有 gtag.js 程式碼，只要再多加入一組內含相關 Google Analytics (分析) 4 資源評估 ID 的「config」指令即可。下方範例就是在現有的 gtag.js 程式碼中新增第 8 行程式碼；這行程式碼參照的是 Google Analytics (分析) 4 資源的評估 ID，因此會將 page_view 事件傳送給該 Google Analytics (分析) 4 資源。此外，這樣還能在該 Google Analytics (分析) 4 資源中啟用自動收集的事件和加強型評估事件 (前提是您已經啟用加強型評估)。

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<特定資源 ID A>"></script>

2: <script>

3: window.dataLayer = window.dataLayer || [];

4: function gtag(){dataLayer.push(arguments);}

5: gtag('js', new Date());

6:

7: gtag('config', '<特定資源 ID A>');

8: gtag('config', 'G-XXXXXXXX');

9: </script>

方法 2：啟用已連結的網站代碼

只要以下條件「都符合」，您就能使用已連結的網站代碼：

• 在您要評估使用者互動的網頁上，負責「控管」現有 gtag.js 程式碼片段的是通用 Analytics (分析) 資源 (亦即這行 gtag.js 程式碼片段參照的 ID 開頭是「UA-」)：

<script async src="https://www.googletagmanager.com/gtag/js?id=<特定資源 ID A>"></script>

(即使現有的 gtag.js 程式碼片段是由 Google Analytics (分析) 4 資源控管，您還是可以使用已連結的網站代碼；不過這種情況只有在您已經導入 Google Analytics (分析) 4 資源時才會發生)。

• 此外，您還必須擁有管理員存取權，可存取程式碼片段中 ID 參照的通用 Analytics (分析) 資源。

如果您的網頁中同時導入了 gtag.js 代碼和 GTM 容器，gtag.js 代碼必須置於 GTM 容器上方，已連結的網站代碼才能正常運作。

gtag.js 的配置設定

您可以設定基本的 gtag.js 程式碼片段，藉此控管 IP 去識別化、Cookie 自訂項目和 Google 信號等資料收集設定；利用 gtag.js 中的「config」或「set」指令就能進行相關設定。

通用 Analytics (分析) 資源 (「UA-XXXXXXXX」) 和 Google Analytics (分析) 4 資源 (「G-XXXXXXXX」) 都支援透過 gtag.js 導入這些配置設定，不過在這兩項資源中，這些設定還是有些微差異。

• IP 去識別化的標準設定是「true」，且無法在 Google Analytics (分析) 4 資源中設定。因此，系統會使用標準事件自動遮蓋 IP 位址後才傳送給 Google Analytics (分析) 4 資源 (「G-XXXXXXXX」)。

• 如要將全域設定套用到所有已設定的資源，請使用「set」指令將設定套用至所有的評估 ID 和/或資源 ID (包括透過「已連結的網站代碼」導入的評估 ID 和資源 ID)。
• 請特別留意「停用廣告個人化」功能，這類功能通常是用一行「config」指令導入。
• 若您使用「已連結的網站代碼」：使用「config」在 gtag.js 程式碼中所做的設定，都只會套用到與該行程式碼中的評估 ID 相關的資源，而「不會」自動傳送給已連結的 Google Analytics (分析) 4 資源。如要將設定套用到已連結的 Google Analytics (分析) 4 資源，請採行下列其中一項做法：
  • 建立個別的「config」指令，並藉由參照評估 ID，將指令套用至相關的 Google Analytics (分析) 4 資源
    或是
  • 使用「set」指令來進行設定；在這個情況下，設定會套用至所有已設定的資源。

設定範例

啟用基本資料收集功能；設定 User-ID

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

進行 Cookie 設定

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

});

事件

請參閱事件遷移指南。

自訂維度和指標

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

使用 Google 代碼 (gtag.js) 自訂維度和指標時，若使用已連結的網站代碼或 Google Analytics (分析) 4 資源 (例如 G-XXXXXXXX)，系統會自動將自訂維度和指標評估資料轉譯成參數。

如要進一步瞭解自訂維度和指標，請參閱這篇文章。