トランザクション・マーケティングメール
ドメイン認証、抑制リスト、配信イベントを備え、アプリケーションから SMTP または HTTP API でトランザクションメールとマーケティングメールを送信します。
トランザクション・マーケティングメールは、送信専用のメールサービスです。お使いのアプリケーションから SMTP または HTTP API 経由で、登録確認、パスワードリセット、領収書、アラート(トランザクションメール)や、ニュースレター、プロモーション(マーケティングメール)を送信できます。Yeap Cloud は各メッセージにお客様のドメインの DKIM 署名を付けて配信し、バウンスと苦情を処理し、すべての処理段階をイベントとして通知します。
コンソールでは、左側ナビゲーションの メールセクションにある メール配信にあります(/tm/streams)。
このサービスは送信専用です。受信トレイはなく、返信を受け取ることはできません。お客様のドメインでメールを受信するには、ドメインメールをご利用ください。
主な概念
| 概念 | 意味 |
|---|---|
| ストリーム | 購入の単位です。サブスクリプションごとにストリームが 1 つ作成され、各ストリームは独自のクォータ、API キー、送信ログ、Webhook、SMTP ホストを持ちます。アプリケーションごとに 1 つなど、複数のストリームを持つことができます。 |
| ストリームの種類 | トランザクションメールまたは マーケティングメールです。ストリームの購入時に選択し、後から変更することはできません。マーケティングストリームには、郵便住所、必須の配信停止リンク、より厳格なコンテンツスキャンという追加要件があります。 |
| API キー | ytm_ で始まるシークレットです。HTTP API の Bearer トークンであり、SMTP のパスワードでもあります(ユーザー名は常に apikey)。作成時に一度だけ表示されます。 |
| 送信ドメイン | From アドレスのドメインです。そのドメインから送信するには、事前に検証(DKIM レコードが有効になっていること)が必要です。ドメインはすべてのストリームで共用することも、1 つのストリームにバインドすることもできます。 |
| サンドボックス | 無料プランのストリームはサンドボックスから始まります(有料プランは対象外)。1 日あたり最大 100 通で、検証済みの受信者アドレス、またはお客様自身の検証済みドメインのアドレスにのみ送信できます。アカウントが信用レベル Lv2 に達するとサンドボックスは解除されます。 |
| 信用レベル | アカウントの送信レピュテーションで、Lv0 から Lv6 まであります。クリーンなメールを継続して送信すると上がります。無料プランでは月間送信量と 1 時間あたりの上限を決定します。有料プランでは 1 時間あたりの上限を増減させ、マーケティングストリームを利用できるかどうかを決定します。 |
| 抑制リスト | 送信対象外のアドレスです。ハードバウンスと苦情は自動的に追加され、配信停止はストリームごとに追加されます。お客様自身でアドレスを追加・削除することもできます。 |
| カテゴリ | メッセージに付ける任意のラベルです(API では category、SMTP では X-Yeap-Category ヘッダー)。送信ログの絞り込みや、受信者が特定の種類のメールだけを配信停止できるようにするために使用します。 |
| イベントと Webhook | 各メッセージは、キュー済み、配信済み、バウンス、苦情などのステータスを経て処理されます。これらはコンソールで確認したり、API で照会したり、お客様自身の HTTPS エンドポイントで受信したりできます。 |
プラン
本書の執筆時点では、以下のプランを提供しています。最新の料金と上限は、コンソールの ストリームを作成ダイアログに表示されます。
| プラン | 料金 | 月間送信数 | 含まれる送信量を超えた場合 | 送信ドメイン | 1 時間あたりの上限 | マーケティングメール |
|---|---|---|---|---|---|---|
| 無料 | 無料 | 0 通を含む。レベル別の許容量のみ(100–3,000) | 不可:翌月まで送信が停止します | 1 | レベルによる(20–500) | 不可 |
| ベーシック | ¥39/月 | 50,000 | 1,000 通あたり ¥0.80 | 3 | 2,000 × レベル係数 | 可(Lv2 以上) |
| TM プロ版 | ¥129/月 | 300,000 | 1,000 通あたり ¥0.60 | 10 | 10,000 × レベル係数 | 可(Lv2 以上) |
| TM エンタープライズ版 | ¥499/月 | 2,000,000 | 1,000 通あたり ¥0.40 | 無制限 | 50,000 × レベル係数 | 可(Lv2 以上) |
- 無料プランの送信量は信用レベルによって決まります。Lv1 では月 100 通で、Lv6 では 3,000 通まで増えます。1 つのアカウントで持てる無料ストリームは 1 つだけです。有料プランにはこの許容量はなく、表に記載された送信量が含まれます。
- 有料プランの 1 時間あたりの上限は、プランの値にレベル係数を掛けたものです。係数は Lv1 で ×0.5、Lv2 で ×0.75、Lv3 で ×1、Lv4 で ×1.25、Lv5 で ×1.5、Lv6 で ×2 です。
- 年払いは月額料金の 10 倍(年 ¥390、¥1,290、¥4,990)で、2 か月分が無料になります。
- 1 通 = 1 受信者です。 3 人の受信者に送信したメッセージは、月間送信量と 1 時間あたりの上限に対して 3 通としてカウントされます。
- 超過分は、開始した 1,000 通のブロックごとに課金されます。各有料プランには未払い超過分の支出上限(¥200、¥1,000、¥5,000)があります。上限に達すると、超過分の請求書を支払うまで送信が停止します。制限、サンドボックス、コンプライアンスをご覧ください。
- 無料プランはサンドボックスから始まります。有料プランは対象外です。アカウントが Lv2 に達するとサンドボックスは解除されます。
信用レベル
アカウントには Lv0 から Lv6 までの信用レベルがあります。新しいアカウントは Lv1 から始まります。無料プランでは、レベルによって月間送信量と 1 時間あたりの上限が決まります。有料プランでは、レベルによって 1 時間あたりの上限が増減し、マーケティングストリームには Lv2 以上が必要です。また Lv5 と Lv6 では自動一時停止のしきい値がやや緩和されます。Lv0 ではアカウントから送信できません。レベルは毎日評価され、アカウントの利用期間が長くなり、配信済みメールが増え、バウンス率と苦情率が低く保たれるにつれて、1 段階ずつ上がります。Lv2 に必要なのは、検証済みのアカウントメールアドレス、検証済みの送信ドメイン 1 つ、利用開始から 7 日以上のアカウントだけです。自動一時停止が発生するとレベルが 1 つ下がり、ウイルスを送信すると Lv0 に下がります。
メール配信ページの 信用レベルカードには、現在のレベル、今月の無料許容量の使用量(無料プラン)、次のレベルに必要な条件が表示されます。全体の表は制限、サンドボックス、コンプライアンスにあります。
クイックスタート
メール配信を開き、ストリームを作成をクリックします。
プランを選択し、
my-appなどの 名前を入力して、タイプとして トランザクションメールまたは マーケティングメールを選択します。マーケティングは有料プランでのみ利用でき、マーケティングメールを送信するにはアカウントの信用レベルが Lv2 以上である必要があります。プランに複数の請求サイクルがある場合は、請求サイクルで選択します。カートに追加をクリックし、チェックアウトで支払います。支払いが完了すると、ストリームが一覧に表示されます。
ストリームを開き、送信ドメインタブに移動して ドメインを追加をクリックします。送信に使うドメイン(
example.comやmail.example.comなど)を入力します。開いた DNS パネルでレコードを追加します。ドメインが Yeap Cloud DNS でホストされている場合は、ワンクリックで追加をクリックします。それ以外の場合は、お使いの DNS プロバイダーでレコードを追加します。送信ドメインと DNSをご覧ください。
検証をクリックします。DKIM レコードが有効になると、ドメインに 検証済みと表示されます。
API キータブに移動し、キーを作成をクリックして名前を入力し、キーをコピーします。キーは一度だけ表示されます。
テストメッセージを送信します。
bashcurl -X POST https://api.tm.yeapcloud.net/v1/send \ -H "Authorization: Bearer ytm_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "from": "Example <noreply@example.com>", "to": "you@example.com", "subject": "Hello from Yeap Cloud", "text": "It works." }'送信ログタブを開き、メッセージが 待機中から 配信済みになるまでを確認します。
ストリームがサンドボックスにある間は、お客様自身の検証済みドメインのアドレス、または サンドボックス受信者タブで検証したアドレスにのみ送信できます。他のプロバイダーのメールボックスでテストしたい場合は、先にそこにご自身のアドレスを追加してください。
ストリームページ
一覧のストリームをクリックすると開きます。ストリームに応じて、次のタブが表示されます。
| タブ | 用途 |
|---|---|
| 概要 | 月間使用量、1 時間あたりの残り許容量、7 日間または 30 日間の統計(送信数、配信率、バウンス率、苦情率、開封数、クリック数)、SMTP と HTTP API の設定 |
| API キー | API キーの作成と失効 |
| 送信ドメイン | 送信ドメインの追加、検証、削除 |
| 送信ログ | 過去 30 日間のメッセージと各メッセージのイベント |
| 抑制リスト | 送信対象外のアドレス |
| Webhook | お客様自身の HTTPS エンドポイントへのイベント送信 |
| マーケティング設定 | マーケティングストリームのみ:郵便住所、カテゴリ、開封とクリックのトラッキング |
| サンドボックス受信者 | ストリームがサンドボックスにある間のみ:テスト用に検証した受信者アドレス |
ストリームのステータス
| ステータス | 意味 | 送信 |
|---|---|---|
| 正常 | 通常の状態 | 許可 |
| 一時停止中 | バウンス、苦情、スパムの水準が高すぎたため、自動的に一時停止されています。理由はストリームに表示されます。 | 一時エラーで拒否されます。再開するにはサポートにお問い合わせください。 |
| 無効 | 更新料金が未払いであるなどの理由で、サブスクリプションが停止されています | サブスクリプションが再び有効になるまで拒否されます |
| 停止処分 | メッセージにウイルスが含まれていました。ストリームのすべての API キーが失効しています。 | 拒否されます。サポートにお問い合わせください。 |
次のステップ
- 送信ドメインと DNS:送信に使うドメインを追加して検証します。
- SMTP と HTTP API:アプリケーションを接続してメールを送信します。
- イベントと Webhook:配信状況を追跡し、お客様のサーバーでイベントを受信します。
- 抑制リストと配信停止:メールを受け取らない相手の管理と、配信停止の仕組みについて説明します。
- 制限、サンドボックス、コンプライアンス:信用レベル、送信上限、超過分、自動一時停止、送信ポリシーについて説明します。