> 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/webshop/implementation.md).

# 웹샵 활용 가이드

## 적용 가이드

### 1. 원웹샵이란?

원웹샵(ONE webshop)은 개발사가 **웹 환경에서 게임 아이템을 판매**할 수 있도록 원스토어가 제공하는 공식 웹샵 서비스입니다.

* 원웹샵은 인앱결제를 대체하는 수단이 아니라, 개발사가 자체 채널에서 새로운 커머스 경험을 확장할 수 있도록 지원하는 보완적 판매 채널입니다.
* 원웹샵 상품 URL은 개발사의 자체 마케팅 채널은 물론, 원스토어 유통앱 내에서도 링크 연동이 가능하여 다양한 접점에서 유저 전환을 지원합니다

#### 주요 특징

* 개발사의 자체 마케팅 채널은 물론, 원스토어 유통앱 내에서도 링크 연동 가능
* **낮은 수수료로** PG 수수료 포함 결제 제공
* PC, Android, iOS 등 모든 브라우저 환경에서 구매 가능
* 인앱결제와 동일한 서버 규격으로 빠른 연동
* 개발자센터에서 등록/검증/정산/CS를 원스톱 관리

#### 웹샵 상세 페이지 URL

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

개발사는 위 URL을 자체 마케팅 채널(인게임, 공식 사이트, 커뮤니티 등)에서 활용할 수 있습니다.

### 2. 인앱결제 상점과 웹샵의 올바른 배치

웹샵 진입 경로는 게임앱 내에서 직접 제공할 수 있습니다. 단, 다음 원칙을 반드시 지켜야 합니다.

{% hint style="danger" %}
**핵심 원칙**

* 인앱결제가 연동된 상점 페이지에서 웹샵 이동 경로 및 상품을 직접 노출하는 것은 **허용되지 않습니다**.
* 웹샵 이동 경로는 인앱결제 상점과 **기능적으로 분리된 별도의 진입 경로**로 구성해야 합니다.
  {% endhint %}

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

### 3. 웹샵 상점 눌렀을때 올바른 동선

게임 내 웹샵 버튼 클릭 시, 원스토어 웹샵의 ‘타이틀 상세 페이지’를 호출하는 방식으로 구현해야 합니다.

{% hint style="danger" %}
**핵심 원칙**

* 웹샵 내 특정 아이템을 직접 게임앱 내에 노출/전시 불가
  {% endhint %}

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

#### 허용되는 유도 방식

인앱결제 상점 외부 영역이라면, 다음과 같은 형태로 자유롭게 구현할 수 있습니다:

* 버튼 (예: "웹샵 바로가기")
* 텍스트 링크
* 팝업 / 다이얼로그
* 메뉴 항목
* 배너 이미지 등

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

### 4. 사용자 경험 최적화 팁

* 웹샵 진입 전('웹샵 버튼 클릭'과 '웹샵 상세 페이지' 사이), 간단한 안내 팝업을 제공하는 것을 권장합니다.
* 원웹샵은 게임 내에서 웹샵으로 이동 시, **게임 ID를 자동으로 연동**하여 별도의 게임 ID 입력 없이 바로 구매할 수 있는 기능을 제공합니다. 상세 연동 방법은 [사용자 정보 연동](/dev/tools/webshop/app-links.md) 가이드를 참고하세요.

{% hint style="danger" %}
**개인정보 관련 안내**

게임의 개인정보처리방침에 따라 게임 ID가 개인정보에 해당할 경우, **개인정보 제3자 제공 동의** 메시지를 추가해야 할 수 있습니다. 개발사의 개인정보처리방침과 관련 법령을 확인하세요.
{% endhint %}

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

### 5. 웹샵 상세 페이지 활용하기

원웹샵 상세 페이지에서 개발사가 활용할 수 있는 기능을 안내합니다.

#### 5-1. 상단 배너 영역

게임의 대표 이미지 또는 프로모션 이미지를 등록할 수 있습니다. 다음과 같은 용도로 활용하세요:

* 웹샵 추천 상품 안내
* 프로모션 / 시즌 이벤트 배너
* 한정 판매 안내

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

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

#### 5-2. 아이템별 뱃지 및 할인 가격 노출

* 아이템별로 짧은 설명 문구를 추가하여 상품의 가치를 효과적으로 전달할 수 있습니다.
* 개발사가 강조하고 싶은 상품에 뱃지를 노출할 수 있습니다.

| 뱃지 유형    | 용도             |
| -------- | -------------- |
| **New**  | 신규 등록 아이템 강조   |
| **Best** | 인기 / 추천 아이템 강조 |

* 정가와 판매가를 각각 설정하면, 정가에 취소선이 적용되고 할인가가 강조 표시됩니다.

```
예시:
정가: 12,000원  →  판매가: 9,600원 (20% 할인)
```

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

### 6. 구매 횟수 제한 처리

웹샵에서는 게임 내 구매 가능 여부를 직접 확인할 수 없습니다. 대신, 개발사가 API 응답을 통해 구매 불가 상태를 처리할 수 있습니다.

#### 6-1. 처리 흐름

