這份參考資料列出 Google 代碼支援的事件。
add_payment_info
這個事件代表使用者已提交付款資訊。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
coupon |
string |
否 | SUMMER_FUN | 與活動相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
payment_type |
string |
否 | 信用卡 | 選擇的付款方式。 |
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
add_shipping_info
這個事件代表使用者已提交運送資訊。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * 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 |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
add_to_cart
這個事件代表使用者已將商品加入購物車。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
add_to_wishlist
事件表示該項目已加入願望清單。使用這個事件可識別應用程式中的熱門禮物。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
begin_checkout
這個事件代表使用者已開始結帳。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
coupon |
string |
否 | SUMMER_FUN | 與活動相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
earn_virtual_currency
這項活動旨在評估虛擬貨幣的頒獎結果。與 spend_virtual_currency 一併記錄,以進一步瞭解您的虛擬經濟。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
virtual_currency_name |
string |
否 | 寶石 | 虛擬貨幣的名稱。 |
value |
number |
否 | 5 | 虛擬貨幣的值。 |
例外狀況
應用程式的執行作業正常流程中斷時,系統就會記錄例外狀況事件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
description |
string |
否 | 未填寫必要欄位。 | 例外狀況的描述。 |
fatal |
boolean |
否 | true |
例外狀況是否為嚴重錯誤。 |
generate_lead
產生待開發客戶後,請記錄這個事件,瞭解再參與廣告活動的效益。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
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 |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
transaction_id |
string |
有 | T_12345 | 交易的專屬 ID。transaction_id 參數有助於避免發生重複的購買交易。 |
value |
number |
有* | 12.21 | 事件金額。 * value 需要有意義的報表,並填入購買者預測目標對象。
* 如果設定 value ,則必須提供 currency 。
|
coupon |
string |
否 | SUMMER_FUN | 與活動相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
shipping |
number |
否 | 5.30 | 與交易相關的運費。 |
tax |
number |
否 | 1.11 | 與交易相關的稅金費用。 |
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
refund
當有一或多個項目退款給使用者時,系統會使用這個事件來表示。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
transaction_id |
string |
有 | T_12345 | 交易的專屬 ID。 |
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
coupon |
string |
否 | SUMMER_FUN | 與活動相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
shipping |
number |
否 | 5.30 | 與交易相關的運費。 |
tax |
number |
否 | 1.11 | 與交易相關的稅金費用。 |
items |
Array<Item>
|
否* | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
remove_from_cart
這個事件代表已從購物車中移除商品。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
search
使用這個事件,將搜尋作業的情境化。這個事件可協助您找出應用程式中最熱門的內容。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
search_term |
string |
有 | T 恤印製 | 搜尋的字詞。 |
select_content
這個事件表示使用者已選取特定類型的內容。 這個事件可協助您找出應用程式中的熱門內容和內容類別。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
content_type |
string |
否 | 產品 | 所選內容的類型。 |
item_id |
string |
否 | I_12345 | 所選項目的 ID。 |
select_item
這個事件代表已選取清單中的一個項目。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_list_id |
string |
否 | 相關產品 | 使用者在其中看到商品的清單 ID。 如果在商品層級設定,系統會忽略這項資訊。 |
item_list_name |
string |
否 | 相關產品 | 使用者在其中看到商品的清單名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
items |
Array<Item> |
有* | 活動項目。 * items 陣列預計必須包含一個元素,用來呈現所選項目。如果提供多個元素,系統只會使用 items 中的第一個元素。
|
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
select_promotion
這個事件代表系統已選取清單中的促銷活動。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
creative_slot |
string |
否 | 精選應用程式_1 | 與事件相關聯的促銷廣告素材版位名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
promotion_id |
string |
否 | P_12345 |
與事件相關聯的促銷活動 ID。 如果在商品層級設定,系統會忽略這項資訊。 |
promotion_name |
string |
否 | 夏季促銷 |
與事件相關聯的促銷活動名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
items |
Array<Item>
|
否 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
分享
在使用者分享內容時使用這個事件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
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 |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
view_item
這個事件表示使用者看到部分內容。使用這個事件即可探索最熱門的項目。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
currency |
string |
有* | USD |
與事件相關聯的項目貨幣,採 3 個英文字母組成的 ISO 4217 格式。 * 如果設定 value ,就必須有 currency 才能準確計算收益指標。
|
value |
number |
有* | 7.77 | 事件金額。 * value 通常需要提供有意義的報表。
如果您將事件標示為轉換,建議您設定 value 。* 如果設定 value ,則必須提供 currency 。
|
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
view_item_list
當使用者查看特定類別的項目清單時,請記錄這個事件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_list_id |
string |
否 | 相關產品 | 使用者在其中看到商品的清單 ID。 如果在商品層級設定,系統會忽略這項資訊。 |
item_list_name |
string |
否 | 相關產品 | 使用者在其中看到商品的清單名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
items |
Array<Item> |
有 | 活動項目。 |
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
view_promotion
這個事件代表使用者觀看了宣傳活動。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
creative_slot |
string |
否 | 精選應用程式_1 | 與事件相關聯的促銷廣告素材版位名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
promotion_id |
string |
否 | P_12345 |
與事件相關聯的促銷活動 ID。 如果在商品層級設定,系統會忽略這項資訊。 |
promotion_name |
string |
否 | 夏季促銷 |
與事件相關聯的促銷活動名稱。 如果在商品層級設定,系統會忽略這項資訊。 |
items |
Array<Item> |
有* | 活動項目。 * items 陣列預計必須包含單一元素,用來代表與促銷活動相關的項目。如果提供多個元素,系統只會使用 items 中的第一個元素。
|
項目參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
item_id |
string |
有* | SKU_12345 |
商品的 ID。
* |
item_name |
string |
有* | 《Stan and Friends T 恤》 |
商品名稱。
* |
affiliation |
string |
否 | Google 商店 |
用來指定供貨公司或實體門市據點的產品聯盟。 注意:「affiliation」僅適用於項目範圍。 |
coupon |
string |
否 | SUMMER_FUN | 與商品相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。 |
creative_name |
string |
否 | 夏季橫幅 2 | 促銷廣告素材的名稱。 如果已設定這項屬性,系統會忽略事件層級的 creative_name 。
如果未設定,則會使用事件層級的 creative_name (如果有的話)。 |
creative_slot |
string |
否 | 精選應用程式_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 |
否 | 相關產品 | 使用者在其中看到商品的清單 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 Place ID) |
與商品相關聯的實體位置 (例如實體商店位置)。建議您使用與關聯項目對應的 Google Place ID。您也可以使用自訂位置 ID。 注意:「location id」僅於項目層級提供。 |
price |
number |
否 | 9.99 | 商品的金額,以指定的貨幣參數為單位。 |
promotion_id |
string |
否 | P_12345 |
與商品相關聯的促銷活動 ID。 如果已設定這項屬性,系統會忽略事件層級的 promotion_id 。
如果未設定,則會使用事件層級的 promotion_id (如果有的話)。 |
promotion_name |
string |
否 | 夏季促銷 |
與商品相關聯的促銷活動名稱。 如果已設定這項屬性,系統會忽略事件層級的 promotion_name 。
如果未設定,則會使用事件層級的 promotion_name (如果有的話)。 |
quantity |
number |
否 | 1 |
商品數量。 |
view_search_results
使用者收到搜尋結果之後,您就可以記錄這個事件。
參數
名稱 | 類型 | 必填 | 範例值 | 說明 |
---|---|---|---|---|
search_term |
string |
否 | 服飾 | 用於搜尋的字詞。 |
items |
Array<Item> |
有 | 活動項目。 |