試用 Google Analytics 的 MCP 伺服器。從 GitHub 安裝，詳情請參閱公告。

建議事件

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

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

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：add_payment_info
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency
電子商務優待券 - ecommerce.coupon
電子商務付款類型 - ecommerce.payment_type

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}
coupon - {{電子商務優待券}}
payment_type - {{Ecommerce 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

如需在電子商務陣列以外設定項目陣列，請在傳送 value (收益) 資料時，於事件層級設定 currency 參數。

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：add_shipping_info
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency
電子商務優待券 - ecommerce.coupon
電子商務運送層級 - ecommerce.shipping_tier

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}
coupon - {{電子商務優待券}}
shipping_tier - {{Ecommerce 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：add_to_cart
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}

觸發條件：事件等於 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：add_to_wishlist
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}

觸發條件：事件等於 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：begin_checkout
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency
電子商務優待券 - ecommerce.coupon

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}
coupon - {{電子商務優待券}}

觸發條件：事件等於 begin_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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`close_convert_lead`

用來評估「待開發客戶已轉換並完成交易」這項事件 (例如透過購買)。

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：close_convert_lead
事件參數 (參數名稱 - 值)：

currency - 美元
value - 30.03

在使用者成為已轉換的待開發客戶 (顧客) 時觸發事件

`close_unconvert_lead`

用來評估「使用者標示為未成為已轉換的待開發客戶」這項事件，並提供原因。

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：close_unconvert_lead
事件參數 (參數名稱 - 值)：

currency - 美元
value - 30.03

因下列任一原因而將使用者標示為未成為已轉換待開發客戶時，觸發事件

`disqualify_lead`

用來評估「使用者標示為不符合條件，無法成為待開發客戶」這項事件，並記錄不符合條件的原因。

參數

名稱	類型	必填	範例值	說明
`currency`	`string`	是*	美元	活動 `value` 的幣別，採用3 個字母的 ISO 4217 格式。 * 如已設定 `value`，則還需要使用 `currency` 才能準確計算收益指標。
`value`	`number`	是*	30.03	事件的金額價值。 * `value` 通常是產生有意義報表的必要條件。如果將事件標示為重要事件，建議您設定 `value`。 * 如已設定 `value`，則必須設定 `currency`。
`disqualified_lead_reason`	`string`	否	不打算購買	待開發客戶標為不符資格的原因。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：disqualify_lead
事件參數 (參數名稱 - 值)：

currency - 美元
value - 30.03
disqualified_lead_reason - 不想購買

在使用者因下列任一原因而標示為不符合條件，無法成為待開發客戶時觸發事件

`earn_virtual_currency`

用來評估「使用者在遊戲中獲得虛擬貨幣」這項事件。記錄這項事件和 spend_virtual_currency，進一步瞭解您的虛擬經濟。

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：earn_virtual_currency
事件參數 (參數名稱 - 值)：

virtual_currency_name - Gem
value - 5

在使用者獲得虛擬貨幣時觸發事件

`generate_lead`

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

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：generate_lead
事件參數 (參數名稱 - 值)：

currency - 美元
value - 30.03
lead_source - 展覽

待開發客戶產生時觸發事件

`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 - 旅程開始...
success - true

在玩家完成關卡時觸發 (例如關卡確認頁面)

`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

在玩家升級時觸發

`login`

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

參數

名稱	類型	必填	範例值	說明
`method`	`string`	否	Google	登入時使用的方法。

範例

`post_score`

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

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：post_score
事件參數 (參數名稱 - 值)：

score - 10000
level - 5
character - 玩家 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`。
`customer_type`	`string` (`new` / `returning`)	否	新推出	轉換來自「新」或「回訪」顧客嗎？ `new`：在指定時間範圍內未曾購物的新顧客 (建議且預設為 540 天，但並非必要)。 `returning`：在指定時間範圍內曾購物的回訪顧客。如果無法確定，請勿指定值 (例如使用者以訪客身分結帳)。
`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：purchase

電子商務項目 - ecommerce.items
電子商務交易 ID - ecommerce.transaction_id
電子商務價值 - ecommerce.value
電子商務稅金 - ecommerce.tax
電子商務運送 - ecommerce.shipping
電子商務幣別 - ecommerce.currency
電子商務優待券 - ecommerce.coupon

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
transaction_id - {{電子商務交易 ID}}
value - {{電子商務價值}}
tax - {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency - {{Ecommerce Currency}}
coupon - {{電子商務優待券}}

觸發條件：事件等於購買

觸發條件設定：

觸發條件類型：自訂事件
活動名稱：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",
    customer_type: "new",
    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
    }]
  }
});

`qualify_lead`

用來評估「使用者標示為符合條件，可成為有效待開發客戶」這項事件。

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：qualify_lead
事件參數 (參數名稱 - 值)：

currency - 美元
value - 30.03

