Setup Guide

15 분 소요

에픽게임즈 스토어에 제품을 퍼블리싱하면, 에픽게임즈 스토어 업적을 통해 제품의 사용자 경험을 향상할 수 있습니다. 에픽게임즈 스토어 업적은 에픽 온라인 서비스 업적의 기능을 확장합니다. 에픽게임즈 스토어 업적을 이용하면 사용자 에픽 프로필에서 경험치(XP)와 기타 혜택을 보상으로 제공할 수 있습니다. 에픽게임즈 스토어 업적에 대해 자세히 알아보세요.

조직에서 에픽게임즈 스토어에 퍼블리싱할 수 있는지 확인

조직에서 에픽게임즈 스토어에 퍼블리싱할 수 있어야만 제품에 에픽게임즈 스토어 업적을 추가할 수 있습니다. 조직이 에픽게임즈 스토어에 퍼블리싱하도록 설정되지 않은 경우, 액세스 요청을 해주세요.

에픽게임즈 스토어 업적을 사용하도록 제품 준비

제품에 에픽게임즈 스토어 업적을 추가하기 전에 에픽게임즈 스토어 업적을 사용하도록 제품을 환경설정해야 합니다. 화면에 표시되는 다음 3단계 온보딩 절차에 따라 설정합니다.

  1. 업데이트된 개발자 계약에 서명합니다.
    • 조직당 한 번만 서명하면 됩니다.
  2. 데브(Dev) 및 스테이지(Stage) 샌드박스와 디플로이를 생성합니다.
  3. 에픽게임즈 스토어 업적에서 사용할 디플로이를 각 샌드박스에서 선택합니다.

1단계: 업데이트된 개발자 계약에 서명

조직 오너가 업데이트된 개발자 계약을 읽고 이에 서명해야 합니다. 조직 오너가 이 계약에 동의하기 전까지는 에픽게임즈 스토어 업적을 사용할 수 없습니다. 조직 오너만 이 절차를 진행할 수 있습니다.

계약을 읽고 이에 서명하는 절차는 다음과 같습니다.

  1. 조직 오너로 개발자 포털에 로그인합니다.
  • 조직 오너가 아니라면 조직 오너에게 이 절차를 진행하라고 요청하세요.
  1. 내 제품(Your Product) > 게임 서비스(Game Services) > 업적(Achievements) > 에픽게임즈 스토어 업적(Epic Games Store achievements) 으로 이동합니다.
  2. 개발자 계약(Developer agreement) 을 선택합니다.
  3. 업데이트된 개발자 계약을 읽고 이에 서명합니다.

2~3단계: 샌드박스와 디플로이 생성 및 선택하기

에픽게임즈 스토어 업적을 설정하려면, 먼저 제품에서 데브 및 스테이지 샌드박스와 디플로이를 생성해야 합니다. 또한 에픽게임즈 스토어 업적에서 사용할 디플로이를 각 샌드박스에서 한 개씩 선택해야 합니다. 에픽 온라인 서비스는 업적 데이터 등 제품의 모든 사용자 데이터를 특정 디플로이에 연결합니다.

샌드박스와 디플로이를 생성하고 선택하는 절차는 다음과 같습니다.

  1. 개발자 포털에서 내 제품(Your Product) > 게임 서비스(Game Services) > 업적(Achievements) > 에픽게임즈 스토어 업적(Epic Games Store achievements) 으로 이동합니다.
  2. 아직 1단계: 업데이트된 개발자 계약에 서명을 완료하지 않았다면, 계약에 먼저 서명한 뒤에 다음 절차를 진행합니다.
  3. 생성(Generate) 을 선택하여 새 데브 및 스테이지 샌드박스, 그리고 연결된 디플로이를 생성합니다.
  • 제품에 데브 및 스테이지 샌드박스가 이미 설정되어 있고 각 샌드박스에 하나 이상의 디플로이가 있는 경우, 이 단계를 건너뛰어도 됩니다.
  1. 각 샌드박스의 주 디플로이를 선택합니다. 이 디플로이에 에픽게임즈 스토어 업적이 포함됩니다.
  2. 제출(Submit) 을 선택합니다.

