事件參照

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

add_payment_info

這個事件代表使用者已在 電子商務結帳程序

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
coupon string 否 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
payment_type string 否 信用卡資訊 選取的付款方式。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

add_shipping_info

這個事件代表使用者已在 電子商務結帳程序

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
coupon string 否 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
shipping_tier string 否 地面 運送層級 (例如 Ground、Air、 (Next-day)，負責運送所購商品。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

add_to_cart

這個事件代表已將商品加入購物車並購買。

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

add_to_wishlist

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

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

begin_checkout

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

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
coupon string 否 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

close_convert_lead

此事件會評估待開發客戶完成轉換及完成的時間 (例如 購買後)。

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

close_unconvert_lead

用來評估使用者未成為已轉換的待開發客戶 和原因

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
unconvert_lead_reason string 否 從未回覆 待開發客戶未轉換的原因。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

disqualify_lead

此事件用來評估使用者何時標示為不符資格，成為待開發客戶 以及撤銷資格的原因。

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
disqualified_lead_reason string 否 不打算購買 待開發客戶遭標示為不符資格的原因。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

earn_virtual_currency

用來評估使用者在遊戲中獲得虛擬貨幣的次數。 連同 spend_virtual_currency 記錄這筆資料，您就能進一步瞭解 虛擬經濟活動

參數

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

exception

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

參數

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

generate_lead

此事件用來評估產生待開發客戶的時間 (例如透過 表單)。記錄此資料以瞭解您的行銷廣告活動效益。 有多少客戶在經過再行銷後再次與您的商家互動 以更全面、準確的方式回答顧客問題 並與顧客自然流暢地對話

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
lead_source string 否 商展 待開發客戶的來源。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

join_group

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

參數

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

level_end

這個事件代表玩家已在遊戲關卡結束。

參數

名稱 類型 必填 範例值 說明
level_name string 否 旅程就此展開... 等級名稱。
success boolean 否 true 如果等級順利完成，請設為 true。

level_start

此事件表示玩家已在遊戲中開始某個關卡。

參數

名稱 類型 必填 範例值 說明
level_name string 否 旅程就此展開... 等級名稱。

level_up

這個事件代表玩家已在遊戲中升級。可用於測量 找出使用者族群的安全分佈情形 完成。

參數

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

login

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

參數

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

page_view

這個事件代表使用者已瀏覽網頁。

參數

名稱 類型 必填 範例值 說明
page_location string 否 https://example.com 網頁的網址。
client_id string 否 ABC_123 用戶端 ID。
language string 否 en_us 用戶端的語言。請參閱語言 代碼和程式碼
page_encoding string 否 UTF-8 網頁的編碼。
page_title string 否 首頁 網頁的標題。
user_agent string 否 用戶端的使用者代理程式。

post_score

在使用者張貼得分時傳送這個事件。透過這個事件瞭解 列出使用者在遊戲中的表現，並將高分與目標對像或目標對象相關 行為

參數

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

purchase

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

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
transaction_id string 是 T_12345 交易的專屬 ID。

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

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
shipping number 否 3.33 與交易相關的運費。
tax number 否 1.11 與交易相關的稅金。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

qualify_lead

此事件用來評估使用者是否符合成為 有效待開發客戶。

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

refund

每當有一或多項商品退款給使用者時，就會使用這個事件。

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
coupon string 否 SUMMER_FUN 與事件相關聯的優待券名稱/代碼。

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
shipping number 否 3.33 與交易相關的運費。
tax number 否 1.11 與交易相關的稅金。
items Array<Item> 否* 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

remove_from_cart

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

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

記錄此事件以指出使用者何時執行搜尋。別擔心！您可以使用 用來找出使用者在網站或應用程式中搜尋的內容。適用對象 舉例來說，您可以在使用者於造訪網站後查看搜尋結果網頁時，傳送此事件 搜尋內容

參數

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

select_content

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

參數

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

select_item

這個事件表示已從清單中選取所需項目。

參數

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

如果在項目層級設定了值，系統會忽略這個值。
item_list_name string 否 相關產品 使用者在其中看到商品的清單名稱。

如果在項目層級設定了值，系統會忽略這個值。
items Array<Item> 是* 事件的項目。

* items 陣列應只包含一個 元素，代表所選項目。如果有多個元素 提供後，系統只會使用 items 中的第一個元素。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

select_promotion

此事件代表已選取促銷活動。

參數

名稱 類型 必填 範例值 說明
creative_name string 否 summer_banner2 促銷廣告素材的名稱。

如果在項目層級設定了值，系統會忽略這個值。
creative_slot string 否 featured_app_1 與 活動。

如果在項目層級設定了值，系統會忽略這個值。
promotion_id string 否 P_12345 與活動相關聯的促銷活動 ID。

如果在項目層級設定了值，系統會忽略這個值。
promotion_name string 否 夏季特賣 與活動相關聯的促銷活動名稱。

如果在項目層級設定了值，系統會忽略這個值。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
coupon string 否 SUMMER_FUN 與商品相關聯的優待券名稱/代碼。

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
creative_name string 否 summer_banner2 促銷廣告素材的名稱。

如果設定這個項目，系統會忽略事件層級的 creative_name。
如果未設定，則會使用事件層級的 creative_name (如果) 。
creative_slot string 否 featured_app_1 與 項目。

如果設定這個項目，系統會忽略事件層級的 creative_slot。
如果未設定，則會使用事件層級的 creative_slot (如果) 。
discount number 否 2 月 22 日 與商品相關聯的單位折扣金額。
index number 否 5 項目在清單中的索引/位置。
item_brand string 否 Google 商品品牌。
item_category string 否 服飾 商品類別。如果用做類別階層的一部分， 就會是第一個類別
item_category2 string 否 成人 商品的第二個類別階層或其他分類。
item_category3 string 否 襯衫 商品的第三個類別階層或其他分類。
item_category4 string 否 工作人員 商品的第四個類別階層或其他分類。
item_category5 string 否 短袖 商品的第五個類別階層或其他分類。
item_list_id string 否 related_products 使用者在其中看到商品的清單 ID。

如果設定這個項目，系統會忽略事件層級的 item_list_id。
如果未設定，則會使用事件層級的 item_list_id (如果) 。
item_list_name string 否 相關產品 使用者在其中看到商品的清單名稱。

如果設定這個項目，系統會忽略事件層級的 item_list_name。
如果未設定，則會使用事件層級的 item_list_name (如果) 。
item_variant string 否 綠色 其他商品的商品子類、專屬代碼，或是說明 詳細資料/選項。
location_id string 否 ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID) 與商品相關聯的實際位置 (例如 商店地點)。建議使用 Google 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
promotion_id string 否 P_12345 與商品相關聯的促銷活動 ID。

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

