1 / 100

Documents

はじめる

Wicleへようこそ

圧倒的なユーザー理解で、ユーザーの心をつかむプロダクト開発をはじめましょう。

Wicleとは？

Wicleは、プロダクトを継続的に使ってくれるファンや特定の機能を利用している一人ひとりのユーザーがどのように使っているかを可視化、分析できるユーザー行動分析のためのプロダクトです。

ファンや休眠ユーザーの移り変わりのような、プロダクトの長期のリテンションが定量的に可視化されるため、全体像の継続的な把握や課題発見、開発のプランニングに繋げることができます。

また、個別に計測するコストが高かった、クリックやスクロールなどを含む様々なユーザー行動をタグ1つで自動計測できます。

プロダクトチームの誰もが手軽に・継続的に・様々な粒度でプロダクトを分析し、ユーザーの心をつかむプロダクト開発ができるようになるのを目指しています。

Wicleでできること

長期のリテンションを定量化： ユーザーがプロダクトを知り、ファンになるまでのライフサイクルをWicleが自動でフェーズに分類します。条件定義や抽出の手間なく、プロダクトの全体像から注力すべき課題がわかります。
ユーザー群の深掘り、課題の要因探索が簡単に： 深掘りしたいユーザー群をクエリなしで抽出し、特徴を把握。群同士の比較を通じて、よく使われている機能や、ユーザー属性、行動の差を把握することができます。
"リアルな行動"をもとにした文脈把握や評価： 特定のページをじっくり見たユーザーや、特定のボタンをクリックしたユーザーを瞬時に抽出し、イベントログとセッションリプレイ（動画）を用いて、一人ひとりの行動を圧倒的な解像度で再現します。
変化に気づける： ライフサイクルやユーザーの変化を自動でお知らせ。最近改善したページなど、定点観測したいデータも通知で受け取れます。
多彩な自動計測： タグ1つで分析のための基本的なユーザー行動の自動計測と、セッションリプレイの設定が完結します。
強固なプライバシー保護： フォームに入力される個人情報のマスキングを簡単に設定可能。マスキング対象も全部〜任意の領域と柔軟に設定できます。

はじめましょう

スタートガイド・デモプロジェクト

ステップバイステップで計測の設定や分析機能に触れることができるガイドです

初期設定

利用開始までに必要な初期設定をまとめたドキュメントです

スタートガイド・デモプロジェクト

スタートガイドとは

これからWicleを始める方に向けた、チェックリスト形式で学べるコンテンツです。目的に応じた2種類のガイドがあります。

セットアップガイド

データの計測などの初期設定を行う管理者向けの設定ガイド

分析ガイド

Wicleの基本的な機能に触れられる、分析者向けのガイド

使い方

左メニュー上部スタートガイドからアクセスできます。
ガイドには該当画面へのリンクと、対応するドキュメントを開くリンクがあります。画面を見ながら触ってみてください。
各ステップは完了を押すか、対応する操作をするとチェックがつきます。

終了する時は

全て終わったら右上のガイドを終了から終了できます。

終了するとガイドは非表示になりますが、左メニュー＞ヘルプ＞スタートガイドから再度アクセスができます。

デモプロジェクトとは

Wicleのタグ設置前に、実際にどのようなデータが取得でき、どのように可視化されるのかを、サンプルデータでご確認いただけます。

サンプルデータは、ECサイトとSaaS型サービスの2種類のプロダクトを想定したプロジェクトに基づいて作成されています。

アクセス方法

左上部のプロジェクト名からアクセスできます。

困った時は

チャットでお気軽にお問い合わせください。

アカウント作成

自分で始める場合

1. アカウントを作成

Googleでサインイン、またはメールアドレスとパスワードを入力し次へ進みます。

2. 認証コードを確認

notifications@wicle.ioから、「XXXXXX is your verification code」という件名のメールが届きます。

メールに記載されている認証コードをコピーして入力画面にペースト、次へ進みます。

メールが届かない場合は迷惑メールフォルダもご確認ください。迷惑メールフォルダに入っている場合はメール上部の「問題ない」をクリック後、認証コードをご利用ください。

3. アカウント情報を入力

必要情報を入力し、次へ進みます。

4. 組織とプロジェクトを作成

必要情報を入力し、次へ進みます。

　テスト環境用プロジェクトについて

チェックすると、計測されるデータの検証などに使えるテスト用のプロジェクトが同時に作成されます。

計測上限はイベントが50,000、セッションリプレイが10,000となります。

このプロジェクト請求対象にはなりません。

5. 初期処理

初期処理は通常数分間で終了します。

初期処理が終了し、管理画面が表示されたら完了です。

招待された場合

1. 招待メールを確認

