建議事件

這些事件可讓您評估其他功能和行為，並在 Google Analytics (分析) 4 中產生更實用的報表。這類事件需要搭配其他相關背景資訊進行評估才會有意義，因此不會自動傳送。請參閱本文件，瞭解每個事件的必要和選用參數。

Google 代碼 代碼管理工具 Firebase

add_payment_info

這個事件代表使用者已在電子商務結帳程序中提交付款資訊。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
coupon	string	否	SUMMER_FUN	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
payment_type	string	否	信用卡資訊	選擇的付款方式。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

add_shipping_info

這個事件代表使用者已在電子商務結帳程序中提交運送資訊。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
coupon	string	否	SUMMER_FUN	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
shipping_tier	string	否	陸運	為交付已購買商品而選取的運送層級 (例如 Ground、Air、Next-day)。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

add_to_cart

這個事件表示商品已加入購物車並進行購買。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

add_to_wishlist

這個事件表示某個項目已加入願望清單。利用此事件來找出應用程式中的熱門禮物。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

begin_checkout

這個事件表示使用者已開始結帳。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
coupon	string	否	SUMMER_FUN	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

earn_virtual_currency

這個事件代表使用者在遊戲中以虛擬貨幣獲得獎勵時，記錄這項資料和 spend_virtual_currency 即可進一步瞭解您的虛擬經濟。

參數

名稱	類型	必要	範例值	說明
virtual_currency_name	string	否	寶石	虛擬貨幣的名稱。
value	number	否	5	虛擬貨幣的價值。

範例

generate_lead

這個事件會評估待開發客戶的產生時間 (例如透過表單產生)。記錄這段記錄，瞭解行銷廣告活動的成效，以及有多少客戶在向消費者再行銷後又再次與您的商家互動。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。

範例

join_group

使用者加入公會、團隊或家庭等群組時，記錄這個事件。您可以利用這個事件，分析特定群組或社交功能的熱門程度。

參數

名稱	類型	必要	範例值	說明
group_id	string	否	G_12345	群組 ID。

範例

level_end

這個事件代表玩家已經在遊戲中達到過關。

參數

名稱	類型	必要	範例值	說明
level_name	string	否	旅程開始...	等級名稱。
success	boolean	否	true	如果關卡順利完成，請設為 true。

範例

level_start

這個事件代表玩家已在遊戲中開始過關卡。

參數

名稱	類型	必要	範例值	說明
level_name	string	否	旅程開始...	等級名稱。

範例

level_up

這個事件代表玩家已在遊戲中升級。您可以運用這項指標估算使用者族群的層級分佈情形，並找出難以完成的關卡。

參數

名稱	類型	必要	範例值	說明
level	number	否	5	字元層級。
character	string	否	玩家 1	升級的角色。

範例

登入

傳送這個事件，指出使用者已登入網站或應用程式。

參數

名稱	類型	必要	範例值	說明
method	string	否	Google	登入方式。

範例

post_score

在使用者發布分數時傳送此事件。利用這個事件來瞭解使用者在遊戲中的表現，以及將最高分與目標對像或行為建立關聯。

參數

名稱	類型	必要	範例值	說明
score	number	是	10000	要張貼的分數。
level	number	否	5	分數的等級。
character	string	否	玩家 1	達到分數的角色。

範例

purchase

這個事件代表使用者購買了一或多項商品。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
transaction_id	string	是	T_12345	交易的專屬 ID。 transaction_id 參數可避免單筆購買產生重複事件。
value	number	是*	12.21	事件的金額。 * 必須設定 value，才能產生有意義的報表，以及填入購買者 預測目標對象。 * 如設定 value，則必須提供 currency。
coupon	string	否	SUMMER_FUN	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
shipping	number	否	3.33	與交易相關聯的運費。
tax	number	否	1.11	與交易相關的稅金費用。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

refund

這個事件代表有一或多項商品退還給使用者。

注意： 建議您在 refund 事件中加入商品資訊，以便在 Analytics (分析) 中查看商品層級退款指標。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
transaction_id	string	是	T_12345	交易的專屬 ID。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
coupon	string	否	SUMMER_FUN	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
shipping	number	否	3.33	與交易相關聯的運費。
tax	number	否	1.11	與交易相關的稅金費用。
items	Array<Item>	否*		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

remove_from_cart

這個事件表示商品已從購物車中移除。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

search

記錄這個事件，指出使用者執行搜尋的時間。您可以使用這個事件找出使用者在網站或應用程式中搜尋的內容。舉例來說，您可以在使用者在搜尋後查看搜尋結果網頁時傳送這個事件。

參數

名稱	類型	必要	範例值	說明
search_term	string	是	T 恤	搜尋的字詞。

範例

select_content

這個事件表示使用者已選取特定類型的內容。這個事件有助您找出網站或應用程式中的熱門內容和內容類別。

參數

名稱	類型	必要	範例值	說明
content_type	string	否	產品	所選內容的類型。
content_id	string	否	C_12345	所選內容的 ID。

範例

select_item

這個事件表示已選取清單中的項目。

參數

名稱	類型	必要	範例值	說明
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果是在商品層級設定，系統會忽略這項設定。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果是在商品層級設定，系統會忽略這項設定。
items	Array<Item>	是*		事件的項目。 * items 陣列應包含一個元素，代表所選項目。如果提供多個元素，系統只會使用 items 中的第一個元素。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

select_promotion

這個事件表示已選取促銷優惠。

