> 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/quest/onequest.md).

# ONEquest  운영가이드

ONEquest(원퀘스트)는 게임사가 원하는 시점에, 목표에 맞는 퀘스트를 직접 만들어 원스토어 이용자의 게임 참여를 이끌어 내는 마케팅 도구입니다.

퀘스트 설계, 일정, 예산, 운영을 모두 게임사가 ONEconsole에서 직접 관리합니다. 현재는 **게임**만 퀘스트를 진행할 수 있습니다. 앱은 진행 기준을 정한 뒤 순차적으로 오픈할 예정입니다. 이 문서는 신청부터 퀘스트 종료까지 게임사가 알아야 할 내용을 순서대로 안내합니다.

{% hint style="info" %}
인게임 액션 퀘스트를 운영하려면 게임 서버 연동이 필요합니다. \
연동 방법은 [ONEquest 인게임 연동 가이드](https://onestore-dev.gitbook.io/dev/tools/onequest)를 확인해 주세요.
{% endhint %}

## 1. 한눈에 보기

<table data-search="false"><thead><tr><th width="133">항목</th><th>내용</th></tr></thead><tbody><tr><td>대상 상품</td><td><ul><li><p>원스토어 <strong>대한민국</strong>에 <strong>등록중</strong> 또는 <strong>판매중</strong>인 Android 게임입니다.</p><ul><li>현재는 게임 기반으로 퀘스트를 진행할 수 있습니다. </li><li>등록중 상태인 경우 “상품 제목”, “대표 아이콘”과 "이용등급"이 필수입니다.</li><li>인게임 액션 미션을 제공하려면 바이너리가 등록되어 있어야 합니다.</li></ul></li></ul></td></tr><tr><td>참여 환경</td><td><ul><li>원스토어 Android 앱에서 제공됩니다.</li><li>원퀘스트 글로벌 웹에서 퀘스트를 진행하려면 문의하기로 문의해 주세요.<br><a href="https://www.onechain.nexus/quest">원퀘스트 글로벌 웹 바로가기</a></li></ul></td></tr><tr><td>퀘스트 타입</td><td><ul><li>소셜미디어 홍보(X: 트위터), 사전예약, 인게임 액션에서 선택할 수 있습니다.</li></ul></td></tr><tr><td>보상</td><td><ul><li>원스토어에서 게임·앱을 결제할 때 사용할 수 있는 원다이아를 지급합니다.</li><li>1다이아는 1원의 가치를 가집니다.</li></ul></td></tr><tr><td>수수료</td><td><ul><li>별도의마케팅 수수료는가없습니다.</li></ul></td></tr><tr><td>노출 위치</td><td><ul><li>원스토어 앱 [혜택]과 [마이]의 원퀘스트에 노출됩니다.</li><li>피쳐드 되면 더 다양한 화면에 노출됩니다.</li></ul></td></tr><tr><td>피쳐드 문의</td><td><ul><li><a href="https://dev.onestore.net/dev/help/contact?categoryId=QNA40001">[문의하기] > [마케팅] > [원퀘스트]</a>로 문의해 주세요.</li></ul></td></tr></tbody></table>

## 2. 이용 절차

<table><thead><tr><th width="125.5">단계</th><th width="429.5">하는 일</th><th>주체</th></tr></thead><tbody><tr><td>1. 신청</td><td>ONEconsole에서 원퀘스트 신청서를 작성하고 약관에 동의</td><td>게임사</td></tr><tr><td>2. 예산 충전</td><td>진행 규모를 협의하고 마케팅 예산(크레딧)을 계좌로 입금</td><td>게임사 · 원스토어</td></tr><tr><td>3. 승인</td><td>입금을 확인한 뒤 원스토어가 신청을 승인</td><td>원스토어</td></tr><tr><td>4. 퀘스트 등록</td><td>퀘스트 그룹과 개별 퀘스트를 등록하고 미리보기로 확인</td><td>게임사</td></tr><tr><td>5. 노출·진행</td><td>노출을 켜면 원스토어 앱에 퀘스트가 공개되고 이용자가 참여</td><td>게임사</td></tr><tr><td>6. 종료</td><td>종료일이 되거나 직접 종료하면 퀘스트가 마감되며, 통계 확인</td><td>게임사</td></tr></tbody></table>

## 3. 신청하기

**경로:** ONEconsole > 마케팅 > 원퀘스트 신청하기

{% hint style="warning" %}
퀘스트를 진행할 게임이 등록된 ONEconsole 개발자 계정으로 신청해 주세요.\
개발자 계정에 등록된 게임으로 퀘스트 관리가 가능합니다.
{% endhint %}

1. 처음 들어가면 원퀘스트 신청 안내가 나옵니다.
2. 신청 양식을 작성하고 원퀘스트 이용약관에 동의한 뒤 신청합니다.
3. 신청이 끝나면 화면에서 진행 상태(승인 대기 / 승인 완료)를 확인할 수 있습니다.

<table><thead><tr><th width="125">확인할 점</th><th>내용</th></tr></thead><tbody><tr><td>신청 권한</td><td>마스터 계정 외에 서브 계정도 [마케팅] 메뉴 권한이 있으면 신청할 수 있습니다.</td></tr><tr><td>약관 동의</td><td>개발자 계정 단위로 한 번 동의합니다. <br>동의한 약관은 ONEconsole > 약관 > 원퀘스트 약관에서 다시 볼 수 있습니다.</td></tr><tr><td>승인 시점</td><td>마케팅 예산 입금이 확인되면 승인됩니다.</td></tr></tbody></table>

승인되면 아래 메뉴가 열립니다.

<table><thead><tr><th width="153">메뉴</th><th>기능</th></tr></thead><tbody><tr><td>퀘스트 관리</td><td>퀘스트 그룹과 개별 퀘스트 등록·수정·종료할 수 있습니다.</td></tr><tr><td>퀘스트 통계</td><td>퀘스트별 참여자 수, 원다이아 지급 현황을 확인할 수 있습니다.</td></tr></tbody></table>

## 4. 마케팅 예산

계좌 입금으로 예산을 충전하고 크레딧으로 관리됩니다.&#x20;

{% hint style="info" %}
마케팅 예산을 등록하고 관리하시려면 "유료 개발자"로 등록해 주세요.
{% endhint %}

1. **충전 신청:** 개발사명, 개발자 ID, 충전 금액을 <devhelper@onestore.net>으로 보내 주세요.
2. **거래처 등록:** 처음 충전한다면 사업자등록증, 법인인감증명서, 통장 사본을 함께 보내 주세요. 사용인감을 쓴다면 사용인감계도 보내 주세요.
3. **입금:** 아래 계좌로 입금해 주세요. 입금자명은 사업자명과 같게 입력해 주세요.
4. **충전 완료:** 입금을 확인한 뒤 크레딧을 충전해 드립니다.

<table><thead><tr><th width="282.5">입금 계좌 안내</th><th>텍스트</th></tr></thead><tbody><tr><td>은행</td><td>하나은행</td></tr><tr><td>계좌번호(가상계좌)</td><td>549-995452-06137</td></tr><tr><td>예금주</td><td>원스토어 주식회사</td></tr><tr><td>입금자명</td><td>사업자명과 같게 입력해 주세요.</td></tr></tbody></table>

* 위 계좌는 국내 개발사용이며 **원화 입금만 가능합니다.** **해외 개발사**는 별도 계좌를 만들어 안내해 드립니다.
* 충전 수수료는 없습니다.
* 한 번에 최대 1억 크레딧까지 충전할 수 있습니다.
* 크레딧 충전은 세금계산서 발행 대상이 아닙니다.

#### 예산 안내 <a href="#undefined" id="undefined"></a>

예산 등록, 사용, 남은 예산은 ONEconsole 메시지함과 이메일로 알려 드립니다.

{% hint style="warning" %}
보유한 크레딧보다 큰 보상을 설정하지 않도록 주의해 주세요. \
보유 크레딧을 넘는 보상이 설정된 퀘스트는 원스토어가 노출을 중지할 수 있습니다.
{% endhint %}

## 5. 퀘스트 구조

원퀘스트는 **퀘스트 그룹**과 그 안의 **개별 퀘스트**로 구성됩니다.

```
퀘스트 그룹 (예: "출시 기념 혜택 받기" — 대상 게임 1개)
 ├─ 퀘스트 1 : X 팔로우 하기
 ├─ 퀘스트 2 : 사전예약 신청하기
 └─ 퀘스트 3 : 레벨 30 달성하기 (인게임 액션)
```

* **퀘스트 그룹:** 이용자에게 보이는 하나의 이벤트 단위입니다. 대상 상품 1개를 지정합니다.
  * 퀘스트 그룹의 진행일정과 노출 여부에 따라서 실제 사용자에게 노출 됩니다.
  * 상품 하나를 여러 퀘스트 그룹에 등록할 수 있지만, **같은 기간에 함께 노출할 수는 없습니다.**
* **개별 퀘스트:** 이용자가 수행하는 미션 하나하나입니다. 퀘스트마다 타입, 기간, 보상을 따로 정합니다.
  * 참여 가능 일정과 보상 단위는 개별 퀘스트 단위 입니다.

## 6. 퀘스트 그룹 등록 <a href="#undefined" id="undefined"></a>

**경로:** ONEconsole > 퀘스트 관리 > 퀘스트 그룹 등록

1. 대상 상품을 선택합니다. 원스토어 대한민국에 등록중 또는 판매중인 Android 상품 만 고를 수 있습니다.
   * 등록중 상태인 경우 “상품 제목”, "이용등급" 과 “대표 아이콘”이 필수입니다.
   * 인게임 액션 미션을 제공하려면 바이너리가 등록되어 있어야 합니다. 바이너리가 등록되지 않았으면 인게임 액션은 퀘스트에 노출되지 않습니다.
2. 그룹 제목, 소개 등 진행 정보를 입력합니다.
3. 저장하면 그룹은 **미노출** 상태로 우선 등록되고 노출 시킬 수 있습니다.

<table><thead><tr><th width="123">규칙</th><th>내용</th></tr></thead><tbody><tr><td>진행 기간</td><td>시작일은 <strong>내일부터</strong>, 종료일은 최대 <strong>약 100일 뒤까지</strong> 설정할 수 있습니다.</td></tr><tr><td>대상 상품</td><td>등록 후에는 <strong>바꿀 수 없습니다.</strong> 다른 상품으로 하려면 새 그룹을 만들어 주세요.</td></tr><tr><td>그 외 정보</td><td>대상 상품을 제외한 내용은 모두 수정할 수 있습니다.</td></tr><tr><td>삭제</td><td>개별 퀘스트가 하나라도 등록되면 그룹을 삭제할 수 없습니다.</td></tr></tbody></table>

#### 노출 켜기 <a href="#undefined" id="undefined"></a>

그룹 노출을 켜려면 아래 조건을 모두 만족해야 합니다.

* 개별 퀘스트가 1개 이상 등록되어 있음
* 같은 기간에 같은 상품으로 노출 중인 다른 퀘스트 그룹이 없음
* 대상 상품이 원스토어 대한민국에 등록중 또는 판매중임

노출을 켜면 원스토어 앱에 바로 공개됩니다.

{% hint style="info" %}
이벤트가 끝난 뒤에도 같은 그룹을 계속 쓸 수 있습니다. \
그룹 정보를 수정하고 종료된 퀘스트는 미노출로 바꾼 다음 새 퀘스트를 추가하면 됩니다.
{% endhint %}

## 7. 개별 퀘스트 등록 <a href="#undefined" id="undefined"></a>

**경로:** 퀘스트 그룹 상세 > 퀘스트 추가

1. 퀘스트 타입을 선택합니다. **타입은 등록 후 바꿀 수 없습니다.**
2. 퀘스트 기간을 정합니다.
3. 보상(1인 보상, 최대 보상, 원다이아 유효기간)을 설정합니다.
4. 타입별 필수 정보를 입력합니다(8장 참고).

#### 기간 <a href="#undefined" id="undefined"></a>

* 등록일 **다음 날부터 최대 100일**까지 설정할 수 있습니다.
* 기간을 수정할 때도 **등록일**을 기준으로 같은 범위(등록일 다음 날 \~ 최대 100일) 안에서만 바꿀 수 있습니다.

#### 보상 설정 <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="148">항목</th><th>설명</th></tr></thead><tbody><tr><td>1인 보상</td><td>퀘스트를 완료한 이용자 1명이 받는 원다이아 개수</td></tr><tr><td>최대 보상</td><td>이 퀘스트에서 지급할 원다이아 총량으로 <strong>1인 보상의 배수</strong>로만 설정할 수 있습니다. 예: 1인 보상 100개 → 최대 보상 100, 200, 300 …</td></tr><tr><td>최대 보상 상한</td><td>보유한 마케팅 예산(크레딧) 안에서 설정해야 합니다.</td></tr><tr><td>원다이아 유효기간</td><td>지급일로부터 최대 30일까지 설정할 수 있습니다. <br>기간이 지나면 이용자의 원다이아는 소멸합니다.</td></tr></tbody></table>

* 최대 보상이 모두 지급되면 이용자에게 “보상 소진”으로 표시되고 더 이상 참여할 수 없습니다.

{% hint style="warning" %}
**보상 설정은 퀘스트 시작 전까지만 수정할 수 있습니다.** \
시작 후에 바꾸려면 퀘스트를 종료하고 새로 만들어 주세요.
{% endhint %}

## 8. 퀘스트 타입별 안내 <a href="#undefined" id="undefined"></a>

#### 8-1. 소셜미디어 홍보 (X) <a href="#x" id="x"></a>

<table><thead><tr><th width="155">항목</th><th>내용</th></tr></thead><tbody><tr><td>지원 미션</td><td>X 팔로우, 리포스트, 좋아요</td></tr><tr><td>게임사가 할 일</td><td>팔로우할 계정 또는 리포스트·좋아요할 게시물의 <strong>URL만 입력</strong>하면 됩니다.</td></tr><tr><td>참여 확인</td><td>X 계정 연결과 참여 여부 확인은 원퀘스트가 처리합니다. 별도 개발이 필요 없습니다.</td></tr><tr><td>이용자 조건</td><td>처음 참여할 때 X 계정을 연결해야 합니다. 원스토어 계정 1개에 X 계정 1개만 연결할 수 있습니다.</td></tr></tbody></table>

#### 8-2. 사전예약 <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="159">항목</th><th>내용</th></tr></thead><tbody><tr><td>사전 조건</td><td>원스토어 <strong>대한민국</strong>에서 사전예약을 진행 중이어야 합니다.</td></tr><tr><td>게임사가 할 일</td><td>사전예약을 진행하고 있는 상품으로 퀘스트를 등록하면 됩니다. 별도 개발이 필요 없습니다.</td></tr><tr><td>보상 시점</td><td>이용자가 사전예약을 <strong>신청 완료</strong>한 뒤 퀘스트에서 <strong>[보상받기]를 직접 눌러야</strong> 지급됩니다. 신청만으로는 자동 지급되지 않습니다.</td></tr></tbody></table>

#### 8-3. 인게임 액션 <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="163.5">항목</th><th>내용</th></tr></thead><tbody><tr><td>지원 미션</td><td>게임 서버에서 달성 여부를 확인할 수 있는 미션을 준비합니다<br>(예: 레벨 달성, 튜토리얼 완료, 특정 스테이지 클리어)</td></tr><tr><td>게임사가 할 일</td><td>게임 서버에 API 2개(유저 유효성 확인, 인게임 액션 검증)를 구현하고 ONEconsole에 URL을 등록합니다.</td></tr><tr><td>게임 계정 식별</td><td>게임 계정 ID(UUID)로 확인합니다. 서버 정보 등 추가 식별 정보가 필요하면 제안해 주세요.</td></tr><tr><td>등록 조건</td><td>등록 화면의 <strong>통신 테스트를 통과해야</strong> 퀘스트를 등록할 수 있습니다.</td></tr><tr><td>이용자 조건</td><td>처음 참여할 때 게임 계정 ID를 입력해 연결합니다. 연결 정보는 같은 퀘스트 그룹 안에서 재사용됩니다.</td></tr><tr><td>게임 계정 안내</td><td>이용자가 어떤 값을 입력해야 하는지(예: 게임 내 [설정] > 계정 정보의 회원 번호) 퀘스트 그룹 정보에 꼭 안내해 주세요.</td></tr></tbody></table>

자세한 규격은 [ONEquest 인게임 연동 가이드](https://onestore-dev.gitbook.io/dev/tools/onequest)를 확인해 주세요.

### 9. 운영 중 할 수 있는 일 <a href="#undefined" id="undefined"></a>

퀘스트 그룹 및 상품 기준

<table data-search="false"><thead><tr><th width="212.5">하고 싶은 일</th><th width="259">가능 여부</th><th>방법·조건</th></tr></thead><tbody><tr><td>그룹 정보 수정</td><td>✅ 가능</td><td>대상 상품 외 모든 항목</td></tr><tr><td>대상 상품 변경</td><td>❌ 불가</td><td>새 퀘스트 그룹 생성</td></tr><tr><td>퀘스트 그룹 노출 끄기</td><td>✅ 가능</td><td></td></tr><tr><td>퀘스트 그룹 일정 변경</td><td>✅ 가능</td><td>현재시점 +1 일 ~ 최대 100일 범위</td></tr><tr><td>퀘스트 그룹 삭제</td><td>🏷️개별 퀘스트가 없을 때만 가능</td><td></td></tr></tbody></table>

개별 퀘스트 기준

<table data-search="false"><thead><tr><th width="212.5">하고 싶은 일</th><th width="259">가능 여부</th><th>방법·조건</th></tr></thead><tbody><tr><td>개별퀘스트 타입 변경</td><td>❌ 불가</td><td>새 퀘스트 생성</td></tr><tr><td>개별 퀘스트 기간 수정</td><td>✅ 가능</td><td>등록일 기준 다음 날 ~ 최대 100일 범위</td></tr><tr><td>보상 수정</td><td>🏷️시작 전만 가능</td><td>시작 후에는 종료 → 새 퀘스트 생성</td></tr><tr><td>개별 퀘스트 조기 종료</td><td>✅ 가능</td><td>진행 중 [종료] 버튼</td></tr><tr><td>개별 퀘스트 노출 끄기</td><td>🏷️종료 후에만 가능</td><td><p>진행 중에는 미노출 불가, </p><p>중단하려면 종료해 주세요.</p></td></tr><tr><td>개별 퀘스트 삭제</td><td>🏷️시작 전만 가능</td><td>시작된 퀘스트는 삭제 불가</td></tr></tbody></table>

### 10. 이용자 참여 조건 <a href="#undefined" id="undefined"></a>

원퀘스트는 부정 참여를 막기 위해 아래 조건이 자동으로 적용됩니다. 게임사가 따로 설정할 필요는 없습니다.

<table data-search="false"><thead><tr><th width="184.5">조건</th><th>내용</th></tr></thead><tbody><tr><td>본인인증</td><td>본인인증한 원스토어 회원만 참여할 수 있습니다.</td></tr><tr><td>1인 1회</td><td>본인인증 정보 기준으로 퀘스트마다 1번만 보상받을 수 있습니다. 다른 원스토어 아이디로 참여해도 같은 사람이면 다시 받을 수 없습니다.</td></tr><tr><td>1기기 1회</td><td>같은 기기에서는 본인인증 정보가 달라도 퀘스트마다 1번만 보상받을 수 있습니다.</td></tr><tr><td>앱플레이어</td><td>PC 앱플레이어(에뮬레이터)에서는 참여할 수 없습니다.</td></tr><tr><td>참여 제한 회원</td><td>원스토어 마케팅 참여 제한 회원은 참여할 수 없습니다.</td></tr><tr><td>진행 기간</td><td>개별퀘스트 기간에만 참여할 수 있습니다.</td></tr><tr><td>청소년 이용불가 게임</td><td>만 19세 미만 이용자에게는 퀘스트 그룹이 보이지 않습니다.</td></tr><tr><td>대상 상품 상태</td><td>상품이 판매중지·판매불가가 되거나 대한민국 배포가 꺼지면 퀘스트가 자동으로 보이지 않습니다.</td></tr><tr><td>결과 반영</td><td>일부 퀘스트는 참여 결과가 반영되기까지 소셜사와 게임사 연동에 따라 최대 2시간 소요될 수 있습니다.</td></tr></tbody></table>

### 11. 이용자에게 보이는 화면 <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="182.5">화면</th><th>내용</th></tr></thead><tbody><tr><td>혜택 · 마이 > 원퀘스트</td><td>진행 중인 퀘스트 그룹 목록. 진행 중 퀘스트 수와 최대 보상 원다이아가 함께 보입니다. 종료된 퀘스트도 목록에 남습니다.</td></tr><tr><td>퀘스트 그룹 상세</td><td>대상 게임, 개별 퀘스트, 달성률, 참여자 수, 지급 원다이아를 보여 주고 이용자가 여기서 참여합니다.</td></tr><tr><td>상품 상세</td><td>진행 중인 퀘스트가 표시되고, 누르면 퀘스트 그룹 상세로 이동합니다.</td></tr><tr><td>퀘스트 상태</td><td>참여 완료 · 보상 소진 · 종료된 퀘스트는 “종료됨”으로 표시됩니다.</td></tr></tbody></table>

퀘스트 그룹 상세 하단에는 원스토어가 관리하는 공통 유의사항이 자동으로 표시됩니다.

### 12. 미리보기와 테스트 <a href="#undefined" id="undefined"></a>

* 등록한 퀘스트 그룹과 퀘스트는 **미리보기**로 이용자 화면을 확인할 수 있습니다.
* **인게임 액션**은 등록 화면의 통신 테스트로 실제 API 호출과 응답 규격을 확인할 수 있습니다.
* 실제 원다이아가 지급되는 테스트 기능은 제공하지 않습니다.

### 13. 통계와 자동 알림 <a href="#undefined" id="undefined"></a>

#### 통계 <a href="#undefined" id="undefined"></a>

* **경로:** ONEconsole > 퀘스트 통계
* 기간별, 퀘스트 그룹별로 보상 지급 수와 지급한 원다이아를 확인할 수 있습니다.

#### 자동 알림 (ONEconsole 메시지함) <a href="#oneconsole" id="oneconsole"></a>

<table><thead><tr><th width="309.5">시점</th><th>알림</th></tr></thead><tbody><tr><td>퀘스트 시작 3일 전, 시작 당일</td><td>퀘스트 진행 시작 안내</td></tr><tr><td>종료 1일 전 오전 9시, 종료 시점</td><td>퀘스트 종료 안내</td></tr><tr><td>최대 보상 50% · 80% · 100% 소진</td><td>보상 소진 안내</td></tr></tbody></table>

### 14. 피쳐드(추가 노출) 신청 <a href="#undefined" id="undefined"></a>

진행 중인 퀘스트는 원스토어 앱 \[혜택]과 \[마이]의 원퀘스트에 노출됩니다. 피쳐드되는 경우 더 다양한 화면에 노출됩니다.

**신청 방법:** 게임·퀘스트 소개 자료를 [\[문의하기\] > \[마케팅\] > \[원퀘스트\]](https://dev.onestore.net/dev/help/contact?categoryId=QNA40001)로 보내 주세요. 검토 후 연락드립니다.

### 15. 운영 정책 <a href="#undefined" id="undefined"></a>

#### 노출 제한 <a href="#undefined" id="undefined"></a>

아래에 해당하면 원스토어가 사전 안내 없이 퀘스트 노출을 중지하고, 원퀘스트 이용 승인을 취소할 수 있습니다. 조치 후 게임사에 안내합니다.

* 성인향, 사행성, 도박성 퀘스트
* 원스토어 운영 정책을 위반한 경우
* 보유한 크레딧보다 큰 보상을 설정한 경우

#### 게임 이관 <a href="#undefined" id="undefined"></a>

* 다른 개발자 계정으로 게임을 이관해도 **퀘스트 정보는 함께 이관되지 않습니다.**
* 진행 예정이거나 진행 중인 퀘스트가 있으면 **모두 종료하거나 삭제한 뒤** 이관해 주세요.

#### 개발자 계정 탈퇴 <a href="#undefined" id="undefined"></a>

* 탈퇴하면 등록중 상품은 삭제되고 판매중 상품은 판매중지되므로, 퀘스트는 모두 자동으로 미노출 처리됩니다.
