Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

よくある質問

最終更新 Markdown で表示Agent セットアップ

よくある質問への回答です。探している回答が見つからない場合は、コミュニティページ ↗ または Discord チャンネル ↗ で追加の情報を確認してください。

Zaraz の料金については、Zaraz の料金 ページを参照してください。

一般

Zaraz のセットアップ

Zaraz が動かないのはなぜですか？

Zaraz に問題がある場合、原因は複数考えられます。まず、Zaraz のスクリプトがウェブサイトで正しく読み込まれているかを確認してください。

スクリプトが正しく読み込まれているかを確認するには、次の手順を実行します。

  1. Web ブラウザでウェブサイトを開きます。
  2. ブラウザのデベロッパーツールを開きます。
  3. Console で zaraz と入力します。
  4. zaraz is not defined というエラーメッセージが表示される場合、Zaraz の読み込みに失敗しています。

Zaraz が読み込まれない場合は、次を確認してください。

使っているブラウザ拡張機能が、追加したツールを見つけられません。なぜですか？

Zaraz はツールをサーバー側で読み込みます。そのため、ブラウザで動くコードからは見えません。ツールをサーバー側で動かすと、ウェブサイトのパフォーマンスとプライバシーには有利ですが、通常のブラウザ拡張機能では Zaraz のツールをデバッグできません。

データの不一致が見えます。Zaraz に届いたデータを確認する方法はありますか？

あります。Zaraz Monitoring のメトリクスと デバッグモード を使い、ワークフローのどこで問題が起きたかを調べられます。

Zaraz を Rocket Loader と一緒に使えますか？

Zaraz を使うときは Rocket Loader を無効にすることを推奨します。Zaraz と Rocket Loader は併用できますが、両方を使う必要は通常ありません。Rocket Loader は、Zaraz へのデータの到達を遅らせ、問題の原因になることがあります。

Zaraz は Content Security Policy（CSP）と互換性がありますか？

あります。Zaraz と CSP 設定の互換性については、Cloudflare Zaraz supports CSP ↗ のブログ投稿を参照してください。

Cloudflare は HTML を処理し、既存のスクリプトを削除してから Zaraz を注入しますか？

Cloudflare Zaraz は、ページ上の他のサードパーティスクリプトを削除しません。Zaraz は設定に応じて 自動注入するかしないか を選べます。ただし、Zaraz で読み込む予定の既存スクリプトは削除してください。

Zaraz は Cloudflare のクライアントサイドセキュリティと一緒に使えますか？

使えます。この製品については クライアントサイドセキュリティ（旧 Page Shield）を参照してください。

/wp-admin 配下など、特定のページで Zaraz を読み込まない方法はありますか？

特定のページで Zaraz を読み込まないようにするには、Zaraz を選択的に読み込む を参照してください。

Zaraz の設定を削除するにはどうすればよいですか？

Zaraz の設定をリセットすると、ツール、トリガー、変数を含むすべての設定が消去されます。この操作ですぐに Zaraz が無効になります。最初からやり直したい場合は、いつでも設定をリセットできます。

  1. Cloudflare ダッシュボードで、Settings ページを開きます。

    Settings を開く ↗

  2. Advanced を開きます。

  3. Reset をクリックし、手順に従います。

Zaraz Web API

zaraz.ecommerce() メソッドが undefined エラーを返すのはなぜですか？

E-commerce Web API を使い始める前に、Zaraz Settings ページ で E-commerce tracking を有効にする必要があります。

シングルページアプリケーション（SPA）でページビューを手動でトリガーするにはどうすればよいですか？

Zaraz には シングルページアプリケーション（SPA）サポート が組み込まれており、SPA のページを移動するときに自動でページビューイベントを送信します。高度な用途では、ページビューをトリガーする独自の仕組みを作りたい場合があります。その場合は、zaraz.spaPageview() を呼び出して内部の SPA ページビューイベントを使えます。

ツール

Google Analytics

Google Analytics 4 から Zaraz へ移行したあと、デモグラフィックデータが見えなくなりました。なぜですか？

Google Analytics 4 の Settings オプション で Hide Originating IP Address を有効にしている可能性があります。これは、Zaraz が IP アドレスを Google へ送らないようにします。デモグラフィックデータにアクセスしつつ訪問者の IP を匿名化するには、代わりに Anonymize Originating IP Address を使ってください。

サードパーティツールの Google Analytics で、IP アドレス情報を匿名化する方法が 2 つあります。Privacy と Additional fields です。どちらが正しいですか？

正しい／正しくないという区別はありません。Google Analytics（GA）にある 2 つのオプションは、それぞれ役割が異なります。

Tool Settings の Hide Originating IP Address オプションは、Zaraz が訪問者の IP アドレスを Google へ送らないようにします。そのため GA は、Zaraz の Worker の IP アドレスを訪問者の IP アドレスとして扱います。場所は近いことが多いですが、一致するとは限りません。

Add field オプションにある Anonymize Originating IP Address では、Cloudflare が訪問者の IP アドレスをそのまま Google へ送り、aip パラメータを GA へ渡します。これは GA にデータの匿名化を依頼します。