1. 유저가 웹샵에서 게임 ID / 서버를 입력하고 구매를 시도합니다.
2. 원웹샵이 개발사 서버로 구매 요청을 전송합니다.
3. 개발사 서버에서 구매 불가로 판단한 경우, **상태코드 `1001`**&#xACFC; 함께 노출 희망 문구를 반환합니다.
4. 원웹샵이 해당 메시지를 유저에게 노출합니다.

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

#### 6-2. API 응답 예시

```
{
  "result.code": "1001",
  "result.message": "해당 계정에서 구매 가능한 횟수를 초과하였습니다."
}
```

#### 6-3. 권장 메시지 예시

| 상황            | 권장 메시지                        |
| ------------- | ----------------------------- |
| 구매 횟수 초과      | "해당 계정에서 구매 가능한 횟수를 초과하였습니다." |
| 이미 구매한 일회성 상품 | "이미 구매한 상품입니다."               |
| 이벤트 종료        | "이벤트 기간이 종료된 상품입니다."          |

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

#### 6-4. 아이템 설명에 사전 안내 (권장)

구매 전 혼선을 줄이기 위해, 아이템 설명 영역에 구매 횟수 제한을 미리 명시하는 것을 권장합니다.

{% hint style="info" %}
**예시**

* "계정당 1회 구매 가능"
* "일일 3회 구매 제한"
* "서버당 월 5회 구매 가능"
  {% endhint %}

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

## 외부 홍보 가이드

* 원웹샵의 실적은 외부 홍보 여부에 따라 크게 달라집니다. 게임 내 연동만으로는 이용자가 웹샵의 존재를 인지하기 어렵기 때문에, 게임 바깥에서 적극적으로 알리는 활동이 필수적입니다.
* 본 가이드에서는 공지/배너/외부 매체를 활용한 홍보 방법을 안내합니다.
* 특히 "공지의 활용"은 원웹샵 적용 개발사의 필수 수행 사항입니다. 공식 커뮤니티 공지는 추가 비용 없이 기존 이용자에게 웹샵을 알릴 수 있는 가장 효과적인 수단입니다. 원웹샵 적용 후 반드시 공지를 통해 이용자에게 안내해 주세요.

### 1. 공지의 활용 <a href="#id-_-_v2-1" id="id-_-_v2-1"></a>

웹샵 홍보 공지에는 아래 항목을 함께 안내해야 이용자의 방문과 전환이 높아집니다.

#### 1-1. 공지 내 포함해야 할 콘텐츠 <a href="#id-_-_v2-1-1" id="id-_-_v2-1-1"></a>

1. 웹샵 전용 혜택: 전용 상품 또는 웹샵에서의 혜택을 명확히 전달 (e.g. 웹샵에서만 판매하는 아이템, 20% 재화 추가 지급 등)
2. 웹샵 접속 링크: `https://webshop.onestore.net/title/{PID}` 형식의 직접 링크 제공
3. (필요 시) 원스토어 빌드 다운로드 안내: 게임 내에서 원웹샵 연결 동선을 제공한 게임콘텐츠가 원스토어에 업로드 되어있다면, 원스토어 내 게임 설치 링크 함께 안내

#### 1-2. 공지 위치 및 방식 <a href="#id-_-_v2-1-2" id="id-_-_v2-1-2"></a>

* 고정 공지: 커뮤니티 상단에 원웹샵 안내를 **상시 고정**하여 신규/기존 이용자 모두에게 지속 노출
  * e.g. \[상시] 원웹샵 바로가기 및 대표 혜택
* 이벤트 공지: 업데이트·시즌·신규 콘텐츠 출시 등 이벤트에 웹샵 혜택을 **병행 안내**
  * e.g. \[기간한정] 원웹샵 전용 패키지 오픈
* 운영 콘텐츠 포함하는 방식: 주간 소식, GM 메시지, 쿠폰 배포 글 등 **일상적 운영 콘텐츠**에 웹샵 링크를 자연스럽게 삽입하여 피로도 없이 반복 노출
  * e.g. 주간 운영소식 하단에 웹샵 링크 추가

#### 1-3. 상황별 안내 문구 예시 <a href="#id-_-_v2-1-3" id="id-_-_v2-1-3"></a>

1. 상시 안내형: *"공식 원웹샵에서는 전용 상품과 다양한 추가 혜택을 확인하실 수 있습니다. 보다 많은 혜택을 원하시는 이용자께서는 아래 링크를 통해 확인해 주세요."*
2. 혜택 강조형: *"원웹샵에서는 공식 채널 전용 혜택이 포함된 특별 상품을 제공하고 있습니다. 추가 보상 및 특별 구성 상품을 확인해 보세요."*
3. 이벤트 연계형: *"업데이트를 기념하여 원웹샵에서 특별 구성 상품 및 추가 혜택을 제공합니다. 웹샵 전용 혜택을 아래에서 확인해 주세요."*
4. 마감 임박형: *"현재 운영 중인 원웹샵 특별 혜택이 곧 종료될 예정입니다. 기간 한정 상품 및 보상을 놓치지 마세요!"*

