使用資料匯入，就能把手邊的 CSV 或核心系統的顧客資料匯入 Lumo，並與 LINE 好友連結起來。會員編號、購買紀錄、狀態這些外部資訊會變成好友的屬性，因此在受眾發送、自動旅程與代理的分析中都能直接使用。本文說明匯入資料的步驟，以及匯入之後的運作方式。
資料匯入可以做什麼
上傳外部資料，就能新增或更新 LINE 好友的屬性。所有方案都可以使用。
- 從檔案匯入：上傳 CSV、JSON、Excel 檔案，把欄位對應到 Lumo 的屬性
- 與既有好友比對：以電話號碼、電子郵件、會員 ID 這類欄位為鍵，更新已存在的好友資訊
- 留成可重複使用的形式：一次決定好的欄位對應會存成資料集，第二次開始只要換檔案就行
- 自動同步：把外部系統的網址登錄為端點，就能依每小時或每日的排程匯入
匯入的屬性，在好友列表、受眾、自動旅程與代理中都能直接使用。把 LINE 官方帳號的既有好友從 LINE 端匯入的功能另有其他，那部分在好友匯入的文章中說明。
使用這項功能的條件
資料匯入在所有方案都可以使用。開始使用前，請先確認以下兩點。
- 已登入 Lumo
- 已連接 LINE 官方帳號
匯入是以 LINE 官方帳號為單位分開的。若您經營多個帳號，請先選好目標帳號再操作。
開啟資料匯入的畫面
資料匯入從 LINE 官方帳號的 「設定」 畫面中的 「資料匯入」 開啟。
- 從側邊選單的 「帳號」 開啟目標的 LINE 官方帳號
- 開啟 「設定」 畫面，移動到 「資料匯入」 的區塊
- 要新匯入時點擊 「新增資料來源」 ，要查看過去的結果時點擊 「查看儀表板」
區塊中會列出已儲存的資料來源與最近的匯入紀錄。把檔案直接拖放到這個區塊，也能開始匯入。
匯入資料
從 「新增資料來源」 開始，以 6 個步驟進行匯入。流程是決定名稱、交出資料，再把欄位對應到屬性。
設定資料集名稱
為匯入的這批資料取個名稱。 「資料集名稱」 取成像「會員名單」這樣看得出用途的名字，日後要新增或更新資料時就不會猶豫。
選擇資料來源
選擇交出資料的方式。要用手邊的檔案就選 「上傳檔案」 ，要讓系統自動去外部系統取得就選 「連接端點」 。
匯入資料
選擇檔案，或拖放到畫面上。支援的格式與上限如下。
| 項目 | 內容 |
|---|---|
| 支援格式 | CSV、JSON、Excel（.xlsx / .xls） |
| 欄位標題 | 檔案的第一列（JSON 則是鍵）會成為欄位標題 |
| 檔案大小 | 10MB 以內 |
| 資料列數 | 50,000 列以內 |
字元編碼除了 「自動偵測」 之外，還可以選 UTF-8 與 Shift_JIS。若在預覽中發現亂碼，請在這裡切換。超過上限的檔案不會被接受，請分割後再上傳。
資料預覽
用預覽確認讀進來的內容。畫面會顯示整體的列數與最前面幾列。若欄位錯位或出現亂碼，請先檢視檔案或字元編碼再往下走。
對應到屬性
把資料的每個欄位對應到 LINE 好友的屬性。每個欄位可從以下 3 種選擇。
| 動作 | 內容 |
|---|---|
| 略過 | 不匯入該欄位 |
| 對應至屬性 | 把值填進既有的屬性 |
| 建立新屬性 | 決定屬性名稱、類型與鍵，建立新的屬性 |
建立新屬性時，類型會從欄位的值自動推斷。要建立的屬性很多時，可以用 「批次設定標籤」 一次加上前綴或後綴。在這個畫面中，要指定一個欄位作為 唯一鍵 。若一時無法決定對應，可以用 「稍後對應（儲存草稿）」 儲存，之後再從 「對應」 畫面繼續設定。
完成
匯入結束後，結果會以筆數顯示。各項的意思如下。
| 結果 | 意思 |
|---|---|
| 總計 | 匯入的資料列總數 |
| 已配對 | 與既有好友連結上的列 |
| 未配對 | 找不到可連結好友的列 |
| 衝突 | 既有好友在同一個屬性上已有不同的值的列，會保留原有的值 |
| 錯誤 | 無法匯入的列 |
識別鍵的概念
每一列要連到哪位好友，取決於對應到 識別屬性 的欄位。建立電話號碼、電子郵件、外部 ID、LINE User ID 類型的屬性時，請先勾選 「做為識別屬性使用」 。
- 對應到識別屬性的欄位有多個時，會先比對 LINE User ID 的欄位。其餘欄位則依排列順序，以最先一致的那一個為準
- 在識別屬性的欄位上沒有比對成功的列，不會與好友連結，會變成「未配對」
在對應中指定的 唯一鍵 ，則是用來辨識資料列本身的鍵。它會在第二次以後的匯入中找出同一列，判斷這是新的列還是值變了的列。請選擇像會員 ID 那樣只指向那個人的值的欄位。若沒有選唯一鍵，每次重新匯入都會當成新的列處理，也就無法判斷差異。
重新執行已儲存的資料來源
一旦建立好的資料集會留存為已儲存的來源，第二次開始不必再走一次精靈，直接換掉資料即可。
從 「設定」 畫面的 「資料匯入」 中並排的來源，可以進行以下操作。
| 操作 | 內容 |
|---|---|
| 以檔案執行 | 使用已儲存的欄位對應，匯入新的檔案 |
| 立即同步 | 把設定了端點的來源當場匯入 |
| 編輯名稱 | 變更資料集的名稱 |
重新執行時會自動套用已儲存的對應。若出現上次沒有的欄位，精靈會顯示出來，可以當場決定對應。
第二次以後的匯入，變動的內容會以 「待確認」 的形式提案。用 「檢閱變更」 查看變更、新增與未變更的筆數，按下 「全部核准」 就會反映到好友的屬性上。若內容不如預期，可以用 「捨棄」 取消。
連接端點自動同步
只要登錄外部系統的網址，不必每次上傳檔案，也能依排程自動匯入資料。
「連接端點」 要設定的項目如下。
| 項目 | 內容 |
|---|---|
| 端點 URL | 回傳資料的網址。回傳記錄陣列的 JSON，或是 CSV |
| 驗證標頭・驗證值 | 網址端需要驗證時設定（選填） |
| 排程 | 從 「手動（僅立即同步）」「每小時」「每日」 中選擇 |
選了 「每小時」 與 「每日」 的來源，Lumo 會每 10 分鐘確認一次執行的時機並自動匯入。匯入之後的處理，與上傳檔案時相同。
匯入的進度與通知
資料列多的檔案匯入會花一些時間，但您不必守在畫面前。畫面會顯示進度列與已處理的列數，離開畫面後匯入仍會繼續。
匯入結束後，結果會以應用程式內通知送達。
| 通知 | 會告訴您的事 |
|---|---|
| 資料匯入已完成 | 匯入已結束，以及有多少筆與好友配對成功 |
| 資料匯入處理失敗 | 匯入失敗，以及失敗的原因 |
通知可從畫面右上角的鈴鐺圖示查看。
管理匯入的資料
匯入之後的確認與設定變更，可從資料匯入畫面中的 4 個選單進行。
| 選單 | 內容 |
|---|---|
| 儀表板 | 確認資料來源的狀態、配對率、配對到的好友數、寫入的屬性數，以及匯入的紀錄 |
| 資料 | 以列表確認匯入 Lumo 的資料最新內容 |
| 對應 | 事後編輯欄位與屬性的對應 |
| 設定 | 設定連線方式、端點，以及刪除資料集 |
點擊紀錄的資料列，就能以 「全部」「已比對」「未比對」「衝突」「錯誤」 的分頁查看該次匯入的明細。明細可以用 「下載 CSV」 匯出，想在手邊查看未配對的資料列時很方便。
資料集可從 「設定」 的 「刪除資料集」 移除。刪除後，加到好友身上的值、匯入紀錄、對應設定與連線設定會一起消失，且無法復原。系統會要求輸入資料集名稱以確認。
遇到問題時
匯入不如預期時，請依序確認檔案的條件與對應的設定。
- 無法上傳檔案：確認檔案大小是否在 10MB 以內、列數是否在 50,000 列以內。超過時請分割檔案
- 預覽出現亂碼：把字元編碼切換成 UTF-8 或 Shift_JIS。若仍未改善，請把檔案改以 UTF-8 重新儲存後再上傳
- 無法與既有好友連結：確認電話號碼、電子郵件這類欄位，是否已對應到設為識別屬性的屬性
- 第二次的匯入沒有反映：確認是否還留著 「待確認」 的變更，並從 「檢閱變更」 用 「全部核准」 核准
- 有衝突的資料列：這是既有好友在同一個屬性上已有不同的值的列。這種情況會保留原有的值。哪些列發生衝突，可在紀錄明細的 「衝突」 分頁確認