क्लाउड डिप्लॉयमेंट

अवलोकन

tracio.ai एक पूरी तरह से मैनेज्ड क्लाउड प्लेटफ़ॉर्म है। आपका एप्लिकेशन ब्राउज़र से सिग्नल भेजता है, और क्लाउड एक पहचान परिणाम लौटाता है। प्लेटफ़ॉर्म स्केलिंग, रिडंडेंसी और इंफ्रास्ट्रक्चर प्रबंधन को संभालता है।

शुरुआत करने में कुछ ही मिनट लगते हैं: एक अकाउंट बनाएँ, अपनी public key प्राप्त करें, SDK इंस्टॉल करें, और विज़िटर्स की पहचान करना शुरू करें।

केवल मैनेज्ड क्लाउड। TRACIO सेल्फ-होस्टेड या ऑन-प्रिमाइस डिप्लॉयमेंट नहीं देता — इंस्टॉल करने योग्य कोई सर्वर कंपोनेंट है ही नहीं। आपके नियंत्रण में जो है, वह है डेटा रीजन, जहाँ से आपका ट्रैफ़िक सर्व होता है (नीचे देखें), और अगर आप चाहते हैं कि agent आपके अपने डोमेन से सर्व हो, तो endpoint / scriptUrl विकल्पों के ज़रिए मैनेज्ड एंडपॉइंट के आगे रखा गया एक first-party प्रॉक्सी।

यह कैसे काम करता है

आपका एप्लिकेशन क्लाइंट-साइड JavaScript SDK के माध्यम से क्लाउड से बात करता है। SDK ब्राउज़र में एक agent लोड करता है, सिग्नल एकत्र करता है, और पहचान परिणाम लौटाता है:

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

1. ब्राउज़र SDK agent को लोड करता है और सिग्नल एकत्र करता है।
2. सिग्नल tracio.ai क्लाउड को भेजे जाते हैं।
3. क्लाउड परिणाम लौटाता है: visitorId और bot जानकारी।

अपने स्वयं के सर्वर पर परिणामों पर कार्रवाई करने के लिए, प्रत्येक पहचान को एक हस्ताक्षरित webhook के रूप में प्राप्त करें, या उन्हें Data API से माँग पर पढ़ें।

शुरुआत करना

1. साइन अप करें और अपना dashboard खोलें।
2. अपना डेटा रीजन चुनें (नीचे देखें)।
3. अपनी public key कॉपी करें — इसे क्लाइंट-साइड कोड में शिप करना सुरक्षित है।
4. SDK इंस्टॉल करें और इसे इनिशियलाइज़ करें:

import { Tracio } from "@tracio/sdk"

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

डेटा रीजन

SDK का region विकल्प यह चुनता है कि SDK किस डेटा रीजन से बात करता है। यह "us" या "eu" स्वीकार करता है। जब यह सेट नहीं होता, तो SDK सामान्य https://edge.tracio.ai एंडपॉइंट का उपयोग करता है — किसी रीजन को पिन करने के लिए इसे स्पष्ट रूप से सेट करें।

API कुंजी प्रबंधन

आपके workspace में दो तरह की कुंजियाँ होती हैं, और वे आपस में बदली नहीं जा सकतीं:

• दोनों को dashboard में API Keys के अंतर्गत बनाएँ और प्रबंधित करें। सीक्रेट कुंजियों के लिए Pro प्लान या उससे ऊपर चाहिए।
• सीक्रेट कुंजी बनाते समय एक ही बार दिखाई जाती है — हमारी तरफ़ केवल एक hash रखा जाता है। खो जाने पर उसे वापस नहीं पाया जाता, बल्कि रोटेट किया जाता है।
• सीक्रेट कुंजी रोटेट करने पर पिछली कुंजी 7 दिन तक काम करती रहती है, ताकि आप बिना डाउनटाइम के डिप्लॉय कर सकें। पब्लिक कुंजियाँ रोटेट नहीं होतीं: वे गोपनीय नहीं हैं और डिज़ाइन के अनुसार आपके पेज के सोर्स में दिखती हैं।

परिणामों को सर्वर-साइड लेने के दो तरीके हैं, और वे साथ में अच्छे चलते हैं:

• एक webhook कॉन्फ़िगर करें — प्रत्येक पहचान आपके एंडपॉइंट पर पहुँचाई जाती है, जो X-Tracio-Signature के साथ हस्ताक्षरित होती है।
• अपनी सीक्रेट कुंजी के साथ Data API कॉल करें और किसी विज़िटर का इतिहास, अलग-अलग सेशन या velocity काउंटर माँग पर पढ़ें।

Webhooks

आप क्लाउड से पहचान इवेंट अपने सर्वर पर पाने के लिए webhooks कॉन्फ़िगर कर सकते हैं। webhooks Pro प्लान और उससे ऊपर उपलब्ध हैं — सेटअप, payload और सिग्नेचर सत्यापन के विवरण के लिए Webhooks देखें।