カスタムドメイン

一部のネットワークやブラウザ拡張機能は、サードパーティの分析ドメインへのリクエストをブロックします。企業のフィルター、DNSレベルのブロッカー、地域による制限、プライバシー拡張機能などです。自社サブドメインから配信すれば、スクリプトはサイト上のファーストパーティリクエストとなり、そうした環境でも動作し続けます。

カスタムドメインとは、metrics.yoursite.comのようにお客様が管理する、TRACIOのエッジに向けたサブドメインです。DNSと証明書が確認されると、スクリプト、そのバンドル、シグナルのリクエストがそのサブドメインから配信されます。プロキシを運用する必要はありません。

有効化の流れ

1. ダッシュボードでサブドメインを追加し、表示されたAレコードをDNSプロバイダーで作成します。
2. TRACIOがレコードを検知し、そのサブドメイン用のTLS証明書を自動的に発行します。
3. お客様の公開鍵でそのサブドメインからスクリプトを読み込むページへの最初の訪問が、ホストを有効化します。

ダッシュボードにはこの3つの段階（Aレコード、証明書、お客様の鍵での最初の訪問）が表示され、自動的に再チェックされます。Check nowを押すと再チェックを強制できます。

カスタムドメインの設定

1. Get Startedを開き、Install the SDK and send your first eventを展開します。その最初の項目でスクリプトの配信元を尋ねられるので、Your own subdomainを選択してサブドメインを入力します。同じウィザードはSettings → Custom Hostsにもあります。
2. ダッシュボードに表示されたAレコードをDNSプロバイダーで追加します。ドメインをCloudflareで管理している場合は、プロキシをオフ（グレーの雲、DNS only）にして追加してください。プロキシがオンだと、Cloudflareがアドレスを置き換えるため、リクエストはTRACIOに届きません。
3. DNSと証明書の段階が確認されるまで待ちます。伝播と発行には数分から数時間かかります。
4. スニペットをページに設置します。お客様の鍵での最初の訪問がホストを有効化します。

すでに共有ドメイン経由でサイトを計測している場合は、DNSと証明書の段階が確認されてからタグを切り替えてください。それまでは、新しいサブドメインからスクリプトは読み込まれません。

スニペット

スクリプトタグ:

<script src="https://metrics.yoursite.com/s.js?k=PUBLIC_KEY" async></script>

npmパッケージ: サブドメインをendpointとして渡します。SDKはそこからスクリプトを読み込み、そこへシグナルを送信します。endpointを設定すると、regionオプションは無視されます。この用途にscriptUrlは使わないでください。scriptUrlは公開鍵を含むスクリプトURL全体を置き換えます。

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "PUBLIC_KEY",
  endpoint: "https://metrics.yoursite.com",
})

フレームワーク向けパッケージも同じendpointオプションを受け付けます。SDKの各ページを参照してください。

制限事項

• metrics.yoursite.comのように、お客様が管理し、他に何も配信していないサブドメインを使用してください。
• CloudflareではレコードをDNS only（グレーの雲）にする必要があります。
• 別のワークスペースで有効になっているサブドメインは追加できません。

次のステップ

• クイックスタート — SDKをインストールして最初の結果を読み取る
• トラブルシューティング — ブロックされたリクエストとCookieの問題