컬럼 매핑 가이드
데이터를 연결할 때는 자사몰 데이터의 각 항목을 라플라스 기준 항목에 하나씩 매핑해야 합니다. 이 작업을 컬럼 매핑이라고 부릅니다.
이 문서는 각 항목이 어떤 값을 의미하는지를 정리한 안내서입니다. 연결 화면에서 어떤 이름을 골라야 할지 헷갈리면 이 문서에서 먼저 확인해 주세요.
이 문서에서는 연결 화면에서 선택하는 컬럼을 항목이라고 부릅니다.
화면에서 매핑하는 방법
연결 화면의 왼쪽에서 라플라스 항목을 확인하고, 오른쪽에서 자사몰 데이터의 키를 선택합니다.
어떤 데이터를 연결할 수 있나요
괄호 안 숫자는 매핑 가능한 항목 수입니다. 전부 채우실 필요는 없고, 대부분 선택 항목입니다.
시작하기 전에 꼭 알아둘 세 가지
1. 라플라스가 정해 둔 뜻에 맞춰 보내 주세요
항목 의미를 자사몰 기준으로 임의 해석해 매핑하면 대시보드 수치가 틀어집니다.
대시보드 지표는 각 항목의 의미를 전제로 계산됩니다. 기준이 다르면 연결은 성공하고 오류 메시지도 없이 수치만 틀어집니다.
예를 들어 결제금액에 배송비를 뺀 값을 넣으면 매출이 실제보다 낮게 나와도 화면에는 경고가 표시되지 않습니다. 나중에 수치가 이상하다는 것을 발견해도 원인을 되짚기가 매우 어렵습니다.
2. 건을 구분하는 항목은 반드시 채워 주세요
데이터마다 "두 행이 같은 건인지, 다른 건인지"를 판단하는 기준 항목이 있습니다. 이 문서에서는 이를 식별 키라고 부릅니다.
주문은
주문번호+상품 주문번호상품은
상품번호회원은
회원 ID기초 상품은
브랜드+기초 상품번호+기초 상품명+적용 시작 일자기초 상품 옵션 매칭은
브랜드+판매 채널+상품번호+상품명+옵션코드+옵션정보+기초 상품 브랜드명+기초 상품번호+기초 상품명
카테고리별 식별 키는 각 페이지 맨 위에 적어 두었습니다.
이 항목을 비우거나 모든 행에 같은 값을 넣으면, 라플라스는 이를 동일한 한 건으로 보고 마지막에 받은 한 행만 남깁니다. 1만 건을 보냈는데 1건만 조회되는 문제가 여기서 발생합니다.
이 현상은 API로 직접 보낼 때 발생합니다. 스프레드시트는 시트 전체를 매번 새로 넣기 때문에 행이 합쳐지지 않습니다. 다만 주문번호가 비어 있으면 주문 단위 지표(주문당 결제금액, 크로스 셀링)를 계산할 수 없으므로, 어느 방식이든 채워 두는 것을 권장합니다.
그래서 같은 데이터라도 전송 방식에 따라 필수 항목 수가 다릅니다. 대표적으로 주문은 스프레드시트 5개, API 7개입니다.
3. 취소·수정을 반영하는 방법도 방식마다 다릅니다
API로 직접 보낼 때는 수정 API나 삭제 API가 따로 없습니다. 같은 식별 키로 변경된 내용을 다시 보내면 가장 최근 값이 최종값이 됩니다. 위 2번 규칙이 그대로 적용됩니다.
스프레드시트로 올릴 때는 시트 내용 전체가 매번 새로 반영됩니다. 이전 내용은 남지 않으며, 수정은 해당 행을 고치면 끝납니다.
각 페이지의 표를 읽는 법
아래 표의 이름을 화면에서 찾아 해당 항목에 매핑해 주세요.
화면 표기
연결 화면에 그대로 보이는 이름입니다. 이 이름으로 찾으시면 됩니다
타입
값의 형식입니다. 아래 값의 형식을 확인해 주세요
필수
필수는 이 항목이 없으면 연결을 저장할 수 없다는 뜻입니다. **필수 (식별 키)**는 위 2번 규칙이 적용되는 항목으로, API로 보내실 때만 필수이고 스프레드시트에서는 선택입니다
상수 입력
가능이면 매핑할 항목 대신 고정값을 직접 입력할 수 있습니다
상수 입력이란
자사몰에 대응 값이 없는 항목은, 매핑할 항목을 고르는 대신 모든 행에 동일하게 들어갈 고정값을 한 번만 입력할 수 있습니다.
브랜드가 하나뿐이어서 브랜드에 상호를 그대로 적어 넣는 경우가 대표적입니다.
식별 키는 원칙적으로 상수 입력이 불가합니다. 고정값을 넣으면 모든 행이 같은 키를 가져 데이터가 한 건으로 합쳐지기 때문입니다. 광고만 예외가 있으니 광고 페이지를 확인해 주세요.
상수 입력이 불가한 식별 키는 행마다 다른 값이 들어 있는 자사몰 컬럼을 매핑해야 합니다. 예를 들어 카테고리 ID에는 category_code, 판매 채널에는 sales_channel을 연결합니다.
저장되지 않는 항목
연결 화면에 한글 이름 없이 영문이 그대로 보이는 항목이 있다면, 실제로는 저장되지 않는 항목입니다. 매핑해도 값이 남지 않으므로 비워 두셔도 됩니다.
값의 형식
날짜와 시간
날짜/시간 또는 날짜시간으로 끝나는 항목입니다. 아래 형식을 모두 인식합니다.
구분자는 . / - 모두 허용하며, 2026-8-4처럼 한 자리 월·일도 인식합니다. 2026-08-24T14:06:28.123+09:00 같은 형태도 지원합니다.
시차 표기(+09:00)는 계산에 반영하지 않고 떼어냅니다. 붙어 있어도 앞의 시각을 그대로 쓰기 때문에, 한국 시각으로 보내주셔야 대시보드 날짜가 맞습니다.
인식하지 못한 값은 빈 값으로 처리됩니다. 다만 API로 보낼 때 식별 키 날짜 항목(광고의 광고 날짜시간, 리뷰의 리뷰 작성 날짜/시간)을 인식하지 못하면 한 번에 보낸 데이터 전체가 저장되지 않습니다. 이 값이 없으면 서로 다른 데이터가 한 건으로 합쳐질 수 있어, 빈 값으로 넘어가지 않고 전송을 중단합니다. 식별 키가 아닌 항목은 빈 값 처리 후 나머지가 저장됩니다.
숫자
표시 형식이 섞여 있어도 대부분 자동으로 인식합니다.
1,234
1234
₩1,234 · 1 234원
1234
(500)
-500 (괄호는 회계에서 쓰는 음수 표기입니다)
1.234.567
1234567
12.5%
빈 값: 12.5인지 0.125인지 정할 수 없어 받지 않습니다
퍼센트나 배수는 기호를 떼고 숫자만 보내 주세요. 통화 기호 외의 단위가 붙은 값은 읽지 못합니다.
상태 변경 안내
주문 취소·환불·반품·교환은 주문 컬럼, 상품 판매 종료·삭제는 상품 컬럼, 회원 탈퇴는 회원 컬럼을 참고해 주세요.
항목을 비우면 어떤 지표가 안 나오나요
비워 두어도 연결은 되지만, 해당 항목을 사용하는 지표는 계산되지 않습니다. 아래는 지표별 필요 항목입니다. 이름은 모두 연결 화면 표시명과 동일합니다.
결제금액
결제금액 · 결제 날짜/시간
실 결제금액
결제금액 · 결제 날짜/시간 · 적립금 · 예치금
순매출
결제금액 · 결제 날짜/시간 · 취소 완료 날짜/시간 · 환불 날짜/시간
주문당 결제금액 (AOV)
결제금액 · 결제 날짜/시간 · 주문번호 (주문번호가 건수를 세는 단위입니다)
상품 구매 금액
상품 가격 · 옵션 가격 · 수량
객단가 (ARPPU) · 재구매율 · 코호트 LTV
결제금액 · 결제 날짜/시간 · 구매자를 구분할 값 (아래 참고)
크로스 셀링
주문번호 · 상품번호 (같은 주문번호로 행을 묶어 조합을 셉니다)
상품별 매출
결제금액 · 상품번호
카테고리별 매출
결제금액 · 카테고리 ID 또는 카테고리명
클릭률 (CTR) · 노출 단가 (CPM)
노출수 · 클릭수 · 광고비 (VAT 포함)
전환당 비용 (CPA)
광고비 (VAT 포함) · 전환
클릭 대비 전환율 (CVR)
클릭수 · 전환
노출 대비 전환율 (CVR)
노출수 · 전환
광고 수익률 (ROAS)
광고비 (VAT 포함) + 주문의 결제금액 (전환 ROAS는 전환 가치)
마진
결제금액 + 기초 상품의 원가
POAS
결제금액 · 광고비 (VAT 포함) + 기초 상품의 원가
공헌이익
결제금액 · 기초 상품의 원가 · 광고비 (VAT 포함) · 수수료 · 배송비
구매자를 구분할 값: 재구매율이나 객단가처럼 "한 사람"을 세는 지표에는 구매자를 구분할 값이 필요합니다. 여기서 방식별 차이가 하나 있습니다.
스프레드시트로 올릴 때는
주문자 전화번호→회원 ID→주문자 이메일 주소순으로 먼저 채워진 값을 사용합니다. 회원 ID가 없어도 전화번호나 이메일이 있으면 계산됩니다.API로 직접 보낼 때는
회원 ID또는유저 ID를 직접 채워야 합니다. 전화번호나 이메일로 대체하지 않습니다.
계산식 전체는 계산식 알아보기를 참고해 주세요.
전담 매니저에게 요청하기
컬럼 매핑에 대해 더 궁금한 점이 있으신가요?
이메일 문의: product@laplacetec.com
마지막 업데이트