> 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" %}
**이 문서에 적힌 항목 이름은 연결 화면에 표시되는 이름과 동일합니다.** 화면에서 해당 이름을 찾아 자사몰 데이터와 매핑해 주세요.

**자사몰에서 쓰는 컬럼 이름을 바꾸실 필요는 없습니다.** 연결 화면에서 대응 관계만 지정하면 됩니다.
{% endhint %}

## 화면에서 매핑하는 방법

컬럼 매칭 화면의 **라플라스 컬럼**에서 라플라스 항목을 확인하고, **데이터 소스 컬럼**에서 자사몰 데이터의 키를 선택합니다. 이전에 저장한 매핑이 있다면 **컬럼맵 불러오기**로 한 번에 불러올 수 있어요.

<figure><img src="https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-511ffd73523e07a0ba18c3ab6fa73f82e878a78a%2Fstartguide__connect__columns__01.png?alt=media" alt="컬럼 매칭 화면의 라플라스 컬럼과 데이터 소스 컬럼" width="432"><figcaption></figcaption></figure>

* **스프레드시트로 연결할 때**: 연결 창의 탭 목록에서 **매칭**을 누르면 이 화면이 열립니다. 연결한 뒤에 매핑을 고치려면 커넥터 화면 표의 시트 행 오른쪽 ⋯(**작업 더 보기**) › **컬럼맵 설정**을 눌러 주세요.
* **이지어드민**: **설정** › **데이터** › **데이터 소스**에서 이지어드민 행 메뉴의 **컬럼 매칭**으로도 열 수 있어요.

## 어떤 데이터를 연결할 수 있나요

| 무엇을 보내는지                                                                                                                                      | 스프레드시트로 올리기 |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| [주문](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/order.md): 언제 무엇이 얼마에 팔렸는지 (42개)                              | 가능          |
| [광고](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/ad.md): 채널별 광고비와 노출·클릭·전환 (23개)                               | 가능          |
| [기초 상품 (원가)](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/cogs.md): 상품별 원가 (5개)                                 | 가능          |
| [기초 상품 옵션 매칭](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/cogs_relation.md): 판매 옵션이 어떤 기초 상품 몇 개로 이루어졌는지 (11개) | 불가          |

괄호 안 숫자는 매핑 가능한 항목 수입니다. 전부 채우실 필요는 없고, 대부분 선택 항목입니다.

## 시작하기 전에 꼭 알아둘 세 가지

### 1. 라플라스가 정해 둔 뜻에 맞춰 보내 주세요

항목 의미를 자사몰 기준으로 임의 해석해 매핑하면 대시보드 수치가 틀어집니다.

대시보드 지표는 각 항목의 의미를 전제로 계산됩니다. 기준이 다르면 **연결은 성공하고 오류 메시지도 없이 수치만 틀어집니다.**

예를 들어 `결제금액`에 배송비를 뺀 값을 넣으면 매출이 실제보다 낮게 나와도 화면에는 경고가 표시되지 않습니다. 나중에 수치가 이상하다는 것을 발견해도 원인을 되짚기가 매우 어렵습니다.

### 2. 건을 구분하는 항목을 확인해 주세요

데이터마다 **"두 행이 같은 건인지, 다른 건인지"를 판단하는 기준 항목**이 있습니다. 이 문서에서는 이를 **식별 키**라고 부릅니다.

* 주문은 `주문번호` + `상품 주문번호`
* 기초 상품은 `브랜드` + `기초 상품번호` + `기초 상품명` + `적용 시작 일자`
* 기초 상품 옵션 매칭은 `브랜드` + `판매 채널` + `상품번호` + `상품명` + `옵션코드` + `옵션정보` + `기초 상품 브랜드명` + `기초 상품번호` + `기초 상품명`

카테고리별 식별 키는 각 페이지 맨 위에 적어 두었습니다.

스프레드시트는 시트 전체를 매번 새로 넣기 때문에 이 항목이 비어 있어도 행이 합쳐지지 않습니다. 다만 주문번호가 비어 있으면 주문 단위 지표(주문당 결제금액, 크로스 셀링)를 계산할 수 없으므로 채워 두는 것을 권장합니다.

### 3. 취소·수정은 시트를 고치면 반영됩니다

**스프레드시트로 올릴 때는** 시트 내용 **전체가 매번 새로 반영됩니다.** 이전 내용은 남지 않으며, 수정은 해당 행을 고치면 끝납니다.

## 각 페이지의 표를 읽는 법

아래 표의 이름을 화면에서 찾아 해당 항목에 매핑해 주세요.

