التحليلات والأحداث

تستقبل Flock الأحداث من لعبتك وتحوّلها إلى تحليلات — التفاعل، والاحتفاظ باللاعبين، وتحقيق الدخل، وغير ذلك.

لوحة التحكم
Unity
Unreal

اطّلع على لوحات التفاعل والاحتفاظ وتحقيق الدخل داخل Flock — وهي مبنيّة على الأحداث والمعاملات التي تبلّغ عنها لعبتك.

لوحات التحليلات — لوحات التفاعل والاحتفاظ وتحقيق الدخل في Flock.

أرسل الأحداث عبر حزمة التطوير أثناء لعب اللاعبين — إتمام مرحلة، أو عملية شراء، أو محطّة في الجلسة. واستدعاءات التسجيل متزامنة ولا تعطّل اللعب أبدًا: فهي تضع الحدث في طابور على القرص، ثم تتولّى حزمة التطوير تجميع الأحداث وتسليمها نيابةً عنك.

FlockClient.Instance.Analytics.LogEvent("level_complete", new Dictionary<string, object>
{
    { "level", 3 },
    { "duration_s", 92 }
});

// Optional: await delivery of everything queued (before a critical moment)
await FlockClient.Instance.Analytics.FlushAsync();

وللجلسات ومشاهدات الشاشات ومعاملات الشراء استدعاءات مخصّصة كذلك (RecordScreenView وRecordTransactionAsync).

عقد Flock | Analytics لا تحتاج إلى طرف Target، وهي آمنة ولا تفعل شيئًا قبل تهيئة حزمة التطوير. وتبدأ الجلسات وتنتهي تلقائيًا حول تسجيل الدخول.

عقدة Flock Log Event مع عقد بناء بيانات وصفية متسلسلة — سجّل حدثًا وابنِ بياناته الوصفية عبر عقد بناء متسلسلة.

Sdk->LogAnalyticsEvent(TEXT("level_complete"),
    FFlockMetadata().Add(TEXT("level"), 3).Add(TEXT("flawless"), true));

ويعود التسجيل فورًا: تُكتب المدخلات على القرص وتُسلَّم لاحقًا، فالاستدعاء رخيص ولا يضيع شيء بسبب انهيار أو شبكة معطّلة. وأي تشغيل ينتهي دون خروج نظيف يُبلَّغ عنه في التشغيل التالي.وتبلّغ المشتريات عن معاملاتها تلقائيًا، ويتوقّف كل ما سبق عند إلغاء تحديد Analytics Enabled.

كشف الإنهاء غير المتوقّع

إذا انتهت جلسة لعب دون خروج نظيف — انهيار، أو تعليق أجبر اللاعب على إنهاء اللعبة قسرًا، أو نظام تشغيل أخرج اللعبة من الذاكرة — تكتشف حزمة التطوير ذلك عند التشغيل التالي وتبلّغ عن حدث app_termination واحد تلقائيًا. لا حاجة إلى أي تكامل.

الخاصية	المعنى
`classification`	`background_kill` (أُنهيت وهي في الخلفية — أمر طبيعي على الهواتف) أو `abnormal` (توقّفت وهي في المقدّمة دون خروج)
`previous_session_id`	الجلسة التي توقّفت
`last_alive_at`	الوقت التقريبي للتوقّف
`unhandled_exception_count`	الاستثناءات التي ظهرت في ذلك التشغيل — سياق مساعد، لا دليل على انهيار

راقب معدّل abnormal لكل إصدار لعبة — فقفزته بعد إطلاق نسخة هي أبكر إشارة تصلك عن استقرار اللعبة، دون الحاجة إلى أداة تقارير انهيار. أما إغلاق اللعبة بشكل طبيعي (الخروج من داخل اللعبة، أو Alt-F4، أو إزاحة التطبيق) فلا يُحتسب abnormal أبدًا.

تتبّع أحداثًا ذات معنى وبأسماء واضحة، مع مجموعة صغيرة من الخصائص. فتوحيد أسماء الأحداث يجعل قراءة اللوحات أسهل بكثير.

بدء الاستخدام

المفاهيم

حزم التطوير

الميزات

المرجع

التحليلات والأحداث

كشف الإنهاء غير المتوقّع

​كشف الإنهاء غير المتوقّع

كشف الإنهاء غير المتوقّع