쇼피파이 메타 오브젝트 & Matrixify 완벽 가이드

0 시작하기 전에

쇼피파이 스토어에 상품 100개를 하나씩 손으로 등록해본 적 있나요? 😱
이제 그런 고생은 끝! 엑셀로 한 번에 등록하는 방법을 알려드릴게요!

❓ 이런 고민 있으셨나요?

😰 "브랜드 정보를 모든 상품마다 일일이 입력하느라 손목 아파요..."

😭 "브랜드 소개를 수정하려니까 관련된 상품 100개를 다 고쳐야 해요..."

😵 "상품 500개를 하나씩 등록하는 데 일주일 걸렸어요..."

→ 이 가이드를 보면 50시간 걸릴 작업을
30분에 끝낼 수 있어요! ⚡

📝 엑셀 다룰 줄 알면 충분해요!

이 가이드는 "엑셀로 표 만들 줄 아는 분"이면 누구나 따라할 수 있어요.
코딩? 몰라도 됩니다! 프로그래밍? 필요 없어요! 👍

✅ 필요한 준비물:

쇼피파이 스토어 (당연히!)
엑셀 또는 구글 스프레드시트
Matrixify 앱 (무료 체험 가능)
등록할 데이터 (작가, 상품 등)

⏱️ 소요 시간: 천천히 따라해도 15분이면 충분해요!
💰 비용: 완전 무료! (Matrixify는 무료 체험으로 시작 가능)

1 메타 오브젝트? 어렵지 않아요!

어려운 말 같지만, 쉽게 말하면 "연락처 주소록" 같은 거예요! 📱

💡 스마트폰 주소록으로 이해하기

스마트폰 주소록에 친구를 저장할 때를 생각해보세요:

📱 이름: 홍길동

📞 전화번호: 010-1234-5678

✉️ 이메일: hong@email.com

📷 사진: 프로필 이미지

→ 이렇게 "친구 정보를 정리해서 저장"하는 게 주소록이죠?
→ "작가 정보를 정리해서 저장"하는 게 메타 오브젝트예요!

🤔 구체적인 예시로 이해하기

독립 서점을 운영한다고 생각해봅시다. 한강 작가의 책이 10권 있어요.

😰 주소록(메타 오브젝트) 없이 하면?

📕 책 1: 상품 설명에 "한강, 대한민국 소설가, 노벨문학상..." 타이핑

📗 책 2: 또 "한강, 대한민국 소설가, 노벨문학상..." 타이핑

📘 책 3: 또 "한강, 대한민국 소설가..." 타이핑...

→ 10번 반복! 🤯 복사-붙여넣기 지옥!

더 큰 문제: 작가 소개를 수정하려면?
→ 책 10개를 일일이 찾아서 수정해야 해요! 😭

😊 주소록(메타 오브젝트) 사용하면?

1️⃣ 먼저 "작가 주소록"에 한강 작가 등록 (딱 1번!)

✍️ 이름: 한강

📝 소개: 대한민국의 소설가, 노벨문학상 수상...

📷 사진: 프로필 이미지

🔗 SNS: 공식 웹사이트

2️⃣ 책 10권에서 "한강" 작가를 선택만 하면 끝!

📕 책 1 → 작가: 한강 선택 ✅

📗 책 2 → 작가: 한강 선택 ✅

📘 책 3 → 작가: 한강 선택 ✅

✨ 마법: 작가 정보 수정하려면?
→ "작가 주소록"에서 한강 작가 정보만 수정하면
→ 연결된 책 10개에 자동으로 반영돼요! 🎉

💼 다른 스토어에서는 이렇게 써요

📚 서점: 작가, 출판사, 번역가 주소록 만들기

👕 옷가게: 브랜드, 디자이너 주소록 만들기

🎨 갤러리: 아티스트, 전시회 주소록 만들기

🍽️ 식품: 원산지, 생산자 주소록 만들기

🎯 핵심 요약:
메타 오브젝트 = 쇼피파이용 주소록
한 번만 등록하고 → 여러 상품에서 재사용!

2 데이터 구조 설계하기

'작가(Author)' 메타 오브젝트를 예시로 데이터 구조를 설계해볼게요.

📋 작가 메타 오브젝트 명세서

필드 이름	Key (변수명)	데이터 타입	설명
이름	`name`	Single line text	필수 항목, 작가 식별자
사진	`photo`	File (Image)	프로필 이미지
소개글	`bio`	Rich text	작가 상세 소개
SNS 주소	`sns_url`	URL / Text	외부 링크
수상 경력	`awards`	Multi-line text	주요 이력
생몰년도	`years`	Single line text	예: 1900-1950
지역	`location`	Single line text	주요 활동지
성별	`gender`	Single line text	통계용 (선택)

