ビジュアルトラッキングの概要

画面表示やボタンタップなどの一連の操作ログから直感的にイベント発生条件を作成し、アプリのアップデートなしで条件にマッチしたイベント発火が可能となります。
主な利用シーンとしては、以下の2つがあります。

  1. 静的なフィールドのみのイベントをビジュアルトラッキングで計測することで、実装コストを下げる（viewイベント等）
  2. イベント実装後に計測したいイベントが追加でできた場合に、追加実装やアプリのリリースなしでイベントを追加する

ご使用される場合にはプラグインが必要のため、営業担当にお問い合わせください。

事前準備

アプリの実装を行う

iOSとAndroidそれぞれでビジュアルトラッキングを有効にするための実装が必要です。
実装方法は下記を参照ください。

※当機能はSDK v1.6.0から対応しています。必要に応じてSDKをアップデートしてください。

新規イベントをビジュアルトラッキングする

画面閲覧イベントをビジュアルトラッキングで計測したい場合は、新たにイベントを作成するのではなく、viewイベントに発生条件を追加する形で指定をお願いします。手順は以下をご確認ください。

viewイベントをビジュアルトラッキングする

null

デバイスと管理画面をペアリングする

イベント発生条件の作成元となる操作ログを管理画面に送信するため、
デバイスと管理画面のペアリングを以下の手順で行います。

  1. イベント作成ボタンをクリック後、ビジュアルイベントを選択
  2. URLスキームの編集ボタンからiOS/Android用のURLスキームを入力して保存
  3. URLスキームを保存するとQRコードが生成されます
  4. 生成されたQRコードをデバイスで読み込み、アプリを起動
  5. 管理画面にペアリング中の文字が表示されればペアリング成功です

ペアリングが正常に行われない場合は、管理画面で選択しているOSと端末のOSに相違がないか？、ビジュアルトラッキングのモジュールが正常にインストールされているか？をご確認ください

操作ログからイベント発火条件を作成する

ペアリング中のデバイスの操作ログからイベント発生条件を作成します。

  1. ペアリング状態のまま、デバイスで計測をしたい操作を行う（例：アイテムをカートに追加する）
  2. 管理画面に次々と操作ログが流れていきます
  3. イベント発生条件に使いたい操作ログのチェックボックスにチェックをいれる
  4. イベント名、イベント表示名などのイベントの詳細情報を編集する
  5. 編集が完了後、保存ボタンをクリックしてイベント定義を保存する

イベント発火条件を編集する

  1. 作成済みのイベント定義の編集ボタンをクリックする
  2. 「保存済のイベント発火条件」を開き発火条件を編集する
  3. 発生条件の値と条件をそれぞれ変更して保存する

条件の詳細はイベント発生条件についてを参照ください

ビジュアルイベントの動作確認をする

  1. アプリ上で何らかのイベントを発火させる（イベント発生条件はtrackのレスポンスに付与されるため）
  2. アプリ上で作成済みのイベント発生条件にマッチする操作を行う
  3. ユーザー詳細画面で発火したイベントを確認する（新規発生のイベントは表示に30秒ほどかかります、表示されない場合はブラウザをリロードしてください。）
  4. ユーザー詳細画面で、該当イベントのデータを「データを確認する」からご覧いただき、閲覧イベント（viewイベント）の、 _systems フィールドの auto_track が 1 に等しければ、ビジュアルイベントが正しく送信されています

既存イベントをビジュアルトラッキングする

新規にビジュアルイベントを作成するだけでなく、既存のイベントもビジュアルトラッキングすることができます。

viewイベントをビジュアルトラッキングする

基本的な手順はビジュアルトラッキングの設定方法と同様です。
閲覧イベントの編集ボタンをクリックして、イベント発生条件を作成します。尚、viewイベントの場合、発生条件のフィールドへview_nameとtitleの指定は必須となります。

既存のカスタムイベントの発生条件をビジュアルトラッキングで追加する

