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

يسمح SDK بإرسال أي أحداث من جزء الخادم من موقعك الإلكتروني إلى Finteza، بما في ذلك بيانات إجراء المستخدم وحالة قاعدة البيانات ومؤشرات الأداء وما إلى ذلك.

قم بالاتصال بطريقة ITracker.SendEvent. لهذا الغرض، احصل على تنفيذ ITracker باستخدام حقن التبعية. على سبيل المثال ، يمكن القيام بذلك باستخدام الحقن التالي في المُنشئ:

class SomeClass
{
    public SomeClass(ITracker tracker)
    {
        tracker.SendEvent("{EVENT}", "{REFERER}");
    }
}

باستخدام طريقة SendEvent يمكنك تسجيل الأحداث وتمرير معلومات إضافية كمعلمات، على سبيل المثال، نوع السلعة المشتراة، السعر، العملة، إلخ. المعلمات التالية مدعومة:

المعلمة	النوع	الوصف
الاسم *	السلسلة	اسم الحدث. الحد الأقصى للطول هو 128 رمزًا.
المُحيل*	السلسلة	عنوان الصفحة التي تم إرسال الحدث منها. جميع الأحداث مرتبطة بالعدادات (المواقع الإلكترونية) على جانب Finteza باستخدام websiteId. يتأكد النظام من وصول مضيف حدث من المضيف الذي يتوافق مع مضيف العداد (المحدد في إعدادات الموقع الإلكتروني للوحة). هذا يمنع تضخيم حركة المرور.
المُحيل الخلفي	السلسلة	عنوان صفحة الويب التي كان يوجد فيها الزائر قبل تنفيذ إجراء متتبع.
IP المستخدم	السلسلة	عنوان IP للزائر الذي قام بإجراء متتبع.
وكيل المستخدم	السلسلة	وكيل المستخدم للزائر الذي قام بإجراء متتبع.
الوحدة	السلسلة	وحدات قياس المعلمات، على سبيل المثال، الدولار الأمريكي، العناصر، إلخ. الحد الأقصى للطول هو 32 حرف.
القيمة	السلسلة	قيمة المعلمة. الحد الأقصى للطول هو 64 رمزًا.

* — المعلمات المطلوبة.

مثال:

tracker.SendEvent("Server Track Purchase", "https://www.mysite.com", "USD", "100");

ليست هناك حاجة لتحديد معلمة المُحيل في كل مرة يتم فيها إرسال الحدث، إذا قمت بتعيين قيمته الافتراضية أثناء التهيئة. أثناء الاتصال بـ AddFintezaAnalytics حدد المعلمة الإضافية DefaultReferer:

services.AddFintezaAnalytics(options =>
{
options.WebsiteId = "{WEBSITE_ID}";
options.DefaultReferer = "{DEFAULT_REFERER}";
...
});

ملاحظة: إذا كنت لا تستخدم defaultReferer، حدد مُحيل أثناء كل اتصال بـ SendEvent. خلاف ذلك، لن يتم إرسال الأحداث.

نوع آخر متاح للوظيفة ITracker.SendEvent:

tracker.SendEvent({CONTEXT}, "{EVENT}");

بدلًا من المواصفات الصريحة لـ المُحيل، المُحيل الخلفي، IP المستخدم، وكيل المستخدم، هنا يتم تحديد سياق تنفيذ الطلب ، والذي سيتم من خلاله استلام المعلمات المحددة وإرسالها إلى Finteza.

المعلمة	النوع	الوصف
httpContext *	Microsoft.AspNetCore.Http.HttpContext	سياق تنفيذ طلب HTTP الحالي، والذي يتم من خلاله تكوين المٌحيل، المُحيل الخلفي، IP المستخدم و وكيل المستخدم للمعلمات تلقائيًا.
الاسم *	السلسلة	اسم الحدث. الحد الأقصى للطول هو 128 رمزًا.
الوحدة	السلسلة	وحدات قياس المعلمات، على سبيل المثال، الدولار الأمريكي، العناصر، إلخ. الحد الأقصى للطول هو 32 حرف.
القيمة	السلسلة	قيمة المعلمة. الحد الأقصى للطول هو 64 رمزًا.

* — المعلمات المطلوبة.