Bulut Dağıtımı

Genel Bakış

tracio.ai, tümüyle yönetilen bir bulut platformudur. Uygulamanız tarayıcıdan sinyaller gönderir ve bulut bir tanımlama sonucu döndürür. Ölçeklendirme, yedeklilik ve altyapı yönetimini platform üstlenir.

Başlamak yalnızca birkaç dakika sürer: bir hesap oluşturun, açık anahtarınızı alın, SDK'yı kurun ve ziyaretçileri tanımlamaya başlayın.

Yalnızca yönetilen bulut. TRACIO, kendi sunucunuzda barındırılan (self-hosted) veya on-premise bir dağıtım sunmaz — kurulabilir bir sunucu bileşeni yoktur. Denetleyebilecekleriniz: trafiğinizin sunulduğu veri bölgesi (aşağıya bakın) ve ajanın kendi alan adınızdan sunulmasını istiyorsanız, endpoint / scriptUrl seçenekleriyle yönetilen uç noktanın önüne yerleştirilen bir first-party proxy.

Nasıl Çalışır

Uygulamanız buluta istemci tarafındaki JavaScript SDK üzerinden bağlanır. SDK, tarayıcıda bir aracı yükler, sinyalleri toplar ve tanımlama sonucunu döndürür:

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

1. Tarayıcı SDK'sı aracıyı yükler ve sinyalleri toplar.
2. Sinyaller tracio.ai bulutuna gönderilir.
3. Bulut sonucu döndürür: visitorId ve bot bilgisi.

Sonuçları kendi sunucunuzda işlemek için her tanımlamayı imzalı bir webhook olarak alın veya talep üzerine Data API üzerinden okuyun.

Başlangıç

1. Kaydolun ve panonuzu açın.
2. Veri bölgenizi seçin (aşağıya bakın).
3. Açık anahtarınızı kopyalayın — istemci tarafı kodda güvenle yayınlanabilir.
4. SDK'yı kurun ve başlatın:

import { Tracio } from "@tracio/sdk"

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

Veri Bölgeleri

SDK'nın region seçeneği, SDK'nın hangi veri bölgesiyle iletişim kuracağını belirler. "us" veya "eu" değerini kabul eder. Ayarlanmadığında SDK, genel https://edge.tracio.ai uç noktasını kullanır — bir bölgeyi sabitlemek için değeri açıkça ayarlayın.

API Anahtarı Yönetimi

Çalışma alanınız iki tür anahtar kullanır ve bunlar birbirinin yerine geçmez:

• Her ikisini de panodaki API Keys bölümünden oluşturur ve yönetirsiniz. Gizli anahtarlar Pro planı ve üzerini gerektirir.
• Gizli anahtar, oluşturulurken yalnızca bir kez gösterilir — bizim tarafımızda yalnızca bir hash saklanır. Kaybederseniz anahtar kurtarılmaz, döndürülür.
• Gizli bir anahtarı döndürdüğünüzde önceki anahtar 7 gün daha çalışmaya devam eder; böylece kesintisiz dağıtım yapabilirsiniz. Açık anahtarlar döndürülmez: bunlar gizli değildir ve tasarım gereği sayfanızın kaynak kodunda görünür.

Sonuçları sunucu tarafında kullanmanın iki yolu vardır ve bunlar birbirini iyi tamamlar:

• Bir webhook yapılandırın — her tanımlama, X-Tracio-Signature ile imzalanmış olarak uç noktanıza teslim edilir.
• Gizli anahtarınızla Data API çağrısı yaparak bir ziyaretçinin geçmişini, tek tek oturumları veya velocity sayaçlarını talep üzerine okuyun.

Webhook'lar

Buluttan gelen tanımlama olaylarını kendi sunucunuzda almak için webhook'lar yapılandırabilirsiniz. Webhook'lar Pro planı ve üzerinde kullanılabilir — kurulum, yük (payload) ve imza doğrulama ayrıntıları için Webhooks sayfasına bakın.