يوضِّح لك هذا الدليل كيفية استخدام واجهة برمجة التطبيقات لإحصاءات اللاعبين في "خدمات ألعاب Google Play". يمكنك استخدام واجهة برمجة تطبيقات إحصاءات اللاعبين لاسترداد بيانات حول نشاط اللاعب داخل اللعبة.
تتيح لك واجهة برمجة التطبيقات لإحصاءات اللاعبين تخصيص تجارب اللعب لشرائح محددة من اللاعبين ومراحل مختلفة من مراحل نشاطهم. يمكنك إنشاء تجارب مخصّصة لكل شريحة من شرائح اللاعبين استنادًا إلى مستوى تقدّم اللاعبين وإنفاقهم وتفاعلهم مع المحتوى. على سبيل المثال، يمكنك استخدام واجهة برمجة التطبيقات هذه لاتخاذ إجراءات استباقية لتشجيع اللاعبين الأقل نشاطًا على إعادة التفاعل مع لعبتك، مثلاً من خلال عرض عناصر جديدة داخل اللعبة والترويج لها عندما يسجّل اللاعب الدخول.
يمكن العثور على واجهات برمجة التطبيقات في الحِزمتَين
com.google.android.gms.games.stats
وcom.google.android.gms.games.
تشمل أنواع بيانات المشغل التي يمكنك استردادها ما يلي:
متوسط مدة الجلسة: متوسط مدة جلسة المشغّل بالدقائق. يتم تحديد مدة الجلسة من خلال الوقت الذي يسجّل فيه اللاعب الدخول إلى خدمات "ألعاب Google Play".
عدد الأيام التي مرت منذ آخر مرة شغّلت فيها المشغّل
عدد عمليات الشراء: العدد التقريبي لعمليات الشراء داخل التطبيق للمشغّل.
عدد الجلسات: العدد التقريبي لجلسات المشغّل. يتم تحديد الجلسات حسب عدد المرات التي سجّل فيها اللاعب الدخول إلى خدمات "ألعاب Google Play".
النسبة المئوية للجلسة: هي القيمة التقريبية للجلسات للمشغّل باعتبارها قيمة عشرية تتراوح بين 0 و1 ضمنًا. تشير هذه القيمة إلى عدد الجلسات التي شغّلها اللاعب الحالي مقارنةً بباقي لاعبي هذه اللعبة. تشير الأرقام الأعلى إلى أنّ هذا المشغّل قد شغّل عددًا أكبر من الجلسات.
النسبة المئوية للإنفاق: النسبة المئوية التقريبية للإنفاق للمشغّل، ويتم عرضها في شكل قيمة عشرية تتراوح من 0 إلى 1 شاملة. تشير هذه القيمة إلى المبلغ الذي أنفقه اللاعب الحالي مقارنةً بباقي قاعدة لاعبي هذه اللعبة. تشير الأرقام الأعلى إلى أنّ إنفاق هذا اللاعب أكبر.
يتم إيقاف الأنواع التالية من بيانات المشغّل ودائمًا ما يتم عرض قيمة ثابتة بدون ضبط:
- احتمالية إيقاف الاستخدام: هي توقُّع ما إذا كان لاعب سيتوقف عن الاستخدام في اليوم التالي، ويتم منحه قيمة عشرية تتراوح بين 0 (احتمال منخفض للتوقّف عن الاستخدام) و1 (احتمالية عالية لتوقّف الاستخدام) شاملة. ويُقصد بالإيقاف النهائي عدم النشاط لمدة 7 أيام.
- احتمالية الإنفاق: هي الاحتمالية التقريبية التي يختارها اللاعب للإنفاق في هذه اللعبة، ويتم احتسابها كقيمة عشرية تتراوح بين 0 (احتمالية منخفضة للإنفاق) و1 (احتمالية عالية للإنفاق) شاملة.
- إجمالي الإنفاق خلال الأيام الـ 28 القادمة: الإجمالي التقريبي لإنفاق اللاعبين المتوقّع خلال الأيام الـ 28 القادمة في هذه اللعبة
- احتمالية الإنفاق المرتفع: الاحتمالية التقريبية بأن ينفق اللاعب مبلغًا يتخطّى 95% أو أعلى من قاعدة لاعبي اللعبة خلال الأيام الثمانية والعشرين المقبلة. يتم تقديم القيمة على شكل قيمة عشرية تتراوح بين 0 (احتمال منخفض أن يصبح إنفاقًا مرتفعًا) و1 (احتمالية عالية بأن يصبح إنفاقًا مرتفعًا).
قبل البدء
قبل بدء استخدام واجهة برمجة التطبيقات لإحصاءات اللاعبين:
- نزِّل عيّنة التعليمات البرمجية وراجعها.
- ننصحك بالتعرّف على الاقتراحات الموضّحة في قائمة التحقّق من الجودة.
جذب العميل
لبدء استخدام واجهة برمجة التطبيقات لإحصاءات اللاعبين، يجب أن تحصل لعبتك أولاً على عنصر PlayerStatsClient. يمكنك القيام بذلك عن طريق استدعاء الطريقة
Games.getPlayerStatsClient()
وتمرير النشاط.
تستخدم فئة
PlayerStatsClient
فئة خدمات Google Play
Task
لعرض النتائج بشكل غير متزامن. لمزيد من المعلومات حول
استخدام المهام لإدارة سلسلة العمل، راجِع
دليل مطوّر برامج واجهة برمجة تطبيقات "مهام Google".
استرداد البيانات
لاسترداد بيانات إحصاءات اللاعب الخاصة باللاعب الذي سجّلت الدخول إليه حاليًا، يمكنك اتّباع الخطوات التالية:
عليك استدعاء الطريقة
PlayerStatsClient.loadPlayerStats().في حال نجاح الطلب، ستعرض "خدمات ألعاب Google Play" عنصر
Taskيحمّل عنصرPlayerStatsبشكل غير متزامن. يمكنك استخدام طرق هذا الكائن لاسترداد بيانات حول أنشطة اللاعب الذي تم تسجيل الدخول إليه في تطبيقك.
إليك مثال على ذلك:
public void checkPlayerStats() {
PlayGames.getPlayerStatsClient(this)
.loadPlayerStats(true)
.addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
@Override
public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
if (task.isSuccessful()) {
// Check for cached data.
if (task.getResult().isStale()) {
Log.d(TAG, "using cached data");
}
PlayerStats stats = task.getResult().get();
if (stats != null) {
Log.d(TAG, "Player stats loaded");
if (stats.getDaysSinceLastPlayed() > 7) {
Log.d(TAG, "It's been longer than a week");
}
if (stats.getNumberOfSessions() > 1000) {
Log.d(TAG, "Veteran player");
}
if (stats.getChurnProbability() == 1) {
Log.d(TAG, "Player is at high risk of churn");
}
}
} else {
int status = CommonStatusCodes.DEVELOPER_ERROR;
if (task.getException() instanceof ApiException) {
status = ((ApiException) task.getException()).getStatusCode();
}
Log.d(TAG, "Failed to fetch Stats Data status: "
+ status + ": " + task.getException());
}
}
});
}
نصائح
تتيح لك واجهة برمجة التطبيقات لإحصاءات Play التعرّف بسهولة على أنواع مختلفة من اللاعبين بناءً على تفاعلهم وسلوكهم في الإنفاق، وتطبيق الاستراتيجيات المناسبة على تحسين تجربتهم في اللعبة.
يسرد الجدول التالي بعض الأمثلة على شرائح اللاعبين واستراتيجيات التفاعل المقترَحة:
| شريحة اللاعبين | استراتيجية التفاعل |
|---|---|
| اللاعبون المتكررون الذين سجَّلوا عددًا كبيرًا من الجلسات ومعدّلًا جيدًا للإنفاق، لكن لم يلعبوا خلال الأسبوع الماضي أو أكثر. |
|
| اللاعبون الأكثر تفاعلاً مع نسبة مئوية منخفضة للإنفاق. |
|
| اللاعبون ذوو الإنفاق المرتفع يُظهرون وجود إشارات إلى بلوغ الذروة وبدأ اللعب بوتيرة أقل. |
|
| اللاعبون الذين لديهم احتمالية إنفاق مرتفعة أو منخفضة للغاية. |
|