💡 설계 팁:

Key(변수명)은 영문 소문자와 언더스코어(_)만 사용
나중에 코드에서 접근할 때 사용되므로 명확하게 작성
필수 필드는 최소화하고, 선택 필드를 적극 활용

3 Matrixify 워크플로우 개요

메타 오브젝트를 대량으로 등록하는 3단계 프로세스를 알아볼게요.

1

📥 템플릿 확보 (Export)

샘플 데이터 1개를 만들고, Matrixify로 내보내서 데이터 구조 파악

2

✏️ 데이터 가공 (Preparation)

엑셀/CSV로 대량 데이터를 Matrixify 포맷에 맞게 정리

3

📤 업로드 및 적용 (Import)

가공한 CSV를 Matrixify로 업로드하여 일괄 등록

⏱️ 소요 시간 비교

😰

수작업

~50시간

1000개 데이터 기준

🚀

Matrixify

~30분

1000개 데이터 기준

4 Step 1: 템플릿 확보하기 (샘플 1개 만들기)

비유: 케이크를 굽기 전에 먼저 레시피를 확인하는 것처럼,
대량 등록 전에 "어떤 형식"으로 만들어야 하는지 확인해야 해요! 📋

🤔 왜 샘플을 먼저 만들어야 하나요?

Matrixify는 각 메타 오브젝트마다 컬럼 이름이 달라요.
샘플 1개를 먼저 만들고 내보내면 → 정확한 양식을 받을 수 있어요!

샘플 1개 만들기 (5분) → 나머지 100개 한 번에 등록 (2분) ⚡

📝 따라하기: 클릭 순서

1️⃣ 쇼피파이 어드민 접속하기

▶ 왼쪽 메뉴 맨 아래 Settings (톱니바퀴 ⚙️) 클릭
▶ Custom data 클릭
▶ Metaobjects 클릭

2️⃣ 작가 메타 오브젝트 만들기

▶ Add definition 버튼 클릭
▶ Name: Author (또는 원하는 이름)
▶ 필드 추가: 이름, 사진, 소개글 등 (Lesson 2 참고)
▶ 저장!

3️⃣ 샘플 작가 1명 등록하기

▶ 방금 만든 Author 정의 클릭
▶ Add entry 버튼 클릭
▶ 예시: 한강 작가 정보 입력
▶ 저장!

💡 Tip: 완벽하게 입력하지 않아도 돼요!
목적은 컬럼 구조를 확인하는 거니까 간단하게만 입력하세요.

4️⃣ Matrixify로 내보내기

▶ 쇼피파이 앱에서 Matrixify 앱 설치 및 열기
▶ New Export 버튼 클릭
▶ Metaobjects 선택
▶ Author 선택
▶ Export 클릭 → 엑셀 파일 다운로드!

✅ 완료! 이제 뭐가 생겼나요?

다운로드한 엑셀/CSV 파일을 열어보면 이런 게 보여요:

Command,ID,Definition: Handle,Handle,Custom: Author: Name,Custom: Author: Bio
MERGE,gid://shopify/Metaobject/12345,author,han-kang,한강,대한민국의 소설가...

⬆️ 이게 바로 "레시피(템플릿)"예요!
이제 이 형식에 맞춰서 나머지 작가들을 정리하면 됩니다! 📋

🎯 이 단계에서 얻은 것:
✅ 메타 오브젝트 구조 확인
✅ 정확한 컬럼명 확인
✅ 다음 단계(데이터 가공)를 위한 양식 확보!

5 Step 2: 엑셀로 데이터 정리하기 가장 중요!

비유: 케이크 레시피를 받았으니, 이제 재료를 준비할 차례예요! 🥄
템플릿(레시피)에 맞춰서 데이터(재료)를 정리하면 됩니다!

🎯 이 단계의 목표

Step 1에서 받은 템플릿(엑셀 파일)에
등록할 작가 100명의 정보를 복사-붙여넣기로 채우는 거예요!

어려운 거 없어요! 그냥 엑셀 표 채우기예요! 📝

⚠️ 초보자 주의! 꼭 알아야 할 컬럼 3개

템플릿을 보면 컬럼이 엄청 많아 보이는데, 딱 3개만 이해하면 돼요!

1️⃣ Command (명령어)

