設定事件參數

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

觀眾

您想透過已設定的事件收集使用者活動的詳細資訊。

在網站上使用 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': 'Travel Destinations',
  'currency': 'USD'
});
</script>

如果您在網頁中加入多個標記 ID,請新增 set 指令,而不要更新 config 指令,讓所有 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報表需要進行一些額外設定才能使用報表。這兩份報表會顯示使用者在網站上觸發的事件。

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

其他參數會要求您建立自訂維度和指標,才能在 Google Analytics (分析) 中查看參數值。每次建立自訂參數時,您都需要建立對應的自訂維度或指標,才能查看相關資料。

後續步驟

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