Skip to main content

​
概要

MoEngage では、S3 バケット内に保存されたファイルを使用して、ユーザーとイベントをインポートできます。

​
インポートの種類

MoEngage は、S3 バケットから次のものをインポートできます。
  1. Registered Users: MoEngage にすでに登録されているユーザーです。
  2. Anonymous Users: MoEngage にまだ登録されていないユーザーです。
  3. Events（標準およびユーザー定義）: MoEngage は、Campaign Interaction Events などの標準イベントと、独自のユーザー定義イベントの両方をインポートできます。
  4. Auxiliary Data: 一時的に追加されるユーザーです。

​
ファイルの準備

サポートされているファイルタイプ、命名規則、ファイル構造などについては、File Imports ヘルプドキュメントを参照してください。ファイルの準備ができたら、S3 バケット内のフォルダーに配置する必要があります。

​
フォルダー構造

すべてのファイルを Amazon S3 フォルダーに配置します。フォルダーパスはインポートの設定時に構成できます。 FolderStructure.png MoEngage はサブフォルダー内のファイルを検索しないことに注意してください。

​
必要なアクセス権限

MoEngage がバケットにアクセスしてファイルを正しくインポートできるよう、新しいポリシーを作成する必要があります。次の権限をリクエストします。
  1. s3:Get\* - ファイルのダウンロードに必要な権限を付与します。
  2. s3:List\* - ファイルの表示と一覧表示に必要な権限を付与します。

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

ナビゲーションバーの Policies タブに移動し、“Get Started”、“Create Policy” の順に選択します。これにより、ユーザーに権限を追加できます。“Create Your Own Policy” を選択します。これにより権限が制限され、指定したバケットにのみアクセスできるようになります。 独自のポリシーを作成する際に、以下のコードを入力します。任意の “Policy Name” を指定し、以下のコードを “Policy Document” セクションに入力します。 を Statement ID に、 を Policy ID に、“ をバケット名に必ず置き換えてください。Principal も置き換えてください（アクセスキー ID とシークレットアクセスキーがこのユーザー/アカウントに属していることを確認してください）。 JSON PROTECTED_54 ポリシーの作成方法の詳細については、PROTECTED_30 を参照してください。

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

PROTECTED_0 S3 インポートを設定するには、次の手順を実行します。
  1. MoEngage のサイドバーメニューで、Data メニュー項目 PROTECTED_2 にカーソルを合わせます。Data メニューが表示されます。
  2. Data imports をクリックします。
    PROTECTED_3
  3. Data imports ページで、+ Import をクリックし、Users または Events を選択して新しいインポートを作成します。
    PROTECTED_4
  4. S3 をクリックして、Users（次のステップで Registered/Anonymous を選択できます）または Events の新しいインポートを作成します。
    PROTECTED_5

​
ステップ 1: S3 認証情報とファイル形式を設定する

​
User Imports

Registered users と Anonymous users のどちらをインポートするかを選択できます。 PROTECTED_6 インポートするものを選択します。登録ユーザーのインポートと匿名ユーザーのインポートでは、想定されるファイル名が異なります。詳細については、PROTECTED_31 セクションを参照してください。

​
Event Imports

Event インポートの場合、インポートするイベントを選択できます。 PROTECTED_7 選択したイベントによって、ファイル名が異なります。ファイル名は、選択したイベントの Event Name で始まる必要があります。“Select event” ドロップダウンには、MoEngage アプリで利用可能なすべてのイベントの Display Name が表示されます。これらのイベントの中には、Display Name と Event Name が異なるものがあります。イベントを選択すると、そのイベントに対して想定されるファイル名が Event Description ボックスに表示されます。 PROTECTED_8 上の例では、“App/Site Opened” が選択したイベントの Display Name で、その Event Name は MOE_APP_OPENED です。そのため、ファイル名は MOE_APP_OPENED で始まる必要があります。詳細については、PROTECTED_32 セクションを参照してください。 ドロップダウンの最後にある ”+ Create event” オプションをクリックして、新しいイベントを作成することもできます。 PROTECTED_9 イベントに一意の名前を付けます。デフォルトでは、Display Name は Event Name と同じになります。PROTECTED_33 ページに移動すると、このイベントやその他の MoEngage イベントを表示または編集できます。ここで作成した新しいイベントは、最初のインポートが成功した後にのみアプリで利用可能になることに注意してください。

​
S3 認証情報の追加

この最初のステップ “Source and format” では、MoEngage が S3 バケットに接続する方法と、ファイルを検索する場所も指定する必要があります。 PROTECTED_10 これらのフィールドの入力方法については、以下の表を参照してください。

​
インポート名

PROTECTED_16 Imports Dashboard で簡単に識別できるよう、このインポートの名前を入力します。

