Google Analytics 建議事件

以下是建議採用的事件。您也可以建立及傳送自己的自訂事件。

重要事項： 如要將事件傳送至應用程式資料串流，請使用 app_instance_id，而非 client_id。

建立自訂事件名稱時，請務必遵守下列規定：

1. 請遵守事件命名規則。
2. 避免使用預留的名稱和前置字元。
3. 請遵守事件收集限制，例如事件和參數名稱的長度上限為 40 個半形字元。

詳情請參閱「開始使用」一文。

如果您要從 Measurement Protocol 升級，請參閱「從 Measurement Protocol 升級」一文的操作說明。

所有資源

ad_impression

這項事件僅適用於應用程式串流。

使用者看到廣告曝光時，請使用這個事件。

• 使用 Measurement Protocol 傳送的 ad_impression不會納入匯出至其他廣告平台 (例如 Google Ads) 的資料。
• 如果您已為已連結的 Google 廣告產品設定代碼或 SDK，使用 Measurement Protocol 傳送 ad_impression 事件可能會導致曝光次數重複計算。只有在標記或 SDK 未擷取到事件時，才使用 Measurement Protocol 傳送 ad_impression 事件。

事件欄位

名稱	類型	必填	範例值	說明
currency	string	否	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	否	歐元	廣告曝光的價值。 * 通常需要 conversion_value 才能產生有意義的報表。 * 如要設定 conversion_value，則必須提供 currency。

參數

名稱	類型	必填	範例值	說明
ad_platform	string	否	MoPub	廣告平台。
ad_source	string	否	AdColony	廣告來源。
ad_format	string	否	橫幅廣告	廣告格式。
ad_unit_name	string	否	Banner_03	廣告單元名稱。

範例