***

### 2. 배너의 활용 <a href="#id-_-_v2-2" id="id-_-_v2-2"></a>

커뮤니티·공식 홈페이지·앱 등록정보 등에 배너를 배치하면 이용자가 별도 탐색 없이 웹샵에 접근할 수 있습니다.

#### 2-1. 배너 제작 시 포함 소재 <a href="#id-_-_v2-2-1" id="id-_-_v2-2-1"></a>

배너 및 외부 광고 소재에는 **“Shop on ONE webshop” 뱃지**를 함께 노출하여, 원웹샵이 공식 판매 채널임을 이용자에게 전달해 주세요.

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

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

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

#### 2-2. 배너 클릭 시 연동 방식 <a href="#id-_-_v2-2-2" id="id-_-_v2-2-2"></a>

1. 원웹샵으로 직접 이동: 배너 클릭 시 원웹샵 URL(`https://webshop.onestore.net/title/{PID}`)로 즉시 이동하도록 링크 연동
2. 다른 페이지 경우: 이벤트 페이지·공지 페이지 등으로 이동하는 경우, 해당 페이지 내에 **원웹샵 접속 링크와 접속 방법 안내**를 반드시 포함
   1. *예) “아래 링크를 통해 원웹샵에서 특별 패키지를 확인해 보세요” + 웹샵 URL*

#### **2-3 배너 제작 및 배치 예시** <a href="#id-_-_v2-2-3" id="id-_-_v2-2-3"></a>

| 배너 제작 문구 예시                                                                                                                                                           | 배너 배치 예시                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <ul><li>바로가기형: <em>"원웹샵 바로가기" / "공식 웹샵 방문하기"</em></li><li>혜택 강조형: <em>"웹샵 전용 혜택 확인하기" / "특별 패키지 보러가기"</em></li><li>이벤트 연계형: <em>"\[업데이트 기념] 원웹샵 특별 혜택"</em></li></ul> | <ul><li>커뮤니티 상단 메인 배너 / 사이드 배너</li><li>커뮤니티 외부 링크 모음 영역</li><li>공지사항 하단 버튼 영역</li><li>공식 홈페이지 / 앱 등록정보</li></ul> |

***

### 3. 외부 매체의 활용 <a href="#id-_-_v2-3" id="id-_-_v2-3"></a>

배너 또는 제작한 소재들을 활용하여 다양한 SNS 및 외부 채널에 웹샵을 노출할 수 있습니다.

#### 3-1. 커뮤니티 채널별 활용 방법 <a href="#id-_-_v2-3-1" id="id-_-_v2-3-1"></a>

* Discord: #announcement 채널에 웹샵 바로가기 링크 고정, 업데이트/시즌 공지 시 웹샵 혜택 병행 안내, Discord 한정 쿠폰 배포로 웹샵 방문 유도
* 외부 커뮤니티: 공식 운영진(CM) 명의 공지로 웹샵 오픈/혜택 안내, 게시글 내 웹샵 직접 링크 포함
* X(Twitter) / Instagram: 웹샵 오픈·특별 혜택·기간 한정 프로모션을 이미지/카드 형식으로 게시, 웹샵 링크 삽입
* YouTube 등: 콘텐츠 소개 영상 내 웹샵 안내, 영상 설명란에 웹샵 링크 또는 쿠폰 코드 배치

#### 3-2. 광고 성과 측정 방법 <a href="#id-_-_v2-3-2" id="id-_-_v2-3-2"></a>

외부 광고 집행 시 광고 성과를 측정하기 위해 트래킹 코드(UTM 파라미터, 픽셀 등)를 삽입해야 하는 경우가 있습니다. 현재 개발자센터에서는 웹샵 페이지에 트래킹 코드를 직접 입력하는 기능이 제공되지 않으므로, **트래킹 코드 설정이 필요한 경우 원스토어로 별도 요청**해 주세요.

| **요청 방법**      | 이메일로 요청                                                                                         |
| -------------- | ----------------------------------------------------------------------------------------------- |
| **연락처**        | <devhelper@onestore.net>                                                                        |
| **요청 시 포함 정보** | <p>- 게임명 / PID<br>- 광고 매체 (Google Ads, Meta Ads 등)<br>- 트래킹 코드 종류 (UTM, 픽셀 등)<br>- 적용 희망 시점</p> |

#### 3-3. 커뮤니티 활용 사례 예시 <a href="#id-_-_v2-3-3" id="id-_-_v2-3-3"></a>

* **수집형 'P'게임** - 이벤트날 커뮤니티 내 운영자가 공지 시 “웹샵 전용 박스” 언급, 웹 전용 보너스 코인 지속 안내
* **'M' 카드게임** - Discord에서 웹샵 리뉴얼 대대적 공지, “WEB EXCLUSIVE” 상품 강조
* **대전형 'C'게임** - 게임사 커뮤니티 이벤트 진행 시 웹샵 방문 & 무료 보상 제공 → 광고 집행
* **RPG 'G'게임** - 외부 커뮤니티에서 게임사 계정을 통해 웹샵 전용 이벤트, 상점 안내

<br>