手動アップロードは、自動化されたファイルインポートやウェアハウスインポートとはいくつかの点で異なります。
- CSVのみ: JSONはサポートされていません。
- 定期的なスケジュール設定なし: アップロードは即時または特定の日時に実行できますが、定期的なスケジュールでは実行できません。
- Object/JSON (複合) 型は非対応: マッピングはダッシュボードで列ごとに行います。
- ユーザー
- イベント
ユーザーアップロードでは、新しいユーザープロファイルを作成したり、既存ユーザーの属性を更新したりできます。既存ユーザーの更新で新しいユーザーが作成されることはなく、すでにMoEngageに存在するユーザーのみが更新されます。エントリーポイント: Segment > User Imports > Import Users。
ステップ1: CSVをアップロードする
ユーザーリストのタイプを選択し、ファイルをアップロードします。- Registered Users: 登録済みアカウントを持つユーザーです。ファイルには、ID 属性にマッピングされる一意のユーザー識別子の列が含まれている必要があります。
- Anonymous Users: サインアップしていないものの、識別子 (メールアドレス、携帯電話番号など) で認識できるユーザーです。識別子は Anonymous ID 属性にマッピングされます。
識別子がすでにMoEngageに存在する場合、既存ユーザーが新しい属性で更新されます。存在しない場合、MoEngageはその識別子で新しいユーザーを作成します。
ステップ2: 列を設定する
各CSV列をMoEngageのユーザー属性にマッピングします (または新しい属性を作成します)。上位3行 (ヘッダーを除く) とすべての列が表示されます。- 識別子の設定: 登録ユーザーの場合は、1つの列を ID としてマークします。Unified Identity が有効な場合は、追加の識別子もマッピングするオプションがあります。匿名ユーザーの場合は、列を Anonymous ID としてマークします。
- 新しい属性の追加: + をクリックし、一意の属性名を入力します。
- カンマを含む値: カンマを含む値は二重引用符で囲んでください (例:
"221B, Baker Street, London")。囲まない場合、カンマより前のテキストのみがインポートされます。 - 列のスキップ: Skip the column をクリックして列を除外します。Show Skipped Columns を切り替えると、スキップした列を非表示にしたり再度含めたりできます。
列名は大文字と小文字が区別され、ダッシュボード上の属性名と完全に一致する必要があります。イベント、イベント属性、ユーザー属性のプレフィックスとして
moe_ を使用しないでください。これは予約済みのシステムプレフィックスであり、使用すると事前の連絡なしに定期的にブラックリストに登録される可能性があります。インポートの動作
MoEngageにすでに存在するユーザーの属性を一括更新するには、Update existing users only を選択します。そのアップロードから新しいユーザーは作成されず、識別子がMoEngageに存在しない行は無視されます。オフのままにすると、アップロードでユーザーの更新に加えて作成も行われます。インポート通知を送信する
通知をオンにし、インポートの作成、成功、失敗時に通知を受け取る最大 10件のメール受信者 を選択します。マッピングが完了したら、Next をクリックします。ファイルセグメントとして保存する
Save as File Segment をオンにして名前を入力すると、インポートしたユーザーからキャンペーンで使用できるセグメントが作成されます。- 既存のセグメント: ユーザーは追加モードで追加されます。新しいユーザーが追加され、削除されるユーザーはありません。
- 新しいセグメント: 更新モードとして、Replace (各インポートでセグメントのユーザーを完全に置き換え) または Append (各インポートでユーザーを追加し、削除はなし) を選択します。
ステップ3: アップロードをスケジュールする
インポートを実行するタイミングを定義します。- As soon as possible: Done をクリックすると開始されます。
- At specific date and time: 選択した開始日時に実行されます。
インポートされたユーザーのチャネル到達可能性とカスタムセグメントは、インポート完了後 2 時間以内に利用可能になります。それに合わせてキャンペーンを計画してください。
リファレンス
以下の内容は、ユーザーアップロードとイベントアップロードの両方に適用されます。サポートされているデータ型
String、Numeric、Boolean、Datetime、Array (String、Double、Float、Int)。配列のサポート
- 単純な配列がサポートされています。ネストされた配列や連想配列はサポートされていません。
- CSV でサポートされている区切り文字はパイプ（
|）です。例:[1|2|3]。 - サポートされているデータ型は Array String と Array Double（数値）です。列のマッピング時に Map column to attribute リストで型を選択してください。
- 配列内のすべての要素は同種である必要があり、すべて integer/double か、すべて string のいずれかでなければなりません。そうでない場合、MoEngage は各要素を宣言された型に型変換しようと試み、その結果を保存します。
- 配列の型変換: 配列
["1" | 2 | "abc"]を Array Double としてマッピングした場合、"abc"は数値に変換できないため破棄され、MoEngage は[1, 2]を取り込みます。
tagsは Array String としてマッピングされ、MoEngage は["premium", "beta_user", "newsletter"]を取り込みます。scoresは Array Double としてマッピングされ、MoEngage は[4.5, 3.8, 5.0]を取り込みます。
[element1|element2|element3]）。パイプの前後にスペースは入れません。
サポートされている日時フォーマット
Portfolioのサポート (プロジェクトレベルのルーティング)
列のマッピングを使用して、インポートされたイベントを MoEngage のポートフォリオワークスペース内の特定のプロジェクトにルーティングできます。プロジェクト識別子の列（brand_name や app_id など）を MoEngage 属性 moe_project_name にマッピングします。値は MoEngage のプロジェクト名と完全に一致する必要があります（大文字と小文字は区別されます）。
- ルーティング成功: 値がポートフォリオ内のプロジェクトと一致する場合、MoEngage はそのプロジェクトレベルでユーザーまたはイベントを取り込みます。
- フォールバック: マッピングがない、空白である、またはプロジェクト名と一致しない場合、MoEngage はグローバルなポートフォリオレベルでデータを取り込みます。
言語と空の値
MoEngageは、言語と空の値を次のように処理します。- 言語: UTF-8でデコード可能な文字を使用して、任意の言語のデータをインポートできます。
- 空の値: 空の値もインポートされます。MoEngageは空の値で属性を作成または更新します。
制限
手動アップロードには次の制限があります。- ファイルサイズ: CSV 1ファイルあたり150 MB未満。
- 行数: 1つのCSVファイルは、1時間あたりの行数制限までサポートします。1時間あたりの行数制限を超えるファイルは拒否されます。5行未満のファイルはエラーの原因となる場合があるため、必要に応じてダミー行を追加してください。
- 列/属性: ユーザーは100列、イベントは1イベントあたり100列。
サポートされていないもの
手動アップロードは次のものをサポートしていません。- 属性タイプ list およびその他の複合型 (JSON、ディクショナリなど)。
- CSVファイルの複数行サポートはデフォルトで無効になっています。この機能が必要な場合は、サポートにお問い合わせください。
Ctrl+Mや\rなど、\n以外の改行フォーマットはサポートされていません。複数行サポートを有効にすると、インポートの処理速度に悪影響を及ぼす可能性があります。 - JSONファイル。
インポートを管理する
インポートの監視、インポートステータスの理解、手動またはAPI経由での実行のトリガーについては、Imports Overviewのインポートの仕組みを参照してください。よくある質問
インポートが失敗しました。原因を確認するにはどうすればよいですか？
インポートが失敗しました。原因を確認するにはどうすればよいですか？
右側の省略記号をクリックし、View をクリックしてインポートの詳細を確認します。Failed ステータスにカーソルを合わせると、理由を確認できます。
スケジュールされたインポートが、最近アーカイブされたセグメントにデータを追加した場合はどうなりますか？
スケジュールされたインポートが、最近アーカイブされたセグメントにデータを追加した場合はどうなりますか？
その場合でも、新しいデータはアーカイブされたセグメントに追加されます。必要に応じてセグメントのアーカイブを解除できます。
実行中のインポートを停止できますか？
実行中のインポートを停止できますか？
インポート処理が開始されると、途中で停止することはできません。データは複数のステップを経て処理されるため、中断すると不完全または不整合な結果になる可能性があるからです。現在のインポートが完了するまで待つことをお勧めします。
スケジュールされたインポートの今後の実行を停止するにはどうすればよいですか？
スケジュールされたインポートの今後の実行を停止するにはどうすればよいですか？
はい、スケジュールされたインポートが今後自動的に実行されないように停止できます。そのためには、Data Imports ダッシュボードでインポートスケジュールを見つけ、Actions メニューから Archive オプションを選択します。これにより、次回のスケジュール時刻に実行されなくなります。
インポートが停止しているように見える、または時間がかかっている場合はどうすればよいですか？
インポートが停止しているように見える、または時間がかかっている場合はどうすればよいですか？
インポートが停止しているように見える場合や、通常より時間がかかっている場合は、待つことをお勧めします。システムにはこうした状況を自動的に処理し、必要に応じて再試行するチェック機能が備わっています。処理中に同じインポートを手動で再度開始すると、競合が発生し、元のインポートが正常に完了しなくなる可能性があります。