notifications@wicle.io から招待メールが届くため、「Accept invitation」をクリックし、次に進みます。

招待メールが届かない場合は迷惑メールフォルダもご確認ください。迷惑メールフォルダに入っている場合はメール上部の「問題ない」をクリック後、招待リンクを開いてください。

2. アカウント情報を入力

必要情報を入力し、次へ進みます。

管理画面が表示されたら完了です

計測タグ

計測タグの確認

左メニュー上部のプロジェクト名をクリック
開いたポップアップメニュー内のプロジェクト名の右にある歯車マークをクリック
遷移した設定画面内の「計測タグ」をクリック

計測タグの設置

「計測タグ」画面にあるタグをコピーし、計測したいサイトに設置します。

設置する場所は</head>タグの直前を推奨しています。難しい場合は<body>タグのなるべく上の方に設置してください。

Google Tag Manager（GTM）をご利用の場合

計測タグをHTMLに貼り付け
詳細設定 > タグ配信の優先度に10を設定
トリガー > All Pagesを設定

SPAサイトに設置する場合

計測タグ（SPAサイトの場合）を参照ください。

イベント送信設定

イベントの各種設定を行います。

自動計測するイベント
- 追加したイベントは課金対象イベントとしてカウントされます。
クリック計測　追加対象セレクタ
- クリックイベントで自動計測の対象外となっている要素について、CSSセレクターを指定することで、該当するDOM要素を計測対象に追加できます。
スクロール計測　閾値タイプ
- スクロール計測の閾値タイプを選択することでイベントを送信する間隔を調整できます。

設置後の確認方法

Chrome拡張を使用し、タグが正常に設置されイベント送信が行われているかをすぐに確認することが可能です。詳細はChrome拡張機能での確認をご覧ください。

実際のイベント計測からデータが反映されるまで数十分程度かかる場合があるため、設置確認ができない場合は時間をおいてお試しください

確認ができたら直近7日間でアクセスしたユーザー、クリックされたa要素から計測されたユーザーがいるか確認しましょう。

データの更新間隔について

送信されたイベントデータは 30-60分毎 に集計処理し管理画面上に反映されます。すぐには管理画面に反映されませんのご注意ください。

数字が反映されない場合

イベントが正常に送信されているか、「Chrome拡張機能での確認」をもとに確認してみましょう。解決しない場合はチャットでお問い合わせください。

計測するデータの拡張

以下の方法で計測するデータを拡張できます。詳細はそれぞれのページをご覧ください。

方法

概要

ユーザー単位で任意のユーザー属性データを紐づけられます

自動計測では取得できない任意のデータを任意のタイミングで送信できます

SPAサイトの場合の設置方法

計測タグ（SPAサイトの場合）をご覧下さい。

計測タグ（SPAサイトの場合）

SPAサイトの場合の設置方法

タグ設定の変更

下記の「アプリケーションへの実装」もしくは「GTMを利用する場合」の設定を行うと、タグから自動的に送信されるviewイベントとイベントデータが重複するため、タグによるviewイベントの自動送信を無効化する設定を行なってください。

左メニュー上部のプロジェクト名をクリック
開いたポップアップメニュー内のプロジェクト名の右にある歯車マークをクリック
遷移した設定画面内の「計測タグ」をクリック
基本設定の「viewイベント自動送信を無効化」のチェックをONにし、保存ボタンをクリック

以上で、設定は完了です。

アプリケーションへの実装

タグ自体はSPAでも動作しますが、仮想的なページ遷移時をpageviewとして計測する場合、明示的にviewイベントを発生させる必要があります。

具体的なコードの埋め込み箇所については、SPAの実装および使用しているフレームワーク(Vue.js, Angular, jQuery-mobileなど)に依存します。

多くの場合フレームワークのルータには、ルーティング完了時にコードを実行するためのイベントハンドラの設定があります。その中で

krt('view');

を実行するようにして下さい。

状態変化に連動して実行するなどの時、実際のページ遷移に対して重複してviewイベントを送信してしまう可能性にご注意ください。変化前後のURLの差分をチェックし、差がある場合のみ実行する制御を入れて頂く必要があるケースがあります。

GTMを利用する場合

1. Wicleタグがページ読み込み時に実行されるようにする

GTM画面にてタグを作成し、Wicleの計測タグをGTMから配信します。

タグの設定
- タグの種類をカスタム HTMLに設定します
- HTMLにはWicleの設定画面で確認できるタグをコピーし、貼り付けます
詳細設定を選択し、タグ配信の優先度を設定します
- 他のタグ実行に必要なため、十分に高い数値（10など）を設定してください。
トリガー

2. viewイベントタグが仮想的なページ遷移時に実行されるようにする

