はじめに
MoEngageでは、ファイル (Amazon S3、SFTP、または手動CSVアップロード) から、またデータウェアハウス (Snowflake、BigQuery、またはDatabricks) から直接、ユーザー、イベント、Auxiliary Dataをワークスペースにインポートできます。このページは、ユースケースに適したソースを選択するのに役立ちます。方法を選択すると、専用のセットアップページでプロセス全体を順を追って確認できます。システムでIPホワイトリスト登録が必要な場合は、データインポートを設定する前に MoEngageでのIPホワイトリスト登録 を参照してください。
ソースとサポートされているエンティティ
ソースごとにサポートされるエンティティタイプが異なります。このマトリックスを使用して、必要なデータをソースからインポートできるかを確認してください。 ファイルソース
データウェアハウス
エンティティタイプ:
- Registered Users: MoEngageにすでに登録されているユーザーです。既存ユーザーの一括更新にも使用します。
- Anonymous Users: MoEngageにまだ登録されていないユーザーです。
- Events (標準およびユーザー定義): Campaign Interaction Eventsなどの標準イベントと、独自のユーザー定義イベントです。
- Auxiliary Data: 特定のビジネス目的のために一時的にMoEngageに取り込まれるユーザーデータです。ファイルベースのソース (S3、SFTP、手動アップロード) でのみ利用でき、データウェアハウスでは利用できません。
インポート方法を選択する
データの保存場所に合ったインポート方法を選択してください。ファイルインポートを設定する
Amazon S3またはSFTPサーバーに配置されたファイルからのインポートを、1回限りまたは定期的なスケジュールで自動化します。
データウェアハウスインポートを設定する
Snowflake、BigQuery、またはDatabricksのテーブルやビューから直接インポートします。接続ベースで、1回限りまたは定期的な同期が可能です。
手動アップロード
ユーザーまたはイベントのCSVをダッシュボードで直接アップロードします。1回限りのみで、定期的なスケジュール設定はできません。
Auxiliary Data
シンプルなプライマリキーマッピングモデルを使用して、S3、SFTP、またはCSV経由で補助データをインポートします。
インポートの仕組み
以下の仕組みは、すべてのインポートソースに共通です。ソース固有のセットアップ手順、制限、失敗時の動作については、各ソースのセットアップページを参照してください。インポートダッシュボード
Data Importsダッシュボードには、すべてのインポートとその主な詳細が一覧表示されます。Data Imports ダッシュボードに表示されるインポートのスケジュールおよび詳細の時刻は、アプリで設定されたタイムゾーンを使用します。アプリのタイムゾーンが設定されていない場合は、デフォルトで UTC で表示されます。希望するタイムゾーンでこれらの時刻を表示するには、Settings からアプリのタイムゾーンを設定してください。この表示用タイムゾーンは、マッピングされたタイムスタンプ列(Event time や Updated at など)を常に UTC にする必要があるという要件とは別のものです。
インポートステータス
ダッシュボード上の各インポートには、次のいずれかのステータスが表示されます。- Scheduled: 実行は将来実行されるようにスケジュールされています。
- Pending: 1時間あたりまたは1日あたりのインポート制限に達したため、実行内の1つ以上のファイルが保留されています。制限に空きができると実行は自動的に再開されるため、対応は不要です。
- Processing: 実行は進行中です。
- Successful: 実行内のすべてのファイルが成功しました。
- Partial Success: 実行は、成功したファイルと失敗したファイルが混在した状態で終了しました。
- Failed: 実行内のすべてのファイルが失敗しました。ステータスにカーソルを合わせると理由が表示されます。
- Archived: 誰かがインポートをアーカイブしました。アーカイブはMoEngageが自動的に行うものではなく手動の操作であり、元に戻すことはできないため、アーカイブされたインポートは復元できません。アーカイブされたインポートの実行履歴とファイル履歴は引き続き利用できます。
- Expired: インポートが終了日を過ぎました。このステータスはMoEngageが自動的に設定するもので、この点が Archived との違いです。
保留中のファイルが残っている実行は、同じ実行内の他のファイルがすでに失敗している場合でも Pending のままです。実行がPartial Successになるのは、すべてのファイルが最終状態に達した後のみです。
スケジュールされた各実行の結果を確認するには、Actions の下にあるケバブメニューをクリックし、View をクリックします。詳細については、実行履歴を参照してください。インポートされたファイルのコピーは最大60日間エクスポートできます。MoEngageからのファイルの再ダウンロードには期限があり、保証されていないため、インポートするファイルのコピーはご自身で保管してください。
インポート制限を確認する
MoEngageは、User imports、Event imports、Aux data の3つのカテゴリに対して、1時間あたりおよび1日あたりのインポート制限を個別に適用します。Import limit overviewでは、各制限の消費量、制限がリセットされるタイミング、保留されているインポート、および最も多く消費したインポートを確認できます。 これらの制限は、Amazon S3、SFTP、CSVアップロードからのファイルインポートに適用されます。データウェアハウスインポートには、このドロワーの対象外である別の制限プールが使用されます。Import Limit Overviewを開く
Import limit overviewは、Data importsページから、またはインポートの設定中に開くことができます。 Data importsページから開くには、次の手順を実行します。-
Import の横にある Check import limit をクリックします。

