التكاملFinteza SDKخوادم الويب ASP.NET Coreإرسال الأحداث

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

يسمح 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 رمزًا.

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

Sign up and get:

بالتسجيل فأنت توافق على شروط اتفاقية الخدمة
تهانينا! لقد تم إنشاء حسابك
  • قم بزيارة
    finteza.com
  • إنشاء
    حساب
  • تأكيد
    البريد الإلكتروني
  • تثبيت
    الرمز

لقد أرسلنا رسالة بريد إلكتروني إلى {email}. يرجى العثور عليه وتنشيط حسابك.

بعد ذلك، تحتاج ببساطة إلى تسجيل الدخول وتثبيت رمز التتبع على موقعك. إنه سهل: