Skip to content
Last updated

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

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

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

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

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

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

イベントスキーマ

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

フィールド説明
profile_identifier_valuestring受信者のメールアドレス
profile_identifier_namestring常に"email_address"(将来のマルチチャネルサポート用)
campaign_idstringキャンペーンの一意のID
campaign_namestringキャンペーンの名前
group_idstringサブスクリプショングループのID(現在は常にグローバル配信停止のNULL)
group_namestringサブスクリプショングループの名前(現在は常に"Global")
actionstring現在は常に"opt-out"(オプトイン機能は今後のリリースで利用可能になります)
action_sourcestring配信停止のトリガー方法: "post"(HTTPS)または"mailto"(メール)
channelstring現在は常に"email"(SMSおよびプッシュチャネルのサポートは今後のリリースで利用可能になります)
task_idstring送信されたメールの一意の識別子
user_agentstringブラウザ/デバイス情報(HTTPSのみ)
ip_addressstringユーザーのIPアドレス(HTTPSのみ)
senderstring送信者のメールアドレス
received_timetimestampTDが配信停止リクエストを受信した日時
timetimestampPlazmaによって自動的に追加

Audience Studioとの統合

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

  1. subscription_eventsテーブルから配信停止ユーザーのテーブルを作成
  2. opt-outフラグを含むアトリビュートテーブルを作成
  3. このテーブルをParent Segmentのアトリビュートテーブルとして登録
  4. Audience Studioでアトリビュートを使用して、キャンペーンオーディエンスを作成する際に配信停止ユーザーを除外
-- 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_*にマッピングしないための注意事項については、メール配信イベントテーブルを参照してください。

関連ドキュメント