إضافة إحصاءات اللاعبين إلى لعبتك

بعد إيقاف واجهة برمجة التطبيقات تسجيل الدخول باستخدام Google نهائيًا، سنزيل الإصدار v1 من حزمة تطوير البرامج (SDK) للألعاب في عام 2026. بعد فبراير 2025، لن يكون بإمكانك نشر الألعاب التي تم دمجها حديثًا مع الإصدار v1 من حزمة SDK للألعاب على Google Play. ننصحك باستخدام الإصدار v2 من حزمة SDK للألعاب بدلاً من ذلك.
مع أنّ التطبيقات الحالية التي تتضمّن عمليات الدمج السابقة للإصدار 1 من "خدمات ألعاب Google Play" ستستمر في العمل لعدّة سنوات، ننصحك بنقل البيانات إلى الإصدار 2 بدءًا من يونيو 2025.
هذا الدليل مخصّص لاستخدام الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play". حزمة تطوير البرامج (SDK) للغة C++ الخاصة بالإصدار 2 من "خدمات ألعاب Play" غير متاحة بعد.

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

يوضّح لك هذا الدليل كيفية استخدام واجهة برمجة التطبيقات Player Stats API في تطبيق C++ أو Objective-C أصلي.

أساسيات إحصاءات اللاعب

يمكنك استخدام واجهات برمجة التطبيقات الخاصة بإحصاءات اللاعبين لاسترداد بيانات حول نشاط اللاعب داخل اللعبة. تشمل أنواع بيانات اللاعبين التي يمكنك استردادها ما يلي:

• متوسط مدة الجلسة: متوسط مدة جلسة اللاعب بالدقائق. يتم تحديد مدة الجلسة حسب المدة التي يسجّل فيها اللاعب الدخول إلى "خدمات ألعاب Google Play".
• احتمالية إيقاف الاستخدام: هي توقّع ما إذا كان اللاعب سيوقف استخدام التطبيق في اليوم التالي، ويتم التعبير عنها بالقيمة 0 (احتمالية منخفضة لإيقاف الاستخدام) أو 1 (احتمالية عالية لإيقاف الاستخدام). يتم تعريف معدّل التوقّف عن الاستخدام بأنّه 7 أيام من عدم النشاط.
• عدد الأيام منذ آخر لعب: عدد الأيام التقريبي منذ آخر مرة لعب فيها اللاعب.
• عدد عمليات الشراء: العدد التقريبي لعمليات الشراء داخل التطبيق التي أجراها اللاعب.
• عدد الجلسات: العدد التقريبي لجلسات اللاعب. يتم تحديد الجلسات من خلال عدد المرّات التي يسجّل فيها اللاعب الدخول إلى "خدمات ألعاب Google Play".
• النسبة المئوية للجلسة: هي القيمة التقريبية للنسبة المئوية لجلسات اللاعب، ويتم عرضها كقيمة عشرية تتراوح بين 0 و1 (شاملة). تشير هذه القيمة إلى عدد الجلسات التي لعبها اللاعب الحالي مقارنةً ببقية قاعدة اللاعبين في هذه اللعبة. تشير الأرقام الأعلى إلى أنّ هذا اللاعب قد لعب عددًا أكبر من الجلسات.
• المعدّل المئوي للإنفاق: المعدّل المئوي التقريبي للإنفاق الذي أجراه اللاعب، ويتم عرضه كقيمة عشرية تتراوح بين 0 و1 (شاملة). تشير هذه القيمة إلى المبلغ الذي أنفقه اللاعب الحالي مقارنةً ببقية قاعدة اللاعبين في هذه اللعبة. تشير الأرقام الأعلى إلى أنّ هذا اللاعب قد أنفق المزيد.

الحصول على إحصاءات لاعب مسجّل الدخول حاليًا باستخدام C++

// Create the callback for our asynchronous fetch call.  This callback will
// log either an error or the average session length for the currently
// signed-in player.
gpg::StatsManager::FetchForPlayerCallback callback = [](gpg::StatsManager::FetchForPlayerResponse const &response) {
  if (IsError(response.status)) {
    LogE("An error occurred fetching player stats.");
  } else {
  gpg::PlayerStats const & player_stats = response.data;
    if (player_stats.HasAverageSessionLength()) {
      LogI("Average session length: %f", player_stats.AverageSessionLength());
    } else {
      LogW("Currently signed-in player had no associated average session length stats.");
    }
  }
};
// Asynchronously fetch the Player Stats.  When the fetch is finished it
// will call our callback. game_services_ is the std::unique_ptr<GameServices>
// returned by gpg::GameServices::Builder.Create()
game_services_->Stats().FetchForPlayer(callback);

الحصول على إحصاءات لاعب مسجّل الدخول حاليًا باستخدام Objective-C

// Asynchronously fetches the Player Stats and then logs either a
// description of them or an error
[GPGPlayerStats playerStatsWithCompletionHandler:^(GPGPlayerStats *playerStats, NSError *error) {
  if (error) {
    NSLog(@"Error fetching player stats: %@", error);
  } else {
    NSLog(@"Description of stats for the currently signed-in player: %@", playerStats);
  }
}];

نصائح لاستخدام بيانات إحصاءات اللاعبين

تتيح لك واجهة برمجة التطبيقات Play Stats API تحديد أنواع مختلفة من اللاعبين بسهولة، استنادًا إلى مستوى تفاعلهم وسلوكهم في الإنفاق، وتطبيق الاستراتيجيات المناسبة لتحسين تجربة اللعب.

يعرض الجدول التالي بعض الأمثلة على شرائح اللاعبين واستراتيجيات التفاعل المقترَحة:

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