كل ما يجب أن يطلبه الموقع وجوجل
كتالوج واحد: استيعاب طرف أول من صفحاتك، واجهة التوأم، روابط طلب جوجل (Search Console والتحليلات وإدارة الوسوم وPageSpeed)، واجهات المتاجر، وويب هوك الدفع — وكلٌ برابط الطلب كما هو.
من موقعك
ثبّت تتبع الطرف الأول في كل صفحة عامة. السكربت يُقدَّم بمفتاحك العام.
https://sitemap.sa/sdk/v1/{public_key}.js
تحميل المتتبع. ضعه كـ <script src="…"> في الموقع.
https://sitemap.sa/ingest/v1/e
أحداث المتصفح. الترويسة X-Sitemap-Key: المفتاح العام. مبالغ الإيراد تُتجاهل بلا توقيع.
https://sitemap.sa/ingest/v1/heartbeat
إبقاء الجلسة حيّة. الجسم: session_id.
استيعاب من الخادم للمشتريات والإيراد الموقّع. الحزم في /sdks.
https://sitemap.sa/ingest/v1/e
نفس عنوان الاستيعاب. أرسل التوقيع والختم الزمني للإيراد الموثوق.
https://sitemap.sa/ingest/v1/events
بديل /ingest/v1/e لإصدارات SDK الأقدم.
واجهة Sitemap.sa
قراءة مؤشرات مركز القيادة لموقع. محدود المعدل.
https://sitemap.sa/api/v1/twin?range=30d
التفويض: Bearer {api_key} أو X-Sitemap-Key.
تنزيل مجموعات البيانات CSV/JSON من لوحة الأعضاء.
https://sitemap.sa/app/export/events.csv
تصدير بعد تسجيل الدخول. بدّل events بـ pages أو sessions أو revenue.
ترسل Sitemap.sa أحداثاً إلى عنوان تسجّله في منصة البيانات.
{your_webhook_url}
نرسل JSON لـ alert.fired وtwin.updated. سجّل العنوان في البيانات والـ API.
قراءة حالة الحوادث المترابطة لموقع. نفس مفتاح واجهة التوأم.
https://sitemap.sa/api/v1/alerts
قائمة الحوادث الأخيرة. التفويض: Bearer {api_key} أو X-Sitemap-Key.
https://sitemap.sa/api/v1/alerts/{id}
حادثة واحدة: النوع والحالة والحدة والأثر.
جوجل
دخول OAuth للأعضاء. اطلب عميل ويب في Google Cloud ثم ضع GOOGLE_CLIENT_ID.
https://sitemap.sa/auth/google/callback
عنوان العودة المصرّح به للصقه في Google Cloud.
https://oauth2.googleapis.com/token
تبديل رمز جوجل.
اطلب واجهة Search Console، وثبّت الموقع، ثم اربط الفهرسة والاستعلامات.
https://search.google.com/search-console
إضافة/توثيق موقعك (وسم HTML من gsc_verification في الإدارة).
https://searchconsole.googleapis.com/webmasters/v3/sites
سرد المواقع الموثّقة. نطاق OAuth: webmasters.readonly
https://searchconsole.googleapis.com/webmasters/v3/sites/{siteUrl}/searchAnalytics/query
تحليلات البحث (استعلامات، صفحات، نقرات، ظهور).
https://searchconsole.googleapis.com/webmasters/v3/sites/{siteUrl}/sitemaps
سرد الخرائط المقدَّمة. قدّم: https://sitemap.sa/sitemap.xml
https://console.cloud.google.com/apis/library/searchconsole.googleapis.com
تفعيل واجهة Search Console في مشروع Google Cloud.
وسم اختياري مزدوج. Sitemap.sa طرف أول؛ GA يُحقن فقط إن وُضع ga_id في الإدارة.
https://analytics.google.com/analytics/web/
أنشئ خاصية GA4 وانسخ معرّف القياس (G-…).
https://analyticsdata.googleapis.com/v1beta/properties/{propertyId}:runReport
طلب تقرير واجهة بيانات GA4.
https://www.googletagmanager.com/gtag/js?id=G-QL67RL17KM
وسم المتصفح الذي تحمّله المنصة عند حفظ ga_id.
https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com
تفعيل واجهة بيانات Google Analytics.
مقتطف الحاوية يُطبع في الموقع فقط عند ضبط gtm_id.
https://www.googletagmanager.com/gtm.js?id=GTM-NBJB8DWC
عنوان سكربت الحاوية في تخطيط الموقع.
https://www.googleapis.com/tagmanager/v2/accounts
واجهة إدارة الوسوم — سرد الحسابات بعد OAuth.
روابط طلب أداء المختبر والميدان لموقع العميل.
https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url={homepage}&strategy=mobile
واجهة PageSpeed Insights. فعّلها في Cloud Console.
https://chromeuxreport.googleapis.com/v1/records:queryRecord
تقرير تجربة كروم (بيانات الميدان لـ Core Web Vitals).
إشعار جوجل بتحديث عنوان بعد إصلاح موافق عليه (أنواع مواقع محددة).
https://indexing.googleapis.com/v3/urlNotifications:publish
نشر URL_UPDATED / URL_DELETED. يتطلب حساب خدمة.
الإدارة تحفظ مفاتيح الموقع والسر. الويدجت يظهر فقط عند وجود المفاتيح.
https://www.google.com/recaptcha/api/siteverify
تحقق الخادم. المنصة ترسل إلى هنا عند إرسال نموذج محمي.
متاجر التجارة
اربط المتجر من التكاملات. روابط طلب واجهة الإدارة الرسمية أدناه.
https://{shop}.myshopify.com/admin/oauth/authorize
طلب وصول واجهة الإدارة (المنتجات والطلبات).
https://{shop}.myshopify.com/admin/api/2024-10/products.json
سرد المنتجات. الترويسة X-Shopify-Access-Token.
https://{shop}.myshopify.com/admin/api/2024-10/orders.json
سرد الطلبات لمزامنة الإيراد.
مفاتيح REST من ووكومرس ← الإعدادات ← متقدم ← REST API.
{store}/wp-json/wc/v3/products
سرد المنتجات. مصادقة consumer_key / consumer_secret.
{store}/wp-json/wc/v3/orders
سرد الطلبات.
اطلب تطبيق سلة ورمز Admin API ثم الصق رابط المتجر والرمز في التكاملات.
https://api.salla.dev/admin/v2/orders
طلبات سلة.
https://salla.partners/
طلب بيانات تطبيق الشريك.
اطلب رمز واجهة زد من بوابة الشركاء.
https://api.zid.sa/v1/managers/store/orders
طلبات زد.
https://web.zid.sa/home
لوحة التاجر لإنشاء بيانات الواجهة.
موصل التجارة الوطني. رابط المتجر ورمز الوصول في التكاملات.
https://ecommerce.sa
طلب وصول المتجر / تسجيل الشريك.
الدفع
جلسة دفع عند وجود STRIPE_SECRET. وإلا فاتورة تجريبية موسومة.
https://sitemap.sa/webhooks/stripe
نقطة ويب هوك سترايب. أضف هذا العنوان في لوحة سترايب.
فاتورة رسمية عند وجود MOYASAR_SECRET.
التنبيهات والدردشة
عناوين ويب هوك واردة تنشئها في سلاك/Teams ثم تلصقها في التنبيهات.
https://hooks.slack.com/services/{T}/{B}/{token}
ويب هوك سلاك الوارد. اطلبه من api.slack.com/apps.