GTM画面にてタグを作成し、viewイベントタグをGTMから配信します。

タグの設定
- タグの種類をカスタム HTMLに設定します
- 詳細設定を選択し、タグ配信の優先度を設定します
- 1.のWicleのタグの後に実行されるように、より低い数値を設定してください。
HTMLには次のようなタグを設定します

<script type="text/javascript">
krt('send', 'view');
</script>

※ Wicleで計測したくないページがある場合は、条件を追加し除外してください。

※ サイトの実装によっては、すべての履歴の変更ではなく一部の履歴の変更(History)イベントにトリガー条件を絞り込む必要があります。GTMプレビューでHistoryイベントの発生状況を確認しつつ、サイトに合わせたトリガー設定を実施してください。

注意点

次のような場合は、サイト改修が必要です。サイト構築を担当しているエンジニアの方に作業をご依頼ください。

GTMが導入されていない場合
GTMが導入されているが、「履歴の変更」トリガーが意図通りに発火しない場合

ユーザープロファイルの設定

ユーザープロファイル機能を活用することで、以下のようなことが実現できます。

ユーザー単位で任意のデータを紐付けできる
紐付けたデータを管理画面上で閲覧・検索できる
デバイスを跨いで同一ユーザーを特定できる

以下の様なコードを埋め込むだけで実装は完了します。

window.krt('send', 'identify', {
  user_id: '<USER_ID>',
  name: '<NAME>',
  email: '<EMAIL>',
  photo: '<IMAGE_URL>',
  isInternalUser: true or false
});

詳細な設定方法は以下のドキュメントをご参照ください。

セッションリプレイの設定

セッションリプレイでできること

計測タグを設置したページのユーザー行動を動画として再現し確認することができます。

有効化/無効化の方法

設定画面の「セッションリプレイ設定」のセクションで設定することができます。

左メニュー上部のプロジェクト名をクリック
開いたポップアップメニュー内のプロジェクト名の右にある歯車マークをクリック
遷移した設定画面内の「セッションリプレイ」をクリック

セッションリプレイを有効化 のチェックを切り替えることで機能利用のOn/Offを切り替えることができます。また、実際に反映されるまで最大数分程度のタイムラグが生じる場合があります。

Offにしている場合は計測タグによるセッションリプレイデータ生成処理自体が行われない様になります。（過去に遡及してデータを生成しなおすことはできません）

セッションリプレイを見るには

計測されたセッションリプレイは、ユーザーのn1画面から見ることができます。

詳しくはセッションリプレイをご覧ください。

プライバシー保護設定

個人情報保護の観点から、フォームへの入力情報(input[type="xx"])がデフォルトでマスキングされます。

具体的には下記のセレクタに該当するものが対象です。

"input:not([type='submit']):not([type='button'])",
'textarea',
'select',

全テキストをマスキングする

この設定を行うと、セッションリプレイで保存されるページのテキストデータが自動でマスキングされます。機微情報が保存される懸念がある場合に利用を推奨いたします。「非マスキング対象セレクター」を指定することで任意要素で無効化することが可能です。

この設定はデフォルト状態ではOnになっています。

テキストの変換ルールは以下の通りです。

種類

マスキング後の表示

半角英字

小文字: x 大文字: X

全角文字（半角日本語含む）

Ｘ (全角エックス)

数字

半角: 0 全角: ０

上記以外（記号や絵文字など）

変換せずそのまま表示します

マスキングのイメージ

マスキング対象セレクター

CSSセレクタを指定して、マスキングを追加することができます。マスキングをかけたいセレクタが複数ある場合は, （カンマ）で繋ぎます。

非マスキング対象セレクター

CSSセレクタを指定して、マスキングを除外することができます。サイト内の検索バーや登録フォーム等の入力情報までを動画でみたい場合に活用できます。マスキングを除外したいセレクタが複数ある場合は, （カンマ）で繋ぎます。

URL 条件

動画を取得するページ、もしくは除外するページをパス、URL、アンカー、クエリを利用して指定することができます。

SPA 除外条件

SPAサイトにおいてセッションリプレイを行いたくないページを除外できます。URL条件で指定されているページの範囲内でしかSPA除外条件の指定ができないため、除外ページも有効になるようURL条件の設定をお願いします。

意図せず保存されてしまったデータの削除

意図しないデータが保存されてしまった場合はデータの削除も可能です。その場合はサポートまでご連絡ください。

CSSセレクタの指定方法がわからない場合

対象のページを開きます
ページ内から、CSSセレクタを取得したい要素を見つけます
要素の上で右クリックし検証を選択すると Chromeデベロッパーツールが開きます
Elementsタブの中で、該当の要素に対応するHTMLタグがハイライトされます
ハイライトされたHTMLタグを右クリックし、Copy > Copy selectorを選択すると、クリップボードにその要素を指定するCSSセレクタがコピーされます

