# Webshop Promotion Guide

## Implementation Guide

### 1. What is ONE Webshop?

ONE Webshop is an official web-based storefront service provided by ONE store that enables developers to **sell game items through a web environment**.

* ONE Webshop is not a replacement for in-app purchases. It is a complementary sales channel that allows developers to extend their commerce experience through their own channels.
* The ONE Webshop product URL can be linked not only through the developer's own marketing channels but also within the ONE store distribution app, supporting user conversion across various touchpoints.

#### Key Features <a href="#onewebshopintegrationguide-english-keyfeatures" id="onewebshopintegrationguide-english-keyfeatures"></a>

* Link integration available through developer marketing channels and the ONE store distribution app
* **Low commission** with PG fees included
* Accessible from any browser on PC, Android, and iOS
* Quick integration using the same server API specification as in-app purchases
* One-stop management of registration, review, settlement, and CS through Developer Center

  <br>

#### Webshop Detail Page URL <a href="#onewebshopintegrationguide-english-webshopdetailpageurl" id="onewebshopintegrationguide-english-webshopdetailpageurl"></a>

```
https://webshop.onestore.net/title/{PID}
```

Developers can use this URL across their own marketing channels (in-game, official website, community, etc.).

### 2. Correct Placement of IAP Store and Webshop

The webshop entry point can be provided directly within the game app. However, the following principle must be strictly observed.

{% hint style="danger" %}
**Key Principle**

* Displaying webshop navigation paths or products **within the in-app purchase store page** is not allowed.
* The webshop entry point must be configured as a **separate path, functionally independent** from the in-app purchase store.
  {% endhint %}

<figure><img src="/files/IhQAVo7AP10JvjV7wyyl" alt=""><figcaption></figcaption></figure>

### 3. Correct Navigation When Entering the Webshop

When clicking the webshop button in-game, it must be implemented by calling the ONE Webshop title detail page.

{% hint style="danger" %}
**Key Principle**

* Directly displaying or listing specific webshop items within the game app is not allowed.
  {% endhint %}

<figure><img src="/files/OhskhtLQyqqXZrr5W6G5" alt=""><figcaption></figcaption></figure>

#### Allowed Navigation Methods

Outside of the IAP store, the following formats may be freely used:

* Button (e.g., Go to Webshop)
* Text link
* Popup / Dialog
* Menu item
* Banner image, etc.

<figure><img src="/files/9oX1O8DNZ3RrVqSRjPQT" alt=""><figcaption></figcaption></figure>

### 4. UX Optimization Tips

