문제 해결

스튜디오에서 가장 자주 발생하는 문제들과 그 원인, 문의 전 확인 사항을 정리했습니다. 여기서 다루지 않는 내용은 FAQ를 참고하거나 support에 문의하세요.

플레이어가 인증 또는 초대 이메일을 받지 못했습니다

주요 원인 — 플레이어 측의 메일 수신 문제이거나, 입력된 이메일 주소와 실제 확인하는 주소가 다른 경우입니다.

확인 사항

플레이어에게 스팸 또는 정크 메일 폴더를 확인해 달라고 요청하세요.
대시보드에서 해당 플레이어의 레코드를 열어 이메일 주소가 올바른지 확인하세요. 플레이어 프로필에서 수정할 수 있습니다.
플레이어의 인증 코드가 계속 실패하는 경우, 인증된 이메일을 제공하는 소셜 계정으로 로그인하면 인증 단계를 건너뛸 수 있습니다. 계정 연동을 참고하세요.
수신 거부는 원인이 아닙니다. 플레이테스트 초대 및 로그인 링크와 같은 중요 이메일은 공지 수신을 거부한 플레이어에게도 항상 발송됩니다. 이메일 마케팅 수신 거부를 참고하세요.

지원 문의 시점 — 여러 플레이어에게 지속적으로 미수신이 발생하는 경우 개별 수신함 문제를 넘어선 원인일 수 있으므로 support에 문의하세요.

Discord 역할 또는 채널이 업데이트되지 않습니다

주요 원인 — Discord 변경 사항은 FirstLook 역할 할당과 별도로 대기열에 추가되어 처리됩니다. FirstLook 역할은 즉시 적용되지만, Discord 반영은 특히 가입자 급증 시 지연될 수 있습니다. 대기열이 밀리면 대시보드에 Large Queue Processing 배너가 표시됩니다.

확인 사항

가장 흔한 잘못된 설정: FirstLook 봇의 역할은 Discord 서버 설정에서 할당해야 할 역할보다 위에 위치해야 합니다. 역할 순서 올바르게 설정하기를 참고하세요.
대시보드에서 Large Queue Processing 배너를 확인하세요. 배너가 표시되는 경우 급증한 요청을 처리 중인 것이므로 잠시 기다려 주세요. 백그라운드에서 발생하는 작업을 참고하세요.
채널 동기화의 경우: 동기화된 게시물은 즉시가 아닌 일정에 따라 업데이트되며, 봇이 동기화할 채널에 접근 권한이 있어야 합니다. Discord 설정 페이지의 Test Discord Integration 버튼을 사용하여 봇의 권한을 확인하세요. Discord 채널 동기화를 참고하세요.
플레이어가 서버에 전혀 참가하지 않는 경우, 플로우의 “Automatically add players if they connected their Discord Account” 토글을 확인하세요. FAQ를 참고하세요.

지원 문의 시점 — 대기열이 해소되고 봇의 역할 순서가 올바른데도 역할이 적용되지 않는 경우.

Discord 서버의 연결을 해제하거나 변경해야 합니다

오류가 아닙니다. FirstLook 프로젝트에는 Discord 서버를 하나만 연결할 수 있으므로, 서버를 전환하려면 먼저 연결을 해제해야 합니다. Configuration → Discord로 이동하여 Request Unlink를 사용해 티켓을 생성하면 FirstLook 팀이 연결 해제를 처리합니다. Discord 서버 연결 해제를 참고하세요.

계정 또는 채널 연결 시 “This account is already linked” 오류가 발생합니다

주요 원인 — 해당 플랫폼 계정 또는 채널이 이미 다른 FirstLook 프로필에 연결되어 있습니다. 크리에이터의 경우, 채널은 하나의 크리에이터 프로필에만 연결할 수 있습니다.

확인 사항

플레이어 또는 크리에이터에게 두 번째 계정(예: 다른 이메일로 이전에 가입한 계정)이 있는지 확인해 보세요.
플레이어의 경우, 대시보드의 프로필에서 잘못 연결된 플랫폼 계정을 해제하면 올바른 계정을 연결할 수 있습니다. FAQ의 “A player linked the wrong steam, discord account, email address”를 참고하세요.

지원 문의 시점 — 다른 계정을 찾을 수 없는 경우 support에 문의하세요.

가져온 키가 표시되지 않습니다

주요 원인 — 대용량 키 가져오기는 백그라운드에서 비동기적으로 처리되므로, 업로드 직후 표시되는 수량이 불완전해 보일 수 있습니다.

확인 사항

몇 분 기다리세요. 처리가 완료되면 수량이 채워집니다.
파일이 10 MB 미만이고 한 줄에 키가 하나씩 입력되어 있는지 확인하세요. 대규모 작업 및 제한 사항 및 파일 요구 사항을 참고하세요.

지원 문의 시점 — 가져오기 후 충분한 시간이 지났음에도 키가 표시되지 않고 파일이 요구 사항을 충족하는 경우.

게임 내 설문조사가 표시되지 않습니다

확인 사항

사용 중인 엔진의 SDK 테스트 단계를 수행하세요: Unity 또는 Unreal.
설문조사에 게임 클라이언트 배포가 활성화되어 있고 트리거가 설정되어 있는지 확인하세요. 트리거는 게임이 지정된 횟수만큼 이벤트를 전송할 때 발동되며, 각 설문조사는 플레이어당 한 번만 표시됩니다. 트리거 설정을 참고하세요.
게임 내 설문조사는 해당 기능이 포함된 플랜이 필요합니다. 기능이 전혀 표시되지 않는 경우 플랜을 확인하세요.

지원 문의 시점 — SDK 테스트 단계가 통과되고 트리거가 설정되었음에도 설문조사가 표시되지 않는 경우.

API에서 기능이 비활성화되었다는 403 오류가 반환됩니다

주요 원인 — 403 오류에 게임에 활성화되지 않은 기능이 명시됩니다. 일부 엔드포인트는 먼저 활성화해야 하는 기능에 의존합니다.

확인 사항 — FirstLook Labs를 통해 오류에 명시된 기능을 활성화하거나, support에 문의하여 게임에 해당 기능을 활성화해 달라고 요청하세요.

다른 문제가 있으신가요? FAQ를 확인하거나 support에 문의하세요.