Domain Kustom

Sebagian jaringan dan ekstensi browser memblokir permintaan ke domain analitik pihak ketiga: filter korporat, pemblokir di tingkat DNS, pembatasan regional, ekstensi privasi. Ketika disajikan dari subdomain Anda sendiri, skrip menjadi permintaan first-party di situs Anda dan tetap bekerja di lingkungan seperti itu.

Domain kustom adalah subdomain yang Anda kendalikan, misalnya metrics.yoursite.com, yang diarahkan ke edge TRACIO. Setelah DNS dan sertifikat terkonfirmasi, skrip, bundle-nya, dan permintaan sinyal disajikan dari subdomain tersebut. Anda tidak perlu menjalankan proxy.

Cara Kerja Aktivasi

1. Anda menambahkan subdomain di dashboard dan membuat A record yang ditampilkannya di penyedia DNS Anda.
2. TRACIO mendeteksi record tersebut dan menerbitkan sertifikat TLS untuk subdomain itu secara otomatis.
3. Kunjungan pertama ke halaman yang memuat skrip dari subdomain tersebut dengan public key Anda akan mengaktifkan host.

Dashboard menampilkan tiga tahap ini — A record, sertifikat, dan kunjungan pertama dengan key Anda — serta memeriksanya ulang secara otomatis. Check now memaksa pemeriksaan ulang.

Menyiapkan Domain Kustom

1. Buka Get Started dan bentangkan Install the SDK and send your first event. Item pertamanya menanyakan dari mana skrip dimuat: pilih Your own subdomain lalu masukkan subdomain Anda. Wizard yang sama tersedia di Settings → Custom Hosts.
2. Tambahkan A record yang ditampilkan di dashboard pada penyedia DNS Anda. Jika domain Anda berada di Cloudflare, tambahkan dengan proxy dimatikan (awan abu-abu, DNS only): bila proxy aktif, Cloudflare mengganti alamatnya dan permintaan tidak sampai ke TRACIO.
3. Tunggu hingga tahap DNS dan Sertifikat terkonfirmasi. Propagasi dan penerbitan memakan waktu dari beberapa menit hingga beberapa jam.
4. Pasang snippet di halaman Anda. Kunjungan pertama dengan key Anda akan mengaktifkan host.

Jika situs Anda sudah melacak melalui domain bersama, ganti tag hanya setelah tahap DNS dan Sertifikat terkonfirmasi: sebelum itu skrip tidak dimuat dari subdomain baru.

Snippet

Tag script:

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

Paket npm: teruskan subdomain sebagai endpoint. SDK memuat skrip dari sana dan mengirim sinyal ke sana. Bila endpoint diset, opsi region diabaikan. Jangan gunakan scriptUrl untuk ini: opsi tersebut mengganti seluruh URL skrip, termasuk public key.

import { Tracio } from "@tracio/sdk"

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

Paket framework menerima opsi endpoint yang sama — lihat halaman SDK.

Batasan

• Gunakan subdomain yang Anda kendalikan, misalnya metrics.yoursite.com, yang tidak melayani hal lain.
• Di Cloudflare, record harus DNS only (awan abu-abu).
• Subdomain yang aktif di workspace lain tidak dapat ditambahkan.

Langkah Berikutnya

• Panduan Cepat — pasang SDK dan baca hasil pertama Anda
• Pemecahan Masalah — permintaan yang diblokir dan masalah cookie