標準事件

對象： 工程師、技術整合人員

標準事件（general.core 預設集）為每個產品自動啟用 — 無需訂閱。它們涵蓋用戶生命週期、驗證與授權，以及應用生命週期。遊戲特定事件請參閱 iGaming 事件。

每個事件也會攜帶基礎屬性（event、timestamp、identity.client_user_id、context.ip_address）。下方表格只列出每個事件特定的欄位。

互動式瀏覽器

選擇一個事件以查看其欄位及一個可直接傳送的信封。切換「僅必填」，然後複製為 JSON 或 cURL。

用戶生命週期

驗證與授權

應用生命週期

POST/v3/s2s/eventregister 僅必填

欄位	類型	要求	說明
event	String	必填	固定為 `register`，必須是已登記的事件名。
timestamp	Number	必填	UTC 紀元毫秒（13 位）。
identity.client_user_id	String	必填	你系統中用戶的唯一 ID。identity 至少需含 client_user_id / anonymous_id 之一。
identity.click_id	String	建議	用於歸因的廣告點擊 ID。
identity.anonymous_id	String	可選	註冊前的匿名 ID；在 client_user_id 出現前用於 App 生命週期身份縫合。
context.ip_address	String	必填	終端用戶 IP（IPv4 或 IPv6）。
context.user_agent	String	建議	瀏覽器/裝置 user-agent 字串。
context.privacy.email_hash	String	建議	電郵的 SHA-256（先小寫並去空格）。絕不傳明文。 SHA-256
context.privacy.phone_hash	String	建議	E.164 規範化電話號碼的 SHA-256。絕不傳明文。 SHA-256
context.privacy.marketing_consent	Boolean	建議	用戶是否同意營銷。
context.attribution.install_source	String	建議	安裝/獲客來源。
context.phone_country_code	String	建議	E.164 國家區號（如 +55）。
context.consent_timestamp	Number	建議	最近一次授權變更，UTC 毫秒。
context.attribution.utm_source	String	建議	UTM 來源。
context.attribution.utm_medium	String	建議	UTM 媒介。
context.attribution.utm_campaign	String	建議	UTM 活動。
context.attribution.utm_content	String	建議	UTM 內容。
context.attribution.utm_term	String	建議	UTM 關鍵詞。

請求信封

{
  "event": "register",
  "timestamp": 1718280000000,
  "identity": {
    "client_user_id": "user_001",
    "click_id": "RS_clk_998877",
    "anonymous_id": "anon_7f3a"
  },
  "context": {
    "ip_address": "203.0.113.1",
    "user_agent": "Mozilla/5.0 (...)",
    "privacy": {
      "email_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
      "phone_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
      "marketing_consent": true
    },
    "attribution": {
      "install_source": "google_ads",
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_campaign": "summer_promo",
      "utm_content": "banner_a",
      "utm_term": "slots"
    },
    "phone_country_code": "+55",
    "consent_timestamp": 1718280000000
  }
}

用戶生命週期

register

建立一個新的用戶帳戶。

欄位	類型	要求	說明
context.user_agent	String	建議	瀏覽器／裝置 user-agent 字串。
context.privacy.email_hash	String	建議	電郵的 SHA-256（轉小寫並去除前後空白）。絕不使用明文。
context.privacy.phone_hash	String	建議	E.164 正規化電話的 SHA-256。絕不使用明文。
context.privacy.marketing_consent	Boolean	建議	用戶是否同意行銷。
context.attribution.install_source	String	建議	安裝／獲客來源。
context.phone_country_code	String	建議	E.164 國家區號（如 +55）。
context.consent_timestamp	Number	建議	最近一次授權變更，UTC 毫秒。
context.attribution.utm_source	String	建議	UTM 來源。
context.attribution.utm_medium	String	建議	UTM 媒介。
context.attribution.utm_campaign	String	建議	UTM 活動。
context.attribution.utm_content	String	建議	UTM 內容。
context.attribution.utm_term	String	建議	UTM 關鍵詞。

referral_register

帶推薦歸因的註冊 — 攜帶推薦人的用戶 ID。

欄位	類型	要求	說明
context.referral_client_user_id	String	建議	推薦人的 client_user_id（推薦本次註冊的用戶）。

login

用戶認證進入你的平台。

欄位	類型	要求	說明
context.user_agent	String	建議	瀏覽器／裝置 user-agent 字串。

驗證與授權

email_verified

欄位	類型	要求	說明
context.email_hash	String	建議	電郵的 SHA-256。絕不使用明文。
context.verification_method	String	建議	link · otp · magic_link 其中之一。

phone_verified

欄位	類型	要求	說明
context.phone_hash	String	建議	電話的 SHA-256。絕不使用明文。
context.phone_country_code	String	建議	E.164 國家區號（如 +91）。
context.verification_method	String	建議	建議用 sms_otp · voice_call · whatsapp_otp。（call · whatsapp 仍接受但已棄用。）

marketing_consent_updated

每次都傳送全部四個渠道的完整狀態（包括註冊時的預設授權）。

欄位	類型	要求	說明
context.allow_email	Boolean	必填	同意電郵。
context.allow_sms	Boolean	必填	同意 SMS。
context.allow_push	Boolean	必填	同意推送。
context.allow_whatsapp	Boolean	必填	同意 WhatsApp。
context.update_source	String	建議	signup · settings_page · unsubscribe_link · support · admin 其中之一。

應用生命週期

NOTE

應用生命週期事件適用於原生 App / APK 廣告主，通常源自行動 SDK / MMP。對於這些事件，client_user_id（以及 app_install 上的 ip_address）會降級為建議，因為用戶在註冊前可能是匿名的 — 改為使用 identity.anonymous_id。

app_install

App 首次安裝並開啟時觸發一次。

欄位	類型	要求	說明
context.platform	String	必填	ios · android · web 其中之一。
context.app_version	String	建議	安裝時的 App 版本。
context.attribution.install_source	String	建議	媒體來源／渠道（來自 MMP）。
context.device_id	String	建議	裝置識別碼。
context.store	String	建議	安裝商店：app_store · play_store · apk_direct。
context.campaign_id	String	建議	廣告活動 ID（來自 MMP）。
context.is_reattribution	Boolean	建議	重裝／重新歸因為 true。

app_open

App 啟動／進入前景時觸發。

欄位	類型	要求	說明
context.platform	String	必填	ios · android · web 其中之一。
context.app_version	String	建議	App 版本。
context.session_id	String	建議	工作階段識別碼。
context.is_first_open	Boolean	建議	安裝後首次開啟為 true。

app_uninstall

一個強烈的流失訊號（MMP 透過推送 token 過期偵測）。

欄位	類型	要求	說明
context.platform	String	必填	ios · android · web 其中之一。
context.app_version	String	建議	最後安裝的版本。
context.days_since_install	Number	建議	從安裝到卸載的天數。

push_permission_updated

推送可達性／選擇加入訊號。

欄位	類型	要求	說明
context.platform	String	必填	ios · android · web 其中之一。
context.permission_status	String	必填	granted · denied · provisional · revoked 其中之一。
context.push_enabled	Boolean	建議	已授予推送權限為 true。
context.update_source	String	建議	變更觸發來源：system_prompt · settings · onboarding。