> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# メール配信停止リンクとヘッダー

> OneSignalでメール配信停止動作を管理する方法を学びます。配信停止リンク、List-Unsubscribeヘッダー、抑制ルール、再サブスクリプションワークフローを含みます。

ユーザーがメールから配信停止する方法を管理することは、メール標準（CAN-SPAMなど）への準拠、GmailやYahooなどのプロバイダーでの強力な配信性の確保、オーディエンスとの信頼構築にとって重要です。

OneSignalは、表示される配信停止リンクとList-Unsubscribeヘッダーの両方をサポートし、ユーザーがいつどのようにオプトアウトできるかを制御しながら、メールの完全な準拠を保証します。

## サブスクリプションステータスと抑制ロジック

メール[サブスクリプション](./subscriptions)には次のいずれかがあります：

* **サブスクライブ済み** – メールメッセージを受信する資格があります。
* **配信停止** – 明示的にオーバーライドされない限り、ほとんどのメール送信から除外されます。

配信停止されたサブスクリプションをメールに含めるには（例：トランザクションメッセージの場合）：

* ダッシュボードで：メール送信時に**Advanced Settings > Include sending to unsubscribed users**を有効にします。
* APIで：[create email notification API](/reference/email)で`include_unsubscribed`プロパティを使用します。

<Frame caption="配信停止ユーザーへの送信を有効にする">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=5bddf440aae0717dc518b8a43789d3da" width="906" height="616" data-path="images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png" />
</Frame>

***

## ユーザーが配信停止される方法

メールサブスクリプションステータスは次の方法で更新されます：

* ユーザーが配信停止リンクまたはList-Unsubscribeヘッダーをクリックする
* [メールアドレスのCSVをインポート](./import)して`subscribed`を`no`に設定する
* [Create user](/reference/create-user)、[Update user](/reference/update-user)、または[Update subscription](/reference/update-subscription) APIを介して`enabled : false`を設定する
* **Audience > Subscriptions > Options > Unsubscribe from Email**から手動で配信停止する

***

## 配信停止ヘッダーと配信停止リンクの比較

* **List-Unsubscribeヘッダー**：受信トレイプロバイダーがネイティブの「配信停止」ボタンを表示するために使用する非表示のメールヘッダー（例：Gmail、Yahoo）。
* **配信停止リンク**：`[unsubscribe_url]`トークンを使用してメールコンテンツに配置される、表示されクリック可能なURL。

### List-Unsubscribeヘッダーの動作

OneSignalは、**「Include sending to unsubscribed users」を有効にした場合を除き**、すべてのメールに`List-Unsubscribe`ヘッダーを含めます。これは次に役立ちます：

* メールがスパムとしてマークされるのを防ぐ
* [Gmail/Yahoo 2024ルール](https://onesignal.com/blog/guide-to-2024-gmail-and-yahoo-requirements-for-email-senders/)に準拠する

<Warning>
  「Include sending to unsubscribed users」を有効にすると、List-Unsubscribeヘッダーは**含まれません**。

  一部の受信トレイプロバイダーは、特定の送信量のしきい値を満たさない限り、このヘッダーを表示から非表示にする場合があります。[Gmail](https://support.google.com/a/answer/81126?visit_id=638683263663552218-2680312485\&rd=1#requirements-5k\&zippy=%2Crequirements-for-sending-or-more-messages-per-day)と[Yahoo](https://senders.yahooinc.com/best-practices/)の要件を参照してください。
</Warning>

ユーザーがこれをクリックすると、そのメールサブスクリプションはOneSignalアプリで配信停止としてマークされます。

### メールに配信停止リンクを追加

OneSignalは`[unsubscribe_url]`トークンを提供し、メールコンテンツに表示される配信停止リンクを挿入します。

独自の配信停止ページでブランド化されたエクスペリエンスを作成することもできます。[カスタム配信停止ページの作成](./create-custom-unsubscribe-page)を参照してください。

#### HTMLエディター

HTMLエディターを使用している場合、デフォルトテンプレートには配信停止リンクが自動的に含まれています：

<Frame caption="デフォルトの配信停止リンクを含むHTMLエディター">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8b10e10-default_code.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=0c996973cd6335a81dd8854c8e0e355d" width="1309" height="562" data-path="images/docs/8b10e10-default_code.png" />
</Frame>

手動で追加するには（例：`email_body`を使用してAPI経由で）：

```html HTML theme={null}
<a href="[unsubscribe_url]">配信停止</a>
```

#### ドラッグ&ドロップエディター

テキストブロック内で：

1. **Special Links > Suppression > Unsubscribe**をクリック
2. `[unsubscribe_url]`プレースホルダーが挿入されます
3. 挿入する前にテキストをハイライトしてリンクにすることができます

<Frame caption="ドラッグ&ドロップエディターの配信停止リンク">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=46180061304abd272dbcef4c85b3b710" width="1114" height="230" data-path="images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png" />
</Frame>

<Info> 配信停止リンクは常に**非常に目立つ**ようにし、読みやすいフォントサイズ（最低12px）と強いコントラストを使用してください。非表示または見つけにくいリンクは、ユーザーがメッセージをスパムとしてマークする原因となり、将来の配信性に害を及ぼす可能性があります。 </Info>

***

## カスタム配信停止リンクの宛先

`[unsubscribe_url]`を独自の配信停止ランディングページに置き換えることができます。

これを行うには：

* [カスタム配信停止ページの作成](./create-custom-unsubscribe-page)の手順に従います。
* メール内の`[unsubscribe_url]`をカスタム配信停止ページのURLに置き換えます。

<Warning>
  カスタムリンクを使用する場合、OneSignalはユーザーを自動的に配信停止としてマークしません。APIまたはページの動作を通じて処理する必要があります。
</Warning>

***

## FAQ

### テストメールで配信停止リンクが機能しないのはなぜですか？

OneSignalメール送信ドメインがまだ検証されていない場合、テストメールの配信停止リンクは機能しません。プレースホルダーテキストは表示されますが、実際のリンクはありません。

ドメインが検証されると、配信停止リンクが正しくレンダリングされ、機能します。

### メールアドレスを再サブスクライブするにはどうすればよいですか？

ユーザーは3つの方法で再サブスクライブできます：

1. ダッシュボード：**Audience > Subscriptions > Options > Resubscribe to Email**に移動
2. API：[Create User](/reference/create-user)または[Update subscription](/reference/update-subscription) APIで`enabled: true`を設定
3. CSVインポート：メールアドレスをインポートする際に`subscribed = yes`を設定

<Warning> サードパーティのメールプロバイダー（ESP）を使用している場合は、そこの抑制リストを確認し、アドレスも削除してください。 </Warning>

### メールに配信停止リンクが2つあるのはなぜですか？

MailgunやSendGridなどのESPを使用している場合、独自の配信停止リンクを挿入する可能性があります。重複を避けるために、ESPの設定でこれを無効にできます。

### 配信停止クリックは分析にカウントされますか？

* OneSignalカスタム`[unsubscribe_url]`のクリックは、クリック分析にカウントされません。
* カスタム配信停止URLのクリックは、クリックとしてカウントされます。詳細については、[URL、リンク、ディープリンク](./links)を参照してください。

***

## 関連記事

* [カスタム配信停止ページの作成](./create-custom-unsubscribe-page)
* [メールメッセージング](./email-messaging)
* [Email API](/reference/email)
* [URL、リンク、ディープリンク](./links)

***