# 스냅샷 버전 관리

## 스냅샷 버전 관리

스냅샷 버전 관리를 통해 에이전시는 스냅샷 새로고침 후 정확히 무엇이 변경됐는지 확인할 수 있습니다. 버전 기록으로 추가, 제거, 동기화된 에셋을 검토하고, 계정 스냅샷의 버전 참조를 활용하여 팀원 간 협업을 원활하게 유지하세요. 이 가이드에서는 버전 보기, 변경사항 해석, 더 빠른 감사를 위한 모범 사례를 설명합니다.

***

**목차**

* [스냅샷 버전 관리란?](#스냅샷-버전-관리란)
* [스냅샷 버전 관리의 주요 장점](#스냅샷-버전-관리의-주요-장점)
* [버전 기록 패널](#버전-기록-패널)
* [버전 기록 상세 정보 (추가, 제거, 동기화)](#버전-기록-상세-정보-추가-제거-동기화)
* [스냅샷 목록의 버전 참조](#스냅샷-목록의-버전-참조)
* [스냅샷 버전 관리 사용 방법](#스냅샷-버전-관리-사용-방법)
* [예시 사용 사례](#예시-사용-사례)
* [자주 묻는 질문](#자주-묻는-질문)

***

## **스냅샷 버전 관리란?**

스냅샷 버전 관리는 Hyperclass의 스냅샷 에셋 뷰어를 개선한 기능으로, 스냅샷을 성공적으로 새로고침할 때마다 새 버전을 기록합니다. 팀은 시간순으로 정리된 버전 기록을 탐색하고, 원하는 버전의 세부 정보를 열어서 이전 버전 대비 변경사항을 파악할 수 있습니다. 이를 통해 하위 계정 간 에셋 복사에 사용하는 템플릿의 변경사항을 정확하게 추적할 수 있습니다.

버전 관리를 통해 스냅샷을 새로고침할 때마다 업데이트 기록을 명확하게 볼 수 있습니다. 각 업데이트에서는 이전 버전과 비교하여 무엇이 추가됐고, 제거됐으며, 동일하게 유지됐는지 보여줍니다. 스냅샷을 관리하거나 공유하는 모든 곳에 버전이 표시되어 팀과 고객이 항상 같은 정보를 공유할 수 있습니다. 각 항목은 계정 내 위치도 표시하여 나중에 쉽게 찾아서 편집할 수 있습니다.

***

### **스냅샷 버전 관리의 주요 장점**

시간에 따른 변경사항 파악은 협업과 문제 해결에 필수적입니다. 버전 관리는 이런 가시성을 중앙화하여 스냅샷 내용을 빠르게 감사하고 고객 및 팀원과 조율할 수 있게 해줍니다.

* **감사 추적:** 고수준 변경사항 요약과 함께 시간순 버전 목록을 검토할 수 있습니다.
* **빠른 문제 해결:** 버전을 비교하여 공유와 가져오기 사이에 무엇이 변경됐는지 확인할 수 있습니다.
* **팀 협업 강화:** 모든 구성원이 동일한 버전을 사용하고 있는지 확인하여 동기화를 유지합니다.
* **운영 정확성:** 상품 카테고리 라벨이 하위 계정의 올바른 영역으로 안내하여 에셋을 쉽게 찾을 수 있습니다.
* **업무 효율성:** 수동 스프레드시트 작업을 내장된 신뢰할 수 있는 기록으로 대체합니다.

***

### **버전 기록 패널**

버전 기록 패널은 성공적인 새로고침으로 생성된 모든 버전의 날짜별 목록을 제공합니다. 누가 스냅샷을 새로고침했는지, 무엇이 변경됐는지 한눈에 확인할 수 있습니다.

표시되는 내용:

* 생성 날짜/시간이 포함된 **시간순 버전 목록**
* 이전 버전 대비 **추가**, **제거**, **동기화** 수를 나타내는 **간결한 변경사항 요약**
* **버전을 선택**하여 상세 요약을 열 수 있는 기능

![버전 기록 패널](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055599954/original/C8q_9Rc1Tp9HqqUXbrB9PHzt28zsy__fXg.png?1760005997)

***

### 버전 기록 상세 정보 (추가, 제거, 동기화)

버전을 열면 이전 버전과의 차이점을 이해하는 데 도움이 되는 에셋의 그룹별 요약이 표시됩니다. 이 보기를 통해 특정 퍼널, 워크플로우 또는 기타 에셋이 변경됐는지 확인할 때의 추측을 줄일 수 있습니다.

세부 정보 보기에서 할 수 있는 것:

* 유형별로 그룹화된 에셋 보기 (예: **퍼널**, **워크플로우**, **이메일** 등)
* 직전 버전과 비교하여 **추가**, **제거** 또는 **동기화**된 에셋 검토
* 공유 또는 가져오기 전에 버전의 정확한 내용을 확인하는 데 이 정보 활용

![버전 기록 상세 정보](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055600025/original/6ilCqeuOnHL6MNThsdctQFZ2_vE1LorX5g.png?1760006042)

***

### **스냅샷 목록의 버전 참조**

버전 참조는 주요 스냅샷 목록에 표시되어 파트너나 고객과의 협업 중에 어떤 버전이 공유되거나 가져와졌는지 빠르게 확인할 수 있습니다.

버전 참조가 표시되는 곳:

* **내 스냅샷**
* **가져온 스냅샷**
* **공유된 스냅샷**

![스냅샷 목록의 버전 참조](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055599606/original/So-UQwCFZv2OQYOym3NbD-8An7lz0edoUQ.gif?1760005741)

***

### 스냅샷 버전 관리 사용 방법

적절한 설정을 통해 팀이 일관되게 버전을 기록하고 검토 시 버전 기록을 활용할 수 있습니다. 다음 단계를 따라 일상 업무에서 버전 관리 사용을 시작하세요.

* **에이전시 뷰** → **계정 스냅샷** → **내 스냅샷**으로 이동합니다.

![에이전시 뷰 접근](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055597317/original/rEXKDKbkUDdJPI-CvIy21q9JyNFSssGO8w.png?1760004905)

* 스냅샷 이름을 클릭하여 **스냅샷 에셋 뷰어**를 엽니다.

![스냅샷 에셋 뷰어 열기](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055597565/original/uNsdQ3in6y80bpvNF74F1FAzrkQevGcw2Q.png?1760005018)

* **버전 기록** 탭으로 전환하여 기록된 모든 버전을 확인합니다.

![버전 기록 탭](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055597936/original/hKfQ6SXM8gBmu4iSd3md-PHuhhos9mMYfA.png?1760005109)

* **버전 기록**에서 원하는 버전 행을 클릭하여 **버전 상세 정보** 요약(추가/제거/동기화)을 엽니다.

![버전 상세 정보 열기](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055598205/original/ud2H4r-SGSmiS3b1aH2o075k5HieRugoLQ.png?1760005285)

* 에셋을 추가하거나 업데이트한 후에는 **내 스냅샷** 목록 보기에서 **스냅샷 새로고침**을 클릭합니다. 성공적인 **새로고침** 후에 **새 버전**이 생성됩니다.

![스냅샷 새로고침](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055598717/original/jecfRzO9tbE-1i1455jJMqLIUzBrV5I6fQ.png?1760005455)

* 공유하거나 가져올 때는 내 스냅샷/가져온 스냅샷/공유된 스냅샷의 버전 참조를 사용하여 협력자와의 버전 일치를 확인합니다.

***

### 예시 사용 사례

다음 시나리오는 버전 기록과 버전 참조를 실제로 활용하는 방법을 보여줍니다. 팀이 릴리스를 조율하고, 고객과의 불필요한 소통을 줄이며, "무엇이 변경됐나요?" 질문을 빠르게 해결할 수 있습니다.

* **대규모 배포 내용 결정:** 여러 위치에 업데이트를 배포하기 전에 **버전 기록**에서 의도한 버전을 확인하고 변경사항을 스캔하여 불완전한 변경사항 배포를 방지합니다. 그 다음 배포 워크플로우를 진행하세요. [**고객 계정에 스냅샷 업데이트 푸시 및 로딩**](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/19-에이전시-뷰/Snapshots/pushing-loading-snapshot-updates-to-client-accounts.md)과 [**스냅샷 푸시 업데이트 기록**](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/19-에이전시-뷰/Snapshots/snapshot-push-update-history.md)을 참조하세요.
* **새로고침 전 사전 QA:** 에셋 업데이트 후 **버전 기록**을 열고 최신 버전의 **추가/제거/동기화** 요약을 검토하여 스냅샷을 공유하기 전에 의도한 변경사항만 포함됐는지 확인합니다. [**스냅샷 공유 방법**](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/19-에이전시-뷰/Snapshots/how-to-share-snapshots.md)을 참조하세요.
* **파트너/고객과 정확한 빌드 동기화:** 다른 에이전시나 위치와 협업할 때 **내 스냅샷**의 **버전 참조**를 그들이 **가져온/공유된 스냅샷**에서 보는 것과 비교하여 모든 사람이 동일한 버전으로 작업하는지 확인합니다.
* **가져오기 후 누락되거나 예상치 못한 에셋 문제 해결:** 위치에서 퍼널/워크플로우가 누락됐다고 보고하는 경우, 가져온 버전의 **버전 상세 정보**를 열어 해당 에셋이 **제거**됐는지 **동기화**됐는지 확인합니다. 그 다음 **상품 카테고리 라벨**을 사용하여 사용자를 올바른 영역으로 안내하세요. 관련 문서: [**스냅샷 가져오기 방법**](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/19-에이전시-뷰/Snapshots/how-to-import-snapshots.md).
* **정리 중 폐기 항목 확인:** 템플릿에서 에셋을 퇴출하는 경우, 스냅샷을 새로고침하고 해당 항목이 최신 버전의 **제거됨**에 나타나는지 확인합니다. 이를 통해 정리 작업이 스냅샷에 반영됐음을 확인할 수 있습니다.

***

### 자주 묻는 질문

**Q: 버전은 언제 생성되나요?** 새 버전은 **스냅샷 새로고침이 성공한 후**에 생성됩니다. 새로고침 없이 스냅샷을 열거나 편집하는 것만으로는 버전이 생성되지 않습니다.

**Q: 스냅샷을 이전 버전으로 되돌릴 수 있나요?** 버전 관리는 감사를 위한 가시성과 참조를 제공하며, 내장된 되돌리기/복원 작업은 포함하지 않습니다.

**Q: 새로고침 실패 시에도 버전이 생성되나요?** 아니요. 버전은 성공적인 새로고침에 대해서만 생성됩니다.

**Q: 버전 참조는 어디서 볼 수 있나요?** 버전 참조는 **내 스냅샷**, **가져온 스냅샷**, **공유된 스냅샷** 목록에 나타납니다.

**Q: 누가 버전 기록과 버전 상세 정보를 볼 수 있나요?** 접근 권한은 사용자 역할과 권한에 따라 달라집니다. 자세한 안내는 \*\*[스냅샷의 세분화된 권한](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/19-에이전시-뷰/Snapshots/granular-permissions-for-snapshots.md)\*\*을 참조하세요.

**Q: 버전 상세 정보에서 "동기화"는 무엇을 의미하나요?** "동기화"는 해당 에셋이 추가되거나 제거되지 않고 이전 버전과 현재 버전 모두에 포함되었음을 나타냅니다.

**Q: 버전 관리가 고객 하위 계정을 자동으로 업데이트하나요?** 아니요. 버전 관리는 정보 제공 목적입니다. 위치에 업데이트를 푸시/로딩하는 것은 별도의 워크플로우입니다.

**Q: 여러 위치에 푸시하기 전에 버전 기록을 어떻게 사용해야 하나요?** 먼저 **버전 기록**에서 의도한 스냅샷 버전을 확인한 다음 푸시를 진행하세요. 푸시 중 알림 동작에 대해서는 \*\*[스냅샷 푸시의 롤링 알림](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/19-에이전시-뷰/Snapshots/rolling-notifications-for-snapshot-push.md)\*\*을 참조하세요.

***

*원문 최종 수정: Tue, 14 Oct, 2025 at 10:35 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/settings/user-access/snapshot-version-management.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.