ワールドデータ管理
ユーザーデータは、ワールドデータ管理機能を通じて表示および変更できます。
❗️ 注意 ワールド開発者は、この機能を使用するために独自のAPIを追加する必要があります。 APIの追加方法については、以下のガイドを参照してください。 [マルチプレイワールドデータストレージ]
各ワールドコンソールの「データ管理」メニューから、ワールドのDBにアクセスして編集できます。
データ管理には合計4つの項目があります。すべての項目は、対応するワールドを使用しているユーザーIDに基づいて、ユーザー固有の情報を検索します。
- 在庫: '製品' メニューで作成されたアイテム/アイテムパッケージ/通貨パッケージに関連するユーザー情報を表示および編集できます。
- 残高: '通貨' メニューで作成された通貨に関連するユーザー情報を表示および編集できます。
- 製品の支払い履歴 (ZEM): 世界内の各支払い取引に対する製品の支払い履歴と領収書IDを確認できます。
❗️ 注意 リンクされた世界データは、審査完了後のリリース時から記録されています。
[マルチプレイ世界データストレージ] は、保存されたユーザー情報を表示することができます。
- 検索に使用されるZEPETO IDは、アプリのユーザープロフィールにあります。
- 検索されたデータの標準時間が表示され、ユーザーがプレイしている場合、データは引き続き変化します。この時、日付の横にある更新ボタンまたはF5を押すことで、データを最新のものに更新できます。
- 各ストレージのデータはキー/バリューの形式で保存され、キーを変更することで検索できます。
- キーリストには、対応するユーザーデータベースに実際に保存されているキー値のみが表示されます。
- キー値を検索して変更することもできます。
- 右側の「編集」ボタンを押すと、編集状態に切り替わります。編集状態では、保存された値を自由に変更できます。
- 編集中はキー値を変更することはできません。
- 編集後、データを保存して実際に反映させる必要があります。編集時のデータが実際のユーザーのデータと異なる場合、警告メッセージが生成されます。
❗️ 注意
- 以下のルールが満たされない場合、データは正常に保存されません。
- 値がない場合
- 保存できない値を入力する場合
- データ保存の制約
- キーの長さ制限：50文字
- キーにはアルファベット、数字、アンダースコア(_)のみが許可されています。
- 最大キー数：ユーザーIDごとに1000
- 最大値データサイズ：500,000文字
- 実際のサーバーに値データが保存されるとき、内部識別子と一緒にシリアライズされることに注意してください。これを考慮し、安全のために余裕を持って使用してください。
- データ保存API呼び出し制限
- 取得（1分あたり）：200回
- 設定（1分あたり）：200回
❗️ 注意 ユーザーがリアルタイムで世界をプレイしている場合、データが上書きされるリスクがあります。保存ボタンを押す前に必ず確認してください！
「製品」メニューで作成されたアイテム/アイテムパッケージ/通貨パッケージに関連するユーザー情報を表示および編集できます。
- 検索に使用されるZEPETO IDは、アプリのユーザープロフィールにあります。
- 検索されたデータの標準時間が表示され、ユーザーがプレイしている場合、データは継続的に変化します。この時、日付の横にある更新ボタンまたはF5を押すことでデータを最新のものに更新できます。
- ID: 保存されたアイテムのユニークID値
- 名前: 保存されたアイテムの名前
- 数: 保存されたアイテムの数（最大2,147,483,647）
- 更新: アイテムの情報が更新された日付
👍 各情報は編集可能であり、管理者はDBに入力された値を自由に変更できます。ただし、一度に最大100件のデータを一括編集できます。
📘 以下のガイドを参照してください。 [Multiplay World DataStorage]
インベントリでユーザーのZEPETO IDを検索すると、履歴付きのユーザーデータベース画面が以下のように表示されます。
- データベースに保存されていない新しいアイテムを追加するには、追加ボタンを押すことができます。ただし、事前に作成された製品のみが新製品として追加できます。
- 編集モードに切り替えると、ボタンが表示されません。
ログ
- リアルタイムデータベースで行われたすべての編集をログメニューで確認できます。
- 最大90日間まで検索できます。
- 2023年に作成されたデータを表示できます。
インベントリのログ履歴ボタンをクリックし、右上隅のダウンロードボタンをクリックして、特定の日付のすべてのログをExcelファイルとしてダウンロードします。
- ダウンロードできるのは最大100,000ビューまでです。
「通貨」メニューでは、作成した通貨に関連するユーザー情報を表示および編集できます。
- 検索に使用されるZEPETO IDは、アプリのユーザープロフィールにあります。
- 検索されたデータの標準時間が表示され、ユーザーがプレイしている場合、データは継続的に変化します。この時、日付の横にある更新ボタンまたはF5を押してデータを最新のものに更新できます。
- ID: 保存された通貨のユニークID値
- 名前: 保存された通貨の名前
- 数: 保存された通貨の数（最大2,147,483,647）
- 更新: 通貨の情報が更新された日付
👍 各情報は編集可能であり、管理者はDBに入力された値を自由に変更できます。ただし、一度に最大100件のデータをバッチ編集できます。
📘 以下のガイドを参照してください。 [あなたの世界を収益化！製品と通貨の設定]
バランスでユーザーのZEPETO IDを検索すると、履歴付きのユーザーデータベース画面が以下のように表示されます。
- データベースに保存されていない新しいアイテムを追加するには、追加ボタンを押すことができます。ただし、事前に作成された通貨のみが新しいものとして追加できます。
- 編集モードに切り替えると、ボタンが表示されません。
ログ
- リアルタイムデータベースで行われたすべての編集をログメニューで確認できます。
- 最大90日間を一度に検索できます。
- 2023年に作成されたデータを表示できます。
バランスのログ履歴ボタンをクリックし、右上のダウンロードボタンをクリックして、指定した日付からすべてのログをExcelファイルとしてダウンロードします。
- 最大100,000ビューまでダウンロードできます。
世界でZEMで取引された商品の支払い履歴と各支払いの領収書IDを確認できます。
- 領収書IDは、支払いが行われたときのみ記録されます。ここに記録されていない支払いは、失敗した支払いです。
- 一度に最大90日間検索できます。
👍 製品の支払い履歴を利用することで、ユーザーの製品取引が実際に行われたかどうかを判断し、関連する問い合わせに対応できます。
- 日付：ログが残された日付
- 領収書ID：領収書のID
- 製品ID：購入した製品のID
- ZEM：購入時に支払った製品のZEM
Sales Histories(ZEM)の右上隅にあるダウンロードボタンをクリックして、指定した日のすべてのログをExcelファイルとしてダウンロードします。
- 最大100,000ビューまでダウンロードできます。
