Google Play游戲服務(wù)：Android 游戲中的玩家統(tǒng)計(jì)信息

重要提示：根據(jù)此API的實(shí)驗(yàn)結(jié)果，我們已停止填充以下端點(diǎn)：流失概率、消費(fèi)概率、未來(lái)28天的預(yù)估總消費(fèi)額以及高消費(fèi)概率?，F(xiàn)在，上述各個(gè)端點(diǎn)都會(huì)始終返回未設(shè)定值常量。玩家統(tǒng)計(jì)信息系統(tǒng)在沒(méi)有足夠的數(shù)據(jù)來(lái)計(jì)算某個(gè)特定端點(diǎn)的值時(shí)，也會(huì)使用同樣的值來(lái)說(shuō)明這種情況。

利用Player Stats API，您可以針對(duì)某些玩家細(xì)分群體和玩家生命周期的不同階段量身設(shè)計(jì)游戲體驗(yàn)。您可以根據(jù)玩家的游戲進(jìn)度、消費(fèi)情況和互動(dòng)度，為每個(gè)玩家細(xì)分群體量身打造體驗(yàn)。舉例來(lái)說(shuō)，您可以使用此API采取積極的措施來(lái)鼓勵(lì)活躍度較低的玩家重新積極地玩游戲，例如您可以在玩家登錄時(shí)顯示并推銷(xiāo)新的游戲內(nèi)商品。

本指南將介紹如何通過(guò)Google Play游戲服務(wù)在游戲中使用Player Stats API。這些API可以在com.google.android.gms.games.stats和com.google.android.gms.games包中找到。

準(zhǔn)備工作

開(kāi)始使用Player Stats API之前，請(qǐng)做好以下準(zhǔn)備：

·下載并查看代碼示例。

·熟悉質(zhì)量核對(duì)清單中所述的建議。

獲取玩家統(tǒng)計(jì)信息客戶端

要開(kāi)始使用Player Stats API，您的游戲必須首先獲取PlayerStatsClient對(duì)象。為此，您可以調(diào)用Games.getPlayerStatsClient()方法并傳入當(dāng)前玩家的活動(dòng)和GoogleSignInAccount。要了解如何檢索玩家的帳號(hào)信息，請(qǐng)參閱在Android游戲中登錄。

注意：PlayerStatsClient類(lèi)會(huì)利用Google Play服務(wù)的Task類(lèi)來(lái)異步返回結(jié)果。要詳細(xì)了解如何使用任務(wù)來(lái)管理線程工作，請(qǐng)參閱Tasks API開(kāi)發(fā)者指南。

玩家統(tǒng)計(jì)信息基礎(chǔ)知識(shí)

您可以使用Player Stats API檢索玩家在游戲內(nèi)的活動(dòng)數(shù)據(jù)。您可以檢索的玩家數(shù)據(jù)類(lèi)型包括：

·平均會(huì)話時(shí)長(zhǎng)：玩家的平均會(huì)話時(shí)長(zhǎng)，以分鐘為單位。每次的會(huì)話時(shí)長(zhǎng)從玩家登錄Google Play游戲服務(wù)之時(shí)開(kāi)始計(jì)算，到退出服務(wù)為止。

·距離上次玩游戲的天數(shù)：距離玩家上一次玩游戲的大概天數(shù)。

·購(gòu)物次數(shù)：玩家在應(yīng)用內(nèi)購(gòu)買(mǎi)商品的大概次數(shù)。

·會(huì)話次數(shù)：玩家的大概會(huì)話次數(shù)。會(huì)話次數(shù)根據(jù)玩家登錄Google Play游戲服務(wù)的次數(shù)來(lái)計(jì)算。

·會(huì)話百分位：玩家的會(huì)話百分位近似值，以0到1之間（含二者）的小數(shù)值表示。此值反映與此游戲的玩家群中其他的玩家相比，當(dāng)前玩家玩游戲的會(huì)話次數(shù)。數(shù)字越大，表示此玩家玩游戲的會(huì)話越多。

·消費(fèi)百分位：玩家的消費(fèi)百分位近似值，以0到1之間（含二者）的小數(shù)值表示。此值反映與此游戲的玩家群中其他的玩家相比，當(dāng)前玩家已經(jīng)消費(fèi)的金額。數(shù)字越大，表示此玩家的消費(fèi)越多。

以下玩家數(shù)據(jù)類(lèi)型已棄用，系統(tǒng)針對(duì)這些類(lèi)型會(huì)始終返回未設(shè)定值常量：

·流失概率：對(duì)玩家是否會(huì)在接下來(lái)的一天流失進(jìn)行的預(yù)測(cè)，以0（低流失概率）到1（高流失概率）之間（含二者）的小數(shù)值表示。流失是指玩家連續(xù)7天無(wú)活動(dòng)。

·消費(fèi)概率：玩家在此游戲中選擇消費(fèi)的大概概率，以0（低消費(fèi)概率）到1（高消費(fèi)概率）之間（含二者）的小數(shù)值表示。

·未來(lái)28天的預(yù)估總消費(fèi)額：預(yù)計(jì)未來(lái)28天玩家在此游戲中的大概總消費(fèi)。

·高消費(fèi)概率：未來(lái)28天玩家的消費(fèi)金額處于此游戲玩家群消費(fèi)水平的第95百分位或更高百分位的大概概率。此值以0（成為高消費(fèi)玩家的概率低）到1（成為高消費(fèi)玩家的概率高）之間（含二者）的小數(shù)值表示。

檢索玩家統(tǒng)計(jì)數(shù)據(jù)

要檢索當(dāng)前已登錄玩家的玩家統(tǒng)計(jì)數(shù)據(jù)，請(qǐng)按以下步驟操作：

1.調(diào)用PlayerStatsClient.loadPlayerStats()方法。

2.如果調(diào)用成功，Google Play游戲服務(wù)會(huì)返回Task對(duì)象，該對(duì)象會(huì)異步加載PlayerStats對(duì)象。使用此對(duì)象的方法來(lái)檢索應(yīng)用中已登錄玩家的活動(dòng)數(shù)據(jù)。

示例如下：

public void checkPlayerStats(){

Games.getPlayerStatsClient(this,GoogleSignIn.getLastSignedInAccount(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());

}

}

});

}

有關(guān)使用玩家統(tǒng)計(jì)數(shù)據(jù)的提示

利用Play Stats API，您可以根據(jù)玩家在游戲內(nèi)的互動(dòng)情況和消費(fèi)行為，輕松識(shí)別不同類(lèi)型的玩家，然后采取相應(yīng)的策略提升玩家的游戲體驗(yàn)。

下表列出了一些玩家細(xì)分群體示例以及建議的互動(dòng)度提升策略：