4分で読めます

Cloudflare Zaraz

統合ステータス — Zenovay によるエンドツーエンドの検証はまだ完了していません。 このガイドは Cloudflare API が正しく構成可能と確認した Zaraz の導入パスを説明していますが、有料 Cloudflare ゾーンでの検証済みライブインストールはまだ完了していません。お試しいただいてうまく動いた (または動かなかった) 場合は、[email protected] までご連絡ください。どの環境でも動作する検証済みの導入パスについては、トラッキングスクリプトリファレンスを参照してください。

サイトのソースコードに手を入れることなく、Cloudflare Zaraz 経由で Zenovay Analytics を導入します。Zaraz はサードパーティスクリプトをエッジへ移すため、アナリティクスの追加によるページ読み込み時間への影響をほぼ完全に抑えられます。

すでに Cloudflare を前段に置いている場合、これが最速の導入経路です。デプロイもテーマ編集も不要で、トラッカーはエッジでサーバーサイド実行されます。

始める前に — Cloudflare プランの前提条件: Zaraz の Custom HTML ツールは execute_unsafe_scripts 権限を必要とし、Cloudflare はゾーンプランごとに段階的に制御しています。お使いのゾーンが Free プランの場合、ダッシュボードでは設定を保存できますが、デプロイは 静かに失敗 します — 「Activity last 24hr」グラフは空のままで、ページ読み込み時にトラッカーが注入されません。数分待っても Zenovay にトラフィックが届かない場合は、ゾーンのプランを確認してください。確実に動くのは Pro プラン以上 (ゾーンあたり月額約 5 ドル) です。Free ゾーンの代替策: Cloudflare Workers のファーストパーティトラッキングを使う、または HTML にスニペットを直接貼り付ける。

Zaraz を使う理由

Zaraz は Cloudflare のタグマネジメント製品です。従来のクライアントサイドのタグマネージャーと違い、Zaraz には次の特長があります。

エッジで実行 — トラッキングスクリプトを差し込むのは Cloudflare のネットワークであり、外部 CDN ではありません。
レンダリングをブロックしない — Core Web Vitals (LCP、INP) への影響がありません。
同意管理に対応 — 組み込みの Consent Manager を使えます (Zenovay の Cookieless モードとも併用可能)。
ビルド工程なし — Custom HTML スニペットを貼り付けて保存するだけです。

Zaraz は無料プランを含むすべての Cloudflare プランに含まれています。

Custom HTML での導入 (推奨)

所要時間: 約 3 分

ステップ 1 — Zaraz を開く

Cloudflare ダッシュボードにログインします
ゾーンが属するアカウントを選択します (Zaraz はゾーン単位ではなくアカウント単位で設定します)
左サイドバーの Tag Management を展開 → Zaraz をクリック

または Zaraz を直接開く — プレースホルダー :account は現在選択中の Cloudflare アカウントに自動的に解決されます。

ステップ 2 — Custom HTML ツールを追加する

Add new tool をクリックします
カタログから Custom Code までスクロールし、Custom HTML を選びます
ツールに名前を付けます: Zenovay Analytics

ステップ 3 — トラッキングスニペットを貼り付ける

HTML フィールドに次を貼り付けます:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

YOUR_TRACKING_CODE を Zenovay ダッシュボードの Settings → General にあるトラッキングコードに置き換えてください。

ステップ 4 — トリガーを設定する

Firing Trigger を Pageview に設定します。

トラッカーが実際に発火するには 2 つの設定が両方とも正しい必要があります — ダッシュボードでは独立して見えますが、実は依存関係があります:

アクションの Firing Trigger が Pageview であること。「All Tracks」ではありません。「All Tracks」は明示的な zaraz.track() JavaScript 呼び出しでのみ発火します。通常のページ読み込みでは発火しません。
「Automatic Pageview Tracking」がゾーンレベルで有効 であること。アクションで Pageview トリガーを選んでいても、このグローバルスイッチがオフだと Zaraz は Pageview イベントを自動発火しません。有効化方法: Zaraz UI を開く → Settings → General Settings → "Other" セクションまでスクロール → "Automatic Pageview Tracking" にチェック → Save をクリック。

どちらか片方でも欠けるとイベントは届きません — アクションの「Activity last 24hr」グラフもゼロのままです。

Firing Trigger: Pageview (必須)
Blocking Triggers: 空のまま
Match: すべてのページ (フィルターなし)

ステップ 5 — 保存して公開する

Save をクリックします
Zaraz は即座に公開します — 別途デプロイ手順はありません

新しいタブでサイトを開きます。1 分以内に最初の訪問者が Zenovay ダッシュボードに表示されるはずです。

Cookieless モード

