웹숍 문제 해결
Unity 웹숍 제작, 테마 지정, 퍼블리싱, 통합과 관련된 일반적인 문제를 해결합니다.
읽는 시간 2분최근 업데이트: 10일 전
이 페이지는 Unity 웹숍을 사용하는 동안 관리자와 게임 개발자가 겪는 가장 일반적인 문제를 증상별로 그룹화하여 수집합니다. 각 엔트리에서 가장 가능성이 높은 원인을 명명하고 이를 해결하는 대시보드 또는 코드 변경 사항을 명명합니다.
웹숍 생성
이미 사용 중인 것처럼 슬러지가 거부됨
원인
슬러그는 스튜디오 내에서 고유합니다. 조직 내 다른 웹숍에서 이미 이 슬러그를 사용하고 있습니다.해결 방법
다른 슬러그를 선택하거나 URL의 용도를 변경하려는 경우 기존 웹숍의 슬러그를 먼저 변경합니다. 전체 슬러그 규칙은 웹 쇼핑 한도 참조를 참조하십시오.생성 중에 스튜디오 이름이 거부됨
원인
스튜디오 이름은 Unity 전역에서 고유합니다. 다른 조직이 이미 이름을 청구했습니다. 다이얼로그에는 다음과 같은 인라인 오류 메시지가 표시됩니다.스튜디오 이름이 이미 사용되었습니다. 이 상표를 소유하고 있는 경우 trademarks@unity3d.com으로 문의하여 상표를 등록하십시오.
해결 방법
다른 이름을 선택합니다. 조직 간에는 자동 전송 플로가 없습니다. 사용된 이름에 등록상표를 보유하고 있는 경우, 릴리스를 요청하도록trademarks@unity3d.comCreate webshop 다이얼로그에서 Studio 필드가 비활성화됩니다.
원인
조직에 이미 하나 이상의 웹캠이 있으므로 스튜디오 이름이 설정되고 재사용됩니다. Create 다이얼로그는 조직에 아직 웹캠이 없는 경우에만 새 스튜디오 이름을 허용합니다.해결 방법
스튜디오의 이름을 변경하려면 Create 다이얼로그를 닫고 Monetization > Settings > Organization로 이동한 후 Studio name 필드를 편집합니다. 이름 변경은 동일한 고유성 검사를 실행하고 조직 내 모든 웹캠의 URL을 변경하므로 그에 따라 외부 링크를 업데이트합니다.참고
레거시 Unity Dashboard를 사용하는 경우 계정 메뉴를 열고 Manage organization을 선택합니다.
동일한 프로젝트에 대한 두 번째 웹숍을 생성할 수 없습니다.
원인
각 Unity 클라우드 프로젝트에는 정확히 하나의 웹캠이 있을 수 있습니다.해결 방법
기존 웹숍을 편집하거나 두 번째 스토어에 새 Unity Cloud 프로젝트를 생성합니다.퍼블리싱
Publish 버튼이 누락되었거나 비활성화되었습니다.
원인
비프로덕션 환경을 편집하고 있습니다. 프로덕션 환경만 퍼블리시할 수 있습니다. 비프로덕션 환경은 드래프트 전용이며, 퍼블리시 대신 저장 드래프트를 표시합니다.해결 방법
편집 뷰 상단의 환경 선택기를 프로덕션으로 전환하여 퍼블리시하거나, 비 프로덕션 환경의 테마 커스터마이즈 섹션에서 프로덕션에 적용하여 초안을 프로덕션으로 복사한 다음 프로덕션으로 전환하여 퍼블리시할 수 있습니다. 게시 모델은 웹숍 소개를 참조하십시오.상점 URL이 응답을 찾을 수 없음 반환
원인
웹숍이 퍼블리시되지 않았거나, 웹숍이 퍼블리시되지 않았거나, URL에 스튜디오 이름이 잘못되었거나, 슬러그가 잘못되었습니다.해결 방법
스튜디오를 확인하고 슬러그가 대시보드와 일치합니다. 그런 다음 프로덕션 환경의 퍼블리싱 상태를 확인합니다. 스토어가 퍼블리시되지 않은 경우 프로덕션 환경에서 퍼블리시합니다. 스튜디오 이름을 최근에 변경한 경우 이전 URL이 더 이상 유효하지 않으며 대시보드에 표시된 새 URL을 사용합니다.퍼블리싱 후에도 라이브 스토어에 기존 브랜딩이 계속 표시됩니다.
원인
콘텐츠 전송 네트워크가 이전 버전을 캐시했거나 대시보드가 전파가 완료되기 전에 성공을 보고했습니다.해결 방법
잠시 기다린 후 다시 시도합니다. 라이브 스토어에서 이전 버전이 몇 분 후에도 여전히 표시되는 경우 대시보드에서 퍼블리시 작업이 성공적으로 완료되었는지 확인합니다(웹 스토어 리스트의 행에는 로그 보기 아래의 최근 퍼블리시 타임스탬프가 표시됨).브랜딩 및 미디어
브랜딩 업로드 거부
원인
업로드가 파일 크기 제한을 초과했거나 허용되는 형식이 아닙니다.해결 방법
웹숍 제한 참조 및 재시도의 한도 내에 에셋을 다시 익스포트합니다. 소스 업로드는 PNG, JPEG 또는 WebP일 수 있으며, 서버는 배포를 위해 무손실 WebP로 전환됩니다.라이브 스토어에서 영웅 배너가 잘린 모습
원인
업로드된 소스의 종횡비가 렌더링된 배너와 다릅니다. 영웅 배너는 서버 측에서 1920 × 384px로 확대/축소되므로 더 넓거나 더 큰 항목은 적절하게 잘립니다.해결 방법
렌더링된 종횡비(32:10) 이상의 해상도로 다시 업로드하고 종횡비가 동일합니다. 참조 웹 쇼핑 한도 참조.테마
AI 테마 생성 실패
원인
대시보드가 앱 스토어 URL에 도달할 수 없거나, 스크레이프가 사용 가능한 에셋을 반환하지 않거나, 생성 단계가 실패했습니다.해결 방법
앱 스토어 URL에 공개적으로 액세스할 수 있는지 확인합니다. 생성을 재시도 — 대부분의 임시 실패는 다음 시도에서 해결됩니다. 여전히 생성에 실패하면 테마 커스터마이즈 섹션에서 테마를 수동으로 편집합니다. 생성 절차는 AI를 사용하여 웹숍 테마 생성을 참조하십시오.프로덕션 환경에서 생성된 테마가 라이브 아님
원인
비프로덕션 환경은 자체적으로 퍼블리시할 수 없습니다. 비프로덕션 환경에 저장된 테마는 해당 환경의 드래프트에만 존재합니다.해결 방법
테마 커스터마이즈 섹션에서 Apply to production을 선택하여 테마를 프로덕션 드래프트에 복사합니다. 그런 다음 환경 선택기를 프로덕션으로 전환하고 퍼블리시를 선택합니다.카탈로그 및 지급
상품 카드 없이 스토어 렌더링
원인
부모 프로젝트의 IAP 카탈로그가 비어 있거나 퍼블리시된 제품이 없습니다. Mock 카탈로그가 꺼져 있고 실제 카탈로그가 연결되지 않은 경우에도 미리보기 창이 비어있게 렌더링됩니다.해결 방법
대시보드의 IAP 섹션에서 프로젝트에 카탈로그에 제품이 하나 이상 있는지 확인합니다. 에디터에서 카탈로그 만들기를 참조하십시오. 실제 카탈로그를 연결하지 않고도 테마를 미리 보려면 Catalog & payment provider 섹션에서 Mock catalog 토글을 활성화합니다.모의 카탈로그 아이템이 플레이어의 스토어에 나타납니다.
원인
이는 불가능합니다. 모형 제품은 대시보드의 미리보기 창에서만 렌더링됩니다. 플레이어가 플레이어를 보고 있음을 보고하면 공개 URL이 아닌 대시보드 미리보기를 보고 있습니다.해결 방법
플레이어가 Dev 미리보기 URL이 아닌 공개shop.unity.com/{studio}/game/{slug}Dev 미리보기에서 실제 카드를 청구한 테스트 구매
원인
Dev 미리보기 URL은 실제 카탈로그와 실제 IAP 결제 제공업체를 비교하여 초안을 렌더링합니다. 웹캠 레이어에는 샌드박스 경계가 없습니다. 테스트 모드는 IAP 결제 제공업체에서 제어합니다.해결 방법
결제 제공업체의 샌드박스 계정 또는 테스트 카드를 사용하여 포괄적인 구매 테스트를 진행합니다. 미리보기 대 테스트 동작에 대한 웹 상점의 카탈로그 및 결제를 참고하고 샌드박스 설정에 대한 결제 제공업체의 관련 공급자 문서를 참고하십시오.제품 가격이 게임과 일치하지 않음
원인
상점을 열 때 재화 또는 로케일 파라미터가 전달되지 않았으므로 상점은 브라우저 로케일과 기본 재화로 폴백되었습니다.해결 방법
게임에서 상점을 열 때localecurrency딥 링크 및 반환 플로
성공 다이얼로그에 게임으로 돌아가기 버튼이 나타나지 않습니다.
원인
다음의 사전 조건 중 하나가 충족되지 않았습니다. 세션이 직접 열렸거나(게임의 딥 링크를 통해 열리지 않음), 플레이어가 데스크톱에 있거나, 딥 링크가 설정되지 않았습니다.해결 방법
플레이어가 URL을 입력하지 않고 게임의 딥 링크에서 상점을 열었으며 모바일 디바이스에 있는지 확인합니다. 그런 다음 대시보드의 카탈로그 및 결제 공급자 섹션에서 Deeplink URL이 설정되어 있는지 확인합니다. 모든 선행 조건은 세부 링크 및 반환 흐름을 참조하십시오.공유 링크에서 플레이어가 스토어 대신 랜딩 페이지를 볼 수 있음
원인
이는 예상됩니다. 플레이어가 인증 컨텍스트 없이 도착하면 스토어가 인증되지 않은 랜딩 페이지를 렌더링합니다. 이는 게임의 딥 링크가 아닌 브라우저에서 직접 열려 있는 URL의 경우입니다. 시작 페이지에는 설정된 딥 링크 체계를 사용하여 게임을 역실행하는 게임 연결 버튼이 표시됩니다.해결 방법
게임 연결이 작동하면 수정이 필요하지 않습니다. 라운드 트립은 플레이어를 인증하고 스토어에 도착합니다. 버튼에 게임을 실행하는 대신 플레이어에게 게임 내에서 스토어를 실행하라는 메시지가 표시되면 되돌리기 딥 링크가 설정되지 않습니다. Edit 뷰의 Catalog & payment provider 섹션에서 Deeplink URL을 설정합니다. 전체 플로에 대한 내용은 인증되지 않은 시작 페이지를 참조하십시오.게임에 연결하면 게임이 열리지만, 다시 시작한 후에도 상점에 계속 랜딩 페이지가 표시됩니다.
원인
게임은 인바운드{scheme}://Application.deepLinkActivatedstatusOpenShop해결 방법
핸들러가statussessionTokenprojectIdenvironmentOpenShop플레이어가 Return to game을 탭하지만 게임이 다시 열리지 않음
원인
딥 링크 체계가 기기에 등록되어 있지 않거나 대시보드의 구성된 체계가 게임에서 수신하는 체계와 일치하지 않습니다.해결 방법
Android 매니페스트 또는 iOSInfo.plist게임이 열리지만 구매 결과가 표시되지 않음
원인
Application.deepLinkActivatedstatus해결 방법
핸들러가statussuccessApplication.absoluteURL