-
+ Import をクリックし、Users、Events、または Auxiliary data をクリックします。

-
ダイアログボックスで、Check import limit をクリックします。

制限に達する前に把握する
MoEngageは制限に近づくと通知するため、インポートが保留される前に再スケジュールできます。制限の80%に達すると、新しいインポートが遅延する可能性があることを警告するバナーがData importsページの上部に表示されます。また、制限に達したときにも、カテゴリとインポートが再開されるタイミングを示すバナーが表示されます。複数の制限に達した場合、影響を受ける制限はそれぞれ異なるタイミングでリセットされる可能性があるため、バナーには再開時刻が表示されません。各制限を確認するには、Import limit overviewを開いてください。 バナーはすべてのタブに表示されるため、あるカテゴリで制限に達した場合、別のカテゴリを表示しているときにも確認できます。すべての制限で80%未満の場合、MoEngageはバナーを表示しません。
消費量を確認する
Import limit overviewには、カテゴリごとに1枚のカードが表示され、上部に1時間あたりの使用量、下部に1日あたりの使用量が表示されます。各カードのプログレスバーには、その制限の消費量が、制限に対する量とパーセンテージで表示されます。 使用量を確認するには、次のいずれかの操作を実行します。- Usage の横にある情報アイコンにカーソルを合わせると、各制限がリセットされるタイミングが表示されます。
- Refresh をクリックすると、数値が更新されます。
- User imports、Event imports、または Aux data カードをクリックすると、そのカテゴリの詳細が表示されます。

影響を受けるインポートを確認する
Affected imports には、制限によって保留されているインポートが一覧表示され、到達した制限と保留中のファイルが再開されるタイミングを示すバナーが表示されます。
テーブルには、制限に達したために保留されているすべてのインポートが一覧表示されます。1時間あたりの制限に達した場合、それらのインポートは制限に空きができ次第再開されます。1日あたりの制限に達した場合、その日の保留中およびスケジュール済みのインポートは翌日に再開されます。
最も多く消費したインポートを確認する
Top contributing imports には、制限を最も多く使用したインポートが表示されるため、インポートを追加または再スケジュールする前に原因を特定できます。Top contributing imports は、カテゴリ内の少なくとも1つのインポートが実行を完了した後に表示されます。 Hourly タブと Daily タブで、テーブルの対象期間を切り替えます。- 現在のローリング1時間の期間内に実行されたインポートを表示するには、Hourly をクリックします。
- 午前12時 (UTC) の最後のリセット以降に実行されたインポートを表示するには、Daily をクリックします。

