CSVを使用してユーザーデータをインポート

ユーザーインポートを使用すると、CSVファイルを通じて新しいユーザープロファイルをインポートしたり、既存のユーザーのプロフィールデータを更新したりできます。これは、他のプラットフォームからMoEngageに移行する際や、大規模なユーザーセグメントに対して一括更新を行う際に特に便利です。これが役立つ一般的なシナリオは以下に示されています:

  • 新しいユーザーをインポートする - これは、モバイル/Web SDKの統合を待つことなく、メールキャンペーンおよびSMSキャンペーンをすぐに開始するのに便利です。
  • 既存のユーザーを更新する - これにより、MoEngage内の既存のユーザーに対して特定のユーザー属性を更新することができます。これは、ユニークなクーポンコードを含む通知を送信するなど、これらのユーザー属性に基づいてセグメント化またはパーソナライズされたキャンペーンを実行している場合に便利です。既存のユーザーを更新しても、新しいユーザーは追加されません。既存のユーザーのみが更新されます。
info

Note

この機能はCSVファイルを介したユーザーインポートのみをサポートしています。JSONファイルはサポートされていません。

この機能は セグメント -> ユーザーのインポートからアクセスできます。 -> ユーザーをインポート。

USERIMPORTS.png

以下のステップバイステップのプロセスでは、ユーザーをMoEngageプラットフォームにインポートする方法を説明します。

ステップ 1: ユーザーの CSV リストをアップロードする

ユーザーをインポートするための最初のステップは、ユーザーの詳細を含む .CSV ファイルをアップロードすることです。MoEngage では、ユーザーリストをログインユーザーのリスト(あなたのウェブサイトやアプリにサインアップしたユーザー)として、または匿名ユーザーのリスト(アプリやウェブサイトを使用/訪問したが、自分自身を登録していないユーザー)としてインポートすることができます。これらの 2 つのユーザーリストタイプについては、以下で詳しく説明します。

  • 登録ユーザー: これらは、あなたのアプリ/ウェブサイトに登録されたアカウントを持つユーザーです。これらのユーザーは、システム内で一意の識別子を持っている必要があり、このアップロードでは、必ずこの一意のユーザー識別子を含む列を「ID」というユーザー属性にマッピングする必要があります。このアップロードは、主にこれらの登録ユーザーのユーザー属性を更新するために使用されます。
  • 匿名ユーザー: これらは、まだあなたのアプリ/ウェブサイトにサインアップしていないユーザーですが、彼らを認識するための識別子(メール、携帯電話番号など)を持っています。このアップロードタイプでは、リストの列(メール、携帯電話番号など)をユーザーの「匿名ID」としてマークする必要があります。このアップロードは、認識可能なユニーク識別子を使用してMoEngageで匿名ユーザーを作成し、メール/SMSキャンペーンを送信するために使用できます。

CreateImport.png

アップロードごとに、CSVファイルで期待されるデータ形式を明確に説明したサンプルファイルをダウンロードすることもできます。実行したいアップロードタイプを選択したら、「参照」ボタンをクリックして、好みの.csvファイルを選択できます。また、上の画像に示されたエリアにファイルをドラッグアンドドロップすることもできます。

さらに、ファイルにヘッダーが含まれているか、既存のユーザーの詳細のみを更新したいかを、それぞれのオプションを選択することで指定できます。ファイルのアップロードが成功裏に完了したら、「次へ」ボタンをクリックして次のステップを実行できます。

info

Note

ログインユーザー(または匿名ユーザーの匿名識別子)のユニーク識別子を提供する場合、システムに既に存在するユーザーは新しい属性で更新されます。識別子が存在しない場合、MoEngageはその識別子を持つ新しいユーザーを作成します。

ステップ2:CSVファイルの列を設定する

ユーザー属性のマッピング

このステップでは、アップロードしたCSVファイルの各列を既存のユーザー属性にマッピングする必要があります(または新しいユーザー属性を作成します)。ヘッダーを除いた上位3行とCSVファイルのすべての列が表示されます(すべての列を見るには水平方向にスクロールしてください)。各列について、ドロップダウンからユーザー属性を選択してください。

