ストレージマネージャー概要

Download as PDF

概要

WalkMeプレーヤーは、WalkMeのプレーヤーの状態を維持したり、ウォークスルーの再生のコンパイルを監視したり、アナリティクスを収集したりするためのデータを格納します。 この目的のため、WalkMeはファーストパーティーCookie、サードパーティーCookie（ローカルストレージ）、およびファーストパーティーローカルストレージを使用します。 個人データは保存されず、ウェブサイトのユーザー使用状況に関する情報は監視されません。

WalkMeが設定したCookieは、名前に「wm-」という接頭辞が付いています。 WalkMeは、WalkMeの設定に応じて異なるCookieを使用します。たとえば、Cookieやローカルストレージを使用してウォークスルーを完了するためのユーザー情報を追跡することができます。

WalkMeで独自のCookieを作成する方法については、 WalkMeデータに関するこの記事をご覧ください。

WalkMeは、以下のような理由でエンドユーザーのブラウザにデータを保存します：

1. スマートウォークスルー状態（エンドユーザーがスマートウォークスルーの途中にあるかどうか）
2. 自動再生ステータス（展開可能ファイルがすでに再生されているかどうか）
3. ゴール完了
4. WalkMeデータ

定義

1. ストレージ方法：ファーストパーティ（同一ドメイン）またはサードパーティ（クロスドメイン）のいずれかのブラウザ上でのストレージの保存方法
2. ストレージタイプ：ブラウザでのストレージの保存場所（ローカルストレージとCookie）
3. ブラウザストレージとサーバーストレージ：データがエンドユーザーの現在のブラウザにのみ保存されるか、またはWalkMeのサーバーに送信されるか（詳細は以下を参照）

サーバーストレージとは？

サーバーストレージは、WalkMeプレーヤーサーバーを介して、異なるブラウザ間でエンドユーザーの状態を同期します。

以下のエンドユーザーの状態はサーバーストレージに保存され、異なるブラウザに同期されます：

1. 1回のみ自動再生の評価
2. ゴール完了
3. TeachMeコースの完了
4. WalkMeデータ

拡張ストレージ

拡張ストレージは、WalkMeストレージオプションの範囲を拡大することを目的としており、最終的には拡張機能を備えた実装のためのデフォルトのストレージ設定となります。 WalkMe関連のデータは拡張設定内に安全に保存され、ブラウザのセキュリティ設定を調整する必要はありません。

拡張ストレージは、Chrome、Firefox、Edge Chromiumと互換性があります。

ストレージAPI

ストレージAPIは、異なるタイプのストレージを管理するための簡単で統一されたインターフェースを提供する新しいブラウザベースのAPIです。 それを活用することで、重要な情報を失ったり、ログインし直す必要がなく、より効率的かつ選択的にデータを管理します。

ブラウザレベルのデータに依存するWalkMeコンテンツをテストまたはトラブルシューティングするために、ブラウザキャッシュとCookieを消去する必要がなくなりました。 キャッシュとCookieを消去することは、ローカルレベルでWalkMe関連データをリセットする一般的な方法ですが、保存されたすべてのデータも削除され、ユーザーがウェブサイトにログインし直す必要があります。

さらに、ストレージAPIは、WalkMeの拡張ストレージの段階的なロールアウトの便利なところです。 拡張ストレージでは、ブラウザキャッシュとCookieを消去することができません。 その場合、WalkMeデータを消去する必要がある場合は、ストレージAPIを使用します。

APIは、ブラウザ開発者ツールコンソールで利用できます。 コンソールにアクセスするには、ウェブページを右クリックし、選択します 検査します 次に、コンソールタブをクリックします。

利用可能なコマンドのリストは次のとおりです：

WalkMeAPI.storage.getAll()

• 現在のブラウザでローカルに保存されたすべてのWalkMeデータを返します
• このコマンドを使用して、すべての既存のデータと、以下のキーで設定したデータを表示します

WalkMeAPI.storage.removeAll()

• 現在のブラウザでローカルに保存されたすべてのWalkMeデータを削除します
• ページが更新された後に、デフォルトのWalkMeデータキーがリセットされます

WalkMeAPI.storage.setItem()

• テスト目的でカスタムデータキーを作成するために使用します
• 2つの必須フィールドと1つのオプションフィールドを受付けます：

• キー：ストレージに追加したいキーの文字列名。 キーが一意であることを確認するために、接頭語として「wm-」をデフォルトで追加することを推奨します。
• 値：追加したいキーの値、文字列または数字
• （オプション）期日を秒単位で設定：ローカルストレージにキーを存在させたい秒数。 指定されていない場合は、2年のデフォルト値が割り当てられます。

• 例：
  • WalkMeAPI.storage.setItem(‘test-1’,123) は2年間、名前「wm-test-1」と値123のキーを設定します。 このキーを設定し、WalkMeAPI.storage.getAll() を実行すると、以下の結果が表示されます：

• WalkMeAPI.storage.setItem(‘test-2’,’Test value’, 360) は、360秒間で、名前「wm-test-2」と「テスト値」の値でキーを設定します。

WalkMeAPI.storage.getExpiryDate()

• データキーが期限切れになる日付と時刻を返します
• キー名を受け入れます
• 例：
  • WalkMeAPI.storage.getExpiryDate(‘wm-test-2’)

ストレージ設定に関するご質問やサポートが必要な場合は、WalkMeまでお問い合わせいただくか、サポートに連絡してください。