建議事件

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

add_payment_info

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

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
coupon string 不支援 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級與項目層級的 coupon 參數各自獨立。
payment_type string 不支援 信用卡資訊 選擇的付款方式。
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

add_shipping_info

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

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
coupon string 不支援 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級與項目層級的 coupon 參數各自獨立。
shipping_tier string 陸運 為交付所購商品而選取的運送層級,例如 GroundAirNext-day
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

add_to_cart

這個事件表示已將商品加入購物車,以便購買。

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string 不支援 Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

add_to_wishlist

事件表明已將項目加入願望清單。請使用這個事件找出應用程式內的熱門禮物。

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string 不支援 Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

begin_checkout

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

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
coupon string SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級與項目層級的 coupon 參數各自獨立。
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string 不支援 Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

earn_virtual_currency

這個事件會評估使用者獲得遊戲虛擬貨幣的時間。將這項資訊與 spend_virtual_currency 進行記錄,即可進一步瞭解虛擬經濟。

參數

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

範例

generate_lead

這個事件會評估待開發客戶產生 (例如透過表單) 的時間。記錄這項資訊可協助您瞭解行銷廣告活動的成效,以及有多少客戶在向顧客再行銷後,再次與您的商家互動。

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 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 是* USD 與事件相關聯的項目幣別,採用 3 個字母的 ISO 4217 格式。

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
transaction_id string T_12345 交易的專屬 ID。

transaction_id 參數可避免單筆購買產生重複事件。
coupon string SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級與項目層級的 coupon 參數各自獨立。
shipping number 3.39 與交易相關聯的運費。
tax number 1.11 與交易相關的稅金費用。
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string 不支援 Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

refund (退款)

這個事件代表將一或多個項目退款給使用者。

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
transaction_id string T_12345 交易的專屬 ID。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
coupon string 不支援 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級與項目層級的 coupon 參數各自獨立。
shipping number 3.39 與交易相關聯的運費。
tax number 1.11 與交易相關的稅金費用。
items Array<Item> 否* 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

remove_from_cart

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

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

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

參數

名稱 類型 必要 範例值 說明
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_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string 不支援 Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

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_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string 不支援 Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例

次分享

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

參數

名稱 類型 必要 範例值 說明
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 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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_item

這個事件表示已向使用者顯示部分內容。請使用這個事件來探索使用者最常瀏覽的品項。

參數

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

* 如果設定了 value,就必須提供 currency 才能準確計算收益指標。
value number 是* 30.03 事件的金額。

* 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shippingtax
* 通常必須提供 value,才能產生有意義的報表。如果您將事件標示為轉換,建議設定 value
* 如果設定 value,就必須提供 currency
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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_item_list

當系統向使用者顯示特定類別的項目清單時,請記錄此事件。

參數

名稱 類型 必要 範例值 說明
item_list_id string related_products 使用者在其中看到商品的清單 ID。

如果是在項目層級設定,系統會忽略這項政策。
item_list_name string 相關產品 使用者在其中看到商品的清單名稱。

如果是在項目層級設定,系統會忽略這項政策。
items Array<Item> 事件項目。

項目參數

名稱 類型 必要 範例值 說明
item_id string 是* SKU_12345

商品的 ID。

*須為 item_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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_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_iditem_name 其中之一。

item_name string 是* Stan and Friends T 恤

商品名稱。

*須為 item_iditem_name 其中之一。

affiliation string Google 商店 產品關聯,用來指定供貨公司或實體商店位置。
注意:「聯盟」僅適用於項目範圍。
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 地點 ID。您也可以使用自訂地區 ID。
注意:「地區 ID」僅適用於項目範圍。
price number 不支援 1,001 萬 商品的貨幣單位價格,以指定貨幣參數的單位表示。
如果商品適用折扣,請將 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 個自訂參數

範例