Activity FeedのBeta版が公開されたので触ってみた

数日前からSendGridでActivity FeedのBeta版が公開されたのでざっと触ってみました。今のところ、すべてのアカウントで使えるようになっているわけではなさそうです。

新しいActivityへの切り替え

左メニューからActivityを選択するといきなりTry the Betaの表示が出てきます。ボタンを選択して切り替えていきます。ちなみに、一度切り替えると、元に戻すメニューは見つかりません。ブラウザを変えると古いActivityに戻るので、ひょっとするとブラウザ側で設定がキャッシュされているのかもしれません。


※2018/3/11追記
元に戻すメニューが発見されました（@kikutaro_さんに教えていただきました）。これは気付かない！

主な機能



これまでのActivityと比べてパッと見で機能がたくさんありそうです。ざっと見ただけで以下のようなものがありそうです。

  • 検索機能が充実
    • 以前のActivityでは、宛先アドレス/ドメインとイベント種別でしかフィルタできませんでしたが、新しいActivityではとても高度な検索が行えるようになっています。詳しくは後述します。
  • CSV形式でダウンロード
    • 以前のActivityでは画面に表示されているデータのダウンロードはできませんでしたが、新しいActivityでは画面上に表示されるデータがダウンロードできるようになりました。
  • イベント単位の表示からメール単位での表示に
    • 以前のActivityではイベント単位で表示されていました。各イベントの紐付けはSMTP-IDを見つつユーザ側で行う必要がありましたが、新しいActivityではメール単位でイベントがまとめて表示されるため、イベントの紐付けを行う必要がなくなり、とても見やすくなりました。これも詳しくは後述します。
  • 配信状態がひと目で分かる
    • 一番知りたい「結局どうなったの？」という情報は配信状態で表されるようになりました。配信状態には「Delivered（届いた）」「Processing（処理中）」「Not Delivered（届かなかった）」の3状態があります。
  • 宛先アドレスと件名がひと目で分かる
    • 以前は宛先アドレスしか確認できませんでしたが、これに加えて件名が確認できるようになりました。
  • 開封数とクリック数がひと目で分かる
    • そのメールが開封された回数とクリックされた回数が表示されるようになりました。

検索機能の充実

検索機能はBasic SearchとAdvanced Searchを切り替えることができます。それぞれ以下の条件で検索ができます。Advanced Searchは指定可能な項目が多すぎるので省略します。画面から雰囲気を感じ取ってください。
  • Basic Search
    • 宛先アドレス
    • イベントの発生期間
  • Advanced Search
    • 宛先アドレス
    • イベントの発生期間
    • その他たくさん（詳細は以下のキャプチャ参照）


詳細情報の確認

各行を選択すると、画面右からシュッとパネルがスライドインしてきます。このパネルにはメールの詳細（Email Information）とイベントの発生履歴（Event History）が表示されます。



メールの詳細

Email Informationでは以下の情報が表示されます。これまで確認できなかった送信元アドレスやAPIキー情報、件名などが確認できるので、どのメールかがわかりやすくなりました。
  • 宛先アドレス
  • 送信元アドレス
  • 件名
  • 使用したAPIキー情報（APIキー名、APIキーID）
  • メッセージID
  • 送信元IPアドレス

