使用者資料架構參考
下方資料架構列出了建議在使用者個人檔案中蒐集的屬性。蒐集所有建議的資料，資料才會完整，Appier 功能也能發揮最佳成效。
屬性類型
屬性分為 2 種類型，從類型可以看出屬性由誰定義、屬性值從何而來。
- 預設：Appier 會透過 SDK 自動蒐集這類屬性。不需要自行傳送。例如：
ip、permission、gcm_id。 - 系統定義：鍵與資料型態由 Appier 定義，值則由您提供。鍵與資料型態無法變更，請完全依照此處的定義傳送資料，Appier 功能才能辨識。例如：
first_name、email、phone_no、line_uid。
資料架構屬性
鍵
顯示名稱
資料型態
說明
屬性類型
account_linked綁定的帳號
字串
使用者在您 CRM 系統中的會員編號。只有 BotBonnie 會使用這個屬性。
範例："U1234acbd5678"
系統定義
appier_idAppier ID
整數
Appier 指派給使用者的識別碼。
範例：1234567890123456789
預設
birthday生日
字串
使用者的出生日期。資料型態可以是字串或整數，視您的設定而定。
範例："1990-05-14"
系統定義
city城市
字串
使用者所在的城市。
範例："Taipei"
系統定義
ec_account_linked綁定的電商帳號
字串
使用者在 91APP、SHOPLINE 等電商（EC）平台上的會員編號。只有 BotBonnie 會使用這個屬性。
範例："Y123456"
系統定義
first_name名字
字串
使用者的名字。
範例："Jane"
系統定義
gcm_idGCM ID
字串
使用者的推播通知 token。格式依平台而異：
- Android 和網頁：Firebase 推播服務（FCM）的註冊 token，長度約 150 個字元。
- iOS：Apple 推播通知服務（APNs）的裝置 token，長度為 64 個十六進位字元。
範例："dGCSgbfREPc:APA91bHiidOoq_iB3Vqbqq7OM2XAJKlLQSyYp954VEDMovG4-NxNnSujamBbReKwK_RSqf3OaDo8Ip54_uC9-N5fqXtyYmXQGEMQr3SDKGp27MPbe9D-oXxKz935wE1WM2srElISB--e"
預設
instagram_uidInstagram UID
字串
使用者在 Instagram 管道上的 ID。這是 Meta 的 Instagram 範圍編號（IGSID），為數字組成的字串，依商業帳號分別指派。
系統定義
ipIP
字串
使用者的 IP 位址。
範例："203.0.113.10"
預設
is_incognito是否為無痕模式
布林值
使用者的瀏覽器是否處於無痕模式（私密瀏覽）。
範例：false
預設
kakao_uidKakao UID
字串
使用者在 KakaoTalk 管道上的 ID。
系統定義
last_name姓氏
字串
使用者的姓氏。
範例："Doe"
系統定義
line_uidLINE UID
字串
使用者的 LINE User ID，只適用於已加您 LINE 官方帳號好友的使用者。
系統定義
line_unfollow_timeLINE 解除好友時間
整數
系統偵測到使用者不再是您 LINE 官方帳號好友的日期。系統每天偵測一次，因此這個日期可能比實際解除好友的日期晚一天。如需在受眾條件中使用這個屬性，請聯絡 Appier Support。屬性值為 UNIX 時間戳記，單位為秒。
範例：1727654400
預設
messenger_uidMessenger UID
字串
使用者在 Messenger 管道上的 ID。這是 Facebook 的粉絲專頁範圍編號（PSID），為數字組成的字串。
範例："3067708500516264"
系統定義
permission權限
字串
使用者的網頁推播訂閱狀態：
granted、denied 或 default。
範例："granted"
預設
phone_no電話號碼
字串
使用者的手機號碼，格式為 E.164，用於傳送簡訊。
範例："+886912345678"
系統定義
reason原因
字串
使用者的 Apple 推播通知服務（APNs）token 無效時，這個屬性會設為
badDeviceToken。
範例："badDeviceToken"
預設
user_agent使用者代理
字串
使用者瀏覽器的使用者代理字串。
範例："Mozilla/5.0 (Windows NT 10.0; Win64; x64) ..."
預設
user_iduser_id
字串
使用者在您 CRM 系統中的 ID。
系統定義
viber_uidViber UID
字串
使用者在 Viber 管道上的 ID。
系統定義
webchat_uidWebchat UID
字串
使用者在 WebChat 管道上的 ID。
系統定義
whatsapp_uidWhatsApp UID
字串
使用者在 WhatsApp 管道上的 ID。
系統定義
zalo_uidZalo UID
字串
使用者在 Zalo 管道上的 ID。
系統定義
AIRIS 預設屬性
AIRIS 會自動收集下列預設屬性，不需要另外傳送。
AIRIS 使用者屬性
這些屬性記錄 AIRIS 首次追蹤到使用者時的資訊。
鍵
顯示名稱
資料型態
說明
屬性類型
~d第一個事件的時間戳記
時間戳記（UNIX）
使用者第一個事件發生的時間點。
預設
~a第一個參照連結網址類型
參照連結網址的類型
使用者首次造訪時的參照連結網址類型：直接訪問、搜尋引擎、社群媒體、Email、反向連結、內部訪問或點擊付費式廣告。
預設
~b第一個參照連結網址
文字
使用者首次造訪時的參照連結網址。受到隱私限制，HTTPS 參照連結網址資料有限，因此可能不含路徑和查詢字串。
預設
~f第一個到達頁
文字
使用者首次瀏覽頁面的網址路徑。
預設
~j第一個行銷活動名稱
文字
第一個特定的商品優惠或策略性質的行銷活動，取自
utm_campaign。預設
~k第一個行銷活動來源
文字
首次帶來該使用者流量的網站，取自
utm_source。預設
~m第一個行銷活動的媒介
文字
使用者第一次來訪時經由的連結類型，例如單次點擊收費或 Email，取自
utm_medium。預設
~n第一個行銷活動內容
文字
使用者第一次點擊而進入網站的內容，取自
utm_content。預設
~l第一個行銷活動詞彙
文字
使用者第一次搜尋的詞彙，取自
utm_term。預設
AIRIS 造訪屬性
這些屬性記錄單次造訪的資訊。
鍵
顯示名稱
資料型態
說明
屬性類型
city城市
文字
造訪所在的城市，根據 GeoIP 判斷。
預設
region州／地區
文字
造訪所在的州或地區，根據 GeoIP 判斷。
預設
country國家
國家
造訪所在的國家，根據 GeoIP 判斷。
預設
continent大洲
大洲
造訪所在的大洲，根據 GeoIP 判斷。
預設
timezone時區
文字
造訪所在的時區。
範例：「America/Los_Angeles」
預設
offset時區偏移
文字
造訪所在時區的偏移值。
範例：「+08:00」
預設
device裝置類型
裝置類型
裝置類型：電腦、平板或手機。
預設
ipIP 位址
文字
造訪的 IP 位址。
預設
screen螢幕解析度
文字
裝置的螢幕解析度。
範例：「2560x1440」
預設
language語言
文字
裝置作業系統或網頁瀏覽器中設定的語言偏好。
預設
os作業系統
文字
裝置的作業系統。
預設
browser瀏覽器
文字
造訪時使用的網頁瀏覽器。
預設
time造訪日期／時間
時間戳記（UNIX）
造訪開始的日期和時間。
預設
time造訪的時間
時間戳記（UNIX）
造訪在幾點開始。
預設
time造訪日期
時間戳記（UNIX）
造訪開始的日期。
預設
time造訪週數
時間戳記（UNIX）
造訪在哪一週開始。
預設
time造訪月份
時間戳記（UNIX）
造訪開始的月份。
預設
time造訪年份
時間戳記（UNIX）
造訪開始的年份。
預設
duration造訪後的停留時長
持續時間（秒）
造訪的時長，以秒為單位。
預設
referrertype參照連結網址的類型
參照連結網址的類型
造訪的參照連結網址類型：直接訪問、搜尋引擎、社群媒體、Email、反向連結、內部訪問或點擊付費式廣告。
預設
referrerquery查詢參照連結網址（搜尋請求來源的頁面網址）
文字
搜尋引擎的查詢字詞，或點擊付費式廣告（PPC）的點擊辨識碼（例如
gclid）。受到隱私限制，HTTPS 參照連結網址資料有限，因此可能顯示為 -encrypted-。預設
referrerurl參照連結網址
文字
參照連結的網址。受到隱私限制，HTTPS 參照連結網址資料有限，因此可能不含路徑和查詢字串。
預設
landingpage到達頁
文字
造訪中首次瀏覽頁面的網址路徑。
預設
actions每次造訪時完成的事件總數
數字
該次造訪中的事件數量。
預設
is_first是首次造訪
短布林值
是否為使用者的首次造訪。
預設
Updated about 10 hours ago
Did this page help you?