Reference

tracker.form

フォームトラッキング

❗️

tracker（タグv1）のサポート終了について

trackerを利用したタグv1は、サポートの終了を予定しています。詳細は下記をご覧ください。

タグv1のサポート終了のご案内とタグv2移行のお願い | KARTEサポートサイト

❗️

本機能は廃止予定です

タグv1のサポート終了とともに、本機能は廃止される予定です。新規の利用はお控えください。

引数で指定したCSSセレクタに合致するページ上のformに対してイベントハンドラを登録し、submit時にフォームの内容をKARTEのイベントとしてトラッキングします。
submitイベントが実行される前にtracker.formを実行してください。

Syntax:

tracker.form(dom_selector, options)

Arguments:

NameTypeRequiredDefaultDescription
dom_selectorString'form'トラッキングした form の DOM を示すCSS セレクタ
optionsObjectnullオプション
options.event_nameString'form'イベント名
options.send_dataBooleanfalseaction と method 以外のパラメータもトラッキングします。(type="password" の場合は、send_data=true でも送信しません。)
options.stop_words[String][]send_data: trueの場合でも値を保存したくないinputのnameを配列形式で指定できます。
options.preFunctionnull送信データをカスタマイズするための関数

options.pre arguments:

NameTypeDescription
dataObjectform で送信されたデータ
tracker.form("#formA", {
  event_name: "formA_send",
  send_data: true,
  stop_words: ["password", "pass", "company"],
  pre: function(data) {
    delete data.password;
    return data;
  }
});

🚧

ブロッキングと二重送信について

tracker.formとtracker.link はページ遷移をブロックしません。イベントは一度 localStorage に保存し、ページ遷移が速く送信が完了しなかった場合、ページ遷移を跨いで送信することがあります。そのためタイミングによっては二重送信となることがあります。