제품에서 에픽게임즈 스토어 업적 생성

다음과 같은 두 가지 방법으로 제품에서 에픽게임즈 스토어 업적을 생성할 수 있습니다.

에픽게임즈 스토어 업적 대량 업로드

대량 임포트 기능을 사용하여 동시에 여러 개의 에픽게임즈 스토어 업적을 추가할 수 있습니다. 데브 샌드박스의 에픽게임즈 스토어 업적에 링크된 디플로이에서 이 작업을 수행해야 합니다.

이 프로세스 시작 시, 다음 중 하나를 수행해야 합니다.

  • 방식 1: 라이브 디플로이에서 현재 에픽 온라인 서비스 업적을 zip 파일로 익스포트합니다. 제품에 정의된 업적이 이미 있는 경우, 이 방식을 사용하는 것이 좋습니다.
  • 방식 2: 아래의 두 번째 화면에 표시된 에픽게임즈 스토어 업적 템플릿 CSV 파일을 다운로드합니다.

그런 다음, 다운로드한 파일에서 업적을 정의하고 그 파일을 개발자 포털로 다시 임포트합니다.

방식 1: 현재 에픽 온라인 서비스 업적 익스포트

  1. 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  2. 디플로이(Deployment) 드롭다운에서 라이브 샌드박스로 전환합니다.
  3. 대량 임포트/익스포트(BULK IMPORT/EXPORT) 를 선택합니다.
  4. 현재 업적 익스포트(EXPORT CURRENT ACHIEVEMENTS) 를 선택합니다.
  5. 대량 익스포터를 닫습니다.

이제 업적을 정의하고 업로드할 수 있습니다.

방식 2: 에픽게임즈 스토어 업적 템플릿 다운로드

  1. 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  2. 디플로이 드롭다운에서 데브 샌드박스로 전환합니다.
  3. 대량 임포트/익스포트(BULK IMPORT/EXPORT) 를 선택합니다.
  4. 대량 임포트/익스포트 를 선택합니다.
  5. 에픽게임즈 스토어 업적 ZIP 템플릿 다운로드(DOWNLOAD Epic Games Store achievementS ZIP TEMPLATE) 를 선택합니다.
  6. 대량 익스포터를 닫습니다.

이제 업적을 정의하고 업로드할 수 있습니다.

업적 정의 및 업로드

어느 방식을 사용했든, 이제 csv 파일에 업적을 추가한 다음 해당 파일을 업로드해야 합니다.

  1. 컴퓨터에서 다운로드한 zip 파일의 압축을 해제합니다.
  2. achievementDefinitions.csv 파일을 엽니다.
  3. 마지막 열이 user_epic_achievements_xp 가 아니면, 해당 열을 추가합니다.
  4. 적절한 업적 값을 파일에 채웁니다.
  1. (선택 사항) achievementLocalizations.csv 파일을 편집합니다. 이 파일에서 현지화 텍스트를 추가하고 업적에 이미지를 연결할 수 있습니다.
  1. 수정된 achievementDefinitions.csv' 파일을 비롯해 작성한 파일을 새 zip 아카이브에 추가합니다. zip 아카이브의 루트 레벨에 모든 파일을 배치합니다.
  2. 개발자 포털에서 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  3. 디플로이 드롭다운에서 데브 샌드박스로 전환합니다.
  4. 대량 임포트/익스포트(BULK IMPORT/EXPORT) 를 선택합니다.
  5. 대량 임포트/익스포트 를 선택합니다.
  6. 아래로 스크롤하여 경고 메시지를 읽고 이에 동의합니다.
  7. 업로드할 파일 선택(CHOOSE FILE TO UPLOAD) 을 선택한 다음 zip 아카이브를 선택합니다.
이미지: CSV 파일 업적 정의 예시

이미지: CSV 파일 업적 정의 예시입니다.

