Skip to main content
POST
Send server-side event
استخدم نقطة الوصول هذه للإبلاغ عن تحويل واحد يقع في الخادم. ولإرسال عدة أحداث في طلب واحد، استخدم POST /server-events/batch. أنشئ قيمة X-API-Key المطلوبة من موقع التتبع لديك: التحليلات ← تتبع التحويلات ← إعداد تتبع التحويلات، ثم إعداد التتبع ← تتبع عبر API في موقعك. راجع إرسال أحداث الخادم للاطلاع على أمثلة برمجية بلغات Node.js وPython وPHP وcURL.

التفويضات

X-API-Key
string
header
مطلوب

Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab

الجسم

application/json
site_id
string
مطلوب

Tracking site ID

Required string length: 1 - 64
event_name
string
مطلوب

Event name (normalized to lowercase/underscore by API)

Required string length: 1 - 64
scan_session_id
string<uuid>

QR scan session id from scnv redirect

event_id
string<uuid>

Unique event ID for deduplication

event_time
string<date-time>

Event occurrence time

user_identifiers
object
conversion_value
object
properties
object

Custom properties. Max serialized size 10KB. Do not include raw email addresses.

Consent signal propagated from browser-side tracking

الخيارات المتاحة:
granted,
denied,
pending

الاستجابة

Event accepted

success
boolean
مطلوب
مثال:

true

event_id
string<uuid>
مطلوب
message
string
مطلوب
مثال:

"Event received"