Zenovay の Cookieless モードは Zaraz でも利用できます。ステップ 3 のスニペットを次に置き換えてください。

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  data-cookieless="true"
  src="https://api.zenovay.com/z.js">
</script>

data-cookieless="true" を指定すると、Zenovay は Cookie も localStorage も書き込みません。これは Zaraz のエッジ実行と自然に組み合わさり、訪問者のブラウザにトラッキング Cookie が一切渡らないため、ePrivacy / TDDDG / FMG 第 45c 条をデフォルトで満たします。

カスタムイベント

Zaraz は任意の Zaraz Action から直接 window.zenovay() を呼び出せます。カスタムイベントを送信するには:

Zaraz で Custom HTML を開く → 2 つ目のツールを追加するか、既存ツールを編集します
次のスニペットパターンを使います:

<script>
  if (window.zenovay) {
    window.zenovay('track', 'signup', { plan: 'pro' });
  }
</script>

トリガーをカスタム Zaraz イベントに設定します (例: サインアップボタンへの Click トリガー)

利用できるすべてのイベントヘルパーは Custom Events を参照してください。

Zaraz の組み込み Consent Manager を利用している場合:

Zenovay ツールを開く → Consent タブ
Consent Purpose を Analytics (または訪問者がオプトインするカテゴリ) に設定します
保存します

訪問者がアナリティクスの同意を拒否した場合、Zaraz は Zenovay ツールを発火しません。同意バナーをまったく出さずに運用したい場合は、上記の Cookieless モード を有効化してください — Zenovay は ePrivacy 第 5(3) 条のもと、同意なしで合法に動作します。

ファーストパーティプロキシ (広告ブロッカー対策)

ファーストパーティプロキシを自分のサブドメイン (例: analytics.yourdomain.com) に設定している場合、Zaraz スニペットの src をプロキシ URL に変更します。

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://analytics.yourdomain.com/z.js">
</script>

Zaraz は既にゾーンのエッジで動作しているため、ファーストパーティプロキシと組み合わせることで広告ブロッカーへの耐性が最大化されます。

SPA 対応 (React、Next.js、Vue、Angular)

Zenovay のトラッキングスクリプトはシングルページアプリケーションでのルート変更を自動検出します。Zaraz の追加トリガーは不要で、デフォルトの Pageview トリガー で十分です。

Zenovay のスクリプトを Zaraz と <head> の両方で読み込まないでください。どちらか一方にしてください。両方だとページビューが重複します。

インストールの確認

Zaraz で公開した後の確認方法として最も簡単なのは:

シークレット / プライベートウィンドウでサイトを開く
デベロッパーツールを開く → Network タブ
zenovay でフィルター
ページを再読み込み

https://api.zenovay.com/z.js (トラッカーバンドル) へのリクエストと、/api/track/... (Pageview イベント) へのリクエストが少なくとも 1 件ずつ表示されるはずです。いずれも HTTP 200 を返している必要があります。

Zenovay ダッシュボードでは、ドメインの Setup → Installation カードが最初のイベントから約 30 秒以内に「Verified」に切り替わります。

トラブルシューティング

症状	対処
トラッカーが読み込まれない	Zaraz ツールが有効になっているか (ツール一覧のトグル)、ゾーンに対して Zaraz 自体が有効になっているかを確認してください。
ダッシュボードにデータが出ない	`data-id` が Settings → General のトラッキングコードと完全に一致しているか確認してください。
ページビューが重複する	HTML から Zenovay 用の直接の `<script>` タグを削除してください。これで Zaraz が唯一の供給源になります。
`window.zenovay is not a function`	Zaraz はデフォルトで Custom HTML を Pageview で発火しますが、カスタムイベントのスニペットはトラッカー登録を待つ必要があります。上の例のように `if (window.zenovay)` でガードしてください。
Content Security Policy エラー	`script-src` と `connect-src` に `https://api.zenovay.com` を追加してください。プロキシ利用時はプロキシドメインも許可します。
Cloudflare Web Analytics と競合	Zenovay と Cloudflare Web Analytics は共存可能ですが、2 つ分の料金を払うことになります。どちらか一方を選んでください。

パフォーマンスへの影響

Zaraz は HTML が訪問者のブラウザに届く前に、Cloudflare エッジでスクリプトを差し込みます。そのためトラッカーはサイトのオリジンの一部として扱われます。サードパーティの DNS 解決なし、追加の TLS ハンドシェイクなし、レンダリングをブロックする外部リクエストもありません。

一般的なサイトでは、<head> に直接挿入した Zenovay トラッカーを Zaraz 経由の注入に切り替えるだけで、クリティカルパスから DNS ルックアップ (約 20-60 ms) と TLS ハンドシェイク (約 80-200 ms) が削減されます。