API

مرجع الواجهة البرمجية

الاستيعاب من طرف أول وواجهة قراءة التوأم. إيراد المتصفح يُتجاهل بلا حدث خادم موقّع. كتالوج الموصلات كاملاً — بما فيها روابط طلب جوجل — في صفحة الموصلات.

الموصلات وروابط جوجل

من موقعك

حزمة جافاسكربت

ثبّت تتبع الطرف الأول في كل صفحة عامة. السكربت يُقدَّم بمفتاحك العام.

GET

https://sitemap.sa/sdk/v1/{public_key}.js

تحميل المتتبع. ضعه كـ <script src="…"> في الموقع.

POST

https://sitemap.sa/ingest/v1/e

أحداث المتصفح. الترويسة X-Sitemap-Key: المفتاح العام. مبالغ الإيراد تُتجاهل بلا توقيع.

POST

https://sitemap.sa/ingest/v1/heartbeat

إبقاء الجلسة حيّة. الجسم: session_id.

حزم PHP وNode وبايثون

استيعاب من الخادم للمشتريات والإيراد الموقّع. الحزم في /sdks.

POST

https://sitemap.sa/ingest/v1/e

نفس عنوان الاستيعاب. أرسل التوقيع والختم الزمني للإيراد الموثوق.

POST

https://sitemap.sa/ingest/v1/events

بديل /ingest/v1/e لإصدارات SDK الأقدم.

واجهة Sitemap.sa

واجهة التوأم الرقمي

قراءة مؤشرات مركز القيادة لموقع. محدود المعدل.

GET

https://sitemap.sa/api/v1/twin?range=30d

التفويض: Bearer {api_key} أو X-Sitemap-Key.

التصدير والمستودع

تنزيل مجموعات البيانات CSV/JSON من لوحة الأعضاء.

GET

https://sitemap.sa/app/export/events.csv

تصدير بعد تسجيل الدخول. بدّل events بـ pages أو sessions أو revenue.

ويب هوك صادر

ترسل Sitemap.sa أحداثاً إلى عنوان تسجّله في منصة البيانات.

POST

{your_webhook_url}

نرسل JSON لـ alert.fired وtwin.updated. سجّل العنوان في البيانات والـ API.

واجهة حالة التنبيه

قراءة حالة الحوادث المترابطة لموقع. نفس مفتاح واجهة التوأم.

GET

https://sitemap.sa/api/v1/alerts

قائمة الحوادث الأخيرة. التفويض: Bearer {api_key} أو X-Sitemap-Key.

GET

https://sitemap.sa/api/v1/alerts/{id}

حادثة واحدة: النوع والحالة والحدة والأثر.