インポートをトリガーする
インポートは次の方法でトリガーできます。- 手動: インポートページで Actions をクリックして、定期インポートをトリガーします。スケジュールされた時刻の5分以内にインポートをトリガーすると、エラーが発生する場合があります。
- API: File Imports Trigger API を使用してインポートをトリガーします。データウェアハウスは現在これらのAPIをサポートしていません。
マッピングファイルとデータマッピング
マッピングファイルには、各ソース列と MoEngage 属性の間のマッピングと、列のデータ型が含まれます。ファイルは JSON 形式である必要があります。ダッシュボードで列を 1 つずつマッピングする代わりに、マッピングファイルをアップロードしてマッピングを自動化できます。- CSV ファイル
- JSON ファイル
column(必須): ソースファイルの列名。JSON ファイルのレベル 2 のキーには、ドット表記(key1.key2)を使用します。moe_attr(必須): 列のマッピング先となる MoEngage 属性。各列が一意のmoe_attrにマッピングされるようにしてください。type(任意): 列のデータ型。サポートされている型については以下を参照してください。datetime_format(任意): 日時形式。DateTime フィールドの場合のみ必須です。is_skipped(任意): ブール型のフィールド。trueとマークされた列はインポート時にスキップされます。
参考: 標準ユーザープロパティ
以下のキーを使用して、ソース列を MoEngage の標準ユーザープロパティにマッピングします。完全な一覧については、Data Management ダッシュボードを参照してください。サポートされている属性タイプ
MoEngage は、配列型以外の列で
|(パイプ)文字をサポートしていません。String、Numeric、Boolean の列にこの文字が含まれていないことを確認してください。ユーザープロパティの予約キーワード
MoEngage は次のキーを予約しています。ユーザープロパティをマッピングまたは追跡する際には、これらを使用しないでください。USER_ATTRIBUTE_UNIQUE_IDUSER_ATTRIBUTE_USER_EMAILUSER_ATTRIBUTE_USER_MOBILEUSER_ATTRIBUTE_USER_NAMEUSER_ATTRIBUTE_USER_GENDERUSER_ATTRIBUTE_USER_FIRST_NAMEUSER_ATTRIBUTE_USER_LAST_NAMEUSER_ATTRIBUTE_USER_BDAYUSER_ATTRIBUTE_NOTIFICATION_PREFUSER_ATTRIBUTE_OLD_IDMOE_TIME_FORMATMOE_TIME_TIMEZONEUSER_ATTRIBUTE_DND_START_TIMEUSER_ATTRIBUTE_DND_END_TIMEMOE_GAIDINSTALLUPDATEMOE_ISLATstatususer_idsource
サポートされている日時フォーマット
これらのフォーマットは、マッピングファイルのdatetime_format フィールドで、またはセットアップ時に日時列を設定する際に使用します。
よくある質問
インポートが失敗しました。原因を確認するにはどうすればよいですか?
インポートが失敗しました。原因を確認するにはどうすればよいですか?
右側の省略記号をクリックし、View をクリックしてインポートの詳細を確認します。Failed ステータスにカーソルを合わせると、理由を確認できます。
スケジュールされたインポートが、最近アーカイブされたセグメントにデータを追加した場合はどうなりますか?
スケジュールされたインポートが、最近アーカイブされたセグメントにデータを追加した場合はどうなりますか?
その場合でも、新しいデータはアーカイブされたセグメントに追加されます。必要に応じてセグメントのアーカイブを解除できます。
実行中のインポートを停止できますか?
実行中のインポートを停止できますか?
インポート処理が開始されると、途中で停止することはできません。データは複数のステップを経て処理されるため、中断すると不完全または不整合な結果になる可能性があるからです。現在のインポートが完了するまで待つことをお勧めします。
スケジュールされたインポートの今後の実行を停止するにはどうすればよいですか?
スケジュールされたインポートの今後の実行を停止するにはどうすればよいですか?
はい、スケジュールされたインポートが今後自動的に実行されないように停止できます。そのためには、Data Imports ダッシュボードでインポートスケジュールを見つけ、Actions メニューから Archive オプションを選択します。これにより、次回のスケジュール時刻に実行されなくなります。
インポートが停止しているように見える、または時間がかかっている場合はどうすればよいですか?
インポートが停止しているように見える、または時間がかかっている場合はどうすればよいですか?
インポートが停止しているように見える場合や、通常より時間がかかっている場合は、待つことをお勧めします。システムにはこうした状況を自動的に処理し、必要に応じて再試行するチェック機能が備わっています。処理中に同じインポートを手動で再度開始すると、競合が発生し、元のインポートが正常に完了しなくなる可能性があります。