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

نظرة عامة

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

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

آلية العمل

يتواصل تطبيقك مع السحابة عبر حزمة JavaScript SDK التي تعمل من جهة العميل. تُحمّل الـ SDK وكيلًا في المتصفح، وتجمع الإشارات، وتُعيد نتيجة التعريف:

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

1. تُحمّل حزمة SDK الخاصة بالمتصفح الوكيل وتجمع الإشارات.
2. تُرسَل الإشارات إلى سحابة tracio.ai.
3. تُعيد السحابة النتيجة: معلومات visitorId وbot.

للتعامل مع النتائج على خادمك الخاص، استقبِل كل عملية تعريف على هيئة webhook موقّع.

البدء

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

• مفتاحك العام مُخصَّص للمتصفح ومن الآمن كشفه في الشيفرة التي تعمل من جهة العميل.
• أدِر المفاتيح وبدّلها من لوحة التحكم الخاصة بك.
• لاستهلاك النتائج من جهة الخادم، هيّئ webhook — تُسلَّم كل عملية تعريف إلى نقطة النهاية الخاصة بك، موقّعة بـ X-Tracio-Signature.

Webhooks

يمكنك تهيئة webhooks لاستقبال الإشعارات من السحابة. انظر Webhooks للاطّلاع على الإعداد وتفاصيل الحمولة (payload).