쉬운 설명: "이 데이터를 어떻게 처리할까요?"
뭐라고 쓰나요? 그냥 MERGE라고 쓰세요! (복사-붙여넣기)
의미: 없으면 만들고, 있으면 업데이트해줘!

2️⃣ Definition: Handle (종류 이름)

쉬운 설명: "이게 뭔 데이터예요?"
뭐라고 쓰나요? author (작가 주소록이니까!)
의미: 이 데이터는 "작가" 종류예요!

3️⃣ Handle (고유 ID)

쉬운 설명: "이 사람을 뭐라고 부를까요?" (별명 같은 거)
뭐라고 쓰나요? han-kang, jk-rowling
규칙: 영문 소문자, 숫자, 하이픈(-) 만 사용!
주의: 한글 ❌, 띄어쓰기 ❌, 특수문자 ❌

✏️ 실제 예시: 이렇게 채우면 돼요!

엑셀/구글 스프레드시트를 열고 이렇게 입력하세요:

Command,Definition: Handle,Handle,Custom: Author: Name,Custom: Author: Bio,Custom: Author: Location
MERGE,author,han-kang,한강,대한민국의 소설가,대한민국 서울
MERGE,author,jk-rowling,J.K. 롤링,해리포터 작가,영국 런던
MERGE,author,kafka,프란츠 카프카,체코의 작가,체코 프라하

👆 보이시나요?
첫 3개 컬럼(Command, Definition, Handle)은 모든 행에서 패턴이 똑같아요!
그냥 복사-붙여넣기 하고, Handle만 작가마다 다르게 바꾸면 됩니다!

🚨 초보자가 자주 하는 실수

❌ 실수 1: Handle에 한글 쓰기 (한강 → 에러!)

✅ 올바른 예: han-kang

❌ 실수 2: Handle에 띄어쓰기 (han kang → 에러!)

✅ 올바른 예: han-kang (하이픈 사용)

❌ 실수 3: Command 빈칸으로 두기

✅ 올바른 예: 모든 행에 MERGE 입력

✅ 체크리스트: 업로드 전에 확인하세요!

☑️ Command 컬럼에 모든 행이 MERGE로 채워져 있나요?
☑️ Definition: Handle 컬럼에 모든 행이 author로 채워져 있나요?
☑️ Handle 컬럼이 영문 소문자, 숫자, 하이픈만 사용했나요?
☑️ Handle이 각 행마다 다른가요? (중복 없어야 해요!)
☑️ 텍스트에 쉼표(,)가 있으면 큰따옴표("")로 감쌌나요?

💡 Pro Tip:
처음엔 10-20개만 먼저 만들어서 테스트하세요!
성공하면 그때 나머지를 추가하는 게 안전해요! 👍

6 Step 3: 업로드 및 적용

마지막 단계! 가공한 CSV를 업로드해서 일괄 등록해요.

📤 Import 절차

Matrixify 앱 열기
Import 영역에 CSV 파일 드래그 앤 드롭
⚠️ 중요: Dry run (모의 테스트) 먼저 실행!
에러가 있으면 메시지 확인 후 CSV 수정
에러 없으면 실제 Import 실행
완료! 🎉

✅ Dry Run이란?

실제로 데이터를 등록하지 않고, 문제가 있는지만 검사하는 기능이에요.
에러가 발생해도 데이터가 망가지지 않으니 반드시 먼저 실행하세요!

📊 Import 결과 예시

✅ Success!
Imported: 150 items
Updated: 0 items
Failed: 0 items
Duration: 12 seconds

💡 Pro Tip: Import가 실패하더라도 걱정하지 마세요. 쇼피파이 데이터는 변경되지 않았고, CSV만 수정해서 다시 시도하면 됩니다!

7 에러 해결하기 (당황하지 마세요!)

에러가 나도 괜찮아요! 😊 컴퓨터는 망가지지 않았고, CSV만 고치면 됩니다!
가장 흔한 에러 3가지와 1분 안에 고치는 방법을 알려드릴게요!

🤗 먼저 알고 가세요!

✅ 에러가 나도 쇼피파이 데이터는 안전해요! (변경 안 됨)
✅ CSV 파일만 수정해서 다시 업로드하면 끝!
✅ 에러 메시지는 "몇 번째 줄이 문제"인지 알려줘요!
✅ 처음엔 누구나 에러를 만나요 - 정상입니다! 👍

😱 에러 1: "컬럼 개수가 안 맞아요!"

                        Error: Expected 9 fields in line 8, saw 10
                    

😵 무슨 뜻이에요?

