Master Data Reference of GS2-LoginReward
{
"version": "2023-07-11",
"bonusModels": [
{
"bonusModelId": "[string]Login Bonus Model GRN",
"name": "[string]Bonus Model Name",
"metadata": "[string?]metadata",
"mode": "[string]mode",
"periodEventId": "[string?]GS2-Schedule Event GRN that represents the period during which to enable login bonuses",
"resetHour": "[int]Reset time of the receive flag (UTC)",
"repeat": "[string]Reset time of the receive flag (UTC)",
"rewards": [
{
"acquireActions": [
{
"action": "[string]Types of actions to be performed in the stamp sheet",
"request": "[string]JSON of request"
}
]
}
],
"missedReceiveRelief": "[string]Missed Rescue Function",
"missedReceiveReliefConsumeActions": [
{
"action": "[string]Types of actions to be performed in the stamp task",
"request": "[string]JSON of the obtain request"
}
]
}
]
}
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
version | ✓ | 2023-07-11 | Format version of master data | |||
bonusModels | List<BonusModel> |
BonusModel
Bonus Model Set the distribution schedule of login bonuses. There are two types of distribution schedules: “Schedule Mode” and “Streaming Mode”.
In Schedule Mode, the GS2-Schedule event is required, and the bonus is distributed based on the number of days elapsed since the start of the event. If you miss a shot in the middle, you will not receive the bonus for that shot.
In Streaming Mode, the rewards set for the bonus are distributed one by one from the beginning every day. In Streaming Mode, you can set it to repeat. In that case, if you reach the end of the stream, you will start distributing from the beginning again.
Both Schedule Mode and Streaming Mode have a rescue function for missed shots. By paying a certain cost, you can receive the bonus you missed. However, if the GS2-Schedule event is associated, you can only receive the bonus after the number of days elapsed since the start of the event. The missed capture function is not available in streaming mode and when repetition is enabled.
The maximum number of days of bonuses that can be set in both Scheduled and Streaming modes is 100 days.
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
bonusModelId | string | ✓ | ~ 1024 chars | Login Bonus Model GRN | ||
name | string | ✓ | ~ 128 chars | Bonus Model Name | ||
metadata | string | ~ 2048 chars | metadata | |||
mode | enum [‘schedule’, ‘streaming’] | ✓ | ~ 128 chars | mode | ||
periodEventId | string | ~ 1024 chars | GS2-Schedule Event GRN that represents the period during which to enable login bonuses | |||
resetHour | int | {periodEventId} == "" | ✓ | ~ 23 | Reset time of the receive flag (UTC) | |
repeat | enum [’enabled’, ‘disabled’] | {mode} == “streaming” | ✓ | ~ 128 chars | Reset time of the receive flag (UTC) | |
rewards | List<Reward> | ~ 100 items | List of rewards | |||
missedReceiveRelief | enum [’enabled’, ‘disabled’] | ✓ | “disabled” | ~ 128 chars | Missed Rescue Function | |
missedReceiveReliefConsumeActions | List<ConsumeAction> | {missedReceiveRelief} == “enabled” | ~ 10 items | List of consumption actions for missed receive relief |
Reward
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
acquireActions | List<AcquireAction> | ✓ | 1 ~ 10 items | List of Acquire Action |
ConsumeAction
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
action | enum [] | ✓ | ~ 128 chars | Types of actions to be performed in the stamp task | ||
request | string | ✓ | ~ 1048576 chars | JSON of the obtain request |
AcquireAction
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
action | enum [] | ✓ | ~ 128 chars | Types of actions to be performed in the stamp sheet | ||
request | string | ✓ | ~ 1048576 chars | JSON of request |