トラブルシューティング

セッションリプレイ動画が見れない、うまく再生されない場合

グループ分析の設定

契約方法

プラン・請求画面でグループ分析機能を契約し有効化することができます。

設定方法

その他グループ分析の概要

イベント計測

計測の仕組み

Wicleによるデータ計測の仕組みやタグの仕様を解説します。

Wicleタグの仕様

Wicleの各種タグについて

Wicleはユーザーのイベントデータ、ユーザーデータなどを(HTMLの)scriptタグによって取得しています。

Wicleのタグはサイトのページ情報が読み込みされた後に読み込まれるためサイト自体の表示やパフォーマンスに影響を与えません。

イベントデータの取得

イベントデータ（閲覧、クリック、スクロール率、滞在時間等）は、ブラウザから自動的に生成される情報をリアルタイムに取得しております。この仕組みについては、一般的なアクセス解析システムとほぼ同等の仕組みです。

ユーザーデータの取得

ユーザーデータは、サイト側から明示的にWicleへと送信する必要があります。ユーザー情報が更新される可能性があるページの遷移先（例：会員登録完了ページ、マイページなど）にタグを設置し、送信する情報を明示的に指定することで、ユーザーの属性情報を送信します。

カスタムイベントデータの取得

カスタムイベントデータとは、購買情報など閲覧情報と属性情報で送信していない任意の情報を送る方法です。属性情報と同様に、サイト側から明示的にWicleへと送信する必要があります。

セッションリプレイデータの取得

セッションリプレイデータとは、セッションリプレイ機能をONにすると取得されるデータです。録画用スクリプト（JavaScript）がエンドユーザーのブラウザ上で実行され、HTMLドキュメント、HTMLの変更、マウスのイベントなどの情報を取得します。取得されたデータは保存用のサーバーに送信され、再生する際にはその情報を元に、管理画面上の再生画面で同じHTMLを生成し再現します。

タグの種類

Wicleは計測タグを設置することで利用が開始できます。更にいろいろなデータと紐付けをしていくために複数の種類のタグをご用意しております。それぞれのタグは以下の様な役割を持っています。

計測タグ以外のタグはすべて 計測タグの読み込み後に読み込まれるように設置いただくことでデータが計測されます。

名称

条件

役割

タグ設置場所

必須

計測をする全ページ

任意

会員情報の紐付け（ログイン機能があるサイトのみ）

ログインページ、会員登録ページなど

任意

サイト上での任意のイベントを計測

任意のイベントが発生するページ

データの種類と特徴

イベントデータとユーザーデータ

計測されるデータにはイベントデータとユーザーデータの2種類があります。それぞれの特徴は以下の通りです

イベントデータ

ユーザーがページを閲覧したりリンクやボタンなどの要素をクリックすると計測されます

イベントの種類：閲覧(view)やクリック(click)
フィールド：イベントデータとして計測する属性。イベントの種類ごとにフィールドが決まっています。属性としてイベントデータの中身がわかることで、どんな行動だったかを詳しく知ることができます
- 閲覧の例：リファラ、アクセスしたページのURL、アクセスしたページのパスなど
- クリックの例：クリックしたボタンの文字、ボタンのリンク先URLなど
イベントディメンション：イベントごとに共通で計測している属性
- 来訪回数、リファラ、デバイス

ユーザーデータ

イベント発生の度に再計算されます

ユーザーディメンション：イベントディメンションをもとに、計測の度に計算されていく属性
- 来訪回数、閲覧の発生数、クリックの発生数、リファラ、デバイス

ディメンション

イベントディメンション
- イベント毎に計算しているユーザー単位の情報です
- 回数を計測するものと、任意の文字列を計測するものがあります
- 来訪回数などの場合は総計が、リファラなど文字列の場合は最新の値が保存されます
ユーザーディメンションとの違い
- ユーザーディメンションには、ユーザー毎に最新の値が保持されます。対して、イベントディメンションにはイベント発生当時の計算結果がそれぞれ保持されています。

セッション

イベントの上位概念で、ユーザーの来訪毎一意のセッションIDが付与されます

ユーザーの最後のイベント発生から30分以上経過すると、セッションIDが新しくなります（新しい来訪とカウントされます）

ユーザー行動と各種データの関係

ユーザーがプロダクトやWebページを利用した行動によって、イベントデータとユーザーデータがどのように計測されていくかを時系列で表すと以下のようになります。

自動計測されるイベント

イベント

自動計測されるイベントについて

