النشر السحابي

نظرة عامة

tracio.ai هي منصة سحابية مُدارة بالكامل. يُرسل تطبيقك الإشارات من المتصفح، وتُعيد السحابة نتيجة التعريف. تتولى المنصة التوسّع والتكرار الاحتياطي وإدارة البنية التحتية.

لا يستغرق البدء سوى دقائق: أنشئ حسابًا، واحصل على مفتاحك العام، وثبّت الـ SDK، وابدأ بتعريف الزوّار.

سحابة مُدارة فقط. لا تقدّم TRACIO نشرًا ذاتي الاستضافة (self-hosted) أو داخل مقرّك (on-premise) — فلا يوجد مكوّن خادم قابل للتثبيت. ما يمكنك التحكّم فيه هو منطقة البيانات التي تُخدَّم منها حركة المرور الخاصة بك (انظر أدناه)، وإذا أردت تقديم الوكيل من نطاقك الخاص، فوسيط من الطرف الأول (first-party proxy) أمام نقطة النهاية المُدارة عبر الخيارين 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",
})

مناطق البيانات

يحدّد خيار region في الـ SDK منطقة البيانات التي تتواصل معها الـ 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) وتفاصيل التحقّق من التوقيع.