OSSの行動ベースガイドライブラリ

サイト内の閲覧から、
次に案内する情報を選ぶ。

Imicue(イミキュー)は、閲覧や操作の記録をもとに、登録した候補から案内先を選ぶOSSライブラリです。

ガイドや資料へのリンクを、サイトに合わせた見せ方で組み込めます。

GitHubで見る ↗Apache-2.0個人・商用利用可

見ている内容に合わせて、次の案内を。

PACELETの閲覧例を選ぶと、機能・事例・資料・相談のどこへ案内するかが変わります。

PACELET架空のチーム向け進行管理サービス
閲覧例を切り替える ほかの閲覧例

機能の閲覧例

担当と予定を、ひとつの場所で。

ボード機能と予定表の説明を見た場合です。

デモを準備しています

閲覧例から案内を選びます

JavaScriptを有効にすると判定結果を表示します。

  1. 01

    閲覧を記録

    登録した要素の表示回数や時間、操作を記録します。

  2. 02

    辞書で関連づけ

    見た内容と案内候補を、サイト側が用意した辞書で結びます。

  3. 03

    次の案内を選ぶ

    候補を比較し、表示する案内のID、または見送りを返します。

用意した閲覧記録を使うデモです。このページの閲覧履歴は収集・送信しません。

案内先の表示例

    PACELETの案内先を要約した表示例です。フォームの操作とページ移動はローカルデモで試せます。

    記録する対象と、案内先はサイト側で決める。

    HTMLと辞書を設定し、判定結果をいつものUIに使えます。

    01

    HTMLにIDを付ける

    計測したい要素に、辞書へ登録したIDを付けます。

    <section
      data-imicue-signal="feature-board">
      担当と状態を一覧するボード機能
    </section>
    02

    辞書で説明する

    何を見たか、どの案内と関係するかを定義します。

    // 案内候補の設定の一部
    relatedSignalIds: [
      'feature-board'
    ]
    03

    判定結果をUIに使う

    候補のIDか見送りを受け取り、カードやリンクを表示します。

    {
      type: 'recommend',
      contentId: 'product-features', …
    }

    Rulesで始める辞書の関連と回数・時間を使ってブラウザ内で判定。APIキーは不要です。

    Jevで意味を比較する説明文をサーバー経由で評価する方法も選べます。APIキーと利用料が必要です。

    ページをまたいで使うsession保存を選ぶと、同じタブの直近30分の記録を引き継げます。

    辞書とSDKの組み込み手順 ↗

    こんな場面で使える。

    プロダクトサイト

    見ている機能に合わせて、詳しい使い方や関連する資料へ案内。

    記事・資料への案内

    読んだテーマと関係する記事や資料を、次の候補として表示。

    Webアプリ内ガイド

    使った機能に関連する操作ガイドを、アプリの画面内に表示。

    ローカルで試す。

    APIキーなしで、計測とRules判定を試せます。

    Node.js 24.22.1 / npm 11.9.0
    開発版をソースから利用できます。npmパッケージは未公開です。

    ターミナル
    git clone https://github.com/blanket11/imicue.git
    cd imicue
    npm ci
    npm run dev

    起動後、http://127.0.0.1:5183/でPACELETを開きます。製品紹介を閲覧すると計測が進み、記録に応じて右下に案内が出ます。

    詳しい導入手順 ↗

    サイトの方針に合わせて使う。

    計測開始を選べる

    ページ表示時の自動開始と、既存の同意管理に連携した手動開始に対応。計測の無効化も選べます。

    必要な情報だけ記録

    登録したIDと数値を扱います。DOM本文やフォームの入力文を自動収集する機能はありません。

    根拠が足りなければ見送る

    候補を絞れないときは案内を表示しません。見送り時も、サイト本来の機能を使えるように組み込みます。

    開発版です。APIや初期値は変更される場合があります。導入前に検証範囲と制約を確認してください。同意の要否や表示・送信の方針は、利用サイトで判断します。

    imicue

    自分のサイトに合わせて、自由に組み込む。

    Apache-2.0ライセンスのOSSです。条件に従って、個人・商用を問わず利用・改変・再配布できます。

    使うだけでも、改善の提案でも。開発への参加や、改変したソースの公開は利用の条件ではありません。

    利用と貢献について

    ソースのコピーやForkで自由に改変できます。再配布時は、ライセンスの同梱、必要な著作権表示の保持、変更したファイルへの変更表示などの条件があります。詳しくはLICENSEを確認してください。

    文書やコードの変更は貢献ガイドに沿ってPRで提案できます。公式本体への変更は、メンテナーが確認して取り込みを判断します。