Wicleの計測タグを設置することで、以下のような行動が自動計測されます。

デフォルトの自動計測イベント
- 非課金イベント
オプトインできる自動計測イベント

デフォルトの自動計測イベント

タグの設置と共に自動的に計測開始されるイベントです。

ページビュー（view）

ページビューが発生し、タグが読み込まれたタイミングで自動でviewイベントとして計測されます。

代表的な項目は以下です

ページのURL
ページタイトル
リファラ
デバイス、OS情報
ユーザーエージェント
IPアドレス

SPAサイトで計測する場合は、別途設定が必要です。

計測タグ（SPAサイトの場合）

クリック（click）

以下の要素をクリックしたタイミングで自動でclickイベントとして計測されます。

対象要素に子要素がある場合、親要素に合致する要素があればその要素のクリックと判断してデータ送信をします。

A要素
BUTTON要素
INPUT要素の内、type属性が以下のもの
- button
- checkbox
- image
- radio
- range
- reset
- submit

計測サポート外のケース

クリックイベントの拡張

対象要素に特定の属性を付与することで、任意のデータをクリックイベントに付与できます。詳しくは以下をご覧ください。

クリックイベントの拡張

非課金イベント

自動計測されますが、より詳細な統計値を正確に計算するためのイベントとして特殊な計測ロジックを使用しています。

これらのイベントは、計測イベント数の実績としてカウントされない非課金のイベントです。

活動時間（spend_time_in_pv / spend_time_in_session）

Wicle内で扱う滞在時間は「活動時間」と呼び、単純な経過時間ではなくエンドユーザーが何らかの操作を行なっていると思われる時間になります。エンドユーザーの操作として検知するのは、マウス移動・スクリーンタッチ・スクロール・クリック・キー入力です。

spend_time_in_pvイベントでは1ページビュー内での、spend_time_in_sessionイベントでは1セッション内での累計滞在時間を計算し、下記の割合を超えた時点でページビューまたはセッションにつき一度のみイベントを送信します。

# spend_time_in_pv
10秒, 30秒, 60秒, 120秒, 180秒, 240秒, 300秒, 360秒, 420秒, 480秒, 540秒, 600秒

# spend_time_in_session
3秒, 10秒, 30秒, 60秒, 120秒, 180秒, 240秒, 300秒, 360秒, 420秒, 480秒, 540秒, 600秒

このイベントデータを持ってユーザー単位やページ単位の活動時間を算出しています。

オプトインできる自動計測イベント

タグの設置と共に計測可能になり、タグ設定画面から計測を有効化することで計測開始されるイベントです。

スクロール率（scroll_depth）

ページのスクロール率(※)を計算し、下記の割合を超えたタイミング毎にページビューにつき一度のみイベントを送信します。

25% , 50% , 75% , 100%

※スクロール率はdocument.documentElement.scrollHeight を基準に計算します。この値が0の時はイベントの送信は行われません。

フォーム送信（submit）

エラー（error）

ブラウザ上でのエラー

ブラウザ上で発生した各種JSエラーの内容をイベントとして計測します。意図しない大量イベントの送信を防ぐため、同一のエラーはページビューにつき一度のみイベントを送信させる様に制御されています。

計測対象は下記の様になっています。

計測対象

level

type

message

stack

warn

console.warn

関数に渡された全ての引数を連結したもの

error

console.error

関数に渡された全ての引数を連結したもの

error

イベントのmessageプロパティ

イベントのerror.stackプロパティ

error

unhandledrejection

イベントのreason.messageプロパティ

イベントのreason.stackプロパティ

計測対象毎にerrorイベントのプロパティのlevelおよびtypeが自動決定され、それぞれで収集できるエラーメッセージ・スタックトレース情報を送信します。

サーバー上でのエラー

WebAPIによるイベント送信を実装することで、サーバー上でのエラーもerrorイベントとして収集することが可能です。

WebAPIをご利用頂くには弊社側での設定とアクセストークンの受け渡し等が必要になります。現時点ではご連絡を頂き個別ご案内させて頂くフローになっておりますので、ご利用されたい場合はチャットやメールでご連絡ください。

Chrome拡張機能での確認

Chrome拡張機能でできること

Chrome拡張機能を使うと、Wicleにどのようなデータが送られているかをサイト上で確認できるようになります。

イベント（データ）の確認

どのような要素や値でイベント（データ）が送られているかすぐ確認できる

デバッグ

イベントが計測されていない、絞り込みたいイベントが検索UIで出てこない場合などに原因を調査できる

イベント条件として保存

確認したイベントをChrome拡張機能上から直接保存できる

インストール方法

操作方法

