1)管理画面の「ヒートマップ登録・削除」⇒「登録」ボタンを押下。
2)以下のモーダルウィンドウが表示され、ヒートマップを導入するURLを入力し、「登録」ボタンを押下。そのあと確認アラートが表示されますが「OK」ボタンを押下。
3)登録が完了したらヒートマップ一覧に追加したURLが表示されます。
4)「Key」タブを押下すると、「ClientKey」と「ManageKey」が表示されます。導入には「ClientKey」を使用します。
5)登録したURLのファイルのheadタグ内に以下のタグを挿入してください。
<script src="https://js.heat-lab.net/v1/heatmap.js"></script>
<script>
HeatMapkey="[ここに上記4)の「ClientKey」を埋めてください]";
HeatMapFreeWord="[ここに任意の文字が入れることが可能です。用途は個人の特定やA/Bテストに使用できます]";
</script>
-----------------------*)赤字部分に「ClientKey」を挿入してください
6)ヒートマップ化したいエレメントのclassにモニタリングするclass名を入力してください。
<div class="HeadMap_MouseMove HeadMap_MouseDown HeadMap_TouchDown HeadMap_TouchMove HeadMap_BreakAreaV HeadMap_ReadAreaV HeadMap_EndAreaV">
~~~~~ 任意のコンテンツ ~~~~~
</div">
-----------------------*)赤字部分の機能は以下の通りです。使用者のご都合に応じて追加をしてください。
HeadMap_MouseDown | ユーザーがマウスをクリックすることでクリックした位置を記録します。 |
HeadMap_MouseMove | ユーザーがマウスを動かすことでマウスの軌跡を記録します。 |
HeadMap_TouchDown | ユーザーがタップすることでタップした位置を記録します。 |
HeadMap_TouchMove | ユーザーがスワイプすることでなぞった軌跡を記録します。 |
HeadMap_BreakAreaV | ユーザーがそのページを離れた位置を記録します *)縦スクロールのみ有効 |
HeadMap_ReadAreaV | ユーザーがそのページを熟読したを位置を記録します *)縦スクロールのみ有効 |
HeadMap_EndAreaV | ユーザーがそのページをどれだけスクロールしたかを記録します *)縦スクロールのみ有効 |
7)導入が完了いたしましたら、早速、テストしてみてください。以下画面の右側に件数がカウントされましたら導入は成功です。
1)ヒートマップ化できる範囲には上限があります。
ヒートマップを導入するエレメントの位置がブラウザの左上から4000pxを超える場合(以下図の①②に該当)
エレメントのサイズ(width、height)が4000pxを超える場合(以下図の③④に該当)
1)ヒートマップの照会方法には以下2通りあります。
・管理画面による照会
・APIによる照会
本項は管理画面による照会を案内いたします。
*)APIによる照会を希望の方は次項に進めてください
2)管理画面の「ヒートマップ照会」を押下。右側の必須項目を入力頂いたら「ヒートマップ照会」ボタンを押下。
3)ヒートマップの照会に成功いたしますと、同画面の下部にヒートマップ情報が表示されます。
データ量に応じて処理時間がかかる場合があります。
4)検索条件にマッチするデータがない。又はヒートマップの照会の連続処理を行いますと以下の通りの画面が表示されます。
【HTTPリクエスト】
https://api.heat-lab.net/v1/GetHeatPic
【メソッド】
GET
【リクエストボディ(GETパラメータ)】
プロパティ | タイプ | 桁数 (文字数) | 必須 | 説明 |
---|---|---|---|---|
id | 半角英数字 | 50 | 必須 | ヒートマップを照会したいManageID |
key | 半角英数字 | 50 | 必須 | 「ヒートマップの導入方法」の4)にて発行したManageKey |
ws | 半角数字 | 4 | 必須 | ヒートマップを導入したエレメントのWidthの開始幅。 0~4000の範囲を指定 |
we | 半角数字 | 4 | 必須 | ヒートマップを導入したエレメントのWidthの終了幅。 0~4000の範囲を指定 |
co | 半角英字 | 30 | 任意 | 国 |
pr | 半角英字 | 30 | 任意 | 都道府県/州 |
fw | 半角英数字 | 20 | 任意 | フリーワード |
d | 半角英字 | 5 | 必須 | デバイスの指定。 「PC」または「Smart」のいずれか指定 |
a | 半角英字 | 10 | 必須 | マウス/タッチ/離脱エリア/注目エリア/終了エリアの指定。 「MouseDown」「MouseMove」「TouchDown」「TouchMove」「BreakAreaV」「ReadAreaV」「EndAreaV」のいずれかを指定 |
bo | 半角数字 | 3 | 任意 | キャンバスの透過の指定。 0~100の範囲を指定 |
po | 半角数字 | 3 | 任意 | 熱源の透過の指定。 0~100の範囲を指定 |
z | 半角数字 | 190 | 任意 | base64のサイズ。 10~100の範囲を指定 |
s | 日付 (YYYY-MM-DD hh:mm形式) | - | 任意 | 座標データが登録された開始日付 初期値は現在日付より1ヵ月前 |
e | 日付 (YYYY-MM-DD hh:mm形式) | - | 任意 | 座標データが登録された終了日付 初期値は現在日付 |
【レスポンス】
プロパティ | 返却 | 説明 |
---|---|---|
status | 「OK」又は「NG」 | 「OK」:データが存在し、ヒートマップ照会ができた状態 「NG」:データが存在しない、またはレート制限にかかった状態 |
img | base64(png形式)又は「Nothing」 | ヒートマップ化された画像がbase64として返却されます 「status」が「OK」である:base64が返却されます。 「status」が「NG」である:「Nothing」が返却されます。 |
count | 半角数字、又は「0」 | ヒートマップ化した件数が返却されます 「status」が「OK」である:件数が返却されます。 「status」が「NG」である:「0」が返却されます。 |
screenwidth | 半角数字 | bodyの幅が返却されます 「status」が「OK」である:件数が返却されます。 「status」が「NG」である:設定されません。 |
screenheight | 半角数字 | bodyの高さが返却されます 「status」が「OK」である:件数が返却されます。 「status」が「NG」である:設定されません。 |
elementwidth | 半角数字 | エレメントの幅が返却されます 「status」が「OK」である:件数が返却されます。 「status」が「NG」である:設定されません。 |
elementheight | 半角数字 | エレメントの高さが返却されます 「status」が「OK」である:件数が返却されます。 「status」が「NG」である:設定されません。 |
【HTTPリクエスト】
https://api.heat-lab.net/v1/GetHeatData
【メソッド】
GET
【リクエストボディ(GETパラメータ)】
プロパティ | タイプ | 桁数 (文字数) | 必須 | 説明 |
---|---|---|---|---|
id | 半角英数字 | 50 | 必須 | ヒートマップを照会したいManageID |
key | 半角英数字 | 50 | 必須 | 「ヒートマップの導入方法」の4)にて発行したManageKey |
ws | 半角数字 | 4 | 必須 | ヒートマップを導入したエレメントのWidthの開始幅。 0~4000の範囲を指定 |
we | 半角数字 | 4 | 必須 | ヒートマップを導入したエレメントのWidthの終了幅。 0~4000の範囲を指定 |
co | 半角英字 | 30 | 任意 | 国 |
pr | 半角英字 | 30 | 任意 | 都道府県/州 |
fw | 半角英数字 | 20 | 任意 | フリーワード |
d | 半角英字 | 5 | 必須 | デバイスの指定。 「PC」または「Smart」のいずれか指定 |
a | 半角英字 | 10 | 必須 | マウス/タッチ/離脱エリア/注目エリアの指定。 「MouseDown」「MouseMove」「TouchDown」「TouchMove」「BreakAreaV」「ReadAreaV」のいずれかを指定 |
s | 日付 (YYYY-MM-DD hh:mm形式) | - | 任意 | 座標データが登録された開始日付 初期値は現在日付より1ヵ月前 |
e | 日付 (YYYY-MM-DD hh:mm形式) | - | 任意 | 座標データが登録された終了日付 初期値は現在日付 |
【レスポンス】
プロパティ | 返却 | 説明 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
status | 「OK」又は「NG」 | 「OK」:データが存在し、ヒートマップ照会ができた状態 「NG」:データが存在しない、またはレート制限にかかった状態 | |||||||||||||||
data | JSON又は「Nothing」
| 座標データをJSONとして返却されます 「status」が「OK」である:座標データが返却されます。 「status」が「NG」である:「Nothing」が返却されます。 | |||||||||||||||
count | 半角自然数、又は「0」 | 件数が返却されます 「status」が「OK」である:件数が返却されます。 「status」が「NG」である:「0」が返却されます。 |
1)管理画面およびAPIなどヒートマップ照会にはレート制限があります。
かなりシビアな制限ですが、サーバーリソースの関係上、ご容赦ください。
API | レート制限 |
---|---|
GetHeatPic | 1リクエスト/5秒 |
GetHeatData | 1リクエスト/1秒 |