آمار بازیکن را به بازی خود اضافه کنید

پس از منسوخ شدن رابط برنامه‌نویسی کاربردی ورود گوگل (Google Sign-In API)، ما در سال ۲۰۲۶ کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) را حذف خواهیم کرد. پس از فوریه ۲۰۲۵، شما قادر به انتشار عناوینی که به تازگی با کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) ادغام شده‌اند، در گوگل پلی نخواهید بود. توصیه می‌کنیم به جای آن از کیت توسعه نرم‌افزاری بازی‌ها نسخه ۲ (games v2 SDK) استفاده کنید.
در حالی که عناوین موجود با بازی‌های قبلی نسخه ۱ ادغام‌شده تا چند سال دیگر به کار خود ادامه می‌دهند، توصیه می‌شود از ژوئن ۲۰۲۵ به نسخه ۲ مهاجرت کنید .
این راهنما برای استفاده از SDK نسخه ۱ سرویس بازی‌های Play Games است. SDK مربوط به C++ برای سرویس بازی‌های Play Games نسخه ۲ هنوز در دسترس نیست.

API آمار بازیکن به شما امکان می‌دهد تجربیات بازی را برای بخش‌های خاصی از بازیکنان و مراحل مختلف چرخه عمر بازیکن تنظیم کنید. می‌توانید بر اساس نحوه پیشرفت، هزینه کردن و تعامل بازیکنان، تجربیات سفارشی برای هر بخش از بازیکنان بسازید. به عنوان مثال، می‌توانید از این API برای انجام اقدامات پیشگیرانه برای تشویق یک بازیکن کمتر فعال به تعامل مجدد با بازی خود استفاده کنید، مانند نمایش و تبلیغ موارد جدید درون بازی هنگام ورود بازیکن.

این راهنما به شما نشان می‌دهد که چگونه از API آمار بازیکن (Player Stats API) در یک برنامه بومی C++ یا Objective-C استفاده کنید.

اصول اولیه آمار بازیکن

شما می‌توانید از APIهای آمار بازیکن برای بازیابی اطلاعات مربوط به فعالیت درون بازی یک بازیکن استفاده کنید. انواع داده‌های بازیکن که می‌توانید بازیابی کنید عبارتند از:

• میانگین مدت زمان هر جلسه : میانگین مدت زمان هر جلسه بازیکن به دقیقه. مدت زمان هر جلسه با توجه به زمانی که بازیکن وارد سرویس‌های بازی‌های گوگل پلی می‌شود، تعیین می‌شود.
• احتمال ریزش : پیش‌بینی اینکه آیا یک بازیکن در روز بعد ریزش خواهد کرد یا خیر، که به صورت ۰ (احتمال ریزش کم) یا ۱ (احتمال ریزش زیاد) داده می‌شود. ریزش به صورت ۷ روز عدم فعالیت تعریف می‌شود.
• تعداد روزهای سپری شده از آخرین بازی : تعداد تقریبی روزهای سپری شده از آخرین بازی بازیکن.
• تعداد خریدها : تعداد تقریبی خریدهای درون برنامه‌ای برای بازیکن.
• تعداد جلسات : تعداد تقریبی جلسات بازیکن. جلسات با تعداد دفعاتی که یک بازیکن وارد سرویس‌های بازی‌های گوگل پلی می‌شود، تعیین می‌شود.
• درصد جلسات : تقریب درصد جلسات برای بازیکن، که به صورت یک مقدار اعشاری بین ۰ و ۱ (شامل) ارائه می‌شود. این مقدار نشان می‌دهد که بازیکن فعلی در مقایسه با بقیه بازیکنان این بازی، چند جلسه بازی کرده است. اعداد بالاتر نشان می‌دهد که این بازیکن جلسات بیشتری بازی کرده است.
• درصد هزینه : درصد تقریبی هزینه بازیکن، که به صورت یک مقدار اعشاری بین ۰ و ۱ (شامل) ارائه می‌شود. این مقدار نشان می‌دهد که بازیکن فعلی در مقایسه با بقیه بازیکنان این بازی چقدر هزینه کرده است. اعداد بالاتر نشان می‌دهد که این بازیکن بیشتر هزینه کرده است.

دریافت آمار بازیکن برای بازیکنی که در حال حاضر وارد سیستم شده است با 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);
  }
}];

نکاتی برای استفاده از داده‌های آمار بازیکن

API آمار بازی به شما امکان می‌دهد به راحتی انواع مختلف بازیکنان را بر اساس میزان تعامل و رفتار خرید آنها شناسایی کنید و استراتژی‌های مناسبی را برای بهبود تجربه بازی آنها به کار بگیرید.

جدول زیر برخی از بخش‌های نمونه بازیکنان و استراتژی‌های تعامل پیشنهادی را فهرست می‌کند:

بخش پخش کننده	استراتژی تعامل
بازیکنانی که مرتباً بازی می‌کنند و تعداد جلسات بالایی دارند و درصد خرج خوبی دارند، اما در هفته گذشته یا بیشتر بازی نکرده‌اند.	در مورد تخفیف یا جایزه ویژه‌ای که پس از بازگشت آنها به بازی در دسترس است، اعلانی ارسال کنید. یک پیام خوشامدگویی که دستاوردهای چشمگیر را تصدیق می‌کند، نمایش دهید و یک نشان طراحی شده برای تشویق به بازی مجدد اهدا کنید.
بازیکنانی با تعامل بالا در درصدی از بازار که هزینه کمی صرف می‌کنند.	برای تشویق آنها به دعوت از دوستانشان برای نصب و پیوستن به بازی شما، پاداش‌هایی را در نظر بگیرید. این رویکرد بر اساس لذتی که بازیکن از بازی نشان می‌دهد، برای جذب بازیکنان جدید عمل می‌کند.
بازیکنان پرخرج نشانه‌هایی از اوج گرفتن و کاهش تعداد دفعات بازی را نشان می‌دهند.	برای جلب توجه آنها، پاداش‌های ویژه‌ای در نظر بگیرید، مثلاً با ارائه ابزارها، سلاح‌ها یا تخفیف‌های با ارزش بالا و کوتاه‌مدت. دفعه‌ی بعدی که بازیکن وارد سیستم می‌شود، ویدیویی به او نشان دهید که او را به سمت ویژگی‌های انجمن، مانند حملات قبیله‌ای، هدایت کند که باعث تعامل بیشتر و طولانی‌تر می‌شود.