SFTPインポート

Overview

MoEngageを使用して、SFTPフォルダに保存されたファイルを介してユーザーとイベントをインポートできます。

輸入の種類

MoEngage はあなたの SFTP フォルダから以下をインポートできます:

登録ユーザー : MoEngageにすでに登録されているユーザー。
匿名ユーザー : MoEngageにまだ登録していないユーザー。
イベント （標準およびユーザー定義）: キャンペーンインタラクションイベントなどの標準イベントと、あなたのユーザー定義イベント。
補助データ : 一時的に追加されたユーザー。

ファイルを準備してください

サポートされているファイルタイプ、命名規則、ファイル構造などに関する詳細情報については、ファイルインポートのヘルプドキュメント。ファイルの準備ができたら、それらをSFTPフォルダーに配置してください。

フォルダー構造

すべてのファイルをフォルダーに配置してください。インポートの設定時にフォルダーのパスを構成できます。
MoEngageは、サブフォルダー内のファイルを探しません。

SFTPからのインポートを設定する

info	前提条件 App Marketplaceで関連する権限を持つSFTP接続が設定されていることを確認してください。詳細については、こちらをご覧ください。 MoEngageダッシュボードの左側のナビゲーションにデータメニューオプションを有効にするには、MoEngageカスタマーサクセスチームにお問い合わせください。

SFTPからのインポートを設定するには、次の手順を実行します：

MoEngageダッシュボードの左側のナビゲーションメニューで、 データ をクリックし、次に データインポート をクリックします。
クリックして + インポート を選択し、次にソースを選択して ユーザー または イベント の新しいインポートを作成します。インポートユーザーダイアログボックスが表示されます .
「 SFTPタイル 」をクリックし、「続行」をクリックします。

ステップ 1: ソースとフォーマット

このステップでは、SFTP接続を構成し、ファイル形式を指定します。「 インポート名 」ボックスに、このインポートをインポートダッシュボードで簡単に識別できるように名前を入力してください。

選択したインポートの種類に基づいて、次のステップは異なる場合があります：

RegisteredユーザーまたはAnonymousユーザーをインポートするかを選択できるようになりました。また、両方を同時にインポートすることもできます。 ユーザータイプを選択 セクションで、RegisteredユーザーまたはAnonymousユーザーのいずれかを選択してください。両方のユーザータイプには異なるファイル名が必要です。詳細については、命名規則を参照してください。

イベントのインポートでは、インポートしたいイベントを選択できます。 イベントを選択 リストから、インポートしたいイベントを選択できます

選択したイベントに基づいて、ファイル名が異なります。選択したイベントのイベント名でファイル名を始める必要があります。In the Select event list, MoEngage displays the names of all the available events for your app.これらのイベントのいくつかは、異なる表示名とイベント名を持っているかもしれません。イベントにカーソルを合わせると、MoEngageはその特定のイベントに対して期待されるファイル名を表示します。

例えば、イベント アプリ/サイトが開かれました は値 MOE_APP_OPENED を持つため、ファイル名は MOE_APP_OPENED で始まる必要があります。詳細については、命名規則。

新しいイベントを作成するには、次の手順を実行します：

リストの イベントを選択 の最後にある + イベントを作成 をクリックします。新しいイベントを作成するダイアログボックスが表示されます。
イベント名ボックスに、イベントのユニークな名前を入力してください。デフォルトでは、表示名はイベント名と同じになります。

このイベントや他の MoEngage イベントを表示または編集するには、データ管理ページに移動できます。

info	情報新しく作成されたイベントは、初回のインポートが成功するまでデータ管理ページに表示されません。

SFTP認証情報を選択してください

最初のステップでは、 ソース およびフォーマット 、MoEngageに使用するSFTP接続と、インポートするフォルダーを通知する必要があります。開始するには、次の手順を実行してください：

この SFTP接続 リストから、このインポートに使用するSFTP接続を選択してください。まだSFTP接続を作成していない場合は、 + 接続を追加 をクリックして SFTP接続 リストの最後に追加してください。詳細については、新しいSFTP接続の設定を参照してください。
以下の詳細を入力してください：

