概要
このページでは、「Customer Datastore」で収集する「ユーザー行動ログ」の、イベントの種類について説明します。
「Customer Datastore」について、概要を知りたい方は Customer Datastore 構成の全体像 をご確認ください。
収集するイベントの種類
行動ログを収集するイベントの種類には、次のものがあります。
- ページ訪問
- 要素のクリック
- フォーム入力値の変更
- フォーム送信
- ページスクロール
- カスタム (任意タイミングで任意内容を送信)
ページ訪問
- 送信タイミング: 画面遷移したとき
サンプルログ
{
"type": "visit",
"ts": 1543212772654,
"log_id":"4d07c4e9-c165-b816-b021-107920b27d37",
"jsid": "f7e315f86c0deff6",
"uuid": "da035e96-5825-a597-59cd-893c631fb982",
"sid": "093187eca907",
"sct": 19,
"lct": 4,
"td": 13748,
"mb": true,
"tz": -540,
"lang": "ja",
"bsid":"db89effae041",
"buex": 0,
"ssz": "375x812",
"custom": {},
"cookies": { "_kz_debug": “1" },
"debug": 1
}
要素のクリック
- 送信タイミング: 画面のどこかをクリックしたとき
サンプルログ
{
"type": "click",
"ts": 1543222136484,
"log_id": "fc1efb4d-51a3-edad-8b58-c52a95422000",
"jsid": "ab810d05ecdcf44d",
"uuid": "1d1e67e4-db98-72b3-3158-9d9f1b2fe07f",
"sid": "a737406f5686",
"sct": 11,
"lct": 38,
"td": 670,
"mb": true,
"tz": -540,
"lang": "ja",
"bsid": "463458168630",
"buex": 1,
"ssz": "375x812",
"sch": 8981,
"custom": {},
"vars": { "isDo119481": 1 },
"debug": 1,
"vid": "30d33278-7f5a-fbfa-2972-727ddb1a8cba",
"tgn": "input",
"tgi": "name1",
"tgc": ".widthS",
"tgp": "!p;;|!div;;.name|!td;;|!tr;;|!tbody;;|!table;;|!div;;.formContents|!form;;|!div;;.main|!div;#content;.clearfix|!div;#container;",
"tga": "name=name1"
}
フォームの編集
- 送信タイミング: フォームの入力項目 (input, select, textarea タグ) の value を変更し、確定したとき
- セキュリティ観点から、入力された値 (value) は送信するログに一切含まれません
サンプルログ (input タグの場合)
{
"type": "change",
"ts": 1543222767396,
"log_id": "1e3eb65e-494e-bcd6-0d61-0ebb26cc8471",
"jsid": "ab810d05ecdcf44d",
"uuid": "1d1e67e4-db98-72b3-3158-9d9f1b2fe07f",
"sid": "a737406f5686",
"sct": 11,
"lct": 46,
"td": 9460,
"mb": true,
"tz": -540,
"lang": "ja",
"bsid": "463458168630",
"buex": 1,
"ssz": "375x812",
"sch": 8981,
"custom": {},
"debug": 1,
"vid": "30d33278-7f5a-fbfa-2972-727ddb1a8cba",
"tgn": "input",
"tgi": "name1",
"tgc": ".widthS",
"tgp": "!p;;|!div;;.name|!td;;|!tr;;|!tbody;;|!table;;|!div;;.formContents|!form;;|!div;;.main|!div;#content;.clearfix|!div;#container;",
"tga": "name=name1"
}
サンプルログ (select タグの場合)
{
"type": "change",
"ts": 1543222610075,
"log_id": "cda53707-7de1-009e-da70-7ac7b9517a22",
"jsid": "ab810d05ecdcf44d",
"uuid": "1d1e67e4-db98-72b3-3158-9d9f1b2fe07f",
"sid": "a737406f5686",
"sct": 11,
"lct": 43,
"td": 1920,
"mb": true,
"tz": -540,
"lang": "ja",
"bsid": "463458168630",
"buex": 1,
"ssz": "375x812",
"sch": 8981,
"custom": {},
"vars": { "isDo119481": 1 },
"debug": 1,
"vid": "30d33278-7f5a-fbfa-2972-727ddb1a8cba",
"tgn": "select",
"tgi": "birth_month",
"tgc": ".hasCustomSelect",
"tgp": "!p;;|!div;;.ymd|!td;;|!tr;;|!tbody;;|!table;;|!div;;.formContents|!form;;|!div;;.main|!div;#content;.clearfix|!div;#container;",
"tga": "name=birth_month"
}
フォーム送信
- 送信タイミング: フォームを送信したとき
# 例: 以下のフォームの submit ボタンをクリックした場合
<form id="foo" action="/confirm">
<input type="submit" value="送信">
</form>
サンプルログ
{
"type":"submit",
"ts":1547526517174,
"log_id":"b83f7220-cdc5-ea43-2f21-2b1486713c8e",
"jsid":"1381962cca2643af",
"uuid":"680de27f-a1da-115d-baa1-1ea33e6369ba",
"sid":"ef317e4ffda6",
"sct":26,
"lct":7,
"td":9,
"mb":false,
"tz":-540,
"lang":"ja",
"bsid":"e4d84f13ca73",
"buex":0,
"ssz":"846x766",
"sch":320,
"custom":{},
"cookies":{},
"debug":1,
"vid":"b88e3588-e249-7acc-bd76-83508a65874b",
"tgn":"form",
"tgi":"foo",
"tga":"action=/confirm"
}
ページスクロール
- 送信タイミング: ページスクロールが開始したとき
- site dockのスクロールマップに利用している情報です。スクロールマップだけが表示されない場合、お手数ですが サポート にお問い合わせください。
サンプルログ
{
"type":"scroll",
"ts":1547526734922,
"log_id":"db8b65a3-ca8d-cdca-1a1c-fb563ed7ab77",
"jsid":"46e1a5a354fa82b6",
"uuid":"4fe8fa59-1723-73b8-1d6e-b2f35d9bb045",
"sid":"6e88b895e907",
"sct":3,
"lct":4,
"td":4867,
"mb":false,
"tz":-540,
"lang":"ja",
"bsid":"86345763c3c0",
"buex":0,
"scp":1161,
"sst":446,
"ssz":"846x766",
"sch":10166,
"custom":{},
"debug":1,
"vid":"2bc7f971-bc7f-ee5b-d4ee-a40ed53b7624"
}
カスタム(任意のタイミングで任意内容を送信)
- 送信タイミング: 任意
- 以下のような JavaScript API を実行する事で、任意タイミングで任意の値をログ送信する事が可能です。
- 後ほど集計時に同値を利用する事で、カスタムな指標を使った集計・分析が可能です。
JavaScript API 仕様
kzs('trackCustomEvent', {
key1: value1, // 第二引数の object に任意の key/value ペアを指定、それらがログとして送信されます
key2: value2,
...
});
コードサンプル
// とある入力フォームの名前 input 項目で、入力エラーが発生した事をログ送信する
$(function() {
var $input = $('#form input[name=Sei]');
if($input.hasClass('hasError') == false)
return;
kzs('setCustomEvent', {
event: 'input-error',
target: 'Sei'
});
});
0 コメント