「Wicle Chrome Extension」がインストールされたChromeでWicleのタグが入っているサイトにアクセスします
Chromeデベロッパーツールを開き、「Wicle」タブをクリックします
ご自身のサイト上でページ遷移やクリックをします
Chromeデベロッパーツール上でどのようなデータがWicleに送られているか確認しましょう
- ページ遷移時にはViewのイベントが発生します
- クリックした時にはClickのイベントが発生します
- 「全てのイベントを表示する」をONにすることでスクロールイベントなども表示されます

データの拡張

計測タグと別のタグを追加することで、ユーザー属性や任意のデータを拡張できます。

ユーザープロファイル

ユーザープロファイルでできること

ユーザープロファイル機能を活用することで、以下のようなことが実現できます。

ユーザー単位で任意のデータを紐付けできる
紐付けたデータを管理画面上で閲覧・検索できる
デバイスを跨いで同一ユーザーを特定できる

カスタムフィールドの設定方法

データ設定 > フィールド設定(ユーザープロファイル) からカスタムフィールドの設定を行うことができます。この画面で、予め送信したいフィールドの名称とデータ型を設定することでデータの送信と閲覧が有効になります。設定したフィールドに応じて、データを送信するためのJavascriptコードサンプルが生成されます。

デフォルトで使用できるフィールドは以下の通りです。

実装方法

設定画面上のサンプルコードを参考に、window.krt の呼び出しをサイト上へ組み込んで頂きます。

user_idを指定すると、同一ID間でイベントデータがマージされます。これにより、デバイスが異なる場合等でも同一ユーザーとして表示されるようになります。
第二引数であるオブジェクトのフィールドは全てオプショナルです。データを更新しないキーは、キー自体の記述を除くことで意図しないデータ更新を防ぐことができます。
user_idには必ず一意な値を設定してください。設定できない場合（ログインしていないユーザーなど）、データの送信自体を行わないようにしてください。これにより意図しないユーザーのマージを防ぐことができます。

identifyはカスタムイベント送信と同様のIFですが、イベント数としてカウントされません。(請求対象外です)

また、同一端末上で再度送信がリクエストされた時、過去送信されたデータと同一であればデータ送信が抑制される場合があります。

実装後の確認方法

以下の様に送信データが表示され、user_id等正しくセットされているかを確認できます。

Identify(User profile)の送信履歴自体が表示されない場合はタグの実装方法に問題がある可能性があり、Payloadの値が期待値と違う場合は引数の設定方法に問題がある可能性があります。

注意事項

user_idはString型で256文字以下である必要があります。

正しい送信が確認できない場合は、チャットでお気軽にお問い合わせください。

データインポート

データ設定 > データインポート(ユーザープロファイル) からCSVファイルをアップロードしユーザープロファイルデータの一括更新を行うことができます。

CSVファイル形式

ヘッダー行が必須です
user_id 列は必須で、それ以外は更新したいフィールドの「キー」の文字列を記述してください

サンプル

注意事項

ヘッダー行にuser_id が無い場合や、フィールド設定に存在しないキー名が記述されている、データ型がフィールド設定と一致しない場合(数値型フィールドに文字列をセットするなど)はアップロード処理自体がエラーとなります
存在しないuser_id のレコードは正常に処理されますが、そのレコードのデータ更新処理は行われません
データインポートにより更新したフィールドをidentifyタグでもデータ送信を行なっている場合、最後に実行されたものが採用されます
- そのため、データインポートで更新するフィールドはindetifyタグではデータ送信をしないフィールドとする、もしくは両方で更新が行われても不整合とならない形での運用が必要となります

カスタムイベント

カスタムイベントでできること

設定・実装方法

イベントの定義情報を設定画面から入力し保存することで、送信されたイベントデータが管理画面上での閲覧・検索が可能になります。データの送信自体は設定を行っていなくても可能です。

クライアントサイドでの実装方法

カスタムイベント設定画面でイベントやフィールドを定義すると、実行コードのサンプルが表示されます。

このコードを元に必要なタイミングで送信したい値をセットし実行される様に実装を行ってください。

サーバーサイドでの実装方法

各画面での利用/確認方法

コードレスイベント

コードレスイベントでできること

コードレスイベントを使うメリット

ユーザーのイベントタイムライン上にコードレスイベントが表示されるため、重要な行動を確認しやすくなります
検索条件が内包されているため、検索がイベント指定のみになります

設定方法

コードレスイベント画面から作成画面に遷移し、イベント名や条件など必要項目を入力します。

過去データの生成について

過去データの遡及は、Growth PlanまたはCustom Planにてご利用いただけます

