建議事件

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

Google 代碼 代碼管理工具 Firebase

add_payment_info

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定了 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：add_payment_info
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 電子商務優待券 - ecommerce.coupon
• 電子商務付款方式 - ecommerce.payment_type
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• coupon - & Lace; & Lace; 電子商務優待券(&L)；
• payment_type - { 電子商務付款方式與陣列
• 觸發條件：事件等於 add_payment_info

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：add_payment_info
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定了 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：add_shipping_info
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 電子商務優待券 - ecommerce.coupon
• 電子商務運送層級 - ecommerce.shipping_tier
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• coupon - & Lace; & Lace; 電子商務優待券(&L)；
• shipping_tier - {{ 電子商務運送層級與範圍；}
• 觸發條件：事件等於 add_shipping_info

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：add_shipping_info
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_cart

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：add_to_cart
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• 觸發條件：事件等於 add_to_cart

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：add_to_cart
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：add_to_wishlist
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• 觸發條件：事件等於 add_to_wishlist

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：add_to_wishlist
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

begin_checkout

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定了 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：begin_checkout
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 電子商務優待券 - ecommerce.coupon
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• coupon - & Lace; & Lace; 電子商務優待券(&L)；
• 觸發條件：事件等於 start_checkout

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：begin_checkout
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

earn_virtual_currency

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

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：earn_virtual_currency
• 事件參數 (參數名稱 - 值)：
• virtual_currency_name - 寶石
• value - 5 則
• 有人贏得虛擬貨幣時觸發事件

generate_lead

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如果設定了 value，就必須提供 currency 才能準確計算收益指標。
value	number	是*	30.03	事件的金額。 * 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shipping 或 tax。 * 通常必須提供 value，才能產生有意義的報表。如果您將事件標示為轉換，建議設定 value。 * 如果設定 value，就必須提供 currency。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：generate_lead
• 事件參數 (參數名稱 - 值)：
• currency - 美元
• value - 99.99 人
• 在產生待開發客戶時觸發事件

join_group

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

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：join_group
• 事件參數 (參數名稱 - 值)：
• group_id：G_12345
• 在使用者加入群組時觸發事件

level_end

這個事件表示玩家已經到達遊戲中的關卡。

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：level_end
• 事件參數 (參數名稱 - 值)：
• level_name - 旅程開始...
• 成功 - 是
• 在玩家達到某個關卡時觸發 (例如關卡確認頁面)

level_start

這個事件表示玩家已在遊戲中啟動關卡。

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：level_start
• 事件參數 (參數名稱 - 值)：
• level_name - 旅程開始...
• 在使用者展開新關卡 (例如關卡起始頁面) 時觸發

level_up

這個事件表示玩家已在遊戲中升級。您可以運用這份報表評估使用者族群的層級分佈情形，並找出難以完成的等級。

參數

名稱	類型	必要	範例值	說明
level	number	否	5	字元的等級。
character	string	否	玩家 1	升級的人物，

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：level_up
• 事件參數 (參數名稱 - 值)：
• level - 5 則
• character - 玩家 1
• 在玩家升級時觸發

登入

傳送這個事件，表示使用者已登入您的網站或應用程式。

參數

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

範例

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：login
• 事件參數 (參數名稱 - 值)：
• method - Google
• 在使用者登入時觸發

post_score

使用者發布分數時傳送這個事件。您可藉由這個事件瞭解使用者在遊戲中的表現，並將高分與目標對像或行為建立關聯。

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：post_score
• 事件參數 (參數名稱 - 值)：
• score - 10,000 人
• level - 5 則
• character - 玩家 1
• 在使用者發布分數時觸發

purchase

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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.39	與交易相關聯的運費。
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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：purchase
• 電子商務商品 - ecommerce.items
• 電子商務交易 ID - ecommerce.transaction_id
• 電子商務價值 - ecommerce.value
• 電子商務稅金 - ecommerce.tax
• 電子商務運費 - ecommerce.shipping
• 電子商務貨幣 - ecommerce.currency
• 電子商務優待券 - ecommerce.coupon
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• transaction_id - (&L)；電子商務交易 ID &rbrace；
• value - (&L) - 電子商務價值(&L)；
• tax - & Lace; { 電子商務稅金}
• shipping - { { 電子商務運送與草寫；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• coupon - & Lace; & Lace; 電子商務優待券(&L)；
• 觸發條件：事件等於購買

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：purchase
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

refund (退款)

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

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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.39	與交易相關聯的運費。
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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：refund
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務交易 ID - ecommerce.transaction_id
• 電子商務價值 - ecommerce.value
• 電子商務稅金 - ecommerce.tax
• 電子商務運費 - ecommerce.shipping
• 電子商務貨幣 - ecommerce.currency
• 電子商務優待券 - ecommerce.coupon
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• transaction_id - (&L)；電子商務交易 ID &rbrace；
• value - (&L) - 電子商務價值(&L)；
• tax - & Lace; { 電子商務稅金}
• shipping - { { 電子商務運送與草寫；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• coupon - & Lace; & Lace; 電子商務優待券(&L)；
• 觸發條件：事件等於退款

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：refund
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

remove_from_cart

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：remove_from_cart
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• 觸發條件：事件等於 remove_from_cart

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：remove_from_cart
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

search

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

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：search
• 事件參數 (參數名稱 - 值)：
• search_term - T 恤
• 當使用者在您的網站上搜尋時觸發

select_content

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

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：select_content
• 事件參數 (參數名稱 - 值)：
• content_type - 產品
• content_id：C_12345
• 觸發條件：事件等於 select_content

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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：select_item
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務商品清單 ID - ecommerce.item_list_id
• 電子商務商品清單名稱 - ecommerce.item_list_name
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• item_list_id - { { 電子商務項目清單 ID 與陣列；}
• item_list_name - {{電子商務項目清單名稱}
• 觸發條件：事件等於 select_item

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：select_item
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務廣告素材名稱 - ecommerce.creative_name
• 電子商務廣告素材版位 - ecommerce.creative_slot
• 電子商務促銷 ID - ecommerce.promotion_id
• 電子商務促銷活動名稱 - ecommerce.promotion_name
• 電子商務商品 - ecommerce.items
• 事件參數 (參數名稱 - 值)：
• creative_name - { { 電子商務廣告素材名稱(&R);
• creative_slot - { { 電子商務廣告素材版位與陣列
• promotion_id - { 電子商務促銷 ID 與 Rbrace;
• promotion_name - { { 電子商務宣傳名稱與陣列；}
• items - { 電子商務項目(&L);
• 變數類型：資料層變數 -「ecommerce.items」
• 觸發條件：事件等於 select_promotion

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：select_promotion
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

次分享

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

參數

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

範例

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：share
• 事件參數 (參數名稱 - 值)：
• method - Twitter
• content_type - 圖片
• item_id：C_12345
• 在使用者分享了內容時觸發

sign_up

這個事件表示使用者已申請帳戶。使用這個事件，瞭解已登入和已登出使用者的各種行為。

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：sign_up
• 事件參數 (參數名稱 - 值)：
• method - Google
• 在使用者申請帳戶時觸發

spend_virtual_currency

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

參數

名稱	類型	必要	範例值	說明
value	number	是	5	虛擬貨幣的價值。
virtual_currency_name	string	是	Gem	虛擬貨幣的名稱。
item_name	string	否	入門重點加強	虛擬貨幣要使用的商品名稱。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：spend_virtual_currency
• 事件參數 (參數名稱 - 值)：
• value - 5 則
• virtual_currency_name - 寶石
• item_name - 入門重點加強
• 在消費者購買虛擬商品時觸發

tutorial_begin

這個事件表示新手上路程序的開始。請在具有 tutorial_complete 的漏斗中使用此模式，瞭解有多少使用者完成教學課程。

參數

這個事件沒有任何參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：tutorial_begin
• 在使用者開始參與程序時觸發

tutorial_complete

這個事件代表使用者已完成新手上路程序。請在搭配 tutorial_begin 的程序中使用，瞭解完成教學課程的使用者人數。

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：tutorial_complete
• 在使用者完成新手上路流程時觸發

unlock_achievement

在使用者解鎖成就時記錄這個事件。此事件有助於瞭解使用者如何體驗您的遊戲。

參數

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

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：unlock_achievement
• 事件參數 (參數名稱 - 值)：
• achievement_id：A_12345
• 使用者解鎖成就時觸發

view_cart

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：view_cart
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• 觸發條件：事件等於 view_cart

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：view_cart
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item

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

參數

名稱	類型	必要	範例值	說明
currency	string	是*	USD	與事件相關聯的項目幣別，採用 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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：view_item
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務價值 - ecommerce.value
• 電子商務貨幣 - ecommerce.currency
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• value - (&L) - 電子商務價值(&L)；
• currency - (&L) - 電子商務貨幣與貨幣 (&Lace;)
• 觸發條件：事件等於 view_item

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：view_item
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：view_item_list
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務商品 - ecommerce.items
• 電子商務商品清單 ID - ecommerce.item_list_id
• 電子商務商品清單名稱 - ecommerce.item_list_name
• 事件參數 (參數名稱 - 值)：
• items - { 電子商務項目(&L);
• item_list_id - { { 電子商務項目清單 ID 與陣列；}
• item_list_name - {{電子商務項目清單名稱}
• 觸發條件：事件等於 view_item_list

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：view_item_list
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

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 商店	產品關聯，用來指定供貨公司或實體商店位置。 注意：「聯盟」僅適用於項目範圍。
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 個自訂參數。

範例

以下是以代碼管理工具導入為例：

顯示代碼設定

代碼設定：

• 代碼類型：GA4 事件
• 事件名稱：view_promotion
• 資料層變數 (名稱 - 資料層變數名稱)：
• 電子商務廣告素材名稱 - ecommerce.creative_name
• 電子商務廣告素材版位 - ecommerce.creative_slot
• 電子商務促銷 ID - ecommerce.promotion_id
• 電子商務促銷活動名稱 - ecommerce.promotion_name
• 電子商務商品 - ecommerce.items
• 事件參數 (參數名稱 - 值)：
• creative_name - { { 電子商務廣告素材名稱(&R);
• creative_slot - { { 電子商務廣告素材版位與陣列
• promotion_id - { 電子商務促銷 ID 與 Rbrace;
• promotion_name - { { 電子商務宣傳名稱與陣列；}
• items - { 電子商務項目(&L);
• 觸發條件：事件等於 view_promotion

觸發條件設定：

• 觸發條件類型：自訂事件
• 事件名稱：view_promotion
• 這項觸發條件的啟動時機：所有自訂事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});