封裝用戶端事件

當求職者與實作 Cloud Talent Solution 的應用程式互動時,系統會發出訊息。提供此資訊可改善 Cloud Talent Solution 在用戶群網站上的品質,最佳化服務的執行效果。傳送的事件數量必須與用戶端向服務發出的其他呼叫 (如職缺搜尋) 一致。

JSON 表示法

{
  "eventId": string,
  "eventType": enum(EventType),
  "requestId": string,
  "relatedJobNames": [
    string
  ],
  "eventTimestampMillis": string,
  "details": {
    string: string,
    ...
  }
}
欄位
eventId

string

必填。

用戶端應用程式產生的唯一 ID。這個 eventId 會用來建立不同事件之間的關係。

eventType

enum(EventType)

必填。

事件的類型 (請參閱 EventType)。

requestId

string

必填。

Cloud Talent Solution 搜尋服務產生的唯一識別碼,包含在 search response 標頭中。

relatedJobNames[]

string

必填。

與這個事件相關聯的 job name(s)。舉例來說,如果這是 impression 事件,此欄位就會包含向求職者顯示的所有工作 ID;如果這是 view 事件,則此欄位會包含求職者曾經看過的工作 ID。

eventTimestampMillis

string (int64 format)

必填。

事件的時間戳記,自訓練週期開始,以毫秒數為單位。

details

map (key: string, value: string)

選填。

此事件的其他相關資訊,例如情境、詳細資料和來源。

含有 "key": value 組合清單的物件。例如:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

EventType

歸因於使用者 (如求職者) 行為之事件的列舉。這些列舉會說明在何種情境下應傳送 ClientEvent 訊息。

列舉
EVENT_TYPE_UNSPECIFIED 使用者提供的其他值未指定事件。
APPLICATION_START 與服務互動的求職者或其他實體啟動了程序,或展現申請工作的意圖。
APPLICATION_FINISH 與服務互動的求職者或其他實體提交了工作申請。
APPLICATION_QUICK_SUBMISSION 與服務互動的求職者或其他實體按了一下滑鼠以提交工作申請,但未輸入資訊。如果求職者執行此動作,則僅傳送此事件給服務。請勿一併傳送 EventType.APPLICATION_STARTEventType.APPLICATION_FINISH 事件。
APPLICATION_REDIRECT 與服務互動的求職者或其他實體執行動作執行了申請工作的動作,但是服務將其重新導向至不同網站以完成申請。
APPLICATION_COMPANY_SUBMIT 當公司代表求職者提交申請時,則應使用此事件。此事件專供人力仲介機構嘗試提供職位候選人使用。
VIEW 與服務互動的求職者或其他實體已檢視完整的詳細資料,包括職缺的完整說明。如果只查看顯示為職缺搜尋結果中一部分的職缺片段,則屬於 impression,不適用這個事件。
BOOKMARK 與服務互動的求職者或其他實體將某個職缺加入書籤或儲存職缺,展現對該職缺的興趣。
IMPRESSION 與服務互動的求職者或其他實體在其檢視中顯示職缺,例如使用壓縮或剪輯格式檢視搜尋結果清單。此事件通常與求職者在單一頁面上查看職缺清單有關。
NOTIFICATION 與服務互動的求職者或其他實體收到服務寄出的通知 (如電子郵件提醒或裝置通知),內容包含服務產生的一或多個徵才資訊。
HIRED 聘僱實體 (雇主) 雇用與服務互動的求職者或其他實體。只有透過 Cloud Talent Solution 服務進行之搜尋所啟動的申請雇用求職者時,才會傳送此事件。
SENT_CV 招募人員或人力仲介機構與服務互動並找到合適的職缺公告後,代表求職者提交申請。
INTERVIEW_GRANTED 聘僱實體 (雇主) 授予和服務互動的實體 (例如求職者) 初次面試的機會。只有求職者因為透過 Cloud Talent Solution 服務進行搜尋,或因為 Cloud Talent Solution 服務推薦,而啟動申請並獲得面試機會時,才會傳送此事件。
APPLICATION_START_FROM_START 與服務互動的求職者或其他實體從搜尋結果頁面啟動程序或展現申請工作的意圖,而未檢視該職缺公告的完整詳細資料。如果傳送此事件,則不應傳送 EventType.VIEW 事件。
APPLICATION_REDIRECT_FROM_START 與服務互動的求職者或其他實體在搜尋結果頁面上按一下滑鼠以申請職缺 (未檢視該職缺公告的完整詳細資料),然後將求職者或實體重新導向到不同網站以完成申請。如果求職者執行這個動作,則只會傳送這個事件給服務。請勿一併傳送 EventType.APPLICATION_STARTEventType.APPLICATION_FINISHEventType.VIEW 事件。
VIEW_DIRECT 與服務互動的求職者或其他實體按一下滑鼠,就可以將他們直接導向到用戶端頁面來取得職缺公告的詳細資訊。對於會顯示多個不同來源的徵才資訊職缺匯總器,這個事件最有用。