Skip to main content
首頁博客指南如何將貨件追蹤數據整合至跨境電子商務的 BI 系統

如何將貨件追蹤數據整合至跨境電子商務的 BI 系統

17TRACK

要將跨境電子商務的貨件追蹤數據整合至 BI 系統,請透過 API 或受支援的事件資料流收集追蹤更新,儲存原始記錄,將承運商事件標準化,並將每件貨件連接至訂單數據。然後建立數據倉庫模型,計算配送表現、異常情況及數據新鮮度,再將這些模型提供給儀表板使用。最重要的設計選擇,是將包裹發生了甚麼事,與你的系統何時得知這件事分開處理。

如何將貨件追蹤數據整合至 BI 系統

本指南適用於建立此數據管道的數據工程師、分析團隊及物流營運經理。工程團隊應負責數據擷取及可靠性;營運團隊應定義貨件里程碑及異常規則;分析團隊應負責指標定義。若沒有這些共同定義,即使技術上的整合成功,仍可能產生誤導性的報告。

建立數據管道,而不是儀表板至 API 的直接連接

一個實用的參考架構如下:

追蹤來源 → 數據擷取服務 → 持久化原始儲存 → 轉換及驗證 → 分析數據倉庫 → BI 語義模型 → 儀表板及警報

17TRACK API 全球貨件追蹤方案

透過單一 API 連接全球 3,500 多家承運商,輕鬆、準確及可靠地追蹤包裹。

免費試用 →

品牌化訂單追蹤方案

透過品牌化追蹤及自動通知,提供更佳的客戶體驗並推動更多回購。

免費試用 →

將訂單、履約及客戶服務數據與追蹤管道一併保留,並對它們之間的連接進行控管。追蹤事件可以說明包裹的移動情況,但單靠追蹤事件,不能確定客戶承諾的送貨日期、訂單價值、退款結果或支援歷史。

將儀表板直接連接至追蹤 API 可能適用於小型原型,但會令歷史重建、重試及共用指標定義更難控制。對於週期性的營運報告,應在呈現數據前先將其持久化儲存。

17TRACK 的定位

17TRACK Tracking API 是追蹤數據整合的相關來源選項。請使用其官方 API 文件確認實作所需的整合合約。在根據相關內容進行設計前,請先驗證身份驗證、貨件註冊、可用事件欄位、更新傳送方式、使用限制及錯誤處理。

將追蹤來源與 BI 管道視為獨立層級。不要假設取得追蹤數據就包括原生連接器,可直接連接至數據倉庫或 BI 工具。請測試你計劃使用的實際承運商、運輸服務、目的地市場及帳戶配置。

1. 定義營運問題及報告粒度

從儀表板必須支援的決策開始。調查延誤包裹的物流經理需要貨件層級的異常資料;比較運輸服務的商業分析師需要配送群組及一致的分母。這些是相關但不同的視圖,不應根據一組未經定義的追蹤狀態建立。

  • 配送表現:哪些運輸路線未能達到客戶承諾?
  • 異常管理:哪些現有貨件需要調查?
  • 承運商交接:在運輸階段之間,哪裏會失去可見性?
  • 客戶影響:哪些配送模式與客戶支援聯絡或退款有關?
  • 整合健康狀況:哪些來源提供不完整或過時的數據?

選擇主要報告粒度:通常是一件實體包裹或一件貨件,而不是一張訂單。一張訂單可能包含數件包裹,而替換貨件亦可能與原始貨件並存。應保留這些關係,而不是將每張訂單強行歸入一個追蹤號碼。

另外定義訂單層級的完成條件。例如,只有所有必要的出庫包裹均已送達,訂單才可計為已送達。退貨、已取消包裹及替換貨件需要明確處理,以免扭曲分母。

17RETURNS

簡化退貨及換貨流程,減少 DTC 支援工作量及收入損失。

了解更多 →

2. 匯入事件前先建立貨件識別

不要將追蹤號碼作為唯一的數據庫鍵值。其解讀可能取決於承運商及貨件背景。請建立內部貨件識別碼,並保留所需的外部參照,以便核對記錄。

欄位用途設計考慮因素
shipment_id穩定的內部識別保持其獨立於外部參照的變更。
order_id and fulfillment_id將運輸連接至商業記錄支援拆單及替換貨件。
tracking_number and carrier_reference識別被追蹤的移動保留原始值及任何標準化識別碼。
shipment_leg_id表示一個運輸階段當國際運輸及最後一公里運輸各有獨立參照時使用。
source_system說明記錄來源區分訂單系統值與追蹤來源值。
promised_delivery_at根據承諾衡量表現保留適用的承諾及其修訂歷史。

