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