S3 エクスポート

概要

MoEngage は S3 とどのように連携しますか?

統合

ステップ1: S3バケットを作成する

1. AWS S3コンソールを開き、サインインするか、AWSアカウントを作成します。
2. Storage カテゴリから S3 を選択します。
3. Create Bucket をクリックし、識別しやすい名前を入力して、希望する物理リージョンを選択します。

ステップ2: App Marketplaceでエクスポートを追加する

1. 次のパラメーターを使用してエクスポートを設定します。

   フィールド	必須	説明
   Export name	はい	エクスポートの一意で識別しやすい名前を入力します（例: File-exports2）。
   S3 connection	はい	ドロップダウンリストから保存済みの接続を選択します。接続でIAMポリシー認証方式を使用する場合は、先にAWSアカウントでIAMポリシーを設定してください。MoEngageはこの権限を使用して、エクスポート時にS3バケットにファイルを配信します。詳細については、認証を設定するを参照してください。
   Folder path	はい	MoEngageがファイルをエクスポートする対象フォルダーへのパスを入力します。文字列の先頭と末尾にスラッシュを付けないでください。 日付でパーティション分割されたサブフォルダーではなく、単一のフォルダーにすべてのエクスポートを書き込むには、Export all files in one folder チェックボックスをオンにします。解決されたファイルパスはフィールドの下にリアルタイムで表示されるため、保存前に配信先を確認できます。形式はチェックボックスを選択したかどうかによって異なります。 単一フォルダー（チェックボックスがオン）: s3://<your-bucket-name>/[<folder_path>]/<connection_name>/event_exports_<file_tag>.json.gz 日付パーティション（チェックボックスがオフ）: s3://<your-bucket-name>/[<folder_path>_]<connection_name>/export_day=YYYY-MM-DD/event_exports_<UNIQUE_ID>.json.gz フォルダーパスの確認方法 S3 バケット内のオブジェクト一覧から、ファイルを格納するフォルダーを開きます。Properties タブで、フォルダーの S3 URI を確認します。フォルダーパスは、s3://[your-bucket-name]/ の後の部分から末尾のスラッシュを除いたものです。
   User properties	いいえ	各エクスポートでイベントレコードとともに含めるユーザープロパティとデバイスプロパティをリストから選択します。
   Select events	はい	既存および今後のすべてのイベントをエクスポートするには All events を選択し、リストからイベントを選ぶには Select events manually を選択します。
   Frequency	はい	MoEngageがこれらのイベントをエクスポートする頻度を選択します。 Every 15 mins: MoEngageは15分間隔でファイルをエクスポートします。 Daily: MoEngageは毎日の終わり、02:00 UTCにファイルをエクスポートします。 Weekly: MoEngageは毎週月曜日の02:00 UTCにファイルをエクスポートします。 保存後にエクスポート頻度を変更することはできません。別の頻度を使用するには、新しいエクスポートを作成してください。
   File encryption	いいえ	PGPを使用してエクスポートされるすべてのファイルを暗号化するには、File encryption チェックボックスをオンにします。MoEngageはGZIP圧縮されたファイルを公開鍵で暗号化し、.gpg 拡張子を付加します（例: event-exports_1735198203.json.gz.gpg）。 ファイルを復号した後、解凍してエクスポートされた内容を表示します。

2. Test をクリックします。
   MoEngageは一時的なプレースホルダーファイルの書き込みを試行して、S3バケットの設定、フォルダーパス、書き込み権限を検証します。
3. テストに合格したら、Save をクリックします。MoEngageは、頻度が固定されることを示す確認ポップアップを表示します。メッセージを確認し、もう一度 Save をクリックしてエクスポートを有効化します。
4. 保存せずに設定を破棄するには、Cancel をクリックします。

イベントと属性

データエクスポート形式

• ファイル形式: JSON
• 圧縮タイプ: GZip
• エクスポート頻度: 15分ごと、毎日、または毎週
• フォルダーパスの例:
  • 日付パーティション: s3://<your-bucket-name>/[<folder_path>_]<connection_name>/export_day=2025-10-28/event_exports_<UNIQUE_ID>.json.gz
  • 単一フォルダー: s3://<your-bucket-name>/[<folder_path>]/<connection_name>/event_exports_<UNIQUE_ID>.json.gz MoEngageは、各エクスポートファイルの一意の識別子として <UNIQUE_ID> を生成します。

エクスポートデータのサンプル

