פריסה בענן

סקירה כללית

tracio.ai היא פלטפורמת ענן מנוהלת לחלוטין. האפליקציה שלך שולחת אותות מהדפדפן, והענן מחזיר תוצאת זיהוי. הפלטפורמה מטפלת בהתאמת עומסים, יתירות וניהול תשתית.

תחילת העבודה אורכת דקות: יוצרים חשבון, מקבלים את המפתח הציבורי, מתקינים את ה-SDK ומתחילים לזהות מבקרים.

ענן מנוהל בלבד. TRACIO אינה מספקת פריסה self-hosted או on-premise — אין רכיב שרת שניתן להתקין. מה שכן בשליטתך: אזור הנתונים שממנו נענית התנועה שלך (ראה למטה), ואם ברצונך שהסוכן יוגש מהדומיין שלך — proxy מסוג first-party לפני נקודת הקצה המנוהלת, באמצעות האפשרויות endpoint / scriptUrl.

איך זה עובד

האפליקציה שלך מתקשרת עם הענן דרך ה-JavaScript SDK בצד הלקוח. ה-SDK טוען סוכן בדפדפן, אוסף אותות ומחזיר את תוצאת הזיהוי:

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

1. ה-SDK בדפדפן טוען את הסוכן ואוסף אותות.
2. האותות נשלחים לענן של tracio.ai.
3. הענן מחזיר את התוצאה: visitorId ומידע bot.

כדי לפעול על סמך התוצאות בשרת שלך, קבל כל זיהוי כ-webhook חתום, או קרא אותן לפי דרישה דרך Data API.

תחילת העבודה

1. הירשם ופתח את לוח הבקרה שלך.
2. בחר את אזור הנתונים שלך (ראה למטה).
3. העתק את המפתח הציבורי שלך — בטוח לשלוח אותו בקוד צד לקוח.
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

בסביבת העבודה שלך יש שני סוגי מפתחות, והם אינם מחליפים זה את זה:

• את שני הסוגים יוצרים ומנהלים בלוח הבקרה תחת API Keys. מפתחות סודיים זמינים בתוכנית Pro ומעלה.
• מפתח סודי מוצג פעם אחת בלבד, בעת היצירה — אצלנו נשמר רק hash. אם איבדת אותו, אין שחזור: מבצעים רוטציה.
• ברוטציה של מפתח סודי, הקודם ממשיך לעבוד 7 ימים כדי שתוכל לפרוס בלי השבתה. מפתחות ציבוריים אינם עוברים רוטציה: הם אינם סוד, והם גלויים בקוד המקור של הדף במכוון.

לצריכת תוצאות בצד השרת יש שתי אפשרויות, והן משתלבות היטב:

• הגדר webhook — כל זיהוי נמסר לנקודת הקצה שלך, חתום עם X-Tracio-Signature.
• קרא ל-Data API עם המפתח הסודי שלך כדי לקרוא לפי דרישה את היסטוריית המבקר, סשנים בודדים או מוני velocity.

Webhooks

ניתן להגדיר webhooks כדי לקבל אירועי זיהוי מהענן אל השרת שלך. webhooks זמינים בתוכנית Pro ומעלה — ראה Webhooks לפרטי הגדרה, payload ואימות חתימה.