事件資料架構參考

本頁列出 Appier 記錄或定義的所有事件,以及各事件專屬的屬性。

  • 事件:目前使用中的事件,含標籤與事件專屬屬性。
  • 已停用的事件:已停止使用的事件,但資料中仍可能出現舊版 SDK 記錄的這類事件。
  • AIRIS 系統事件屬性:AIRIS 會自動加到每個追蹤事件的屬性,各事件卡片中不再重複列出。

如何閱讀本頁

事件標籤

本頁以標籤標示事件由誰傳送,以及是否影響計費。

標籤說明
預設 Appier 的 SDK 或後端會自動記錄此事件,不需要另外加入程式碼。
系統定義 事件名稱與屬性由 Appier 定義,事件由您傳送。請完全依照定義傳送事件名稱與屬性,Appier 的功能才能使用這些資料。傳送時須遵守資料記錄準則。
計費 此事件會計入每月的事件用量上限。
計入 MAU 此事件會將使用者計入每月活躍使用者(Monthly Active User,MAU)的用量上限。

事件屬性標籤

每次記錄事件時,都必須包含標示為必填的屬性,部分 Appier 功能需要這些屬性才能運作。系統定義事件的其他屬性也建議一併傳送,以支援更多使用情境,並提升 Appier 功能的成效。


事件

accept_NTN

預設計費

使用者同意接收定期通知訊息時,BotBonnie 會產生此事件。權限詳細資訊也會存入 ntn 使用者屬性。

屬性
類型
說明
token
字串
傳送通知訊息給使用者時使用的 token。
範例: "1234567890123456789"
topic
字串
通知訊息的主題。
範例: "default"
expired
整數
權限的到期時間,格式為 Unix 時間戳記(毫秒)。
範例: 2145916800000
frequency
字串
可傳送通知訊息的頻率:「DAILY」、「WEEKLY」或「MONTHLY」。
範例: "WEEKLY"

accept_OTN

預設計費

使用者同意接收一次性通知訊息時,BotBonnie 會產生此事件。

屬性
類型
說明
token
字串
傳送通知訊息給使用者時使用的 token。
範例: "1234567890123456789"
topic
字串
通知訊息的主題。
範例: "default"
expired
整數
權限的到期時間,格式為 Unix 時間戳記(毫秒)。
範例: 2145916800000
frequency
字串
可傳送通知訊息的頻率:「DAILY」、「WEEKLY」或「MONTHLY」。
範例: "WEEKLY"

account_link

預設計費

使用者將 BotBonnie 身分連結至外部會員帳號時,BotBonnie 會產生此事件。已連結的帳號 ID 也會存入 account_linked 使用者屬性。

屬性
類型
說明
account_linked
字串
已連結的外部帳號 ID。
範例: "MEMBER-ID-123"

account_unlink

預設計費

使用者取消 BotBonnie 身分與外部會員帳號的連結時,BotBonnie 會產生此事件。

屬性
類型
說明
account_linked
字串
已取消連結的外部帳號 ID。
範例: "MEMBER-ID-123"

actionclicked

預設

使用者點擊推播通知上的動作按鈕(包含複製代碼按鈕)時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
actionid
字串
使用者點擊的動作按鈕 ID,即推播 payload 中定義的 ID。
範例: "btn_view"

add_tag

預設計費

使用者被加上標籤時,BotBonnie 會產生此事件。使用者完整的標籤清單也會存入 bb_tag_ids 與 bb_tag_names 使用者屬性。

屬性
類型
說明
bb_tag_ids
字串陣列
新增的標籤 ID。
範例: ["tag-AbC123xYz"]
bb_tag_names
字串陣列
新增的標籤名稱。
範例: ["VIP"]

aiq_cg_received

預設

App 內或網頁內行銷活動針對實驗控制組的使用者觸發時記錄此事件。系統不會顯示訊息,並以此事件取代 qg_inapp_displayed 或 qg_inweb_displayed。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
type
字串
App 內訊息類型(Android);控制組一律為 0。
範例: "0"

aiq_deep_link_redirected

預設

使用者透過深層連結或通用連結開啟 App 時記錄此事件,並附上原始網址、網址中的 UTM 與歸因參數,以及上次啟動 App 的時間。

屬性
類型
說明
url
字串
開啟 App 的原始深層連結或通用連結網址。
範例: "myapp://products/123?utm_source=newsletter&asi=a1b2c3d4e5f6"
asi
字串
從深層連結取得的 Appier 廣告歸因 ID,用於廣告歸因。
範例: "a1b2c3d4e5f6"
timestamp
整數
處理深層連結的時間,格式為 Unix 時間戳記(毫秒)。
範例: 1727671200000
last_app_launched_time
整數
此深層連結之前,最後一次啟動 App 的時間,格式為 Unix 時間戳記(毫秒)。
範例: 1727671200000
utm_source
字串
開啟 App 的深層連結中的 UTM 來源。重複的值會以逗號串接。
範例: "newsletter"
utm_medium
字串
開啟 App 的深層連結中的 UTM 媒介。重複的值會以逗號串接。
範例: "email"
utm_campaign
字串
開啟 App 的深層連結中的 UTM 行銷活動名稱。重複的值會以逗號串接。
範例: "spring_sale"
utm_term
字串
開啟 App 的深層連結中的 UTM 詞彙(付費搜尋關鍵字)。重複的值會以逗號串接。
範例: "running shoes"
utm_content
字串
開啟 App 的深層連結中的 UTM 內容,用來區分同一個行銷活動中的不同廣告或連結。重複的值會以逗號串接。
範例: "banner_a"
utm_id
字串
開啟 App 的深層連結中的 UTM 行銷活動 ID。重複的值會以逗號串接。
範例: "cmp_2024_01"
utm_source_platform
字串
開啟 App 的深層連結中的 UTM 來源平台(GA4 參數)。重複的值會以逗號串接。
範例: "google_ads"
utm_creative_format
字串
開啟 App 的深層連結中的 UTM 廣告內容格式(GA4 參數)。重複的值會以逗號串接。
範例: "display"
utm_marketing_tactic
字串
開啟 App 的深層連結中的 UTM 行銷策略(GA4 參數)。重複的值會以逗號串接。
範例: "prospecting"

aiq_geofence

預設

Android SDK 一次傳送一批地理柵欄進出紀錄時記錄此事件。每次進出都會以一筆紀錄的形式放在 transitions 屬性中。帳號已啟用地理柵欄功能時才會記錄。

屬性
類型
說明
transitions
字串
進出紀錄的 JSON 陣列,以單一字串傳送。每筆紀錄含 latitude、longitude、timestamp(Unix 時間戳記,單位為秒)、provider、geofence_id、geofence_name、geofence_latitude、geofence_longitude、geofence_radius、transition(1 = 進入,2 = 離開)與 isMock;裝置有回報時,還會加上 altitude、accuracy、speed、bearing、bearingAccuracyDegrees、verticalAccuracy、speedAccuracy 與 isComplete。
範例: [{"geofence_id": "1024", "transition": 1, "latitude": 25.0480, "longitude": 121.5172, "timestamp": 1727671200}]

aiq_kakao_pending

預設

Infobip 回報 Kakao 行銷活動訊息尚未送達(待處理)時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
供應商報告中的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 收到供應商報告的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
vendor
字串
回報狀態的供應商:kakaoinfobip。
範例: "kakaoinfobip"
error
字串
Infobip 回報的錯誤類別,即 Infobip 錯誤群組名稱的第一部分。
範例: "OK"
infobip_status_name
字串
Infobip 回報的狀態名稱。
範例: "PENDING_ENROUTE"
infobip_error_name
字串
Infobip 回報的錯誤名稱。
範例: "NO_ERROR"
infobip_mccmnc
字串
Infobip 回報的行動網路代碼(MCC+MNC)。
範例: "46692"

aiq_kakao_rejected

預設

Infobip 回報 Kakao 行銷活動訊息無法送達時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
供應商報告中的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 收到供應商報告的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
vendor
字串
回報失敗的供應商:kakaoinfobip。
範例: "kakaoinfobip"
error
字串
Infobip 回報的錯誤類別,即 Infobip 錯誤群組名稱的第一部分。
範例: "USER"
infobip_status_name
字串
Infobip 回報的狀態名稱。
範例: "UNDELIVERABLE_NOT_DELIVERED"
infobip_error_name
字串
Infobip 回報的錯誤名稱。
範例: "EC_ABSENT_SUBSCRIBER"
infobip_mccmnc
字串
Infobip 回報的行動網路代碼(MCC+MNC)。
範例: "46692"

aiq_mms_operation_failed

預設

多媒體簡訊的傳送請求整批失敗時記錄此事件。原因是 Mitake 針對請求回傳錯誤,或 AIQUA 無法完成請求,因此沒有任何訊息被受理。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
ts
整數
AIQUA 記錄失敗的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
vender
字串
發送失敗的傳送端:mmsmitake。
範例: "mmsmitake"
error_code
字串
Mitake 針對請求回傳的錯誤代碼,或 AIQUA 的內部錯誤代碼。
範例: "1007"
error_description
字串
Mitake 針對請求回傳的錯誤說明,或 AIQUA 的內部錯誤說明。
範例: "Quantities of concurrent connections for this account are over the upper limit."

aiq_mms_rejected

預設

Mitake 回報多媒體簡訊行銷活動訊息無法送達時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
供應商報告中的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 收到供應商報告的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
vender
字串
回報失敗的供應商:mmsmitake。
範例: "mmsmitake"
status_code
字串
Mitake 回報的失敗狀態代碼。
範例: "4"
status_desc
字串
Mitake 失敗狀態代碼的說明。
範例: "Invalid recipient"

aiq_mms_sending_failed

預設

