ドキュメントDataFast からの乗り換え

02 · インストール

タグを 1 つ差し替えて DataFast から乗り換える

Tally は DataFast のタグと同じものを読み取るので、ページのコードはそのままで構いません。

01タグを差し替える

DataFast のタグを削除し、サイトの Setup ページにある自分のタグを追加します。ページのほかの部分は何も変わりません。

削除
<script defer data-website-id="dfid_…" data-domain="yoursite.com" src="https://datafa.st/js/script.js"></script>
追加
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>

02そのまま動くもの

  • タグの data-website-id(data-site として読み取ります)と data-allow-localhost="true"。
  • window.datafast(name, props) の呼び出しと、スクリプトの読み込み前の呼び出しを受ける DataFast のキュー用スニペット。
  • data-fast-goal="name" 属性と、その data-fast-goal-<key> プロパティ(DataFast と同じく、ケバブケースはスネークケースになります)。
  • datafast_visitor_id Cookie。再訪問者はこれを訪問者 ID として引き継ぎ、Cookie も更新され続けるため、これを読み取るチェックアウトのコードは引き続き売上を紐づけます。
  • Stripe、Paddle、Lemon Squeezy、Polar のメタデータに入った datafast_visitor_id。そのまま読み取ります。
  • ブラウザを除外する localStorage.datafast_ignore = true。
  • DataFast の決済 API の呼び出し。パスも本文も同じです(Payments API)。

03動作が異なるもの

  • data-domain は無視されます。Cookie を保持できる最も広いドメインを、スクリプトが自分で見つけます。
  • Cookie なしモード、同意優先モード、ハッシュルーティングは、別ファイルではなく 1 つのスクリプトの属性(data-mode、data-hash)です。
  • data-api-url は読み取りません。プロキシは data-api で設定します。DataFast 用のプロキシは DataFast に転送するものなので、いずれにしても差し替えの際に変わります(自分のドメインから配信する)。
  • ゴールのプロパティ:10 個を超える場合や不正なキーがある場合、DataFast はゴールを破棄しますが、このスクリプトでは有効なものを先頭から 10 個まで保持します。
  • datafast_session_id は書き込みません。セッションはサーバー側で判定し、売上は訪問者 ID で紐づけます。
  • datafast('identify', …) と datafast('payment', …) は、メールアドレスを含む場合に identify として扱われ、そのアドレスで購入者を照合します。名前、画像、カスタムキーは送信しません。
  • Stripe の Payment Links には、訪問者 ID(client_reference_id)が自動でタグ付けされます。
  • ほかのホスト名へのリンクのクリックは、すべて外部リンクとして数えます。www.yoursite.com から app.yoursite.com へのリンクも含みます。

04引き継がれないもの

05うまくいったか確認する

足りない情報や、実際の画面と違う点はありませんか? どのページかを添えて support@tallybyoutpost.com までお知らせください。