App Store Connect 輔助說明

支援 / App Store Connect / 參考資料 / 排行榜

參考資料

排行榜

排行榜後設資料可識別 App Store Connect 中的每個排行榜、描述排行榜的得分,並收集要在排行榜中顯示的語言特定文字。App Store Connect 會追蹤排行榜類型的後設資料,並顯示狀態來指出排行榜是否通過核准以及是否會隨 App 一併上線。

請依照設定排行榜中描述的方法,在 App 的 Game Center 頁面之「排行榜」區段設定這些屬性。

排行榜屬性

主要的排行榜屬性可識別 App Store Connect 中的每一個排行榜。這些屬性描述了分數的編排方式與格式。

屬性

描述

參照名稱

你必須為每個排行榜所提供的內部名稱。如果你會在 App Store Connect 中搜尋排行榜,那麼這就是你搜尋時使用的名稱。

排行榜 ID

你為排行榜所選擇的英數識別碼。此 ID 最長為 100 個字元(假設為半形字元)。請注意,排行榜 ID 等同於 GameKit API 中的「類別」。你的排行榜 ID 為永久設定,因此確定之後就無法在未來加以編輯。

戰績格式

你要讓此 App 的分數在排行榜上顯示時使用的格式類型—例如,整數、經過時間或金錢。

戰績範圍

使用 64 位元帶正負號的整數表達的戰績範圍。這些值必須介於長最小值(-2^63)和長最大值(2^63 - 1)之間。超出此範圍的任何戰績,都會被刪除。戰績範圍值並非必要資訊,但如果加入了戰績範圍值,這兩個值都必須是固定的,且不得相等。首度加入戰績範圍或在未來將戰績範圍變更為會限制資料的較小範圍時,位於範圍外的所有資料都會遺失,且無法復原。

戰績提交類型

要顯示在排行榜中的玩家戰績:最佳戰績或最新戰績。

排序方式

戰績的排序。在「由低至高」與「由高至低」之間選擇。如果想讓最低的戰績優先顯示,請選擇「由低至高」。如果想讓最高的戰績優先顯示,請選擇「由高至低」。

開始日期與時間1

開始將戰績發佈到排行榜的日期與時間。日期與時間均以世界標準時間(UTC)為準。

持續時間1

將戰績發佈到排行榜之後所經過的時間長度。

重建的時間間隔1

排行榜上戰績重置的頻率。

1這項屬性僅可用於重複排行榜。

排行榜語言屬性

排行榜語言屬性收集了用來在排行榜上顯示的語言特定文字。你必須至少為一種語言包含這些屬性。

屬性

描述

本地化語言

顯示排行榜時使用的語言。必須至少定義一種語言。

顯示名稱

以指定語言呈現的排行榜顯示名稱。

戰績格式後綴(單數)

系統會將此後綴以單數形式添加到畫面上顯示的戰績尾端。此後綴並非必要資訊,但對於說明排行榜中儲存的戰績類型而言相當實用。後綴的範例有「point」、「coin」和「hit」。

戰績格式後綴(複數)

系統會將此後綴以複數形式添加到畫面上顯示的戰績尾端。此後綴並非必要資訊,但對於說明排行榜中儲存的戰績類型而言相當實用。後綴的範例有「points」、「coins」和「hits」。

戰績格式

此格式決定你在特定語言排行榜上的分數顯示方式。舉例來說,如果你的 App 是以金錢來計分,建議你根據所選語言指定不同的金錢類型。除非你指定了不同的分數格式類型,否則你為排行榜設定的類型將自動套用至所有語言。此選項為非必填。

影像

代表排行榜的本地化影像。影像格式必須是 .jpeg.jpg、或 .png 檔,大小為 1024 x 1024 像素,至少 72 dpi,並且採用 RGB 色彩空間。此屬性為非必填。

排行榜類型

App Store Connect 會追蹤各類排行榜的不同資料。排行榜類型會決定排行榜中包含了哪些戰績。

類型

描述

經典

絕不會重置戰績資料的排行榜(除非將排行榜刪除)。

循環性

循環性排行榜會根據你的偏好設定持續重置。

聯合

將來自多種個別排行榜的玩家戰績合併顯示與共同排名的一種排行榜。

附加

與其他排行榜合併顯示的個別排行榜—聯合排行榜的附加子項目。

排行榜狀態

排行榜狀態會指出排行榜是否已通過核准且連同 App 一併上架。

狀態

描述

已上架

排行榜已連同 App 一併通過核准。

未上架

排行榜尚未連同 App 的某個版本通過核准。如果排行榜先前已為某一款 App 上架、移至群組且尚未連同群組一併通過核准,則排行榜也將具有此狀態。