はじめに

MoEngageは、顧客がS3バケットやSFTPサーバーなどのさまざまなソースに保存されたファイルを通じてユーザーとイベントをインポートできるようにします。また、データウェアハウス内のテーブルから直接インポートすることもできます。MoEngageダッシュボードでは、ファイルの場所を定義し、1つ以上のファイルインポートソースとインポート方法を構成することによって、複数のインポートを直接設定できます。

サポートされているソース

MoEngageは現在、以下のファイルのインポートをサポートしています:

1. Amazon S3 バケット
2. SFTPサーバー

MoEngageはデータウェアハウスからのインポートもサポートしています:

1. Snowflake Imports
2. Databricks Imports

輸入の種類

MoEngageは、あなたのソースから以下をインポートできます：

1. 登録ユーザー : これは、MoEngageにすでに登録されているユーザーです。このタイプのインポートを使用して、既存のユーザーを一括で更新することもできます。
2. 匿名ユーザー : これらはMoEngageに登録しなければならないユーザーです。
3. イベント （標準およびユーザー定義）：MoEngageは、キャンペーンインタラクションイベントなどの標準イベントと、あなた自身のユーザー定義イベントをインポートできます。
4. 補助データ : 特定のビジネス目的のために、一時的にMoEngageに取り込まれたユーザーデータがあります。

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

MoEngage ダッシュボードでインポートを設定する前に、すべてのファイルが期待される形式であり、許可された制限内にあることを確認してください。

サポートされているファイルタイプ

すべてのファイルはUTF-8ファイルエンコーディングである必要があります。

命名規則

ファイル名は2つの部分で構成されています: <import type>_<date time format> .<file_extension> 。最終的な名前は、インポートの種類と選択した日付時刻形式によって異なります。

インポートタイプ

• 登録ユーザー
  • ファイル名は接頭辞 registered_user_data_ で始まる必要があります
  • registered_user_data_01311997.csv または registered_user_data_01311997.json
• 匿名ユーザー
  • ファイル名はプレフィックスから始める必要があります anonymous_user_data_
  • anonymous_user_data_jan_2022.csv または anonymous_user_data_jan_2022.json
• イベント
  • ファイル名はプレフィックスで始まる必要があります _
  • 特定のケースでは、イベント名と表示名が異なる場合があります。イベントを管理するには、MoEngageの データ管理 ページに移動してください。
  • 例えば、イベント名が「Purchase Summary」の場合: Purchase_Summary_31011997.csv または Purchase_Summary_31011997.json
  • 例えば、イベント名が "Purchase_Transaction" の場合： Purchase_Transaction_1997 0131_1259 .csv または Purchase_Transaction_19970131_1259.json

日付時刻形式

ファイル名は、サフィックス <date time format>.<file extension> で終わる必要があります。この「日付-時間」は、インポートが実行される日を表します。たとえば、インポートが「2022年1月7日」に実行され、選択された日付-時間形式が ddmmyyyy の場合、MoEngageはサフィックス 07012022.csv または 07012022.json で終わるすべてのファイルを探します。

MoEngageは複数の日付時刻形式をサポートしています：

インポートを設定する際に、MoEngage ダッシュボードでファイル名の日時形式を構成できます。

有効なファイル名の例

以下は有効なファイル名の例です：

• 登録ユーザーは、日付時刻形式 {yyyymmdd}_{hhmm} のファイル名を持ちます。例えば、 registered_user_data_20220131_1259.csv または registered_user_data_20220131_1259.json
• 匿名ユーザーのインポートは、日付時刻形式 {mon_yyyy} で、ファイル名は anonymous_user_data_feb_2022.csv または anonymous_user_data_feb_2022.json のようになります。
• アイテム購入イベントのインポートは、日付時刻形式 {ddmmyyyy} で、ファイル名はアイテム Purchased_31012022.csv または Purchased_31012022.json のようになります。

ファイル構造

MoEngageはCSVおよびJSONファイルからのデータのインポートをサポートしています。あなたのファイルは以下のルールに従う必要があります：