​
ファイル設定

PROTECTED_17 ファイル名に含まれる DateTime 形式を選択します。上記で定義した PROTECTED_46 に従い、ファイル名は _.csv で終わる必要があります。サポートされている DateTime 形式については、前述の表を参照してください。以下の情報メッセージは選択した DateTime 形式に応じて更新されるため、ファイル名が想定どおりかどうかを簡単に照合できます。 S3 認証情報とファイル名の形式を設定すると、MoEngage は S3 バケットへの接続を試み、指定された形式で利用可能な最新のファイルを取得します。指定した場所に少なくとも 1 つのファイルがあることを確認してください。ファイルがない場合は続行できません。準備ができたら、“Fetch file” ボタンをクリックして最新のファイルを取得します。 S3 認証情報と選択したファイル形式が正しい場合、MoEngage は最新のファイルの上位 5 行のプレビューを表示します。 FilePreviewSuccess.png ただし、S3 バケットからファイルを取得する際にエラーが発生する場合があります。一般的なエラーは次のとおりです。
  • Given S3 Access Key is not valid - S3 認証情報が正しくないことを意味します。正しい認証情報を入力して、もう一度ファイルを取得してください。
  • Please check the folder path and try again - フォルダーパスが正しくないか、指定されたフォルダーパス内に CSV ファイルが存在しないことを意味します。
  • Found zero data rows in the file - MoEngage が取得したファイルのヘッダー行の後に行がない（ファイルの合計行数が 1）ことを意味します。最初の行は常にヘッダー行として扱われるため、ファイルには少なくとも 2 行（ヘッダー行 1 行 + データ行 1 行）が必要です。詳細については、File Structure を参照してください。
ファイルのプレビューに問題がなければ、Next をクリックしてマッピングのステップに進みます。

​
ステップ 2: 列を MoEngage の属性にマッピングする

このステップでは、CSV ファイルの列を MoEngage に存在する属性にマッピングする必要があります。すべての列が縦に並んで表示されます。 Step2.png
  1. Column name - マッピングする列名です（前のステップで取得したファイルの最初の行から取得されます）。列名の下には、参考としてサンプル値（前のステップで取得したファイルの 2 行目から取得されます）も表示されます。
  2. Map attribute - CSV の列をマッピングする MoEngage の属性を選択する必要があります。新しい属性を作成することもできます。一部の属性は複数のデータタイプからの取り込みをサポートしているため、列のデータタイプも選択する必要があります。“DateTime” 列の場合は、形式も選択する必要があります。
  3. More actions - 必要に応じて、列をスキップすることもできます。スキップした列はインポートされません。
インポートの種類に応じて、いくつかの必須マッピングがあります。
  1. User imports - 次の内容を含む列を選択する必要があります。
    1. Registered -
      1. User ID - ファイルには、一意のユーザー識別子（システム内のユーザーアカウントを識別するもの）を含む列が必須です。
    2. Anonymous -
      1. Anonymous ID - ファイルの列（メールアドレス、携帯電話番号など）を、これらのユーザーの識別子としてマークする必要があります。
  2. Event imports - 次の内容を含む列を選択する必要があります。
    1. User ID - この列は、MoEngage のユーザーと CSV ファイルを照合するために使用されます。
    2. Event Time - Event Time (UTC) または Event Time (App Timezone) のいずれかをマッピングする必要があります。Event Time (UTC) を選択した場合、インポートされたイベントの “Event Time” は、MoEngage Dashboard の設定で選択されたタイムゾーンに変換されます: AppTimezone.png
必須マッピングを指定すると、マッピングテーブルの列名に反映され、その列をスキップ可能としてマークできなくなります。 MappingIdentifier.png 新しいイベントと同様に、ドロップダウンから ”+ Create attribute” をクリックして新しい属性を作成することもできます。 CreateNewAttribute.png 属性に名前を付け、Data type を選択します。この属性や既存の属性は、Data Management ページで編集できます。ここで作成した新しい属性は、最初のインポートが成功した後にのみアプリで利用可能になることに注意してください。

​
フィールドの追加

+Add Field をクリックして、ダッシュボードから直接フィールドを追加することもできます。これにより、リストの下部に新しいフィールドが作成され、属性のマッピングを手動で入力できます。 AddField (1).png

​
Manifest ファイル

