# 커스터마이제이션 활용하기: 커스텀 JavaScript로 마켓플레이스 앱 기능 확장

마켓플레이스 앱의 커스텀 JavaScript 및 CSS

커스텀 JavaScript 기능은 마켓플레이스 앱(Marketplace Apps)에 커스텀 JavaScript 코드를 추가하여 플랫폼의 기능을 확장합니다. 이 기능을 통해 개발자는 에이전시(Agency)에서 배포하는 앱 내에서 플랫폼 기능을 개인화하고 확장할 수 있습니다.

## 소개

플랫폼에 커스텀 JavaScript와 CSS를 통합하는 기능은 에이전시에서 배포하는 앱의 기능성과 미적 요소를 향상시키려는 개발자들에게 다양한 가능성을 열어줍니다. 이 기능은 높은 수준의 커스터마이제이션을 지원하며 플랫폼 내에서 더욱 동적인 상호작용을 가능하게 합니다. 하지만 플랫폼의 무결성, 보안, 성능을 유지하기 위해 모든 커스텀 스크립트는 배포 전에 철저한 검토 과정을 거쳐야 합니다.

## 배포 타입

커스텀 JavaScript 코드를 추가하려면 앱의 배포 타입(Distribution Type)이 Agency 또는 Agency & Sub-account여야 합니다.

## 검토 과정 및 가이드라인

에이전시 배포 앱용 커스텀 JavaScript나 CSS를 제출할 때는 다음 가이드라인을 준수하여 원활한 검토 과정을 보장하세요. 검토 과정은 최대 10일의 서비스 수준 협약(SLA)을 가지고 있습니다. 승인되면 스크립트가 에이전시 앱에 임베드됩니다.

## 커스텀 스크립트 가이드라인

* **민감한 데이터 접근**: 커스텀 스크립트는 의도하지 않은 데이터 조작이나 충돌을 방지하기 위해 민감한 데이터에 접근해서는 안 됩니다.
* **난독화 코드**: 난독화된 코드 사용을 피하세요. 잠재적인 보안 위험을 방지하고 스크립트 의도가 명확하게 드러나도록 읽기 쉬운 코드가 필요합니다.
* **데이터베이스 접근**: 데이터 무결성과 보안을 유지하기 위해 커스텀 스크립트는 데이터베이스에 직접 접근해서는 안 됩니다.
* **원격 파일 참조**: 모든 로직은 자체 포함되어야 합니다. 원격 파일 참조나 실시간 스크립트 로드는 허용되지 않습니다.
* **스크립트 삽입**: DOM과의 올바른 통합을 위해 JavaScript 코드가 `<script>` 태그 내에 적절히 삽입되었는지 확인하세요.
* **콘솔 로그 피하기**: 깨끗하고 효율적인 코드를 유지하기 위해 커스텀 스크립트에 console.log 문을 포함하지 마세요.

## 제출 전 테스트

잠재적인 문제를 피하기 위해 제출 전에 커스텀 스크립트를 철저히 테스트하세요. 에이전시 뷰에서 `Settings(설정) → Company` 아래의 Custom JavaScript & Custom CSS 섹션에 추가하여 테스트할 수 있습니다. 에이전시 접근 권한이 없다면 샌드박스 계정을 생성하여 환경을 시뮬레이션하고 스크립트를 테스트하는 것을 고려해보세요.

이러한 가이드라인을 따라 주시면 모든 사용자를 위한 안전하고 신뢰할 수 있는 플랫폼 경험에 기여하게 됩니다. 협조해 주셔서 감사하며, 우리 플랫폼을 향상시키는 혁신적인 방법들을 기대하고 있습니다!

[커스텀 JS 래퍼 함수 활용 방법](https://highlevel.stoplight.io/docs/integrations/342bca923152a-custom-js)

***

*원문 최종 수정: Fri, 29 Nov, 2024 at 12:03 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/developer/unlocking-customization-enhancing-marketplace-apps-with-custom-javascript.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.