CSV 파일은 쉼표(,)로 데이터를 구분해요.
그런데 작가 소개글 안에 쉼표가 들어있으면
→ 컴퓨터가 "어? 열이 하나 더 있네?" 하고 헷갈려해요! 🤔

❌ 문제가 되는 예:

MERGE,author,kafka,프란츠 카프카,체코의 작가, 부조리 문학의 선구자,체코 프라하

👆 "체코의 작가, 부조리 문학의 선구자" 이 부분의 쉼표 때문에
컴퓨터가 "어? 열이 2개네?" 하고 착각해요!

✅ 해결 방법: 큰따옴표로 감싸기!

MERGE,author,kafka,프란츠 카프카,"체코의 작가, 부조리 문학의 선구자",체코 프라하

👆 큰따옴표(" ")로 감싸면
"안에 있는 쉼표는 무시해줘!" 라고 알려주는 거예요! ✨

🎯 1분 해결법:

에러 메시지에서 "line 8" 확인 → CSV의 8번째 줄로 가기
그 줄에서 쉼표(,)가 들어간 텍스트 찾기
그 텍스트를 큰따옴표(" ")로 감싸기
저장하고 다시 업로드! 끝! 🎉

😱 에러 2: "Definition이 뭐예요?"

                        Error: Definition: Handle is required
                    

😵 무슨 뜻이에요?

"Definition: Handle" 컬럼이 없거나 비어있어요!
이 컬럼은 "이게 뭔 데이터예요?" 알려주는 거라서 꼭 있어야 해요!

🎯 1분 해결법:

CSV 파일 첫 번째 줄(헤더)에 "Definition: Handle" 컬럼 있나요?
있다면 → 모든 데이터 줄에 author 값이 입력되어 있나요?
없다면 → 헤더에 "Definition: Handle" 컬럼 추가!
빈 칸 없이 모든 행에 author 채우기!

😱 에러 3: "이미 있다는데요?"

                        Error: Handle 'han-kang' already exists
                    

😵 무슨 뜻이에요?

"han-kang"이라는 Handle이 이미 쇼피파이에 있어요!
같은 Handle을 2번 만들 수는 없어요 (주소록에 같은 이름 2명 저장 안 되는 것처럼)

🎯 1분 해결법:

📌 상황 1: 기존 데이터를 업데이트하고 싶어요

→ Command 컬럼이 MERGE인지 확인!
→ MERGE면 자동으로 업데이트됩니다! ✨

📌 상황 2: 새로운 데이터를 만들고 싶어요

→ Handle을 다른 이름으로 바꾸세요!
→ 예: han-kang → han-kang-2 또는 han-kang-poet

✅ 에러 예방 체크리스트

업로드 전에 이것만 확인하면 에러 90% 예방!

☑️ 텍스트에 쉼표(,)가 있으면 큰따옴표(" ")로 감쌌나요?
☑️ Command 컬럼이 모든 행에 MERGE로 채워져 있나요?
☑️ Definition: Handle 컬럼이 모든 행에 author로 채워져 있나요?
☑️ Handle이 영문 소문자, 숫자, 하이픈만 사용했나요?
☑️ Handle이 각 행마다 다른 값인가요?
☑️ 처음엔 10개만 테스트해봤나요?

🎓 프로의 조언:
에러가 나면 당황하지 말고
1️⃣ 에러 메시지에서 라인 번호 확인
2️⃣ CSV에서 그 줄 찾아가기
3️⃣ 위에서 배운 해결법 적용하기
대부분 1분 안에 해결돼요! 💪

8 CSV 검증하기 (실습)

직접 CSV 데이터를 입력해서 문제가 없는지 확인해보세요!

🧪 CSV 검증기

아래에 CSV 데이터를 입력하고 검증 버튼을 누르면, 일반적인 에러를 미리 확인할 수 있어요.

💡 검증 항목:

필수 컬럼(Command, Definition: Handle, Handle) 존재 여부
각 행의 컬럼 개수 일치 여부
Handle 중복 체크
쉼표 문제 가능성 검사

9 실무 Best Practices

효율적이고 안전한 작업을 위한 실무 팁을 정리했어요.

✅ Do - 이렇게 하세요

백업 먼저: 작업 전에 기존 데이터 Export로 백업
소량 테스트: 전체 업로드 전에 10-20개로 먼저 테스트
Dry Run 활용: 실제 Import 전에 반드시 Dry Run 실행
버전 관리: CSV 파일에 날짜/버전 번호 포함 (예: authors_v1_20241209.csv)
문서화: Handle 명명 규칙을 미리 정하고 문서화
따옴표 사용: 텍스트 필드는 모두 큰따옴표로 감싸기

