Deployment Cloud

Ikhtisar

tracio.ai adalah platform cloud yang dikelola sepenuhnya. Aplikasi Anda mengirimkan sinyal dari browser, dan cloud mengembalikan hasil identifikasi. Platform ini menangani penskalaan, redundansi, dan pengelolaan infrastruktur.

Memulai hanya butuh beberapa menit: buat akun, dapatkan public key, pasang SDK, dan mulai mengidentifikasi pengunjung.

Hanya managed cloud. TRACIO tidak menyediakan deployment self-hosted maupun on-premise — tidak ada komponen server yang bisa dipasang. Yang bisa Anda kendalikan adalah region data tempat trafik Anda dilayani (lihat di bawah) dan, jika Anda ingin agent disajikan dari domain Anda sendiri, sebuah proxy first-party di depan endpoint terkelola melalui opsi endpoint / scriptUrl.

Cara Kerjanya

Aplikasi Anda berkomunikasi dengan cloud melalui JavaScript SDK sisi klien. SDK memuat agent di browser, mengumpulkan sinyal, dan mengembalikan hasil identifikasi:

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. SDK browser memuat agent dan mengumpulkan sinyal.
2. Sinyal dikirim ke cloud tracio.ai.
3. Cloud mengembalikan hasilnya: informasi visitorId dan bot.

Untuk menindaklanjuti hasil di server Anda sendiri, terimalah setiap identifikasi sebagai webhook yang ditandatangani, atau bacalah sesuai kebutuhan melalui Data API.

Memulai

1. Daftar dan buka dashboard Anda.
2. Pilih region data Anda (lihat di bawah).
3. Salin public key Anda — aman untuk disertakan dalam kode sisi klien.
4. Pasang SDK dan inisialisasikan:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

Region Data

Opsi region pada SDK menentukan region data mana yang diajak berkomunikasi oleh SDK. Opsi ini menerima "us" atau "eu". Jika tidak disetel, SDK menggunakan endpoint generik https://edge.tracio.ai — setel secara eksplisit untuk mengunci sebuah region.

Pengelolaan API Key

Workspace Anda memakai dua jenis key, dan keduanya tidak saling menggantikan:

• Keduanya dibuat dan dikelola di dashboard pada bagian API Keys. Key rahasia tersedia mulai paket Pro ke atas.
• Key rahasia ditampilkan sekali saja, saat dibuat — di sisi kami hanya hash yang disimpan. Jika hilang, key tidak dipulihkan, melainkan dirotasi.
• Saat merotasi key rahasia, key sebelumnya tetap berfungsi selama 7 hari sehingga Anda bisa merilis tanpa downtime. Key publik tidak dirotasi: key itu bukan rahasia dan memang sengaja terlihat di kode sumber halaman Anda.

Untuk mengonsumsi hasil di sisi server ada dua opsi, dan keduanya berpadu dengan baik:

• Konfigurasikan sebuah webhook — setiap identifikasi dikirim ke endpoint Anda, ditandatangani dengan X-Tracio-Signature.
• Panggil Data API dengan key rahasia Anda untuk membaca riwayat pengunjung, sesi individual, atau penghitung velocity sesuai kebutuhan.

Webhooks

Anda dapat mengonfigurasi webhook untuk menerima event identifikasi dari cloud di server Anda sendiri. Webhook tersedia mulai paket Pro ke atas — lihat Webhooks untuk detail penyiapan, payload, dan verifikasi tanda tangan.