CRMイベントのエクスポート (S3)

FlareLaneで発生したメッセージの配信・到達・クリックなどのCRMイベントを、毎日お客様のAmazon S3バケットへ自動でエクスポートする機能です。エクスポートされたデータはParquet形式で保存されるため、社内のデータウェアハウスやBIツールに取り込んで、キャンペーンの成果を精緻に分析できます。

設定は最初に一度だけ行えば十分です。お客様のAWSアカウントでIAM Roleを作成してFlareLaneに書き込み権限を委任したうえで、FlareLaneコンソールで対象バケットと権限情報を入力すると、翌日から自動的にデータが蓄積されます。

エクスポートされたファイルは、以下のパス規則で保存されます。

s3://<bucket>/<prefix>/<YYYY-MM-DD>/<YYYYMMDDHHMMSS>_part_<NNN>.parquet

// e.g. s3://my-flarelane-export/crm/2026-05-14/20260515030412_part_001.parquet

設定時に、以下のリストの中からエクスポートするイベントを自由に選択できます（最低 1 つ以上が必須）。選択しなかったタイプのイベントは、エクスポートの対象から除外されます。

設定を始める前に、以下の項目をご準備ください。

設定に使用する CloudFormation テンプレートです。以下のボタンからダウンロードして、2 段階目で使用してください。

お客様の AWS アカウントで、エクスポート対象の S3 バケットを準備します。既存のバケットを再利用しても問題ありませんが、CRM イベント専用として別のバケットを使用することを推奨します。

FlareLane の Glue Job がお客様の S3 バケットにデータを書き込み、蓄積後に一時ファイルを整理（rename・cleanup）できるように、IAM Role と権限を作成します。以下の 2 つの方法のいずれかを選択してください。

1. 上記の iam-role.yaml ダウンロードボタンでテンプレートをダウンロードします。
2. AWS コンソールの CloudFormation → Create stack → With new resources (standard) に移動し、Upload a template file で iam-role.yaml をアップロードします。
3. 以下のパラメータを入力します。

4. 最後の確認ステップで "I acknowledge that AWS CloudFormation might create IAM resources with custom names" チェックボックスを選択したうえで、スタックを作成します。
5. スタックの作成が完了したら、Outputs タブで RoleArn の値をコピーします。3 段階目のコンソール入力で使用します。
6. （SSE-KMS バケットのみ該当） Outputs タブの KmsKeyPolicyStatement JSON をコピーし、該当する KMS キーの Key policy に Statement として追加します（KMS コンソール → カスタマー管理型キー → キーを選択 → キーポリシーを編集）。クロスアカウント KMS アクセスは IAM 権限だけでは不十分であり、キーポリシーでもこの Role を Principal として許可する必要があります。

CloudFormation を使用せずにコンソールで直接構成する場合は、以下の手順に従います。

(1) IAM Roleの作成

1. AWS コンソールの IAM → Roles → Create role に移動します。
2. Trusted entity type として Custom trust policy を選択し、以下の JSON をそのまま貼り付けます。2 か所のプレースホルダーを実際の値に置き換えてください。
   • <FLARELANE_GLUE_ROLE_ARN>: FlareLane からお渡しする値
   • <FLARELANE_PROJECT_ID>: FlareLane プロジェクト ID

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "<FLARELANE_GLUE_ROLE_ARN>"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "<FLARELANE_PROJECT_ID>"
        }
      }
    }
  ]
}

3. Role 名を自由に入力し（例: flarelane-crm-export-role）作成します。

(2) S3インラインポリシーの付与

1. 作成した Role の詳細画面で Add permissions → Create inline policy を選択します。
2. ポリシーエディタを JSON モードに切り替え、以下の JSON を貼り付けます。<DESTINATION_BUCKET> を 1 段階目で準備したバケット名に置き換えてください。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::<DESTINATION_BUCKET>",
        "arn:aws:s3:::<DESTINATION_BUCKET>/*"
      ]
    }
  ]
}

3. ポリシー名を自由に入力し（例: flarelane-crm-export-policy）保存します。

(3) KMS権限の付与 — SSE-KMSバケットのみ該当

対象バケットが KMS カスタマー管理型キーで暗号化されている場合は、上記のポリシーに加えて、以下の 2 点を追加で設定する必要があります。

• Role に KMS 権限（kms:GenerateDataKey、kms:Decrypt）を付与し、Resource を該当するキー ARN に指定します。
• 該当する KMS キーの Key policy にも、この Role を Principal として許可する Statement を追加します。クロスアカウント KMS アクセスは IAM 権限だけでは不十分であり、キーポリシーの許可が必ず併せて必要です。

FlareLane コンソールの プロジェクト設定 → CRM イベントのエクスポート 画面で、以下の値を入力します。

保存後、有効化トグルをオンにすると、次回の KST 03:00 から自動的にエクスポートが開始されます。

有効化した翌日の KST 03:00 ~ 03:30 の間に初回実行が行われます。同じ日の午前中に、以下を確認してください。

1. 対象 S3 バケット内に <prefix>/<昨日の日付>/ ディレクトリが作成されているか確認します。
2. ディレクトリ内に <YYYYMMDDHHMMSS>_part_001.parquet 形式のファイルが存在するか確認します。
3. Parquet ファイルを開き、前日に発生したイベントが正常に蓄積されているか点検します。

ディレクトリが作成されていない場合は、以下の項目を確認してください。

• 前日に発生した該当イベントが実際に存在するか（存在しない場合は、空のディレクトリも作成されません）
• 選択した エクスポートするイベントタイプ フィルターに、該当イベントが含まれているか
• IAM Role の Trust Policy の sts:ExternalId 値が、ご自身のプロジェクト ID と一致しているか
• IAM Policy の Resource ARN が、実際のバケット名と一致しているか
• （SSE-KMS バケットの場合）KMS キーの Key policy に、export Role が Principal として許可されているか

上記の項目がすべて正常であるにもかかわらずデータが蓄積されない場合は、FlareLane のカスタマーサポートまでお問い合わせください。

Q. 機能を有効化する前の過去データを一括で受け取れますか？

対応していません。有効化した時点以降の「前日」データから、日次単位で蓄積されます。過去の期間のデータが必要な場合は、FlareLane のカスタマーサポートまでお問い合わせください。

Q. 昨日のデータが空になっています。

次の 2 つのいずれかである可能性が高いです。

• 該当日に発生した CRM イベントがない場合（この場合、S3 ディレクトリ自体が作成されません）
• 発生したイベントのタイプが エクスポートするイベントタイプ フィルターに含まれていない場合

Q. S3 パス prefix を途中で変更するとどうなりますか？

変更した時点以降のデータから、新しい prefix のパスに蓄積されます。既存の prefix のパスに保存されたファイルはそのまま維持され、FlareLane が自動的に移動させることはありません。

Q. IAM Role ARN を誤って入力しました。その日付のデータは自動的に再蓄積されますか？

自動復旧はされません。ARN を正しい値に修正して保存すると、翌日から正常に蓄積されます。欠落した日付のデータが必要な場合は、FlareLane のカスタマーサポートまでお問い合わせください。

Q. 1 つのプロジェクトから複数の S3 バケットへ同時にエクスポートできますか？

現在は、プロジェクトごとに 1 つの対象バケットのみ設定可能です。