事件參照

本參考資料列出 Google 代碼支援的建議事件。

add_payment_info

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額價值。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 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。
注意：`location id` 僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

add_shipping_info

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額價值。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 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。
注意：`location id` 僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

add_to_cart

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

add_to_wishlist

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

begin_checkout

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額價值。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 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。
注意：`location id` 僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

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 虛擬貨幣的價值。

exception

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

參數

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

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 用來登入帳戶的方法。

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 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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。
注意：`location id` 僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

qualify_lead

用來評估使用者是否符合成為合格待開發客戶的條件。

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 事件的 value 幣別，採用 3 個字母的 ISO 4217 格式。

* 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額價值。

* value 通常是產生有意義報表的必要條件。如果您將事件標示為重要事件，建議您設定 value。
* 如果您設定 value，則必須使用 currency。

refund

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

remove_from_cart

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

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

參數

名稱 類型 必填 範例值 說明
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。
注意：`location id` 僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，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 否 成人 商品的第二個類別階層或其他分類。
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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
promotion_id string 否 P_12345 與商品相關聯的促銷活動 ID。

如果已設定，系統會忽略事件層級 promotion_id。
如果未設定，系統會使用事件層級 promotion_id (如有)。
promotion_name string 否 夏季促銷 與商品相關聯的促銷活動名稱。

如果已設定，系統會忽略事件層級 promotion_name。
如果未設定，系統會使用事件層級 promotion_name (如有)。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

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 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

view_item

這個事件表示系統向使用者顯示了部分內容。您可以使用這個事件，找出觀看次數最多的商品。

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

view_item_list

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

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。

view_item 事件的價值指標不會計入收益

* 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 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.01 商品的貨幣單位價格，以指定貨幣參數的單位表示。
如果商品適用折扣，請將 price 設為折扣單價，並在 discount 參數中指定單價折扣。
promotion_id string 否 P_12345 與商品相關聯的促銷活動 ID。

如果已設定，系統會忽略事件層級 promotion_id。
如果未設定，系統會使用事件層級 promotion_id (如有)。
promotion_name string 否 夏季促銷 與商品相關聯的促銷活動名稱。

如果已設定，系統會忽略事件層級 promotion_name。
如果未設定，系統會使用事件層級 promotion_name (如有)。
quantity number 否 3

商品數量。

如果未設定，quantity 會設為 1。
除了規定的參數外，您還可以在 items 陣列中加入最多 27 個自訂參數。

view_search_results

在使用者看到搜尋結果時記錄此事件。請注意，您可以透過 Google Analytics 中的加強型事件評估，啟用 view_search_results 事件以便自動收集。

參數

名稱 類型 必填 範例值 說明
search_term string 否 服飾 用於搜尋的字詞。

working_lead

用來評估使用者與服務專員聯絡，或服務專員與使用者聯絡的時間。

參數

名稱 類型 必填 範例值 說明
currency string 是* 美元 事件的 value 幣別，採用 3 個字母的 ISO 4217 格式。

* 如已設定 value，則還需要使用 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額價值。

* value 通常是產生有意義報表的必要條件。如果您將事件標示為重要事件，建議您設定 value。
* 如果您設定 value，則必須使用 currency。
lead_status string 否 已開始的對話 待開發客戶的狀態。