| 열     | 뜻                                                                                                      |
| ----- | ------------------------------------------------------------------------------------------------------ |
| 화면 표기 | 연결 화면에 그대로 보이는 이름입니다. 이 이름으로 찾으시면 됩니다                                                                  |
| 타입    | 값의 형식입니다. 아래 [값의 형식](#value-format)을 확인해 주세요                                                           |
| 필수    | **필수**는 이 항목이 없으면 연결을 저장할 수 없다는 뜻입니다. **필수 (식별 키)** 는 위 2번 규칙이 적용되는 항목으로, 스프레드시트에서는 비워도 연결을 저장할 수 있습니다 |
| 상수 입력 | **가능**이면 매핑할 항목 대신 고정값을 직접 입력할 수 있습니다                                                                  |

### 상수 입력이란

자사몰에 대응 값이 없는 항목은, 매핑할 항목을 고르는 대신 **모든 행에 동일하게 들어갈 고정값을 한 번만 입력할 수 있습니다.** 컬럼 매칭 화면에서 **(직접 입력)** 을 고르면 됩니다.

브랜드가 하나뿐이어서 `브랜드`에 상호를 그대로 적어 넣는 경우가 대표적입니다.

식별 키는 원칙적으로 상수 입력이 불가합니다. 고정값을 넣으면 모든 행이 같은 키를 가져 데이터가 한 건으로 합쳐지기 때문입니다. 광고만 예외가 있으니 [광고 페이지](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/ad.md)를 확인해 주세요.

상수 입력이 불가한 식별 키는 행마다 다른 값이 들어 있는 자사몰 컬럼을 매핑해야 합니다. 예를 들어 `카테고리 ID`에는 `category_code`, `판매 채널`에는 `sales_channel`을 연결합니다.

### 저장되지 않는 항목

연결 화면에 **한글 이름 없이 영문이 그대로 보이는 항목**이 있다면, 실제로는 저장되지 않는 항목입니다. 매핑해도 값이 남지 않으므로 비워 두셔도 됩니다.

## 값의 형식 <a href="#value-format" id="value-format"></a>

### 날짜와 시간

`날짜/시간` 또는 `날짜시간`으로 끝나는 항목입니다. 아래 형식을 모두 인식합니다.

```
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 %}

인식하지 못한 값은 빈 값으로 처리됩니다.

### 숫자

표시 형식이 섞여 있어도 대부분 자동으로 인식합니다.

| 보내신 값               | 라플라스가 읽는 값                              |
| ------------------- | --------------------------------------- |
| `1,234`             | 1234                                    |
| `₩1,234` · `1 234원` | 1234                                    |
| `(500)`             | -500 (괄호는 회계에서 쓰는 음수 표기입니다)             |
| `1.234.567`         | 1234567                                 |
| `12.5%`             | **빈 값**: 12.5인지 0.125인지 정할 수 없어 받지 않습니다 |

**퍼센트나 배수는 기호를 떼고 숫자만 보내 주세요.** 통화 기호 외의 단위가 붙은 값은 읽지 못합니다.

## 상태 변경 안내

주문 취소·환불·반품·교환은 [주문 컬럼](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/order.md)을 참고해 주세요.

## 항목을 비우면 어떤 지표가 안 나오나요 <a href="#blank-fields" id="blank-fields"></a>

비워 두어도 연결은 되지만, 해당 항목을 사용하는 지표는 계산되지 않습니다. 아래는 지표별 필요 항목입니다. 이름은 모두 연결 화면 표시명과 동일합니다.

| 지표                           | 필요한 항목                                                |
| ---------------------------- | ----------------------------------------------------- |
| 결제금액                         | `결제금액` · `결제 날짜/시간`                                   |
| 실 결제금액                       | `결제금액` · `결제 날짜/시간` · `적립금` · `예치금`                   |
| 순매출                          | `결제금액` · `결제 날짜/시간` · `취소 완료 날짜/시간` · `환불 날짜/시간`      |
| 주문당 결제금액 (AOV)               | `결제금액` · `결제 날짜/시간` · `주문번호` (주문번호가 건수를 세는 단위입니다)     |
| 상품 구매 금액                     | `상품 가격` · `옵션 가격` · `수량`                              |
| 객단가 (ARPPU) · 재구매율 · 코호트 LTV | `결제금액` · `결제 날짜/시간` · 구매자를 구분할 값 (아래 참고)              |
| 크로스 셀링                       | `주문번호` · `상품번호` (같은 주문번호로 행을 묶어 조합을 셉니다)              |
| 상품별 매출                       | `결제금액` · `상품번호`                                       |
| 카테고리별 매출                     | `결제금액` · `카테고리 ID` 또는 `카테고리명`                         |
| 클릭률 (CTR) · 노출 단가 (CPM)      | `노출수` · `클릭수` · `광고비 (VAT 포함)`                        |
| 전환당 비용 (CPA)                 | `광고비 (VAT 포함)` · `전환`                                 |
| 클릭 대비 전환율 (CVR)              | `클릭수` · `전환`                                          |
| 노출 대비 전환율 (CVR)              | `노출수` · `전환`                                          |
| 광고 수익률 (ROAS)                | `광고비 (VAT 포함)` + 주문의 `결제금액` (전환 ROAS는 `전환 가치`)        |
| 마진                           | `결제금액` + 기초 상품의 `원가`                                  |
| POAS                         | `결제금액` · `광고비 (VAT 포함)` + 기초 상품의 `원가`                 |
| 공헌이익                         | `결제금액` · 기초 상품의 `원가` · `광고비 (VAT 포함)` · `수수료` · `배송비` |

**구매자를 구분할 값**: 재구매율이나 객단가처럼 "한 사람"을 세는 지표에는 구매자를 구분할 값이 필요합니다. 스프레드시트로 올리실 때는 `주문자 전화번호` → `회원 ID` → `주문자 이메일 주소` 순으로 먼저 채워진 값을 사용합니다. 회원 ID가 없어도 전화번호나 이메일이 있으면 계산됩니다.

계산식 전체는 [계산식 알아보기](https://www.analytics-docs.laplacetec.com/guide/dashboard/formula.md)를 참고해 주세요.

## 전담 매니저에게 요청하기 <a href="#contact" id="contact"></a>

컬럼 매핑에 대해 더 궁금한 점이 있으신가요?

> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)

**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)