Mitake 受理多媒體簡訊傳送請求,但拒絕其中個別訊息時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
ts
整數
AIQUA 記錄失敗的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
vender
字串
發送失敗的傳送端:mmsmitake。
範例: "mmsmitake"
vendortrackid
字串
Mitake 為被拒絕的訊息指派的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
error_code
字串
Mitake 針對訊息回傳的狀態代碼。
範例: "4"
error_description
字串
Mitake 針對訊息回傳的狀態說明。
範例: "Invalid recipient"

aiq_notification_blocked

預設

推播通知已收到但未顯示時記錄此事件,原因是通知在設定的使用者休息時間內送達,或送達時已過期。只適用於 Android。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

aiq_onsite_experience_clicked

預設

使用者點擊站內體驗行銷活動所加入內容中的連結時記錄此事件。

屬性
類型
說明
experience_id
字串
站內體驗行銷活動的 ID。
範例: "exp_301"
creative_id
字串
站內體驗中顯示的內容 ID。
範例: "crv_77"

aiq_onsite_experience_displayed

預設

站內體驗行銷活動針對使用者變更網站內容時記錄此事件。

屬性
類型
說明
experience_id
字串
站內體驗行銷活動的 ID。
範例: "exp_301"
creative_id
字串
站內體驗中顯示的內容 ID。
範例: "crv_77"

aiq_sms_pending

預設

簡訊供應商回報簡訊行銷活動訊息已受理但尚未送達(待處理或緩衝中)時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
供應商報告中的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 收到供應商報告的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
msgcount
整數
訊息使用的簡訊額度數量(Vonage)。
範例: 1
vonage_status
字串
Vonage 回報的送達狀態。
範例: "buffered"
vonage_err_code
字串
Vonage 回報的錯誤代碼。
範例: "0"
vonage_network_code
字串
Vonage 回報的行動網路代碼。
範例: "46692"
error
字串
Infobip 簡訊回報的錯誤類別,即 Infobip 錯誤群組名稱的第一部分。
範例: "OK"
infobip_status_name
字串
Infobip 簡訊回報的狀態名稱。
範例: "PENDING_ENROUTE"
infobip_error_name
字串
Infobip 簡訊回報的錯誤名稱。
範例: "NO_ERROR"
infobip_mccmnc
字串
Infobip 簡訊回報的行動網路代碼(MCC+MNC)。
範例: "46692"

aiq_sms_rejected

預設

簡訊供應商回報簡訊行銷活動訊息無法送達時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
供應商報告中的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 收到供應商報告的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
error
字串
錯誤類別。Vonage 為「HANDSET」、「USER」、「OPERATOR」或「VENDOR」,由錯誤代碼對應而來;Infobip 為錯誤群組名稱的第一部分;Mitake 一律為「VENDOR」。
範例: "HANDSET"
msgcount
整數
訊息使用的簡訊額度數量(Vonage)。
範例: 1
vonage_status
字串
Vonage 回報的送達狀態。
範例: "rejected"
vonage_err_code
字串
Vonage 回報的錯誤代碼。
範例: "6"
vonage_network_code
字串
Vonage 回報的行動網路代碼。
範例: "46692"
infobip_status_name
字串
Infobip 回報的狀態名稱。只適用於 Infobip 簡訊。
範例: "UNDELIVERABLE_NOT_DELIVERED"
infobip_error_name
字串
Infobip 回報的錯誤名稱。只適用於 Infobip 簡訊。
範例: "EC_ABSENT_SUBSCRIBER"
infobip_mccmnc
字串
Infobip 回報的行動網路代碼(MCC+MNC)。只適用於 Infobip 簡訊。
範例: "46692"
vender
字串
回報失敗的供應商:mitake。只適用於 Mitake 簡訊。
範例: "mitake"
status_code
字串
Mitake 回報的狀態代碼。只適用於 Mitake 簡訊。
範例: "0"
status_flag
字串
Mitake 回報的狀態旗標。只適用於 Mitake 簡訊。
範例: "5"
status_flag_meaning
字串
Mitake 狀態旗標的意義。只適用於 Mitake 簡訊。
範例: "內容有錯誤"
status_string
字串
Mitake 回報的狀態字串。只適用於 Mitake 簡訊。
範例: "SYNTAXE"

aiq_switch_app_id

預設

App 將 SDK 切換至另一個 Appier App ID 時記錄此事件,並附上切換前後的 ID。

屬性
類型
說明
from
字串
切換前 SDK 使用的 Appier App ID。
範例: "0123456789abcdef0123"
to
字串
SDK 切換後使用的 Appier App ID。
範例: "abcdef0123456789abcd"

app_launched

預設計費計入 MAU

每次啟動 App 或將 App 切換到前景時記錄此事件。App 在背景啟動時不會記錄,例如被靜默推播喚醒的情況。

沒有事件專屬屬性。

appier_property_update

預設計費

每次使用者屬性的值變更時記錄此事件,並附上屬性的新值與舊值。此事件只會顯示在 AIRIS 中。

屬性
類型
說明
property
字串
值有變更的使用者屬性名稱。
範例: "membership_level"
value
字串
使用者屬性的新值。
範例: "gold"
last
字串
使用者屬性的舊值。屬性原本沒有值時為空。
範例: "silver"

beacon

預設計費

使用者進入 LINE Beacon 範圍時,BotBonnie 會產生此事件。

屬性
類型
說明
hwid
字串
LINE Beacon 的硬體 ID。
範例: "0000012345"

button click

預設計費

使用者點擊網站上的連結、按鈕或提交按鈕時,AIRIS 會產生此事件。點擊追蹤預設為開啟。AIRIS 也會加上 AIRIS 系統事件屬性。

屬性
類型
說明
text
字串
被點擊元素的文字。
範例: "Add to cart"
url
字串
被點擊元素的連結網址。元素是連結時才會傳送。
page_url
字串
發生點擊的頁面網址。
page_title
字串
發生點擊的頁面標題。
範例: "Running Shoes X1 | Example Store"
tag_name
字串
被點擊元素的 HTML 標籤。較舊的資料可能改用 tagname。
範例: "button"
classname
字串
被點擊元素的 CSS class。
範例: "btn btn-primary"
type
字串
被點擊元素的 type 屬性。
範例: "submit"
title
字串
被點擊元素的 title 屬性。
範例: "Add this item to your cart"
pointer_type
字串
點擊時使用的輸入方式:「mouse」、「touch」或「pen」。
範例: "mouse"
dom_path
字串
被點擊元素在頁面中的位置,以 CSS 路徑表示。
範例: "body > main > section[1] > form#cart-form > button"

cancel_NTN

預設計費

使用者停止接收定期通知訊息時,BotBonnie 會產生此事件。

屬性
類型
說明
token
字串
傳送通知訊息給使用者時使用的 token。
範例: "1234567890123456789"
topic
字串
通知訊息的主題。
範例: "default"
expired
整數
權限的到期時間,格式為 Unix 時間戳記(毫秒)。
範例: 2145916800000
frequency
字串
可傳送通知訊息的頻率:「DAILY」、「WEEKLY」或「MONTHLY」。
範例: "WEEKLY"

category_viewed

系統定義計費

使用者瀏覽商品類別頁面時,請記錄此事件。

