概要

お客様でご契約しているSendgridとKARTEをAPI連携し、KARTEの接客サービスを用いたメール配信とKARTE上での効果測定を実施することが可能です。

<連携イメージ>

例えば以下のように、KARTEとSendgridの両方のメール配信機能を活用することもできます。

KARTEでできること

  • KARTEのセグメントを使って、KARTE上で計測しているユーザー行動をトリガーとしたメール配信を行うことができます。
  • KARTEの接客サービスを作成して、SendgridのAPI経由でメール配信します。

Sendgridでできること

  • Sendgridのマーケティングキャンペーン機能を利用してメールの一斉配信ができます。
  • アドレスリストの登録やテンプレートの作成はお客様にて実施いただきます。
    ※Sendgirdの各種機能については、Sendgrid代理店へお問い合わせください。

ご利用の流れ

1.Sendgrid契約
2.ドメイン準備
3.Sendgrid API key 払い出し
4.KARTE管理画面でのSendgridプラグイン設定
5.Sendgrid Webhookの設定
6.接客サービス配信

1. Sendgrid契約

ご契約はお客様にてSendgridにお申込みいただきます。
フリープランから、KARTEとのAPI連携機能をご利用可能です。

(参考)料金プランはこちら

(注意事項)Sendgridはライセンスの譲渡および二次ライセンスが不可となっております。(参考サイト)受託や運用代行を行なっている企業様の代理申し込みはできないため、必ずご利用企業様から直接お申し込みください。

2. ドメイン準備

Sendgridの手順に従い、メール送信に利用するドメインのご準備とDNS設定をお願いいたします。
独自ドメインの利用を推奨しております。

(参考サイト)

3. Sendgrid API key 払い出し

Sendgridの管理画面の Settings > API keys より、API keyを作成します。
API Keyには、Full Accessもしくは以下の権限を設定してください。

  • 「Mail Send」の「Mail Send」
  • 「Stats」の「Stats Overview」

ここで作成したAPI keyを、項番4でKARTEに設定します。

4. KARTE管理画面でのSendgridプラグイン設定

プラグイン設定 > sendgrid より下記の内容に従って設定し、一番下にある保存ボタンより保存を行ってください。

設定項目 説明
有効化 「有効化」チェックボックスにチェックを入れてください
送信アドレス メール送信時のアドレスです。(ヘッダFrom)原則KARTEの送信用に払い出したドメインのアドレスを使用してください。※それ以外のドメインの場合、到達率が下がる可能性があることをご理解の上、ご利用ください。
送信者名 メール送信時の送信者名を設定してください。
返信先アドレス メールの返信先アドレスを設定してください。お客様が受信できるメールアドレスをご指定ください。
API key Sendgrid管理画面からAPI keyを払い出し、設定してください。
クリックトラッキングの無効化 メールのリンククリックの効果を測定する場合はチェックはいりません。
開封トラッキングの無効化 メールの開封の効果を測定する場合はチェックはいりません。
通知先メールアドレス 送信制限数に対する警告や上限に達したときのメール通知先を設定できます。

5. Sendgrid Webhook設定

SendgridのイベントをKARTEに連携するためのWebhook設定を行います。Sendgrid管理画面の Settings > Mail Settings > Event Notification に、以下のHTTP POST URLを設定してください。

「https://t.karte.io/hook/#{api_key}/sendgrid/event」

※上記URLの#{api_key}部分に、こちらで取得できるAPIキーを入力します。

6. 接客サービス配信

配信前に必ず下記をご確認ください。
(参照)メール配信 – 開始前に必ずお読みください

通常のKARTEのメール配信と同じように、接客サービスを配信してください。
(参照)メール配信 – 接客サービスを配信する

KARTEの接客サービスを使ってメール配信をすれば、KARTEのセグメントを使ったメール配信や、KARTE上で計測しているユーザー行動をトリガーとしたメール配信を、SendgridとAPI連携して送信することが可能です。

サービス仕様

1. メール送信条件

KARTEで取得しているユーザーデータを元に、以下の条件に当てはまる場合にKARTEからSendgridにメール送信リクエストを連携します。

  • ユーザータグ(identifyイベント)のemailが存在する
  • ユーザータグ(identifyイベント)のsubscriptiontrue
  • 2. メール停止条件

    KARTEでメール送信失敗(talk_message_fail)を検知すると、該当ユーザーデータのsubscriotionfalseにします。これにより次回以降配信がされません。

    また、Sendgridの機能でもバウンス管理機能があります。詳細はこちらをご確認ください。(参考)

    (注意)Sendgridのソフトバウンスの仕様としては、最大72時間リトライする仕組みがあります。リトライ結果送信成功した場合には、KARTEではメール送信失敗(talk_message_fail)とはなりません。

    メール再送条件:

    上記の仕様により、KARTEとSendgrid両方で停止条件を解除する必要があります。

    • KARTE
      • 該当ユーザーデータのsubscriotiontrueにすることで、再送可能状態になります。
    • Sendgrid
      • バウンスリストから該当アドレスを削除することで、再送可能になります。(参考

    3. イベント連携

    KARTEから送信したメールについては、Sendgrid側からKARTEに以下の結果イベントを連携しています。

    イベント名 プラグイン 説明
    _sendgrid_delivered sendgrid メールが正常に到達されたイベント
    _sendgrid_bounce sendgrid メールが正常に到達しなかったイベント
    _sendgrid_dropped sendgrid Sendgrid側でメールを配信しなかったイベント(Quotaを超えたなど)
    _sendgrid_spamreport sendgrid 受信者にスパム判定されたイベント

    4. 効果測定

    KARTEから送信したメールについては、開封・クリックを測定可能です。
    プラグイン設定画面で、「クリックトラッキングの無効化」「開封トラッキングの無効化」を行うと、トラッキングが無効になります。
    開封・クリックトラッキングが有効な時は、以下のようなイベントが発生します。

    イベント名 プラグイン 説明
    talk_message_open sendgrid メッセージを開封したイベント
    message_click sendgrid 短縮URLリンクをクリックしたイベント

    (参考) メール配信 – 開封数やクリック数を正しく計測できますか?

    その他

    • Sendgridの管理画面にてバウンスリストのダウンロードやバウンス登録解除が可能です。
    • Sendgridに関するサポートは、Sendgrid代理店にお問い合わせいただきます。