datafast

このスキルを使用する場面

• DataFast トラッキングをウェブサイト（静的サイト、SPA、Next.js、Astro など）に導入する必要がある場合。
• マーケティングチャネル（Stripe、LemonSqueezy、Polar、カスタムプロバイダー）に収益を紐付ける必要がある場合。
• 広告ブロッカーの影響を受けずに、カスタムイベント／目標を確実に記録したい場合。
• データ品質の向上やハッシュベースのナビゲーションのため、トラッカー／スクリプトをプロキシする必要がある場合。
• 過去の分析データをエクスポート／インポートしたり、DataFast API にクエリを送信したりしたい場合。

クイックスタート（4 ステップ）

1. トラッキングスクリプトを <head> 内にインストールします：

   <script
     defer
     data-website-id="dfid_XXXX"
     data-domain="example.com"
     src="https://datafa.st/js/script.js"
   ></script>
   

   • data-allow-localhost、data-api-url、data-debug、data-allowed-hostnames、data-disable-console、data-allow-file-protocol を使用してカスタマイズします。
   • ライブラリの読み込み前に発生した呼び出しをキューに入れるには、datafast-queue スニペットを含めます。
2. 決済プロバイダー（Stripe、LemonSqueezy、Polar、Shopify など）を Revenue タブから接続すると、DataFast が収益を自動的にトラッキングします。
3. window.datafast("my_goal")、data-fast-goal 属性、またはサーバーサイドの Goals API を使用して、カスタム目標／イベントを追加します。
4. 任意のプロキシで広告ブロッカーを回避します。/js/script.js と /api/events を自分のドメインに書き換え、x-datafast-real-ip で訪問者の IP を転送します。

インストールのリファレンス

• スクリプトは、フレームワーク（Next.js App Router、React、Vue、Astro など）では <Script /> コンポーネントを介して読み込むか、public/index.html に宣言的に記述します。
• ハッシュベースのナビゲーションには、ハッシュ対応スクリプト https://datafa.st/js/script.hash.js を使用します。
• GTM、Shopify、Webflow、Wix、Podia、Kajabi、Ghost、Bubble、Framer、Astro、React Router、Laravel、Django、FastAPI、Flask、Express、PHP、Nginx、Firebase、Rocket などでは、同じスクリプトを <head> またはプラットフォーム固有の head／カスタムコードセクションに追加します。

収益紐付けのベストプラクティス

• トラッキングスクリプトが有効になったら、ウェブサイト設定 → Revenue に移動し、各決済プロバイダーを追加します。
• チェックアウトセッションの作成時には、必ず datafast_visitor_id（必要に応じて datafast_session_id も）を渡します。
  • Stripe Checkout／PaymentIntent：cookies() または request.cookies から Cookie を読み取り、metadata に追加します。
  • LemonSqueezy：DataFast の Cookie を custom に含めます。
  • Polar：Cookie を metadata に追加します。
  • Paddle／Dodo Payments／Easytool／Custom：Payments API を呼び出すか、顧客のメールアドレスを指定して payment 目標を発火させます。
• DataFast がすでに収益を取得しているゲートウェイ（Shopify、Stripe、LemonSqueezy、Polar）では、トラッキングスニペットをインストールしたまま、重複する手動イベントは省略します。
• メタデータのマッピングを文書化し、後続のジョブが各金融イベントの datafast_visitor_id を読み取るようにします。

カスタムイベントと目標

方法 1 – window.datafast()（クライアントサイド）

• クリック時、成功ページ、または API レスポンスの受信後に window?.datafast("goal_name") を発火させます。
• パラメーターを記録します：window.datafast("checkout", { price: "49", plan: "pro" })。

方法 2 – HTML データ属性

• ボタン／リンクに data-fast-goal="goal_name" を追加します。
• data-fast-goal-* 属性で情報を追加できます（data-fast-goal-price="49" は { price: "49" } になります）。

方法 3 – サーバーサイド Goals API

• datafast_visitor_id、name、任意の metadata を指定して https://datafa.st/api/v1/goals に POST します。
• Authorization: Bearer YOUR_API_KEY で認証します。
• 訪問者がすでに少なくとも 1 回ページビューを記録していることを確認します（スクリプト経由でトラッキングされます）。

ファネル、スクロール、フィルター