업적 임포트 확인

업적을 임포트한 다음에는 업적에 대한 경험치(XP) 요구 사항의 기준을 충족하는지 확인할 수 있습니다.

업적 임포트를 확인하는 절차는 다음과 같습니다.

  1. 개발자 포털에서 내 제품(Your Product) > 게임 서비스(Game Services) > 업적(Achievements) > 에픽게임즈 스토어 업적(Epic Games Store achievements) 으로 이동합니다.
  2. 화면 상단에서 스테이지로 푸시(PUSH TO STAGE) 버튼을 확인합니다.
  • 버튼이 활성화되어 있는 경우, 업적이 유효성 검사를 통과한 것입니다. 즉, 업적에 대한 경험치(XP) 요구 사항의 기준을 충족했다는 뜻입니다. 이 절차의 4단계로 건너뜁니다.
  • 버튼이 비활성화되어 있는 경우, 업적이 기준을 통과하지 못한 것입니다. 메시지를 펼쳐 업적이 유효성 검사에 실패한 자세한 이유를 확인합니다. 일반적으로 발생하는 오류는 XP 값이 누락되거나 잘못된 경우, XP 총계가 1,000이 되지 않는 경우, 아이콘 파일 크기가 잘못된 경우, 문자 수 제한을 초과한 경우입니다. XP 요구 사항에 대해 자세히 알아보세요.
  1. 파일의 오류를 해결하고 zip 아카이브를 업데이트한 다음, 다시 대량 임포트 프로세스를 사용하여 zip 아카이브를 업로드합니다.

스테이지로 푸시하기 전에 제품의 에픽게임즈 스토어 업적 유효성을 검사할 수 있습니다. 유효성을 검사하려면, SDK 초기화 중에 업적에 연결된 데브 샌드박스와 디플로이를 사용하는 제품의 빌드를 생성합니다.

업적을 라이브로 푸시하면, 제품 세부사항 페이지와 업적 세부사항 페이지에서 푸시한 업적을 프리뷰할 수 있습니다. 업적을 프리뷰하려면, 먼저 모더레이션 리뷰와 승인을 받기 위해 업적을 스테이지로 푸시해야 합니다.

단일 에픽게임즈 스토어 업적 생성 및 링크

참고: 이 섹션에서는 단일 에픽게임즈 스토어 업적을 생성하고 링크하는 방법을 설명합니다. 제품에 에픽 온라인 서비스 업적이 이미 있는 경우, 대신 에픽게임즈 스토어 업적 대량 업로드를 진행하는 것이 좋습니다.

에픽게임즈 스토어 업적을 생성할 때, 이를 에픽 온라인 서비스 업적에 링크하고 XP 값을 할당합니다. 적절한 에픽 온라인 서비스 업적이 없다면 개발자 포털에서 간단하게 생성할 수 있습니다.

에픽게임즈 스토어 업적에 해당하는 에픽 온라인 서비스 업적 생성

참고: 에픽게임즈 스토어 업적에 해당하는 에픽 온라인 서비스 업적이 이미 있는 경우, 바로 에픽게임즈 스토어 업적 생성을 진행할 수 있습니다.

다음 두 가지 방법으로 에픽 온라인 서비스 업적을 정의할 수 있습니다.

  • 실행 전에 해당 코드를 제품에 작성합니다. 에픽 온라인 서비스 업적에 대해 자세히 알아보세요.
  • 각 에픽 온라인 서비스 업적은 통계를 기반으로 합니다. 예를 들어, 게임에서 특정 거리를 이동한 사용자에게 보상을 주는 업적을 만들고 싶다면, 먼저 플레이어의 이동 거리를 추적하는 통계를 생성해야 합니다. 그런 다음, 이 통계에 기반한 업적을 생성합니다.