CreateIMport_Step2.png

info

Note

  • 列名は大文字と小文字を区別します。ダッシュボードの属性の名前と正確に一致する必要があります。
  • イベント、イベント属性、またはユーザー属性の名前を付ける際に「moe_」をプレフィックスとして使用することはできません。これはシステムプレフィックスであり、使用すると事前の通知なしに定期的なブラックリスト入りの可能性があります。

識別子の設定

ログインしているユーザーの場合、ドロップダウンから ID を選択することで、必ず1つの列をユーザーのユニーク識別子として特定する必要があります。

CreateIMport_Step_2.png

匿名ユーザーの場合、列の上にカーソルを合わせてチェックボックス 匿名ID を選択することで、任意の列を匿名識別子として特定できます。

CreateIMport_Step_2_1.png

新しいユーザー属性の追加

ユーザーに追加する新しい属性の列がある場合は、「+」をクリックして属性の名前を入力します。既存の属性のいずれかと同じ新しい属性名の場合は、新しい名前を入力する必要があります。

カンマで値を追加する

いずれかの列の値にカンマ(,)が含まれている場合は、その値が複数の列に分割されないように、値が二重引用符("")で囲まれていることを確認してください。例えば、列に値 (221B ベイカー街、ロンドン) が含まれている場合、それは 二重 引用符で囲まれるべきです ("221B, ベイカー街、ロンドン").他の形式では、与えられた列に対しては「,」の前のデータのみが考慮されます。

サポートされているデータタイプ

ファイル内の列値にサポートされているデータ型は次のとおりです:

  • 文字列
  • 数値
  • ブール
  • 日時
  • 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"
  • 2022-01-22
“datetime_format”: "YYYY/MM/DD"
  • 2022/01/22
“datetime_format”: "DD/MM/YYYY"
  • 22/01/2022
“datetime_format”: "DD-MM-YYYY"
  • 22-01-2022
“datetime_format”: "DD-MM-YYYY hh:mm:ss"
  • 31-12-2022 12:10:33
“datetime_format”: "DD/MM/YYYY hh:mm:ss"
  • 31/12/2022 12:10:33
“datetime_format”: "YYYY-MM-DD hh:mm:ss"
  • 2019-02-22 17:54:14
“datetime_format”: "YYYY/MM/DD hh:mm:ss"
  • 2019/02/22 17:54:14
“datetime_format”: "DD-MM-YYYYThh:mm:ss.s"
  • 31-12-2022T12:10:33.882
“datetime_format”: "DD/MM/YYYYThh:mm:ss.s"
  • 31/12/2022T12:10:33.882
“datetime_format”: "DD-MM-YYYYThh:mm:ssTZD"
  • 31-12-2022T12:10:33Z
  • 31-12-2022T12:10:33+08:00
  • 31-12-2022T12:10:33-08:00
“datetime_format”: "DD/MM/YYYYThh:mm:ssTZD"
  • 31/12/2022T12:10:33Z
  • 31/12/2022T12:10:33+08:00
  • 31/12/2022T12:10:33-08:00
“datetime_format”: "YYYY-MM-DD hh:mm:ss.s"
  • 2019-02-22 17:54:14.933
“datetime_format”: "YYYY/MM/DD hh:mm:ss.s"
  • 2019/02/22 17:54:14.933
“datetime_format”: "YYYY-MM-DDThh:mm:ssTZD"
  • 2019-11-14T00:01:02Z
  • 2019-11-14T00:01:02+08:00
  • 2019-11-14T00:01:02Z-08:00
“datetime_format”: "YYYY/MM/DDThh:mm:ssTZD"
  • 2019/11/14T00:01:02Z
  • 2019/11/14T00:01:02+08:00
  • 2019/11/14T00:01:02-08:00
“datetime_format”: "YYYY-MM-DDThh:mm:ss.sTZD"
  • 2019-02-22T17:54:14.957Z
  • 2019-02-22T17:54:14.957299-08:00
  • 2019-02-22T17:54:14.957299+08:00
