MoEngageは、メッセージデータをアーカイブするための2つの主なオプションを提供します:S3バケットへのエクスポートまたはSFTPサーバーへのエクスポート。各オプションには、それぞれのディレクトリ構造とファイル命名規則があります。設定されたアーカイブ方法の詳細を表示するには、以下の適切なタブを選択してください。
以下は、S3バケットにエクスポートされたアーカイブメッセージのデフォルトのファイルパスとファイル名の規則です。
チャンネルとプラットフォーム | ファイルパスとファイル命名規則 |
---|---|
ファイルパス:
|
|
ファイル名:
|
|
SMS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - Android |
ファイルパス:
|
ファイル名:
|
|
プッシュ - iOS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - ウェブ |
ファイルパス:
|
ファイル名:
|
チャンネルとプラットフォーム | ファイルパスとファイル命名規則 |
---|---|
ファイルパス:
|
|
ファイル名:
|
|
SMS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - Android |
ファイルパス:
|
ファイル名:
|
|
プッシュ - iOS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - ウェブ |
ファイルパス:
|
ファイル名:
|
チャンネルとプラットフォーム | ファイルパスとファイル命名規則 |
---|---|
ファイルパス:
|
|
ファイル名:
|
|
SMS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - Android |
ファイルパス:
|
ファイル名:
|
|
プッシュ - iOS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - ウェブ |
ファイルパス:
|
ファイル名:
|
チャンネルとプラットフォーム | ファイルパスとファイル命名規則 |
---|---|
ファイルパス:
|
|
ファイル名:
|
|
SMS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - Android |
ファイルパス:
|
ファイル名:
|
|
プッシュ - iOS |
ファイルパス:
|
ファイル名:
|
|
プッシュ - ウェブ |
ファイルパス:
|
ファイル名:
|
ただし、MoEngage S3 バケットまたはあなたの S3 バケットに基づいて、要件に応じてファイル命名規則をカスタマイズできます。
-
ファイルパスまたはファイル名に以下の属性のいずれかを追加できます:
属性 説明 {{cid}}
MoEngageキャンペーンID {{channel}}
チャネルタイプ {{db_name}}
ワークスペース名 {{date}}
アーカイブの日付 {{id}}
ID {{moe_transaction_id}}
MoEngage取引ID {{time}}
アーカイブの時間 {{moe_event_id}}
MoEngageイベントID {{alert_ID}}
アラートIDはInform用です。Informの場合、キャンペーンIDはありません。 -
ファイル名の属性の順序を変更できます。たとえば、一回限りのメールキャンペーンのファイル命名規則を考えてみましょう。
デフォルト:
MoeCampaignID_ID_epochtime_email.eml
カスタマイズ:
ID_MoeCampaignID_epochtime_email.eml
(ここでは、IDがMoeCampaignIDの前に来ます)
設定後、MoEngageはメッセージイベントデータをあなたのサーバーにエクスポートします。アーカイブプロセスは、すべてのチャネル(プッシュ、メール、SMSなど)からのメッセージを同じエクスポートファイルにまとめます。
サーバーディレクトリパス
MoEngageは、あなたのSFTPサーバーの特定のディレクトリパスにアーカイブファイルをアップロードします。セットアップ中に、これらのアップロードの基本パスを構成できます。提供するパスはスラッシュ(/)で終わる必要があります。ベースパスを提供しない場合、MoEngageはデフォルトを使用します:
/home/{username}/uploads/
。
MoEngageは、自動的にワークスペース名(db_name)と日付を追加して最終的なディレクトリ構造を作成します:
your_configured_base_path/{db_name}/{YYYY-MM-DD}/
カスタムパスを提供しない場合、MoEngageは以下のデフォルト構造を使用します:
/home/{username}/uploads/{db_name}/{YYYY-MM-DD}/
- /home/{username}/uploads/: デフォルトのベースパス。
- ユーザー名: SFTP接続設定時に提供されたユーザー名。
- db_name: あなたのMoEngageワークスペースの名前。
- YYYY-MM-DD: エクスポートの日付。
例えば、デフォルトのパスを使用すると、ユーザー名が
citi-test
で、ワークスペース(db_name)が
checkfcsgain
の場合、2025年7月15日のファイルは次の場所にあります:
/home/citi-test/uploads/checkfcsgain/2025-07-15/
。
アーカイブファイル名と構造
SFTPサーバーにアップロードされたファイルは、.zipアーカイブに圧縮されます。これらのアーカイブは一貫したパターンを使用して名前が付けられており、データ量が大きい場合は複数の部分に分割されることがあります。
ZIPファイル命名規則:
[workspace_name]_[date]_[hour]_[chunk_number].zip
コンポーネント | Description |
---|---|
workspace_name
|
あなたのMoEngageワークスペースの名前(例:
checkfcsgain
)。
|
日付
|
エクスポートの日付はYYYY-MM-DD形式です。 |
時間
|
エクスポートが生成された日の時間 (00-23)。 |
chunk_number
|
1から始まる連続番号。総時間データが200MB未満の場合、チャンク番号は1になります。 |
info |
情報 ファイルはチャンク化されており、1チャンクあたりの最大サイズは200 MBです。指定された時間のデータがこの制限を超える場合、データは複数のZIPファイルに分割されます。例えば、2025年7月14日の午前6時のデータが350 MBの場合、2つのファイルが届きます:
個々のメッセージレコード(完全なJSONオブジェクト)は、2つの異なるファイルに分割されたり壊されたりすることはありません。 |
各 .zip アーカイブには複数の JSON ファイルが含まれています。個別のJSONファイルは、以下の命名および内容の規則に従います:
-
データファイル名:
MoEngageは、内部システムでの名前付けを反映した、これらのファイルに対してシステム生成の名前を使用します。例えば:
sftp.bulk.upload+0+0000049701.json
。 - ファイルの内容と形式: これらのJSONファイルには、1つ以上の完全なJSONオブジェクトが連続して含まれることがあります。単一のファイル内の個々のJSONオブジェクトの間には区切り文字はありません。ファイルを開くと、完全なJSONオブジェクトが次々と表示されます。
各JSONオブジェクトは、単一のアーカイブされたメッセージを表し、
"message_content"
キーで始まります。
MoEngageの機能は、エクスポートを管理するために毎時実行されます。この機能は最新のメッセージデータを収集し、それをzipアーカイブに圧縮して、あなたのSFTPサーバーにアップロードします。