​

MoEngage × Amazon S3

​

ユースケース

• リアルタイムの行動セグメントを同期する。
• ユーザーとイベントをインポートする。
• キャンペーンのインタラクションイベントをエクスポートする。

​

メリット

​

統合にかかる時間の短縮

• 外部の ETL（Extract, Transform, and Load）ツールが不要になります。
• 複雑なデータパイプラインを 1 回限りの設定プロセスに置き換えます。
• 開発チームや技術チームへの依存を最小限に抑えます。

​

データ処理の高速化

• 大量のデータをほぼリアルタイムで処理およびクエリします。
• MoEngage で手動の再設定を行わなくても、スキーマの更新が自動的に反映されます。
• 従来の外部クラウドパイプラインと比べて、データ転送コストを削減します。

​

統合

​

ステップ 1: 認証を設定する

クロスアカウントロール（推奨）— インポートとエクスポートの両方をサポート

この方式では、AWS アカウントに IAM ロールを 1 つ作成し、単一の MoEngage ロールがそれを引き受けられるようにします。MoEngage から次の 2 つの値が必要です。

• MoEngage AWS Account ARN: ロールが信頼する唯一の MoEngage ID です。
• MoEngage External ID: ワークスペースに固有の値で、moe-external-xxxxxxxxxx の形式です。

これらの値の確認場所MoEngage で、Amazon S3 > Integrations > Add Connection に移動します。MoEngage AWS Account ARN とワークスペースの MoEngage External ID は、Add Connection フォームに表示されます（ステップ 3: App Marketplace で Amazon S3 を接続するを参照）。AWS を設定する前に、これらの値をコピーしてください。

クロスアカウントロールを作成する

1. AWS Management Console にサインインし、IAM サービスを開きます。
2. 左側のナビゲーションで Roles を選択し、Create role をクリックします。
3. Trusted entity type で Custom trust policy を選択します。
4. Custom trust policy エディターに次の信頼ポリシーを貼り付け、プレースホルダーを App Marketplace の値に置き換えてから、Next をクリックします。信頼ポリシーは、誰がロールを引き受けられるかを定義します。
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "AllowMoEngageToAssume",
         "Effect": "Allow",
         "Principal": {
           "AWS": "<<MoEngage AWS Account ARN>>"
         },
         "Action": "sts:AssumeRole",
         "Condition": {
           "StringEquals": {
             "sts:ExternalId": "<<MoEngage External ID>>"
           }
         }
       }
     ]
   }
   
   sts:ExternalId 条件により、このロールの範囲はお使いのワークスペースのみに限定されます。この条件は変更または削除しないでください。
5. Add permissions 画面で Next をクリックします。バケットの権限は、後で ステップ 2: 権限を付与するでアタッチします。
6. Name, review, and create 画面で、必須のプレフィックス moe-export- で始まる Role name を入力します（例: moe-export-moengage-s3）。MoEngage はこのプレフィックスを持つロールのみを引き受けられるため、名前が moe-export- で始まらないロールは接続に失敗します。
7. Create role をクリックします。
8. 作成したロールを開き、その Role ARN をコピーします（例: arn:aws:iam::111122223333:role/moe-export-moengage-s3）。これは ステップ 3 で Add Connection ページに貼り付けます。

ロールを作成したら、ステップ 2: 権限を付与するで説明されているバケット権限（Imports タブ、Exports タブ、またはその両方）をアタッチします。

アクセスキー [Imports] — インポートのみをサポート

ロールの代わりに、バケットへの読み取りアクセス権を持つ AWS アクセスキーペアを指定します。

1. AWS アカウントで IAM user を作成し（または既存のプログラム用ユーザーを使用し）、Access Key ID と Secret Access Key を生成します。
2. バケットへの読み取りアクセス権を付与する権限ポリシーをアタッチします（ステップ 2: 権限を付与する → Imports タブを参照）。
3. Add Connection ページで Access Key ID と Secret Access Key を入力します（ステップ 3: App Marketplace で Amazon S3 を接続するを参照）。

アクセスキーの認証情報は、インポートごとに入力するのではなく、再利用可能な S3 接続として MoEngage に一度だけ保存されます。接続を一度作成し（ステップ 3）、S3 インポートを設定する際にその接続を選択します。

IAM ポリシー [Exports] — エクスポートのみをサポート

この方式では、S3 バケットポリシーを通じて MoEngage のエクスポートロールに直接アクセス権を付与します（MoEngage が引き受けるロールはありません）。MoEngage はこの方式ですべてのデータセンターにわたって単一のエクスポートロールを使用するため、データセンターごとの ARN 表は必要ありません。

arn:aws:iam::612427630422:role/service-role/core_s3_export-role-e1qw8ulf