에픽 온라인 서비스 업적을 생성하는 절차는 다음과 같습니다.

  1. 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  2. 디플로이 드롭다운에서 데브 샌드박스와 연결된 디플로이를 선택합니다.
  3. 새로 생성(CREATE NEW) 을 선택합니다.
  4. 이 업적을 통계에 기반해 만들고 싶다면, 통계를 선택합니다.
  • 예를 들어, 제품 사용자가 특정 수의 아이템을 수집할 때 업적이 잠금해제되도록 하고 싶다면, 수집한 아이템 수와 관련된 통계를 선택합니다.
  1. 4단계에서 통계를 선택했다면, 업적이 잠금해제되는 통계 값을 입력합니다. 예를 들어, 제품 사용자가 부적 다섯 개를 수집하면 업적이 잠금해제되도록 하고 싶다면, 5 를 입력합니다.
  2. 다음 을 클릭합니다.
  3. 다음과 같이 업적의 세팅을 입력합니다.
  • 업적 ID(Achievement ID) : 업적을 식별하는 고유 값입니다.
  • 로케일 선택(Select Locale) : 이름과 설명이 적용되는 로케일입니다. 에픽게임즈 스토어에서 지원하는 언어마다 에픽게임즈 스토어 업적 세트를 서로 다르게 정의할 수 있습니다.
  • 비저빌리티(VISIBILITY) : 잠금해제 전에 제품 사용자에게 업적을 보여줄지 여부를 정합니다.
  • 잠금해제됨 아이콘(UNLOCKED ICON) : 제품 사용자가 업적을 잠금해제한 뒤 에픽게임즈 소셜 오버레이나 제품에 표시되는 아이콘을 업로드합니다.
  • 잠금 아이콘(LOCKED ICON) : 업적이 잠금해제되기 전에 제품 사용자에게 표시되는 아이콘입니다. 참고: 연결된 에픽게임즈 스토어 업적의 경우, 이 아이콘이 제품 사용자에게 표시되지 않습니다. 대신, 반투명한 잠금해제됨 아이콘 버전이 사용자에게 표시됩니다.
  • 잠긴 표시명 : 업적이 잠금해제되기 전에 제품 사용자에게 표시되는 이름입니다.
  • 잠긴 설명 : 업적이 잠금해제되기 전에 제품 사용자에게 표시되는 설명입니다.
  • 잠금해제된 표시명 : 업적이 잠금해제된 뒤에 제품 사용자에게 표시되는 이름입니다.
  • 잠금해제된 설명 : 업적이 잠금해제된 뒤에 제품 사용자에게 표시되는 설명입니다.
  • 플레이버 텍스트(선택 항목) : 선택 항목으로서 제품에 자유롭게 사용할 수 있는 추가 텍스트입니다.
  1. 저장(CREATE) 을 선택합니다.

에픽게임즈 스토어 업적 생성 및 링크

참고 : 각 에픽게임즈 스토어 업적을 에픽 온라인 서비스 업적에 링크해야 합니다. 적절한 에픽 온라인 서비스 업적이 없다면, 개발자 포털에서 간단하게 생성할 수 있습니다.

새 에픽게임즈 스토어 업적을 생성하는 절차는 다음과 같습니다.

  1. 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  2. 디플로이 드롭다운에서 데브 샌드박스와 연결된 디플로이를 선택합니다.
  3. 새 에픽게임즈 스토어 업적에 링크하려는 에픽 온라인 서비스 업적을 업적 목록에서 찾습니다.
  4. … > 업적 링크(Link achievement) 를 선택합니다.
  5. 업적의 XP 값을 입력합니다.
  1. 링크 생성(CREATE LINK) 을 선택합니다.

에픽게임즈 스토어 업적의 XP 값 편집

에픽게임즈 스토어 업적으로 받는 XP를 편집할 수 있습니다.

참고: 업적을 라이브로 푸시한 다음에는 에픽게임즈 스토어 업적의 XP 값을 변경할 수 없습니다.

