設定事件參數

本指南說明如何在網站上設定建議事件自訂事件的參數,以便收集更多事件資訊。如要瞭解如何新增以商品為範圍的參數,請參閱「評估電子商務」一文。

觀眾

您想透過已設定的事件,收集更多使用者活動相關資訊。

您在網站上使用 Google 代碼 (gtag.js) 或 Google 代碼管理工具。 如要為行動應用程式設定事件參數,請參閱「記錄事件」一文。


事前準備

請務必先完成下列事項,再按照本指南的說明操作:

此外,您也需要具備下列權限:

  • 可存取網站原始碼
  • Google Analytics 帳戶的「編輯者」(或更高層級) 角色

閱讀本指南前,也請先參閱「設定事件」。

瞭解事件參數

參數可以針對使用者與網站的互動方式,提供更多相關資訊。舉例來說,有人瀏覽您銷售的產品時,就可以加入名稱、類別和價格等參數,描述使用者瀏覽的產品。

根據預設,自動收集和加強型評估事件都會納入參數。Google 也提供一組必要和選用參數,可加到每個建議事件。此外,您也可以視需要加入更多事件參數。

設定事件參數

事件的結構如下,其中 <event_parameters> 是您的事件參數,以鍵/值組合的形式寫入:

gtag('event', '<event_name>', {
  <event_parameters>
});

請參考以下範例:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

在這個例子中:

  • app_namescreen_name 是事件參數名稱
  • myAppNameHome 是事件參數值

重要事項:登記自訂參數

在程式碼中傳送自訂參數只是第一步。如要讓 Google Analytics 顯示標準報表和探索中的任何自訂參數資料,並供您分析,請在 Google Analytics 介面中將這些參數登錄為自訂維度或指標。如果未註冊,系統仍會收集參數資料,但無法用於報表。

進一步瞭解自訂維度和指標

為每個事件設定參數

前一節的範例使用 gtag() 函式中的 event 指令,傳送單一事件的參數。您也可以更新 Google 代碼片段 (位於 <head> HTML 代碼中) 的 config 指令,傳送網頁上每個事件的參數。

下列程式碼會設定網頁標題,然後隨網頁上的每個事件傳送參數:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Contact Us',
  'currency': 'EUR'
});
</script>

如果要在網頁中加入多個代碼 ID,請使用已記錄的全域參數 (例如 user_idpage_titlecurrency) 的 set 指令,讓所有 ID 都能沿用這些值。將 set 指令置於 config 指令上方。

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

在 Analytics 中查看事件

您可以使用「即時和「DebugView報表,確認事件和參數是否正確傳送。這些報表會顯示傳送的資料。請注意,您必須先進行額外設定,才能使用「DebugView」報表。

不過,如要在更廣泛的 Google Analytics 報表介面 (例如探索或標準報表) 中查看及分析您傳送的任何自訂參數值,必須先將這些參數註冊為自訂維度或指標。註冊自訂維度或指標後,最多可能需要 48 小時,資料才會顯示在報表中。

瞭解自訂維度和指標

在 DebugView 中驗證

使用 DebugView 報表時,以 gtag('set') 定義的參數會套用至網頁上後續的所有 gtag('event') 呼叫。如要驗證,請確認 gtag('set') 指令是在事件觸發「之前」執行。接著,在 DebugView 中選取事件,並檢查「參數」分頁,查看合併的參數清單,包括全域設定的參數。

部分參數會在 Google Analytics 中自動填入預先建立的維度和指標。舉例來說,自動收集和加強型評估事件的參數,以及您為建議事件傳送的必要和選用參數,都會填入預先建立的維度和指標。

對於其他參數,您必須建立自訂維度和指標,才能在 Google Analytics 中查看參數值。

後續步驟

為自訂事件參數建立自訂維度和指標