コードレスイベント作成時に、「イベントデータを遡及して生成する」をONにすることで、設定時点から過去に遡ってイベントデータとユーザーの統計情報（発生回数）を生成します。この場合、保存後データの生成処理がバックグラウンドで行われます。（初期処理中という表示になります）生成処理中でも検索やキー行動の設定は可能ですが、検索についてはデータが不十分になる場合があります。キー行動で利用する場合は設定後、処理を待機するため問題ありません。

これにより後からでも重要行動となるイベントを設定することができます。

過去に遡って集計できるのは 90日前以降 が対象となります。それ以前は該当するイベントデータがあっても生成されないためご注意ください。

クリックイベントの拡張

メタデータの追加

計測対象要素に data-wicle-click-additional 属性を付与することで、任意のデータをクリックイベントに付与することができます。

属性を付与すると、クリックの追加情報(additional)フィールドに文字列データとして格納され、検索できるようになります。

イベント発生対象の追加

CSSセレクターで設定する

上記のクリック計測対象に合致しない要素を、CSSセレクターを指定し該当するDOMに対するクリックを計測対象として追加することができます。

HTMLを修正し設定する

CSSセレクターでの指定が厳密にはできないケースや、修正で計測が行われなくなるケースなどが考えられる場合、対象とするHTMLタグに data-wicle-auto-click 属性を付与することでその要素のクリックイベントを送信対象とすることができます。

データの保持期間

各種データの保持期間は契約プランに基づき決定されます。