{
    "app_name": "App Name",
    "export_hour": "10",
    "db_name": "MoEngage App Name",
    "event": {
        "uid": "user id",
        "event_type": "USER_ACTION_EVENT",
        "event_code": "VIEW_RADAR",
        "event_name": "VIEW_RADAR",
        "user_attributes": {
            "moengage_user_id": "userid1",
            "user_attr1": "value1",
            "user_attr2": "value2"
        },
        "event_source": "MOENGAGE",
        "event_attributes": {
            "event_attr1": "value1",
            "event_attr2": "value2"
        },
        "event_uuid": "62045d15-8d5e-4cfd-ac49-5919bffb401d",
        "event_time": 1652820710,
        "device_attributes": {
            "moengage_device_id": "device id"
        }
    },
    "export_day": "2022-05-20"
}

{
    "app_name": "App Name",
    "export_hour": "6",
    "db_name": "MoEngage App Name",
    "event": {
        "uid": "user id",
        "event_type": "CAMPAIGN_EVENT",
        "event_code": "MOE_EMAIL_SENT",
        "event_name": "Email Sent",
        "user_attributes": {
            "moengage_user_id": "userid1",
            "user_attr1": "value1",
            "user_attr2": "value2"
        },
        "event_source": "MOENGAGE",
        "email_id": "[email protected]",
        "event_attributes": {
            "campaign_name": "Campaign name",
            "moe_campaign_tags": [
                "Tag1",
                "Tag2"
            ],
            "campaign_type": "GENERAL",
            "moe_campaign_channel": "Email",
            "moe_delivery_type": "One Time",
            "campaign_id": "moengage campaign id",
            "campaign_channel": "EMAIL"
        },
        "event_uuid": "3b918064-08dc-47ae-b674-c23797475a8d",
        "event_time": 1653022310,
        "device_attributes": {
            "moengage_device_id": "device id if applicable"
        }
    },
    "export_day": "2022-05-20"
}

AWS Key Management ServiceとAmazon S3の統合

1. AWS Management Console、AWS CLI、またはAWS SDKを使用して、AWS Key Management Service（KMS）のカスタマーマスターキー（CMK）を作成します。AWS KMSキーを既に生成している場合は、この手順をスキップしてください。
2. AWS KMSキーポリシーに権限を追加して、S3でAWS KMSキーを使用できるようにします。次のキーポリシーの例では、S3の暗号化にキーを使用することを許可しています。
   {
      "Version": "2012-10-17",
      "Id": "key-policy",
      "Statement": [
          {
            "Sid": "Allow use of the key for S3 encryption",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::612427630422:role/service-role/core_s3_export-role-e1qw8ulf"
            },
            "Action": [
                "kms:Encrypt",
                "kms:Decrypt",
                "kms:ReEncrypt*",
                "kms:GenerateDataKey*",
                "kms:DescribeKey"
            ],
            "Resource": [
                "arn:aws:s3:::your-bucket",
                "arn:aws:s3:::your-bucket/*"
            ]
          }
      ]
    }
   
3. 暗号化にAWS KMSキーを使用するようにS3バケットを設定します。これは、バケットの作成時またはバケットのプロパティを変更することで行えます。
4. S3 Management Consoleで、サーバー側の暗号化を有効にするバケットに移動します。
5. Properties タブをクリックし、Default encryption セクションまでスクロールします。
6. Encryption で Server-side encryption with AWS Key Management Service keys (SSE-KMS) を選択し、ドロップダウンメニューから作成したAWS KMSキーを選択します。KMSキーのAWS KMS ARNのみを使用してください。
7. Save をクリックして、暗号化設定をバケットに適用します。S3は、統合したAWS KMSキーを使用してオブジェクトを自動的に暗号化します。
8. MoEngageがホワイトリストに登録できるよう、AWS KMSキーのARNをMoEngageに提供します。

エクスポート失敗時のポリシー

MoEngage がエクスポートを一時停止するタイミング

エクスポートの一時停止中に起こること

エクスポートを再開する

失敗の理由を確認する

エクスポートを有効にする

一時停止中のデータをリプレイする

リプレイをリクエストする

1. Replay available ラベルにカーソルを合わせるか、エクスポートのケバブメニューを開きます。
2. Replay paused data をクリックします。
3. Replay paused data ダイアログボックスで、Confirm をクリックします。

リプレイの結果

重複データを回避する

エクスポート一時停止アラート

よくある質問