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