収益レポートのエクスポート

Pro プラン

Zenovayを使用すると、外部分析、レポート、または他のビジネスツールとの統合のためにデータを取得できます。2つの方法があります: データエクスポートツール (CSV/JSONファイルをダウンロードまたはスケジュール) と REST API (プログラム的に数字をクエリ)。この記事では両方の方法と、各形式から収益数字を読み取る方法をカバーしています。

データエクスポートをダウンロード

Scale プラン

データエクスポートツールはエージェンシー ページ (所有者と Scale プラン以上の管理者) に位置します。

1. 1

   エクスポートツールを開く

   エージェンシー → エクスポート に移動します。

2. 2

   ウェブサイトと日付範囲を選択

   1つ以上のウェブサイトと、エクスポートしたい期間を選択します。

3. 3

   フォーマットを選択

   CSV または JSON でエクスポートします。

4. 4

   エクスポートを実行

   Zenovayはファイルを作成し、準備ができたら安全なダウンロードリンクをメールで送信します。より大きい範囲はバックグラウンドで処理されます。

エクスポートフォーマット

フォーマット	推奨用途
CSV	Excel、Google Sheets、データベース
JSON	API統合、開発者、カスタムダッシュボード

エクスポートの内容

データエクスポートには、デフォルトで集計された日次メトリクス (1日につき1行) が含まれています:

フィールド	説明
date	メトリクスがカバーする日
visitors	合計訪問者数
unique_visitors	ユニークな訪問者
pageviews	ページビュー合計
bounce_rate	バウンス率
avg_session_duration	平均セッション期間

生エクスポートには、代わりに訪問者レベルの詳細が含まれます – date、session_id、device_type、browser、os、country_code、city、referrer、および各訪問のエンゲージメント値スコア。

CSV出力サンプル

date,visitors,pageviews,unique_visitors,bounce_rate,avg_session_duration
2026-06-13,1248,3104,982,41.2,138
2026-06-12,1190,2987,941,43.7,142
2026-06-11,1305,3380,1024,39.8,151

スケジュール済みエクスポート

Scale プラン

定期的なエクスポートを自動化して、更新されたファイルがスケジュールに従ってインボックスに到着するようにします。

1. 1

   エクスポートツールを開く

   エージェンシー → エクスポート に移動します。

2. 2

   スケジュールを作成

   新しいスケジュール済みエクスポートを追加し、ウェブサイト、メトリクス、フォーマット、頻度を選択します。

3. 3

   受信者を設定

   各エクスポートを受け取るべきメールアドレスを追加します。

スケジュールオプション

オプション	選択肢
頻度	週単位、月単位
フォーマット	CSV、JSON
メトリクス	訪問者、ページビュー、バウンス率、その他の分析メトリクス
受信者	メールアドレス

スケジュールの管理

同じ エージェンシー → エクスポート タブで、すべてのアクティブスケジュールを確認し、いつでも一時停止、編集、削除できます。

APIを介して収益を読む

Pro プラン

REST API (プロプラン以上) を使用すると、プログラム的に数字をあなた自身のスクリプト、ダッシュボード、BIツールに取得できます。設定 → アカウント → セキュリティとアクセス でキーを作成します – キーは zv_ で始まります。

収益LTVコホート

curl -G "https://api.zenovay.com/api/external/v1/revenue/{websiteId}/ltv" \
  -H "X-API-Key: zv_YOUR_API_KEY" \
  -d range=90d \
  -d granularity=monthly

レスポンスは、コホートごとのライフタイムバリュー数字とサマリーブロックを含むJSONです。 {websiteId} をウェブサイトのIDに置き換えてください。

統計エンドポイント

集計、時系列、内訳メトリクス (収益追跡を設定した場合の収益を含む) については、統計エンドポイントを使用します:

curl -G "https://api.zenovay.com/api/external/v1/stats/aggregate" \
  -H "X-API-Key: zv_YOUR_API_KEY" \
  -d site_id=YOUR_WEBSITE_ID \
  -d period=30d

エンドポイント、パラメータ、レスポンス形状の完全なリストは、REST APIリファレンス およびマシン可読な OpenAPI仕様 にあります。APIレスポンスはJSONとして返されます。

一般的なAPIエラー

エラー	解決策
401 Unauthorized	X-API-Key ヘッダーを確認し、キーが zv_ で始まっていることを確認してください
429 Rate Limited	リクエスト率を低下させてください – レート制限 を参照してください
400 Bad Request	クエリパラメータを確認してください

エクスポートのベストプラクティス

適切なフォーマットを選択

ユースケース	推奨フォーマット
スプレッドシート分析	CSV
システム統合	JSON
プログラム的クエリ	REST API

日付範囲の考慮事項

• 非常に最近のデータがエクスポート前に落ち着くのを少し待ってください。
• エクスポートはプランのデータ保持ウィンドウを尊重します。
• 範囲をビジネスレポート期間に合わせてください。

大規模なデータセット

大規模または継続的なデータニーズの場合:

• 繰り返される手動ダウンロードの代わりに、REST APIまたはスケジュール済みエクスポートを使用してください。
• Scale プランでは、ウェアハウスエクスポートをS3に直接ストリーミングするために接続します (利用可能な場合、BigQueryまたはSnowflake)。S3へのウェアハウスエクスポート を参照してください。

一般的なエクスポート用途

財務報告

• 月次収益調整
• 監査ドキュメント

マーケティング分析

• キャンペーンROI分析
• チャネルパフォーマンス
• アトリビューションモデリング

ビジネスインテリジェンス

エクスポートされたデータを以下のようなツールに統合します:

• Tableau
• Power BI
• Looker
• カスタムダッシュボード

トラブルシューティング

エクスポートが到着しない

ダウンロードリンクが到着しない場合:

• エクスポートメールのスパムフォルダを確認してください。
• スケジュール済みエクスポートの受信者アドレスを確認してください。
• より小さい日付範囲を試してください。

データが不完全に見える

データが欠落しているように見える場合:

• 日付範囲を確認してください。
• 期間がプランの保持ウィンドウ内にあることを確認してください。
• 最近のデータが処理を終えるまで待ってください。

ファイルが正しく開かない

• ファイル拡張子が選択したフォーマットと一致することを確認してください。
• CSV/JSONファイルはUTF-8エンコードされています。
• 別のアプリケーションを試してください。

プライバシーとセキュリティ

エクスポートされたデータ

日次集計エクスポートには分析メトリクスが含まれ、個人識別子は含まれません。生エクスポートにはセッションとデバイスの詳細が含まれます。これらのファイルを機密として扱ってください。

アクセス制御

• エクスポートおよびスケジュール済みエクスポートツールは、Scale プラン以上での所有者または管理者ロールを必要とします。
• スケジュール済みエクスポートの受信者を、データを見るべき人物に制限してください。

データ保持

エクスポートファイルは:

• Zenovayによって長期的に保存されず、メールまたはシステムに配信されます。
• ダウンロード後のセキュリティ保護はあなたの責任です。

次のステップ

• 収益追跡
• ソースごとの収益
• API概要