イベント・ユーザーデータのディメンションは計測開始時点から計算された累積値が保持されます。(e.g. 保持期間より過去の3年前に1度来訪したユーザーが今日再度来訪した場合、来訪回数は2とカウントされます）

データの更新間隔

送信されたイベントデータは 20-30分毎に集計処理し管理画面上に反映されます。(内部の処理状況により時間が前後します)

ライフサイクルやキー行動のデータは 40-60分毎に集計処理し最新の値に更新されます。

タイムゾーン

プロジェクト作成時に指定されたタイムゾーンに準拠し、計測データの集計を行います。

分析

ダッシュボードの概要

ダッシュボードとは？

ダッシュボードとは毎日みるべき指標と、自分がみたい指標（チャート）を設定し、確認できる場所です。

ダッシュボードで見えるもの

アクティビティ

最近、プロジェクト内のメンバーが行った活動を確認することができます。

全体の傾向

アクティブユーザー

指定した基準日を元に、日/週/月の範囲でプロジェクト全体と初回来訪のアクティブユーザーの推移をドメイン別で確認することができます。 Wicleでは活動時間が10秒以上のセッションがあるユーザーをアクティブユーザーと定義しています。

ライフサイクル

特徴的なユーザー

活動量が多いユーザー

初めてキー行動を発生したユーザー

カスタムチャート

データの操作

基準日

基準日はダッシュボード集計の起点となる日です。デフォルトは当日になっています。基準日の変更は右上の日付選択で行うことができ、変更するとダッシュボード全体に適応されます。

表示単位

表示単位は日/週/月から選択することができます。変更を行うと全体の傾向のアクティブユーザーとライフサイクルに適応されます。

よくある質問　

Q. 各チャートの表示位置は移動できますか？

カスタムチャートのみ、ドラッグ＆ドロップで移動が可能です。

グループ分析

リテンションの可視化

インテグレーション

組織とプロジェクト

組織設定

プロジェクト設定

請求

その他

サポート情報

設定方法

グループプロファイルの設定方法

データ設定 > フィールド設定(グループプロファイル) からグループプロファイルとして送信するデータのフィールドを設定できます。

この画面で、予め送信したいフィールドの名称とデータ型を設定することでデータの送信と閲覧が有効になります。設定したフィールドに応じて、データを送信するためのJavascriptコードサンプルが生成されます。

デフォルトで設定されているフィールドは以下の通りです。

key名

セットする内容

group_id

グループのID。グループとして特定したい一意の値をセットする様にしてください。どの様な単位をグループと扱うか、という点に特に制限はありませんが非常に大量のユーザーが所属するグループになる設計では分析が成立しないため、適切に分割させられる単位を選択してください。

name

グループの表示名（Wicle内各画面の表示名としても使用されます）

photo

グループのプロフィール画像のURL（Wicle内各画面のアイコンとしても使用されます）

実装方法

1. グループプロファイルの送信(`group_identify`)

設定画面上のサンプルコードを参考に、window.krt の呼び出しをサイト上へ組み込んで頂きます。

window.krt('send', 'group_identify', {
  group_id: '<GROUP_ID>',
  name: '<NAME>',
  photo: '<IMAGE_URL>',
});

第二引数であるオブジェクトのフィールドはgroup_idを除き全てオプショナルです。データを更新しないキーは、キー自体の記述を除くことで意図しないデータ更新を防ぐことができます。
group_idには必ず一意な値を設定してください。

group_identifyはカスタムイベント送信と同様のIFですが、イベント数としてカウントされません。(請求対象外です)

また、同一端末上で再度送信がリクエストされた時、過去送信されたデータと同一であればデータ送信が抑制される場合があります。

2. イベントにグループを紐付ける(`set_group`)

グループプロファイルの送信ではグループ情報の登録が行われる一方で、この実装ではset_groupを実行した以降に発生するイベントがどのグループに属するものかを示すことができます。

window.krt('local', {
  wicle: {
    method: 'set_group',
    group_id: '<GROUP_ID>',
  },
});

group_id の値を現在の行動のコンテキストとして適切なものをセットすることで、以降このユーザーが発生させる全てのイベントが指定したグループに紐付きます。
グループが切り替わる場合は、同コードで別のgroup_idを指定します。
一度に複数のグループを指定することはできません。1つに指定できる単位をグループとしてください。
デバイスが切り替わりさらにset_groupが実行されていなかったケースでも、内部的に最後に紐づけられたgroup_idが自動で引き継ぎます。その為、グループの所属をリセットしたい（どのグループにも所属していない状態にしたい）場合、group_idに null をセットしてset_groupを実行してください。

コンテキストのセットではイベント送信は発生しない為、投機的に実行しても問題ありません。

例えば、グループを簡単に切り替えることができるサービスの場合、グループが変化した瞬間に都度 set_group を実行することがもし難しい場合、以下の様にタイマー処理でその時点のグループ情報をセットし続けるということも可能です。

setInterval(() => {
  window.krt('local', {
    wicle: {
      method: 'set_group',
      group_id: getCurrentGroupId(), // getCurrentGroupId() は現在のグループIDを取得する関数と仮定
    },
  });
}, 300);

あるユーザーに複数のグループが紐付かないケース(シングルアカウント環境)

上記の通り、set_groupは一度実行するとそのユーザーの以降の行動はグループ情報が自動で引き継がれます。

ただし、長期間(約30日以上)行動が発生しない状態から復帰した場合などで引き継ぎができない可能性がある為、アクセス時に1度は実行する実装を推奨致します。

あるユーザーに複数のグループが紐付くケース(マルチアカウント環境)

この場合は、グループの切り替えが発生する度にset_groupを実行することで適切なgroup_idを各イベントに紐付けることができます。

切り替えをhookにする実装が難しい場合は、短時間のインターバル処理等で現在有効なグループを常にセットし続けるといった実装も可能です。

実装後の確認方法

1. グループプロファイル

以下の様に送信データが表示され、group_id等が正しくセットされているかを確認できます。

Group identify(Group Profile)の送信履歴自体が表示されない場合はタグの実装方法に問題がある可能性があり、Payloadの値が期待値と違う場合は引数の設定方法に問題がある可能性があります。

2. イベントにグループを紐付ける

グループプロファイルと同様にChrome拡張上で確認することができます。

set_groupが正しく実行されていれば以下の様に「Event Meta」セクションのGroup IDの欄にセットしたID文字列が表示されます。

set_groupの処理はアプリケーション側で実行されるため、viewイベントなどタグ読み込み後即座に送信されるイベントでは多くの場合Group IDが表示されません。

その場合はクリック等のイベントでGroup IDをご確認ください。

また、Chrome拡張上ではGroup IDが認識されていないイベントもデータ解析時の補正処理でGroup IDのセットが行われます。

注意事項

group_idはString型で256文字以下である必要があります。

正しい送信が確認できない場合は、チャットでお気軽にお問い合わせください。

データインポート

データ設定 > データインポート(グループプロファイル) からCSVファイルをアップロードしユーザープロファイルデータの一括更新を行うことができます。

CSVファイル形式

ヘッダー行が必須です
group_id 列は必須で、それ以外は更新したいフィールドの「キー」の文字列を記述してください

サンプル

group_id,int_field,string_field,boolean_field
group1,123,ABC,true
group2,456,DEF,false

注意事項

ヘッダー行にgroup_id が無い場合や、フィールド設定に存在しないキー名が記述されている、データ型がフィールド設定と一致しない場合(数値型フィールドに文字列をセットするなど)はアップロード処理自体がエラーとなります
存在しないgroup_id のレコードは正常に処理されますが、そのレコードのデータ更新処理は行われません
データインポートにより更新したフィールドをgroup_identifyタグでもデータ送信を行なっている場合、最後に実行されたものが採用されます
- そのため、データインポートで更新するフィールドはgroup_indetifyタグではデータ送信をしないフィールドとする、もしくは両方で更新が行われても不整合とならない形での運用が必要となります