在使用者標示為符合條件，可成為有效待開發客戶時觸發事件

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：refund
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務交易 ID - ecommerce.transaction_id
電子商務價值 - ecommerce.value
電子商務稅金 - ecommerce.tax
電子商務運送 - ecommerce.shipping
電子商務幣別 - ecommerce.currency
電子商務優待券 - ecommerce.coupon

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
transaction_id - {{電子商務交易 ID}}
value - {{電子商務價值}}
tax - {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency - {{Ecommerce Currency}}
coupon - {{電子商務優待券}}

觸發條件：事件等於退款

觸發條件設定：

觸發條件類型：自訂事件
活動名稱：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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：remove_from_cart
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}

觸發條件：事件等於 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`search`

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

參數

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

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：search
事件參數 (參數名稱 - 值)：

search_term - 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 商店	產品關聯，用來指定供貨公司或實體商店位置。注意：`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：select_item
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務產品清單 ID - ecommerce.item_list_id
電子商務商品清單名稱 - ecommerce.item_list_name

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
item_list_id - {{電子商務項目清單 ID}}
item_list_name - {{Ecommerce 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,
      google_business_vertical: "retail",
      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 商店	產品關聯，用來指定供貨公司或實體商店位置。注意：`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
資料層變數 (名稱 - 資料層變數名稱)：

電子商務廣告素材名稱 - ecommerce.creative_name
電子商務廣告素材位置 - ecommerce.creative_slot
電子商務促銷活動 ID - ecommerce.promotion_id
電子商務促銷活動名稱 - ecommerce.promotion_name
電子商務項目 - ecommerce.items

事件參數 (參數名稱 - 值)：

creative_name - {{電子商務廣告素材名稱}}
creative_slot - {{Ecommerce Creative Slot}}
promotion_id - {{Ecommerce Promotion ID}}
promotion_name - {{電子商務宣傳活動名稱}}
items - {{電子商務項目}}

變數類型：資料層變數 -「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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`share`

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

參數

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

以下範例適用於代碼管理工具導入作業：

範例

`sign_up`

這項事件表示使用者已註冊帳戶。透過這個事件，掌握已登入和已登出使用者的各種行為。

參數

名稱	類型	必填	範例值	說明
`method`	`string`	否	Google	註冊時使用的方法。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：sign_up
事件參數 (參數名稱 - 值)：

method - Google

在使用者註冊帳戶時觸發

`spend_virtual_currency`

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

參數

名稱	類型	必填	範例值	說明
`value`	`number`	是	5	虛擬貨幣價值。
`virtual_currency_name`	`string`	是	寶石	虛擬貨幣的名稱。
`item_name`	`string`	否	新手加速	虛擬貨幣所用項目的名稱。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：spend_virtual_currency
事件參數 (參數名稱 - 值)：

value - 5
virtual_currency_name - Gem
item_name - Starter Boost

有人購買虛擬商品時觸發

`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`	是*	美元	與事件相關聯的項目幣別，採用3 個字母的 ISO 4217 格式。 `view_item` 事件的價值指標不會計入收益 * 如已設定 `value`，則還需要使用 `currency` 才能準確計算收益指標。
`value`	`number`	是*	30.03	事件的金額價值。 * 將 `value` 設為 `(price * quantity)` 中所有項目的 `(price * quantity)` 總和，這些項目位於 `items`。請勿加入 `shipping` 或 `tax`。 * 通常需要 `value` 才能產生有意義的報表。如果將事件標示為重要事件，建議您設定 `value`。 * 如已設定 `value`，則必須設定 `currency`。
`items`	`Array<Item>`	是		活動項目。

項目參數

名稱	類型	必填	範例值	說明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *請提供 `item_id` 或 `item_name` 其中之一。
`item_name`	`string`	是*	Stan and Friends T 恤	商品名稱。 *請提供 `item_id` 或 `item_name` 其中之一。
`affiliation`	`string`	否	Google 商店	產品關聯，用來指定供貨公司或實體商店位置。注意：`affiliation` 僅適用於項目範圍。
`coupon`	`string`	否	SUMMER_FUN	與商品相關聯的優待券名稱/代碼。事件層級與項目層級的 `coupon` 參數各自獨立。
`discount`	`number`	否	2.22	與項目相關聯的單一折扣金額。
`index`	`number`	否	5	商品在清單中的索引/位置。
`item_brand`	`string`	否	Google	商品品牌。
`item_category`	`string`	否	服飾	商品類別。如果用做類別階層或分類的一部分，這會是第一個類別。
`item_category2`	`string`	否	成人	商品的第二個類別階層或其他分類。
`item_category3`	`string`	否	襯衫	商品的第三個類別階層或其他分類。
`item_category4`	`string`	否	工作人員	商品的第四個類別階層或其他分類。
`item_category5`	`string`	否	短袖	商品的第五個類別階層或其他分類。
`item_list_id`	`string`	否	related_products	使用者在其中看到商品的清單 ID。如果已設定，系統會忽略事件層級的 `item_list_id`。如未設定，系統會使用事件層級的 `item_list_id` (如有)。
`item_list_name`	`string`	否	相關產品	使用者在其中看到商品的清單名稱。如果已設定，系統會忽略事件層級的 `item_list_name`。如未設定，系統會使用事件層級的 `item_list_name` (如有)。
`item_variant`	`string`	否	綠色	其他商品詳細資料/選項，如商品子類、專屬代碼或說明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID)	與商品相關聯的實體位置 (例如實體商店位置)。建議使用與相關聯項目對應的 Google 地點 ID。您也可以使用自訂位置 ID。注意：`location id` 僅適用於項目範圍。
`price`	`number`	否	10.01	商品單價，以指定幣別參數的單位表示。如果商品適用折扣，請將 `price` 設為折扣後的單價，並在 `discount` 參數中指定單價折扣。
`quantity`	`number`	否	3	商品數量。如未設定，`quantity` 會設為 1。

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：view_cart
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}

