前回のチュートリアルでは、ログ・ファイルのダウンロードについてご案内しました。実際にダウンロードしたファイルを開いてみましたか?
たった一通のSMS送信の記録にしては、項目がずらりと並んでいて、驚かれたかもしれないですね。シンプルなようでいて、SMS送信には、様々な要素があることがおわかりいただけたかと思います。
今回は、ダウンロードできるファイルの種類とファイル内の項目について、ご説明いたします。
ログ・ファイルのファイル形式
パソコンで扱うファイルには、それぞれファイル名の最後にピリオド(ドット)で区切られた英数字 1〜4字で構成される 拡張子 がついています。 例えば、画像ファイルには「jpg」や「png」、表計算ファイルには「xlsx」や、圧縮ファイルは「zip」などで、これによって、ファイルの種類が識別されています。
EZSMSのアカウントページからダウンロードできるログ・ファイルは「CSV」という拡張子がついた .csv形式のファイル です。 このファイルは、テキストファイルなので、そのまま開くと、項目が「,」(コンマ)で区切られた形で表示されますが、エクセルなどの表計算ソフトで開くと、簡単に見やすい罫線引きの表として表示できます。
例)
.csvファイルをテキストファイルとして開く
国名,首都,国土面積,人口,通貨
日本,東京,"377,973,89km2", 1億2614万6099人,円
アメリカ合衆国,コロンビア特別区,"9,834,000km2",3億3100万3000人,USD
.csvファイルを表計算ファイルとして開く
国名 | 首都 | 国土面積 | 人口 | 通貨 |
---|---|---|---|---|
日本 | 東京 | 377,973,89km2 | 1億2614万6099人 | 円 |
アメリカ合衆国 | コロンビア特別区 | 9,834,000km2 | 3億3100万3000人 | USD |
表計算ソフトで開くと、人間の目にとって見やすく、その後分析に使うように、データの並べ替えや分類を行ったり、計算式を入れて計算するのに便利ですね。
ログ・ファイルを読もう
さて、開き方がわかったところで、EZSMSでダウンロードできる、SMS送信のログ・ファイルの読み方をご紹介します。
ファイル内にあるデータは、横位置業に一件の送信についての詳細が、項目ごとに記されています。
その項目は、下記のとおりです。
項目 | 日本語 | 説明 | |
---|---|---|---|
1 | SEND TIME (LOCALTIME) |
送信日時 | EZSMS側でメッセージの送信リクエストを受け付けた時刻。(※1) |
2 | LATEST STATUS UPDATED TIME (LOCAL TIME) |
送信ステータス 最新更新日時 |
SMS送信ステータスを更新した時刻。(※1) |
3 | DELIVERY END TIME (LOCALTIME) |
送信終了日時 | 送信完了時刻。(※1)メッセージが不達の場合でも送信完了といいます。 |
4 | MESSAGE ID | メッセージID | 各メッセージに特定するため固有のID。ある特定の送信について、問い合わせをいただく際に必要です。 |
5 | RECIPIENT | 受信者の電話番号 | 送信の宛先 |
6 | SENDER ID | 送信元ID | 送信時に送信元として設定されたID |
7 | MESSAGE | メッセージ本文 | 設定されたメッセージ |
8 | MESSAGE STATUS | 送信ステータス | メッセージの送信状況です。以下のステータスのいずれかになります。 MESSAGE_DELIVERY_COMPLETE 正常に配信完了しました。 MESSAGE_PASSED_TO_CARRIER_FOR_DELIVERY メッセージはキャリアに渡っています。配信完了までしばらくお待ちください。 MESSAGE_EXPIRED メッセージはキャリアまで渡っていますが、キャリアが決めたリトライ回数に達しても宛先の携帯電話まで着信できなかったため配信できませんでした。 MESSAGE_DELIVERY_FAILED 配信に失敗しました。考えられる理由として こちら をご覧ください。 |
9 | USED_POINTS | 消費ポイント数 | このメッセージの送信が消費したポイント数 参照: 料金ページ |
10 | SHORTLINK STATUS | ショートリンクの ステータス |
リンクトラッキングを使った送信時に、リンク(URL)がアクセスされたかどうかを示します。 0 の場合 リンクはアクセスされていません 1 の場合 リンクはアクセスされています |
11 | SHORTLINK URL | ショートリンクURL | リンクトラッキングに使われた、ショートURL (有効期限は生成後90日です) |
(※1)ここで表示される日時は、ご利用登録時に選択された「タイムゾーン」に基づいています。ログ・ファイルの日時が実際の送信時間と大幅にずれている場合、アカウント情報を確認いただき、ご利用のアカウントが、日本時間に設定されていることをご確認ください。
「タイムゾーン」の設定を含めた送信ログの読み方は、ヘルプページを参照してください。
今回のチュートリアルは、ここまでです。
ログ・ファイル内に並ぶ、たくさんの項目の読み方がおわかりいただけましたか?
次回は、ログ・ファイルの保存についてです。
お楽しみに。