Messageのログテーブル

masspush_event_log_regionalビューは、KARTE Messageで計測しているログを参照できるビューになります。

（一部プロジェクトでは、 masspush_event_logというビューも存在しますが、同一のデータが取得可能です）

用途

KARTE Messageで計測した送信、開封、クリックなどのログをさまざまな分析にご利用いただけます。

反映タイミング

ログをそのまま参照している形なので、リアルタイムに結果を確認することが出来ます。

ご注意ください

ビューの場合、テーブル一覧画面、テーブル詳細画面でのレコード数の確認、及びプレビューはできません。実際のデータを確認したい場合はクエリ画面からクエリを実行してください。

ビューの参照方法

下記のようにビュー名を記述することで masspush_event_log_regional ビューへのクエリを実行することができます。

SELECT
  *
FROM
  `prd-karte-message-per-client.csv_upload_{{api_key}}.masspush_event_log_regional`

抽出対象データの期間指定

以下のようにtimestampまたは schedule_task_id で期間指定を行うことで、クエリリソースを節約してデータを抽出することができます。

SELECT
  *
FROM
  `prd-karte-message-per-client.csv_upload_{{api_key}}.masspush_event_log_regional`
WHERE
  timestamp < CURRENT_TIMESTAMP

SELECT
  *
FROM
  `prd-karte-message-per-client.csv_upload_{{api_key}}.masspush_event_log_regional`
WHERE
  schedule_task_id = '配信時に振られるID'

フィールド名	表示名	説明
event_hash	イベントハッシュ	イベントの一連の流れを識別するIDです
event_name	イベント名	以下のイベントが格納されています。 * message_ses_send：KARTEから配信エンジンへのリクエスト完了（メールでのみ発生します） * message_send：送信成功 * message_fail：送信失敗（送信成功していても苦情などの理由により送信失敗ログが後から発生することがあります） * message_open：開封（メールでのみ発生します） * message_delay：送信リトライ（メールでのみ発生します） * message_click：クリック * message_unsubscribe：購読停止（メールでのみ発生します） * message_subscribe：購読再開（メールでのみ発生します） * system_start：配信処理の開始 * system_error：配信処理の失敗 * system_success：配信処理の成功
timestamp	タイムスタンプ	イベントが発生したタイムスタンプです。JSTではなくUTCである点に注意してください。
api_key	APIキー	プロジェクトのAPIキーです
user_data_list	ユーザー情報	配信先をtarget、ユーザーIDをuser_idとしてREPEATED（配列）で保有します
┗ target	配信先	アプリプッシュであれば、FCMトークン。メールであればメールアドレスが暗号化された状態で入ります。
┗ user_id	ユーザーID	マスターリストで指定したリストのユーザーIDカラムの値が入ります。
campaign_id	キャンペーンID	キャンペーンを識別するIDです。URLの /campaign/xxx/ のxxxにあたる箇所です。
push_content_id	送信コンテンツID	送信コンテンツに自動付与されるIDです。
plugin_type	送信タイプ	どのチャネルで送信したかを示します。sesはメール。native_appはアプリプッシュ通知。lineはLINE配信です。
schedule_task_id	配信ID	キャンペーンが繰り返しの場合、一回の配信を識別できるようにするIDです。
values	-	valuesにはイベントによって異なる値が格納されます。 message_click：クリックしたurlが入ります。 message_unsubscribe：購読停止された送信元アドレスが入ります。
error_type	エラータイプ	エラー原因の大項目が入ります。 SES_BOUNCE：メールのバウンス発生 SES_COMPLAINT：メールに対する苦情の発生
error_code	エラー原因	エラー原因の小分類が入ります
error_message	エラーメッセージ	エラーメッセージが入ります
error_recoveries	-	主にバウンスなどで、配信ができなくなったユーザーに再度配信を行うためのシステム用フィールドです

message_delayは一時的にメールの受信サーバーがメール受け取りをできなかった際に発生する送信リトライがあったことを示すイベントです。message_delayが発生した結果、送信成功したらmessage_sendが発生します。message_delayが何度も発生しリトライ時間制限を超えてしまった場合は、message_failが発生します。message_delayが発生するたびにmessage_failが発生しているわけではないことにご注意ください。

Messageの設定情報テーブル

詳細については、KARTE Messageの設定情報テーブルを参照してください。

FAQ

Q. prd-karte-message-per-clientのデータセットは外部に共有できますか？

prd-karte-message-per-clientを外部に共有することは可能です。
手順については、KARTE Datahubのデータセットを外部に共有するを参照してください。

Q. `message_ses_send`の件数が `message_send`と `message_fail`の合計にならないのはなぜですか？

message_sendの後にmessage_failが発生することがあるからです。
message_ses_send・message_send・message_fail は、次のようにそれぞれ異なるタイミングで発生します。

イベント	発生タイミング
`message_ses_send`	KARTE から配信エンジン（SES）へのリクエストが完了した時点
`message_send`	受信サーバーが配信成功イベントを返却した時点
`message_fail`	配信失敗時、または配信成功後に受信サーバーから苦情が返された時点

Message関連のビュー