事件參考資料

這份參考資料列出 Google 代碼支援的事件。

add_payment_info

這個事件代表使用者已提交付款資訊。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

add_shipping_info

這個事件代表使用者已提交運送資訊。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

add_to_cart

這個事件代表使用者已將商品加入購物車。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

add_to_wishlist

事件表示該項目已加入願望清單。使用這個事件可識別應用程式中的熱門禮物。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

begin_checkout

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

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

earn_virtual_currency

這項活動旨在評估虛擬貨幣的頒獎結果。與 spend_virtual_currency 一併記錄，以進一步瞭解您的虛擬經濟。

參數

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

例外狀況

應用程式的執行作業正常流程中斷時，系統就會記錄例外狀況事件。

參數

名稱	類型	必填	範例值	說明
description	string	否	未填寫必要欄位。	例外狀況的描述。
fatal	boolean	否	true	例外狀況是否為嚴重錯誤。

generate_lead

產生待開發客戶後，請記錄這個事件，瞭解再參與廣告活動的效益。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	更上一層樓。

login

傳送此事件，表示使用者已經登入。

參數

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

page_view

這個事件代表使用者曾瀏覽網頁。

參數

名稱	類型	必填	範例值	說明
page_location	string	否	https://example.com	網頁的網址。
client_id	string	否	ABC_123	用戶端 ID。
language	string	否	en_us	用戶端的語言。請參閱語言標記和代碼一節。
page_encoding	string	否	UTF-8	網頁的編碼。
page_title	string	否	首頁	網頁的標題。
user_agent	string	否		用戶端的使用者代理程式。

post_score

在使用者張貼分數時傳送此事件。使用這個事件來瞭解使用者在遊戲中的表現，並將分數與目標對像或行為建立關聯。

參數

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

purchase

當使用者購買一或多個商品時，系統就會透過這類事件來表示。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	5.30	與交易相關的運費。
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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

refund

當有一或多個項目退款給使用者時，系統會使用這個事件來表示。

注意：我們建議您在 refund 事件中加入項目資訊，才能在 Analytics (分析) 中查看項目層級的退款指標。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	5.30	與交易相關的運費。
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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

remove_from_cart

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

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

search

使用這個事件，將搜尋作業的情境化。這個事件可協助您找出應用程式中最熱門的內容。

參數

名稱	類型	必填	範例值	說明
search_term	string	有	T 恤印製	搜尋的字詞。

select_content

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

參數

名稱	類型	必填	範例值	說明
content_type	string	否	產品	所選內容的類型。
item_id	string	否	I_12345	所選項目的 ID。

select_item

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

參數

名稱	類型	必填	範例值	說明
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

select_promotion

這個事件代表系統已選取清單中的促銷活動。

參數

名稱	類型	必填	範例值	說明
creative_name	string	否	夏季橫幅 2	促銷廣告素材的名稱。 如果在商品層級設定，系統會忽略這項資訊。
creative_slot	string	否	精選應用程式_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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

分享

在使用者分享內容時使用這個事件。

參數

名稱	類型	必填	範例值	說明
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	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

view_item

這個事件表示使用者看到部分內容。使用這個事件即可探索最熱門的項目。

參數

名稱	類型	必填	範例值	說明
currency	string	有*	USD	與事件相關聯的項目貨幣，採 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

view_item_list

當使用者查看特定類別的項目清單時，請記錄這個事件。

參數

名稱	類型	必填	範例值	說明
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

view_promotion

這個事件代表使用者觀看了宣傳活動。

參數

名稱	類型	必填	範例值	說明
creative_name	string	否	夏季橫幅 2	促銷廣告素材的名稱。 如果在商品層級設定，系統會忽略這項資訊。
creative_slot	string	否	精選應用程式_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	否	夏季橫幅 2	促銷廣告素材的名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_name。 如果未設定，則會使用事件層級的 creative_name (如果有的話)。
creative_slot	string	否	精選應用程式_1	與商品相關聯的促銷廣告素材版位名稱。 如果已設定這項屬性，系統會忽略事件層級的 creative_slot。 如果未設定，則會使用事件層級的 creative_slot (如果有的話)。
discount	number	否	2.22	與商品相關聯的折扣金額。
index	number	否	5	清單中項目的索引/位置。
item_brand	string	否	Google	商品品牌。
item_category	string	否	服飾	商品類別。如果屬於類別階層或分類的一部分，就會成為第一個類別。
item_category2	string	否	成人	商品的第二個類別階層或其他分類。
item_category3	string	否	襯衫	商品的第三個類別階層或其他分類。
item_category4	string	否	工作人員	商品的第四個類別階層或其他分類。
item_category5	string	否	短袖	商品的第五個類別階層或其他分類。
item_list_id	string	否	相關產品	使用者在其中看到商品的清單 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 Place ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意：「location id」僅於項目層級提供。
price	number	否	9.99	商品的金額，以指定的貨幣參數為單位。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定這項屬性，系統會忽略事件層級的 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果有的話)。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果已設定這項屬性，系統會忽略事件層級的 promotion_name。 如果未設定，則會使用事件層級的 promotion_name (如果有的話)。
quantity	number	否	1	商品數量。 如果未設定，系統會將 quantity 設為 1。

view_search_results

使用者收到搜尋結果之後，您就可以記錄這個事件。

參數

名稱	類型	必填	範例值	說明
search_term	string	否	服飾	用於搜尋的字詞。
items	Array<Item>	有		活動項目。