Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

ONEshop 활용 가이드

적용 가이드

1. ONEshop이란?

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

  • ONEshop은 인앱결제를 대체하지 않습니다. 자체 채널의 커머스 경험을 확장하는 보완적 판매 채널입니다.

  • ONEshop 상품 URL은 자체 마케팅 채널과 원스토어 유통앱에서 연동할 수 있습니다.

주요 특징

  • 개발사의 자체 마케팅 채널은 물론, 원스토어 유통앱 내에서도 링크 연동 가능

  • 낮은 수수료로 PG 수수료 포함 결제 제공

  • PC, Android, iOS 등 모든 브라우저 환경에서 구매 가능

  • 인앱결제와 동일한 서버 규격으로 빠른 연동

  • 개발자센터에서 등록/검증/정산/CS를 원스톱 관리

웹샵 상세 페이지 URL

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

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

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

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

핵심 원칙

  • 인앱결제가 연동된 상점 페이지에서 웹샵 이동 경로 및 상품을 직접 노출하는 것은 허용되지 않습니다.

  • 웹샵 이동 경로는 인앱결제 상점과 기능적으로 분리된 별도의 진입 경로로 구성해야 합니다.

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

게임 내 웹샵 버튼 클릭 시, ONEshop의 ‘타이틀 상세 페이지’를 호출해야 합니다.

핵심 원칙

  • 웹샵 내 특정 아이템을 직접 게임앱 내에 노출/전시 불가

허용되는 유도 방식

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

  • 버튼 (예: "웹샵 바로가기")

  • 텍스트 링크

  • 팝업 / 다이얼로그

  • 메뉴 항목

  • 배너 이미지 등

4. 사용자 경험 최적화 팁

  • 웹샵 진입 전('웹샵 버튼 클릭'과 '웹샵 상세 페이지' 사이), 간단한 안내 팝업을 제공하는 것을 권장합니다.

  • ONEshop은 게임 내 이동 시 게임 ID를 자동 연동합니다. 별도 입력 없이 구매할 수 있습니다. 상세 방법은 사용자 정보 연동을 참고하세요.

개인정보 관련 안내

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

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

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

5-1. 상단 배너 영역

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

  • 웹샵 추천 상품 안내

  • 프로모션 / 시즌 이벤트 배너

  • 한정 판매 안내

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

  • 아이템별로 짧은 설명 문구를 추가하여 상품의 가치를 효과적으로 전달할 수 있습니다.

  • 개발사가 강조하고 싶은 상품에 뱃지를 노출할 수 있습니다.

뱃지 유형
용도

New

신규 등록 아이템 강조

Best

인기 / 추천 아이템 강조

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

6. 구매 횟수 제한 처리

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

6-1. 처리 흐름

  1. 유저가 웹샵에서 게임 ID / 서버를 입력하고 구매를 시도합니다.

  2. ONEshop이 개발사 서버로 구매 요청을 전송합니다.

  3. 개발사 서버에서 구매 불가로 판단한 경우, 상태코드 1001과 함께 노출 희망 문구를 반환합니다.

  4. ONEshop이 해당 메시지를 사용자에게 노출합니다.

6-2. API 응답 예시

6-3. 권장 메시지 예시

상황
권장 메시지

구매 횟수 초과

"해당 계정에서 구매 가능한 횟수를 초과하였습니다."

이미 구매한 일회성 상품

"이미 구매한 상품입니다."

이벤트 종료

"이벤트 기간이 종료된 상품입니다."

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

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

예시

  • "계정당 1회 구매 가능"

  • "일일 3회 구매 제한"

  • "서버당 월 5회 구매 가능"

외부 홍보 가이드

  • ONEshop의 실적은 외부 홍보 여부에 따라 크게 달라집니다. 게임 내 연동만으로는 이용자가 웹샵의 존재를 인지하기 어렵습니다. 게임 밖에서도 적극적으로 알려야 합니다.

  • 본 가이드에서는 공지/배너/외부 매체를 활용한 홍보 방법을 안내합니다.

  • 특히 "공지의 활용"은 ONEshop 적용 개발사의 필수 수행 사항입니다. 공식 커뮤니티 공지는 기존 이용자에게 웹샵을 알리는 효과적인 수단입니다. ONEshop 적용 후 반드시 공지로 안내해 주세요.

1. 공지의 활용

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

1-1. 공지 내 포함해야 할 콘텐츠

  1. 웹샵 전용 혜택: 전용 상품 또는 웹샵에서의 혜택을 명확히 전달 (e.g. 웹샵에서만 판매하는 아이템, 20% 재화 추가 지급 등)

  2. 웹샵 접속 링크: https://webshop.onestore.net/title/{PID} 형식의 직접 링크 제공

  3. (필요 시) 원스토어 빌드 다운로드 안내: 게임 내에서 ONEshop 연결 동선을 제공한 게임 콘텐츠가 원스토어에 업로드되어 있다면, 원스토어 게임 설치 링크를 함께 안내

