配信チェック用ツール「KARTE Action Viewer」のご利用方法についてご説明します。
目的
「KARTE Action Viewer」とは、下記のような目的で利用するための Google Chromeの拡張機能です。
- どの接客サービスが配信・表示されているか確認する
- どのようなイベントがKARTEに送られているか確認する
- サイト内の要素のCSSセレクタを確認する
- 計測タグ未設置のサイトで、viewイベントを発生させる
インストール方法
Chrome ウェブストア にアクセスし「Chromeへ追加」をクリックしてください。
正しくインストールされるとChromeのデベロッパーツールに「KARTE」タブが追加されます。
利用方法
- 「KARTE Action Viewer」がインストールされたChromeでKARTE管理画面にアクセスし、ログインします
- 別のブラウザタブで、自サイトの計測タグが設置されているページへアクセスします
- Chromeデベロッパーツールを開き、「KARTE」タブをクリックします
- 自サイトを表示させたまま、ページを更新します
- KARTEにログインしていれば、「KARTE」タブ内の「ログイン状態」が「ログイン済」になり、イベント・接客サービスの情報が表示されます
各機能紹介
「送信されたイベント」の確認
中央カラムに、送信されたイベントが上から送信された順に表示されています。
各イベント名をクリックすると、イベントに付加された属性項目を確認することができます。
表示される項目は、サイト上で明示的に付加された属性項目のみです。
イベントによってはKARTEにイベントが到達した時点で付与される属性項目があり、それらは「KARTE Action Viewer」で確認することは出来ません。
例えばview(閲覧)イベントは、ユーザー行動詳細画面では属性項目が表示されますが、「KARTE Action Viewer」では属性項目が表示されません。
フィルタイベントはKARTE Action Viewerで確認できますか？
フィルタイベントについてはサーバーサイドで発生するイベントのため、KARTE Action Viewerでは確認ができません。
ユーザーストーリー画面で発火をご確認ください。「配信された接客サービス」の確認
中央カラムに、配信された接客サービスのリストが並んでいます。
接客サービス名は、各「管理画面URL」をクリックし、KARTEの管理画面でご確認ください。
※ 「配信比率で未接客グループに振り分けられた」サービスには「未接客グループ」の記載がされています。
※ 「配信条件に合致したが何らかの理由で表示されていない」サービスには「非表示」の記載がされています。
「サイト要素のCSSセレクタ」の確認
拡張機能アイコン表示されている「KARTEアイコン」のマススポインターアイコンをクリックすると、CSSセレクタ確認モードになります。
サイト内の確認したい要素をホバーすると、CSSセレクタが表示されます。
※ 要素をクリックすることで、CSSセレクタのコピーが可能です。
計測タグのテスト実行
計測タグの設置がまだ完了していない場合に、この機能を使って計測タグを手動で発生させ、自分のブラウザ上でKARTEの計測を開始させることができます。
本機能を不用意に別サイトで利用しないでください。
不要なユーザーデータ（イベント）が発生し、該当のイベントは削除することができません。- Chrome拡張を インストール します
すでにインストールしている場合は不要です。 - Chromeデベロッパーツールを開き、「KARTE」タブをクリックします
- 下記画像1が指している 「計測タグのテスト実行」を選択
- 下記画像2で囲っているステップに従って、計測をしてみましょう
- 計測を開始すると、「テスト計測タグ発動中」に代わります
- 画像下部の「管理画面で自分を表示するURL」からKARTE管理画面で自分の行動ログをリアルタイムに確認することができます
トラブルシューティング
「KARTE Action Viewer」はChromeの最新版での動作しかサポートしていません。
まずは次の点をご確認ください。
- Chromeのバージョンが最新であること
- 「KARTE Action Viewer」のバージョンが最新であること
- 最新のバージョンは、前述したChrome ウェブストアのページからご確認ください
以下、事象別のトラブルシューティング方法をご説明します。
デベロッパーツールに「KARTE」タブが表示されない
- Chrome拡張機能が有効化されていないケース
- Chromeアドレスバーに
chrome://extensions/と入力し、拡張機能の設定画面を開きます - KARTE Action Viewerが有効であることを確認します
- Chromeのバグ等で一時的に拡張機能が読み込めていないケース
次のいずれかの方法で「KARTE」タブが表示される可能性があります。
- デベロッパーツールを開き直す
- デベロッパーツールを Undock する
- 同一サイトの別のページで試す
「KARTE」タブのログイン状態が「ログイン済」にならない
- Chromeの別タブで、対象ページの計測タグに対応するKARTEのプロジェクトにログインしていないケース
- 別タブでKARTEにログインしてください
- Ghosteryなどの広告ブロック用Chrome拡張機能と競合しているケース
- Ghosteryなどの広告ブロッカーをChrome拡張機能で利用している場合、ログイン判定が失敗するケースがあります
- 広告ブロッカーをOFFにしてお試しください
- サードパーティーCookieがブロックされているケース
- Chromeの「Cookieと他のサイトデータ」の設定で「Cookieをすべて受け入れる」となっていることを確認ください
- KARTEそのものは、サードパーティーCookieがブロックされていても（マルチドメインタグを除き）動作致しますが、KARTE Action Viewerの動作には、サードパーティーCookieが利用可能な状態である必要がございます
viewイベントのステータスが"waiting..."のまま変わらない
- 送信したイベントに対応するKARTEからのアクション配信に失敗しているケース
以下の記事を参考に、自分自身のユーザー詳細画面で_errorイベントが発生していないかご確認ください。_errorイベントが発生している場合は、そのエラーメッセージから原因特定できる可能性があります。
- イベントデータをKARTEに送る処理が失敗しているケース
イベントが発生しない場合のチェックリスト をご確認ください。
KARTE Action Viewer自体のログ確認方法
KARTEのサポートから、KARTE Action Viewerのログの共有を依頼する場合があります。
その際は、以下の手順でログの内容を確認し、スクリーンショットのご共有をお願いします。
デベロッパーツールを別ウィンドウで開く
Chrome本体で該当ページを、ChromeデベロッパーツールでKARTEタブを開いたまま、右上の「三点マーク」から設定プルダウンを開き、"Dock side"を"Undock into separate window"にします。
別ウィンドウで表示させたChromeデベロッパーツールに対して、更にデベロッパーツールを開く
Chromeデベロッパーツールのウィンドウをアクティブにした状態で、デベロッパーツールを開くためのショートカットキー(Windowsの場合Ctrl+Shift+I、Macの場合Cmd+Opt+I)を押します。
開かれたデベロッパーツールの上部に"Developer Tools - chrome-devtools://..."と表示されていれば、成功です。
KARTEタブのコンソールを表示する
手順2で開いた方のデベロッパーツール内で「Consoleタブ」を開きます。
このタブ内に表示されるログが「KARTE Action Viewer」から出力されたログになります。ページを更新し、コンソールを確認する
計測タグ設置ページを開いているChromeのタブをページ更新し、手順3で表示させたコンソールにエラーログが出力されるかどうか確認します。
エラーログがある場合は、お手数ですがスクリーンショットとエラー文言を添えてサポートまでお問い合わせください。
- よいスクリーンショットの例
KARTE Action Viewerのバージョンがアップデートされない
古いKARTE Action Viewerを使っている場合に、バージョンの自動更新が止まってしまうケースがあります。
お手数ですが、一度Chrome拡張機能を削除し Chrome ウェブストア から再インストールをお願いします。