عن المشروع

Aptabase هو منصة تحليلات مفتوحة المصدر تراعي الخصوصية. يتيح هذا SDK خاصاً بـ Unreal Engine للمطورين دمج تحليلات Aptabase في مشاريعهم على منصات الجوال وسطح المكتب والويب. يمكن التثبيت عبر Unreal Marketplace أو بنسخ المستودع إلى مجلد `Plugins` في المشروع (يتطلب مشروعاً يعتمد على C++). بعد تفعيل الإضافة عبر قائمة Edit → Plugins في المحرر، أضف `ProviderModuleName=Aptabase` تحت قسم `[Analytics]` في ملف `Config/DefaultEngine.ini`. إذا كان مُوفِّر تحليلات آخر مُعَرَّفاً بالفعل، يجب استبداله أو استخدامه جنباً إلى جنب عبر Multicast Analytics Provider Plugin. يتطلب إعداد المشروع مفتاح تطبيق (App Key) من لوحة تحكم Aptabase، يُدخل في Project Settings → Analytics → Aptabase. يتم تحديد المضيف تلقائياً بناءً على المفتاح؛ أما عمليات النشر المستضافة ذاتياً فتسمح بوضع عنوان URL مخصص. يمكن توقيت إرسال الأحداث بشكل منفصل لوضعي Release وDebug. يتم دعم تتبع الأحداث عبر Blueprints وC++. يُنصح مستخدمو Blueprint باستخدام Blueprint Analytics Plugin للتتبع المحايد تجاه المُوفّر. تشمل العقد المتاحة `Record Event with Attributes` للأحداث المخصصة و`Record Currency Purchase` لتتبع المشتريات. في لغة C++، تُوصى استخدام طرق وحدة `FAnalytics` مثل `RecordEvent` و`RecordCurrencyPurchase`. يثري SDK الأحداث تلقائياً بمعلومات نظام التشغيل وإصدار التطبيق. لا يتم تتبع أي أحداث تلقائياً — يجب على المطورين تسجيلها يدوياً. تعمل استدعاءات التسجيل بشكل غير متزامن في الخلفية. تدعم الخصائص المخصصة السلاسل والأرقام فقط. فيما يخص التقديم إلى متجر Apple App Store، تقدم Aptabase إرشادات حول ملء نموذج خصوصية التطبيق.