ダウンロード追跡は、訪問者がサイトからファイルをダウンロードするたびに記録します。トラッキングスクリプトはインストールされると同時にこれらのイベントを自動的に取得します — コードの変更は不要です（すべてのプランで利用可能）。データを表示するには、ウェブサイトのダッシュボードを開いて Downloads タブを選択してください。このタブは Download Analytics 機能の一部で、Pro 以上のプランで利用できます。
ダウンロードとしてカウントされるもの
Zenovay は訪問者が次のいずれかを実行したときにダウンロードを記録します:
- ダウンロード可能なファイルへのリンク — URL パスが認識されている拡張子で終わる
<a href>: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>リンク — ファイルの拡張子に関係なく、アンカーにdownload属性がある場合、Zenovay はファイルダウンロードとして扱います。- JavaScript で生成された (blob) ダウンロード — コードが一時的な
blob:URL を作成して保存ダイアログを起動する場合。
確認場所
ウェブサイトのダッシュボードを開き、Downloads タブを選択します（サイドバーの Audience グループの下）。このビューは Download Analytics の一部で、Pro、Scale、Enterprise プランで利用可能です。このタブはサインイン済みのオーナーとチームメンバーにのみ表示されます — 公開または共有ダッシュボードには表示されません。ファイルのパスや名前が、外部に公開したくない内部構造を露出する可能性があるためです。
タブには以下が表示されます:
- ダウンロード数上位のファイル — ダウンロード数でランク付けされたテーブル。ユニークダウンローダー数、ファイルサイズ (利用可能な場合)、平均完了時間 (測定可能な場合) を含みます。
- 時系列でのダウンロード — 選択した期間のダウンロード数を示す面グラフ。
- 内訳 — デバイスの種類、国、トラフィックソース別のダウンロード内訳。
- ダウンロード完了 — 開始したダウンロードに対して完了したダウンロードの数 (タイミングが測定可能な blob/fetch ダウンロードに適用され、ブラウザ管理のリンク (サイズを報告するもの) にも適用されます)。
日付範囲とデータ保持
| プラン | 分析データ保持期間 |
|---|---|
| 無料 | 1 年 |
| Pro | 2 年 |
| Scale | 4 年 |
| Enterprise | カスタム |
ファイルサイズと完了時間
ファイルサイズは同一オリジンのダウンロード (自分のドメインから配信されるファイル) で表示されます。クロスオリジンのファイル (CDN やサードパーティドメインでホストされるファイル) の場合、ファイルサーバーが許容的な CORS ヘッダーを返すときのみサイズが利用可能で、それ以外の場合は列に 「—」 が表示されます。
完了時間は、ブラウザーが転送を JavaScript に委ねる blob・fetch ダウンロードでのみ測定可能で、Zenovay は転送の完了を観察できます。通常の <a href> ファイルリンクの場合、ブラウザーが独自のダウンロードマネージャーで転送をすべて管理するため、完了シグナルを取得する方法がありません — これらの行の完了時間列には 「—」 が表示されます。これは追跡の不具合ではなく、想定された動作です。
特定のリンクを除外する方法
ダウンロード条件に一致するリンクがあっても追跡したくない場合は、アンカーに data-download 属性を追加します:
<a href="/files/report.pdf" data-download>レポートをダウンロード (追跡なし)</a>
Zenovay は data-download 属性を持つすべての <a> 要素の追跡を抑制します。
ブラウザー互換性
ダウンロード追跡は Chrome、Firefox、Safari で動作します。
プライバシー
ダウンロード追跡は、すでにページに配置されている同じトラッカーを使用します — 新しい Cookie は追加されず、localStorage も使用しません。Cookie なしモードでも動作し、その場合は永続的なストレージの代わりにウィンドウスコープのメモリ内識別子が使用されます。Global Privacy Control または Do Not Track のシグナルを送る訪問者は設計上追跡されないため、タブには表示されません。
テスト方法
- ダウンロード可能なファイルリンクを含むサイトのページを開きます。
- リンクをクリックしてダウンロードを開始します。
app.zenovay.comにサインインし、そのウェブサイトを開いて Downloads タブを選択します。
ダウンロードは数秒以内に表示されるはずです。表示されない場合は、トラッキングスクリプトがインストールされているか、リンクが上記の拡張子または属性のいずれかに一致しているかを確認してください。