> ## 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メールの一般的な問題を診断して修正する方法。

このガイドを使用して、セットアップの問題、配信性の課題、デザインエラーを含む、最も一般的なOneSignalメールの問題を特定して解決します。

<Note>
  トラブルシューティングの前に、[メールセットアップ](./email-setup)と[メール配信性](./email-deliverability)ガイドを確認してください。これらは、メール問題の最も一般的な原因をカバーしています。
</Note>

## セットアップの問題

ほとんどのセットアップの問題は、不正なDNSレコードまたはメールサービスプロバイダー（ESP）からの制限に起因します。

### DNSレコードを検証する

1. DNSプロバイダーを開きます。
2. SPF、DKIM、MXレコードが[メールDNS構成](./email-dns-configuration)ガイドと一致することを確認します。
3. DNS変更が伝播するまで最大24時間待ちます。

<Warning>
  DNSレコードが誤って構成されていると、メールの送信に失敗したり、バウンスしたり、スパムとしてマークされたりする可能性があります。
</Warning>

### 月間送信制限（OneSignal以外のESP）

SendGrid、Mailchimp、またはMailgunを直接使用している場合（OneSignalメール経由ではない）、送信量はESPプランによって制限されます。
プロバイダーのログを確認してください：

* [SendGrid Activity Feed](https://www.twilio.com/docs/sendgrid/ui/analytics-and-reporting/email-activity-feed)
* [Mailchimp Activity & Reports](https://mailchimp.com/developer/transactional/docs/activity-reports/)
* [Mailgun Logs](https://www.mailgun.com/products/send/email-analytics/logs/)

### DNSルックアップが多すぎる

[URI test](https://www.uriports.com/tools?method=spf\&domain=mail.daystrom-institute.com)のようなツールでSPFレコードをテストすると、次のように表示される場合があります：

<Frame caption="DNSルックアップが多すぎる">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-troubleshooting-too-many-dns-lookups.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=926c451d7d99431a4ed0e8092ff6b014" alt="Too many DNS lookups" width="1127" height="338" data-path="images/email/email-troubleshooting-too-many-dns-lookups.png" />
</Frame>

これは、次のSPFレコードを使用している場合に予想されます：

```
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
```

OneSignalは、メールサービスプロバイダーとして「内部的に」Mailgunを使用しています。これは、SPFルックアップが同じIP範囲を指しており、実際には追加のルックアップを追加しないことを意味します。警告を削除するには、次のように簡素化できます：

```
v=spf1 include:mailgun.org ~all
```

これによりエラーが防止され、OneSignalメール送信に影響しません。

### 送信ドメインの複数のTXTレコード

送信ドメインには**1つ**のSPFレコードしか持つことができません。
[WhatsMyDNS TXT lookup](https://www.whatsmydns.net/#TXT)で複数のエントリがないことを確認してください。

***

## 配信性の問題

配信性の問題には、送信の遅延、スパムフォルダへの配置、メールバウンスが含まれます。

### 遅延メール

送信ドメインが新しい場合や評判が低い場合、ISP（Gmail、Outlook、Yahoo）は配信を遅延させる可能性があります。これは**レート制限**または**グレイリスト**と呼ばれます。[メールメッセージレポート](./email-message-reports)を確認すると、メッセージの送信にかかった時間の詳細を確認できます。

<Frame caption="OneSignalから3秒未満で送信されたメール">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-speed-message-report.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=ac366a1120913e1ee2204e7ce2baa4ed" alt="Email message report" width="2186" height="816" data-path="images/email/email-speed-message-report.png" />
</Frame>

この例では、メールがOneSignalから3秒未満で送信されたことがわかります。メールサービスプロバイダーに送信され、その後受信者のISPに送られます。これらのメールサーバーは、受信者に配信される前に最大数時間メールを遅延させる可能性があります。

<Note>
  配信を高速化するには、[メール評判のベストプラクティス](./email-reputation-best-practices)に従ってください。
</Note>

### メールがスパムに分類される

最も一般的な原因は、送信者の評判が悪いことです。[メール配信性](./email-deliverability)ガイドに従ってください。

サードパーティのESPを使用している場合は、以下を参照してください：

* [SendGrid: Deny lists](https://docs.sendgrid.com/ui/sending-email/deny-lists)
* [Mailgun: Blacklist info](https://help.mailgun.com/hc/en-us/articles/115005365027-What-Is-a-Blacklist-)
* [Mailchimp: Reputation & rejections](https://mailchimp.com/developer/transactional/docs/reputation-rejections/#rejected-emails)

### 同じドメインからの送信と受信

単一のドメインは、送信と受信に同じMXレコードを同時に使用できません。`@yourdomain.com`から**送信**し、同じドメインで**受信**したい場合：

* 送信DNSをOneSignalに維持します。
* MXレコードを受信メールプロバイダーに向けます（例：[Google Workspace MX records](https://support.google.com/a/topic/2683820?hl=en\&ref_topic=9202)）。

### 抑制リスト

アドレスが配信停止したり、スパムとしてマークしたりした場合、ESPはそのアドレスへの送信を抑制します。
再登録するには：

1. OneSignalで**Audience > Subscriptions**に移動します。
2. メールアドレスを検索します。
3. **Unsubscribe from Email**（登録されている場合）をクリックしてから、**Resubscribe to Email**をクリックします。
4. テストメールを送信して確認します。

### Apple Private Relay

`@privaterelay.appleid.com`アドレスに送信する場合は、[Apple Developer account](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service/)で送信ドメインを検証する必要があります。
未検証のドメインは、メールがドロップされる結果となります。

### APIキーの制限が厳しすぎる

SendGridまたはMailchimpを使用している場合は、APIキーに[最小限の必要な権限](./sendgrid-setup#what-are-the-minimum-api-restrictions-i-can-allow)があることを確認してください。

***

## メールデザイン

これらは、メールコンテンツ自体の問題です。

### リンクが機能しない

通常、CNAMEの構成が欠落しているか不正であることが原因です。
サードパーティのESPを使用している場合は、トラッキングドメインのセットアップに従ってください。

### ボタンがクリックできない

* URLが正しく、`https://`で始まることを確認してください。
* スパムフォルダからのテストは避けてください。一部のメールクライアントはそこでリンクをブロックします。

### プリヘッダーに画像を追加する

Gmailは、プリヘッダーのプロモーション画像（取引アノテーション、製品カルーセル）をサポートしています。
セットアップについては、[Gmail Developer Portal](https://developers.google.com/gmail/promotab/overview)を参照してください。

***

## メールサービスプロバイダー（ESP）

SendGrid、Mailchimp、またはMailgunとの統合の使用に関連する一般的な質問または問題。

### メールのために別のプロバイダーに支払う必要がありますか？

[OneSignalメールセットアップ](./email-setup)を使用する場合、メールアカウントを管理するため、別のメールプロバイダーを使用する必要はありません。Sendgrid、Mailchimp、またはMailgunを使用する予定の場合は、メールサービスプロバイダーに直接支払いを続ける必要があります。

## OneSignalのメールスループットはどのくらいですか？

OneSignalは通常、メールサービスプロバイダーに毎秒1,000〜5,000のレートでメッセージを送信します。ユーザーにメールを配信するのはESP次第です。

OneSignalはOneSignalメールにMailgunを使用しており、Mailgunは[1時間あたり最大1,500万通のメール](https://www.mailgun.com/blog/product/how-quickly-can-mailgun-process-my-messages-introducing-the-rapid-fire-throughput-sla/)をサポートできると宣伝しています。

***