“datetime_format”: "YYYY/MM/DDThh:mm:ss.sTZD"
  • 2019/02/22T17:54:14.957Z
  • 2019/02/22T17:54:14.957299-08:00
  • 2019/02/22T17:54:14.957299+08:00

言語サポート

UTF-8でデコード可能な文字を使用していれば、任意の言語でデータをインポートできます。
空の値

ファイルに空の値が含まれている場合でも、これらはMoEngageにインポートされます。この場合、値が空のユーザー属性を作成/更新します。

スキップする列

列をスキップする必要がある場合は、「列をスキップ」をクリックするだけで、その列を設定する必要がなくなります。スキップした列を隠すには、設定の下にある「スキップした列を表示」のチェックボックスの選択を解除できます。

Screen_Shot_2017-04-05_at_3.01.27_PM.png

スキップされた列を再度含めたい場合は、「スキップされた列を表示」チェックボックスを選択し、その列の「含めて設定」をクリックしてください。

ファイルセグメントの作成

インポートされたユーザーのために、ユーザーインポートワークフロー自体の中でファイルセグメントを作成できます。これは、「ファイルセグメントとして保存」トグルを選択し、ファイルセグメントの名前を提供することで達成できます。成功裏に完了すると、このカスタムセグメントはファイルセグメントのリストに表示され、キャンペーンで使用できるようになります。

SaveFileSegment.png

クリックして 完了 を選択すると、データがアップロードされます。すべてのインポートのリストと、そのステータスがアップロードが処理されたかどうかを示します。アップロードが処理されると、アップロードの詳細を記載したメールが届きます。 注意 : ファイルセグメント名に / Unicode 文字を使用することはできません。そうしないと、インポートに失敗します。

ステップ3: インポートのスケジューリング

このステップでは、ファイルをインポートするタイミングを定義する必要があります。MoEngageは以下の種類のインポートをサポートしています:

  1. できるだけ早く : ファイルは、 完了 をクリックするとすぐにインポートが開始されます。
  2. 特定の日付と時刻 : 選択した 開始日 開始時刻 に基づいてインポートを実行することができます。

Step3.png

過去の輸入

最初のユーザーインポート後、アカウント内の過去のインポートとその詳細を表示するセクションが表示されます。

info

情報

インポートの完了後、チャンネルの到達性とインポートされたユーザーのカスタムセグメントは、30分後に利用可能になります。これに従ってキャンペーンを計画することをお勧めします。

配列サポート

  • シンプルな配列がサポートされています。ネストされた配列および関連配列はサポートされていません。
  • CSVでサポートされている区切り文字は「|」です。
  • サポートされているデータ型は、配列ダブル(数値)と配列文字列です。これらのデータ型は、 属性にマップする列 の下にあるリストで選択できます 列をマップ セクションで、 ステップ2: インポート設定とアクションを実行します。

  • 配列内のすべての要素は均一でなければなりません。つまり、それらは整数または文字列のいずれかでなければなりません。均一でない場合、MoEngageは要素を型変換(変換)し、その後データを保存しようとします。以下はCSVフィールド内の配列の例です: [1|2|3]
  • 配列の型キャスト: 要素が["1" | 2 | "abc"]の異なるデータ型を持つ配列があり、定義されたデータ型が配列整数である場合、MoEngageに取り込まれる最終的な配列は[ 1, 2 ]です。この場合、「abc」は整数に変換できない文字列であり、したがって最終配列にMoEngageに取り込まれませんでした。MoEngageにおける型変換の詳細については、 こちら を参照してください。

現在サポートされていないものは何ですか?

  • 属性タイプ リスト およびその他の複雑なタイプ(JSON、辞書など)。
  • 新しい行文字形式は「\\n」以外 - .csvファイルで現在サポートされている唯一の新しい行文字は「\\n」です。「Ctrl+M」や「\\r」などの他の形式はサポートされていません。
  • ファイルに5行未満のデータが含まれている場合、ファイルのインポート中にエラーが発生する可能性があります。このケースにインポートするためにダミー行をいくつか追加してください。

この記事は役に立ちましたか?
4人中0人がこの記事が役に立ったと言っています

How can we improve this article?