# 화이트라벨 모바일 앱 커스터마이저에 구글 플레이스토어 계정 연결하기

## 화이트라벨 모바일 앱 커스터마이저에 구글 플레이스토어 계정 연결하기

## **구글 플레이: 계정 연결 및 앱 설정**

### **개요**

이 가이드는 하이퍼클래스(HighLevel)의 에이전시 앱 매니저(Agency App Manager) 내에서 구글 플레이 온보딩 과정을 완전히 통합한 내용입니다. 구글 플레이 개발자 계정을 연결한 후, 안드로이드 패키지 이름을 등록하여 하이퍼클래스가 브랜딩된 앱을 빌드하고 제출할 수 있도록 합니다. 여기서는 두 튜토리얼을 하나의 완전한 워크플로우로 통합했습니다.

#### 주의사항

* 시작하기 전에 관리자 권한을 가진 구글 플레이 개발자 계정이 필요합니다.
* 패키지 이름은 고유해야 하고 영구적이므로, 게시 후에는 변경할 수 없으니 신중하게 선택하세요.
* 패키지 이름에는 소문자, 숫자, 마침표만 사용하세요 (예: com.brand.appname).
* 권한 오류를 방지하기 위해 전체 과정 동안 구글 계정을 로그인 상태로 유지하세요.

### **이 가이드에서 다루는 내용**

* 이 워크플로우가 하는 일
* 사전 준비사항
* 하이퍼클래스에서 구글 플레이 개발자 계정 연결하기
* 앱 설정에서 안드로이드 패키지 이름 등록하기
* 검증 및 일반적인 오류
* 자주 묻는 질문

### **사전 준비사항**

* 관리자 권한을 가진 유료 구글 플레이 개발자 계정
* 플레이 개발자 계정을 소유한 구글 계정에 대한 접근 권한
* 역방향 DNS 형식을 따르는 명확한 패키지 이름 계획 (예: com.company.product)

### **1단계: 하이퍼클래스에서 구글 플레이 개발자 계정 연결하기**

영상 튜토리얼: <https://app.arcade.software/share/vN0AiiOM6x2ZTKlsUqD9>