Field	Description
Folder URL	フォルダのURLを入力してください。これはあなたのファイルが存在するフォルダーのパスです。MoEngageはサブフォルダーの中を見ません。トレーリングスラッシュを含めないでください。注意 : MoEngageは現在、ルートフォルダをサポートしていないため、すべてのファイルが単一のフォルダ内にあることを確認してください。これをどうやって見つけますか？あなたのフォルダーパスは、末尾のスラッシュを除いた `sftp://[host-name]/` で始まる完全なパスです。例: `sftp://files.hostname.com/my_folder` `sftp://127.0.0.1/my_folder/sub_folder`
ファイルタイプ	インポートしたいファイルの種類を選択してください。MoEngageは以下のファイルのインポートをサポートしています：カンマ区切り値 (. `CSV` ) 改行区切りのJSONファイル（. `JSON` ）
あなたのファイルは暗号化されていますか？	暗号化されたファイルをインポートする場合は、ファイルは暗号化されていますか？チェックボックスを選択してください。 MoEngageは暗号化ファイルのインポートをサポートしています。現在、 PGP暗号化をサポートしています。詳細については、 MoEngageはPGP暗号化をどのように扱っているか？を参照してください。注: MoEngageは、最大2048ビットの長さのRSAキーを使用したファイル暗号化をサポートしています。より高いビット数は推奨されません。
復号鍵	暗号解除キーを入力してください。このフィールドは、ファイルは暗号化されていますか？チェックボックスを選択すると表示されます。これはあなたのプライベートPGPキーです。自分でPGPキーを生成することも、MoEngageに生成させることもできます。例: -----BEGIN PGP PRIVATE KEY BLOCcK----- `xcMGBGVqq74BCADKpWRLSAdcTtDKpT+LCUCqDoZQ2dlgeBiXNovBVyTPlAOPQSqX bnNGs+U4RpHebjvTxaWCLDBGYOvtZbtv6WvPIF7lzXrIv+DcgLMBQp2b3t+ohRBi 41Ch8CZ04F2lxbVBo` -----END PGP PRIVATE KEY BLOCK-----
署名キー	署名キーを入力してください。このフィールドは、ファイルが暗号化されていますか？チェックボックスを選択すると表示されます。署名キーが設定されている場合は、次の形式で署名キーセクションに入力してください。例えば： -----BEGIN PGP PUBLIC KEY BLOCK----- `xqq74BCADKpWRLSAdcTtD45nl24KpT+LCUCqDoZQ2dlgeBiXNovBVyTPlAOPQSqX bnNGs+U4RpHebjvTxaWCLDBGYOvtZbtv6WvPIF7lzXrIv+DcgLMBQp2b3t+ohRBi 41Ch8CZ04F2lxboksCwnl31laEuQkk8MERlcthB9AiKvSEf6jihLcPSVVanrQUQN77UZf sFCynJXweqijZxtmUl9V1838sUVOoTzfmGwu7PzV99tAiOlxBjYF9SXIYY/GOoJN Zuz8uOaXWtFPmV536uQT` -----END PGP PUBLIC KEY BLOCK-----
キーパスフレーズ	暗号化キーペアで生成されたキーパスフレーズを入力してください。

ファイル設定

ファイル名に含まれているDateTime形式を選択してください。以下の命名規則に従い、ファイル名は _ .csv または _ .json で終わる必要があります。前に提供された表を参照して、MoEngageがサポートしているDateTimeフォーマットを確認してください。情報メッセージは、選択した日付時刻形式に応じて更新されるため、ファイル名が期待通りであるかどうかを簡単に確認できます。

SFTPの資格情報とファイル名の形式を設定した後、MoEngageはSFTPサーバーに接続し、指定された形式で利用可能な最も最近のファイルを取得しようとします。指定された場所に少なくとも1つのファイルが利用可能であることを確認してください。さもなければ、続行できません。準備ができたら、 ファイルを取得する をクリックして、最近のファイルを取得してください。

SFTPの認証情報と選択したファイル形式が正しければ、MoEngageは最近のファイルの最初の5行のプレビューを表示します。

これらは、SFTPサーバーからファイルを取得する際に遭遇する可能性のある一般的なエラーです：

指定された資格情報が正しくありません : これは、あなたのSFTP資格情報が正しくないことを示しています。正しい資格情報を入力し、再度ファイルを取得してください。
フォルダパスを確認して再試行してください : これは、フォルダパスが正しくないか、指定されたフォルダパス内にCSVまたはJSONファイルが存在しないことを示しています。
ファイルにデータ行がゼロ件見つかりました : これは、取得したファイルがヘッダーを超える行を含まなかった（CSVファイルの場合）か、完全に空であったことを示しています。MoEngageは、CSVファイルに対して少なくとも2行（1つのヘッダー + 1つのデータ行）、またはJSONファイルに対して少なくとも1つのデータ行を期待しています。詳細については、ファイル構造を参照してください。

ファイルのプレビューに満足したら、次へをクリックしてマッピングステップに進んでください。

ステップ 2: 設定とアクションのインポート

