ライブで試す
このページは、Zenovay トラッカーがイベントを記録するときに送信するリクエストをそのまま組み立てます。自分のサイトに組み込む前に、フィールドごとに内容を読めます。イベント名を変更するとペイロードが更新され、送信するとレスポンスが表示されます。
既定で Cookie レスです。下の訪問者 ID とセッション ID は、このページ専用にメモリ上で生成されます。Cookie やローカルストレージには何も書き込まれません。
送信のしくみ
ボタンは、チームがサンドボックスのサイトに向けて設定しているかどうかに応じて、2 つのモードのいずれかで動作します。
- シミュレーションモード(既定)。リクエストはブラウザから外に出ません。記録されたカスタムイベントに対して取り込みが返す代表的な
200レスポンスが、シミュレーションとして表示されます。実際の分析データに触れることなく、ページの内容を正直に保ちます。 - ライブモード。実際のサンドボックス用トラッキングコードが設定されている場合、ボタンはそのサイト 1 件だけにイベントを送信し、実際のレスポンスを表示します。未知のコードはきれいな
404を返すため、入力ミスがあっても余計なデータは作成されません。
このページは分析データを読み戻しません。リクエストと取り込みのレスポンスを表示するだけです。記録されたイベントを確認するには、自分が所有するサイトのダッシュボードを開いてください。
ライブモード
サンドボックス用トラッキングコードが設定されています。送信ボタンはそのサイト 1 件だけに実際のイベントを送信し、実際のレスポンスを表示します。
下のペイロードで event_name として使われます。編集するとリクエストが更新されます。
リクエスト
Content-Type: application/json
{
"event_type": "custom",
"event_name": "signup_clicked",
"session_id": "s_0000000000000000",
"visitor_id": "v_0000000000000000",
"url": "https://example.com/pricing",
"referrer": "https://example.com/",
"device_type": "desktop",
"browser": "Chrome",
"os": "macOS",
"screen_width": 1512,
"screen_height": 982,
"language": "en-US",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
}レスポンス
イベントを送信すると、ここにレスポンスが表示されます。
リクエストの説明
トラッカーは、パスにサイトのトラッキングコードを含めて、イベントエンドポイントへ POST を送信します。
POST https://api.zenovay.com/api/events/<あなたのトラッキングコード>
Content-Type: application/json
ボディはプレーンな JSON です。カスタムイベントには event_type、event_name、8 文字以上の session_id、ページの url、および基本的なクライアントフィールド(device_type、browser、os、user_agent)が必要です。残りは任意のコンテキストです。同じエンドポイントは /api/track/<code> と短いパス /e/<code> も受け付けます。
記録されたイベントは次のように返ります。
{
"success": true,
"data": {
"type": "event_recorded",
"event_type": "custom",
"event_name": "signup_clicked"
},
"timestamp": "2026-06-20T00:00:00.000Z"
}
次のステップ
- 自分のサイトにトラッキングスクリプトをインストールします。
- アプリケーションのコードからカスタムイベントを送信します。
- API キーを使ってAPI エンドポイント全体をテストします。