Skip to main content
تتيح أحداث الخادم لخادمك الإبلاغ عن التحويلات مباشرة إلى واجهة تتبّع Scanova باستخدام مفتاح API. وعلى خلاف أحداث المتصفح، لا تستطيع أدوات حجب الإعلانات إيقاف أحداث الخادم، ولا تتأثر بقيود المتصفح، وتنقل بيانات النسبة الحساسة بأمان.

متى تستخدم أحداث الخادم

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

كيف تعمل النسبة على الخادم

القيمة scan_session_id هي الرابط بين مسح رمز QR وحدث الخادم. وهذا هو المسار المعتاد:
ما يقع على عاتقك: تمرير scan_session_id من المتصفح إلى خادمك. والطرق الشائعة لذلك:
  • إدراجها في حقل نموذج مخفي
  • إرسالها في جسم طلب الواجهة من JavaScript في الواجهة الأمامية
  • حفظها في جلسة الزائر على خادمك (بقراءتها من معامل الرابط عند تحميل الصفحة)

المتطلبات

  • موقع تتبع مُنشأ في التحليلات ← تتبع التحويلات
  • مفتاح API خاص بالموقع (يُنشأ من تبويب إعداد التتبع ← تتبع عبر API في الموقع)
  • قدرة خادمك على إرسال طلبات POST عبر HTTPS
  • طريقة لاستقبال scan_session_id من متصفح الزائر

متطلبات الأمان

  • لا تكشف مفتاح API أبدًا في كود الواجهة الأمامية أو في JavaScript على جهة العميل
  • احفظ المفتاح في متغير بيئة أو في مدير أسرار
  • بدّل المفاتيح دوريًا من لوحة التحكم

الخطوات التالية

إنشاء مفتاح API

أنشئ من لوحة التحكم مفتاح API خاصًا بموقع واحد.

إرسال الأحداث

أمثلة برمجية بلغات cURL وNode.js وPython وPHP.

تكرار الطلبات والإرسال مرة أخرى

كيف تعيد إرسال الطلبات الفاشلة بأمان.

التحقق من الوصول

تأكد من وصول أحداثك.