必要に応じて、manifest ファイルをアップロードして、これらの列を自動マッピングすることもできます。 manifest ファイルをアップロードするには、マッピングテーブルの右上にある “Upload mapping file” オプションをクリックします。 UploadMapping.png 新規インポートの場合は、サンプルの manifest ファイルを確認できます。これは、インポートに適したマッピングファイルを作成する際の参考として使用できます。 既存のインポートを複製してマッピングファイルをアップロードする場合は、既存のマッピングファイルがすでに追加されており、ダウンロードできます。 UploadMapping_1.png manifest ファイルをアップロードし、Done をクリックします。マッピングがそれに応じて自動的に設定されます。manifest ファイルに記載されているものの MoEngage に現在存在しない追加の属性がある場合は、モーダルが開き、これらの属性が一覧表示されるので、属性を作成できます。 CreateNewAttributes.png manifest ファイルには存在するものの CSV ファイルには存在しない追加の列は無視されます。また、既存の CSV 列のマッピングが manifest ファイルに存在しない場合、MoEngage はマッピングを空白のままにするため、手動で設定できます。 manifest ファイル内の列が存在しない MoEngage 属性にマッピングされている場合、マッピングは空白になります。その場合は、まず UI から新しい属性を手動で作成してから、マッピングする必要があります。

​
インポート通知の送信

ImportStatus.png 必要に応じて、インポートのステータスについてメールで通知を受け取ることができます。ステータスメールの送信先として最大 10 件のメールアドレスを選択します。次の場合にメールが届きます。
  1. インポートが成功した場合。
  2. インポートが失敗した場合（考えられる失敗の原因も記載されます）。
すべてのマッピングに問題がなければ、Next をクリックします。エラーがある場合は、修正してから先に進んでください。

​
ステップ 3: インポート頻度を選択する

Frequency.png このステップでは、S3 バケットからファイルをインポートするタイミングを定義する必要があります。次のタイプのインポートがサポートされています。
  1. One-Time Imports: インポートをできるだけ早く実行するか、後の日時に実行する（スケジュール）かを選択できます。
  2. Periodic: インポートを毎時、毎日、毎週、毎月、または間隔や詳細設定を使用して実行するよう選択できます。
各実行で、MoEngage は設定された DateTime 形式のファイルを取得しようとするため、ファイル名が適切に設定されていることを確認してください。必要に応じて、指定した回数の実行後、または特定の日付にインポートを終了するかどうかを指定できます。準備ができたら “Done” をクリックします。

​
重複インポート

一度に設定できる一意のインポートは 1 つのみです。次のすべてが同じ場合、そのインポートは重複インポートと見なされます。
  1. Import Type - Users / Events
  2. Import Sub-Type - Event Name / Registered / Anonymous - イベント名が同じ場合、または同じ S3 パスとバケット名を持つ登録/匿名ユーザーのインポートがすでに存在する場合。
  3. S3 Folder Path
  4. Bucket Name
上記のいずれか 1 つでも異なれば、そのインポートは一意と見なされます。

​
よくある質問

右側の省略記号をクリックし、View をクリックしてインポートの詳細を確認します。Failed ステータスにカーソルを合わせると、理由を確認できます。
デフォルトでは、失敗した場合にインポートは再試行されません。ただし、失敗時にメールアラートを受け取るよう設定できます。
このような場合でも、新しいデータはアーカイブされたセグメントに追加されます。必要に応じてセグメントのアーカイブを解除できます。
特定のワークスペースのスケジュールされた実行では、MoEngage はファイル名のプレフィックスに基づいて S3/SFTP フォルダー内で識別されたすべての新しいファイルを取得し、処理します。特定の MoEngage ワークスペースのデータインポートでは、フォルダーの場所とファイル名の組み合わせによってこれらのファイルを一意に識別します。
いいえ。一度処理されたファイルは、ファイル名が同じで同じフォルダーの場所にある場合、再度処理されることはありません。ただし、同じファイルが別のフォルダーの場所にも配置されている場合、新しいフォルダーの場所を設定した MoEngage の新しいデータインポートでそのファイルが取得されます。
いいえ。MoEngage ワークスペースのダッシュボードでは、データインポートをユーザーデータとイベントデータで個別に設定する必要があります。そのため、ファイルにはユーザー属性データまたはイベントデータのいずれかを含める必要があります。
インポートプロセスが開始されると、途中で停止することはできません。これは、データがいくつかのステップを経て処理されるため、中断すると結果が不完全または不整合になる可能性があるためです。現在のインポートは完了させることをお勧めします。
はい、今後スケジュールされたインポートが自動的に実行されないよう停止できます。これを行うには、Data Imports ダッシュボードでインポートスケジュールを見つけ、Actions メニューから “Archive” オプションを選択します。これにより、次回のスケジュール時刻に実行されなくなります。
インポートが停止しているように見える場合や、通常より時間がかかっている場合は、待つことをお勧めします。システムにはこのような状況を自動的に処理するチェック機能があり、必要に応じて再試行します。処理中に同じインポートを手動で再度開始すると、競合が発生し、元のインポートが正常に完了しなくなる可能性があります。