觸發條件：事件等於 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：view_item
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務價值 - ecommerce.value
電子商務幣別 - ecommerce.currency

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
value - {{電子商務價值}}
currency - {{Ecommerce Currency}}

觸發條件：事件等於 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：view_item_list
資料層變數 (名稱 - 資料層變數名稱)：

電子商務項目 - ecommerce.items
電子商務產品清單 ID - ecommerce.item_list_id
電子商務商品清單名稱 - ecommerce.item_list_name

事件參數 (參數名稱 - 值)：

items - {{電子商務項目}}
item_list_id - {{電子商務項目清單 ID}}
item_list_name - {{Ecommerce 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,
      google_business_vertical: "retail",
      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",
      google_business_vertical: "retail",
      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 商店	產品關聯，用來指定供貨公司或實體商店位置。注意：`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 個自訂參數。

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：view_promotion
資料層變數 (名稱 - 資料層變數名稱)：

電子商務廣告素材名稱 - ecommerce.creative_name
電子商務廣告素材位置 - ecommerce.creative_slot
電子商務促銷活動 ID - ecommerce.promotion_id
電子商務促銷活動名稱 - ecommerce.promotion_name
電子商務項目 - ecommerce.items

事件參數 (參數名稱 - 值)：

creative_name - {{電子商務廣告素材名稱}}
creative_slot - {{Ecommerce Creative Slot}}
promotion_id - {{Ecommerce Promotion ID}}
promotion_name - {{電子商務宣傳活動名稱}}
items - {{電子商務項目}}

觸發條件：事件等於 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`working_lead`

用來評估「使用者聯絡代表或由代表聯絡」這項事件。

參數

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

範例

以下範例適用於代碼管理工具導入作業：

顯示代碼設定

代碼設定：

代碼類型：GA4 事件
活動名稱：working_lead
事件參數 (參數名稱 - 值)：

currency - 美元
value - 30.03
lead_status - Started conversations

在使用者聯絡代表或由代表聯絡時觸發事件

建議事件 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

add_payment_info

參數

項目參數

範例

顯示代碼設定

add_shipping_info

參數

項目參數

範例

顯示代碼設定

add_to_cart

參數

項目參數

範例

顯示代碼設定

add_to_wishlist

參數

項目參數

範例

顯示代碼設定

begin_checkout

參數

項目參數

範例

顯示代碼設定

close_convert_lead

參數

範例

顯示代碼設定

close_unconvert_lead

參數

範例

顯示代碼設定

disqualify_lead

參數

範例

顯示代碼設定

earn_virtual_currency

參數

範例

顯示代碼設定

generate_lead

參數

範例

顯示代碼設定

join_group

參數

範例

顯示代碼設定

level_end

參數

範例

顯示代碼設定

level_start

參數

範例

顯示代碼設定

level_up

參數

範例

顯示代碼設定

login

參數

範例

顯示代碼設定

post_score

參數

範例

顯示代碼設定

purchase

參數

項目參數

範例

顯示代碼設定

qualify_lead

參數

範例

顯示代碼設定

refund

建議事件

`add_payment_info`

`add_shipping_info`

`add_to_cart`

`add_to_wishlist`

`begin_checkout`

`close_convert_lead`

`close_unconvert_lead`

`disqualify_lead`

`earn_virtual_currency`

`generate_lead`

`join_group`

`level_end`

`level_start`

`level_up`

`login`

`post_score`

`purchase`

`qualify_lead`

`refund`

`remove_from_cart`

`search`

`select_content`

`select_item`

`select_promotion`

`share`

`sign_up`

`spend_virtual_currency`

`tutorial_begin`

`tutorial_complete`

`unlock_achievement`

`view_cart`

`view_item`

`view_item_list`

`view_promotion`