- 他社ツールから書き出した名簿を、分割せずに1ファイルのまま取り込めます(最大500万行)
- 取り込みの進捗を画面で確認し、途中でキャンセルできます
- 一部だけ失敗した場合に、失敗した分だけ再試行できます
- ワークスペースで 大量データ移行が有効になっている こと(既定で有効です。個別に無効化されているワークスペースでは利用できません)
- ワークスペースのオーナー、管理者、またはコンタクト管理権限を持つメンバーであること
- 取り込み先のLINEチャンネルが連携済みであること
通常のインポートとの違い
通常のコンタクトのCSVインポートは、日々の名簿更新のための機能です。ブラウザから直接アップロードして、その場で取り込みます。他社ツールからの乗り換えや初回の一括登録のように、名簿をまるごと持ち込む場合は大量データ移行を使います。
大量データ移行で扱えるのは、1ファイルあたり500万行までです。これを超える場合は、ファイルを500万行以内に分割してから移行してください。分割の単位や再開の仕方はシステム側で決めるため、操作する側で行数を計算してファイルを割る必要はありません。
| 項目 | 通常のインポート | 大量データ移行 |
|---|---|---|
| 想定する場面 | 定常運用の名簿更新 | 初回の乗り換え・一括移行 |
| 扱える規模 | ブラウザから直接アップロードできる大きさ | 500万行まで |
| 列の割り当て | 画面で指定できます | できません(Tsunavo形式の列構成で判定します) |
| 既存コンタクトの更新 | 「空欄のみ更新」「上書き」「更新しない」から選べます | 選べません(「空欄のみ更新」に固定) |
| 変更内容の事前確認 | できます | できません |
| 処理方式 | その場で取り込みます | 分割してバックグラウンドで取り込みます |
| 所要時間 | 数分 | 行数とその時点の負荷によって変わります(数百万行では半日〜1日程度かかることがあります) |
大量データ移行はバックグラウンドで分割して取り込むため、所要時間は行数、列の内容、その時点のシステムの負荷によって変わります。特定の時間内に完了することはお約束していません。配信やキャンペーンの開始日が決まっている場合は、余裕をもって移行を始めてください。進捗は画面で確認できます。
大量データ移行には「変更内容を確認」の工程がありません。取り込みを開始すると、そのままコンタクトが作成・更新されます。まずは同じCSVの先頭数十行を切り出したファイルを大量データ移行で流し、コンタクト一覧で結果を確認してから本番のファイルを流すことをおすすめします。
試すときは通常のインポートではなく大量データ移行で試してください。通常のインポートには列の割り当てと更新の仕方の選択があり、そこで確認した設定は大量データ移行に引き継がれません。
大量データ移行の更新の仕方は「空欄のみ更新」に固定されています。既にコンタクトに値が入っている表示名・メールアドレス・電話番号は、CSVに別の値が書かれていてもそのまま残ります。書き換わるのは空欄だった項目だけです。
他社ツールの値でTsunavo側を上書きしたい場合、大量データ移行ではできません。移行後に通常のインポートで「上書き」を選んで流し直すか、サポートまでご相談ください。
大量データ移行が読むのは、通常のインポートと同じTsunavo形式の列だけです。それ以外の列を足しても、エラーにも警告にもならずに無視されます(状態は「完了」になります)。
カスタム項目に値を入れたい場合は、通常のインポートで列を割り当てるか、custom_fields 列にJSON形式でまとめてください。custom_fields 列は大量データ移行でもそのまま取り込まれます。
identity_tags に書いたタグ名がまだ存在しない場合、そのタグが新規に作成されます。この動作は止められません。移行の規模では、表記ゆれや誤記がそのままタグ一覧に大量に並ぶことになります。事前確認の工程が無いぶん、CSVのタグ列は流す前に確認してください。
取り込みを開始する
左側メニューから コンタクト → 「インポート」を開きます。大量データ移行が有効なワークスペースでは、ファイルを選ぶ前から「大量データ移行に切り替える」というリンクが表示されているので、これをクリックします。通常のインポートで扱える大きさを超えるファイルを選んだときにも、同じリンクが案内として出ます。
取り込み先チャネル に、コンタクトを追加するLINEチャンネルを選びます。
CSVの書き出し元 は「Tsunavo形式CSV」の固定表示です。大量データ移行で取り込めるのはTsunavo形式(通常のコンタクトインポートと同じ列構成)のCSVのみです。他社ツールから書き出したファイルは、先にTsunavo形式へ整えてください。
Tsunavo形式の見出し行は、通常のインポート画面の「テンプレートをダウンロード」で取得できます。移行するファイルの1行目は、このテンプレートの見出し行に合わせてください。
なかでも line_user_id は必須です。この列が無いファイル、またはLINE User ID(U で始まる33文字)になっていない行は、1行も取り込まれません。大量データ移行には行ごとの失敗理由の一覧が無いため、この状態になっても画面には「取り込み済み 0件・失敗 ◯件」と出るだけで、原因までは分かりません。流す前に、見出し行と line_user_id の値を確認してください。
CSVファイルを選び、「移行を開始」をクリックします。ファイルのアップロードが始まり、完了すると自動的に取り込みが始まります。
進捗画面に「取り込み中」と表示され、取り込み済みの行数が増えていけば成功です。画面を閉じても取り込みは続きます。あとから同じ画面を開けば、進捗の続きを確認できます。
進捗の見方
進捗画面には、次の7つの状態のいずれかが表示されます。
| 状態 | 意味 |
|---|---|
| 受け付け済み | ジョブを受け付け、開始を待っています |
| 分割中 | ファイルを読み取り、処理単位に分割しています |
| 取り込み中 | 分割した単位を順番に取り込んでいます |
| 完了 | すべての行の処理が終わりました |
| 一部失敗 | 一部の単位が失敗しました。成功した分は取り込まれています |
| 失敗 | 取り込みが失敗しました |
| キャンセル済み | キャンセルが完了しました |
進捗率は、分割した単位のうち処理が終わった割合です。実行中は100%手前で止まって見えることがあります。処理の終わりは進捗率ではなく、状態表示(完了 / 一部失敗 / 失敗 / キャンセル済み)で判断してください。
キャンセルする
取り込み中に「キャンセル」をクリックすると、キャンセルの受け付けが記録され、表示が「キャンセル処理中」に変わります。
すでに処理が始まっている単位はそのまま最後まで実行されるため、キャンセルしても、その時点までに取り込まれたコンタクトは残ります。取り消したい場合は、コンタクト一覧から個別に削除してください。
失敗した分だけ再試行する
状態が「一部失敗」で、失敗した単位が残っているときにだけ、「失敗した分割を再試行」が表示されます。これをクリックすると、失敗した単位だけがもう一度キューに入ります。
再試行する単位は、先頭の行からもう一度処理します(途中から再開する仕組みはありません)。前回すでに取り込まれた行も、コンタクトの照合とタグ付けの判定をもう一度通ります。
更新の仕方は「空欄のみ更新」に固定されているため、前回の取り込みのあとに値を入れ直した項目が上書きされることはありません。ただし、値を空にした項目はCSVの値で埋め直されます(空欄が更新の対象だからです)。外したタグも付け直されます。再試行の前に、取り込み済みの範囲と、そのあとに手動で編集したコンタクトを確認してください。
ほかの移行が実行中のときは、再試行も受け付けられません(同時に実行できるのは1件です)。その場合は画面に理由が表示され、このジョブは画面に残ります。実行中の移行が終わってから、もう一度「失敗した分割を再試行」を押してください。
コンタクトが二重に作られることはありません。同じLINEユーザーは既存のコンタクトとして照合され、新しく作られるのではなく更新の対象になります。
状態が「失敗」のときは、この画面からの再試行はできません。原因を直したうえで「別のファイルを移行する」から新しい移行としてやり直してください。
分割した単位は、処理を進めた分をその場で確定させてから失敗します。そのため、すべての単位が失敗して状態が「失敗」になっても、そこまでに取り込まれたコンタクトが残っている場合があります。1件も取り込まないうちにすべての単位が失敗した場合は0件です。まず画面の「取り込み済み」の件数を確認してください(失敗の起き方によっては、この件数が実際より少なく表示されることがあります)。
件数が0件でないまま同じファイルを流し直すと、すでに取り込まれたコンタクトに更新やタグ付けがもう一度適用されます。やり直す前に、コンタクト一覧で取り込み済みの範囲を確認してください。
原因を直さないまま流し直しても、同じところで失敗します。エラーの内容を確認し、CSV側に原因がある場合はファイルを修正してからやり直してください。
原因: ワークスペースで大量データ移行が個別に無効化されています(既定では有効です)。
解決策: サポートまでお問い合わせください。有効化後、画面を再読み込みすると表示されます。
原因: 同じワークスペースで、まだ終わっていない移行ジョブがあります。同時に実行できるのは1件です。開始のときだけでなく、失敗した分の再試行のときにも出ます。
解決策: 実行中のジョブが完了するまで待つか、キャンセルしてから操作し直してください。新しい移行を開始しようとして出た場合は、画面が実行中のジョブの進捗に切り替わります。再試行で出た場合は、再試行しようとしたジョブが画面に残るので、実行中のジョブは画面を再読み込みすると表示されます。
原因: CSVファイルのサイズが、大量データ移行の上限を超えています。
解決策: ファイルを分割し、1件ずつ順番に移行してください。
原因: 1ファイルの行数が上限の500万行を超えている可能性があります。行数の超過はアップロードのあとの分割処理で初めて分かるため、開始した直後はエラーになりません。画面には行数超過とは表示されず、1時間ほど「分割中」が続いたあと「失敗」に変わります。
解決策: CSVの行数を確認し、500万行以内に分割してから、1件ずつ順番に移行してください。
原因: アップロードの途中で通信が切れたか、アップロード用URLの有効期限が切れました。
解決策: ファイルを選び直して、もう一度移行を開始してください。大きいファイルでは、通信が安定した環境で実行してください。
原因: ほかのタブやメンバーが、同じジョブを同時に操作しました。
解決策: 最新の状態が自動で読み込まれます。表示を確認したうえで、もう一度操作してください。
原因: `line_user_id` 列が無いか、値がLINE User ID(`U` で始まる33文字)になっていない可能性があります。この列はCSVの見出し名で判定するため、名前が違うだけでも全行が失敗します。
解決策: 通常のインポート画面の「テンプレートをダウンロード」で見出し行を取得し、移行するファイルの1行目をそれに合わせてください。1件も取り込まれていないため、同じファイルを直したうえで「別のファイルを移行する」からやり直しても、二重に反映されることはありません。
原因: CSVの列構成がTsunavo形式と合っていなかった可能性があります。
解決策: 列構成をTsunavo形式に合わせて修正し、移行し直してください。すでに取り込まれたコンタクトは、通常のインポートで正しい値を上書きするか、サポートまでご相談ください。