❌ Don't - 이런 실수 주의

Dry Run 생략: 바로 Import하면 에러 발생 시 대량 수정 필요
한글 Handle: Handle은 영문/숫자/하이픈만 사용 (한글 ❌)
컬럼 순서 변경: Export한 템플릿의 컬럼 순서 유지
엑셀에서 직접 편집: 엑셀이 데이터를 자동 변환할 수 있음 (날짜 등)
대량 작업 한번에: 1000개 이상은 여러 번에 나눠서 진행

🎯 추천 워크플로우

계획 단계: 메타 오브젝트 구조 설계 및 문서화
템플릿 생성: 샘플 1개 생성 → Export로 템플릿 확보
데이터 준비: 소스 데이터를 CSV 포맷으로 가공
소량 테스트: 10-20개로 Dry Run → Import 테스트
문제 해결: 에러 수정 및 프로세스 개선
대량 실행: 전체 데이터 Import (500개씩 배치 추천)
검증: 쇼피파이 어드민에서 결과 확인

🎉 완료!

축하합니다! 이제 쇼피파이 메타 오브젝트와 Matrixify 전문가가 되셨어요!

📚 배운 내용 정리

✅ 메타 오브젝트: 쇼피파이 데이터 구조 확장하기
✅ 데이터 설계: 필드 타입과 구조 정의하기
✅ Matrixify 워크플로우: Export → Preparation → Import
✅ CSV 포맷: 필수 컬럼 3대장 (Command, Definition, Handle)
✅ 트러블슈팅: 쉼표 에러, Definition 누락, Handle 중복 해결
✅ Best Practices: 안전하고 효율적인 작업 방법

🚀 다음 단계

1️⃣ 자신의 스토어에 필요한 메타 오브젝트 구조 설계하기
2️⃣ 소량 데이터로 워크플로우 테스트해보기
3️⃣ 실제 데이터 대량 등록 진행하기
4️⃣ Liquid 코드로 프론트엔드에 연동하기

💬 도움이 필요하신가요?

막히는 부분이 있거나 궁금한 점이 있다면
@루쿠쿠 이은재 Tony에게
슬랙 DM 보내주세요! 🙌

Happy Shopify-ing! 🛍️✨

🛍️ 쇼피파이 메타 오브젝트 & Matrixify

0 시작하기 전에

❓ 이런 고민 있으셨나요?

📝 엑셀 다룰 줄 알면 충분해요!

1 메타 오브젝트? 어렵지 않아요!

💡 스마트폰 주소록으로 이해하기

🤔 구체적인 예시로 이해하기

😰 주소록(메타 오브젝트) 없이 하면?

😊 주소록(메타 오브젝트) 사용하면?

💼 다른 스토어에서는 이렇게 써요

2 데이터 구조 설계하기

📋 작가 메타 오브젝트 명세서

3 Matrixify 워크플로우 개요

📥 템플릿 확보 (Export)

✏️ 데이터 가공 (Preparation)

📤 업로드 및 적용 (Import)

⏱️ 소요 시간 비교

4 Step 1: 템플릿 확보하기 (샘플 1개 만들기)

🤔 왜 샘플을 먼저 만들어야 하나요?

📝 따라하기: 클릭 순서

✅ 완료! 이제 뭐가 생겼나요?

5 Step 2: 엑셀로 데이터 정리하기 가장 중요!

🎯 이 단계의 목표

⚠️ 초보자 주의! 꼭 알아야 할 컬럼 3개

✏️ 실제 예시: 이렇게 채우면 돼요!

🚨 초보자가 자주 하는 실수

✅ 체크리스트: 업로드 전에 확인하세요!

6 Step 3: 업로드 및 적용

📤 Import 절차

✅ Dry Run이란?

📊 Import 결과 예시

7 에러 해결하기 (당황하지 마세요!)

🤗 먼저 알고 가세요!

😱 에러 1: "컬럼 개수가 안 맞아요!"

😱 에러 2: "Definition이 뭐예요?"

😱 에러 3: "이미 있다는데요?"

✅ 에러 예방 체크리스트

8 CSV 검증하기 (실습)

🧪 CSV 검증기

9 실무 Best Practices

✅ Do - 이렇게 하세요

❌ Don't - 이런 실수 주의

🎯 추천 워크플로우

🎉 완료!

📚 배운 내용 정리

🚀 다음 단계

💬 도움이 필요하신가요?