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'

スキーマ

🚧

user_idやtargetのデータを取得する際の注意点

target(送信先情報)やuser_idなどはuser_data_listに格納されています。user_data_listはREPEATEDのカラムであるため、UNNESTしてuser_data_listのデータを展開することでuser_idやtargetをデータを取得いただけます。

※「deprecated」と表記されているものは現在使用していません。

Field NameDisplay NameDescription
event_hashイベントハッシュイベントの一連の流れを識別するIDです
event_nameイベント名以下のイベントが格納されています。

- message_ses_send:KARTEから配信エンジンへのリクエスト完了(メールでのみ発生します)
- message_send:送信成功
- message_fail:送信失敗
- message_open:開封(メールでのみ発生します)
- message_click:クリック
- message_unsubscribe:購読停止(メールでのみ発生します)
- message_subscribe:購読再開(メールでのみ発生します)
timestampタイムスタンプイベントが発生したタイムスタンプです。JSTではなくUTCである点に注意してください。
api_keyAPIキープロジェクトの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_pushはアプリプッシュ通知です。
schedule_task_id配信IDキャンペーンが繰り返しの場合、一回の配信を識別できるようにするIDです。
valuesvaluesにはイベントによって異なる値が格納されます。
message_click:クリックしたurlが入ります。
message_unsubscribe:購読停止された送信元アドレスが入ります。
error_typeエラータイプエラー原因の大項目が入ります。

SES_BOUNCE:メールのバウンス発生
SES_COMPLAINT:メールに対する苦情の発生
error_codeエラー原因エラー原因の小分類が入ります
error_messageエラーメッセージエラーメッセージが入ります
error_recoveries主にバウンスなどで、配信ができなくなったユーザーに再度配信を行うためのシステム用フィールドです