커스텀 도메인

일부 네트워크와 브라우저 확장 프로그램은 서드파티 분석 도메인으로의 요청을 차단합니다. 기업 필터, DNS 수준 차단기, 지역 제한, 개인정보 보호 확장 프로그램이 그렇습니다. 자체 서브도메인에서 제공하면 스크립트는 사이트의 퍼스트파티 요청이 되어 그러한 환경에서도 계속 동작합니다.

커스텀 도메인은 metrics.yoursite.com처럼 직접 관리하며 TRACIO 에지를 가리키는 서브도메인입니다. DNS와 인증서가 확인되면 스크립트와 그 번들, 신호 요청이 해당 서브도메인에서 제공됩니다. 프록시를 운영할 필요는 없습니다.

활성화 방식

1. 대시보드에서 서브도메인을 추가하고, 표시된 A 레코드를 DNS 공급자에 생성합니다.
2. TRACIO가 레코드를 인식하고 해당 서브도메인용 TLS 인증서를 자동으로 발급합니다.
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를 설치하고 첫 결과 읽기
• 문제 해결 — 차단된 요청과 쿠키 문제