Skip to content
Last updated

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

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

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

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

  • 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

関連ドキュメント