1. AWS Management Console > S3 を開き、バケットを選択して、Permissions > Bucket policy > Edit に移動します。
2. 次のステートメントを追加します。<INSERTPOLICYID> と <INSERTSID> を任意の値（一意の識別子であれば何でも構いません）に、your-bucket-name をバケット名に置き換えます。MoEngage の Principal ARN は表示どおりに保持してください。

{
  "Version": "2012-10-17",
  "Id": "<INSERTPOLICYID>",
  "Statement": [
    {
      "Sid": "<INSERTSID>",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::612427630422:role/service-role/core_s3_export-role-e1qw8ulf"
      },
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3::<INSERTBUCKETNAME>/*"
    }
  ]
}

​

ステップ 2: 権限を付与する

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "MoEngageImportReadObjects",
      "Effect": "Allow",
      "Action": ["s3:GetObject"],
      "Resource": "arn:aws:s3:::<INSERTBUCKETNAME>/*"
    },
    {
      "Sid": "MoEngageImportListBucket",
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::<INSERTBUCKETNAME>/*"
    }
  ]
}

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "MoEngageExportWriteObjects",
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:AbortMultipartUpload"],
      "Resource": "arn:aws:s3:::your-bucket-name/moengage/*"
    },
    {
      "Sid": "MoEngageExportListBucket",
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::<INSERTBUCKETNAME>/*"
    }
  ]
}

​

ステップ 3: App Marketplace で Amazon S3 を接続する

1. MoEngage ダッシュボードの左側のナビゲーションメニューで、App marketplace をクリックします。
2. App Marketplace ページで Amazon S3 を検索します。
3. Amazon S3 タイルをクリックします。
4. Amazon S3 ページで Integrate タブに移動し、+Add Connection をクリックします。
5. S3 connections セクションで、次の設定を入力します。

   適用対象	フィールド	必須	説明
   	Connection name	はい	Amazon S3 接続を識別するための一意の名前を入力します。
   	Bucket name	はい	Amazon S3 バケットの正確な名前を入力します。MoEngage はこの名前を使用してインポートとエクスポートをルーティングします。
   	Bucket region	任意	ドロップダウンリストから、対象の S3 バケットをホストしている AWS リージョンを選択します。
   	Authentication method	はい	MoEngage を Amazon S3 に接続するためのオプションを選択します。 Cross account role: AWS アカウントの IAM ロールを引き受けることで、MoEngage がインポートとエクスポートのために S3 バケットにアクセスできるようにします。このオプションは長期的な認証情報の保存を不要にすることで、セキュリティを高めます。 Access key [Imports]: 静的なプログラム用 AWS 認証情報（Access Key ID と Secret Key）を使用してインポートを認証します。 IAM Policy [Exports]: リソースレベルの S3 バケットポリシーを使用して、MoEngage からの自動エクスポートを承認します。
   Cross account role	MoEngage AWS Account ARN	読み取り専用	MoEngage の AWS アカウント ARN（arn:aws:iam::582272135730:root）を表示します。この値をコピーして、AWS ロールの信頼関係ポリシーを設定します。このフィールドは Cross account role をクリックした場合にのみ表示されます。
   	MoEngage External ID	読み取り専用	MoEngage の外部セキュリティ ID（moe-external-f82a6992-9c75-5d4c-f985-a0c3b8f3bcf2）を表示します。この値をコピーして、AWS ロールの信頼関係ポリシーを設定します。このフィールドは Cross account role をクリックした場合にのみ表示されます。
   	Your AWS role ARN	条件付き	MoEngage との信頼関係が設定された AWS IAM ロールの Amazon リソースネーム（ARN）を入力します。このフィールドは Cross account role をクリックした場合にのみ必須です。AWS ロール ARN を入力します。
   Access key [Imports]	Access Key ID	条件付き	AWS ユーザー用に生成されたプログラム用の Access Key ID を入力します。このフィールドは Access key [Imports] をクリックした場合にのみ必須です。Access Key ID を入力します。
   	Secret Key	条件付き	AWS ユーザー用に生成されたプログラム用のシークレットアクセスキーを入力します。このフィールドは Access key [Imports] をクリックした場合にのみ必須です。Secret Key を入力します。
   IAM Policy [Exports]	認証情報は不要	—	この方式は S3 エクスポート専用です。ここでは認証情報を入力しません。代わりに AWS アカウントで IAM ポリシーを設定すると、MoEngage はその権限を使用してエクスポート時にファイルを S3 バケットに配信します。バケットポリシーを設定するには、ステップ 1: 認証を設定するの IAM Policy [Exports] 方式を参照してください。このフィールドは IAM Policy [Exports] をクリックした場合にのみ表示されます。

6. Test をクリックして認証情報を検証し、Connect をクリックして Amazon S3 統合を有効にします。
   設定の変更がアクティブなキャンペーンと接続に反映されるまで、最大 15 分かかる場合があります。

​

ユーザーとイベントをインポートする

​

イベントをエクスポートする