メインコンテンツへスキップ
Zenovaydocs
3分で読めます

ファーストパーティプロキシセットアップ

Zenovayトラッキングを独自ドメイン経由で提供して、ブラウザのトラッキング保護と広告ブロッカーをバイパスします。

ファーストパーティプロキシはトラッキングを独自ドメイン経由でルーティングするため、ブラウザはそれをファーストパーティと見なし許可します。これにより訪問者数を15～30%増加させることができます。

ファーストパーティプロキシを使用する理由は何ですか？

最新ブラウザはサードパーティトラッキングスクリプトをブロックします。各ブラウザがブロックする内容は次のとおりです。

ブラウザ保護機能api.zenovay.comをブロック？
FirefoxEnhanced Tracking Protection (ETP)はい
BraveShieldsはい
EdgeTracking Preventionはい
Opera組み込みブロッカーはい
SafariIntelligent Tracking Prevention (ITP)部分的
Chrome制限あり（今のところ）一部拡張機能

仕組みについて

ファーストパーティプロキシの仕組みTEXT
プロキシなし（ブロック）:
Browser → api.zenovay.com ❌ (サードパーティ = ブラウザによってブロック)

プロキシあり（機能）:
Browser → yourdomain.com/api/_z/* ✅ (ファーストパーティ = 許可)
     ↓
Your Server → api.zenovay.com/fp/* (サーバー間 = 常に機能)

ブラウザが見るのは独自ドメインへのリクエストだけなので、トラッキング保護は適用されません。

同一オリジンの理解（重要！）

これは理解する必要がある最も重要な概念です。

すべての「ファーストパーティ」アプローチが同じではありません。同一ドメインプロキシとカスタムサブドメインの間に重大な違いがあります。

2つのアプローチ

アプローチ例Firefox ETP理由
同一ドメインプロキシ/api/_z/script.js✅ 機能同一オリジン
カスタムサブドメインz.yourdomain.com❌ ブロック異なるオリジン

「同一オリジン」とは何ですか？

ブラウザは「同一オリジン」を次のように定義します：同じプロトコル + 同じドメイン + 同じポート

同一オリジンの例TEXT
https://yourdomain.com (your site)

❌ https://z.yourdomain.com    → 異なるオリジン（異なるサブドメイン）
❌ https://api.yourdomain.com  → 異なるオリジン（異なるサブドメイン）
✅ https://yourdomain.com/api/ → 同一オリジン（単なるパス）

Firefoxでサブドメインが機能しない理由

z.yourdomain.comは「ファーストパーティ」に見えますが、Firefox ETPはそれをサードパーティとして扱います。なぜなら：

  1. オリジンチェック：z.yourdomain.com ≠ yourdomain.com
  2. クロスオリジンリクエスト：ブラウザが別のオリジンにリクエストを行う
  3. ETPがブロック：Firefoxがクロスオリジントラッキングリクエストをブロック

同一ドメインプロキシが機能する理由

/api/_z/script.jsを使用する場合：

  1. オリジンチェック：yourdomain.com/api/_z/ = yourdomain.com ✅
  2. 同一オリジンリクエスト：ブラウザがファーストパーティリクエストを行う
  3. ETPが許可：Firefoxが同一オリジンリクエストを許可
  4. サーバープロキシ：サーバーがZenovayに転送（ブラウザは見えない）

要するに： Firefoxとの互換性が必要な場合は、同一ドメインプロキシアプローチ（Vercel、Netlify、Next.js、Cloudflare Pages、nginx、Apache、Astro）を使用してください。

Cloudflare Workersカスタムサブドメインアプローチ（z.yourdomain.com）はFirefox ETPをバイパスしていません。一部の広告ブロッカーをバイパスするだけです。

プラットフォームを選択してください

ホスティングプラットフォームを選択して、詳細なステップバイステップガイドを開始してください：

Next.js

next.config.jsの書き換えを使用します。Next.jsプロジェクトにおいて最も簡単なオプションです。

Cloudflare Workers

共有ホスティングユーザーに最適です。5分で無料Workerを作成できます。

Cloudflare Pages

既にCloudflare Pagesでホストしている場合はPages Functionsを使用します。

Vercel

vercel.jsonの書き換えまたはEdge Middlewareを使用します。任意のフレームワークで機能します。

Netlify

シンプルな_redirectsファイルまたはnetlify.toml設定。

nginx / Apache

リバースプロキシ設定を使用したセルフホストサーバー。

Astro

SSR有効なAstroプロジェクトのAPIルート。

クイックリファレンス

セットアップ最適なオプションガイド
Next.jsプロジェクトnext.config.jsの書き換えNext.jsガイド
Vercel（任意のフレームワーク）vercel.jsonの書き換えVercelガイド
Netlify_redirectsファイルNetlifyガイド
Cloudflare PagesPages FunctionsCF Pagesガイド
Cloudflare（一般）Cloudflare WorkersCF Workersガイド
セルフホストサーバーnginx/Apacheプロキシnginx/Apacheガイド
AstroAPIルートAstroガイド
共有ホスティング（Hostinger、GoDaddyなど）Cloudflare Workers（無料）CF Workersガイド

共有ホスティング（Hostinger、GoDaddy、Bluehostなど）を使用していますか？

これらのプラットフォームはサーバー側プロキシをサポートしていません。無料のCloudflareアカウントを作成してCloudflare Workersを使用してください。5分で完了し、完璧に機能します。

→ Cloudflare Workersガイド

セットアップ後：スクリプトを更新してください

プロキシをセットアップした後、トラッキングスクリプトを更新します。ドメイン設定でファーストパーティスニペットを見つけることができます：ドメインを開き、サイトをクリックして、一般ページに移動し、トラッキングスクリプトカードのファーストパーティタブを選択します。

プロキシされたスクリプトスニペットを表示するファーストパーティタブが付いたトラッキングスクリプトカード
ドメイン設定のファーストパーティタブには、プロキシされたパスが事前に入力されたスクリプトが表示されます。
前（サードパーティ - ブロックされる可能性があります）HTML
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
後（ファーストパーティ - 常に機能）HTML
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="/api/_z/script.js">
</script>

重要：Cloudflare Workersの制限

Cloudflare Workersアプローチ（z.yourdomain.com）はFirefox ETPをバイパスしません。サブドメインはまだ異なるオリジンだからです。

Firefoxとの互換性を確保するために、代わりに以下の同一ドメインプロキシオプションの1つを使用してください：

機能を確認してください

セットアップ後、プロキシが機能していることを確認してください：

1. ネットワークタブを確認します

  1. DevToolsを開く（F12またはCmd+Option+I）
  2. ネットワークタブに移動します
  3. ページをリロード
  4. /api/_z/script.js（またはカスタムドメインパス）を探す
  5. 独自ドメインから200ステータスを表示する必要があります

2. Firefox（最も厳格）でテストします

Firefoxは最も厳格なトラッキング保護を備えています：

  1. Firefoxを開く
  2. 設定 → プライバシーとセキュリティ → Enhanced Tracking Protection：厳格
  3. ウェブサイトにアクセス
  4. スクリプトが正常に読み込まれることを確認

Firefox厳格モードで機能すれば、どこでも機能します。

APIエンドポイントリファレンス

プロキシは以下のパスを転送する必要があります：

パスZenovay API目的
/api/_z/script.js/fp/script.jsトラッキングスクリプト
/api/_z/e/:code/fp/e/:codeページビューイベント
/api/_z/settings/:code/fp/settings/:codeウェブサイト設定
/api/_z/load/fp/load動的ローダー

トラブルシューティング

問題がありますか？これらの一般的な問題を確認してください：

  • スクリプトが404を返す - プロキシパス設定を確認してください
  • CORSエラー - プロキシがCORSヘッダーを追加していることを確認してください
  • ジオロケーションが間違っている - X-Zenovay-Real-IPヘッダーでクライアントIPを転送してください
  • 依然としてブロックされている - プロキシされたパスを使用していることを確認し、直接URLを使用していないことを確認してください

詳細なトラブルシューティングについては、各プラットフォームの固有のガイドまたは一般的なトラブルシューティングページを参照してください。

次のステップ

このページは役に立ちましたか？