イベントの発生履歴



    Event Historyでは、発生したイベントが上から下に向かって時系列で表示されます。加えてそのイベントが発生した理由、宛先サーバからの生の応答内容、その後SendGridがどういう挙動をするか、など詳しい情報が得られます。いくつかのケースでどんな表示になるか見てみます。

    正常に届くケース 


    • Processed
      • Processedはメールの送信リクエストをSendGridが受け付けたことを意味します。これが出た後、SendGridは指定された宛先にメールの送信を試みます。Processedが記録されていない場合（Activityにレコードが表示されていない場合）リクエストに失敗しているので、詳細な原因の調査するにはリクエストの応答内容を確認してください。
    • Delivered
      • SendGridが宛先サーバに送信を試みた結果、宛先サーバが正常応答を返したことを意味します。Deliveredが発生しているにも関わらずメールが受信トレイに届かない場合、迷惑メールフォルダに振り分けられたり、宛先サーバ内で滞留していると考えられます。そんなときは、宛先サーバの管理者に問い合わせましょう。
    • Opened
      • Open Tracking機能を有効化した状態で受信したメールを開封するとOpenイベントが発生します。テキストメールでOpenイベントは発生しません。
    • Clicked
      • Click Tracking機能を有効化した状態でメール本文内のURLをクリックするとClickイベントが発生します。画面ではクリックされたURLも確認できます。
    • Unsubsucribe
      • Subscription Tracking機能を有効化した状態でメール本文内の配信停止リンクをクリックするとUnsubscribeイベントが発生します。この宛先はGlobal Unsubscribeリストに登録され、以降メールを送信しようとすると破棄（Drop）されるようになります。




    ハードバウンスするケース 


    • Bounced
      • 宛先アドレス誤りなど、宛先サーバからバウンス応答が返ると、Bouncedイベントが発生します。いわゆるハードバウンスです。画面から、以降SendGridは同じ宛先にメールを送信しないことがわかります。また、宛先サーバが返したバウンスの応答内容が表示されるので、これを元にバウンスの原因を調査できます。

    送信したメールが破棄されるケース 


    • Dropped
      • 過去にバウンスした宛先（バウンスリストに掲載されている宛先）や、配信停止されていた宛先（配信停止リストに掲載されている宛先）に送信を試みるとDroppedイベントが発生します。これは、SendGridがメールの送信リクエストを破棄してメールを送信しなかったことを意味します。詳しくは詳細を見ると確認できます。

    ソフトバウンスするケース 


    • Deferred
      • 宛先の問題などで送信を試みたメールが正常に届かなかった場合、Deferredイベントが発生します。いわゆるソフトバウンスです。今回はメールサーバをダウンさせた状態にして意図的に発生させました。この際、Deferredイベントの横に試行回数（Attempt）が表示されます。SendGridが必要と判断した場合、一定期間再送を試みます。その際に発生した詳細な状況も表示されます（今回はタイムアウトが起きていることがわかります）。

    まとめ

    個人的には今までのActivityに不満は特に感じていませんでしたが、新しいActivityの圧倒的な機能アップでトラブルシューティングがとても行いやすくなったと感じました。また機能だけでなく、送信リクエストがSendGridでどう扱われているかが直感的にわかるUIになったので、「あれ、この時どういう挙動をするはずなんだっけ」って感じでドキュメントを見返すケースが減るんじゃないかと思います。あとは画面が日本語化されると完璧じゃないかと思います。









    コメント

    コメントを投稿

    このブログの人気の投稿

    Execノードを使う

    イメージ
    ここのところずっと Node-RED のサンプルを見ながら各ノードの使い方を確認しています。 頭出しの記事はこちら をご確認ください。今回はExecノードです。Execノードを使うと外部のコマンドを実行することができます。コマンドが出力した、標準出力や標準エラー出力などをノードから出力できます。 標準出力の内容を出力する 最初に確認するサンプルは「 flows > node-red > function > exec > 01 - Get standard output from external command 」です。 Execノードのプロパティを見ると以下の通りになっています。 実行コマンドは「 echo 」 msg.payload で受け取った値を引数として利用 出力モードは「 コマンド終了時 - execモード 」 コマンド終了時に結果を出力します Execノードには出力ポートが3つあります。 標準出力 標準エラー出力 返却コード 実行すると、標準出力には「 Hello World! 」、返却コードには「 {code : 0} 」が出力されます。この挙動は特に説明することはないかと思います。 標準エラー出力の内容を出力する 次に確認するサンプルは「 flows > node-red > function > exec > 02 - Get error output from external command 」です。外部コマンドのエラーをポートに出力します。中身は先程のサンプルフローとほぼ同じですが、Execノードで存在しないコマンドを実行しています。 実行すると、以下のログが出力されます。これも説明不要かと思います。 実行中に出力する 最後に確認するサンプルは「 flows > node-red > function > exec > 03 - Run external command in spawn mode 」です。出力がコマンド実行中に行われるのがこれまでのサンプルと違う点です。 コマンドはwhieループ内で2秒おきに「 Hello 」を標準出力に出力し続けます。Spawnモードで実行するとループ内でechoコマンドが実行されるたびにログが出力されます。サービスっぽい...
    続きを読む

    SendGridのX-SMTPAPIヘッダの使い方（Section Tags、Substitution Tags編）

    イメージ
    前回に引き続き SendGrid についてです。 今回は SMTP API を使ってみました。 SMTP APIについて SendGridのSMTP APIは基本的には普通のSMTPプロトコルに則ったものですが、X-SMTPAPIヘッダというカスタムヘッダを使うことで機能を拡張することができます。 X-SMTPAPIヘッダについて X-SMTPAPIヘッダはSMTPプロトコルの拡張ヘッダです。 X-SMTPAPI: { "category": "newuser" } みたいな感じでJSON形式でパラメータを与えることで機能を拡張します。 Section TagsとSubstitution Tagsについて 今回はSMTP APIで使える機能のうちSection TagsとSubstitution Tagsを使ってみました。 Section TagsとSubsitution Tagsは送信メールの内容を宛先毎に特定の文字列を置換するための機能です。toと合わせて使うことで機能します。 例えば、X-SMTPAPIヘッダの値を以下のような形にします。 { "to": ["test1@xxx.xxx", "test2@yyy.yyy"], "sub": { "-body-": [ "-bodyFemale-", "-bodyMale-" ], "-favorite-": [ "バナナ", "カツオ" ], " "-nickname-": [ "ミキ", "サブロー" ] }, "section": { " "-bodyFemale-": "-nickname-さん！女性向けの商品のご紹介です。", "-bodyMale": "-nickn...
    続きを読む

    Joinノードを使う（その4）

    イメージ
    ここのところずっと Node-RED のサンプルを見ながら各ノードの使い方を確認しています。 頭出しの記事はこちら をご確認ください。今回はJoinノードの4回目です。終わらねぇ。 確認するサンプルは、 前回 に引き続き「 読み込み > サンプル > flows > node-red > sequence > join > 02 - Manual join mode 」です。 メッセージを結合してkey/valueオブジェクトにする 5段目のフローから見ていきます。ざっくりとした流れは以下のとおりです。 DataノードでCSVデータを送信する CsvノードでCSVデータをJSONオブジェクトに変換する msg.payloadには以下のような値が指定されたメッセージ4つに分解される { name: "Apple", price: 100 } Changeノードでmsg.payload内の値を以下のプロパティに設定する msg.topic = "Apple"（msg.payload.nameの値） msg.payload = 100（msg.payload.priceの値） Joinノードで、2個の受信メッセージごとにmsg.topicの値をキーとしてkey/valueオブジェクトに結合して送信する これを実行すると、以下のようにmsg.payloadにJSONオブジェクトが指定されていることを確認できます。 メッセージを結合して結合オブジェクトにする 先ほどは結合した値がkey/valueオブジェクトでしたが、6段目のフローでは単純にオブジェクト結合します。ざっくりとした流れは以下のとおりです。 DataノードでJSON配列を送信する nameをキーに持つオブジェクトとpriceをキーに持つオブジェクトを交互に含んでいます（実際、こんなに都合の良いデータが生成されることはあるんだろうか） Splitノードで配列データを個別のメッセージに分割します Joinノードで、2個の受信メッセージごとにオブジェクトに結合して送信する これを実行すると、以下のようにmsg.payloadに2個ずつのオブジェクトがJSONオブジェクトに結合されたものが指定されていることを確認できます。ちなみに、Joinノード...
    続きを読む