建議事件

Google Analytics 會自動傳送部分事件類型，本頁面將說明可設定的選用額外事件，協助您評估更多行為，並產生更實用的商家報表。這些額外的 您需要花更多心力設定這些活動，才能使用它們， Analytics 4 無法自動傳送這些內容。如需針對網站或應用程式設定建議事件和自訂事件的逐步操作說明，請參閱「設定事件」一文。

如要查看可用的各個事件詳細資料，請選取代碼管理平台：

gtag.js 代碼管理工具 Firebase

翻譯：已停用

add_payment_info

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

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件相關項目的貨幣， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 地點 ID。您也可以使用自訂位置 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

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

範例

add_shipping_info

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

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value	number	是*	30.03	事件的金額。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 地點 ID。您也可以使用自訂位置 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

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

範例

add_to_cart

這項事件表示商品已加入購物車以供購買。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value	number	是*	30.03	事件的金額。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

add_to_wishlist

這個事件表示商品已加入願望清單。這個事件的用途 在應用程式中找出熱門禮物。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件相關項目的貨幣， 3 個字母 ISO 4217 格式。 * 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value	number	是*	30.03	事件的金額。 * 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shipping 或 tax， * 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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：`location id` 僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

begin_checkout

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

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額價值。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

close_convert_lead

此事件會評估待開發客戶完成轉換及完成的時間 (例如 購買)。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件 value 的幣別， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額價值。 * value 通常是產生有意義報表的必要條件。如果標示 將事件設為重要事件 value。 * 如果設定 value，則必須提供 currency。

範例

close_unconvert_lead

用來評估使用者未成為已轉換的待開發客戶 和原因

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件 value 的幣別， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額。 * 製作有意義的報表通常需要 value。 如果標示 將事件設為重要事件 value。 * 如果設定 value，則必須提供 currency。
unconvert_lead_reason	string	否	從未回覆	待開發客戶未轉換的原因。

範例

disqualify_lead

此事件用來評估使用者何時標示為不符資格，成為待開發客戶 以及撤銷資格的原因。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件 value 的幣別， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額。 * 製作有意義的報表通常需要 value。 如果標示 將事件設為重要事件 value。 * 如果設定 value，則必須提供 currency。
disqualified_lead_reason	string	否	不想購買	待開發客戶遭標示為不符資格的原因。

範例

earn_virtual_currency

用來評估使用者在遊戲中獲得虛擬貨幣的次數。 連同 spend_virtual_currency 記錄這筆資料，您就能進一步瞭解 虛擬經濟活動

參數

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

範例

generate_lead

這項事件會評估待開發客戶產生的時間 (例如透過表單產生)。記錄這項資料，瞭解行銷活動的成效，以及在向客戶進行再行銷後，有多少客戶重新與您的業務互動。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件 value 的幣別， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額。 * 製作有意義的報表通常需要 value。 如果標示 將事件設為重要事件 value。 * 如果設定 value，則必須提供 currency。
lead_source	string	否	商展	待開發客戶的來源。

範例

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	登入方式。

範例

post_score

在使用者發布分數時傳送此事件。透過這個事件瞭解 找出使用者在遊戲中的表現，並將高分與目標對像或目標對象相關 行為

參數

名稱	類型	必填	範例值	說明
score	number	是	10000	要發布的分數。
level	number	否	5	分數的等級。
character	string	否	玩家 1	獲得分數的字元。

範例

purchase

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

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件相關項目的貨幣， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額價值。 * 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 value。 如果標示 將事件設為重要事件 value。 * 如果設定 value，則必須提供 currency。
transaction_id	string	是	T_12345	交易的專屬 ID。 transaction_id 參數可避免單筆購買產生重複事件。
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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

qualify_lead

此事件用來評估使用者是否符合成為 有效待開發客戶。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件 value 的幣別， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額價值。 * 製作有意義的報表通常需要 value。 如果標示 將事件設為重要事件 value。 * 如果設定 value，則必須提供 currency。

範例

refund

每當有一或多項商品退款給使用者時，就會使用這個事件。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件相關項目的貨幣， 3 個字母 ISO 4217 格式。 * 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
transaction_id	string	是	T_12345	交易的專屬 ID。
value	number	是*	30.03	事件的金額。 * 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shipping 或 tax。 * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 地點 ID。自訂位置 您也可以使用 ID。 注意：`location id` 僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

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

範例

remove_from_cart

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

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件相關項目的貨幣， 3 個字母 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如果未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

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	否	成人	商品的第二個類別階層或其他分類。
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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果) 。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果設定這個項目，系統會忽略事件層級的 promotion_name。 如果未設定，系統會使用事件層級 promotion_name (如有)。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

share

使用者分享內容時使用此事件。

參數

名稱	類型	必填	範例值	說明
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	是*	30.03	事件的金額。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax。 * 製作有意義的報表通常需要 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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

view_item

這個事件代表已向使用者顯示部分內容。這個事件的用途 就能找出 最受歡迎的商品

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額。 * 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax， * 製作有意義的報表通常需要 value。 如果標示 將事件設為重要事件 value。 * currency 是必要的，如果您設定 value。
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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：「位置 ID」僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

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 參數各自獨立。
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	否	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 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。 注意：`location id` 僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity	number	否	3	商品數量。 如未設定，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	否	成人	商品的第二個類別階層或其他分類。
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 與關聯項目相對應的地點 ID。您也可以使用自訂位置 ID。 注意：`location id` 僅適用於項目範圍。
price	number	否	10 月 1 日	商品的貨幣單位價格，以指定貨幣為單位 參數。 如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果已設定，系統會忽略事件層級 promotion_id。 如果未設定，則會使用事件層級的 promotion_id (如果) 。
promotion_name	string	否	夏季特賣	與商品相關聯的促銷活動名稱。 如果設定這個項目，系統會忽略事件層級的 promotion_name。 如果未設定，系統會使用事件層級 promotion_name (如有)。
quantity	number	否	3	商品數量。 如未設定，quantity 會設為 1。

除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

範例

working_lead

用來評估使用者聯絡或代表聯絡的使用者。

參數

名稱	類型	必填	範例值	說明
currency	string	是*	美元	事件的 value 幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定 value，就必須使用 currency 才能準確計算收益指標
value	number	是*	30.03	事件的金額價值。 * 製作有意義的報表通常需要 value。 如果您將事件標示為重要事件，建議您設定 value。 * 如果設定 value，則必須提供 currency。
lead_status	string	否	已發起對話	待開發客戶的狀態。

範例