當一件貨件有多個追蹤參照或運輸段時,建立橋接表。這樣分析師便可追蹤跨境包裹在交接過程中的狀況,而不會將其計算為兩件已送達貨件。

3. 以可重播及核對為前提擷取更新

使用來源所支援的更新機制。如果可以傳送事件,請透過能驗證請求並將已接受的有效負載寫入持久化儲存的服務接收更新。如果必須輪詢,請根據已記錄的限制及業務新鮮度要求安排請求。

對於事件驅動的擷取,只有在有效負載已安全持久化儲存或已放入持久化佇列後,才確認成功接收。保持接收端點輕量化;在下游執行耗費資源的轉換。請遵循來源已記錄的身份驗證及請求驗證機制,不要自行假設簽名格式。

對於輪詢,請儲存擷取檢查點,並在 API 允許的情況下使用重疊的擷取窗口。重疊窗口有助於捕捉延遲更新,但亦需要去重。除非文件明確說明,否則不要假設分頁游標代表永久的歷史檢查點。

  • 保留原始有效負載、接收時間戳記、來源識別碼及擷取執行識別碼。
  • 以受控的退避策略重試暫時性故障,並遵守已記錄的速率限制。
  • 將持續失敗的記錄送入審核佇列,而不是靜默丟棄。
  • 將已追蹤貨件與履約系統核對,以識別遺漏的註冊。
  • 定期檢查現有貨件中追蹤數據已停止更新的貨件。

使寫入操作具備冪等性:再次處理相同更新不應建立額外的邏輯事件。優先使用已記錄的穩定事件識別碼。如果不存在,請使用貨件識別、事件時間、事件代碼、位置及其他相關欄位定義並測試複合指紋。保留原始記錄,以便調查碰撞或修正。

4. 在不失去含義的情況下標準化事件

承運商描述不應直接成為儀表板分類。建立有文件記錄的映射層,將來源事件轉換為較少數量的業務里程碑,同時保留原始描述及代碼。

起始分類可以包括已收到資料、承運商已接收、運輸中、派送中、已送達、嘗試派送、異常及退回運輸。這些是建議的內部分類,並不表示每個追蹤來源都使用相同狀態。

將里程碑狀態與異常屬性分開。一件貨件可以仍然處於運輸中,同時帶有與海關相關的異常。將兩個概念強行放入同一欄位,會難以區分實際進度與營運風險。

明確處理跨境歧義

  • 海關事件:保留所報告的事件含義。不要將每個海關參照都解讀為延誤或已完成清關。
  • 承運商交接:在關係已獲驗證的情況下,將相關參照與同一貨件關聯。新的參照不一定代表新的包裹。
  • 未知事件:將其作為未映射記錄保留並顯示。不要將不熟悉的代碼強行歸入方便的分類。
  • 修正:允許後續資訊修訂已解讀的狀態,但不要刪除較早的證據。

為映射規則建立版本。當解讀方式改變時,應能說明歷史圖表的變化是因為配送表現改變,還是因為轉換邏輯改變。

5. 分開建立事件時間、擷取時間及本地日期模型

至少儲存報告的事件時間戳記,以及平台接收記錄的時間戳記。數據倉庫載入時間戳記對診斷內部處理延誤亦很有用。這些時間戳記回答的是不同問題。

在可用的情況下,使用能識別時區偏移的交換格式。RFC 3339 定義了包含 UTC 或數字偏移量的時間戳記格式。保留原始值,將明確的時間點標準化為 UTC 以計算經過時間,並使用明確的時區規則推導本地報告日期。

如果來源提供沒有偏移量或可靠時區的本地時間戳記,請標示該不確定性。不要靜默地將其視為 UTC。若一個國家適用多個時區,僅作國家層級假設可能並不足夠。

延遲抵達的事件同樣需要小心處理。今天收到的較舊事件不應自動取代較新的貨件狀態。應根據已記錄的事件語義、時間戳記及修正規則推導目前狀態,而不是單純採用最近插入的數據庫資料列。

6. 建立具備清晰指標合約的數據倉庫模型

實用的模型會將事件歷史與貨件摘要分開:

  • 事件事實表:每個邏輯追蹤事件一行,包含來源及標準化屬性。
  • 貨件事實表:每件貨件一行,包含推導出的里程碑及目前狀態。
  • 關係表:訂單、包裹、運輸段及外部參照之間的連結。
  • 維度:承運商、服務、起點、目的地、渠道及其他已批准的報告屬性。

避免將訂單收入直接連接至每個追蹤事件後再求和。這會令訂單價值在事件資料列中重複。應在適當粒度進行彙總,或在語義模型中使用明確受控的關係。

