스토어를 옮겨 주는 Shopify 키

이 키가 무엇이며, 왜 직접 만들어야 하는가

Shopify는 다른 서비스가 여러분의 스토어를 읽을 수 있는 비밀번호를 내주지 않습니다. 대신 여러분이 자기 스토어에 작은 앱을 만들고, 그 앱이 무엇을 읽을 수 있는지 정확히 선택하면, Shopify가 그 앱에 토큰을 건넵니다. 그 토큰을 Omniterra에 붙여 넣으면 저희가 그것을 통해 카탈로그를 읽습니다.

여기서 두 가지가 따라오는데, 둘 다 여러분에게 유리합니다.

• 무엇을 보여줄지는 여러분이 정합니다. 저희는 여러분이 선택한 권한만 받습니다. 읽기 권한을 요청할 뿐, Shopify 스토어에 쓰는 것은 아무것도 요청하지 않습니다.
• 언제든 끊을 수 있습니다. Shopify에서 앱을 삭제하면 토큰은 즉시 작동을 멈춥니다. 누구에게도 메일이 가지 않습니다.

그동안 Shopify 스토어는 평소대로 돌아갑니다. 저희가 하는 어떤 일도 그것을 바꾸지 않습니다.

1단계 — 앱 설정 열기

Shopify 관리자에서 설정 → 앱 및 판매 채널 → 앱 개발 로 들어갑니다.

맞춤 앱 개발 허용 이라는 버튼이 보이면 누르세요. Shopify는 스토어당 한 번만 묻고, 스토어 소유자만 할 수 있습니다.

2단계 — 앱 만들기

앱 만들기 를 누르고, 나중에 알아볼 수 있는 이름을 붙인 뒤 — 「Omniterra 이전」이면 충분합니다 — 확인합니다.

지금 앱은 비어 있습니다. 아직 아무것도 읽지 못합니다.

3단계 — 권한 선택하기

구성 탭을 열고 Admin API 통합 → 편집 으로 들어갑니다.

가져가고 싶은 모든 항목에 읽기 권한을 선택합니다.

저장 을 누릅니다.

Omniterra는 같은 목록을 가져오기 화면에도 복사하기 좋게 보여 주고, 연결이 부족하게 돌아오면 어떤 권한이 아직 빠졌는지 알려 줍니다.

4단계 — 앱 설치하고 토큰 복사하기

API 자격 증명 탭으로 가서 앱 설치 를 누릅니다.

이제 Shopify가 Admin API 액세스 토큰 을 보여 줍니다. `shpat_` 로 시작하는 문자열입니다. 복사하세요.

이 부분은 꼼꼼히 읽어 주세요. Shopify는 그 토큰을 단 한 번만 보여 줍니다. 복사하지 않고 페이지를 닫으면 다시 볼 수 없고, 새 토큰을 받으려면 앱을 삭제했다가 다시 설치해야 합니다. 작업이 사라지지는 않지만, 짜증 나는 오 분입니다.

5단계 — Omniterra에 붙여 넣기

Omniterra 관리자에서 상품 → 가져오기 / 내보내기 로 가서 Shopify 를 고르고, 스토어 주소(`my-store.myshopify.com`)를 입력한 뒤 토큰을 붙여 넣습니다.

연결 을 누르세요. 저희가 카탈로그를 읽어, 무엇이든 기록되기 전에 찾은 것을 먼저 보여 드립니다 — 상품, 고객, 주문, 페이지가 각각 몇 개인지. 여러분이 말하기 전까지는 아무것도 움직이지 않습니다.

권한이 부족하다고 나오면

이 대목에서 많이들 당황하니 미리 알아 두는 편이 좋습니다. Shopify가 알려 주는 것은 앱을 설치할 때 부여된 권한이지, 지금 구성에 적힌 내용이 아닙니다. 설치한 뒤에 항목을 더 선택해도 앱은 예전의 좁은 권한을 그대로 들고 있습니다.

해결책은 다시 설치하는 것입니다. 구성 → Admin API 통합 → 편집에서 빠진 것을 선택하고 저장한 다음, API 자격 증명 → 앱 다시 설치. 토큰은 그대로입니다.

Dev Dashboard에서 앱을 만든 경우

일부 스토어는 스토어 관리자 안이 아니라 `dev.shopify.com` 에서 만든 앱을 씁니다. 원리는 같고, 두 가지가 더 붙습니다.

1. 앱 구성에서 `access_scopes` 를 수정하고 저장 을 누릅니다.
2. 릴리스 를 누릅니다. 릴리스하지 않으면 변경은 게시되지 않은 버전으로 남고 스토어는 그것을 영영 보지 못합니다.
3. 새 권한이 실제로 부여되도록 스토어에 앱을 다시 설치합니다.

무엇이 옮겨지고, 무엇은 옮길 수 없는가

상품과 그 옵션, 이미지, 컬렉션, 고객, 주문, 할인, 페이지, 블로그 글, 메뉴, 리디렉션, 파일 — 모두 넘어옵니다.

옮길 수 없는 것도 있는데, 그건 끝난 뒤가 아니라 시작하기 전에 말씀드립니다. 기프트카드 코드(Shopify가 결코 외부로 내주지 않습니다), 저장된 카드 정보(스토어가 아니라 결제 대행사의 것입니다), 그리고 설치된 외부 앱과 그 안에 담아 둔 데이터입니다.

생각보다 적은 상품이 들어왔을 때

거의 모든 경우가 세 가지로 설명되며, 어느 것도 가져오기가 실패했다는 뜻은 아닙니다.

초안과 보관된 상품은 기본적으로 남습니다. Shopify가 이들을 활성 카탈로그에서 빼 두고, 저희도 같습니다. 필요하다면 가져오기 전에 Shopify에서 게시하거나, 이쪽으로 옮긴 뒤 여기서 초안으로 되돌리세요.

가격이 없거나 옵션이 없는 상품은 그 상태로는 팔 수 없어 건너뜁니다. 마지막 보고서에 이름과 함께 나오므로 어떤 것이 왜 빠졌는지 정확히 보실 수 있습니다.

설치 후에 추가한 권한은 앱을 다시 설치하기 전까지 적용되지 않습니다. 앞서 말한 것과 같은 함정입니다. 다시 설치한 뒤 가져오기 화면에서 ‘다시 확인’을 누르세요. 이미 들어온 것은 건드리지 않고 카탈로그를 한 번 더 읽습니다.

필요하면 가져오기를 두 번 실행해도 됩니다. 상품은 Shopify 식별자로 맞추므로, 두 번째에는 이미 있는 것이 갱신될 뿐 중복이 생기지 않습니다.

얼마나 걸리나

수백 개 상품의 카탈로그는 보통 이삼 분이면 끝납니다. 큰 스토어는 나눠서 진행되고 페이지를 떠나도 됩니다 — 가져오기는 계속되고, 돌아오면 진행 상황을 볼 수 있습니다.