このステップでは、SFTP接続とファイル形式を設定した後、データ列をMoEngage属性にマッピングします。インターフェースは、ファイルのすべての列（CSVヘッダーまたはJSONキーから派生）をリストし、それぞれをMoEngageの対応する属性にマッピングできるようにします：

「 マップ列 」セクションには、次の内容があります：

列名 : これはマッピングされる列名です（前のステップで取得したファイルの最初の行から取得）。列名の下には、MoEngageがサンプル値（前のステップで取得したファイルの2行目から取得）も表示され、参考になります。
マップ列を属性に : どのMoEngage属性に列をマップするかを選択する必要があります。新しい属性を作成することもできます。いくつかの属性は複数のデータ型からの取り込みをサポートしているため、列のデータ型も選択する必要があります。「DateTime」列については、フォーマットも選択する必要があります。「DateTime」列については、形式を選択する必要があります。
アクション : 列をスキップすることを選択できます。スキップされた列はインポートされません。

インポートの種類に応じて、いくつかの必須マッピングが必要です：

ユーザーインポート

登録ユーザー
- - : あなたのファイルには、必ず一意のユーザー識別子を含む列が必要です（これは、あなたのシステム内のユーザーアカウントを識別します）。
匿名ユーザー
- 匿名ID : ファイルの列（メール、携帯番号など）をこれらのユーザーの識別子としてマークする必要があります。
イベントのインポート
- : この列は、MoEngageのユーザーをあなたのファイルにマッチさせるために使用されます。
- イベント時間 : イベント時間 (UTC) またはイベント時間 (アプリのタイムゾーン) のいずれかをマッピングする必要があります。イベント時間 (UTC) を選択した場合、インポートされたイベントの「イベント時間」は、あなたの MoEngage ダッシュボード設定で選択したタイムゾーンに変換されます:

必須のマッピングがマークされると、マッピングテーブルの列名に反映され、もはやその列をスキップ可能としてマークすることはできなくなります。

フィールドを追加

ダッシュボードから直接フィールドを追加することもできます。 +列を追加 をクリックしてください。これにより、下のリストの最後に 列名を入力 する新しい項目が作成され、属性マッピングを手動で入力できます。

マニフェストファイル

オプションで、これらの列を自動的にマッピングするために、マニフェストファイルをアップロードすることができます。マニフェストファイルをアップロードするには:

マッピングテーブルの右上にある マッピングファイルをアップロード をクリックしてください。
アップロードマッピングダイアログボックスで、マニフェストファイルをアップロードしてください。
クリックして完了します。

新しいインポートの場合、インポート用の適切なマッピングファイルを作成する際の参考として使用できるサンプルマニフェストファイルを見つけることができます。既存のインポートを複製し、マッピングファイルをアップロードすると、既存のマッピングファイルがすでに追加されているのがわかり、それをダウンロードできます。マッピングは自動的に設定されます。マニフェストファイルに記載されているが、現在MoEngageに存在しない追加の属性については、属性を作成するためのリストが表示されるモーダルが開きます。

CreateNewAttributes (1).png

MoEngage以外の属性を持つ列は空白のままにされ、手動でマッピングするか、それらのための新しい属性を作成することができます。マニフェストファイルが期待される規約に従っていることを確認してください。

マニフェストファイルに存在するが、あなたのファイルには存在しない追加の列は無視されます。また、既存の列のマッピングがマニフェストファイルに存在しない場合、MoEngageはマッピングを空白のままにしておきますので、手動で設定できます。

マニフェストファイルの列が存在しないMoEngage属性にマッピングされている場合、そのマッピングは空白になります。そのため、まずUIから新しい属性を手動で作成し、次にマッピングする必要があります。

インポート通知を送信

インポートのステータスに関するメール通知を受け取るには、次の手順を実行してください：

「 インポートステータスを送信 」トグルをオンにします。
メールIDを選択する Select email id リストから、メールIDを選択してください。ステータスメールを送信するために最大10件のメールを選択できます。

インポートステータスメールには、以下のイベントに関する情報が含まれています：
- - インポートが作成されました
  - インポートが成功しました
  - インポートが失敗しました
すべてのマッピングが完了したら、次へクリックしてください。

ステップ3: スケジューリング

このステップでは、SFTPサーバーからファイルをインポートするタイミングを定義する必要があります。

以下の種類のインポートをサポートしています：

一度のインポート : できるだけ早くインポートを実行するか、後の日時にスケジュールして実行することができます。
定期的 : インポートを毎時、毎日、毎週、または毎月実行することができます。また、間隔や高度な設定を使用することも可能です。

各実行の際、MoEngageは設定された日付時刻形式のファイルを取得しようとしますので、ファイル名が正しく設定されていることを確認してください。オプションとして、インポートを特定の発生数または特定の日付で終了させるかどうかを指定できます。準備ができたら完了をクリックしてください。