以下範例說明如何使用 Data Manager API 傳送 ad_impression 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "ad_impression",
      "params": {
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

earn_virtual_currency

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

事件欄位

名稱	類型	必填	範例值	說明
conversion_value	number	否	5	虛擬貨幣價值。

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 earn_virtual_currency 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

join_group

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

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 join_group 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

login

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

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 login 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

screen_view

這項事件僅適用於應用程式串流。

使用這個事件表示發生畫面轉場。

參數

名稱	類型	必填	範例值	說明
screen_class	string	否	MainActivity	畫面的類別。
screen_name	string	否	關於	畫面名稱。

範例

以下範例說明如何使用 Data Manager API 傳送 screen_view 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

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

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 search 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

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

參數

名稱	類型	必填	範例值	說明
content_type	string	否	產品	所選內容的類型。
content_id	string	否	C_12345	所選內容的 ID。值至少要包含一個非數值半形字元。

範例

以下範例說明如何使用 Data Manager API 傳送 select_content 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

share

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

事件欄位

名稱	類型	必填	範例值	說明
cart_data.items	Item[]	否		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 share 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

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

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 sign_up 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

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

事件欄位

名稱	類型	必填	範例值	說明
conversion_value	number	是	5	虛擬貨幣價值。
cart_data.items	Item[]	否		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
item_name	string	否	新手加速	虛擬貨幣所用項目的名稱。

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 spend_virtual_currency 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

這個事件表示開始進行新手上路程序。在漏斗中搭配 tutorial_complete 使用，瞭解有多少使用者完成教學課程。

參數

系統未建議此事件使用任何參數。

範例

以下範例說明如何使用 Data Manager API 傳送 tutorial_begin 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

這項事件表示使用者已完成新手上路程序。在漏斗中使用這項事件和 tutorial_begin，瞭解有多少使用者完成教學課程。

參數

系統未建議此事件使用任何參數。

範例

下列範例說明如何使用 Data Manager API 傳送 tutorial_complete 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

view_search_results

在系統向使用者顯示搜尋結果時，請記錄這項事件。請注意，您可以在 Google Analytics 中透過加強型事件評估，啟用 view_search_results 事件的自動收集功能。

參數

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

注意： 如果在目前工作階段中是不重複搜尋字詞，view_search_results 事件就會傳送值為 1 的 unique_search_term 參數。如果已透過目前工作階段提交此搜尋字詞，參數值則是 0。

範例

下列範例說明如何使用 Data Manager API 傳送 view_search_results 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

campaign_details

使用這個事件傳送廣告活動詳細資料，這些資料會套用至時間戳記大於或等於 campaign_details 事件時間戳記的事件。

注意： Google Analytics 報表或 DebugView 不會顯示 campaign_details 事件。如果已啟用 BigQuery Export，這個事件就會出現在 BigQuery 事件匯出資料中。

參數

名稱	類型	必填	範例值	說明
campaign_id	string	否	google_1234	廣告活動 ID。
campaign	string	否	Summer_fun	用來識別特定促銷活動或策略性廣告活動的名稱。
source	string	否	google	廣告活動流量來源 (例如 Google、電子郵件等)。
medium	string	否	單次點擊出價	廣告活動媒介 (例如電子郵件、單次點擊出價等)
term	string	否	summer+travel	與付費搜尋廣告搭配使用的廣告活動字詞，可提供廣告的關鍵字。
content	string	否	logolink	用於 A/B 測試和指定內容廣告的廣告活動內容，可區分連到同一個網址的不同廣告或連結。

範例

下列範例說明如何使用 Data Manager API 傳送 campaign_details 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

線上銷售

add_payment_info

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

事件欄位

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * view_item 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。
cart_data.coupon_codes	string[]	否	SUMMER_FUN	與事件相關聯的優待券代碼。 在 CartData 物件上設定 coupon_codes 欄位。 * 請只在這份清單中提供一組優待券代碼。 * 這與項目層級的優待券代碼無關。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
payment_type	string	否	信用卡資訊	你選取的付款方式。

範例

下列範例說明如何使用 Data Manager API 傳送 add_payment_info 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "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",
            "currency": "USD",
            "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_shipping_info

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

事件欄位

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * view_item 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。
cart_data.coupon_codes	string[]	否	SUMMER_FUN	與事件相關聯的優待券代碼。 在 CartData 物件上設定 coupon_codes 欄位。 * 請只在這份清單中提供一組優待券代碼。 * 這與項目層級的優待券代碼無關。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
shipping_tier	string	否	地面	選取配送已購商品的運送層級，例如 Ground、Air、Next-day。

範例

下列範例說明如何使用 Data Manager API 傳送 add_shipping_info 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "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",
            "currency": "USD",
            "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 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 add_to_cart 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 add_to_wishlist 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。
cart_data.coupon_codes	string[]	否	SUMMER_FUN	與事件相關聯的優待券代碼。 在 CartData 物件上設定 coupon_codes 欄位。 * 請只在這份清單中提供一組優待券代碼。 * 這與項目層級的優待券代碼無關。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 begin_checkout 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

in_app_purchase

這項事件僅適用於應用程式串流。

當使用者進行應用程式內購買時，請使用這個事件。

事件欄位

名稱	類型	必填	範例值	說明
currency	string	是*	美元	活動 conversion_value 的幣別，採 3 個英文字母組成的 ISO 4217 格式。 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * conversion_value 通常是產生有意義報表的必要條件。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	否		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
product_id	string	否	ABC123456789	產品的 ID。
subscription	boolean	否	true	指出購買項目是否為訂閱項目。 如未設定，預設值為 false。
free_trial	boolean	否	true	指出事件是否為訂閱項目的免費試用。 如未設定，預設值為 false。
price_is_discounted	boolean	否	false	指出 price 是否享有折扣。 如未設定，預設值為 false。

範例

以下範例說明如何使用 Data Manager API 傳送 in_app_purchase 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

事件欄位

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * view_item 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
transaction_id	string	是	T_12345	交易的專屬 ID。 transaction_id 參數可避免單筆購買產生重複事件。在 Event 物件中設定 transaction_id 欄位。
user_properties.customer_type	CustomerType	否	NEW	轉換來自NEW或RETURNING顧客。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。
cart_data.coupon_codes	string[]	否	SUMMER_FUN	與事件相關聯的優待券代碼。 在 CartData 物件上設定 coupon_codes 欄位。 * 請只在這份清單中提供一組優待券代碼。 * 這與項目層級的優待券代碼無關。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
shipping	number	否	3.33	與交易相關的運費。
tax	number	否	1.11	與交易相關聯的稅金費用。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 purchase 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
    method: "POST",
    body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

refund

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

注意： 建議您在 refund 事件中加入商品資訊，以便在 Analytics 中查看商品層級的退款指標。

事件欄位

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * view_item 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
transaction_id	string	是	T_12345	交易的專屬 ID。
cart_data.items	Item[]	否		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。
cart_data.coupon_codes	string[]	否	SUMMER_FUN	與事件相關聯的優待券代碼。 在 CartData 物件上設定 coupon_codes 欄位。 * 請只在這份清單中提供一組優待券代碼。 * 這與項目層級的優待券代碼無關。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
shipping	number	否	3.33	與交易相關的運費。
tax	number	否	1.11	與交易相關聯的稅金費用。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 refund 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

下列範例說明如何使用 Data Manager API 傳送 remove_from_cart 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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_item

這項事件表示使用者從清單中選取了項目。

事件欄位

名稱	類型	必填	範例值	說明
cart_data.items	Item[]	是*		活動的項目。 * items 陣列應只有一個元素，代表所選項目。如果提供多個元素，系統只會使用 items 中的第一個元素。 在 Event 物件上設定 cart_data.items 欄位。

參數

名稱	類型	必填	範例值	說明
item_list_id	string	否	related_products	使用者在其中看到商品的清單 ID。 如果是在項目層級設定，系統會忽略這項屬性。
item_list_name	string	否	相關產品	使用者在其中看到商品的清單名稱。 如果是在項目層級設定，系統會忽略這項屬性。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 select_item 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "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",
            "currency": "USD",
            "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

這項事件表示使用者從清單中選取了促銷活動。

事件欄位

名稱	類型	必填	範例值	說明
cart_data.items	Item[]	否		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。
creative_slot	string	否	featured_app_1	與事件相關聯的促銷廣告素材版位名稱。
promotion_id	string	否	P_12345	與活動相關聯的促銷活動 ID。
promotion_name	string	否	夏季促銷	與事件相關聯的促銷活動名稱。

如要在 Google Analytics 報表中填入以商品為範圍的促銷維度，例如「商品促銷 ID」或「商品促銷名稱」，Google Analytics 會先在電子商務事件的 items 陣列中，尋找每個特定物件內的相應促銷參數 (promotion_id、promotion_name、creative_name 和 creative_slot)。如果項目物件中沒有參數，Google Analytics 就會使用 *事件層級* 參數的值 (如有提供)。如果項目物件和事件層級參數都缺少相關參數，特定項目的以商品為範圍促銷活動維度才會回報為「(not set)」。項目層級參數一律優先於事件層級參數。

項目參數

名稱	類型	必填	範例值	說明
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_slot	string	否	featured_app_1	與項目相關聯的促銷廣告素材版位名稱。 如未設定，預設為事件層級的 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 僅適用於項目範圍。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果未設定，預設為事件層級的 promotion_id。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果未設定，預設為事件層級的 promotion_name。

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

範例

下列範例說明如何使用 Data Manager API 傳送 select_promotion 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "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",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "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,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

這項事件表示使用者查看了購物車。

事件欄位

名稱	類型	必填	範例值	說明
currency	string	是*	美元	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * view_item 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 view_cart 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
conversion_value	number	是*	30.03	事件的金額價值。 * 將 conversion_value 設為 (price * quantity) 中所有項目的總和，並放在 items 中。請勿加入 shipping 或 tax。 * 通常需要 conversion_value 才能產生有意義的報表。 如果將事件標示為重要事件，建議您設定 conversion_value。 * 如要設定 conversion_value，則必須提供 currency。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 view_item 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 事件的價值指標不會計入收益 * 如已設定 conversion_value，則還需要使用 currency 才能準確計算收益指標。
cart_data.items	Item[]	是		活動的項目。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

項目參數

名稱	類型	必填	範例值	說明
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 僅適用於項目範圍。

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

範例

以下範例說明如何使用 Data Manager API 傳送 view_item_list 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "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",
            "currency": "USD",
            "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_promotion

這項事件表示促銷活動是從清單中查看。

事件欄位

名稱	類型	必填	範例值	說明
cart_data.items	Item[]	是*		活動的項目。 * items 陣列應只有一個元素，代表與促銷活動相關聯的項目。如果提供多個元素，系統只會使用 items 中的第一個元素。 在 Event 物件上設定 cart_data.items 欄位。

項目欄位

名稱	類型	必填	範例值	說明
item_id	string	是	I_12345	項目的專屬 ID。在 Item 物件中設定 item_id 欄位。
unit_price	number	是	27.67	此為單價，不含稅金、運費和這個項目的事件範圍 (交易層級) 折扣。 如果商品有商品範圍折扣，請使用折扣後的單價。舉例來說，如果商品的單價為 27.67，單價折扣為 6.66，則請將 unitPrice 設為 21.01。
quantity	number	是	1	這項商品購買的數量。

參數

名稱	類型	必填	範例值	說明
creative_name	string	否	summer_banner2	促銷廣告素材的名稱。
creative_slot	string	否	featured_app_1	與事件相關聯的促銷廣告素材版位名稱。
promotion_id	string	否	P_12345	與活動相關聯的促銷活動 ID。
promotion_name	string	否	夏季促銷	與事件相關聯的促銷活動名稱。

如要在 Google Analytics 報表中填入以商品為範圍的促銷活動維度，例如「商品促銷 ID」或「商品促銷活動名稱」，Google Analytics 會先在電子商務事件的 items 陣列中，尋找每個特定物件內的相應促銷活動參數 (promotion_id、promotion_name、creative_name 和 creative_slot)。如果項目物件中沒有參數，Google Analytics 就會使用 *事件層級* 參數的值 (如有提供)。如果項目物件和事件層級參數都缺少相關參數，特定項目的以商品為範圍促銷活動維度才會回報為「(not set)」。項目層級參數一律優先於事件層級參數。

項目參數

名稱	類型	必填	範例值	說明
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_slot	string	否	featured_app_1	與項目相關聯的促銷廣告素材版位名稱。 如未設定，預設為事件層級的 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 僅適用於項目範圍。
promotion_id	string	否	P_12345	與商品相關聯的促銷活動 ID。 如果未設定，預設為事件層級的 promotion_id。
promotion_name	string	否	夏季促銷	與商品相關聯的促銷活動名稱。 如果未設定，預設為事件層級的 promotion_name。

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

範例

以下範例說明如何使用 Data Manager API 傳送 view_promotion 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "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",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "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,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

遊戲

level_up

這個事件表示玩家在遊戲中升級。您可以藉此評估使用者族群的關卡分布，並找出難以完成的關卡。

參數

名稱	類型	必填	範例值	說明
level	number	否	5	角色的等級。
character	string	否	玩家 1	升級的角色。

範例

以下範例說明如何使用 Data Manager API 傳送 level_up 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

post_score

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

參數

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

範例

以下範例說明如何使用 Data Manager API 傳送 post_score 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

unlock_achievement

使用者解鎖成就時，請記錄這項事件。這項事件可協助您瞭解使用者對遊戲的體驗。

參數

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

範例

下列範例說明如何使用 Data Manager API 傳送 unlock_achievement 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

待開發客戶產生

close_convert_lead

當有效待開發客戶成功轉換為顧客時，請記錄這項事件。這通常表示待開發客戶培育程序已結束，例如簽署合約、開始付費訂閱或完成最終銷售。

• 注意：如要追蹤待開發客戶的初始獲取情況，例如表單提交、訂閱電子報或要求試用，請使用 generate_lead 事件。

事件欄位

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

範例

下列範例說明如何使用 Data Manager API 傳送 close_convert_lead 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

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

事件欄位

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

參數

名稱	類型	必填	範例值	說明
unconvert_lead_reason	string	否	從未回覆	待開發客戶未轉換的原因。

範例

下列範例說明如何使用 Data Manager API 傳送 close_unconvert_lead 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

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

事件欄位

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

參數

名稱	類型	必填	範例值	說明
disqualified_lead_reason	string	否	不打算購買	待開發客戶標為不符資格的原因。

範例

以下範例說明如何使用 Data Manager API 傳送 disqualify_lead 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

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

事件欄位

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

參數

名稱	類型	必填	範例值	說明
lead_source	string	否	商展	待開發客戶的來源。

範例

以下範例說明如何使用 Data Manager API 傳送 generate_lead 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

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

事件欄位

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

範例

以下範例說明如何使用 Data Manager API 傳送 qualify_lead 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

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

事件欄位

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

參數

名稱	類型	必填	範例值	說明
lead_status	string	否	已發起對話	待開發客戶的狀態。

範例

以下範例說明如何使用 Data Manager API 傳送 working_lead 事件。如果您要從 Measurement Protocol 升級，請使用分頁將要求遷移至 Data Manager API。

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});