設定事件參數

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

觀眾

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

您在網站上使用 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 是事件參數值

為每個事件設定參數

上一節的範例會在 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報表需要進行額外設定才能使用。這兩份報表都會即時顯示使用者在網站上觸發的事件。

在 DebugView 中驗證

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

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

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

後續步驟

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