에픽게임즈 스토어 업적으로 받는 XP를 편집하는 절차는 다음과 같습니다.

  1. 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  2. 에픽 온라인 서비스 업적 위에 있는 드롭다운에서 데브 샌드박스와 연결된 디플로이를 선택합니다.
  3. 에픽게임즈 스토어 업적(Epic Games Store achievements) 을 선택합니다.
  4. XP를 수정하려는 업적을 찾습니다.
  5. ... > XP 편집(Edit XP) 을 선택합니다.
  6. 새 XP 값을 입력합니다.
  7. 저장(SAVE) 을 선택합니다.

에픽게임즈 스토어 업적 링크해제 및 삭제

연결된 에픽 온라인 서비스 업적에서 에픽게임즈 스토어 업적을 링크해제할 수 있습니다. 링크해제하면, 다음과 같은 사항이 적용됩니다.

  • 에픽게임즈 스토어 업적이 삭제됩니다.
  • 연결된 에픽 온라인 서비스 업적은 삭제되지 않습니다.

참고 : 업적을 라이브로 푸시한 경우, 개발자 포털에서 에픽게임즈 스토어 업적을 링크해제할 수 없습니다. 이러한 상황에서 업적을 삭제하려면, 에픽게임즈 지원팀에 문의하세요.

에픽게임즈 스토어 업적을 링크해제하고 삭제하는 절차는 다음과 같습니다.

  1. 게임 서비스(Game Services) > 업적(Achievements) > 에픽 온라인 서비스 업적(Epic Online Services achievements) 으로 이동합니다.
  2. 에픽 온라인 서비스 업적 위에 있는 드롭다운에서 데브 샌드박스와 연결된 디플로이를 선택합니다.
  3. 에픽게임즈 스토어 업적(Epic Games Store achievements) 을 선택합니다.
  4. 링크해제하고 삭제하려는 업적을 찾습니다.
  5. ... > 링크해제(Unlink) 를 선택합니다.
  6. 링크 제거(REMOVE LINK) 를 선택합니다.

라이브 에픽게임즈 스토어 업적 보기

제품 세부사항 페이지와 제품의 새 업적 세부사항 페이지를 보려면, 먼저 다음 사항을 확인하세요.

  • 제품을 라이브로 푸시했습니다.
  • 제품에 카탈로그 아이템이 있습니다.
  • 제품에 오퍼가 있습니다.

업적 세부사항 페이지 를 보려면, /store/en-US/achievements/<product-name> URL을 사용하고 <product-name>을 내 제품 이름으로 교체합니다.

*이미지: 이미지: 업적 세부사항 페이지 예시입니다.

이제 업적을 스테이지 샌드박스로 푸시할 수 있습니다. 자세한 정보는 퍼블리싱, 모더레이션, 승인을 참조하세요.

퍼블리싱, 모더레이션, 승인

참고: 업적을 라이브하면 업적을 제거하거나 XP 값을 조정할 수 없습니다. 텍스트나 이미지를 변경하려면 이 섹션에 설명된 대로 일반 퍼블리싱 플로를 따릅니다. 업적을 삭제해야 하는 경우, 에픽게임즈 지원팀에 문의하세요.

퍼블리싱 워크플로

업적을 라이브로 만들어 사용자가 볼 수 있게 하려면, 퍼블리싱 워크플로를 따릅니다.

  1. 데브 샌드박스에서 업적을 생성합니다.
  2. 업적을 스테이지 샌드박스로 푸시합니다. 에픽게임즈에서 모더레이션 프로세스에 따라 업적을 리뷰합니다.
  3. 업적을 라이브 샌드박스로 푸시합니다.

참고: 한 샌드박스에서 다른 샌드박스로 에픽게임즈 스토어 업적을 푸시하면, 대상 샌드박스에 링크된 디플로이의 모든 업적이 교체됩니다.

업적을 스테이지로 푸시

업적을 스테이지로 푸시하려면, 업적 목록 위의 스테이지로 푸시(PUSH TO STAGE) 를 선택합니다. 버튼이 활성화되지 않았다면, 먼저 해결해야 하는 오류가 있다는 뜻입니다. 페이지의 경고 상자에 이러한 오류가 나열됩니다.

업적 모더레이션

