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

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

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

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

- **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
```

## `td_log_`プレフィックスによる非PIIカスタム識別子列

配信停止ログに生のメールアドレスを保存することが禁止されるような厳格なセキュリティ環境でも、`subscription_events`テーブルは`td_log_`プレフィックスによる非PIIカスタム識別子列をサポートしています。アクティベーションで出力列名が`td_log_`で始まるアウトプットマッピング（例：`td_log_member_id`）を定義すると、その列が`subscription_events`テーブルに自動的に追加され、該当アクティベーションから発生する各配信停止イベントに値が入力されます。

これにより、生のメールアドレスの代わりに（またはメールアドレスと併用して）、内部会員ID、CRM ID、ハッシュ化された識別子などの非PII識別子を使った配信停止管理・分析が可能になります。同じ`td_log_*`列の値は`events`テーブルと`error_events`テーブルにも出現するため、メールアドレスでJOINすることなく、配信停止と配信・バウンス・エラーを紐付けて分析できます。

設定手順、制限（1アクティベーションあたり最大5個、ASCII文字のみの列名、列名256文字制限）、PIIを`td_log_*`にマッピングしないための注意事項については、[メール配信イベントテーブル](/ja/products/marketing-cloud/engage-studio/channels/email/email-delivery-events-table)を参照してください。

## 関連ドキュメント

- [ワンクリック配信停止管理](/ja/products/marketing-cloud/engage-studio/channels/email/one-click-unsubscribe)
- [メール配信イベントテーブル](/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)