參數

名稱	類型	必要	範例值	說明
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果是在商品層級設定，系統會忽略這項設定。
creative_slot	string	否	featured_app_1	與事件相關聯的促銷廣告素材版位名稱。 如果是在商品層級設定，系統會忽略這項設定。
promotion_id	string	否	P_12345	與活動相關聯的促銷活動 ID。 如果是在商品層級設定，系統會忽略這項設定。
promotion_name	string	否	夏季特賣	與活動相關聯的促銷活動名稱。 如果是在商品層級設定，系統會忽略這項設定。
items	Array<Item>	否		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

次分享

當使用者分享了內容時，請使用這個事件。

參數

名稱	類型	必要	範例值	說明
method	string	否	Twitter	分享內容的方法。
content_type	string	否	圖片	共用內容的類型。
item_id	string	否	C_12345	分享內容的 ID。

範例

sign_up

這個事件表示使用者已註冊帳戶。透過這個事件，瞭解已登入和已登出使用者的不同行為。

參數

名稱	類型	必要	範例值	說明
method	string	否	Google	註冊時使用的方法。

範例

spend_virtual_currency

這個事件會評估應用程式內的虛擬商品銷售情況，協助您找出最受歡迎的虛擬商品。

參數

名稱	類型	必要	範例值	說明
value	number	是	5	虛擬貨幣的價值。
virtual_currency_name	string	是	寶石	虛擬貨幣的名稱。
item_name	string	否	新手重點加強	採用虛擬貨幣的商品名稱。

範例

tutorial_begin

這個事件表示新手上路程序的開始時間。在搭配 tutorial_complete 的程序中使用此功能，瞭解完成教學課程的使用者數量。

參數

這個事件沒有任何參數。

範例

tutorial_complete

這個事件表示使用者已完成新手上路程序。請在使用 tutorial_begin 程序中使用這項功能，瞭解有多少使用者完成教學課程。

參數

這個事件沒有任何建議使用的參數。

範例

unlock_achievement

在使用者解鎖成就時記錄這個事件。這個事件有助於瞭解使用者對遊戲的感受。

參數

名稱	類型	必要	範例值	說明
achievement_id	string	是	A_12345	已解鎖的成就 ID。

範例

view_cart

這個事件代表使用者查看了購物車。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

view_item

這個事件表示已向使用者顯示部分內容。利用這個事件來探索使用者瀏覽的熱門商品。

參數

名稱	類型	必要	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須提供 currency，才能準確計算收益指標。
value	number	是*	7.77	事件的金額。 * value 通常用於產生有意義的報表。 如果您將事件標示為轉換，建議您設定 value。 * 如設定 value，則必須提供 currency。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

view_item_list

系統會在使用者看到特定類別的項目清單時，記錄此事件。

參數

名稱	類型	必要	範例值	說明
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果是在商品層級設定，系統會忽略這項設定。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果是在商品層級設定，系統會忽略這項設定。
items	Array<Item>	是		事件的項目。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例

view_promotion

這個事件表示使用者瀏覽了促銷活動。

參數

名稱	類型	必要	範例值	說明
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果是在商品層級設定，系統會忽略這項設定。
creative_slot	string	否	featured_app_1	與事件相關聯的促銷廣告素材版位名稱。 如果是在商品層級設定，系統會忽略這項設定。
promotion_id	string	否	P_12345	與活動相關聯的促銷活動 ID。 如果是在商品層級設定，系統會忽略這項設定。
promotion_name	string	否	夏季特賣	與活動相關聯的促銷活動名稱。 如果是在商品層級設定，系統會忽略這項設定。
items	Array<Item>	是*		事件的項目。 * items 陣列應該要包含一個元素，用來代表與促銷活動相關聯的項目。如果提供多個元素，系統只會使用 items 中的第一個元素。

項目參數

名稱	類型	必要	範例值	說明
item_id	string	是*	SKU_12345	商品的 ID。 *必須輸入 item_id 或 item_name 其中之一。
item_name	string	是*	Stan and Friends T 恤	商品名稱。 *必須輸入 item_id 或 item_name 其中之一。
affiliation	string	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「affiliation」僅適用於項目範圍。
coupon	string	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。 如果已設定，系統會忽略事件層級的 creative_name。 如未設定，則會使用事件層級的 creative_name (如有)。
creative_slot	string	否	featured_app_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定，系統會忽略事件層級的 creative_slot。 如未設定，則會使用事件層級的 creative_slot (如有)。
discount	number	否	2.22	與項目相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果用於類別階層或分類中，這會是第一個類別。
item_category2	string	否	Adult	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果已設定，系統會忽略事件層級的 item_list_id。 如未設定，系統會使用事件層級的 item_list_id (如有)。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果已設定，系統會忽略事件層級的 item_list_name。 如未設定，系統會使用事件層級的 item_list_name (如有)。
item_variant	string	否	綠色	其他商品詳細資料/選項的商品子類、專屬代碼或說明。
location_id	string	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實際地點 (例如實體商店位置)。建議使用與相關項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅適用於項目範圍。
price	number	否	歐元	商品金額，以指定貨幣參數的單位為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級的 promotion_id。 如未設定，系統會使用事件層級的 promotion_id (如有)。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果已設定，系統會忽略事件層級的 promotion_name。 如未設定，系統會使用事件層級的 promotion_name (如有)。
quantity	number	否	1	商品數量。 如果未設定，quantity 會設為 1。

除了法規參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

範例