• 重要なセクション（機能、料金、お客様の声）に data-fast-scroll を使用すると、要素の 50% が表示された時点でスクロール目標が送信されます。
• スクロール目標とファネル（ランディングページへの訪問 → 機能までスクロール → CTA のクリック）を組み合わせて、離脱箇所を特定します。
• DataFast が自動的に追跡する UTM／ref／via パラメーターを追跡します。マーケティングリンクには ?ref=、?utm_source=、?utm_medium=、?utm_campaign=、?utm_term=、?utm_content を含めるようにします。
• フィルターを使って、国、デバイス、キャンペーン、URL パス、カスタム目標別にデータを抽出します。チャートにカーソルを合わせると、フィルターのショートカットが表示されます。
• 内部トラフィックを除外する datafast_ignore localStorage のドキュメントを用意します。

プロキシとホスティングのガイダンス

• リクエストをプロキシし、スクリプトが /js/script.js から読み込まれ、イベントが自社ドメインの /api/events に送信されるようにします。
• 正確な位置情報を維持するため、訪問者の IP を x-datafast-real-ip で転送します。
• Next.js の rewrites、Express HTTP proxy、Flask/FastAPI のルート、PHP スクリプト、Nginx/Caddy のルール、Firebase Functions、DigitalOcean/Nginx の例は、すぐに利用できるパターンです。スタックに合ったものを調整してください。
• data-allowed-hostnames="app.io,shop.example.com" で追加ドメインを許可リストに登録し、サブドメイン間で Cookie を共有するには、data-domain にルートドメインを設定します。
• カスタムルーティングが必要な場合は data-api-url または datafast_events エンドポイントを使用します。トラッカーはプロキシ構成を自動検出します。

API とエクスポート／インポート

• DataFast API（Overview、Timeseries、Devices、Pages、Countries、Referrers、Campaigns、Goals、Payments、Visitors、Metadata、Realtime）では、すべて Authorization: Bearer <API_KEY> が必要です。
• 未対応のプロバイダーから売上を送信するには、Payments API を使用します。amount、currency、transaction_id、および訪問者 ID を含めます。
• サーバーサイドイベントには Goals API を使用します（メタデータキーは最大 10 個）。
• 過去のデータを維持するには、Plausible のエクスポートを DataFast にインポートします。Import your Plausible data を参照してください。
• API Playground、Real-time エンドポイント、またはカスタムスクリプトを使って、ダッシュボードにエクスポートします。

モバイルとサポート

• DataFast モバイルアプリ（iOS/Android）をインストールすると、外出先でも指標を確認できます。API キーを使って任意のサイトを接続できます。
• キーワードの影響を確認するには、Google Search Console との連携を使用します。ドメインが確認済みで、オーナーまたはフル権限を持っていることを確認してください。
• GitHub のコミットをダッシュボードで追跡し、リリースと売上急増の相関を確認します。
• サポート、機能リクエスト、トラブルシューティングについては、[email protected] または https://feedback.datafa.st/ までお問い合わせください。

トラブルシューティングのチェックリスト

• スクリプトが発火せず、ヘッダーが表示されない場合：タグが <head> 内にあり、data-website-id のドメインが data-domain と一致していることを確認します。
• 売上が記録されない場合：決済プロバイダーとの接続と、Stripe/LemonSqueezy/Polar のセッションにおけるメタデータ Cookie を確認します。
• 目標が記録されない場合：目標名が小文字、アンダースコア、ハイフンを使用し、64 文字を超えていないことを確認します。
• Vercel のプレビューにデータが表示されない場合：ステージング中に data-allow-localhost="true" を有効にするか、本番環境ではプロキシ経由のスクリプトを使用します。
• プロキシ経由の訪問者がすべてサーバー IP として表示される場合：x-datafast-real-ip を追加するか、X-Forwarded-For を転送します。

参考資料

• スクリプト設定のリファレンス：data-allowed-hostnames、data-api-url、data-allow-localhost、data-disable-console、data-debug。
• 売上アトリビューションガイド（Stripe Checkout、PaymentIntent、Checkout Links、LemonSqueezy、Polar、Paddle、Dodo Payments、Easytool）。
• 技術別のインストールドキュメント（Shopify、Webflow、Wix、Ghost、Next.js、Astro、Laravel、React Router、Firebase、Astro middleware、Caddy、Nginx、DigitalOcean など）。