trocco Web行動ログ収集SDK - 各種機能

概要

trocco Web行動ログ収集SDKでは、追加でJavaScriptのコードを埋め込んだり、スクリプトを実行することで、以下のことができます。

• イベントトラッキングの追加
• カスタムカラムの追加
• 既存設定の変更
• スクリプト実行による収集データの取得

このページでは、それぞれの方法をサンプルコードを添えて説明します。

イベントトラッキングの追加

以下のJavaScriptのコードを、HTMLファイル内の対象操作を行う箇所に埋め込むことで、ユーザーのイベントを取得できます。
なお、{custom_column_1: 'value1'}の部分については、後述のカスタムカラムの追加を参照ください。

Nanalytics('send','event',{category:<category>,action:<action>,label:<label>,value:<value>,sendPageviewIfSessionExpired:(<boolean>)}, {custom_column_1: 'value1'});

なお、取得したイベントは、転送元 - trocco Web行動ログにてイベントログを選択することで転送できます。

コード内の各種パラメーター

必須列に✓がついたパラメーターは、コード内に必ず含める必要があります。

コードサンプル

以下は、ユーザーが外部サイトリンクをクリックしたログを取得するコードサンプルです。
なお、string型のパラメーターの値を指定したい場合は、設定値部分をクォーテーションで括ってください。

<a onclick="Nanalytics('send','event',{category:'link', action:'click', label:'example.com'})">https://example.com/</a>

カスタムカラムの追加

ページビューログ・イベントログのいずれも、カスタムカラムを設定することで、任意のカラムを取得データに含めることができます。

コードサンプル

以下のコードサンプルにおける、カラム名（custom_column_xの部分）とその値は、適宜編集ください。
値はstring型（文字列）のみ、指定できます。

ページビューログの場合

JavaScriptコードの埋め込みで記載している、埋め込み用JavaScriptのコードのNanalytics('send','pageview');行を、以下のように編集します。

Nanalytics('send','pageview',{custom_column_1: 'value1', custom_column_2: 'value2'});

イベントログの場合

イベントトラッキングの追加で記載しているJavaScriptのコードをベースとします。

<a onclick="Nanalytics('send','event',{category:'link', action:'click', label:'example.com'}, {custom_column_1: 'value1', custom_column_2: 'value2'})">https://example.com/</a>

既存設定の変更

以下のJavaScriptのコードを追加で埋め込むことで、trocco Web行動ログ収集SDKの内部的な設定を一部変更できます。

Nanalytics('config','<setting_name>',<setting_value>);

変更できる設定項目一覧

通常、以下の設定にはデフォルト値が用いられています。

コードサンプル

JavaScriptコードの埋め込みで記載している、埋め込み用コードのNanalytics('setup',...行とNanalytics('send',...行の間に、以下の行を追加してください。
なお、string型の設定値を変更したい場合は、設定値部分をクォーテーションで括ってください。

<script>
!function(t,e,n){(t.NanalyticsObject=n)in t||(t[n]=function(){(t[n].q=t[n].q||[]).push(arguments)},t[n].ep=e);var a=t.document.getElementsByTagName("script")[0],s=t.document.createElement("script"),c=1e17*Math.random();s.type="text/javascript",s.async=!0,s.src="https://sdk."+e+"/v1/web.js?sid="+c,a.parentNode.insertBefore(s,a)}(window,"n-analytics.io","Nanalytics");

Nanalytics('setup','<site_id>',(new Date).getTime());

// Code addition starts.

Nanalytics('config','session_expire_msec',3600000);
Nanalytics('config','cookie_prefix','__hoge_');
Nanalytics('config','cookie_host','.hoge.co.jp');
Nanalytics('config','customer_id','1234');

// Code addition ends.

Nanalytics('send','pageview');
</script>

スクリプト実行による収集データの取得

trocco Web行動ログ収集SDKが収集したデータは、以下のスクリプトを実行することでも取得できます。
Webブラウザの開発者ツールなどで値を確認したい際などにお使いください。

Nanalytics('get',[<callback_function>]);

スクリプトで取得できるデータ一覧

コールバック関数の引数が以下のプロパティ名を持つオブジェクトとなります。
値が存在しない場合は、undefinedとなります。

コードサンプル

以下は、session_numの値を出力するコードサンプルです。

Nanalytics('get',function(value) { console.log(value.session_num) });