如果設定這個項目，系統會忽略事件層級的 promotion_name。
如果未設定，則會使用事件層級的 promotion_name (如果) 。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

share

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

參數

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

sign_up

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

參數

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

spend_virtual_currency

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

參數

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

tutorial_begin

此事件代表新手上路程序的開始。用於漏斗中 使用 tutorial_complete 瞭解有多少使用者完成教學課程。

參數

這個事件沒有任何參數。

tutorial_complete

這個事件代表使用者已完成新手上路流程。使用這份草稿 包含 tutorial_begin 的漏斗中，您就能瞭解有多少使用者完成了 教學課程。

參數

這個事件沒有建議參數。

unlock_achievement

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

參數

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

view_cart

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

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

view_item

這個事件代表已向使用者顯示部分內容。這個事件的用途 就能找出 最受歡迎的商品

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

view_item_list

系統向使用者顯示一系列 某些類別的影片

參數

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

如果在項目層級設定了值，系統會忽略這個值。
item_list_name string 否 相關產品 使用者在其中看到商品的清單名稱。

如果在項目層級設定了值，系統會忽略這個值。
items Array<Item> 是 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

view_promotion

這個事件代表使用者曾在清單中瀏覽促銷活動。

參數

名稱 類型 必填 範例值 說明
creative_name string 否 summer_banner2 促銷廣告素材的名稱。

