本頁面說明如何使用 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
});