ストア内のアイテムを表示する時間制限
仕組み
ストア内のアイテムの表示期間を次のように設定できます：
- ホリデーセール中など、特定の時間帯にカタログの関連性を維持します。
- カタログに表示せずに事前にアイテムを作成します。
- アイテムの横にタイマーを表示することで、ユーザーの購入意欲を高めることができます。サイトビルダーを使用してカタログインターフェースを作成すると、タイマーは自動的に表示されます。カスタムインターフェースを使用してカタログを構築する場合は、タイマーを開発者側で実装する必要があります。
- ゲーム内アイテムの販売 — 仮想アイテム、仮想通貨パッケージ、およびバンドル
- ゲームキーによるゲームおよびDLCの販売
注意
バンドル内ではアイテムの表示期間制限は考慮されません。
例
Booster という仮想アイテムを作成し、その表示期間を10月29日から11月15日までに設定してください。Legendary Start Pack というバンドルを作成し、その中にBooster を含めます。このバンドルには時間制限がないため、常にストアで表示されます。- 10月20日、ユーザーがインゲームストアを開きます。以下のメソッドを使用します：
- 仮想アイテムリストを取得するは仮想アイテムのカタログを表示するために使用されます。
- バンドルリストを取得するはバンドルのカタログを表示するために使用されます。
show_inactive_time_limited_itemsパラメータは渡しません。 - アイテムカタログを取得します：
Booster は、表示期間が10月29日から11月15日までであるため、仮想アイテムリストを取得するの応答には含まれません。仮想アイテムリストを取得するでパラメータshow_inactive_time_limited_items:1を渡すと、Booster が応答に含まれ、期間配列は購入可能な期間を示します。Booster は、Legendary Start Pack バンドルの一部としてバンドルリストを取得するの応答に含まれており、ユーザーは、show_inactive_time_limited_itemsパラメータの値に関係なく、それを入手できます。
制限の設定と更新
パブリッシャーアカウントで設定および更新する
注意
- 以下の設定プロセスは、仮想アイテムを例として示されています。
- 仮想アイテムを設定する前に、グループを作成することを推奨します。グループを使用すると、多層的なカタログを構築し、ストアでのアイテムの表示方法を管理できます。
- パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > すべてのアイテム > 仮想アイテムセクションに移動します。
- 「追加」をクリックして仮想アイテムを選択します。
- 以下のパラメータを指定してください：
- 画像
- SKU
- アイテムが属するべき1つまたは複数のグループ
- 名称
- 説明
- 価格
注意
アイテムを作成するには、実際通貨または仮想通貨の価格を指定する必要があります。価格をゼロにしてアイテムを作成することはできません。必要に応じて、地域別価格を設定してください。
- ユーザーがアイテムを購入できる回数を制限するには、1人のユーザーがこのアイテムを購入できる回数を制限するトグルをオンに設定し、制限回数を指定してください。
- 制限がリフレッシュされる頻度を設定するには：
- ドロップダウンリストで、期間を選択します：
- 日次
- 週次
- 月次
- カスタム間隔。この間隔は、ストアでのアイテムの表示期間の開始日から計算されます。
- 定期的なリフレッシュなし
- ドロップダウンリストで、期間を選択します：
- 期間に対応するパラメータを指定して、更新スケジュールを設定してください。
- カタログでアイテムの表示期間を設定するには、期間限定を選択し、タイムゾーン、開始日、終了日を指定します。アイテムを無期限に利用可能にするには、終了日なしを選択してください。
- 「アイテムを作成」をクリックします。
APIコールによる設定と更新
ストアでのアイテム表示に制限時間を設定するには、以下のAPIコールを使用してください：
- 仮想アイテムを作成するまたは仮想アイテムを更新する
- 仮想通貨を作成するまたは仮想通貨を更新する
- 仮想通貨パッケージを作成するまたは仮想通貨パッケージを更新する
- バンドルを作成するまたはバンドルを更新する
- ゲームを作成する、SKUによるゲームを更新する、またはIDによるゲームを更新する
periods[0].date_fromはアイテムの表示期間の開始日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mmGMT形式のタイムゾーンインジケーターです。periods[0].date_untilはアイテムの表示期間の終了日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mmGMT形式のタイムゾーンインジケーターです。アイテムの表示期間の終了を示さないようにするには、nullを渡します。
ストア内のアイテムを表示する期間を複数設定できます。これを行うには、APIコールですべての期間の開始日と終了日を含むオブジェクトの配列を渡します。
例：
Copy
- json
1"periods": [
2 {
3 "date_from": "2022-06-10T14:00:00+03:00",
4 "date_until": "2022-06-30T14:00:00+03:00"
5 },
6 {
7 "date_from": "2022-07-10T14:00:00+03:00",
8 "date_until": "2022-07-30T14:00:00+03:00"
9 },
10 {
11 "date_from": "2022-08-10T14:00:00+03:00",
12 "date_until": "2022-08-30T14:00:00+03:00"
13 }
14]
カタログ取得APIコールは、リクエスト時にストアに表示されているアイテムを返します。表示期間がまだ開始されていないまたは既に終了しているアイテムの情報を取得するには、カタログをリクエストする際に、「show_inactive_time_limited_items」パラメータを値「1」で渡します。
アイテムカタログでの制限の表示
カタログ内での期間限定アイテムの表示は、サイトビルダー経由かまたはAPIコール経由か、どちらの実装方法をとるかによって異なります。
サイトビルダー経由での表示
サイトビルダーを使用する場合、制限時間は自動的に表示されます。アイテムの販売期間終了の30日前になると、アイテムカードに残り時間を示すタイマーが自動で表示されます：
- 販売終了まで1週間以上ある場合、タイマーには日数と時間が表示されます。
- 販売終了まで1日以上ある場合、タイマーには時間と分が表示されます。
- 販売終了まで1日未満の場合、タイマーには分と秒が表示されます。
注意
プロモーションアイテムに注目を集めるため、注目オファーのカードスタイルを使用することを推奨します。
API経由での制限情報の取得
カタログがAPIを使用して実装されている場合、アイテムの販売期間の情報は以下のカタログ関連APIコールのitems.periods配列で返されます：
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