指標建議定義解讀保障
運輸時長送達時間戳記減去第一個符合條件的承運商接收時間戳記報告缺失的接收掃描;不要在未披露的情況下以建立標籤時間代替。
準時配送率在適用承諾前送達的符合條件貨件,除以承諾到期群組中的符合條件貨件定義截止時間、時區、排除項目,以及對逾期未送達包裹的處理方式。
異常發生率具有符合條件異常的獨立貨件數,除以符合條件的貨件群組計算貨件,而不是重複的異常訊息。
追蹤停滯報告時間減去最後一個符合條件的追蹤事件時間停滯是需要調查的訊號,不代表包裹已遺失。
觀察到的更新延遲接收時間減去報告的事件時間將來源延遲與時間戳記不確定性及數據倉庫延遲分開。

使用已送達群組了解已完成的運輸時長,但不要將其視為整體表現。仍在運輸中的慢速貨件不會出現在該計算中。應將已完成配送統計與未完成貨件老化視圖及承諾到期群組配合使用。

比較不同運輸路線時,顯示樣本數、服務級別、目的地及報告期間。貨件組成差異可以解釋表面上的承運商表現差距。儀表板應協助調查該差距,而不是提出沒有依據的因果結論。

7. 發佈營運儀表板前驗證管道

測試情境,而不只是成功的 API 回應。包括正常配送、拆單、替換貨件、承運商交接、重複更新、亂序事件、缺少時區、與海關相關事件、退回運輸及延遲修正。

對每個情境,從原始有效負載追蹤至標準化事件、貨件摘要及最終儀表板。營運團隊應確認顯示的狀態及建議行動符合底層證據。

  • 覆蓋率:將符合條件的已履約貨件與追蹤管道中的貨件進行比較。
  • 完整性:衡量缺少的貨件識別碼、事件時間、承運商參照及配送承諾。
  • 一致性:將不可能或可疑的里程碑順序標記以供審核,而不是自動重寫。
  • 新鮮度:分別監控來源接收、數據倉庫處理及儀表板更新。
  • 可重現性:使用保留的輸入重建報告期間,並確認結果符合預期。

在營運儀表板上顯示數據新鮮度指示器。當兩者都顯示為「沒有最近更新」時,包裹異常與擷取中斷可能看起來相似。使用者需要足夠背景資料來區分兩者。

8. 以責任歸屬、存取控制及實用警報推出

先在包含具代表性跨境複雜性的有限運輸路線上試行整合。待貨件匹配、狀態解讀及指標核對符合已同意的驗收標準後再擴展。只包含簡單配送的試點無法測試模型中較困難的部分。

將分析數據擷取限制於報告目的所需的欄位。限制對追蹤參照及任何個人資料的存取,將憑證放在 BI 報告之外,並建立符合適用義務的保留及刪除程序。

為每個警報指定負責人。過時的擷取資料流應由工程團隊負責;未映射事件應由數據團隊及物流專家負責;逾期包裹應由相關營運流程負責。開始時應設定少量可採取行動的警報,而不是為每次異常掃描都產生通知。

當業務使用者可以將儀表板結果追溯至某件貨件、某個標準化事件及其來源記錄,並了解哪些假設影響了結果時,整合便已準備好擴大使用。

常見問題

我需要即時追蹤數據來進行 BI 報告嗎?

不一定。歷史表現報告可能只需定期更新,而現有異常處理可能需要更新鮮的數據。首先定義所需的回應時間,然後考慮來源更新延遲、數據擷取延遲、數據倉庫處理及儀表板更新。更快的儀表板更新無法產生承運商尚未報告的事件。

追蹤數據可以衡量清關時間嗎?

只有在來源提供能可靠代表你希望衡量的海關階段開始及結束的事件時才可以。兩次掃描之間的間隔不足以證明海關處理時間。若界線不清楚,應將該指標標示為觀察到的區間,而不是已確認的清關時長。

一張訂單有多個追蹤號碼時應如何處理?

將訂單與貨件的關係,與貨件和追蹤參照之間的關係分開建模。數個包裹可能屬於一張訂單,而數個參照可能描述一個包裹旅程中的不同運輸段。分開保留這些關係,可避免重複計算貨件及錯誤的訂單完成報告。

我應使用輪詢還是事件驅動更新?

使用來源支援的機制,並根據新鮮度及可靠性要求作出選擇。事件驅動傳送可以減少重複請求,而輪詢可在可用時支援擷取或核對。無論採用哪種方法,都不能免除去重、重試、監控及從遺漏更新中恢復的需要。

追蹤數據可以解釋退款增加的原因嗎?

將追蹤數據與退款及支援記錄透過適當識別碼及時間窗口連接後,可以支援調查,但單靠追蹤數據不能確立因果關係。在將增幅歸因於配送表現前,請檢查退款原因、產品問題、客戶群組、運輸服務及其他相關因素。

來源