모더레이션 프로세스 동안, 에픽게임즈에서는 성인 콘텐츠와 비속어, 에셋 플립과 같은 부적절한 콘텐츠를 찾습니다.

에픽게임즈에서는 링크해제된 업적(즉, 에픽 온라인 서비스 업적)을 모더레이션하지 않습니다. 에픽게임즈에서는 에픽게임즈 스토어 업적만 모더레이션합니다.

에픽게임즈 스토어 업적이 모더레이션을 통과하지 못하는 경우

에픽게임즈에서 에픽게임즈 스토어 업적을 거부한 경우, 스테이지 샌드박스에 아래의 메시지가 표시됩니다.

자세한 내용을 확인하려면, 세부사항 보기(SEE DETAILS) 를 선택합니다.

문제를 해결하려면, 데브 샌드박스로 전환하고 필요한 변경을 한 다음, 승인을 위해 스테이지에 업적을 다시 제출합니다.

참고:

  • 스테이지로 푸시한 경우, 제품 승인 전에 언제든지 추가로 변경할 수 있습니다. 추가로 변경하려면, 스테이지로 푸시를 취소하고 데브 샌드박스에서 변경한 다음, 제품을 다시 스테이지로 푸시합니다.
  • 업적 세트를 변경하면, 모더레이션을 위해 전체 업적 세트를 스테이지에 다시 제출해야 합니다.

업적이 모더레이션을 통과한 경우

에픽게임즈에서 업적을 승인한 경우, 화면 상단에 메시지가 표시되며 라이브로 푸시할 수 있는 버튼이 표시됩니다.

업적을 라이브로 푸시

업적을 라이브로 만들면, 다음과 같은 제한 사항이 적용됩니다.

  • 라이브 업적의 XP를 조정할 수 없습니다.
  • 라이브 업적을 삭제하려면 에픽게임즈 지원팀에 문의해야 합니다.
  • 라이브 업적 텍스트나 업적 이미지를 변경하려면 일반 퍼블리싱 플로를 따릅니다.

업적을 라이브로 만드는 절차는 다음과 같습니다.

  1. 스테이지 샌드박스로 전환합니다.
  2. 업적 목록 위에서 라이브로 푸시(PUSH TO LIVE) 를 선택합니다.

에픽게임즈 스토어 업적에 대한 XP 요구 사항

에픽게임즈 스토어 업적의 경험치(XP)는 다음과 같은 요구 사항을 충족해야 합니다.

  • 얼마나 많은 업적을 정의하든 상관없이 각 제품의 총 XP는 정확히 1,000XP여야 합니다.
  • 게임에 1,000XP 초과 또는 미만의 XP 값을 추가하면 오류 메시지가 표시됩니다.
  • 제품의 XP가 1,000XP보다 많거나 적으면, 데브에서 스테이지로 업적을 푸시할 수 없습니다.
  • 업적 테이블 위의 게임 서비스(Game Services) > 업적(Achievements) > 에픽게임즈 스토어 업적(Epic Games Store achievements) 에서 제품의 총 XP를 확인할 수 있습니다.
  • 각 업적의 XP 값은 5의 배수여야 합니다(예: 5, 10, 15, 100, 110, 200 등).
  • 단일 업적의 최소 XP는 5, 최대 XP는 200입니다.
  • 참고 : 업적이 포함된 DLC를 추가할 예정이거나 전체 업적에서 XP 총계를 1,000 넘게 요구할 경우, 계속 에픽 온라인 서비스 업적을 사용해야 합니다. 1,000XP를 초과하는 업적은 향후 릴리스에서 지원할 예정입니다.
  • 참고 : 에픽게임즈 스토어 업적은 다음과 같이 브론즈, 실버, 골드로 분류됩니다.
    • 5~45XP: 브론즈
    • 50~95XP: 실버
    • 100~200XP: 골드
    • 추가 플래티넘 티어 업적이 있습니다. 제품 사용자가 제품에서 총 1,000XP를 획득하면 이 업적이 잠금해제됩니다.