{"user_id": "user123", "name": "John Doe", "email": "john.doe@example.com", "address": {"city": "New York", "zip": "10001"}}
{"user_id": "user124", "name": "Jane Smith", "email": "jane.smith@example.com", "address": {"city": "Los Angeles", "zip": "90001"}, "preferences": ["email_updates", "sms_alerts"]}
          

{
"Level 1 item-id": 123,
"Level 1 item-type": "books",
"Level 1 item-cost": {
"Level 2 amount": {
"Level 3 cost-price": 100,
"Level 3 discount": 0
},
"Level 2 currency": "USD"
}
}

各種インポートタイプについて、MoEngageでは必須属性にマッピングできる列を持つ必要があります：

1. 登録ユーザーのインポート: あなたのファイルには、ユーザーID（MoEngageのユーザープロファイルを識別するためのユーザー識別子）にマッピングできる列が必要です。
2. 匿名ユーザーのインポート: あなたのファイルには、匿名IDにマッピングできる列（メール、モバイルなど）が必要です。メールアドレスやモバイルなどの匿名IDは、アプリやウェブサイトを利用したがまだサインアップしていないユーザーを特定するのに役立ちます。
3. イベントインポート: ファイルにはイベント時間とユーザーIDのための別々の列が必要です。

マニフェストファイル

マニフェストファイルには、ソース列とMoEngage属性とのマッピングが含まれています。それは列のデータ型も含まれています。このファイルはJSON形式でなければなりません。マニフェストファイルの例は以下に示されています。MoEngageダッシュボードを使用すると、CSVまたはJSONファイルの列をMoEngage内の属性にマッピングできます。または任意で、マニフェストファイルをアップロードすることもできます。

{
  "mapping": [
    {
      "column": "ID",
      "moe_attr": "uid",
      "type": "string",
      "is_skipped": false
    },
    {
      "column": "First Name",
      "moe_attr": "u_fn",
      "type": "string",
      "is_skipped": false
    },
    {
      "column": "First Seen",
      "moe_attr": "cr_t",
      "type": "datetime",
      "datetime_format": "YYYY-MM-DD hh:mm:ss",
      "is_skipped": false
    },
    {
      "column": "LTV",
      "moe_attr": "t_rev",
      "type": "double",
      "is_skipped": false
    },
    {
      "column": "Install Status",
      "moe_attr": "installed",
      "type": "bool",
      "is_skipped": false
    }
  ]
}

{
  "mapping": [
    {
      "column": "customer_id",
      "moe_attr": "uid",
      "type": "string",
      "is_skipped": false
    },
    {
      "column": "user.first_name",
      "moe_attr": "u_fn",
      "type": "string",
      "is_skipped": false
    },
    {
      "column": "user.first_seen",
      "moe_attr": "cr_t",
      "type": "datetime",
      "datetime_format": "YYYY-MM-DD hh:mm:ss",
      "is_skipped": false
    },
    {
      "column": "attribution.lifetime_value",
      "moe_attr": "t_rev",
      "type": "double",
      "is_skipped": false
    },
    {
      "column": "attribution.device_installed",
      "moe_attr": "installed",
      "type": "bool",
      "is_skipped": false
    }
  ]
}

各列について、次のフィールドを記載する必要があります：

1. 「カラム」 : (必須) ソースファイルからの列名を表します。JSONファイルのレベル2列をマッピングする際には、ドット表記を使用できます: key1.key2.
   
2. “moe_attr” (required) マッピングしたいMoEngage属性（属性名）を指定してください。 データ管理 ページで、イベント数、ユーザー属性、ユーザーおよびイベントのボリュームを確認できます。各列がユニークな「moe_attr」にマッピングされていることを確認してください。
3. 「タイプ」: (オプション) このフィールドは列のデータ型を表します。属性の受け入れ可能な「型」形式については、 以下の表 を参照してください。詳細については、 データ管理 ページを参照してください。
4. “datetime_format” : (オプション) このフィールドは日付と時刻の形式を示します。これはDateTimeフィールドのみに必須です。サポートされている日付時刻形式の完全なリストについては、 以下の表 を参照してください。
5. “is_skipped”: (optional) このフィールドは、MoEngageが列をインポートするかどうかを示します。これはブール型のフィールドで、trueとしてマークされた属性はインポート中にスキップされます。

