2分で読めます

ダウンロードトラッキング

訪問者がどのファイルをダウンロードしているか、どのデバイス・国からダウンロードしているか、そしてダウンロード数が時系列でどう推移しているかを確認できます。コード変更なしで、すべて自動的に収集されます。

概要

Zenovay は、訪問者がサイト上のダウンロード可能なファイルのリンクをクリックするたびに、download_start イベントを自動的に記録します。データはダッシュボードの アプリ → ウェブサイトを開く → 「ダウンロード」タブ に表示されます。

ダウンロードタブは、認証済みのウェブサイトオーナーおよびチームメンバーのみに表示されます。ファイルの URL や名前が内部パスを公開してしまう可能性があるため、公開共有ダッシュボードでは意図的に非表示にしています。

ダウンロードトラッキングは Zenovay トラッキングスクリプトの一部です。自動キャプチャイベントと連携して動作し、別途インストールや設定は不要です。

自動的にキャプチャされる内容

訪問者が以下のいずれかをクリックすると、download_start イベントが発火します:

パスが認識されたファイル拡張子で終わる <a> リンク: pdf, zip, exe, dmg, pkg, msi, apk, csv, xls, xlsx, doc, docx, ppt, pptx, mp4, mp3, wav, mov, avi, rar, 7z, tar, gz, tgz, iso, deb, rpm
ファイル拡張子に関わらず、任意の <a download> リンク
JavaScript で生成された blob ダウンロード（例：動的に生成された PDF）

Zenovay は navigator.sendBeacon を使用するため、クリックによってファイルダウンロードが開始されブラウザがページから離れる場合でも、イベントは確実に送信されます。

コードの変更は不要です。 Zenovay トラッキングスクリプトをインストールするだけで、ダウンロードトラッキングはすぐに機能します。

ファイルサイズ

同一オリジンのダウンロード（サイトと同じドメインから配信されるファイル）の場合、Zenovay はファイルサイズを自動的にキャプチャします。
クロスオリジンのダウンロード（異なるドメインのファイル）の場合、ファイルサーバーの CORS ポリシーで許可されている場合のみファイルサイズを取得できます。許可されていない場合、サイズの列は 「—」 と表示されます。

ダウンロード完了タイミング

完了タイミングは、アプリ内またはプログラムによる（fetch + blob）ダウンロードでのみ利用可能です。たとえば、JavaScript で PDF を取得して Blob ダウンロードを開始するボタンが該当します。

通常のブラウザ管理型のファイルリンク（標準的なファイルへの <a href>）では、ブラウザが転送全体を管理します。ウェブプラットフォームにはダウンロードにかかる時間を計測する API が存在しないため、これらのダウンロードでは「平均時間」列に 「—」 が表示されます。これは Zenovay の制限ではなく、ブラウザの本質的な制約です。

ファイルの完了タイミングが必要な場合は、fetch() と URL.createObjectURL() を使用してダウンロードを実装してください。その場合、Zenovay は転送全体を計測できます。

個別リンクのオプトアウト

アンカー要素に data-download 属性を追加すると、そのリンクをダウンロードトラッキングから完全に除外できます:

リンクをダウンロードトラッキングから除外するHTML

<!-- このリンクはダウンロードとして追跡されません -->
<a href="/internal-report.pdf" data-download>レポートをダウンロード</a>

クロスブラウザ対応

ダウンロードトラッキングは Chrome、Firefox、Safari で動作します。navigator.sendBeacon を使用してイベントを送信するため、ダウンロードナビゲーションがページをアンロードする場合でも確実に配信されます。

プライバシー

ダウンロードトラッキングは既存の Zenovay トラッカーを使用します。新しい Cookie や localStorage エントリは追加されず、クッキーレスモードでも動作します。Global Privacy Control または Do Not Track シグナルを送信する訪問者は追跡されないため、その訪問者のダウンロードはダウンロードタブに表示されません。これは仕様です。

プランの制限

プラン	1 ウェブサイトあたりの 1 日のダウンロードイベント数
Free	100（ソフトキャップ）
Pro	無制限
Scale	無制限
Enterprise	無制限

Free プランの上限はソフトキャップです。1 日の上限を超えたイベントは、その日のダウンロードタブに表示される合計数にカウントされません。

ダウンロードデータの確認

アプリでウェブサイトを開き、ダウンロード タブに移動します。このタブには以下が含まれます:

パネル	表示内容
上位ダウンロードファイル	ファイル URL、ダウンロード数、ユニークダウンロード数、サイズ、平均完了時間
時系列ダウンロード数	選択した期間のダウンロード量の推移
デバイス別	デバイスタイプ別のダウンロード内訳
国別	訪問者の国別ダウンロード内訳
ソース別	トラフィックソース別ダウンロード内訳
完了サマリー	完了タイミングが記録されたダウンロードとブラウザ管理型ダウンロードの比率

期間

7 日間 と 30 日間 はすべてのプランで利用可能です。
90 日間 は Scale または Enterprise プランが必要です。