重複インポート

重複インポートは次のような場合に考慮されます:

ユーザー/イベントのインポートタイプは同じです。
イベント名/ 登録済み/ 匿名/ すべてのユーザーのインポートサブタイプは同じです。
イベント名/ 登録済み/ 匿名/ 同じ SFTP フォルダーパスを持つすべてのユーザーインポートタイプ。

FAQ

arrow_drop_down 私のインポートが失敗しました。何が悪かったのか確認するにはどうすればよいですか？

右側の省略記号をクリックし、表示をクリックしてインポートの詳細を確認します。強調表示された失敗 ステータス にカーソルを合わせて、理由を確認してください。

arrow_drop_down S3/SFTPフォルダーからファイルを取得する際にエラーが発生した場合、通常はエラーメッセージが表示され、ファイルの取得が失敗したことが通知されます。これにより、ユーザーは問題を特定し、修正するための手順を講じることができます。具体的なエラーの内容は、接続の問題、認証の失敗、またはファイルが存在しないことなど、さまざまな原因が考えられます。

デフォルトでは、インポートが失敗した場合、再試行は行われません。ただし、失敗時にメールアラートを受け取るように設定することができます。

arrow_drop_down 最近アーカイブされたセグメントにデータが追加される予定のインポートがあった場合はどうなりますか？

そのような場合、新しいデータはアーカイブされたセグメントに追加されます。必要に応じてセグメントを復元できます。

arrow_drop_down MoEngage は定期的に新しいファイルをどのように取得するのでしょうか?

指定されたワークスペースのスケジュールされた実行では、MoEngageはファイル名のプレフィックスに基づいてS3/SFTPフォルダ内で特定されたすべての新しいファイルを取得し、それらを処理します。指定された MoEngage ワークスペースへのデータインポートは、フォルダーの場所とファイル名の組み合わせによってこれらのファイルを一意に識別します。

arrow_drop_down 定期データインポートは、以前に処理されたファイルを取得しますか？

No.同じファイル名で同じフォルダーの場所にある場合、処理されたファイルは再度処理されることはありません。ただし、同じファイルが別のフォルダーに配置されている場合、新しいフォルダーの場所が設定されたMoEngageでの新しいデータインポート設定がファイルを取得します。

arrow_drop_down CSVファイルにはユーザーとイベントの両方のデータを含めることができますか？

いいえ。MoEngage ワークスペースダッシュボードでのデータインポートは、ユーザーデータとイベントデータのために別々に設定する必要があります。したがって、ファイルにはユーザー属性データまたはイベントデータのみが含まれている必要があります。

arrow_drop_down インポートが実行中に停止できますか？

インポートプロセスが開始されると、その途中で停止することはできません。これは、データがいくつかのステップを経るためであり、それを中断すると不完全または一貫性のない結果につながる可能性があるからです。現在のインポートが完了するまで待つのが最良です。

arrow_drop_down 今後のスケジュールされたインポートの実行を停止するにはどうすればよいですか？

はい、今後のスケジュールされたインポートが自動的に実行されるのを停止できます。これを行うには、インポートスケジュールを見つけ、データインポートダッシュボードの アーカイブ オプションを アクション メニューから選択します。これにより、次の予定された時間に実行されるのを防ぎます。

arrow_drop_down NDJSONとは何ですか、そしてなぜそれが必要なのですか？

NDJSON（改行区切りJSON）とは、.jsonファイル内の各行が完全なJSONオブジェクトであり、新しい行で区切られていることを意味します。このフォーマットは、大規模で堅牢なインポートを可能にするために、広範なJSONデータセットを行単位で処理するために必要です。

arrow_drop_down 圧縮ファイル（例： .gz, .zip ）はサポートされていますか？

いいえ、圧縮ファイルのインポートはサポートしていません。

arrow_drop_down 既存のインポートのファイルタイプを変更すると、マッピングはどうなりますか？

ファイルタイプを変更すると、既存のプレビューが削除され、新しいファイルタイプに基づいて利用可能なファイルのリストが再取得されます。再度プレビュー用のファイルを選択し、新しいファイルの構造に基づいてマッピングを設定する必要があります。

arrow_drop_down インポートがスタックしているように見える場合や、長時間かかっている場合はどうすればよいですか？

インポートがスタックしているように見える場合や、通常よりも時間がかかっている場合は、待つのが最善です。システムには、これらの状況を自動的に処理するためのチェックが備わっており、必要に応じて再試行します。同じインポートを処理中に手動で再度開始すると、競合が発生し、元のインポートが正常に完了しない可能性があります。