如果在項目層級設定了值，系統會忽略這個值。
creative_slot string 否 featured_app_1 與 活動。

如果在項目層級設定了值，系統會忽略這個值。
promotion_id string 否 P_12345 與活動相關聯的促銷活動 ID。

如果在項目層級設定了值，系統會忽略這個值。
promotion_name string 否 夏季特賣 與活動相關聯的促銷活動名稱。

如果在項目層級設定了值，系統會忽略這個值。
items Array<Item> 是* 事件的項目。

* items 陣列應只包含一個 元素，代表與促銷活動相關的商品。如有多個 提供後，只有 items 中的第一個元素 。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
coupon string 否 SUMMER_FUN 與商品相關聯的優待券名稱/代碼。

事件層級和項目層級的 coupon 參數如下 而且不會產生獨立的差異
creative_name string 否 summer_banner2 促銷廣告素材的名稱。

如果設定這個項目，系統會忽略事件層級的 creative_name。
如果未設定，則會使用事件層級的 creative_name (如果) 。
creative_slot string 否 featured_app_1 與 項目。

如果設定這個項目，系統會忽略事件層級的 creative_slot。
如果未設定，則會使用事件層級的 creative_slot (如果) 。
discount number 否 2 月 22 日 與商品相關聯的單位折扣金額。
index number 否 5 項目在清單中的索引/位置。
item_brand string 否 Google 商品品牌。
item_category string 否 服飾 商品類別。如果用做類別階層的一部分， 就會是第一個類別
item_category2 string 否 成人 商品的第二個類別階層或其他分類。
item_category3 string 否 襯衫 商品的第三個類別階層或其他分類。
item_category4 string 否 工作人員 商品的第四個類別階層或其他分類。
item_category5 string 否 短袖 商品的第五個類別階層或其他分類。
item_list_id string 否 related_products 使用者在其中看到商品的清單 ID。

如果設定這個項目，系統會忽略事件層級的 item_list_id。
如果未設定，則會使用事件層級的 item_list_id (如果) 。
item_list_name string 否 相關產品 使用者在其中看到商品的清單名稱。

如果設定這個項目，系統會忽略事件層級的 item_list_name。
如果未設定，則會使用事件層級的 item_list_name (如果) 。
item_variant string 否 綠色 其他商品的商品子類、專屬代碼，或是說明 詳細資料/選項。
location_id string 否 ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID) 與商品相關聯的實際位置 (例如 商店地點)。建議使用 Google 與關聯項目相對應的地點 ID。自訂位置 您也可以使用 ID。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
promotion_id string 否 P_12345 與商品相關聯的促銷活動 ID。

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

如果設定這個項目，系統會忽略事件層級的 promotion_name。
如果未設定，則會使用事件層級的 promotion_name (如果) 。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。

view_search_results

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

參數

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

working_lead

用來評估使用者聯絡或代表聯絡的使用者。

參數

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

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

* 針對 中的所有項目，將 value 設為 (price * quantity) 的總和 items。請勿加入 shipping 或 tax，
* 製作有意義的報表通常需要 value。 如果標示 將事件視為轉換 value。
* 如果設定 value，則必須提供 currency。
lead_status string 否 已發起對話 待開發客戶的狀態。
items Array<Item> 否 事件的項目。

項目參數

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

商品的 ID。

*必須輸入 item_id 或 item_name。

item_name string 是* 史坦與朋友 T 恤

商品名稱。

*必須輸入 item_id 或 item_name。

affiliation string 否 Google 商店 產品關聯，用來指定供應公司/實體 實體商店位置。
注意：「聯盟」僅適用於項目範圍。
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。
注意：「位置 ID」僅適用於項目範圍。
price number 否 10.01 商品的貨幣單位價格，以指定貨幣為單位 參數。
如果商品適用折扣，請將 price 設為折扣單位價格， 請在 discount 參數中指定單價折扣。
quantity number 否 3

商品數量。

如未設定，quantity 會設為 1。
除了規定的參數外，您還可以加入 到 27 自訂參數 items 陣列內第一個參數。