Google Analytics で Event Reporting（enhanced measurements）を設定したのに、Zaraz が報告するのは Page View、Session Start、First Visit だけなのはなぜですか？

これは不具合ではありません。Zaraz は、通常の GA4 JavaScript スニペットが最初から提供する自動イベントをすべて備えているわけではありません。それらのイベントを捕捉するには、トリガー と アクション を構築する必要があります。Zaraz の仕組みについては 始める を参照してください。

Zaraz で Google Analytics のカスタムディメンションを設定できますか？

できます。ツールへ追加データを送る方法は Additional fields を参照してください。

イベントに User Property を付けるにはどうすればよいですか？

Google Analytics 4 のアクションで Add field > Add custom field... を選び、up. で始まるフィールド名（例: up.name）を入力します。これにより Zaraz は、そのフィールドを Event Property ではなく User Property として送ります。

Zaraz には Google Consent Mode v2 のサポートが組み込まれています。使い方は Google Consent Mode のページ を参照してください。

Facebook Pixel

Zaraz アカウントに Facebook Pixel を設定したのに、データが流れているように見えないのはなぜですか？

Facebook Pixel の仕組み上、Facebook の画面にデータが表示されるまで 15 分から数時間かかることがあります。デバッグモード を使い、Zaraz アカウントからデータが正しく送られているかを確認することもできます。

Conversion ID と Conversion Label の想定形式は何ですか

Conversion ID と Conversion Label は、通常 Google Ads から「gtag スクリプト」として提供されます。次は 1 USD のコンバージョンの例です。

gtag("event", "conversion", {
	send_to: "AW-123456789/AbC-D_efG-h12_34-567",
	value: 1.0,
	currency: "USD",
});

Conversion ID は send_to パラメータの前半で、AW- を除いた部分です。上の例では 123456789 です。Conversion Label は send_to パラメータの後半で、上の例では AbC-D_efG-h12_34-567 です。Zaraz 経由で Google Ads のコンバージョンを設定するときは、実装を依頼された元のスクリプトから情報を取り出してください。

Custom HTML

Google Tag Manager を Zaraz と一緒に使えますか？

Zaraz で Google Tag Manager を読み込むことはできますが、推奨しません。Google Tag Manager 内で設定したツールは Zaraz で最適化できず、Zaraz のプライバシー制御でも制限できません。さらに Google Tag Manager は追加の JavaScript が必要で、ルールがクライアント側で評価されるため、ウェブサイトを遅くすることがあります。現在 Google Tag Manager を使っている場合は、タグを Zaraz のツールとして直接設定し、Zaraz へ置き換えることを推奨します。

HTML スニペットではなく、ネイティブのツール連携を使うべきなのはなぜですか？

ウェブサイトへツールを追加するときは、HTML スニペットより Zaraz のネイティブ連携のほうが常に優れています。HTML スニペットは追加のクライアント側リクエストに依存することが多く、クライアント側のコード実行が必要で、ウェブサイトを遅くすることがあります。ハッキングされる可能性もあり、セキュリティリスクになることもよくあります。さらに、訪問者のプライバシーへの影響を制御するのが非常に難しい場合があります。Zaraz ライブラリに含まれるツールには、こうした問題がありません。高速で、エッジで実行され、サンドボックス化されているため制御と制限ができます。

シングルページアプリ（SPA）のウェブサイトで、Custom HTML を 1 回だけ注入するにはどうすればよいですか？

Zaraz Settings で「Single Page Application support」を有効にしていると、新しい SPA ページが読み込まれるたびに Custom HTML コードが不要に注入されることがあります。その結果、重複が発生します。これを避けるには、Custom HTML アクションを開き、「Add Field」オプションを選びます。次に「Ignore SPA」フィールドを追加し、トグルスイッチを有効にします。これにより、コードがすべての SPA ページビューで発火しなくなり、1 回だけ注入されます。

その他のツール

Zaraz がサポートしていないツールを使いたい場合はどうすればよいですか？

Zaraz のエンジニアリングチームは、新しいツールのサポートを継続的に追加しています。新しい連携の要望は コミュニティスペース ↗ でも出せます。

ウェブサイトの読み込み時にツールを読み込めません。ウェブサイトにコードを追加する必要がありますか？

ドメインを Cloudflare でプロキシしている場合、ウェブサイトにコードを追加する必要はありません。既定では、Zaraz に自動化された Pageview トリガーが含まれます。Google Analytics などの一部のツールは、このトリガーを使う Pageview アクションを自動で追加します。他のツールでは、手動で追加する必要があります。詳細は 始める を参照してください。

ベンダーです。自分のツールを Zaraz に連携するにはどうすればよいですか？

Zaraz チームは、サードパーティベンダーと協力し、Zaraz SDK を使った独自の Zaraz 連携の構築を進めています。新しいツール連携の依頼や SDK への協力については、[email protected] へ連絡してください。

同意

すべてのユーザーに同意モーダルを再表示するにはどうすればよいですか？

その場合は、Zaraz Consent の設定で Consent cookie name 欄の Cookie 名を変更できます。これにより、すべてのユーザーに同意モーダルが再表示されます。サイト上の Zaraz でまだ使っていない Cookie 名を使ってください。

役に立ちましたか？