Overview
イベントインポート機能を使用すると、CSVファイルからイベントをMoEngageアカウントにインポートできます。この機能は、以下のようなさまざまな用途をサポートしています：
- 履歴データのインポート - マーケターとして、MoEngageに過去のイベントデータをインポートして、顧客の過去の行動やトレンドを分析することができます。
- イベントデータ移行 - プラットフォームの移行中に、CSVを通じてイベントをインポートすることで、歴史的なイベントデータのスムーズな移行を確保し、分析やキャンペーン管理の継続性を保証します。
- バッチアップロード - CSVを通じてイベントをインポートすることで、ユーザーは一度に大量のイベントをアップロードでき、時間と労力を節約できます。これは、MoEngageプラットフォームで多数のイベントを更新または入力する際に便利です。
CSVを使用してイベントをインポート
CSVファイルを使用してイベントデータをインポートするには、次の手順を実行してください：
- MoEngageダッシュボードにログインします。
-
「データ」>「データインポート」に移動します。
-
「
データインポート
」ページの「
イベント
」タブで、「
インポート
」>「
イベント
」をクリックします。
- 「 イベントのインポート 」ダイアログボックスで、 CSVをアップロード をクリックします。イベントは、 SFTP や S3 を使用してインポートすることもできます。
-
クリック
続行します。
以下のステップバイステップのプロセスは、CSVを使用してMoEngageプラットフォームにイベントをインポートする方法を説明しています。
ステップ 1: ソースとフォーマット
CSVファイルのソースおよびフォーマットに関連する詳細をステップ1に入力してください。
| info |
情報 CSVファイルは一度に1つのイベントしかアップロードできないため、1つのCSVファイルを使用して複数のイベントをアップロードすることは不可能です。 |
- インポート名 - インポートの名前を入力してください。
-
イベントを選択
- CSVファイルを使用してアップロードしたいイベントを選択します。ドロップダウンに探しているイベントが表示されていない場合は、ドロップダウンから
新しいイベントを作成
をクリックしてください。
- 新しいイベントを作成 ダイアログボックスで、 イベント名 を入力し、 作成 をクリックします。
-
ファイルを選択
- CSVファイルをドラッグ＆ドロップするか、コンピュータからCSVファイルをアップロードできます。また、
サンプルファイルをダウンロード
して、CSVファイルで期待されるデータ形式を明確に説明するサンプルイベントファイルを表示することもできます。150 MB未満のCSVファイルがサポートされていることに注意してください。
info 情報
イベントCSVファイルをアップロードすると、列はイベント属性を表します。
- ファイルプレビュー - アップロードしたCSVファイルをプレビューするには、 ファイルをプレビュー をクリックしてください。イベントCSVファイルの最初の5行をプレビューできます。
-
クリックして
次へ
。これにより次のステップに進みます。
ステップ2：設定とアクションのインポート
このステップでは、MoEngageのイベント属性をCSVファイルのイベント属性列にマッピングします。
Required Mapping
これは実行すべき必須のマッピングです。「 属性名 」の下で、 User Identifier や Event time などのMoengageのイベント属性を表示できます。これらの属性は、 マップ列 の下にリストされているCSVファイルのイベント属性列に必ずマッピングされるべきです。アップロードしたCSVファイルの列名は、 マップ列 の下のドロップダウンメニューから選択できます。
イベントの
時間
をマッピングする際は、日付、時間形式、タイムゾーンを選択してください。
マップ列
上記の必須フィールドを正常にマッピングした後、CSVファイル内の残りのイベント属性列をMoEngageのイベント属性にマッピングする必要があります。
CSVファイルのイベント属性の列は 列名 の下にリストされており、これは 属性に列をマッピング の下でMoEngageのイベント属性にマッピングされる必要があります。
列をマッピングするために、次の手順を実行してください：
-
MoEngageのイベント属性を
属性を選択
ドロップダウンから選択するか、ドロップダウンに属性が表示されていない場合は
新しい属性を作成
をクリックします。
-
新しい属性を作成
ダイアログボックスで、
属性名
、
データ型
を入力し、
作成
をクリックします。
-
新しい属性を作成
ダイアログボックスで、
属性名
、
データ型
を入力し、
作成
をクリックします。
- 各属性の データ型 を選択しながらマッピングします。
-
選択する
スキップ列
をマッピングからスキップしたい場合は選択してください。必須フィールドはすでにマッピングされているため、
列をマップ
の下で無効になっています。
インポートステータスを送信
イベントデータがMoEngageにインポートされた後、インポートステータスを10のメールIDに送信できます。ステータスを送信したい
メールID
をドロップダウンから選択し、
次へ
をクリックします。
ステップ 3: スケジューリング
このステップでは、ファイルをインポートするタイミングを定義する必要があります。MoEngageは以下のインポートタイプをサポートしています：
-
できるだけ早く
: ファイルは
インポートのスケジュール
をクリックするとすぐにインポートが開始されます。
-
特定の日付と時刻に
: 選択した
開始日
と
開始時刻
に基づいてインポートを実行するように選択できます。また、
タイムゾーン
を選択することもできます。
スケジュールを設定したら、 インポートをスケジュール をクリックします。イベントデータは現在MoEngageにインポートされます。
インポートされたイベントデータを見る
インポートされたイベントデータは
データ
>
データインポート
>
イベント
の下にリストされます。
アクション
(
) をクリックして、イベントデータを
表示
または
複製
します。
-
インポートされたイベントの詳細を表示するには
表示
をクリックしてください。
アクション
をクリックして(
)、 ファイルをエクスポート してあなたのメールアドレスに 送信します 。
- イベント名が同じイベントを複製するには 複製 をクリックし、その後CSVファイルをアップロードできます。
インポートされたイベントデータのインポートステータスは次のとおりです:
- 成功 - イベントのインポートが成功したときに表示されます。
- 処理中 - インポートされた後、イベントのインポートがまだ処理中の状態で表示されます。
- アーカイブ済み - インポートされたイベントがアーカイブされているときに表示されます。
- 失敗 - イベントのインポートが失敗した場合に表示されます。
イベントデータにおけるサポートされているデータ型、イベント属性型および日付時刻形式
サポートされているデータ型
ファイル内の列値に対してサポートされているデータ型は次のとおりです：
- 文字列
- 数値
- ブール
- 日時
- Array (String, Double, Float, Int)
サポートされているイベント属性タイプ
| タイプ | Description | マニフェストの値 |
|---|---|---|
| 文字列 | Any string value.許容される値の例は、ABC、ABC XYZ、ABC123などです。 | "type": "string" |
| ダブル | 任意の小数値。許容される値の例は 3.14159、241.23、-123.1 です。 | "type": "double" |
| ブール | 許容される値の例は、true、falseです | "type": "bool" |
| 日付 時間 | 任意の日付時刻値。サポートされているフォーマットは 次の表 に記載されています。許可される値の例は2019/02/22 17:54:14.933です。 | "type": "datetime" |
サポートされている日付時刻形式
| 日付と時刻の形式 | 例 |
|---|---|
| “datetime_format”: "YYYY-MM-DD" |
|
| “datetime_format”: "YYYY/MM/DD" |
|
| “datetime_format”: "DD/MM/YYYY" |
|
| “datetime_format”: "DD-MM-YYYY" |
|
| “datetime_format”: "DD-MM-YYYY hh:mm:ss" |
|
| “datetime_format”: "DD/MM/YYYY hh:mm:ss" |
|
| “datetime_format”: "YYYY-MM-DD hh:mm:ss" |
|
| “datetime_format”: "YYYY/MM/DD hh:mm:ss" |
|
| “datetime_format”: "DD-MM-YYYYThh:mm:ss.s" |
|
| “datetime_format”: "DD/MM/YYYYThh:mm:ss.s" |
|
| 「datetime_format」: "DD-MM-YYYYThh:mm:ssTZD" |
|
| “datetime_format”: "DD/MM/YYYYThh:mm:ssTZD" |
|
| “datetime_format”: "YYYY-MM-DD hh:mm:ss.s" |
|
| “datetime_format”: "YYYY/MM/DD hh:mm:ss.s" |
|
| “datetime_format”: "YYYY-MM-DDThh:mm:ssTZD" |
|
| “datetime_format”: "YYYY/MM/DDThh:mm:ssTZD" |
|
| “datetime_format”: "YYYY-MM-DDThh:mm:ss.sTZD" |
|
| “datetime_format”: "YYYY/MM/DDThh:mm:ss.sTZD" |
|
言語サポート
UTF-8でデコード可能な文字を使用している限り、任意の言語でデータをインポートできます。
空の値
ファイルに空の値が含まれている場合でも、それらはMoEngageにインポートされます。この場合、値が空のイベント属性を作成/更新します。
配列サポート
- シンプルな配列がサポートされています。ネストされた配列および関連配列はサポートされていません。
- CSVでサポートされている区切り文字は「|」です。
-
サポートされているデータ型は、配列の倍精度（数値）と配列の文字列です。これらのデータ型は、
マップ列を属性にマップ
の
マップ列
セクションのリストから選択できます
ステップ2：インポート設定とアクションを実行します。
-
配列内のすべての要素は同種でなければならず、すなわちそれらはダブルまたは文字列である必要があります。もし同種でない場合、MoEngageは要素を型変換（変換）し、その後データを保存しようとします。以下はCSVフィールド内の配列の例です: [1|2|3]
-
配列の型変換：要素が ["1" | 2 | "abc"] の異なるデータ型を持つ配列があり、定義されたデータ型が Array Double の場合、MoEngage に取り込まれる最終的な配列は [ 1, 2 ] になります。この場合、「abc」はDoubleに変換できない文字列であり、したがって最終配列にMoEngageに取り込まれませんでした。MoEngageにおける型キャストの詳細については、 こちら を参照してください。
現在サポートされていないものは何ですか?
- 属性タイプリストおよびその他の複雑なタイプ（JSON、辞書など）。
- 新しい行文字形式は "\\n" 以外 - .現在、.csvファイルでサポートされている唯一の新しい行文字は "\\n" です。 "Ctrl+M" や "\\r" のような他の形式はサポートされていません。
- ファイルに5行未満のデータが含まれている場合、ファイルのインポート中にエラーが発生する可能性があります。この場合、インポートするためにいくつかのダミー行を追加してください。