> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns.md). # 컬럼 매핑 가이드 데이터를 연결할 때는 자사몰 데이터의 각 항목을 라플라스 기준 항목에 하나씩 매핑해야 합니다. 이 작업을 **컬럼 매핑**이라고 부릅니다. 이 문서는 각 항목이 **어떤 값을 의미하는지**를 정리한 안내서입니다. 연결 화면에서 어떤 이름을 골라야 할지 헷갈리면 이 문서에서 먼저 확인해 주세요. 이 문서에서는 연결 화면에서 선택하는 컬럼을 **항목**이라고 부릅니다. {% hint style="info" %} **이 문서에 적힌 항목 이름은 연결 화면에 표시되는 이름과 동일합니다.** 화면에서 해당 이름을 찾아 자사몰 데이터와 매핑해 주세요. **자사몰에서 쓰는 컬럼 이름을 바꾸실 필요는 없습니다.** 연결 화면에서 대응 관계만 지정하면 됩니다. **전송 방식에 따라 적용되는 규칙이 다릅니다.** 각 페이지 상단의 info 상자에서 적용되는 전송 방식을 먼저 확인해 주세요. {% endhint %} ## 화면에서 매핑하는 방법 연결 화면의 왼쪽에서 라플라스 항목을 확인하고, 오른쪽에서 자사몰 데이터의 키를 선택합니다. ![컬럼 매핑 화면 예시](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2FJI5pQ0K8aVuzhgOLQDl1%2FUntitled%20\(13\).png?alt=media\&token=3ad69b2c-d6b7-475a-8661-3792e8cd0e47) ## 어떤 데이터를 연결할 수 있나요 | 무엇을 보내는지 | 스프레드시트로 올리기 | API로 직접 보내기 | | ---------------------------------------------------------------------------------------------------- | ----------- | ----------- | | [주문](/guide/startguide/connect/columns/order.md): 언제 무엇이 얼마에 팔렸는지 (42개) | 가능 | 가능 | | [광고](/guide/startguide/connect/columns/ad.md): 채널별 광고비와 노출·클릭·전환 (23개) | 가능 | 가능 | | [상품](/guide/startguide/connect/columns/product.md): 상품명·가격·카테고리 (21개) | 불가 | 가능 | | [회원](/guide/startguide/connect/columns/user.md): 가입한 고객 정보 (25개) | 불가 | 가능 | | [카테고리](/guide/startguide/connect/columns/category.md): 상품 분류 체계 (10개) | 불가 | 가능 | | [리뷰](/guide/startguide/connect/columns/review.md): 상품 후기와 별점 (13개) | 불가 | 가능 | | [기초 상품 (원가)](/guide/startguide/connect/columns/cogs.md): 상품별 원가 (5개) | 가능 | 가능 | | [기초 상품 옵션 매칭](/guide/startguide/connect/columns/cogs_relation.md): 판매 옵션이 어떤 기초 상품 몇 개로 이루어졌는지 (11개) | 불가 | 가능 | 괄호 안 숫자는 매핑 가능한 항목 수입니다. 전부 채우실 필요는 없고, 대부분 선택 항목입니다. ## 시작하기 전에 꼭 알아둘 세 가지 ### 1. 라플라스가 정해 둔 뜻에 맞춰 보내 주세요 항목 의미를 자사몰 기준으로 임의 해석해 매핑하면 대시보드 수치가 틀어집니다. 대시보드 지표는 각 항목의 의미를 전제로 계산됩니다. 기준이 다르면 **연결은 성공하고 오류 메시지도 없이 수치만 틀어집니다.** 예를 들어 `결제금액`에 배송비를 뺀 값을 넣으면 매출이 실제보다 낮게 나와도 화면에는 경고가 표시되지 않습니다. 나중에 수치가 이상하다는 것을 발견해도 원인을 되짚기가 매우 어렵습니다. ### 2. 건을 구분하는 항목은 반드시 채워 주세요 데이터마다 **"두 행이 같은 건인지, 다른 건인지"를 판단하는 기준 항목**이 있습니다. 이 문서에서는 이를 **식별 키**라고 부릅니다. * 주문은 `주문번호` + `상품 주문번호` * 상품은 `상품번호` * 회원은 `회원 ID` * 기초 상품은 `브랜드` + `기초 상품번호` + `기초 상품명` + `적용 시작 일자` * 기초 상품 옵션 매칭은 `브랜드` + `판매 채널` + `상품번호` + `상품명` + `옵션코드` + `옵션정보` + `기초 상품 브랜드명` + `기초 상품번호` + `기초 상품명` 카테고리별 식별 키는 각 페이지 맨 위에 적어 두었습니다. 이 항목을 비우거나 모든 행에 같은 값을 넣으면, 라플라스는 이를 **동일한 한 건으로 보고 마지막에 받은 한 행만 남깁니다.** 1만 건을 보냈는데 1건만 조회되는 문제가 여기서 발생합니다. **이 현상은 API로 직접 보낼 때 발생합니다.** 스프레드시트는 시트 전체를 매번 새로 넣기 때문에 행이 합쳐지지 않습니다. 다만 주문번호가 비어 있으면 주문 단위 지표(주문당 결제금액, 크로스 셀링)를 계산할 수 없으므로, 어느 방식이든 채워 두는 것을 권장합니다. 그래서 **같은 데이터라도 전송 방식에 따라 필수 항목 수가 다릅니다.** 대표적으로 주문은 스프레드시트 5개, API 7개입니다. ### 3. 취소·수정을 반영하는 방법도 방식마다 다릅니다 **API로 직접 보낼 때는** 수정 API나 삭제 API가 따로 없습니다. **같은 식별 키로 변경된 내용을 다시 보내면 가장 최근 값이 최종값이 됩니다.** 위 2번 규칙이 그대로 적용됩니다. **스프레드시트로 올릴 때는** 시트 내용 **전체가 매번 새로 반영됩니다.** 이전 내용은 남지 않으며, 수정은 해당 행을 고치면 끝납니다. ## 각 페이지의 표를 읽는 법 아래 표의 이름을 화면에서 찾아 해당 항목에 매핑해 주세요. | 열 | 뜻 | | ----- | ------------------------------------------------------------------------------------------------------------- | | 화면 표기 | 연결 화면에 그대로 보이는 이름입니다. 이 이름으로 찾으시면 됩니다 | | 타입 | 값의 형식입니다. 아래 [값의 형식](#value-format)을 확인해 주세요 | | 필수 | **필수**는 이 항목이 없으면 연결을 저장할 수 없다는 뜻입니다. \*\*필수 (식별 키)\*\*는 위 2번 규칙이 적용되는 항목으로, API로 보내실 때만 필수이고 스프레드시트에서는 선택입니다 | | 상수 입력 | **가능**이면 매핑할 항목 대신 고정값을 직접 입력할 수 있습니다 | ### 상수 입력이란 자사몰에 대응 값이 없는 항목은, 매핑할 항목을 고르는 대신 **모든 행에 동일하게 들어갈 고정값을 한 번만 입력할 수 있습니다.** 브랜드가 하나뿐이어서 `브랜드`에 상호를 그대로 적어 넣는 경우가 대표적입니다. 식별 키는 원칙적으로 상수 입력이 불가합니다. 고정값을 넣으면 모든 행이 같은 키를 가져 데이터가 한 건으로 합쳐지기 때문입니다. 광고만 예외가 있으니 [광고 페이지](/guide/startguide/connect/columns/ad.md)를 확인해 주세요. 상수 입력이 불가한 식별 키는 행마다 다른 값이 들어 있는 자사몰 컬럼을 매핑해야 합니다. 예를 들어 `카테고리 ID`에는 `category_code`, `판매 채널`에는 `sales_channel`을 연결합니다. ### 저장되지 않는 항목 연결 화면에 **한글 이름 없이 영문이 그대로 보이는 항목**이 있다면, 실제로는 저장되지 않는 항목입니다. 매핑해도 값이 남지 않으므로 비워 두셔도 됩니다. ## 값의 형식 ### 날짜와 시간 `날짜/시간` 또는 `날짜시간`으로 끝나는 항목입니다. 아래 형식을 모두 인식합니다. ``` 2026-08-24 2026-08-24 14:06 2026-08-24 14:06:28 2026-08-24T14:06:28 20260824 20260824140628 ``` 구분자는 `.` `/` `-` 모두 허용하며, `2026-8-4`처럼 한 자리 월·일도 인식합니다. `2026-08-24T14:06:28.123+09:00` 같은 형태도 지원합니다. {% hint style="warning" %} **시차 표기(`+09:00`)는 계산에 반영하지 않고 떼어냅니다.** 붙어 있어도 앞의 시각을 그대로 쓰기 때문에, **한국 시각으로 보내주셔야** 대시보드 날짜가 맞습니다. {% endhint %} 인식하지 못한 값은 빈 값으로 처리됩니다. 다만 **API로 보낼 때 식별 키 날짜 항목(광고의 `광고 날짜시간`, 리뷰의 `리뷰 작성 날짜/시간`)을 인식하지 못하면 한 번에 보낸 데이터 전체가 저장되지 않습니다.** 이 값이 없으면 서로 다른 데이터가 한 건으로 합쳐질 수 있어, 빈 값으로 넘어가지 않고 전송을 중단합니다. 식별 키가 아닌 항목은 빈 값 처리 후 나머지가 저장됩니다. ### 숫자 표시 형식이 섞여 있어도 대부분 자동으로 인식합니다. | 보내신 값 | 라플라스가 읽는 값 | | ------------------- | --------------------------------------- | | `1,234` | 1234 | | `₩1,234` · `1 234원` | 1234 | | `(500)` | -500 (괄호는 회계에서 쓰는 음수 표기입니다) | | `1.234.567` | 1234567 | | `12.5%` | **빈 값**: 12.5인지 0.125인지 정할 수 없어 받지 않습니다 | **퍼센트나 배수는 기호를 떼고 숫자만 보내 주세요.** 통화 기호 외의 단위가 붙은 값은 읽지 못합니다. ## 상태 변경 안내 주문 취소·환불·반품·교환은 [주문 컬럼](/guide/startguide/connect/columns/order.md), 상품 판매 종료·삭제는 [상품 컬럼](/guide/startguide/connect/columns/product.md), 회원 탈퇴는 [회원 컬럼](/guide/startguide/connect/columns/user.md)을 참고해 주세요. ## 항목을 비우면 어떤 지표가 안 나오나요 비워 두어도 연결은 되지만, 해당 항목을 사용하는 지표는 계산되지 않습니다. 아래는 지표별 필요 항목입니다. 이름은 모두 연결 화면 표시명과 동일합니다. | 지표 | 필요한 항목 | | ---------------------------- | ----------------------------------------------------- | | 결제금액 | `결제금액` · `결제 날짜/시간` | | 실 결제금액 | `결제금액` · `결제 날짜/시간` · `적립금` · `예치금` | | 순매출 | `결제금액` · `결제 날짜/시간` · `취소 완료 날짜/시간` · `환불 날짜/시간` | | 주문당 결제금액 (AOV) | `결제금액` · `결제 날짜/시간` · `주문번호` (주문번호가 건수를 세는 단위입니다) | | 상품 구매 금액 | `상품 가격` · `옵션 가격` · `수량` | | 객단가 (ARPPU) · 재구매율 · 코호트 LTV | `결제금액` · `결제 날짜/시간` · 구매자를 구분할 값 (아래 참고) | | 크로스 셀링 | `주문번호` · `상품번호` (같은 주문번호로 행을 묶어 조합을 셉니다) | | 상품별 매출 | `결제금액` · `상품번호` | | 카테고리별 매출 | `결제금액` · `카테고리 ID` 또는 `카테고리명` | | 클릭률 (CTR) · 노출 단가 (CPM) | `노출수` · `클릭수` · `광고비 (VAT 포함)` | | 전환당 비용 (CPA) | `광고비 (VAT 포함)` · `전환` | | 클릭 대비 전환율 (CVR) | `클릭수` · `전환` | | 노출 대비 전환율 (CVR) | `노출수` · `전환` | | 광고 수익률 (ROAS) | `광고비 (VAT 포함)` + 주문의 `결제금액` (전환 ROAS는 `전환 가치`) | | 마진 | `결제금액` + 기초 상품의 `원가` | | POAS | `결제금액` · `광고비 (VAT 포함)` + 기초 상품의 `원가` | | 공헌이익 | `결제금액` · 기초 상품의 `원가` · `광고비 (VAT 포함)` · `수수료` · `배송비` | **구매자를 구분할 값**: 재구매율이나 객단가처럼 "한 사람"을 세는 지표에는 구매자를 구분할 값이 필요합니다. 여기서 방식별 차이가 하나 있습니다. * **스프레드시트로 올릴 때는** `주문자 전화번호` → `회원 ID` → `주문자 이메일 주소` 순으로 먼저 채워진 값을 사용합니다. 회원 ID가 없어도 전화번호나 이메일이 있으면 계산됩니다. * **API로 직접 보낼 때는** `회원 ID` 또는 `유저 ID`를 직접 채워야 합니다. **전화번호나 이메일로 대체하지 않습니다.** 계산식 전체는 [계산식 알아보기](/guide/dashboard/formula.md)를 참고해 주세요. ## 전담 매니저에게 요청하기 컬럼 매핑에 대해 더 궁금한 점이 있으신가요? > 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge) > > 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact) **이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)