> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/cht/quest/onequest.md).

# ONEquest Operation Guide

ONEquest is a marketing tool that lets game developers create quests that fit their goals, at the time they choose, to drive ONE store users to engage with their games.

Game developers manage quest design, schedules, budgets, and operations directly in ONEconsole. Currently, quests are available for **games** only. Apps will open in stages once the criteria for apps are set. This guide walks you through everything you need to know, from application to the end of a quest.

{% hint style="info" %}
To run in-game action quests, you need to integrate your game server. See the [ONEquest In-game Integration Guide](https://onestore-dev.gitbook.io/dev/eng/tools/onequest-developer-guide) for details
{% endhint %}

## 1. Summary

<table data-search="false"><thead><tr><th width="133">Item</th><th>Details</th></tr></thead><tbody><tr><td>Eligible products</td><td><ul><li><p>Android games that are <strong>In Registration</strong> or <strong>On Sale</strong> on ONE store <strong>Korea</strong>.</p><ul><li>Currently, quests are available for game-based content only.</li><li>For products In Registration, the “Product Title” and “Main Icon” are required.</li><li>Products in registration also need to obtain a content rating.</li><li>To offer in-game action missions, a binary must be registered.</li></ul></li></ul></td></tr><tr><td>Platform</td><td><ul><li>Provided in the ONE store Android app.</li><li>To run quests on the ONEquest Global Web, please contact us through Contact Us.<br><a href="https://www.onechain.nexus/quest">Go to ONEquest Global Web</a></li></ul></td></tr><tr><td>Quest types</td><td><ul><li>Choose from Social Media Promotion (X: Twitter)</li><li>Pre-registration</li><li>In-game Action</li></ul></td></tr><tr><td>Rewards</td><td><ul><li>Users receive ONEdia, which can be used to pay for games and apps on ONE store.</li><li>1 ONEdia is worth 1 KRW.</li></ul></td></tr><tr><td>Fees</td><td><ul><li>There is no marketing fee.</li></ul></td></tr><tr><td>Where quests appear</td><td><ul><li>Quests appear in ONEquest under [Benefits] and [My] in the ONE store app.</li><li>Featured quests appear on more screens.</li></ul></td></tr><tr><td>Featuring inquiries</td><td><ul><li>Please contact us via <a href="https://dev.onestore.net/dev/help/contact?categoryId=QNA40001">[Contact Us] > [Marketing] > [ONEquest]</a>.</li></ul></td></tr></tbody></table>

## 2. How It Works

<table><thead><tr><th width="150.5">Step</th><th width="402">What happens</th><th>Who</th></tr></thead><tbody><tr><td>1. Apply</td><td>Fill out the ONEquest application in ONEconsole and agree to the terms.</td><td>Game developer</td></tr><tr><td>2. Charge budget</td><td>Agree on the campaign size and deposit the marketing budget (Credits) to the bank account.</td><td>Game developer · ONE store</td></tr><tr><td>3. Approval</td><td>ONE store approves the application after confirming the deposit.</td><td>ONE store</td></tr><tr><td>4. Register quests</td><td>Register quest groups and individual quests, and check them in Preview.</td><td>Game developer</td></tr><tr><td>5. Display &#x26; run</td><td>When display is turned on, the quest goes live in the ONE store app and users take part.</td><td>Game developer</td></tr><tr><td>6. End</td><td>The quest closes on its end date or when you end it, and you review the statistics.</td><td>Game developer</td></tr></tbody></table>

## 3. How to Apply

**Path:** ONEconsole > Marketing > Apply for ONEquest

{% hint style="warning" %}
Please apply using the ONEconsole account where the game for this quest is registered.\
You can manage quests for the games registered to your developer account.
{% endhint %}

1. When you first enter, you will see the ONEquest application guide.
2. Fill out the application form, agree to the ONEquest Terms of Service, and submit.
3. After you apply, you can check the status (Pending Approval / Approved) on the screen.

<table><thead><tr><th width="176">Note</th><th>Details</th></tr></thead><tbody><tr><td>Who can apply</td><td>In addition to the master account, sub-accounts with [Marketing] menu permission can apply.</td></tr><tr><td>Terms agreement</td><td>Agreement is given once per developer account. You can view the agreed terms again at ONEconsole > Terms List > ONEquest Terms.</td></tr><tr><td>When approval happens</td><td>Your application is approved once your marketing budget deposit is confirmed.</td></tr></tbody></table>

Once approved, the following menus open.

<table><thead><tr><th width="182">Menu</th><th>Function</th></tr></thead><tbody><tr><td>Quest Management</td><td>Register, edit, and end quest groups and individual quests</td></tr><tr><td>Quest Statistics</td><td>Number of participants and ONEdia paid out per quest</td></tr></tbody></table>

## 4. Marketing Budget

The ONEquest budget is managed in **Credits**.

{% hint style="info" %}
To register and manage your marketing budget, please register as a “Paid Developer.”
{% endhint %}

#### How to Charge <a href="#how-to-charge" id="how-to-charge"></a>

Currently, you can charge Credits by bank transfer.

1. **Charge request:** Send your company name, developer ID, and charge amount to <devhelper@onestore.net>.
2. **Vendor registration:** If this is your first charge, also send your business registration certificate, certificate of corporate seal impression, and a copy of your bankbook. If you use a registered signature seal, please also send the seal registration form.
3. **Deposit:** Transfer the amount to the account below. Please enter the depositor name exactly as your business name.
4. **Charge complete:** After confirming the deposit, we will charge your Credits.

<table><thead><tr><th width="285.5">Deposit account</th><th>Details</th></tr></thead><tbody><tr><td>Bank</td><td>Hana Bank</td></tr><tr><td>Account number (virtual account)</td><td>549-995452-06137</td></tr><tr><td>Account holder</td><td>ONE store Co., Ltd.</td></tr><tr><td>Depositor name</td><td>Please enter the same name as your business name.</td></tr></tbody></table>

* The account above is for developers based in Korea, and **only KRW deposits are accepted.** For **developers outside Korea**, we will create a separate account and provide the details.
* There is no charge fee.
* You can charge up to 100,000,000 Credits at a time.
* Credit charges are not subject to tax invoice issuance.

#### Budget Notifications <a href="#undefined" id="undefined"></a>

We will notify you of budget registration, usage, and remaining budget through the ONEconsole message box and email.

{% hint style="warning" %}
Please do not set rewards larger than the Credits you hold.\
ONE store may stop displaying quests whose rewards exceed your Credit balance.
{% endhint %}

## 5. Quest Structure

ONEquest consists of **quest groups** and the **individual quests** inside them.

```
Quest group (e.g. "Launch Celebration Rewards" — 1 target game)
 ├─ Quest 1 : Follow on X
 ├─ Quest 2 : Pre-register
 └─ Quest 3 : Reach level 30 (in-game action)
```

* **Quest group:** A single event unit shown to users. You specify one target product.
* **Individual quest:** Each mission a user completes. Type, period, and reward are set for each quest.
* One product can be registered in multiple quest groups, but **they cannot be displayed during the same period.**

## 6. Registering a Quest Group <a href="#undefined" id="undefined"></a>

**Path:** ONEconsole > Quest Management > Register Quest Group

1. Select the target product. Only Android games that are In Registration or On Sale on ONE store Korea can be selected.
   * Currently, quests are available for **games** only. Apps will open in stages once the criteria for apps are set.
   * For products In Registration, the “Product Title” and “Main Icon” are required.
   * To offer in-game action missions, a binary must be registered. If no binary is registered, in-game actions will not be shown in the quest.
2. Enter the group title, description, and other campaign details.
3. When saved, the group is registered as **Hidden**.

<table><thead><tr><th width="179">Rule</th><th>Details</th></tr></thead><tbody><tr><td>Campaign period</td><td>The start date can be set from <strong>tomorrow</strong>, and the end date up to <strong>about 100 days later</strong>.</td></tr><tr><td>Target product</td><td><strong>Cannot be changed</strong> after registration. To use another product, create a new group.</td></tr><tr><td>Other information</td><td>Everything except the target product can be edited.</td></tr><tr><td>Deletion</td><td>Once even one individual quest is registered, the group cannot be deleted.</td></tr></tbody></table>

#### Turning On Display <a href="#turning-on-display" id="turning-on-display"></a>

All of the following conditions must be met to turn on group display.

* At least one individual quest is registered
* No other quest group for the same product is being displayed during the same period
* The target product is In Registration or On Sale on ONE store Korea

Once display is turned on, the quest goes live in the ONE store app immediately.

{% hint style="info" %}
You can keep using the same group after an event ends. \
Edit the group information, set ended quests to Hidden, and add new quests..
{% endhint %}

## 7. Registering an Individual Quest <a href="#undefined" id="undefined"></a>

**Path:** Quest group details > Add Quest

1. Select the quest type. **The type cannot be changed after registration.**
2. Set the quest period.
3. Set the rewards (reward per user, maximum reward, ONEdia validity period).
4. Enter the required information for each type (see Section 8).

#### Period <a href="#period" id="period"></a>

* You can set a period from **the day after registration for up to 100 days**.
* When editing the period, you can only change it within the same range based on the **registration date** (the day after registration up to 100 days).

#### Reward Settings <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="198.5">Item</th><th>Description</th></tr></thead><tbody><tr><td>Reward per user</td><td>Number of ONEdia one user receives for completing the quest</td></tr><tr><td>Maximum reward</td><td>Total ONEdia to be paid out for this quest. Can only be set in <strong>multiples of the reward per user</strong>. E.g. reward per user 100 → maximum reward 100, 200, 300 …</td></tr><tr><td>Maximum reward limit</td><td>Must be set within your marketing budget (Credits).</td></tr><tr><td>ONEdia validity period</td><td>Can be set up to 30 days from the payout date. Once the period passes, the user’s ONEdia expires.</td></tr></tbody></table>

* When the maximum reward has been fully paid out, users see “Rewards exhausted” and can no longer participate.

{% hint style="warning" %}
**Reward settings can only be edited before the quest starts.** \
To change them after the start, end the quest and create a new one.
{% endhint %}

## 8. Guide by Quest Type  <a href="#undefined" id="undefined"></a>

#### 8-1. Social Media Promotion (X) <a href="#x" id="x"></a>

<table><thead><tr><th width="227">Item</th><th>Details</th></tr></thead><tbody><tr><td>Supported missions</td><td>Follow, repost, and like on X</td></tr><tr><td>What developers do</td><td>Simply <strong>enter the URL</strong> of the account to follow or the post to repost/like.</td></tr><tr><td>Participation check</td><td>ONEquest handles X account linking and participation checks. No separate development is required.</td></tr><tr><td>User requirement</td><td>Users must link their X account the first time they participate. One ONE store account can link only one X account.</td></tr><tr><td>Cancellation after participating</td><td>Rewards are not reclaimed even if a user unfollows after receivin</td></tr></tbody></table>

#### 8-2. Pre-registration <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="230">Item</th><th>Details</th></tr></thead><tbody><tr><td>Prerequisite</td><td>Pre-registration must be in progress on ONE store <strong>Korea</strong>.</td></tr><tr><td>What developers do</td><td>Simply register a quest with the product that is running pre-registration. No separate development is required.</td></tr><tr><td>When rewards are paid</td><td>Rewards are paid only after the user <strong>completes pre-registration</strong> and <strong>taps [Claim Reward] in the quest</strong>. Pre-registering alone does not pay out the reward automatically.</td></tr></tbody></table>

#### 8-3. In-game Action <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="227.5">Item</th><th>Details</th></tr></thead><tbody><tr><td>Supported missions</td><td>Any mission whose completion can be verified on the game server. E.g. reaching a level, completing the tutorial, clearing a specific stage</td></tr><tr><td>What developers do</td><td>Implement two APIs on your game server (user validation and in-game action verification) and register their URLs in ONEconsole.</td></tr><tr><td>Game account identification</td><td>Verified by game account ID (UUID). If you need additional identifiers such as server information, please let us know.</td></tr><tr><td>Registration requirement</td><td>You must <strong>pass the connection test</strong> on the registration screen to register the quest.</td></tr><tr><td>User requirement</td><td>Users enter their game account ID to link it the first time they participate. The link is reused within the same quest group.</td></tr><tr><td>Game account guidance</td><td>Be sure to explain in the quest group information which value users should enter (e.g. the member number under [Settings] > Account Info in the game).</td></tr></tbody></table>

See the [ONEquest In-game Integration Guide](https://onestore-dev.gitbook.io/dev/tools/onequest) for detailed specifications.

## 9. What You Can Do During Operation

Quest Group and Product&#x20;

<table data-search="false"><thead><tr><th width="212.5">Action</th><th width="259">Allowed</th><th>How / Conditions</th></tr></thead><tbody><tr><td>Edit group information</td><td>✅ YES</td><td>All items except the target product.</td></tr><tr><td>Change target product</td><td>❌ NO</td><td>Create a new quest group.</td></tr><tr><td>Turn off group display </td><td>✅ YES</td><td></td></tr><tr><td>Edit group period</td><td>✅ YES</td><td>Within the day after registration up to 100 days, based on the current time.</td></tr><tr><td>Delete group</td><td>🏷️Only when it has no individual quests</td><td></td></tr></tbody></table>

Individual Quest

<table data-search="false"><thead><tr><th width="212.5">Action</th><th width="259">Allowed</th><th>How / Conditions</th></tr></thead><tbody><tr><td>Change quest type</td><td>❌ NO</td><td>Create a new quest.</td></tr><tr><td>Edit quest period</td><td>✅ YES</td><td>Within the day after registration up to 100 days, based on the registration date.</td></tr><tr><td>Edit rewards</td><td>🏷️Before start only</td><td>After the start, end the quest → create a new one.</td></tr><tr><td>End quest early</td><td>✅ YES</td><td>[End] button while in progress.</td></tr><tr><td>Turn off quest display</td><td>🏷️After end only</td><td>Display cannot be turned off while in progress. To stop, please end the quest.</td></tr><tr><td>Delete quest</td><td>🏷️Before start only</td><td>Quests that have started cannot be deleted.</td></tr></tbody></table>

## 10. User Participation Conditions  <a href="#undefined" id="undefined"></a>

ONEquest automatically applies the following conditions to prevent fraudulent participation. Game developers do not need to set them up.

<table data-search="false"><thead><tr><th width="183.5">Condition</th><th>Details</th></tr></thead><tbody><tr><td>Identity verification</td><td>Only ONE store members who have completed identity verification can participate.</td></tr><tr><td>Once per person</td><td>Each quest can be rewarded only once per person, based on identity verification. The same person cannot receive it again even with a different ONE store ID.</td></tr><tr><td>Once per device</td><td>Each quest can be rewarded only once on the same device, even with different identity verification.</td></tr><tr><td>App players</td><td>Participation is not possible on PC app players (emulators).</td></tr><tr><td>Restricted members</td><td>Members restricted from ONE store marketing participation cannot participate.</td></tr><tr><td>Campaign period</td><td>Users can participate only during the quest period.</td></tr><tr><td>Adult-only games</td><td>Quest groups are not shown to users under 19.</td></tr><tr><td>Target product status</td><td>If the product becomes Suspended or Unavailable for Sale, or distribution to Korea is turned off, the quest is automatically hidden.</td></tr><tr><td>Result reflection</td><td>For some quests, it can take up to 2 hours for participation results to be reflected.</td></tr></tbody></table>

## 11. What Users See <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="192">Screen</th><th>Details</th></tr></thead><tbody><tr><td>Benefits · My > ONEquest</td><td>List of quest groups in progress, along with the number of quests in progress and the maximum ONEdia reward. Ended quests also remain in the list.</td></tr><tr><td>Quest group details</td><td>Shows the target game, individual quests, completion rate, number of participants, and ONEdia paid out. Users participate here.</td></tr><tr><td>Product details</td><td>Quests in progress are shown, and tapping them opens the quest group details.</td></tr><tr><td>Quest status</td><td>Completed, exhausted, and ended quests are marked as “Ended”.</td></tr></tbody></table>

Common notices managed by ONE store are automatically shown at the bottom of the quest group details.

## 12. Preview and Testing <a href="#undefined" id="undefined"></a>

* You can check registered quest groups and quests from the user’s view with **Preview**.
* For **in-game actions**, the connection test on the registration screen checks actual API calls and the response format.
* A test feature that pays out actual ONEdia is not provided.

## 13. Statistics and Automatic Notifications <a href="#undefined" id="undefined"></a>

#### Statistics <a href="#undefined" id="undefined"></a>

**Path:** ONEconsole > Quest Statistics

You can check the number of rewards paid out and the ONEdia paid by period and by quest group.

#### Automatic Notifications (ONEconsole Message Box) <a href="#automatic-notifications-oneconsole-message-box" id="automatic-notifications-oneconsole-message-box"></a>

| When                                                | Notification        |
| --------------------------------------------------- | ------------------- |
| 3 days before quest start, on the start day         | Quest start notice  |
| 9 AM one day before the end, at the end             | Quest end notice    |
| When 50% · 80% · 100% of the maximum reward is used | Reward usage notice |

## 14. Applying for Featuring (Extra Exposure) <a href="#undefined" id="undefined"></a>

Quests in progress appear in ONEquest under \[Benefits] and \[My] in the ONE store app. Featured quests appear on more screens.

**How to apply:** Send your game and quest introduction materials via [\[Contact Us\] > \[Marketing\] > \[ONEquest\]](https://dev.onestore.net/dev/help/contact?categoryId=QNA40001). We will review them and get back to you.

## 15. Operating Policies <a href="#undefined" id="undefined"></a>

#### Display Restrictions <a href="#display-restrictions" id="display-restrictions"></a>

In the following cases, ONE store may stop displaying a quest without prior notice and revoke ONEquest approval. We will notify the game developer after taking action.

* Adult-oriented, speculative, or gambling-related quests
* Violations of ONE store operating policies
* Rewards set higher than the Credits you hold

#### Game Transfer <a href="#game-transfer" id="game-transfer"></a>

* Even if a game is transferred to another developer account, **quest information is not transferred with it.**
* If there are quests scheduled or in progress, please **end or delete all of them** before the transfer.
