# サブスクリプションイベントテーブル

ワンクリック配信停止は、すべての配信停止イベントをメールドメインのデータベース内の専用テーブルに自動的に記録します。このテーブルを使用して、配信停止アクティビティを追跡し、トレンドを分析し、配信停止ユーザーを今後のキャンペーンから除外するワークフローを構築できます。

## データベースとテーブルの場所

サブスクリプションイベントデータは、Treasure Dataアカウント内の以下の場所に保存されます：

- **Database**: `delivery_email_{your-domain}` (例: `delivery_email_example_com`)
- **Table**: `subscription_events`


`subscription_events`テーブルは、TD Managed Unsubscribeを有効にすると、メール配信イベントと同じデータベースに自動的に作成されます。

## イベントスキーマ

`subscription_events`テーブルには以下のフィールドが含まれます。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `profile_identifier_value` | string | 受信者のメールアドレス |
| `profile_identifier_name` | string | 常に"email_address"(将来のマルチチャネルサポート用) |
| `campaign_id` | string | キャンペーンの一意のID |
| `campaign_name` | string | キャンペーンの名前 |
| `group_id` | string | サブスクリプショングループのID(現在は常にグローバル配信停止のNULL) |
| `group_name` | string | サブスクリプショングループの名前(現在は常に"Global") |
| `action` | string | 現在は常に"opt-out"(オプトイン機能は今後のリリースで利用可能になります) |
| `action_source` | string | 配信停止のトリガー方法: "post"(HTTPS)または"mailto"(メール) |
| `channel` | string | 現在は常に"email"(SMSおよびプッシュチャネルのサポートは今後のリリースで利用可能になります) |
| `task_id` | string | 送信されたメールの一意の識別子 |
| `user_agent` | string | ブラウザ/デバイス情報(HTTPSのみ) |
| `ip_address` | string | ユーザーのIPアドレス(HTTPSのみ) |
| `sender` | string | 送信者のメールアドレス |
| `received_time` | timestamp | TDが配信停止リクエストを受信した日時 |
| `time` | timestamp | Plazmaによって自動的に追加 |


## Audience Studioとの統合

キャンペーンで配信停止データを使用するには、Parent Segmentのアトリビュートとして統合する必要があります：

1. `subscription_events`テーブルから配信停止ユーザーのテーブルを作成
2. opt-outフラグを含むアトリビュートテーブルを作成
3. このテーブルをParent Segmentのアトリビュートテーブルとして登録
4. Audience Studioでアトリビュートを使用して、キャンペーンオーディエンスを作成する際に配信停止ユーザーを除外



```sql
-- Create a table of unsubscribed users
CREATE TABLE unsubscribed_users AS
SELECT
email, latest_action, last_updated, cast(1 as bigint) is_opt_out
FROM (
  SELECT
    profile_identifier_value AS email,
    MAX_BY(action, received_time) AS latest_action,
    MAX(received_time) AS last_updated
  FROM subscription_events
  WHERE group_name = 'Global'
  GROUP BY profile_identifier_value
  HAVING MAX_BY(action, received_time) = 'opt-out'
) t1
```

## 関連ドキュメント

- [ワンクリック配信停止管理](/ja/products/marketing-cloud/engage-studio/channels/email/one-click-unsubscribe)
- [Email Delivery Events Table](/ja/products/marketing-cloud/engage-studio/channels/email/email-delivery-events-table)
- [Email Sender Configuration](/ja/products/marketing-cloud/engage-studio/channels/email/email-sender-configuration)