レコード開始/停止を任意に制御する
Liveの配信条件に合致して配信(配信設定方法はこちら のページをご参照ください。)されると、
ページ遷移を行わない限りそのページのレコード処理を自動で行い続けます。
SPA内でレコード処理を行いたく無いページを除外する場合や、
ページ遷移が伴わないが不必要なコンテンツのレコードを停止したい場合に、
JavaScript APIを通じてレコードの開始/停止を制御することが可能です。
レコード対象外としたいパスを指定して制御する方法
こちらの記事をご参照ください。
開始/停止関数を直接コールして制御する方法
上記方法で対応できない場合(ページ遷移を伴わない場合等)、直接Liveスクリプトの関数をコールすることでも制御する事ができます。
Liveスクリプト生成オブジェクト
Liveスクリプトが配信され、正常に起動している場合下記のオブジェクトがページ上に存在します。
非同期でLiveスクリプトが読み込まれる為、ページ描画直後にオブジェクトがまだ生成されていない可能性があります。エラーを防ぐ為、オブジェクトの存在チェックをして関数の実行を行うことを推奨致します。
window.__karte_live
レコードの開始
レコードを開始したい場合は、下記の関数を実行します。
停止されていない状態で実行しても何も起こりません。
window.__karte_live.record();
レコードの停止
レコードを停止したい場合は、下記の関数を実行します。
開始されていない状態で実行しても何も起こりません。
window.__karte_live.stop();
注意事項
- 当機能でレコードの開始/停止を行うと、別PVとしてレコードが開始されます。(セッションは同一のものになります。セッションの定義は こちら のページをご参照ください)
Updated 3 months ago