這份參考資料列出 Google 代碼支援的建議事件。
translation: disabled
add_payment_info
這個事件表示使用者已在電子商務結帳程序中提交付款資訊。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件相關項目的貨幣,
3 個字母
ISO 4217 格式。 * 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額價值。 * 將 value 設為 items 中所有項目的 (price * quantity) 總和。請勿加入 shipping 或 tax ,
* 製作有意義的報表通常需要 value 。
如果您將事件標示為重要事件,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
coupon |
string |
否 | SUMMER_FUN | 與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
payment_type |
string |
否 | 信用卡資訊 | 所選付款方式。 |
items |
Array<Item> |
是 | 事件的項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必須輸入 |
item_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
item_category |
string |
否 | 服飾 | 商品類別。如果用做類別階層的一部分, 就會是第一個類別 |
item_category2 |
string |
否 | 成人 | 商品的第二個類別階層或其他分類。 |
item_category3 |
string |
否 | 襯衫 | 商品的第三個類別階層或其他分類。 |
item_category4 |
string |
否 | 工作人員 | 商品的第四個類別階層或其他分類。 |
item_category5 |
string |
否 | 短袖 | 商品的第五個類別階層或其他分類。 |
item_list_id |
string |
否 | related_products | 使用者在其中看到商品的清單 ID。 如果設定這個項目,系統會忽略事件層級的 item_list_id 。
如果未設定,則會使用事件層級的 item_list_id (如果)
。
|
item_list_name |
string |
否 | 相關產品 | 使用者在其中看到商品的清單名稱。 如果設定這個項目,系統會忽略事件層級的 item_list_name 。
如果未設定,則會使用事件層級的 item_list_name (如果)
。
|
item_variant |
string |
否 | 綠色 | 其他商品詳細資料/選項,如商品子類、專屬代碼或說明。 |
location_id |
string |
否 | ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID) |
與商品相關聯的實際位置 (例如
商店地點)。建議使用
Google
與關聯項目相對應的地點 ID。您也可以使用自訂位置 ID。 注意:`location id` 僅適用於項目範圍。 |
price |
number |
否 | 10.01 |
商品的貨幣單位價格,以指定貨幣為單位
參數。
如果商品適用折扣,請將 price 設為折扣單位價格,
請在 discount 參數中指定單價折扣。
|
quantity |
number |
否 | 3 |
商品數量。 |
items
陣列中加入最多 27 個自訂參數。
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
items
陣列中加入最多 27 個自訂參數。
close_convert_lead
此事件會評估待開發客戶完成轉換及完成的時間 (例如 購買)。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件 value 的幣別,
3 個字母
ISO 4217 格式。* 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額。 * 製作有意義的報表通常需要 value 。
如果標示
將事件設為重要事件
value 。
* 如果設定 value ,則必須提供 currency 。
|
close_unconvert_lead
用來評估使用者未成為已轉換的待開發客戶 和原因
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件 value 的幣別,
3 個字母
ISO 4217 格式。* 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額價值。 * 製作有意義的報表通常需要 value 。
如果標示
將事件設為重要事件
value 。
* 如果您設定 value ,則必須使用 currency 。 |
unconvert_lead_reason |
string |
否 | 從未回覆 | 待開發客戶未轉換的原因。 |
disqualify_lead
這項事件用於評估使用者何時被標示為無法成為待開發客戶,以及無法成為待開發客戶的原因。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件 value 的幣別,
3 個字母
ISO 4217 格式。* 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額。 * 製作有意義的報表通常需要 value 。
如果標示
將事件設為重要事件
value 。
* currency 是必填項目,如果您已設定 value 。 |
disqualified_lead_reason |
string |
否 | 不想購買 | 待開發客戶遭標示為不符資格的原因。 |
earn_virtual_currency
這項事件用於評估使用者在遊戲中獲得虛擬貨幣的時機。記錄這項資料並搭配 spend_virtual_currency,進一步瞭解您的虛擬經濟。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
virtual_currency_name |
string |
否 | 寶石 | 虛擬貨幣的名稱。 |
value |
number |
否 | 5 | 虛擬貨幣的值。 |
exception
當應用程式的正常執行流程中斷時,系統就會記錄例外狀況事件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
description |
string |
否 | 未填寫必要欄位。 | 發生的例外狀況說明。 |
fatal |
boolean |
否 | true |
是否為嚴重例外狀況。 |
generate_lead
這項事件會評估待開發客戶產生的時間 (例如透過表單產生)。記錄此資料以瞭解您的行銷廣告活動效益。 有多少客戶在經過再行銷後再次與您的商家互動 以更全面、準確的方式回答顧客問題 並與顧客自然流暢地對話
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件 value 的幣別,
3 個字母
ISO 4217 格式。* 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額。 * 製作有意義的報表通常需要 value 。
如果您將事件標示為重要事件,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
lead_source |
string |
否 | 商展 | 待開發客戶的來源。 |
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 |
否 | 登入方式。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
items
陣列內第一個參數。
qualify_lead
用來評估使用者是否符合成為合格待開發客戶的條件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件 value 的幣別,
3 個字母
ISO 4217 格式。* 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額價值。 * 製作有意義的報表通常需要 value 。
如果標示
將事件設為重要事件
value 。
* 如果設定 value ,則必須提供 currency 。
|
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
item_category |
string |
否 | 服飾 | 商品類別。如果用做類別階層的一部分, 就會是第一個類別 |
item_category2 |
string |
否 | 成人 | 商品的第二個類別階層或其他分類。 |
item_category3 |
string |
否 | 襯衫 | 商品的第三個類別階層或其他分類。 |
item_category4 |
string |
否 | 工作人員 | 商品的第四個類別階層或其他分類。 |
item_category5 |
string |
否 | 短袖 | 商品的第五個類別階層或其他分類。 |
item_list_id |
string |
否 | related_products | 使用者在其中看到商品的清單 ID。 如果設定這個項目,系統會忽略事件層級的 item_list_id 。
如果未設定,則會使用事件層級的 item_list_id (如果)
。
|
item_list_name |
string |
否 | 相關產品 | 使用者在其中看到商品的清單名稱。 如果設定這個項目,系統會忽略事件層級的 item_list_name 。
如果未設定,則會使用事件層級的 item_list_name (如果)
。
|
item_variant |
string |
否 | 綠色 | 其他商品詳細資料/選項,如商品子類、專屬代碼或說明。 |
location_id |
string |
否 | ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID) |
與商品相關聯的實際位置 (例如
商店地點)。建議使用
Google
與關聯項目相對應的地點 ID。自訂位置
您也可以使用 ID。 注意:`location id` 僅適用於項目範圍。 |
price |
number |
否 | 10.01 |
商品的貨幣單位價格,以指定貨幣為單位
參數。
如果商品適用折扣,請將 price 設為折扣單位價格,
請在 discount 參數中指定單價折扣。
|
quantity |
number |
否 | 3 |
商品數量。 |
items
陣列內第一個參數。
search
記錄此事件以指出使用者何時執行搜尋。別擔心!您可以使用 用來找出使用者在網站或應用程式中搜尋的內容。適用對象 舉例來說,您可以在使用者於造訪網站後查看搜尋結果網頁時,傳送此事件 搜尋內容
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
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 |
否 | 商品品牌。 | |
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 |
商品數量。 |
items
陣列中加入最多 27 個自訂參數。
share
當使用者分享內容時,請使用這個事件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
method |
string |
否 | 分享內容的方式。 | |
content_type |
string |
否 | 圖片 | 共用內容的類型。 |
item_id |
string |
否 | C_12345 | 分享內容的 ID。 |
sign_up
這項事件表示使用者已註冊帳戶。這個事件的用途 瞭解已登入和登出使用者的不同行為。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
method |
string |
否 | 註冊方式。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
item_category |
string |
否 | 服飾 | 商品類別。如果用做類別階層的一部分, 就會是第一個類別 |
item_category2 |
string |
否 | 成人 | 商品的第二個類別階層或其他分類。 |
item_category3 |
string |
否 | 襯衫 | 商品的第三個類別階層或其他分類。 |
item_category4 |
string |
否 | 工作人員 | 商品的第四個類別階層或其他分類。 |
item_category5 |
string |
否 | 短袖 | 商品的第五個類別階層或其他分類。 |
item_list_id |
string |
否 | related_products | 使用者在其中看到商品的清單 ID。 如果設定這個項目,系統會忽略事件層級的 item_list_id 。
如果未設定,則會使用事件層級的 item_list_id (如果)
。
|
item_list_name |
string |
否 | 相關產品 | 使用者在其中看到商品的清單名稱。 如果設定這個項目,系統會忽略事件層級的 item_list_name 。
如果未設定,則會使用事件層級的 item_list_name (如果)
。
|
item_variant |
string |
否 | 綠色 | 其他商品詳細資料/選項,如商品子類、專屬代碼或說明。 |
location_id |
string |
否 | ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID) |
與商品相關聯的實際位置 (例如實體商店位置)。建議使用
Google
與關聯項目相對應的地點 ID。您也可以使用自訂位置 ID。 注意:`location id` 僅適用於項目範圍。 |
price |
number |
否 | 10.01 |
商品的貨幣單位價格,以指定貨幣為單位
參數。
如果商品適用折扣,請將 price 設為折扣單位價格,
請在 discount 參數中指定單價折扣。
|
quantity |
number |
否 | 3 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
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 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
affiliation |
string |
否 | Google 商店 |
產品關聯,用來指定供應公司/實體
實體商店位置。 注意:「聯盟」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關的優待券名稱/代碼。 事件層級和項目層級的 coupon 參數如下
而且不會產生獨立的差異
|
discount |
number |
否 | 2.22 | 與商品相關聯的單位折扣金額。 |
index |
number |
否 | 5 | 項目在清單中的索引/位置。 |
item_brand |
string |
否 | 商品品牌。 | |
item_category |
string |
否 | 服飾 | 商品類別。如果用做類別階層的一部分, 就會是第一個類別 |
item_category2 |
string |
否 | 成人 | 商品的第二個類別階層或其他分類。 |
item_category3 |
string |
否 | 襯衫 | 商品的第三個類別階層或其他分類。 |
item_category4 |
string |
否 | 工作人員 | 商品的第四個類別階層或其他分類。 |
item_category5 |
string |
否 | 短袖 | 商品的第五個類別階層或其他分類。 |
item_list_id |
string |
否 | related_products | 使用者在其中看到商品的清單 ID。 如果設定這個項目,系統會忽略事件層級的 item_list_id 。
如果未設定,則會使用事件層級的 item_list_id (如果)
。
|
item_list_name |
string |
否 | 相關產品 | 使用者在其中看到商品的清單名稱。 如果設定這個項目,系統會忽略事件層級的 item_list_name 。
如果未設定,則會使用事件層級的 item_list_name (如果)
。
|
item_variant |
string |
否 | 綠色 | 其他商品詳細資料/選項,如商品子類、專屬代碼或說明。 |
location_id |
string |
否 | ChIJIQBpAG2ahYAR_6128GcTUEo (舊金山的 Google 地點 ID) |
與商品相關聯的實際位置 (例如
商店地點)。建議使用與關聯項目相符的 Google 地點 ID。自訂位置
您也可以使用 ID。 注意:`location id` 僅適用於項目範圍。 |
price |
number |
否 | 10.01 |
商品的貨幣單位價格,以指定貨幣為單位
參數。
如果商品適用折扣,請將 price 設為折扣單位價格,
請在 discount 參數中指定單價折扣。
|
quantity |
number |
否 | 3 |
商品數量。 |
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_name |
string |
是* | 史坦與朋友 T 恤 |
商品名稱。
*必須輸入 |
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 |
否 | 商品品牌。 | |
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 |
商品數量。 |
items
陣列內第一個參數。
view_search_results
系統向使用者顯示搜尋結果時,記錄此事件。請注意,您可以透過 Google Analytics 中的加強型事件評估功能,啟用 view_search_results 事件供自動收集。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
search_term |
string |
否 | 服飾 | 用於搜尋的字詞。 |
working_lead
用來評估使用者聯絡或代表聯絡的使用者。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
是* | 美元 |
事件 value 的幣別,
3 個字母
ISO 4217 格式。* 如果設定 value ,就必須使用 currency
才能準確計算收益指標
|
value |
number |
是* | 30.03 | 事件的金額價值。 * 製作有意義的報表通常需要 value 。
如果標示
將事件設為重要事件
value 。
* 如果設定 value ,則必須提供 currency 。
|
lead_status |
string |
否 | 已發起對話 | 待開發客戶的狀態。 |