上記のサンプルマニフェストファイルは、5つの標準属性で構成されています。以下のリストでさらに多くの標準属性を参照するか、データ管理ダッシュボードを参照して完全な標準属性リストを取得できます。

MoEngageの参考用の他の標準ユーザー属性:

サポートされているユーザー属性タイプ

サポートされている日時形式

ファイルの準備ができたら、それらをフォルダーの中に入れる必要があります。

フォルダー構造

すべてのファイルをフォルダーに配置してください。インポートの設定中にフォルダーのパスを構成できます。 MoEngage はルートフォルダーやサブフォルダー内のファイルを探しませんのでご注意ください。

インポートの設定

MoEngageダッシュボードの以下のナビゲーションでS3/SFTPインポートを設定できます: セグメント -> S3/SFTPインポート 。 ダッシュボードの以下のナビゲーションでユーザー特有のインポートを見つけることもできます: セグメント ユーザーをインポートします。

Amazon S3

S3インポートを正しく設定するには、MoEngageに関連する権限を付与し、すべてのファイルが私たちに適切にアクセス可能であることを確認する必要があります。 S3インポートの設定方法を学ぶ 。

SFTPサーバー

MoEngageがサポートする認証方法の種類と構成手順について学ぶには、 SFTPインポートの設定方法を確認してください 。

インポートダッシュボード

S3/SFTPインポートダッシュボードには、インポートを追跡するために必要なすべての情報が含まれています。重要な情報を一目で確認できます:

各インポートの詳細は、対象の三点リーダーのアクションメニューをクリックし、 詳細を表示 を選択することで確認できます。

MoEngageのユーザーに対する実際の作成数と更新数を確認するには、セグメンテーションクエリを利用してください。

インポートのトリガー

インポートをトリガーするには、次のオプションのいずれかを使用できます：

1. 手動 : 定期インポートは、インポートページから アクション をクリックすることで手動でトリガーできます。

   注意 : 予定された時間の5分以内にインポートをトリガーすると、エラーが発生する可能性があります。

2. API : インポートは、ファイルインポートトリガーAPIを使用してトリガーできます。詳細については、 ファイルインポートトリガーAPI を参照してください。

ファイル制限

MoEngageがサポートする最大ファイルサイズは1ファイルあたり200MBです。より大きなファイルの場合は、ファイルをそれぞれ200MBのファイルに分割する必要があります。

1. 行: MoEngageはCSV/JSONファイルで最大1M行を許可します。
   
2. 列/属性: MoEngageはユーザーごとに100の列（属性）と、イベントごとに100の列（属性）を許可します。
3. ファイルサイズ: S3/SFTPの場合はファイルサイズは<200MB（CSVごと）、手動アップロードの場合は<150MB（CSVごと）であるべきです。
4. ファイルごとの行数: 行数は100万を超えてはいけません。
5. ファイル名のプレフィックス: ファイル名のプレフィックスの最大文字数は100文字である必要があります。これらの制限はS3およびSFTPインポートに適用されます。
6. ファイルの数: 各インポートで、MoEngageは最大250ファイルをインポートできます。
7. 輸入制限 : 下記の表を参照してください。

右上隅のレート制限を参照して、ユーザー、イベント、および補助データの消費制限/デフォルト制限を日次および時間ごとに確認できます。以下の画像に示されています。

ベストプラクティス

データインポートがスムーズかつ効率的に実行されるように、以下の推奨事項を考慮してください：

• スピードのためのファイルサイズの最適化: より迅速な処理のために、個々のインポートファイルは100万行未満に抑えることをお勧めします。
• 大規模データセットの分割: インポートするデータが大量にある場合、それを複数の小さなファイルに分割することで、一般的に1つの大きなファイルをアップロードするよりも全体的な処理速度が速くなる可能性があります。

よくある質問