* We recommend providing a brief transition popup before navigating to the webshop (between the Webshop button click and the Webshop detail page).
* ONE Webshop supports **automatic game ID linking** when navigating from the game to the webshop, allowing users to purchase without manually entering their game ID. For detailed integration instructions, refer to [User Information Integration](broken://pages/EypKAdTiJXLpqs6gwAIn) guide.

{% hint style="danger" %}
**Privacy Notice**

If the game ID constitutes personal information under your privacy policy, you may need to add a **third-party data sharing consent** message. Please review your privacy policy and applicable regulations.
{% endhint %}

<figure><img src="/files/Fg02zNtP4wo2enU1ymnH" alt=""><figcaption></figcaption></figure>

### 5. Utilizing the Webshop Detail Page

This section describes the features available on the ONE Webshop detail page that developers can leverage.

#### 5-1. Top Banner Area

You can register a representative game image or promotional image. Use this area for:

* Featured webshop item announcements
* Promotion / seasonal event banners
* Limited-time sale notices

<figure><img src="/files/YWM6YUri7qOy1wxLCyQd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Cjtujuns1IxxJ2KU1NuD" alt=""><figcaption></figcaption></figure>

#### 5-2. Item Badges and Discount Pricing <a href="#onewebshopintegrationguide-english-5-2.itembadgesanddiscountpricing" id="onewebshopintegrationguide-english-5-2.itembadgesanddiscountpricing"></a>

* Add short descriptions to each item to effectively communicate its value to users.
* Highlight featured products with badges.

| Badge Type | Purpose                               |
| ---------- | ------------------------------------- |
| **New**    | Highlight newly registered items      |
| **Best**   | Highlight popular / recommended items |

* Set both a regular price and a sale price. The regular price will be displayed with a strikethrough, and the discounted price will be highlighted.

```
Example:
Regular price: 12,000 KRW  ->  Sale price: 9,600 KRW (20% off)
```

<figure><img src="/files/W8p3IvGnqh81laSzoyyM" alt=""><figcaption></figcaption></figure>

### 6. Handling Purchase Limits <a href="#onewebshopintegrationguide-english-6.handlingpurchaselimits" id="onewebshopintegrationguide-english-6.handlingpurchaselimits"></a>

The webshop cannot directly verify in-game purchase eligibility. Instead, developers can handle purchase restrictions through API responses, refer to [User Validation](broken://pages/EXLmyhStUcOzoGSTYXyg) guide.

#### 6-1. Flow <a href="#onewebshopintegrationguide-english-6-1.flow" id="onewebshopintegrationguide-english-6-1.flow"></a>

1. User enters their game ID / server and attempts a purchase on the webshop.
2. ONE Webshop sends a purchase request to the developer server.
3. If the developer server determines the purchase is not allowed, it returns **status code `1001`** with a display message.
4. ONE Webshop displays the message to the user.

<figure><img src="/files/R6JpDZcXgokOKJVZr4hu" alt=""><figcaption></figcaption></figure>

#### 6-2. API Response Example <a href="#onewebshopintegrationguide-english-6-2.apiresponseexample" id="onewebshopintegrationguide-english-6-2.apiresponseexample"></a>

```
{
  "result.code": "1001",
  "result.message": "해당 계정에서 구매 가능한 횟수를 초과하였습니다." //You have exceeded the maximum number of purchases for this account.
}
```

#### 6-3. Recommended Messages <a href="#onewebshopintegrationguide-english-6-3.recommendedmessages" id="onewebshopintegrationguide-english-6-3.recommendedmessages"></a>

| Scenario                        | Recommended Message                                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Purchase limit exceeded         | <p>You have exceeded the maximum number of purchases for this account.<br>("해당 계정에서 구매 가능한 횟수를 초과하였습니다.")</p> |
| One-time item already purchased | <p>This item has already been purchased.<br>("이미 구매한 상품입니다.")</p>                                             |
| Event expired                   | This promotional item is no longer available.("이벤트 기간이 종료된 상품입니다.")                                           |

<figure><img src="/files/xjHFDw6XiBOcJCepz91h" alt=""><figcaption></figcaption></figure>

#### 6-4. Pre-Purchase Notice in Item Description (Recommended) <a href="#onewebshopintegrationguide-english-6-4.pre-purchasenoticeinitemdescription-recommended" id="onewebshopintegrationguide-english-6-4.pre-purchasenoticeinitemdescription-recommended"></a>

To reduce confusion before purchase, we recommend stating purchase limits in the item description field.

{% hint style="info" %}
**Examples**

* Limit 1 per account
* Daily purchase limit: 3
* 5 purchases per server per month
  {% endhint %}

<figure><img src="/files/jdfdgv54AMP84EJYDRdf" alt=""><figcaption></figcaption></figure>

## External Promotion Guide <a href="#onewebshoppromotionguide_en-integrationguide_v2-onewebshopexternalpromotionguide" id="onewebshoppromotionguide_en-integrationguide_v2-onewebshopexternalpromotionguide"></a>

* ONE webshop performance **varies significantly depending on external promotion efforts.** Since users are unlikely to become aware of the webshop through in-game integration alone, active promotion outside the game is essential.
* This guide covers promotion methods using announcements, banners, and external media.
* In particular, **“Utilizing Announcements” is a mandatory action** for developers who have integrated ONE webshop. Official community announcements are the most effective way to inform existing users about the webshop at no additional cost. After integrating ONE webshop, be sure to notify users through announcements.

### 1. Utilizing Announcements <a href="#onewebshoppromotionguide_en-integrationguide_v2-1.utilizingannouncements" id="onewebshoppromotionguide_en-integrationguide_v2-1.utilizingannouncements"></a>

Including the following items in your webshop promotion announcements will increase user visits and conversions.

#### 1-1. Content to Include in Announcements <a href="#onewebshoppromotionguide_en-integrationguide_v2-1-1.contenttoincludeinannouncements" id="onewebshoppromotionguide_en-integrationguide_v2-1-1.contenttoincludeinannouncements"></a>

1. **Webshop-exclusive benefits:** Clearly communicate exclusive products or webshop benefits (e.g., items sold only on the webshop, 20% bonus in-game currency, etc.)
2. **Webshop access link:** Provide a direct link in the format `https://webshop.onestore.net/title/{PID}`
3. **(If applicable) ONE store build download guide:** If the game content that provides an in-game path to ONE webshop has been uploaded to ONE store, include the game installation link on ONE store as well

#### 1-2. Announcement Placement & Methods <a href="#onewebshoppromotionguide_en-integrationguide_v2-1-2.announcementplacement-and-methods" id="onewebshoppromotionguide_en-integrationguide_v2-1-2.announcementplacement-and-methods"></a>

* **Pinned announcement:** **Permanently pin** the ONE webshop guide at the top of the community for continuous exposure to both new and existing users
  * e.g., \[Pinned] ONE webshop Quick Access & Key Benefits
* **Event announcement:** Include webshop benefits **alongside** updates, seasonal events, and new content releases
  * e.g., \[Limited Time] ONE webshop Exclusive Package Open
* **Embedded in operational content:** Naturally insert webshop links into **routine operational content** such as weekly newsletters, GM messages, and coupon distribution posts for repeated exposure without fatigue
  * e.g., Add webshop link at the bottom of weekly updates

#### 1-3. Example Copy by Scenario <a href="#onewebshoppromotionguide_en-integrationguide_v2-1-3.examplecopybyscenario" id="onewebshoppromotionguide_en-integrationguide_v2-1-3.examplecopybyscenario"></a>

1. **Evergreen notice:** *“Explore exclusive products and various bonus rewards on the official ONE webshop. For more benefits, please check the link below.”*
2. **Benefit-focused:** *“The ONE webshop offers special products with exclusive official channel benefits. Discover the bonus rewards and special bundle items now.”*
3. **Event-linked:** *“To celebrate the update, special bundle items and bonus rewards are available on the ONE webshop. Check out the webshop-exclusive benefits below.”*
4. **Urgency/Deadline:** *“The current ONE webshop special offer is ending soon. Don’t miss out on the limited-time items and rewards!”*

***

### 2. Utilizing Banners <a href="#onewebshoppromotionguide_en-integrationguide_v2-2.utilizingbanners" id="onewebshoppromotionguide_en-integrationguide_v2-2.utilizingbanners"></a>

Placing banners on communities, official websites, and app store listings allows users to access the webshop without additional navigation.

#### 2-1. Materials to Include in Banners <a href="#onewebshoppromotionguide_en-integrationguide_v2-2-1.materialstoincludeinbanners" id="onewebshoppromotionguide_en-integrationguide_v2-2-1.materialstoincludeinbanners"></a>

Include the **“Shop on ONE webshop” badge** in banners and external ad creatives to communicate to users that ONE webshop is an official sales channel.

{% file src="/files/zCvLXxlHtr0mjN9KHgYg" %}

{% file src="/files/OBd0BeWsIvHVElVRWBnn" %}

| Theme           | Badge                                                               | BI                                                                  |
| --------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **White Theme** | <img src="/files/67IvAhBTshFULEGWjRe8" alt="" data-size="original"> | <img src="/files/exKM0TIZCZNRfOUIxW1p" alt="" data-size="original"> |
| **Dark Theme**  | ![](/files/SBW0KH8Pmh82yvrCXc1k)                                    | <img src="/files/q2Rc1fbaqLeSQNRTq13b" alt="" data-size="original"> |

#### 2-2. Banner Click Behavior <a href="#onewebshoppromotionguide_en-integrationguide_v2-2-2.bannerclickbehavior" id="onewebshoppromotionguide_en-integrationguide_v2-2-2.bannerclickbehavior"></a>

1. **Direct link to ONE webshop:** Link the banner click to the ONE webshop URL (`https://webshop.onestore.net/title/{PID}`) for immediate access
2. **Via another page:** If the banner leads to an event page or announcement page, make sure that page includes the **ONE webshop access link and instructions**
   1. *e.g., “Check out the special packages on the ONE webshop via the link below” + Webshop URL*

#### **2-3. Banner Copy & Placement Examples** <a href="#onewebshoppromotionguide_en-integrationguide_v2-2-3.bannercopy-and-placementexamples" id="onewebshoppromotionguide_en-integrationguide_v2-2-3.bannercopy-and-placementexamples"></a>

| Banner Copy Examples                                                                                                                                                                                                                                                            | Banner Placement Examples                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <ul><li>Direct access: <em>“Go to ONE webshop” / “Visit the Official Webshop”</em></li><li>Benefit-focused: <em>“Check Webshop-Exclusive Benefits” / “View Special Packages”</em></li><li>Event-linked: <em>“\[Update Celebration] ONE webshop Special Benefits”</em></li></ul> | <ul><li>Main banner / side banner at the top of the community</li><li>External links section of the community</li><li>Button area below announcements</li><li>Official website / app store listing page</li></ul> |

***

### 3. Utilizing External Media <a href="#onewebshoppromotionguide_en-integrationguide_v2-3.utilizingexternalmedia" id="onewebshoppromotionguide_en-integrationguide_v2-3.utilizingexternalmedia"></a>

Use banners or other prepared creatives to promote the webshop across various SNS and external channels.

#### 3-1. Community Channel Usage <a href="#onewebshoppromotionguide_en-integrationguide_v2-3-1.communitychannelusage" id="onewebshoppromotionguide_en-integrationguide_v2-3-1.communitychannelusage"></a>

* **Discord:** Pin a webshop link in the #announcement channel; include webshop benefits in update/season announcements; distribute Discord-exclusive coupons to drive webshop visits
* **External communities:** Post webshop launch/benefit announcements under the official CM name; include direct webshop links in posts
* **X(Twitter) / Instagram:** Post webshop launches, special benefits, and limited-time promotions in image/card format; include webshop links
* **YouTube, etc.:** Mention the webshop in content introduction videos; place webshop links or coupon codes in video descriptions

#### 3-2. Ad Performance Measurement <a href="#onewebshoppromotionguide_en-integrationguide_v2-3-2.adperformancemeasurement" id="onewebshoppromotionguide_en-integrationguide_v2-3-2.adperformancemeasurement"></a>

When running external ads, you may need to insert tracking codes (UTM parameters, pixels, etc.) to measure ad performance. Since the Developer Center does not currently provide a feature to directly enter tracking codes on webshop pages, please **contact ONE store separately to set up tracking codes.**

| **How to Request**         | Request via email                                                                                                                                  |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Contact**                | <devhelper@onestore.net>                                                                                                                           |
| **Information to Include** | <p>- Game name / PID<br>- Ad platform (Google Ads, Meta Ads, etc.)<br>- Tracking code type (UTM, Pixel, etc.)<br>- Desired implementation date</p> |

#### 3-3. Community Promotion Case Studies <a href="#onewebshoppromotionguide_en-integrationguide_v2-3-3.communitypromotioncasestudies" id="onewebshoppromotionguide_en-integrationguide_v2-3-3.communitypromotioncasestudies"></a>

* **Collection ‘P’ Game** – During events, community managers mention “Webshop Exclusive Box” in announcements; continuously promote web-exclusive bonus coins
* **Card ‘M’ Game** – Major webshop renewal announcements on Discord; emphasizes “WEB EXCLUSIVE” products
* **MOBA ‘C’ Game** – Offers webshop visits & free rewards during community events → followed by ad campaigns
* **RPG ‘G’ Game** – Promotes webshop-exclusive events and store information through the game’s account on external communities


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://onestore-dev.gitbook.io/dev/chi/webshop/implementation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.