1-2. 공지 위치 및 방식

  • 고정 공지: 커뮤니티 상단에 ONEshop 안내를 상시 고정하여 신규·기존 이용자에게 지속 노출

    • e.g. [상시] ONEshop 바로가기 및 대표 혜택

  • 이벤트 공지: 업데이트·시즌·신규 콘텐츠 출시 등 이벤트에 웹샵 혜택을 병행 안내

    • e.g. [기간한정] ONEshop 전용 패키지 오픈

  • 운영 콘텐츠 포함하는 방식: 주간 소식, GM 메시지, 쿠폰 배포 글 등 일상적 운영 콘텐츠에 웹샵 링크를 자연스럽게 삽입하여 피로도 없이 반복 노출

    • e.g. 주간 운영소식 하단에 웹샵 링크 추가

1-3. 상황별 안내 문구 예시

  1. 상시 안내형: "공식 ONEshop에서는 전용 상품과 다양한 추가 혜택을 확인하실 수 있습니다. 아래 링크에서 확인해 주세요."

  2. 혜택 강조형: "ONEshop에서는 공식 채널 전용 혜택이 포함된 특별 상품을 제공합니다. 추가 보상과 특별 구성 상품을 확인해 보세요."

  3. 이벤트 연계형: "업데이트를 기념하여 ONEshop에서 특별 구성 상품과 추가 혜택을 제공합니다. 웹샵 전용 혜택을 아래에서 확인해 주세요."

  4. 마감 임박형: "현재 운영 중인 ONEshop 특별 혜택이 곧 종료됩니다. 기간 한정 상품과 보상을 놓치지 마세요!"

2. 배너의 활용

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

2-1. 배너 제작 시 포함 소재

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

612KB
ONEwebshop Badge.psd
image
Open
351KB
ONEwebshop Badge.ai
Open
테마
뱃지
BI

White 테마

Dark 테마

2-2. 배너 클릭 시 연동 방식

  1. ONEshop으로 직접 이동: 배너 클릭 시 ONEshop URL(https://webshop.onestore.net/title/{PID})로 즉시 이동하도록 링크 연동

  2. 다른 페이지로 이동하는 경우: 해당 페이지에 ONEshop 접속 링크와 접속 방법 안내를 반드시 포함

    1. 예) “아래 링크를 통해 ONEshop에서 특별 패키지를 확인해 보세요” + 웹샵 URL

2-3 배너 제작 및 배치 예시

배너 제작 문구 예시
배너 배치 예시

  • 바로가기형: "ONEshop 바로가기" / "공식 웹샵 방문하기"

  • 혜택 강조형: "웹샵 전용 혜택 확인하기" / "특별 패키지 보러가기"

  • 이벤트 연계형: "[업데이트 기념] ONEshop 특별 혜택"

  • 커뮤니티 상단 메인 배너 / 사이드 배너

  • 커뮤니티 외부 링크 모음 영역

  • 공지사항 하단 버튼 영역

  • 공식 홈페이지 / 앱 등록정보

3. 외부 매체의 활용

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

3-1. 커뮤니티 채널별 활용 방법

  • Discord: #announcement 채널에 웹샵 바로가기 링크 고정, 업데이트/시즌 공지 시 웹샵 혜택 병행 안내, Discord 한정 쿠폰 배포로 웹샵 방문 유도

  • 외부 커뮤니티: 공식 운영진(CM) 명의 공지로 웹샵 오픈/혜택 안내, 게시글 내 웹샵 직접 링크 포함

  • X(Twitter) / Instagram: 웹샵 오픈·특별 혜택·기간 한정 프로모션을 이미지/카드 형식으로 게시, 웹샵 링크 삽입

  • YouTube 등: 콘텐츠 소개 영상 내 웹샵 안내, 영상 설명란에 웹샵 링크 또는 쿠폰 코드 배치

3-2. 광고 성과 측정 방법

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

요청 방법

이메일로 요청

연락처

devhelper@onestore.net

요청 시 포함 정보

- 게임명 / PID - 광고 매체 (Google Ads, Meta Ads 등) - 트래킹 코드 종류 (UTM, 픽셀 등) - 적용 희망 시점

3-3. 커뮤니티 활용 사례 예시

  • 수집형 'P'게임 - 이벤트날 커뮤니티 내 운영자가 공지 시 “웹샵 전용 박스” 언급, 웹 전용 보너스 코인 지속 안내

  • 'M' 카드게임 - Discord에서 웹샵 리뉴얼 대대적 공지, “WEB EXCLUSIVE” 상품 강조

  • 대전형 'C'게임 - 게임사 커뮤니티 이벤트 진행 시 웹샵 방문 & 무료 보상 제공 → 광고 집행

  • RPG 'G'게임 - 외부 커뮤니티에서 게임사 계정을 통해 웹샵 전용 이벤트, 상점 안내

Last updated