発生条件を追加したいカスタムイベントの詳細画面で、右上の編集ボタンをクリック。以下キャプチャにある通り、種別のプルダウンでビジュアルトラッキングを選択し、QRを読み取ります。以降は上記と同様の手順で操作します。
null

イベント発生条件について

イベント発生条件の構成要素

イベント発生条件は以下要素で構成されます。
アクション名は編集不可、発生条件とフィールドは編集可能です。

  • アクション名
    • アプリ上で行った操作の名称（例：touch）　　
  • 発生条件　　
    • target_text：アクションの対象テキスト（ボタンの場合はボタンタイトルなど）　　
    • view：アクション発生元のview　　
    • view_controller/activity：アクション発生元のViewControllerまたはActivity　　
    • action_id：アクションが発生したViewを一意に識別するための文字列（SDK v2以降で利用可能）
  • フィールド　　
    • イベント発火時に一緒に送信されるフィールド
    • 特に閲覧イベントを設定する際は、「view_name」と「title」のフィールドの手動設定が必須

所謂画面と対応するものが ViewController（またはActivity）です。ViewControllerは複数のViewの表示や挙動をコントロールするものです。また、その画面を構成する要素（ボタンやラベル）のことをViewと呼びます。（詳細の説明は、各OSのドキュメントを参照下さいませ。）

viewとview_controller（またはactivity） および、手動で設定するフィールド（viewであれば view_name やtitle）の組み合わせで、どの画面で発生したイベントかを判別可能にしています。

発生条件と操作のマッチの仕方

発生条件値とのマッチ条件に「に等しい」「と異なる」「から始まる」「を含む」「で終わる」が選択可能です。（例：target_textの値を「購入」、マッチ条件を「を含む」とした場合、「xxを購入」、「購入済みのxx」などのtarget_textにマッチします。）
発生条件には、action、target_text、view、view_controller/activity、action_id（SDK v2以降で利用可能）があり、発生条件のすべての値がユーザーの操作とマッチした場合（AND条件）にイベントが発火します。

複数の発生条件がある場合

発生条件は複数定義することが可能です。複数の発生条件のうち、一つでもユーザーの操作がマッチした場合（OR条件）イベントが発火します。

イベント発生条件がアプリに反映されるタイミング

イベント発生条件は全イベントの送信のレスポンスに付与されます。
尚、イベント発生条件に更新がある時だけレスポンスに付与され、メモリ上に保持されます。

ビジュアルイベントを識別する方法

ビジュアルイベントでは、イベントフィールドの _system.auto_track が 1 となっているため、こちらで識別が可能です。

注意点

  • ビジュアルトラッキングイベントを作成できるのは、管理者権限を持つアカウントのみです。
  • URLスキームを指定する際は、 ://の前までを指定してください。 （例： karte:// ではなく karte ）
  • アプリの仕様上、取得できない操作ログがあります。
  • iOSとAndroidは別々に指定する必要があります。
  • WebView内の操作はビジュアルトラッキングのサポート対象外です。
  • 対象の端末にインストールされているアプリにて、ビジュアルトラッキング対応のKARTE SDK（v1.6.0以降）が導入されたものではない場合は、ビジュアルイベントが発生しないことにご注意下さいませ。例えば、ゴールイベントとしてビジュアルイベントを設定した際、ビジュアルトラッキング未対応のアプリからのゴールは測定されないことになります。
  • アプリの作りが変わると、イベント発生条件が変わりイベントが発生しなくなるケースがあります。アプリの作りが変わった場合にはビジュアルトラッキングで設定したイベントが発生しているかご確認いただき、発生していなければ条件の編集をしていただく必要があります。
  • 条件欄のプルダウンで表示される選択肢の候補は、計測された最初の10件の値が表示されます（ただしロジックとして最初の10件を取得する仕様にあえて指定しているわけではないため必ずしも最初の10件ではない、ランダムな値が入る場合もあります）。候補として表示されない場合はイベント名を直接入力ください。
    null