* **에이전시 앱 매니저 열기** 하이퍼클래스에서 좌측 네비게이션의 \*\*Mobile App(모바일 앱)\*\*으로 이동합니다.
* \*\*Agency App Manager(에이전시 앱 매니저)\*\*를 엽니다. \*\*Apple App Store(애플 앱스토어)\*\*와 **Google Playstore(구글 플레이스토어)** 두 개의 타일이 보이고, 각각 **Set Up(설정)** 버튼이 있습니다.
* 좌측의 **Steps(단계)** 레일에서 \*\*Distribution(배포)\*\*이 표시되는지 확인합니다.
* **구글 플레이 연결 시작** **Google Playstore(구글 플레이스토어)** 타일의 \*\*Set Up(설정)\*\*을 클릭합니다.
* 플레이 스토어 연결 폼이 로드됩니다.
* **연결 이름 지정** \*\*Play Store account name(플레이 스토어 계정 이름)\*\*에 귀하와 팀이 인식할 수 있는 짧은 라벨을 입력합니다 (예: 에이전시나 브랜드 이름).
* 나중에 여러 플레이 계정을 연결할 계획이라면 고유한 라벨을 사용하세요.
* **내장 링크로 구글 플레이 콘솔 열기** 폼의 링크를 클릭하여 구글 개발자 계정 페이지를 엽니다. 이 링크는 새 탭에서 \*\*![구글 플레이 콘솔](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155062059746/original/vySdHUQJmHcgZuq_iptJP2rBYZ_bsXsx-w.png?1767731032) [Google Play for business | Launch & monetize your apps | Google Play Console](https://play.google.com/console/developers)\*\*로 이동합니다.
* **Google Play Developer(구글 플레이 개발자)** 프로그램을 소유한 구글 계정으로 로그인합니다. 이미 로그인되어 있다면 올바른 계정인지 확인하세요.
* **플레이 콘솔에서 접근 권한 확인** 개발자 콘솔 홈 화면에 도달할 수 있는지 확인합니다.
* 구글에서 업데이트된 약관 동의나 계정 확인을 요구하면 완료하세요.
* 권한 오류가 표시되면 소유자(Owner)나 관리자(Admin)에게 \*\*Users and permissions(사용자 및 권한)\*\*에서 **Admin(관리자)** 권한을 부여해달라고 요청하세요.
* **하이퍼클래스로 돌아가서 저장** 하이퍼클래스 탭으로 돌아갑니다.
* **Play Store account name(플레이 스토어 계정 이름)** 필드가 채워졌는지 확인합니다.
* **Save(저장)** 또는 \*\*Continue(계속)\*\*를 클릭하여 연결 세부사항을 저장합니다.
* 이제 Google Playstore 타일에 계정이 연결되었다고 표시됩니다. 여전히 연결되지 않았다고 표시되면 페이지를 새로고침하고 다시 시도하세요.
* **다음 단계로 넘어가기 전 빠른 확인사항**
  * 브라우저에서 올바른 구글 계정으로 로그인되어 있습니다.
  * 플레이 개발자 계정이 활성화되어 있고 정상 상태입니다.
  * 플레이 콘솔에서 관리자 수준의 권한을 보유하고 있습니다.

**팁**: 같은 브라우저에서 여러 구글 계정을 관리하는 경우, 시크릿 창을 열고 플레이 개발자 프로그램을 소유한 계정으로만 로그인하세요. 이렇게 하면 잘못된 계정을 연결하는 것을 방지할 수 있습니다.

### **2단계: 앱 설정에서 안드로이드 패키지 이름 등록하기**

영상 튜토리얼: <https://app.arcade.software/share/xiKjlvnbJ6kHP1CBc8oW>

* 동일한 연결 워크플로우에서 **App Setup(앱 설정)** 단계를 엽니다.
* \*\*Register(등록)\*\*를 클릭하여 안드로이드 패키지 이름을 생성합니다.
* **역방향 DNS 형식의 식별자**를 입력합니다 (예: com.youragency.clientapp). 공백이나 대문자는 피하세요.
* **등록 확인**. 하이퍼클래스가 값을 검증하고 등록을 완료합니다. 패키지 이름이 등록되면 성공 상태를 확인할 수 있습니다.
* 앱 배포 설정의 다음 단계로 계속 진행하거나, 아직 에셋을 준비해야 한다면 나중에 돌아오세요.

### **검증 및 일반적인 오류**

* **패키지 이름이 이미 사용됨**: 새로운 값을 선택하세요 (예: 이니셜이나 지역 코드 추가 - [com.youragency.clientapp.na](http://com.youragency.clientapp.na)).
* **권한 부족**: 플레이 개발자 계정의 관리자인지 확인하거나, 계정 소유자 또는 관리자에게 사용자 및 권한에서 권한을 부여해달라고 요청하세요.
* **빌드와의 불일치**: 앱의 빌드 파일에 있는 패키지 이름이 등록된 값과 일치하는지 확인하세요. 안드로이드 프로젝트와 관련 서비스에서 동일한 식별자를 일관되게 사용하세요.

### 자주 묻는 질문

Q: 이 과정을 완료하려면 플레이 콘솔의 관리자여야 하나요?

A: 네, 앱 등록 및 배포 설정을 관리하려면 관리자(Admin) 또는 소유자(Owner) 권한이 필요합니다.

Q: 패키지 이름을 나중에 변경할 수 있나요?

A: 아니요, 앱이 게시되면 패키지 이름은 영구적입니다. 나중에 다른 이름이 필요하다면 새로운 앱으로 게시해야 합니다.

Q: 많은 클라이언트 앱을 가진 에이전시를 위한 좋은 명명 패턴은 무엇인가요?

A: 안정적인 역방향 DNS 베이스에 클라이언트 접미사를 사용하세요 (예: com.agencyname.clientbrand).

Q: 모든 브랜드마다 새로운 플레이 개발자 계정을 만들어야 하나요?

A: 아니요, 하나의 플레이 개발자 계정으로 여러 앱을 소유할 수 있습니다. 하이퍼클래스에서 각 연결에 대해 명확한 라벨을 사용하여 어떤 앱이 어떤 클라이언트에 속하는지 추적할 수 있습니다.

***

*원문 최종 수정: Tue, 24 Mar, 2026 at 6:21 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/and/linking-google-playstore-account-to-the-whitelabel-mobile-app-customizer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.