評估 Google Analytics (分析) 事件

本頁面說明如何使用 gtag.js 傳送 Google Analytics (分析) 事件。

傳送事件

如要在已加入 Google 代碼的網頁上傳送 Google Analytics (分析) 事件，請使用 gtag.js event 指令，並採用下列語法：

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});

名稱	類型	預設值	說明
`<action>`	`string`		在 Google Analytics (分析) 事件報表中顯示為事件動作的值。
`<category>`	`string`	`"general"`	事件的類別。
`<label>`	`string`		事件的標籤。
`<value>`	`number`		非負整數，會顯示為事件值。

以下程式碼會傳送動作為 'aaa'、'bbb' 類別以及 'ccc' 標籤的事件：

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

如果省略 <category> 或 <label>，系統會將其設為預設值 "(not set)"。

如要進一步瞭解 Google Analytics (分析) 如何解讀事件結構，請參閱 Google Analytics (分析) 事件參數的分析。

預設 Google Analytics (分析) 事件

請使用已預先設定類別和標籤的預設 Google Analytics (分析) 事件。使用這些事件有助於製作一致的報表，以及與日後推出的功能互通性。

下表列出預設的 Google Analytics (分析) 事件、事件的預設類別，以及預設標籤類型 (如果有的話)。若是這個表格未列出的事件名稱 (例如您建立的任意事件名稱)，預設類別是 "engagement"，預設標籤則為 "(not set)"。

事件名稱	預設類別	預設標籤類型
`add_payment_info`	`ecommerce`
`add_to_cart`	`ecommerce`
`add_to_wishlist`	`ecommerce`
`begin_checkout`	`ecommerce`
`checkout_progress`	`ecommerce`
`generate_lead`	`engagement`
`login`	`engagement`	`method`
`purchase`	`ecommerce`
`refund`	`ecommerce`
`remove_from_cart`	`ecommerce`
`search`	`engagement`	`search_term`
`select_content`	`engagement`	`content_type`
`set_checkout_option`	`ecommerce`
`share`	`engagement`	`method`
`sign_up`	`engagement`	`method`
`view_item`	`engagement`
`view_item_list`	`engagement`
`view_promotion`	`engagement`
`view_search_results`	`engagement`	`search_term`

傳送非互動事件

如要傳送非互動事件，請將 non_interaction 參數設為 true：

gtag('event', 'video_auto_play_start', {
  'event_label': 'My promotional video',
  'event_category': 'video_auto_play',
  'non_interaction': true
});