# 앱 이전 가이드

{% hint style="warning" %}
**\[마이앱 가이드 > 사용 전 필독사항]**&#xC5D0; 안내되는 사용 솔루션에 따른 유의사항은 앱 이전 시에도 동일하게 적용됩니다. 앱 이전 신청 이전에 반드시 해당 내용을 먼저 확인 부탁드립니다.
{% endhint %}

{% hint style="danger" %}
해당 문서는 **기본 스킨 사용자를 대상**으로 작성되었습니다. 기본 스킨을 커스텀 하였거나 샵바이 헤드리스 상점인 경우, 마이앱 호환 가이드에 따라 추가 작업이 필요할 수 있습니다.
{% endhint %}

## **1. 앱 이전 의사 전달**

* 사용중인 앱 서비스 업체에 이전 의사를 전달한 후, 앱 이전에 필요한 정보를 요청해주세요.
  * 아래 정보는 AOS 환경에서만 요구되며, iOS 앱 이전 시에는 필요하지 않습니다.
    * 키스토어 파일&#x20;
    * storePassword(스토어 비밀번호)&#x20;
    * keyAlias(키별칭)&#x20;
    * keyPassword(키 비밀번호)&#x20;

## **2. 마이앱 서비스 신청**

* \[[NHN커머스 워크스페이스 > 앱스토어](https://apps.nhn-commerce.com/?_gl=1*1vqmt0r*_gcl_aw*R0NMLjE3MzkxNzQ4ODAuRUFJYUlRb2JDaE1JNVBYYndvdnVoQU1WX2w4UEFoMWRZUU56RUFBWUFTQUFFZ0wwN2ZEX0J3RQ..*_gcl_au*MTA5NjU3Njk3LjE3MzM3MDMxMTk.*_ga*MTMwMzIxMjA5MC4xNzA0NzU4NjU1*_ga_Z1WW9QB68M*MTczOTE3NDc0MC40ODguMS4xNzM5MTc0ODgwLjU5LjAuMTUwMzUwNDU4MA..)]에 접속한 후, 사용할 쇼핑몰에 마이앱을 설치해주세요.

  <figure><img src="/files/dwLN61h1LIqc0KU74GGu" alt=""><figcaption></figcaption></figure>

* 앱을 설치한 후, 솔루션 관리자에서 마이앱 관리자를 실행해주세요.

  <figure><img src="/files/YKhQXoFzAhXiCBpm1Gpk" alt=""><figcaption></figcaption></figure>

* 마이앱 제작에 필요한 기본/제작정보를 입력한 후 심사를 요청해주세요.&#x20;

  * 메뉴 경로 : 마이앱 > 설정 > 출시정보
  * 이전할 앱이 등록되어 있는 iOS/AOS 개발자 계정을 입력해주세요.
  * <mark style="color:blue;">신청 유형을 반드시</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**“앱 이전”**</mark><mark style="color:blue;">으로 선택</mark>해주세요. 미선택 시에는 마이앱 제작 프로세스에 따라 신규 앱이 즉시 제작될 수 있으니 유의 부탁드립니다.
    * [마이앱 > STEP 5. 설정 사용 가이드 바로가기](https://store-help.nhn-commerce.com/app/marketing/myapp/step-5.)

  <figure><img src="/files/FFApkECFTRLcMRdYMmcG" alt=""><figcaption></figcaption></figure>

## **3.  마이앱 이전 신청 접수**

* \[[NHN 커머스 홈페이지 > 1:1 문의](https://www.nhn-commerce.com/support/inquiry/list)]에 접속한 후, 아래 정보를 모두 입력하여 문의글을 작성해주세요.&#x20;
  * <mark style="color:red;">\*</mark>**어떤 도움이 필요하신가요?** : 일반 문의&#x20;
  * <mark style="color:red;">\*</mark>**문의 분류** : 스토어(앱/디자인)

{% hint style="info" %}
\*마이앱 서비스를 먼저 신청 후, 진행해주세요. \
(타사 앱 이전은 NHN 커머스의 마이앱으로만 가능합니다.) \
\*아래 정보를 반드시 기재해주세요. (정보를 기재해주셔야, 이전 신청이 정상적으로 접수됩니다.)<br>

1. 이전 앱 개발사 회사명(<mark style="color:red;">\*필수</mark>)<br>
2. 기존 앱 서비스 만료일<br>
3. 기존 회원에 앱 혜택 제공여부 \
   ① 앱 설치 혜택 : \
   ② 푸시알림 ON 혜택 : \
   ③ 첫 구매 혜택 :&#x20;

\*마이앱 혜택을 기존 앱 고객에 제공할 지에 대한 의사를 전달해주세요.&#x20;

\*관련된 상세 설명은 아래에 **\[참고]앱 이전 시 유의사항 > 2-2. 앱 전용 혜택**을 확인 부탁드립니다.<br>

4. AOS 앱 이전에 필요한 정보\
   ● 키스토어 파일(<mark style="color:red;">\*필수</mark>) \
   ● storePassword(\*스토어비밀번호)(<mark style="color:red;">\*필수</mark>) \
   ● keyAlias(키별칭)(<mark style="color:red;">\*필수</mark>)\
   ● keyPassword(키 비밀번호)(<mark style="color:red;">\*필수</mark>)

\[안내 및 주의사항]

> 추가로 이전 시 궁금한 사항은 NHN 커머스 >  1:1 문의로 개별 접수 부탁드립니다.
> {% endhint %}

## **4. 마이앱 이전 신청 완료**

* NHN커머스에서 해당 내용을 확인 후, 마이앱 심사요청 시 기재하신 담당자 정보로 앱 이전 방법을 안내드립니다.

***

## **\[참고] 앱 이전 시 유의사항**

**\[1] 앱 이전 시 소요되는 기간**

* 앱 이전은 기존 앱 서비스 만료일로부터 <mark style="color:red;">**최소 두 달 전**</mark>에 진행을 권장합니다.&#x20;
* 신규 마이앱 제작은 이전이 완료된 후에 시작되며, 출시완료까지 각 스토어별로 소요되는 기간이 상이합니다.&#x20;
  * 다만, 마이앱의 경우 iOS와 AOS 스토어 심사가 모두 완료된 후 동시에 출시되며, 특정 하나의 운영체제만 앱 이전 및 제작은 불가능합니다.

**\[2] 앱 이전 시 반영 불가한 정보**

* 기존에 사용하던 앱에 저장된 설정 정보는 이전되지 않으므로, <mark style="color:red;">반드시 마이앱 관리자에서 재설정</mark>해야 합니다.

2-1. 하단바, 설정 메뉴 및 팝업

* 메뉴 경로 : 마이앱 > 디자인 > 하위 메뉴&#x20;
* 위 경로에서 설정된 디자인은 실제 스토어 출시 전에, 마이앱 미리보기 기능을 통해 확인 가능합니다.
  * [마이앱 미리보기 사용 가이드 바로가기](https://store-help.nhn-commerce.com/app/marketing/myapp/step-5.#id-4)

2-2. 앱 전용 혜택

* 메뉴 경로 : 마이앱 > 설정 > 혜택 관리&#x20;
* 위 경로에서 설정된 혜택은 마이앱 출시 이후, 쇼핑몰 관리자에 저장된 회원의 모바일 앱 정보를 기준으로 지급됩니다.&#x20;
  * 만약, 기존 앱을 사용한 이력이 있는 특정 회원에게 앱 전용 혜택을 제공하지 않고자 할 시에는 \
    위 &#x34;**. 마이앱 이전 신청  접수 단계**에서 혜택 제공여부와 회원 데이터를 전달해주셔야 합니다.

    ① 앱 설치 혜택

    * 제공여부 : 제공 안 함&#x20;
      * 전달되어야 하는 회원 데이터&#x20;
        * 필수 : 기존 앱을 설치한 이력이 있는 회원번호&#x20;
        * 선택 : 해당 회원번호에 저장되어 있는 최초 로그인 일시

    ② 푸시알림 ON 혜택

    * 제공여부 : 제공 안 함&#x20;
      * 전달되어야 하는 회원 데이터&#x20;
        * 필수 : 기존 앱에서 알림 설정한 이력이 있는 회원번호

    ③ 첫 구매 혜택

    * 제공여부 : 제공 안 함&#x20;
      * 전달되어야 하는 회원 데이터&#x20;
        * 필수 : 기존 앱에서 상품을 구매한 이력이 있는 회원번호&#x20;
        * 선택 : 해당 회원번호에 저장되어 있는 최초 주문 일시(=결제완료 기준)

\*전달되어야  하는 회원 데이터는 아래 양식에 맞게 작성 후, 제출 부탁드립니다.

{% file src="/files/Tdqq5ymTUCgsDdr82bhM" %}

2-3. 앱 통계 데이터

* 메뉴 경로 : 마이앱 > 통계 > 하위 메뉴&#x20;
* 마이앱 출시 이후 시점부터 발송된 앱 푸시 통계와 앱 사용현황 데이터는 위 경로에서 확인 가능합니다.

**\[3] 앱 이전 후 기존 사용 고객 안내**

* 기존 앱 사용 고객은 각 스토어에서 <mark style="color:red;">**앱을 반드시 업데이트**</mark> 해야만 이전한앱을 사용할 수 있습니다.
* &#x20;따라서, 이전 신청 후 스토어 심사가 진행되는 시점부터는 쇼핑몰 웹페이지에 팝업이나 공지사항 등을 통해 아래 내용을 포함하여 안내 부탁드립니다.&#x20;
  * 구글 플레이스토어/애플 앱스토어에서 최신 버전으로 앱 업데이트 필요&#x20;
  * 앱 정보성/광고성 알림 설정 여부 및 자동 로그인 여부에 대해 재설정 필요


---

# 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://store-help.nhn-commerce.com/app/marketing/myapp/transfer.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.
