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

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

この機能はβ機能のため今後仕様が変わることや提供を停止する可能性もございますので、その点はご了承ください。また、ご使用される場合にはプラグインが必要のため、営業担当にお問い合わせください。

事前準備

アプリの実装を行う

iOSとAndroidそれぞれでビジュアルトラッキングを有効にするための実装が必要です。
実装方法は iOS SDK - ビジュアルトラッキングを利用する（Beta） または Android SDK - ビジュアルトラッキングを利用する（Beta） を参照ください。
（当機能はSDK v1.6.0から対応しています。必要に応じてSDKをアップデートしてください。）

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

null

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

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

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

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

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

  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　　
  • フィールド　　
    • イベント発火時に一緒に送信されるフィールド

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

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

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

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

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

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

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

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

注意点

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