Overview

MoEngageは、顧客がS3バケット内に保存されたファイルを通じてユーザーとイベントをインポートできるようにします。

輸入の種類

MoEngage は、あなたの S3 バケットから以下をインポートできます:

1. 登録ユーザー : MoEngageに既に登録されているユーザー。
2. 匿名ユーザー : MoEngageにまだ登録されていないユーザー。
3. イベント （標準およびユーザー定義）：MoEngageは、キャンペーンインタラクションイベントやユーザー定義イベントなどの標準イベントをインポートできます。
4. 補助データ : 一時的に追加されたユーザー。

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

サポートされているファイルタイプ、命名規則、およびファイル構造に関する情報は、 ファイルインポートヘルプドキュメント を参照してください。ファイルの準備ができたら、それらをS3バケット内のフォルダーに置いてください

フォルダー構造

インポートを設定する際にフォルダーパスを構成する必要があります。すべてのファイルをAmazon S3フォルダーに配置してください。

MoEngageはサブフォルダー内のファイルを探しません。

必要なアクセス権限

新しいポリシーを作成して、MoEngageがバケットにアクセスし、ファイルを正しくインポートできるようにする必要があります。MoEngageは以下の権限を要求しています：

1. s3:Get* - これは、ファイルをダウンロードするために必要な権限を付与します。
2. s3:List* - これは、ファイルを表示およびリストするために必要な権限を付与します。

新しいポリシーを作成する

新しいポリシーを作成するには、次の手順を実行します：

1. ナビゲーションバーの ポリシー タブに移動します。
2. クリックして 開始する を選択し、その後 ポリシーを作成 をクリックします。
   これにより、ユーザーの権限を追加できます。
   
3. 「 独自のポリシーを作成 」を選択します。
   これにより、MoEngageは指定したバケットにのみアクセスできる限られた権限が与えられます。

自分のポリシーを作成する際に、以下のコードを入力してください。自分の選択した「ポリシー名」を指定し、以下のコードを「ポリシードキュメント」セクションに入力します。 <INSERTSID> をステートメントIDに、 <INSERTPOLICYID> をポリシーIDに、 <INSERTBUCKETNAME> をバケット名に置き換えることを忘れないでください。また、Principalも置き換えてください（アクセスキーIDとアクセスシークレットキーがこのユーザー/アカウントに属していることを確認してください）。

{
    "Version": "2012-10-17",
    "Id": <INSERTPOLCIYID>,
    "Statement": [
        {
            "Sid": <INSERTSID>,
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::<ACCOUNTID>:<USER>/<USERNAME>"
            },
            "Action": [
                "s3:Get*",
                "s3:List*"
            ],
            "Resource": [
                "arn:aws:s3:::<INSERTBUCKETNAME>/*",
                "arn:aws:s3:::<INSERTBUCKETNAME>"
            ]
        }
    ]
}

ポリシーの作成方法についての詳細は こちら をご覧ください。

S3からのインポートを設定

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

1. MoEngageダッシュボードの左側のナビゲーションメニューで、 データ > データインポート をクリックします。
2. 右上隅の + インポート をクリックし、 ユーザー または イベント を選択して新しいインポートを作成します。
   
3. クリックして S3 タイルを選択してください。
4. クリックして 続行 します。
   

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

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

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

ユーザーインポート イベントインポート

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

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

選択したイベントに基づいて、ファイル名が異なります。ファイル名は、選択したイベントのイベント名で始まる必要があります。「 イベントを選択 」リストには、MoEngageがアプリの利用可能なすべてのイベントの名前を表示します。これらのイベントのいくつかは、異なる表示名とイベント名を持つ場合があります。イベントにカーソルを合わせると、MoEngageはその特定のイベントに対して期待されるファイル名を表示します

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

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

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

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

Add your S3 Credentials

この最初のステップでは、 ソースとフォーマット 、MoEngageを指定し、使用するS3接続とインポートするテーブルを指定する必要があります。 始めるには、次の詳細を提供してください：

ファイル設定

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

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

S3の資格情報と選択したファイル形式が正しい場合、MoEngageは最近のファイルからの上位5行のプレビューを表示します：

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

• 指定されたS3アクセスキーは無効です : これは、あなたのS3認証情報が正しくないことを示しています。正しい認証情報を入力し、再度ファイルを取得してみてください。
• フォルダーパスを確認して、再試行してください : これは、フォルダーパスが正しくないか、指定されたフォルダーパス内にCSVまたはJSONファイルが存在しないことを示しています。
• ファイルにデータ行がゼロ件見つかりました : これは、取得したファイルがヘッダー以外に行を含まない（CSVファイルの場合）か、完全に空であったことを示しています。MoEngageは、CSVファイルに対して少なくとも2行（1つのヘッダー + 1つのデータ行）を、またはJSONファイルに対して少なくとも1つのデータ行を必要とします。詳細については、 ファイル構造 を参照してください。

ファイルのプレビューに満足したら、次へ進むには「次へ」をクリックしてください。

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

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

In the Map Columns section, you have the following:

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

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

ユーザーのインポート

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

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

新しいオブジェクト属性は、 + 新しい属性を作成 をクリックすることで作成できます。これは、 マップ属性 マッピングセクションの 属性を選択 リストの下にあります。

属性に名前を付け、そのデータ型を選択します。このページから、 データ管理 の既存の属性を編集できます。新しく作成した属性は、最初の成功したインポートの後にアプリで利用可能であることに注意してください。

フィールドを追加

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

マニフェストファイル

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

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

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

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

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

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

インポート通知を送信する

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

1. 送信インポートステータスを チェックボックスを選択してください。
2. メールIDを選択 リストから、メールIDを選択します。ステータスメールを送信するために最大10件のメールを選択できます。
   
   

   インポートステータスメールには、以下のイベントに関する情報が含まれています：

   • • インポートが作成されました
     • インポートが成功しました
     • インポートが失敗しました
3. すべてのマッピングが完了したら、 次へ をクリックします

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

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

MoEngageは次の種類のインポートをサポートしています：

• 一回限りのインポート : できるだけ早くインポートを実行するか、後で日付と時刻を指定して実行することができます。
• 定期的 : インポートを毎時、毎日、毎週、または毎月実行することができ、間隔や高度な設定も可能です。

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

重複インポート

重複インポートは、次の条件の場合に考慮されます:

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

FAQ