# SendGrid Output Streaming Integration

SendGridは、メールサーバーを維持することなくメールを送信できるクラウドベースのSMTPプロバイダーです。

この連携により、リアルタイムアクティベーションの一環として、マーケティングキャンペーンでメールを送信するようSendGridに指示することができます。

## 前提条件

- Treasure Dataの基本知識
- SendGridプラットフォームの知識（[動的テンプレートの作成方法](https://docs.sendgrid.com/ui/sending-email/how-to-send-an-email-with-dynamic-templates)および[メールの送信方法](https://docs.sendgrid.com/ui/sending-email)に関する知識を含む）


## API情報

Treasure Dataは、[Mail Send API](https://docs.sendgrid.com/api-reference/mail-send/mail-send)を使用してSendGridにメールメッセージの送信を指示します。このAPIのRequest Bodyに関するドキュメントは、SendGridでメールテンプレートを設定する際に非常に役立ちます。

## 使用例

このストリーミング連携の主な使用例は、リアルタイムアクティベーションのワークフローに組み込むことです。このワークフローの設定方法の概要は以下のとおりです：

1. [SendGridダッシュボード](https://login.sendgrid.com/login/identifier)で、送信したいメール用の[動的テンプレート](https://docs.sendgrid.com/ui/sending-email/how-to-send-an-email-with-dynamic-templates)を作成します。
2. [SendGridダッシュボード](https://login.sendgrid.com/login/identifier)で、[メールを送信](https://docs.sendgrid.com/ui/sending-email)するようSendGridを設定します。
3. Treasure コンソールで、この連携がSendGridと通信するための認証を作成します。
4. Real-time Journeyで、新しいトリガーアクティベーション用にこの認証を選択します。


## 要件と制限事項

SendGridの*Mail Send*または*Send Test Marketing Mail*機能を使用する場合、いくつかのレート制限と制約が適用されます：

- メールの合計サイズ（添付ファイルを含む）は30MB未満である必要があります。
- 受信者の合計数は1000を超えてはいけません。これには、含めるオブジェクトごとのpersonalizations配列のto、cc、およびbccパラメータで定義されたすべての受信者が含まれます。
- custom argumentsの合計長は10,000バイト未満である必要があります。
- fromフィールドはUnicodeエンコーディングをサポートしていません。
- to.name、cc.name、およびbcc.nameのpersonalizationsには、カンマまたはセミコロンを含めることができません。
- substitutionの場合、NULL値は空の文字列に切り捨てられます：**" "**。substitutionが数値列の場合は、文字列に変換されます。
- *Mail Send*操作の場合：
  - 「Template ID」は、Personalization Bodyで定義されたsubstitutionを上書きします。
  - 「Skip invalid records」は、無効なpersonalization bodiesに対してのみ適用されます。
- *Send Test Marketing Mail*操作の場合：
  - 「Unsubscribe URL」または「Suppression group ID」のみを使用してください。
  - 「Skip invalid records」は、無効なメールに対して適用されます。


## SendGrid APIキーの取得

SendGridアプリケーションへの接続を確立するには、[SendGrid APIキー](https://docs.sendgrid.com/ui/account-and-settings/api-keys)が必要です。アプリケーション、メールクライアント、またはWebサイトは、これらのAPIキーを使用して認証できます。

Treasure Dataでは、すべてのSendGridサービスへの接続にAPIキーを使用することを推奨しています。これは、ユーザー名とパスワードを使用する代替手段として推奨されます。APIキーは、ユーザー名やパスワードの変更を必要とせず、いつでも取り消すことができるためです。

Sendgridで使用できるAPIキーには、次の種類があります：

- **Full Access** - APIキーがアカウントのすべての部分（請求とEmail Address Validationを除く）のGET、PATCH、PUT、DELETEおよびPOSTエンドポイントにアクセスできるようにします。
- **Restricted Access** - アカウントのすべての部分（請求とEmail Address Validationを除く）のアクセスレベルをカスタマイズします。
- **Billing Access** - APIキーがアカウントの請求エンドポイントにアクセスできるようにします。


SendGrid Webサイトから：

1. 左側のナビゲーションバーで**Settings**に移動します。
2. **API Keys**を選択します。
3. Treasure DataがSendGridへのリクエスト送信時に使用するAPIキーの値をコピーまたは書き留めます。


## Treasure コンソールを使用して接続を作成する

Treasure Dataでは、クエリを実行する前にデータ接続を作成および設定する必要があります。データ接続の一部として、連携にアクセスするための認証を提供します。

1. **Treasure コンソール**を開きます。
2. **Integrations Hub > Catalog**に移動します。
3. Catalog画面の右端にある検索アイコンを選択し、**SendGrid Output Streaming**と入力します。
4. SendGrid Output Streamingコネクターにカーソルを合わせ、**Create Authentication**を選択します。
![](/assets/sendgrid_streamingout.f3437c038ef03a6fb15b1e061599e566cdbf2168e764a86471e314124e633dbd.157ac480.png)
5. 必要な認証情報を入力します。
![](/assets/sendgridoutputstreamingauth.4a5957a94252233f39d7e1cbc3f73bb2a7bc67324515b1899d735ef813f5d001.157ac480.png)
6. 接続の名前を入力します。
7. **Done**を選択します。


SendGrid Output Streaming連携が、リアルタイムカスタマージャーニーアクティベーションに組み込めるようになりました。詳細については、[リアルタイムトリガーアクティベーションの作成](/products/customer-data-platform/journey-orchestration/realtime/creating-a-real-time-triggered-activation)を参照してください。