屬性
類型
說明
category_name
字串
以逗號分隔的類別清單。類別名稱必須與商品目錄中的類別相符。
範例: "Shoes,Running"
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
事件記錄範例
appier('event', 'category_viewed', {
  category_name: 'Shoes,Running',
  user_id: 'member_10023'
});
var properties: [String: Any] = [:]
properties["category_name"] = "Shoes,Running"
properties["user_id"] = "member_10023"
QGSdk.getSharedInstance().logEvent("category_viewed",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("category_name", "Shoes,Running")
    properties.put("user_id", "member_10023")
    QG.getInstance(context).logEvent("category_viewed", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

checkout_completed

系統定義計費

使用者完成結帳時,每筆訂單記錄一次此事件。請將此事件作為轉換事件,並針對訂單中的每項商品各記錄一個 product_purchased 事件。記錄時請帶入訂單總額作為 valueToSum。

屬性
類型
說明
order_id必填
字串
訂單的唯一 ID。
範例: "ORD-20240930-001"
order_quantity
整數
訂單中的商品總數。
範例: 2
order_amount
浮點數
此事件的訂單金額。
範例: 1599.98
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
currency
字串
此事件中價格使用的幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
事件記錄範例
appier('event', 'checkout_completed', {
  order_id: 'ORD-20240930-001',
  order_quantity: 2,
  order_amount: 1599.98,
  user_id: 'member_10023',
  currency: 'TWD'
}, 1599.98);
var properties: [String: Any] = [:]
properties["order_id"] = "ORD-20240930-001"
properties["order_quantity"] = 2
properties["order_amount"] = 1599.98
properties["user_id"] = "member_10023"
properties["currency"] = "TWD"
QGSdk.getSharedInstance().logEvent("checkout_completed",
                                   withParameters: properties,
                                   withValueToSum: 1599.98)
try {
    val properties = JSONObject()
    properties.put("order_id", "ORD-20240930-001")
    properties.put("order_quantity", 2)
    properties.put("order_amount", 1599.98)
    properties.put("user_id", "member_10023")
    properties.put("currency", "TWD")
    QG.getInstance(context).logEvent("checkout_completed", properties, 1599.98)
} catch (e: JSONException) {
    // 處理例外狀況
}

checkout_initiated

系統定義計費

使用者開始結帳流程時,請記錄此事件。

屬性
類型
說明
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
currency
字串
此事件中價格使用的幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
事件記錄範例
appier('event', 'checkout_initiated', {
  user_id: 'member_10023',
  currency: 'TWD'
});
var properties: [String: Any] = [:]
properties["user_id"] = "member_10023"
properties["currency"] = "TWD"
QGSdk.getSharedInstance().logEvent("checkout_initiated",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("user_id", "member_10023")
    properties.put("currency", "TWD")
    QG.getInstance(context).logEvent("checkout_initiated", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

click

預設計費計入 MAU

使用者點擊聊天機器人訊息中的按鈕或回傳動作時,BotBonnie 會產生此事件。

屬性
類型
說明
value
字串
含此按鈕的聊天機器人訊息模組 ID。
範例: "module-AbC123xYz"

content_detail_viewed

系統定義計費

重要的詳細資訊頁面顯示時,請記錄此事件,例如服務、課程、方案、房產或諮詢的詳細資訊頁面。請在頁面成功顯示後才記錄。只適用於網站。

屬性
類型
說明
content_id必填
字串
頁面上顯示內容的唯一 ID。
範例: "SERVICE-123"
content_name
字串
內容的顯示名稱。
範例: "Financial Planning Consultation"
content_type
字串
內容類型。
範例: "service"
content_category
字串
內容類別,由您自行定義。
範例: "financial_planning"
content_link
字串
內容詳細資訊頁面的完整網址。
事件記錄範例
appier('event', 'content_detail_viewed', {
  content_id: 'SERVICE-123',
  content_name: 'Financial Planning Consultation',
  content_type: 'service',
  content_category: 'financial_planning',
  content_link: 'https://example.com/services/financial-planning'
});

delete_params

預設計費

使用者的自訂欄位或基本資料被刪除時,BotBonnie 會產生此事件。只會傳送被刪除的欄位。

屬性
類型
說明
bb_params_<encoded field name>
物件
被刪除的自訂欄位,含欄位值(value)與欄位名稱(name)。屬性名稱的結尾是編碼後的欄位名稱。
範例: {"value": "2025-08-13", "name": "Membership expiry date"}

download

預設計費

使用者點擊網站上的連結,下載 PDF、ZIP、Office 文件、影片等檔案時,AIRIS 會產生此事件。下載追蹤預設為開啟。UTM 與行銷活動屬性描述的是此次造訪,而非檔案本身。AIRIS 也會加上 AIRIS 系統事件屬性。

屬性
類型
說明
url
字串
下載檔案的網址。
utm_source
字串
此次造訪的 UTM 來源,取自到達網頁網址。
範例: "newsletter"
utm_medium
字串
此次造訪的 UTM 媒介,取自到達網頁網址。
範例: "email"
utm_campaign
字串
此次造訪的 UTM 行銷活動名稱,取自到達網頁網址。
範例: "spring_sale"
utm_term
字串
此次造訪的 UTM 詞彙,取自到達網頁網址。
範例: "running shoes"
utm_content
字串
此次造訪的 UTM 內容,取自到達網頁網址。
範例: "banner_a"
utm_id
字串
此次造訪的 UTM 行銷活動 ID,取自到達網頁網址。
範例: "cmp_2024_01"
utm_aa_crtv_id
字串
此次造訪的 Appier 廣告內容 ID,取自到達網頁網址。
範例: "1234567"
campaign_source
字串
此次造訪的行銷活動來源,取自 AIRIS 行銷活動追蹤。
範例: "newsletter"
campaign_medium
字串
此次造訪的行銷活動媒介,取自 AIRIS 行銷活動追蹤。
範例: "email"
campaign_name
字串
此次造訪的行銷活動名稱,取自 AIRIS 行銷活動追蹤。
範例: "spring_sale"
campaign_term
字串
此次造訪的行銷活動詞彙,取自 AIRIS 行銷活動追蹤。
範例: "running shoes"
campaign_content
字串
此次造訪的行銷活動內容,取自 AIRIS 行銷活動追蹤。
範例: "banner_a"
campaign_id
字串
此次造訪的行銷活動 ID,取自 AIRIS 行銷活動追蹤。
範例: "wp_1024"
campaign_aa_crtv_id
字串
此次造訪的 Appier 廣告內容 ID,取自 AIRIS 行銷活動追蹤。
範例: "1234567"

ec_account_link

預設計費

使用者連結電商或 CRM 會員帳號時,BotBonnie 會產生此事件。會員的姓名、Email 地址、電話號碼、會員等級等詳細資料也會存入使用者個人檔案。

屬性
類型
說明
ec_account_linked
字串
已連結的電商會員帳號 ID。
範例: "EC-MEMBER-ID-123"

ec_coupon_received

預設計費

使用者收到優惠券時,BotBonnie 會產生此事件。

屬性
類型
說明
coupon_title
字串
優惠券名稱。
範例: "Spring sale coupon"
coupon_code
字串
優惠碼。
範例: "SPRING-1234"
promotion_id
字串
優惠券所屬的促銷活動 ID。
範例: "PROMO-ID-123"
promotion_type
字串
促銷活動類型。
範例: "draw"
user_id
字串
使用者的電商會員帳號 ID。
範例: "member_10023"
expired_date
字串
優惠券到期日。
範例: "Never expires"

ec_credit_received

預設計費

使用者獲得購物金時,BotBonnie 會產生此事件。

屬性
類型
說明
value
整數
獲得的購物金金額。
範例: 100
credit_earned
整數
使用者購物金的變動量。
範例: 100
remaining
整數
變動後的使用者購物金餘額。
範例: 500
reason
字串
變動原因。
範例: "Refund to credit"
expired_date
字串
購物金到期日。
範例: "2026/12/31"
user_id
字串
使用者的電商會員帳號 ID。
範例: "member_10023"

ec_credit_used

預設計費

使用者使用購物金時,BotBonnie 會產生此事件。

屬性
類型
說明
value
整數
使用的購物金金額。
範例: 79
credit_earned
整數
使用者購物金的變動量。使用購物金時為負數。
範例: -79
remaining
整數
變動後的使用者購物金餘額。
範例: 421
reason
字串
變動原因。
範例: "Order payment"
expired_date
字串
購物金到期日。
範例: "Never expires"
user_id
字串
使用者的電商會員帳號 ID。
範例: "member_10023"

ec_membership_tier_updated

預設計費

使用者的會員等級變更時,BotBonnie 會產生此事件。新等級的 ID、名稱與到期日會存入 ec_membership_tier 使用者屬性。

沒有事件專屬屬性。

ec_order_placed

預設計費

使用者下單時,BotBonnie 會產生此事件。

屬性
類型
說明
order_id
字串
訂單 ID。
範例: "ORD-20240930-001"
order_number
字串
顯示給使用者的訂單編號。
範例: "20260210023946626"
order_payment
字串
訂單總額,含幣別。
範例: "1599 TWD"
amount
數字
訂單總額。
範例: 1599
currency
字串
訂單幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
payment_type
字串
付款方式。
範例: "Credit card"
delivery
字串
送貨方式。
範例: "Home delivery"
purchased_products
物件陣列
訂單中的商品,每項商品含 ID(product_id)與數量(quantity)。
範例: [{"product_id": "SKU-10023", "quantity": 1}]
user_id
字串
使用者的電商會員帳號 ID。
範例: "member_10023"

ec_order_refunded

預設計費

訂單退款時,BotBonnie 會產生此事件。

屬性
類型
說明
order_id
字串
訂單 ID。
範例: "ORD-20240930-001"
order_number
字串
顯示給使用者的訂單編號。
範例: "20260210023946626"
refund_amount
字串
退款金額,含幣別。
範例: "1599 TWD"
amount
數字
退款金額。
範例: 1599
currency
字串
退款幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
payment_type
字串
付款方式。
範例: "Credit card"
cancel_reason
字串
訂單取消原因。
範例: "Changed my mind"

ec_order_status_changed

預設計費

訂單狀態變更時,BotBonnie 會產生此事件。

屬性
類型
說明
order_id
字串
訂單 ID。
範例: "ORD-20240930-001"
current_status
字串
訂單的新狀態。
範例: "confirmed"
status_changed_at
字串
狀態變更的時間,格式為 ISO 8601。
範例: "2026-02-10T05:49:20.645Z"

ec_point_received

預設計費

使用者獲得點數時,BotBonnie 會產生此事件。

屬性
類型
說明
value
整數
獲得的點數。
範例: 150
point_earned
整數
使用者點數的變動量。
範例: 150
remaining
整數
變動後的使用者點數餘額。
範例: 1200
reason
字串
變動原因。
範例: "Purchase reward"
expired_date
字串
點數到期日。
範例: "2027/09/16"
user_id
字串
使用者的電商會員帳號 ID。
範例: "member_10023"

ec_point_used

預設計費

使用者使用點數時,BotBonnie 會產生此事件。

屬性
類型
說明
value
整數
使用的點數。
範例: 150
point_earned
整數
使用者點數的變動量。使用點數時為負數。
範例: -150
remaining
整數
變動後的使用者點數餘額。
範例: 1050
reason
字串
變動原因。
範例: "Order discount"
expired_date
字串
點數到期日。
範例: "Never expires"
user_id
字串
使用者的電商會員帳號 ID。
範例: "member_10023"

ec_shipment_updated

預設計費

訂單出貨或送達時,BotBonnie 會產生此事件。

屬性
類型
說明
status
字串
貨運狀態:「shipped」或「delivered」。
範例: "shipped"
order_id
字串
訂單 ID。
範例: "ORD-20240930-001"
order_number
字串
顯示給使用者的訂單編號。
範例: "20260210023946626"
order_payment
字串
訂單總額,含幣別。
範例: "1599 TWD"
payment_type
字串
付款方式。
範例: "Credit card"
delivery
字串
送貨方式。
範例: "Home delivery"
tracking_number
字串
貨運追蹤編號。
範例: "TRACK-123456"
delivery_date
字串
訂單送達日期。status 為「delivered」時才會傳送。
範例: "2026/02/10"

first_app_launched

預設計費

安裝 SDK 後第一次啟動 App 時記錄此事件,只會記錄一次。

沒有事件專屬屬性。

follow

預設計費

使用者追蹤官方帳號時,BotBonnie 會產生此事件。

沒有事件專屬屬性。

geofence_enter

預設

裝置進入 Appier 地理柵欄(設定好的位置區域)時記錄此事件。帳號已啟用地理柵欄功能時才會記錄。

屬性
類型
說明
geofence_id
字串
地理柵欄 ID。
範例: "1024"
geofence_name
字串
地理柵欄名稱。
範例: "Taipei Main Station"
geofence_latitude
浮點數
地理柵欄中心的緯度。
範例: 25.0478
geofence_longitude
浮點數
地理柵欄中心的經度。
範例: 121.5170
geofence_radius
浮點數
地理柵欄的半徑,單位為公尺。
範例: 200
geofence_config
字串
地理柵欄設定,格式為 id|latitude|longitude|radius。
範例: "1024|25.0478|121.5170|200"
latitude
浮點數
進出地理柵欄時裝置的緯度。
範例: 25.0480
longitude
浮點數
進出地理柵欄時裝置的經度。
範例: 121.5172
altitude
浮點數
裝置的海拔高度,有資料時才會提供。
範例: 12.5
accuracy
浮點數
裝置位置的水平精確度,單位為公尺,有資料時才會提供。
範例: 15.0
speed
浮點數
裝置的速度,有資料時才會提供。
範例: 0.0
provider
字串
回報位置的定位提供者(Android)。
範例: "fused"
timestamp
整數
進出地理柵欄的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

geofence_exit

預設

裝置離開 Appier 地理柵欄時記錄此事件。帳號已啟用地理柵欄功能時才會記錄。

屬性
類型
說明
geofence_id
字串
地理柵欄 ID。
範例: "1024"
geofence_name
字串
地理柵欄名稱。
範例: "Taipei Main Station"
geofence_latitude
浮點數
地理柵欄中心的緯度。
範例: 25.0478
geofence_longitude
浮點數
地理柵欄中心的經度。
範例: 121.5170
geofence_radius
浮點數
地理柵欄的半徑,單位為公尺。
範例: 200
geofence_config
字串
地理柵欄設定,格式為 id|latitude|longitude|radius。
範例: "1024|25.0478|121.5170|200"
latitude
浮點數
進出地理柵欄時裝置的緯度。
範例: 25.0480
longitude
浮點數
進出地理柵欄時裝置的經度。
範例: 121.5172
altitude
浮點數
裝置的海拔高度,有資料時才會提供。
範例: 12.5
accuracy
浮點數
裝置位置的水平精確度,單位為公尺,有資料時才會提供。
範例: 15.0
speed
浮點數
裝置的速度,有資料時才會提供。
範例: 0.0
provider
字串
回報位置的定位提供者(Android)。
範例: "fused"
timestamp
整數
進出地理柵欄的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

geofence_register_failed

預設

SDK 註冊要監測的地理柵欄失敗時記錄此事件。帳號已啟用地理柵欄功能時才會記錄。

屬性
類型
說明
geofence_id
字串
地理柵欄 ID。
範例: "1024"
geofence_name
字串
地理柵欄名稱。
範例: "Taipei Main Station"
error
字串
說明註冊失敗原因的錯誤訊息。
範例: "Geofence service is not available now"
geofence_latitude
浮點數
地理柵欄中心的緯度(iOS)。
範例: 25.0478
geofence_longitude
浮點數
地理柵欄中心的經度(iOS)。
範例: 121.5170
geofence_radius
浮點數
地理柵欄的半徑,單位為公尺(iOS)。
範例: 200
geofence_config
字串
地理柵欄設定,格式為 id|latitude|longitude|radius(iOS)。
範例: "1024|25.0478|121.5170|200"
timestamp
整數
失敗發生的時間(iOS),格式為 Unix 時間戳記(秒)。
範例: 1727671200

geofence_updated

預設

SDK 在裝置上完成註冊或更新要監測的地理柵欄時記錄此事件。帳號已啟用地理柵欄功能時才會記錄。

沒有事件專屬屬性。

incognito_browsing

預設

SDK 偵測到使用者以私密視窗或無痕視窗瀏覽時記錄此事件。

沒有事件專屬屬性。

interest_tagging

預設

AIRIS 幫使用者加上興趣關鍵字標籤時,會產生此事件。AIRIS 也會加上 AIRIS 系統事件屬性。

屬性
類型
說明
keyword
字串
使用者被標記的興趣關鍵字。
範例: "skincare"

journey_map_entry

預設計費

使用者進入旅程圖時記錄此事件。

屬性
類型
說明
timestamp
整數
進出旅程圖的時間,格式為 Unix 時間戳記(毫秒)。
範例: 1727671200000
journey_map_id
字串
旅程圖 ID,格式為 journeymap-<id>。
範例: "journeymap-1234"
journey_node_id
字串
使用者進入的第一個節點 ID。
範例: "node-5"
journey_map_version
字串
使用者所在的旅程圖版本。版本不明時為空。
範例: "3"

journey_map_exit

預設

使用者離開旅程圖時記錄此事件,並附上離開時所在的節點;如果適用,也會附上離開該節點的路徑。

屬性
類型
說明
timestamp
整數
進出旅程圖的時間,格式為 Unix 時間戳記(毫秒)。
範例: 1727671200000
journey_map_id
字串
旅程圖 ID,格式為 journeymap-<id>。
範例: "journeymap-1234"
journey_node_id
字串
使用者離開時所在的節點 ID。
範例: "node-5"
journey_map_version
字串
使用者所在的旅程圖版本。版本不明時為空。
範例: "3"
journey_map_split_path_type
字串
使用者離開節點時所走的路徑類型。
範例: "clicked"
journey_map_split_path_id
字串
使用者離開節點時所走的路徑 ID,路徑有 ID 時才會提供。
範例: "path-2"

lead_initiated

系統定義計費

使用者首次與潛在顧客表單或諮詢表單有實質互動時,請記錄此事件。請勿在頁面載入時記錄。只適用於網站。

屬性
類型
說明
form_id
字串
表單的唯一 ID。
範例: "CONSULTATION-FORM"
form_name
字串
表單的顯示名稱。
範例: "Book a Consultation"
service_id
字串
此次詢問所針對的服務或方案 ID。
範例: "SERVICE-123"
service_name
字串
此次詢問所針對的服務或方案名稱。
範例: "Financial Planning Consultation"
事件記錄範例
appier('event', 'lead_initiated', {
  form_id: 'CONSULTATION-FORM',
  form_name: 'Book a Consultation',
  service_id: 'SERVICE-123',
  service_name: 'Financial Planning Consultation'
});

lead_submitted

系統定義計費

網站確認潛在顧客資料或詢問已提交時,請記錄此事件。請將此事件作為主要的潛在顧客轉換。只適用於網站。

屬性
類型
說明
lead_id
字串
提交的潛在顧客唯一 ID。
範例: "LEAD-123"
form_id
字串
表單的唯一 ID。
範例: "CONSULTATION-FORM"
form_name
字串
表單的顯示名稱。
範例: "Book a Consultation"
service_id
字串
此次詢問所針對的服務或方案 ID。
範例: "SERVICE-123"
service_name
字串
此次詢問所針對的服務或方案名稱。
範例: "Financial Planning Consultation"
lead_source
字串
潛在顧客的來源,由您自行定義。
範例: "website_consultation_form"
user_id
字串
由您指派的使用者 ID。有此資料且獲得允許時,請一併傳送,協助 Appier 辨認使用者。
範例: "member_10023"
email
字串
使用者的 Email 地址。有此資料且獲得允許時,請一併傳送,協助 Appier 辨認使用者。
範例: "[email protected]"
phone_no
字串
使用者的電話號碼,含國碼。有此資料且獲得允許時,請一併傳送,協助 Appier 辨認使用者。
範例: "+886912345678"
事件記錄範例
appier('event', 'lead_submitted', {
  lead_id: 'LEAD-123',
  form_id: 'CONSULTATION-FORM',
  form_name: 'Book a Consultation',
  service_id: 'SERVICE-123',
  service_name: 'Financial Planning Consultation',
  lead_source: 'website_consultation_form',
  user_id: 'member_10023',
  email: '[email protected]',
  phone_no: '+886912345678'
});

login

系統定義計費

網站或 App 確認使用者登入成功後,請記錄此事件;請勿在登入頁面載入或使用者點擊登入按鈕時記錄。

沒有事件專屬屬性。
事件記錄範例
// 在網站本身的登入流程成功後呼叫。
// 將 user_id 存入使用者個人檔案,再傳送 login 事件。
appier('login', 'user_id', 'member_10023');
QGSdk.getSharedInstance().logEvent("login")
QG.getInstance(context).logEvent("login")

mobile_screen_viewed

系統定義計費

App 顯示畫面時,請呼叫 AiDeal 的 startLogging 方法並傳入畫面的頁面類型,以記錄此事件。SDK 會以您傳入的頁面類型記錄此事件。

屬性
類型
說明
screen_types
字串陣列
畫面的頁面類型:「top」、「search」、「detail_search」、「category」、「item_group」、「item」、「registration_form」、「registration」、「login」、「mypage」、「cart」、「cart_form」、「conversion」或自訂頁面類型。
範例: ["item"]
事件記錄範例
// 在該畫面的 view controller 中
let attributes = AIDPageAttributes.Builder()
    .pageType(.item)
    .build()
AppierSDK.AiDeal.startLogging(self, attributes: attributes)
// 在該畫面的 Activity 中
val attributes = Attributes.Builder()
    .pageType(PageType.ITEM)
    .build()
Appier.AiDeal.startLogging(this, attributes)

notification_browsed

預設

使用者點擊下一張/上一張或滑動,瀏覽輪播或滑塊推播中的卡片時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

notification_clicked

預設計費計入 MAU

使用者點擊行銷活動訊息、點擊 App 或網頁推播通知、開啟 Email 中的追蹤連結,或從 LINE 或 ATM 行銷活動連結進入網站或 App 時記錄此事件。App 內、網頁內與多媒體簡訊行銷活動不會記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
actionid
字串
App 推播(Android):使用者點擊的動作按鈕 ID,或被點擊的輪播或滑塊卡片位置(標頭為 100)。
範例: "btn_view"
qgtag
字串
App 推播(Android):被點擊的輪播或滑塊卡片的標籤。
範例: "item_2"
product_line
字串
來自 ATM 行銷活動連結的網頁點擊:傳送連結的行銷活動所屬的產品線。
範例: "aiqua"
ts
整數
Email 連結點擊:點擊的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
url
字串
Email 連結點擊:使用者點擊的原始連結。

notification_delivered

預設

發送供應商回報行銷活動訊息已送達使用者時記錄此事件。適用於簡訊、多媒體簡訊、Kakao、Email 與 LINE。LINE 訊息在送出後即會記錄。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
ts
整數
回報送達的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
msgid
字串
供應商送達報告中的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
vender
字串
簡訊與多媒體簡訊的送達回報供應商:mitake(簡訊)或 mmsmitake(多媒體簡訊)。
範例: "mitake"
vendor
字串
Kakao 的送達回報供應商:kakaoinfobip。Kakao 送達報告使用這個鍵,而非 vender。
範例: "kakaoinfobip"
msgcount
整數
訊息使用的簡訊額度數量,取自 Vonage 送達報告。
範例: 1
ip
字串
Sendgrid Email:Sendgrid 送達 webhook 回報的 IP 位址。
範例: "167.89.0.10"

notification_displayed

預設

推播通知顯示在裝置上時記錄此事件。在 iOS 上由 Notification Service Extension 記錄。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

notification_error

預設

透過 ESS Sender 傳送的行銷活動訊息未能送達使用者時記錄此事件,目前適用於 Kakao Moment 行銷活動。此事件不含錯誤詳細資訊。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
ts
整數
回報失敗的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

notification_received

預設

行銷活動訊息送達使用者時記錄此事件:App 或網頁推播抵達裝置,或 Email 服務供應商回報 Email 已寄出或已送達。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
device_time
整數
推播抵達裝置的時間(Android),格式為 Unix 時間戳記(秒)。
範例: 1727671200
in_blackout_window
字串
推播是否在使用者休息時間內抵達(Android):「true」、「false」、「unspecified」或「invalid」。
範例: "false"
expired
字串
推播抵達時是否已過期(Android):「true」、「false」、「unspecified」或「invalid」。
範例: "false"
msgid
字串
Email 服務供應商提供的訊息 ID。只適用於 Email。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
Email 服務供應商回報 Email 的時間,格式為 Unix 時間戳記(秒)。只適用於 Email。
範例: 1727671200

notification_sent

預設計入 MAU

發送供應商受理要傳送給使用者的行銷活動訊息時記錄此事件。適用於 App 推播(FCM、APNs)、網頁推播、簡訊、多媒體簡訊、Kakao、Email 與 LINE。App 內與網頁內行銷活動不會記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
ts
整數
供應商受理訊息的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200
vender
字串
傳送通路或供應商:web、fcm、apns、mitake(簡訊)、mmsmitake(多媒體簡訊)或 kakaoinfobip。會與 vendortrackid 一起傳送。
範例: "fcm"
vendortrackid
字串
供應商回傳的訊息 ID。供應商有回傳時才會傳送。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
msgcount
整數
訊息使用的額度數量:簡訊則數或多媒體簡訊額度。只會針對簡訊與多媒體簡訊傳送。
範例: 1

notification_targeted

預設

使用者被選為 A/B 實驗行銷活動的接收者時記錄此事件,包括不會收到訊息的控制組使用者。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
ts
整數
使用者被選為目標對象的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

outgoing

預設計費

使用者點擊網站上連往其他網站的連結時,AIRIS 會產生此事件。外部連結追蹤預設為開啟。AIRIS 也會加上 AIRIS 系統事件屬性。

屬性
類型
說明
url
字串
使用者點擊的外部連結網址。

page_viewed

預設計費計入 MAU

網站每次載入頁面時記錄此事件,並附上頁面網址、參照網址,以及網址中的所有 UTM 參數。

屬性
類型
說明
url
字串
瀏覽頁面的完整網址。
referrer
字串
使用者來源頁面的網址(document.referrer)。瀏覽器有提供時才會傳送。
qg_seg
字串
頁面網址中 qg_seg 查詢參數的值。參數存在時才會傳送。
範例: "vip"
utm_source
字串
瀏覽頁面網址中的 UTM 來源。
範例: "newsletter"
utm_medium
字串
瀏覽頁面網址中的 UTM 媒介。
範例: "email"
utm_campaign
字串
瀏覽頁面網址中的 UTM 行銷活動名稱。
範例: "spring_sale"
utm_term
字串
瀏覽頁面網址中的 UTM 詞彙(付費搜尋關鍵字)。
範例: "running shoes"
utm_content
字串
瀏覽頁面網址中的 UTM 內容,用來區分同一個行銷活動中的不同廣告或連結。
範例: "banner_a"
utm_id
字串
瀏覽頁面網址中的 UTM 行銷活動 ID。
範例: "cmp_2024_01"
utm_aa_crtv_id
字串
瀏覽頁面網址中的 Appier 廣告內容 ID(utm_aa_crtv_id)。
範例: "1234567"
事件記錄範例
// 僅限單頁應用程式(SPA):其他網站由 SDK 自動記錄 page_viewed。
// 每次頁面網址變更時,請手動記錄此事件。
appier('event', 'page_viewed', { url: window.location.href });

payment_info_added

系統定義計費

使用者在帳號中新增信用卡、PayPal 帳號等付款資訊時,請記錄此事件。

屬性
類型
說明
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
事件記錄範例
appier('event', 'payment_info_added', {
  user_id: 'member_10023'
});
var properties: [String: Any] = [:]
properties["user_id"] = "member_10023"
QGSdk.getSharedInstance().logEvent("payment_info_added",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("user_id", "member_10023")
    QG.getInstance(context).logEvent("payment_info_added", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

prediction_score_update

預設

AiDeal 更新使用者的轉換、價格敏感度、提升等預測分數時記錄此事件。此事件可作為旅程圖的條件。

屬性
類型
說明
conversion_score
浮點數
預測使用者轉換的可能性。
範例: 0.82
price_sensitivity_score
浮點數
預測使用者對價格的敏感度。
範例: 0.35
uplift_score
浮點數
預測以行銷活動鎖定使用者後可帶來的提升幅度。
範例: 0.12

product_added_to_cart

系統定義計費

使用者將商品加入購物車時,請記錄此事件。每項商品記錄一個事件。

屬性
類型
說明
product_id
字串
與此事件相關的商品 ID。
範例: "SKU-10023"
product_price
浮點數
商品價格。
範例: 799.99
product_name
字串
商品名稱。
範例: "Running Shoes X1"
product_image_url
字串
商品圖片網址。
product_url
字串
商品頁面網址。
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
product_category
字串
商品類別。商品有多個類別時,以逗號分隔列出。
範例: "Shoes,Running"
currency
字串
此事件中價格使用的幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
事件記錄範例
appier('event', 'product_added_to_cart', {
  product_id: 'SKU-10023',
  product_price: 799.99,
  product_name: 'Running Shoes X1',
  product_image_url: 'https://cdn.example.com/img/sku-10023.jpg',
  product_url: 'https://www.example.com/products/sku-10023',
  user_id: 'member_10023',
  product_category: 'Shoes,Running',
  currency: 'TWD'
});
var properties: [String: Any] = [:]
properties["product_id"] = "SKU-10023"
properties["product_price"] = 799.99
properties["product_name"] = "Running Shoes X1"
properties["product_image_url"] = "https://cdn.example.com/img/sku-10023.jpg"
properties["product_url"] = "https://www.example.com/products/sku-10023"
properties["user_id"] = "member_10023"
properties["product_category"] = "Shoes,Running"
properties["currency"] = "TWD"
QGSdk.getSharedInstance().logEvent("product_added_to_cart",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("product_id", "SKU-10023")
    properties.put("product_price", 799.99)
    properties.put("product_name", "Running Shoes X1")
    properties.put("product_image_url", "https://cdn.example.com/img/sku-10023.jpg")
    properties.put("product_url", "https://www.example.com/products/sku-10023")
    properties.put("user_id", "member_10023")
    properties.put("product_category", "Shoes,Running")
    properties.put("currency", "TWD")
    QG.getInstance(context).logEvent("product_added_to_cart", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

product_added_to_wishlist

系統定義計費

使用者將商品加入願望清單或我的最愛時,請記錄此事件。

屬性
類型
說明
product_id
字串
與此事件相關的商品 ID。
範例: "SKU-10023"
product_price
浮點數
商品價格。
範例: 799.99
product_name
字串
商品名稱。
範例: "Running Shoes X1"
product_image_url
字串
商品圖片網址。
product_url
字串
商品頁面網址。
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
product_category
字串
商品類別。商品有多個類別時,以逗號分隔列出。
範例: "Shoes,Running"
事件記錄範例
appier('event', 'product_added_to_wishlist', {
  product_id: 'SKU-10023',
  product_price: 799.99,
  product_name: 'Running Shoes X1',
  product_image_url: 'https://cdn.example.com/img/sku-10023.jpg',
  product_url: 'https://www.example.com/products/sku-10023',
  user_id: 'member_10023',
  product_category: 'Shoes,Running'
});
var properties: [String: Any] = [:]
properties["product_id"] = "SKU-10023"
properties["product_price"] = 799.99
properties["product_name"] = "Running Shoes X1"
properties["product_image_url"] = "https://cdn.example.com/img/sku-10023.jpg"
properties["product_url"] = "https://www.example.com/products/sku-10023"
properties["user_id"] = "member_10023"
properties["product_category"] = "Shoes,Running"
QGSdk.getSharedInstance().logEvent("product_added_to_wishlist",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("product_id", "SKU-10023")
    properties.put("product_price", 799.99)
    properties.put("product_name", "Running Shoes X1")
    properties.put("product_image_url", "https://cdn.example.com/img/sku-10023.jpg")
    properties.put("product_url", "https://www.example.com/products/sku-10023")
    properties.put("user_id", "member_10023")
    properties.put("product_category", "Shoes,Running")
    QG.getInstance(context).logEvent("product_added_to_wishlist", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

product_purchased

系統定義計費

已完成訂單中的每項商品各記錄一次此事件,並針對訂單記錄一個 checkout_completed 事件。記錄時請帶入商品的價值作為 valueToSum。一筆訂單可能產生多個這類事件,因此請勿將此事件作為主要的訂單轉換事件,請改用 checkout_completed。

屬性
類型
說明
order_id必填
字串
訂單的唯一 ID。
範例: "ORD-20240930-001"
product_id必填
字串
與此事件相關的商品 ID。
範例: "SKU-10023"
product_price
浮點數
商品價格。
範例: 799.99
product_name
字串
商品名稱。
範例: "Running Shoes X1"
product_image_url
字串
商品圖片網址。
product_url
字串
商品頁面網址。
product_category
字串
商品類別。商品有多個類別時,以逗號分隔列出。
範例: "Shoes,Running"
product_quantity
浮點數
商品數量。
範例: 2
total_price
浮點數
此筆商品或整筆訂單的總價(價格 × 數量)。
範例: 1599.98
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
currency
字串
此事件中價格使用的幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
事件記錄範例
appier('event', 'product_purchased', {
  order_id: 'ORD-20240930-001',
  product_id: 'SKU-10023',
  product_price: 799.99,
  product_name: 'Running Shoes X1',
  product_image_url: 'https://cdn.example.com/img/sku-10023.jpg',
  product_url: 'https://www.example.com/products/sku-10023',
  product_category: 'Shoes,Running',
  product_quantity: 2,
  total_price: 1599.98,
  user_id: 'member_10023',
  currency: 'TWD'
}, 1599.98);
var properties: [String: Any] = [:]
properties["order_id"] = "ORD-20240930-001"
properties["product_id"] = "SKU-10023"
properties["product_price"] = 799.99
properties["product_name"] = "Running Shoes X1"
properties["product_image_url"] = "https://cdn.example.com/img/sku-10023.jpg"
properties["product_url"] = "https://www.example.com/products/sku-10023"
properties["product_category"] = "Shoes,Running"
properties["product_quantity"] = 2.0
properties["total_price"] = 1599.98
properties["user_id"] = "member_10023"
properties["currency"] = "TWD"
QGSdk.getSharedInstance().logEvent("product_purchased",
                                   withParameters: properties,
                                   withValueToSum: 1599.98)
try {
    val properties = JSONObject()
    properties.put("order_id", "ORD-20240930-001")
    properties.put("product_id", "SKU-10023")
    properties.put("product_price", 799.99)
    properties.put("product_name", "Running Shoes X1")
    properties.put("product_image_url", "https://cdn.example.com/img/sku-10023.jpg")
    properties.put("product_url", "https://www.example.com/products/sku-10023")
    properties.put("product_category", "Shoes,Running")
    properties.put("product_quantity", 2.0)
    properties.put("total_price", 1599.98)
    properties.put("user_id", "member_10023")
    properties.put("currency", "TWD")
    QG.getInstance(context).logEvent("product_purchased", properties, 1599.98)
} catch (e: JSONException) {
    // 處理例外狀況
}

product_removed_from_cart

系統定義計費

使用者將商品移出購物車時,請記錄此事件。每項商品記錄一個事件。

屬性
類型
說明
product_id
字串
與此事件相關的商品 ID。
範例: "SKU-10023"
product_price
浮點數
商品價格。
範例: 799.99
product_name
字串
商品名稱。
範例: "Running Shoes X1"
product_image_url
字串
商品圖片網址。
product_url
字串
商品頁面網址。
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
事件記錄範例
appier('event', 'product_removed_from_cart', {
  product_id: 'SKU-10023',
  product_price: 799.99,
  product_name: 'Running Shoes X1',
  product_image_url: 'https://cdn.example.com/img/sku-10023.jpg',
  product_url: 'https://www.example.com/products/sku-10023',
  user_id: 'member_10023'
});
var properties: [String: Any] = [:]
properties["product_id"] = "SKU-10023"
properties["product_price"] = 799.99
properties["product_name"] = "Running Shoes X1"
properties["product_image_url"] = "https://cdn.example.com/img/sku-10023.jpg"
properties["product_url"] = "https://www.example.com/products/sku-10023"
properties["user_id"] = "member_10023"
QGSdk.getSharedInstance().logEvent("product_removed_from_cart",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("product_id", "SKU-10023")
    properties.put("product_price", 799.99)
    properties.put("product_name", "Running Shoes X1")
    properties.put("product_image_url", "https://cdn.example.com/img/sku-10023.jpg")
    properties.put("product_url", "https://www.example.com/products/sku-10023")
    properties.put("user_id", "member_10023")
    QG.getInstance(context).logEvent("product_removed_from_cart", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

product_removed_from_wishlist

系統定義計費

使用者將商品移出願望清單或我的最愛時,請記錄此事件。

屬性
類型
說明
product_id
字串
與此事件相關的商品 ID。
範例: "SKU-10023"
product_price
浮點數
商品價格。
範例: 799.99
product_name
字串
商品名稱。
範例: "Running Shoes X1"
product_image_url
字串
商品圖片網址。
product_url
字串
商品頁面網址。
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
事件記錄範例
appier('event', 'product_removed_from_wishlist', {
  product_id: 'SKU-10023',
  product_price: 799.99,
  product_name: 'Running Shoes X1',
  product_image_url: 'https://cdn.example.com/img/sku-10023.jpg',
  product_url: 'https://www.example.com/products/sku-10023',
  user_id: 'member_10023'
});
var properties: [String: Any] = [:]
properties["product_id"] = "SKU-10023"
properties["product_price"] = 799.99
properties["product_name"] = "Running Shoes X1"
properties["product_image_url"] = "https://cdn.example.com/img/sku-10023.jpg"
properties["product_url"] = "https://www.example.com/products/sku-10023"
properties["user_id"] = "member_10023"
QGSdk.getSharedInstance().logEvent("product_removed_from_wishlist",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("product_id", "SKU-10023")
    properties.put("product_price", 799.99)
    properties.put("product_name", "Running Shoes X1")
    properties.put("product_image_url", "https://cdn.example.com/img/sku-10023.jpg")
    properties.put("product_url", "https://www.example.com/products/sku-10023")
    properties.put("user_id", "member_10023")
    QG.getInstance(context).logEvent("product_removed_from_wishlist", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

product_viewed

系統定義計費

使用者瀏覽商品頁面或商品詳細資訊時,請記錄此事件。在商品頁面上,此事件可取代 page_viewed。

屬性
類型
說明
product_id
字串
與此事件相關的商品 ID。
範例: "SKU-10023"
product_price
浮點數
商品價格。
範例: 799.99
product_name
字串
商品名稱。
範例: "Running Shoes X1"
product_image_url
字串
商品圖片網址。
product_url
字串
商品頁面網址。
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
product_category
字串
商品類別。商品有多個類別時,以逗號分隔列出。
範例: "Shoes,Running"
currency
字串
此事件中價格使用的幣別,以三個字母的 ISO 4217 代碼表示。
範例: "TWD"
事件記錄範例
appier('event', 'product_viewed', {
  product_id: 'SKU-10023',
  product_price: 799.99,
  product_name: 'Running Shoes X1',
  product_image_url: 'https://cdn.example.com/img/sku-10023.jpg',
  product_url: 'https://www.example.com/products/sku-10023',
  user_id: 'member_10023',
  product_category: 'Shoes,Running',
  currency: 'TWD'
});
var properties: [String: Any] = [:]
properties["product_id"] = "SKU-10023"
properties["product_price"] = 799.99
properties["product_name"] = "Running Shoes X1"
properties["product_image_url"] = "https://cdn.example.com/img/sku-10023.jpg"
properties["product_url"] = "https://www.example.com/products/sku-10023"
properties["user_id"] = "member_10023"
properties["product_category"] = "Shoes,Running"
properties["currency"] = "TWD"
QGSdk.getSharedInstance().logEvent("product_viewed",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("product_id", "SKU-10023")
    properties.put("product_price", 799.99)
    properties.put("product_name", "Running Shoes X1")
    properties.put("product_image_url", "https://cdn.example.com/img/sku-10023.jpg")
    properties.put("product_url", "https://www.example.com/products/sku-10023")
    properties.put("user_id", "member_10023")
    properties.put("product_category", "Shoes,Running")
    properties.put("currency", "TWD")
    QG.getInstance(context).logEvent("product_viewed", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

pv

預設

使用者載入網站上的頁面時,AIRIS 會產生此事件。AIRIS 也會加上 AIRIS 系統事件屬性。

屬性
類型
說明
url
字串
載入頁面的完整網址。
uri
字串
載入頁面的路徑。
範例: "/products/123"
domain
字串
網站的網域。
範例: "www.example.com"
title
字串
載入頁面的標題。
範例: "Running Shoes X1 | Example Store"
referrer
字串
使用者來源頁面的網址。
returning
字串
使用者是否曾造訪過網站。
範例: "true"
scroll_depth
浮點數
使用者向下捲動頁面的程度,以占頁面高度的比例表示。
範例: 0.75

qg_carousel_clicked

預設計費

使用者點擊輪播或滑塊推播中的卡片時記錄此事件。被點擊卡片的內容會隨事件一起傳送。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
title
字串
被點擊輪播卡的標題。
範例: "Spring sale starts now"
message
字串
被點擊輪播卡的訊息文字。
範例: "Up to 50% off this weekend"
image
字串
被點擊輪播卡的圖片網址(Android)。
imageurl
字串
被點擊輪播卡的圖片網址(iOS)。
body
字串
被點擊輪播卡的內文(iOS)。
範例: "Up to 50% off this weekend"
deeplink
字串
被點擊輪播卡的深層連結。
範例: "myapp://products/123"

qg_carousel_dismissed

預設計費

使用者透過關閉動作關閉輪播或滑塊推播時記錄此事件。只適用於 iOS。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

qg_email_deferral

預設

Email 行銷活動訊息暫時無法送達、將會重試時記錄此事件。意義與 qg_email_deferred 相同,適用於透過 Mandrill 寄送的 Email。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_deferred

預設

Email 行銷活動訊息暫時無法送達時記錄此事件。Email 服務供應商會持續重試,最長 72 小時。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_group_resubed

預設

使用者重新訂閱先前退出的 Email 訂閱群組時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_group_unsubed

預設

使用者取消訂閱 Email 訂閱群組時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_hard_bounced

預設

Email 行銷活動訊息發生硬退件時記錄此事件,代表因永久性原因無法寄達,例如 Email 地址不存在。使用者個人檔案中的 Email 也會標記為硬退件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_opened

預設計費計入 MAU

使用者開啟 Email 行銷活動訊息時記錄此事件,依據為 Email 服務供應商或 AIQUA 開信追蹤像素的回報。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。由 AIQUA 開信追蹤像素記錄開信時不會傳送。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商或開信追蹤像素收到開信紀錄的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_processed

預設

Email 服務供應商受理 Email 行銷活動訊息並準備寄送時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_rejected

預設

Email 服務供應商拒絕寄送 Email 行銷活動訊息時記錄此事件,原因可能是 Email 地址在供應商的封鎖清單中。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_soft_bounced

預設

Email 行銷活動訊息發生軟退件時記錄此事件,代表因暫時性原因無法寄達,例如信箱已滿。被 Sendgrid 捨棄的 Email 也會記錄為軟退件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_spammed

預設

使用者將 Email 行銷活動訊息標為垃圾訊息時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商收到事件的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_email_unsubed

預設計費

使用者透過 AIQUA 的取消訂閱連結或 Email 服務供應商的取消訂閱功能,取消訂閱 Email 行銷活動時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
msgid
字串
Email 服務供應商提供的訊息 ID。由 Email 服務供應商回報取消訂閱時才會傳送。
範例: "6c1f2a9e-3b7d-4e2a-9f10-5d8c7b6a4e21"
ts
整數
AIQUA 從 Email 服務供應商或 AIQUA 取消訂閱連結收到取消訂閱的時間,格式為 Unix 時間戳記(秒)。
範例: 1727671200

qg_inapp_clicked

預設計費計入 MAU

使用者點擊 App 內訊息中的按鈕或連結,或創意設計模組 App 內訊息中的網址動作時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
actionid
字串
被點擊按鈕的位置,從 1 開始(Android)。
範例: "1"
qgtag
字串
被點擊按鈕的標籤(Android)。
範例: "item_2"
calltoactiontext
字串
創意設計模組 App 內訊息中,被點擊元素的標示文字。
範例: "Shop now"

qg_inapp_closed

預設計費

使用者關閉 App 內訊息,或訊息因本身的動作而關閉時記錄此事件,例如開啟深層連結後自動關閉。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

qg_inapp_displayed

預設計入 MAU

App 內訊息顯示在 App 畫面上時記錄此事件。創意設計模組的 App 內訊息會在內容載入完成後記錄。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
type
字串
App 內訊息類型(Android):「1」(浮動式)、「2」(圖片)、「3」(指定尺寸)、「4」(收件匣)、「5」(HTML)或「6」(創意設計模組)。
範例: "6"

qg_inapp_failed

預設

App 內訊息無法顯示時記錄此事件,原因可能是 payload 無效、圖片或圖示下載失敗,或創意設計模組訊息載入失敗。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
reason
字串
訊息失敗的原因。
範例: "invalid_campaign_image"
msg
字串
錯誤訊息(Android)。
範例: "Failed to download campaign image"
cause
字串
錯誤的根本原因(Android)。
範例: "java.io.FileNotFoundException"
networktype
字串
發生錯誤時裝置的網路類型(Android)。
範例: "wifi"
giosgjsurl
字串
載入失敗的創意設計模組指令碼網址(Android)。

qg_inapp_lead_gen

預設計費

使用者提交創意設計模組 App 內訊息中的表單時記錄此事件。提交時間與行銷活動 ID 也會存入使用者個人檔案。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
leadtype
字串
潛在顧客表單類型:creativeStudio。
範例: "creativeStudio"

qg_inapp_toggled

預設計費

使用者展開或收合浮動式或標記式 App 內訊息時記錄此事件。創意設計模組的 App 內訊息不支援此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
state
字串
訊息的新狀態:open 或 close。
範例: "open"

qg_inweb_clicked

預設計費計入 MAU

使用者點擊網頁內訊息中的行動呼籲時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
calltoactiontext
字串
被點擊的行動呼籲文字。按鈕上有文字的網頁內範本才會傳送此屬性,例如多重動作、固定橫幅與創意設計模組訊息。
範例: "Shop now"

qg_inweb_closed

預設計費

使用者關閉網頁內訊息時記錄此事件。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

qg_inweb_displayed

預設計入 MAU

網頁內訊息顯示給使用者時記錄此事件。網頁內訊息即網站上的彈出式視窗或橫幅。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

qg_inweb_lead_gen

預設計費

使用者提交網頁內潛在顧客開發訊息或創意設計模組訊息中的表單時記錄此事件。提交的欄位與提交詳細資訊也會存入使用者個人檔案。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
leadtype
字串
潛在顧客表單類型:lead(網頁內潛在顧客表單)或 creativeStudio。
範例: "lead"
leadsubmitid
字串
此次表單提交的唯一 ID。只適用於網頁內潛在顧客表單。
範例: "3f2b8c1e-7a4d-4b9e-8c21-0d5e6f7a8b90"
leadkeys
字串陣列
使用者提交的欄位名稱。只適用於網頁內潛在顧客表單。
範例: ["email", "phone"]

qg_line_click

預設計費計入 MAU

使用者從 LINE 行銷活動訊息中的連結開啟網站或 App 時記錄此事件,系統以連結中的 _lnchid 和 _lnuid 參數辨識。同時也會為行銷活動記錄 notification_clicked 事件,並將使用者的 LINE Channel ID 與 LINE UID 存入個人檔案。

屬性
類型
說明
url
字串
使用者從 LINE 訊息開啟的頁面或深層連結完整網址。
utm_source
字串
使用者開啟的連結中的 UTM 來源。
範例: "newsletter"
utm_medium
字串
使用者開啟的連結中的 UTM 媒介。
範例: "email"
utm_campaign
字串
使用者開啟的連結中的 UTM 行銷活動名稱。
範例: "spring_sale"
utm_term
字串
使用者開啟的連結中的 UTM 詞彙。
範例: "running shoes"
utm_content
字串
使用者開啟的連結中的 UTM 內容。
範例: "banner_a"
utm_id
字串
使用者開啟的連結中的 UTM 行銷活動 ID。只適用於 Web SDK。
範例: "cmp_2024_01"
utm_aa_crtv_id
字串
使用者開啟的連結中的 Appier 廣告內容 ID。只適用於 Web SDK。
範例: "1234567"

qg_notification_dismissed

預設

使用者點擊輪播或滑塊推播上的關閉按鈕時記錄此事件。只適用於 Android。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
actionid
整數
關閉動作的位置;未設定時為 100。
範例: 100

qg_rich_push_opened

預設計費

使用者展開多媒體推播通知(輪播或滑塊)以檢視內容時記錄此事件。只適用於 iOS。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"

recommendation_clicked

系統定義計費計入 MAU

使用者在 App 中點擊 Appier 推薦情境推薦的商品時,請呼叫 SDK 的 logRecommendationClicked 方法記錄此事件。在網站上,以及創意設計模組 App 內訊息中的推薦結果,SDK 會自動記錄。不會歸因到行銷活動。

屬性
類型
說明
scenario_id必填
字串
推薦情境 ID。
範例: "SCENARIO-ID-123"
model_id必填
字串
產生推薦結果的推薦模型 ID。
範例: "12345"
recommendation_id必填
字串
此推薦結果的 ID,曝光與點擊事件共用同一個 ID。
範例: "73c01528-8a61-4181-a185-974d8e19286f"
product_id必填
字串
被點擊的商品 ID。
範例: "SKU-10023"
事件記錄範例
QGSdk.getSharedInstance().logRecommendationClicked(withScenarioId: "SCENARIO-ID-123",
                                                   withModelId: "12345",
                                                   withProductId: "SKU-10023",
                                                   withRecommendationId: "73c01528-8a61-4181-a185-974d8e19286f")
QG.getInstance(context).logRecommendationClicked(
    "SCENARIO-ID-123",
    "12345",
    "SKU-10023",
    "73c01528-8a61-4181-a185-974d8e19286f"
)

recommendation_impression

預設計入 MAU

Appier 推薦情境回傳要顯示給使用者的商品,或針對不顯示推薦的實驗組回傳空結果時記錄此事件。不會歸因到行銷活動。

屬性
類型
說明
scenario_id
字串
推薦情境 ID。
範例: "SCENARIO-ID-123"
model_id
字串
產生推薦結果的推薦模型 ID。
範例: "12345"
recommendation_id
字串
此推薦結果的 ID,曝光與點擊事件共用同一個 ID。
範例: "73c01528-8a61-4181-a185-974d8e19286f"

registration_completed

系統定義計費

使用者完成帳號註冊時,請記錄此事件。

屬性
類型
說明
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
事件記錄範例
appier('event', 'registration_completed', {
  user_id: 'member_10023'
});
var properties: [String: Any] = [:]
properties["user_id"] = "member_10023"
QGSdk.getSharedInstance().logEvent("registration_completed",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("user_id", "member_10023")
    QG.getInstance(context).logEvent("registration_completed", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

registration_initiated

系統定義計費

使用者開始註冊帳號時,請記錄此事件。

沒有事件專屬屬性。
事件記錄範例
appier('event', 'registration_initiated');
QGSdk.getSharedInstance().logEvent("registration_initiated")
QG.getInstance(context).logEvent("registration_initiated")

remove_tag

預設計費

使用者的標籤被移除時,BotBonnie 會產生此事件。使用者剩餘的標籤也會存入 bb_tag_ids 與 bb_tag_names 使用者屬性。

屬性
類型
說明
bb_tag_ids
字串陣列
移除的標籤 ID。
範例: ["tag-AbC123xYz"]
bb_tag_names
字串陣列
移除的標籤名稱。
範例: ["VIP"]

searched

系統定義計費

使用者在網站或 App 上搜尋時,請記錄此事件。

屬性
類型
說明
searched_keyword
字串
使用者搜尋的詞彙或關鍵字。
範例: "running shoes"
searched_keywords
字串
使用者搜尋的詞彙或關鍵字,以逗號分隔的字串表示。
範例: "running shoes,socks"
user_id
字串
觸發此事件的使用者 ID。
範例: "member_10023"
事件記錄範例
appier('event', 'searched', {
  searched_keyword: 'running shoes',
  searched_keywords: 'running shoes,socks',
  user_id: 'member_10023'
});
var properties: [String: Any] = [:]
properties["searched_keyword"] = "running shoes"
properties["searched_keywords"] = "running shoes,socks"
properties["user_id"] = "member_10023"
QGSdk.getSharedInstance().logEvent("searched",
                                   withParameters: properties)
try {
    val properties = JSONObject()
    properties.put("searched_keyword", "running shoes")
    properties.put("searched_keywords", "running shoes,socks")
    properties.put("user_id", "member_10023")
    QG.getInstance(context).logEvent("searched", properties)
} catch (e: JSONException) {
    // 處理例外狀況
}

send

預設計費計入 MAU

使用者傳送文字、圖片、貼圖等訊息給聊天機器人時,BotBonnie 會產生此事件。

屬性
類型
說明
type
字串
訊息類型:「text」、「video」、「audio」、「image」、「file」、「location」或「sticker」。
範例: "text"

story_mention

預設計費

使用者在 Instagram 等社群媒體的限時動態中提及您的帳號時,BotBonnie 會產生此事件。

屬性
類型
說明
story
物件
提及您帳號的限時動態,含媒體網址(source)與 ID(id)。
範例: {"source": "https://lookaside.fbsbx.com/ig_messaging_cdn/?asset_id=1234567890", "id": "1234567890"}

subscribed_to_webpush

預設計費

網站的網頁推播通知權限變更為「granted」時記錄此事件,例如使用者在瀏覽器提示視窗中點擊「允許」。Web SDK 會在使用者回應提示視窗時,以及每次載入頁面時檢查權限,因此在瀏覽器設定中所做的變更,會在使用者下次造訪時記錄。

屬性
類型
說明
url
字串
偵測到權限變更的頁面完整網址。
referrer
字串
偵測到權限變更時,使用者來源頁面的網址(document.referrer)。瀏覽器有提供時才會傳送。

unfollow

預設計費

使用者取消追蹤官方帳號時,BotBonnie 會產生此事件。

沒有事件專屬屬性。

unsubscribed_to_webpush

預設計費

網站的網頁推播通知權限變更為「denied」時記錄此事件,例如使用者在瀏覽器提示視窗中點擊「封鎖」,或在瀏覽器設定中封鎖通知。權限重設為預設狀態(再次詢問)時不會記錄。

屬性
類型
說明
url
字串
偵測到權限變更的頁面完整網址。
referrer
字串
偵測到權限變更時,使用者來源頁面的網址(document.referrer)。瀏覽器有提供時才會傳送。

url_click

預設計費計入 MAU

使用者點擊聊天機器人訊息中的連結時,BotBonnie 會產生此事件。

屬性
類型
說明
url
字串
被點擊連結的網址。
value
字串
含此連結的聊天機器人訊息模組 ID。
範例: "module-AbC123xYz"

visited

預設計費

使用者當天第一次載入網站頁面時記錄此事件,每天最多記錄一次。

屬性
類型
說明
url
字串
使用者當天首次造訪時進入的頁面完整網址。
utm_source
字串
使用者進入的頁面網址中的 UTM 來源。
範例: "newsletter"
utm_medium
字串
使用者進入的頁面網址中的 UTM 媒介。
範例: "email"
utm_campaign
字串
使用者進入的頁面網址中的 UTM 行銷活動名稱。
範例: "spring_sale"
utm_term
字串
使用者進入的頁面網址中的 UTM 詞彙(付費搜尋關鍵字)。
範例: "running shoes"
utm_content
字串
使用者進入的頁面網址中的 UTM 內容,用來區分同一個行銷活動中的不同廣告或連結。
範例: "banner_a"
utm_id
字串
使用者進入的頁面網址中的 UTM 行銷活動 ID。
範例: "cmp_2024_01"
utm_aa_crtv_id
字串
使用者進入的頁面網址中的 Appier 廣告內容 ID(utm_aa_crtv_id)。
範例: "1234567"

已停用的事件

這些事件已停止使用。若使用者的 App 或網站仍是舊版 SDK,資料中仍可能出現這些事件,但 Appier 的功能不會用到。

aiq_cs_load_started

預設

創意設計模組 App 內訊息開始載入內容時記錄此事件。只適用於 iOS。

屬性
類型
說明
notificationid
字串
行銷活動通知 ID。
範例: "1900012345"
giosg_interaction_id
字串
正在載入的創意設計模組互動內容 ID。
範例: "6f1c2d3e4b5a"
type
整數
App 內訊息類型;一律為 6(創意設計模組)。
範例: 6

aiq_web_personalization_impression

預設

網頁個人化行銷活動將網站內容替換為個人化內容時記錄此事件。

屬性
類型
說明
campaign_id
字串
網頁個人化行銷活動 ID。
範例: "wp_1024"
url
字串
顯示個人化內容的頁面完整網址。
referrer
字串
使用者來源頁面的網址(document.referrer)。

drip_notification_shown

預設

使用者刪除接續推播行銷活動的上一則通知後,佇列中的接續推播顯示時記錄此事件。只適用於 Android。

沒有事件專屬屬性。

inapp_param_missing

預設

App 內行銷活動的觸發條件設有參數條件,但觸發的事件沒有參數,行銷活動因此無法比對時,記錄此事件。只適用於 Android。

沒有事件專屬屬性。

missing_endpoint

預設

App 呼叫推薦 API,但 App 未設定推薦端點時記錄此事件。只適用於 iOS。

屬性
類型
說明
endpoint
字串
缺少的端點名稱:「recommendation」。
範例: "recommendation"
api
字串
需要此端點的 SDK 方法名稱。
範例: "getRecommendationWithScenarioId:"

qg_exception

預設

Android SDK 發生內部錯誤時記錄此事件,例如通知工作無法啟動、通知音效下載失敗,或行銷活動資源載入失敗。

屬性
類型
說明
msg
字串
錯誤訊息。
範例: "Error in downloading notification sound"
cause
字串
錯誤的根本原因,已知時才會提供。
範例: "coerceIn"
networktype
字串
發生錯誤時裝置的網路類型,或「none」。
範例: "wifi"
filename
字串
回報錯誤的原始檔(由 App 內訊息的拖曳處理程式傳送)。
範例: "DraggableLayout"
density
浮點數
裝置的螢幕密度(由 App 內訊息的拖曳處理程式傳送)。
範例: 2.75

AIRIS 系統事件屬性

AIRIS 會自動將這些屬性加到每個追蹤的事件,因此各事件卡片中不再重複列出。資料型態依 AIRIS 中的顯示名稱列出。

鍵
顯示名稱
資料型態
說明
~d
網域
文字
執行追蹤用程式碼的網域。
~i
造訪時的第一個事件
短布林值
此事件是否為造訪中的第一個事件。
~o
造訪時的最後一個事件
短布林值
此事件是否為造訪中的最後一個事件。
is_first
是第一個事件
短布林值
此事件是否為使用者的第一個事件。
~c
是目前的事件
短布林值
此事件是否為目前這次造訪中的最新事件。
~n
事件名稱
文字
事件的鍵。
~a
事件的顯示名稱
文字
事件的顯示名稱,依資料架構中的定義。
~p
整合設定
文字
用來追蹤事件的程式庫或整合方式。
~q
App
文字
Appier App ID。
~r
平台
文字
追蹤事件的平台,例如「web」、「ios」或「android」。
~s
是 HTTPS
短布林值
事件是否透過 SSL/TLS 安全追蹤。
~z
事件類型
事件類型
事件類型:Active、Passive 或 System。
~u
事件持續時間
持續時間(秒)
事件的持續時間,單位為秒。AIRIS 會自動幫頁面瀏覽事件設定此值。
@time
事件時間戳記
時間戳記(UNIX)
事件發生的時間。
~t
可觸發
短布林值
此事件是否能啟動觸發動作。
campaign_name
行銷活動名稱
文字
特定的商品促銷或策略性行銷活動,取自 utm_campaign。
campaign_source
行銷活動來源
文字
帶來流量的網站,取自 utm_source。
campaign_medium
行銷活動媒介
文字
使用的連結類型,例如每次點擊成本或 Email,取自 utm_medium。
campaign_content
行銷活動內容
文字
使用者進入網站前點擊的內容,取自 utm_content。
campaign_term
行銷活動詞彙
文字
搜尋詞彙,取自 utm_term。
campaign_id
行銷活動 ID
文字
行銷活動 ID,取自 utm_id。

Did this page help you?