# API 직접 적재(Push API) | 사내 데이터를 라플라스로 전송 | 라플라스

URL: https://www.analytics.laplacetec.com/integration/api

> 고객사 서버에서 주문·회원·상품·리뷰 등 8가지 데이터를 라플라스 API로 직접 보내, 쇼핑몰·광고 데이터와 합쳐 재구매율·LTV·ROAS를 분석해요. Growth 플랜부터.

API 직접 적재(Push API) 연동

# API 직접 적재(Push API) 데이터, 사내 데이터도 분석으로

고객사 서버에서 주문·회원·상품·리뷰 등 8가지 데이터를 라플라스 API로 직접 보내, 쇼핑몰·광고 데이터와 합쳐 재구매율·LTV·ROAS를 분석해요. Growth 플랜부터.
[무료로 시작하기](https://www.analytics.laplacetec.com/login) [소개서 받기](https://www.analytics.laplacetec.com/contact?tab=brochure)
API 직접 적재(Push API) 로고API 직접 적재(Push API)
연결 방식
고객사 서버에서 라플라스로 데이터 직접 전송(POST)
필요한 것
고객사 개발 인력, 라플라스 API 키(프로젝트 오너 발급)
업데이트
보낸 데이터를 받아 반영
Growth 플랜부터

## API 직접 적재(Push API) 데이터로 라플라스에서 이런 분석을 봐요.

### 사내 데이터로 만드는 대시보드

보낸 데이터에서 지표와 차원을 골라 차트를 만들고, 쇼핑몰·광고 차트와 한 보드에 모아요.
- 지표·차원 직접 선택
- 데이터 소스별 차트

### 회원 ID 기준 재구매·LTV

주문과 회원을 같은 회원 ID로 보내면 첫 구매 월별 재구매율과 고객생애가치를 봐요.
- 재구매율
- 고객생애수익(LTR)
- 이탈율

### 원가까지 보내 SKU별 이익

기초 상품과 옵션 매칭을 함께 보내면 상품마다 원가를 반영한 마진·공헌이익을 봐요.
- 마진율
- 공헌이익

### AI 에이전트에 질문

보낸 데이터에 대해 물으면 표·차트로 답하고 이상 징후를 알려 줘요.
- 원인 진단
- 이상 징후 알림

## 다른 데이터와 함께 보면 API 직접 적재(Push API)만으로는 안 보이던 게 보여요.

API 직접 적재(Push API)카페24스마트스토어

### 자체 주문 + 외부 판매처

자체 시스템 주문을 API로 보내면 연동된 쇼핑몰·오픈마켓 주문과 같은 기준으로 합쳐 판매처별 매출과 고객을 봐요.
- 판매처별 매출
- 재구매율
- 코호트 LTV
자세히
API 직접 적재(Push API)Meta(페이스북·인스타그램) 광고Google Ads(구글 광고)

### 광고비 대비 자체 주문 매출

광고 채널 광고비와 API로 보낸 주문 결제금액을 합쳐 광고 성과를 실제 주문으로 계산해요.
- ROAS
- CAC
- 캠페인별 광고비
자세히
API 직접 적재(Push API)회원 데이터

### 회원 정보로 코호트 보기

회원 데이터를 주문과 같은 회원 ID로 보내면 재구매율·객단가·코호트 LTV처럼 한 사람을 따라가는 지표가 계산돼요.
- 재구매율
- 코호트 LTV
- 재구매 주기
자세히

### 함께 연결하는 채널

- [데이터베이스(DB)](https://www.analytics.laplacetec.com/integration/database)
- [Amazon S3 주문 데이터](https://www.analytics.laplacetec.com/integration/s3)
- [구글 스프레드시트](https://www.analytics.laplacetec.com/integration/google-sheets)
- [카페24](https://www.analytics.laplacetec.com/integration/cafe24)
- [전체 연동 채널 보기](https://www.analytics.laplacetec.com/integration)

## API 직접 적재(Push API)에서 가져오는 데이터 협의한 데이터가 정해진 주기로 모여요.

데이터 종류
8가지
전송 형식
NDJSON(gzip 압축)
반영
데이터 갱신 때(직접 갱신 가능)
01

### 보낼 수 있는 데이터

연결 안에 소스를 만들고 데이터 종류를 골라요. 한 요청은 한 소스로만 보내요.
- 주문
- 상품
- 회원
- 광고
- 리뷰
- 카테고리
- 기초 상품
- 기초 상품 옵션 매칭
02

### 회원·상품·카테고리

스프레드시트로는 올릴 수 없는 데이터예요. 주문의 회원 ID와 같은 값을 보내야 재구매율·코호트 LTV가 주문과 이어져요.
- 회원 ID
- 회원 상태
- 상품번호
- 상품 상태
- 카테고리 ID
- 상위 카테고리 ID
03

### 리뷰

브이리뷰·크리마가 아닌 리뷰 데이터는 API로 직접 보내요.
- 리뷰 작성 날짜/시간
- 회원 ID
- 상품번호
- 평점
- 리뷰 내용
- 리뷰 유형
집계 기준은 직접 골라요
- 결제금액 VAT 포함 / 제외
- 환불/취소 제외 금액 따로 보기
- 회원 ID로 주문·회원 연결
[전체 지표 보기](https://www.analytics-docs.laplacetec.com/guide/customdashboard/custom/about_values)

## 연결은 이렇게 해요 담당 엔지니어와 함께 진행해요.

- 1 ### 연결·소스 만들기 라플라스 「데이터 연결」 › 「API 직접 적재」에서 연결 이름·데이터 종류·소스 이름을 넣고 「생성」을 누르면 전송 주소와 데이터 소스 ID가 보여요.
- 2 ### 컬럼 매칭 보낼 JSON의 키를 라플라스 컬럼에 연결해요. 필수 컬럼은 반드시 매칭해야 해요.
- 3 ### API 키 발급 「설정」 › 「API 연동」 › 「API 키」에서 키를 발급해요. 키는 발급할 때 한 번만 보이고 90일 뒤 만료돼요.
- 4 ### 전송·확인 전송 주소·API 키·데이터 소스 ID로 데이터를 보내고, 「API 직접 적재」 화면의 배치 현황에서 접수·검증 결과를 확인해요.

### 개발이 필요한 연결이에요

- 화면에서 클릭으로 연결하는 다른 채널과 달리 고객사 서버에서 데이터를 보내는 개발이 필요해요.
- API 키 발급은 프로젝트 오너가 Growth 이상 요금제에서 할 수 있어요.
- 전송 결과를 조회하는 API는 없어요. 접수·검증 결과는 「API 직접 적재」 화면의 배치 현황 표에서 봐요.

### 연결 전에 확인하세요

- 분당 10회를 넘지 않도록 설계해 주세요. 넘으면 호출이 막힐 수 있어요.
- 막혀서 다시 보낼 때는 배치마다 정해 둔 같은 Idempotency-Key로 보내 주세요. 키를 새로 만들면 같은 데이터가 중복으로 쌓여요.
- 전송 성공 응답은 접수했다는 뜻이에요. 대시보드에는 데이터 갱신 뒤에 반영되고, 배치 현황의 통과·거부 건수는 보통 다음 날 갱신 뒤에 채워져요.
- 소스를 남긴 채 일부 데이터만 골라 지우는 기능은 없어요. 소스를 삭제하면 그 소스로 보낸 데이터가 다음 갱신부터 빠져요.
화면별 자세한 순서와 오류 해결은 제품 가이드에 있어요.
[API 직접 적재(Push API) 연결 가이드 보기](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/api/push-ingestion)

## API 직접 적재(Push API) 연동, 자주 묻는 질문

더 궁금한 점은 언제든 문의해 주세요. 도입 방식에 맞춰 안내해 드려요.

### 개발 없이 연결할 수 있나요?

API 직접 적재는 고객사 서버에서 데이터를 보내야 해서 개발이 필요해요. 개발 없이 올리고 싶다면 구글 스프레드시트나 S3 주문 데이터 연결을 써 보세요.

### 보낸 데이터가 대시보드에 안 보여요.

보낸 데이터는 접수 → 검증 → 적재 → 데이터 갱신을 거쳐 화면에 나타나요. 바로 보고 싶으면 「API 직접 적재」 목록에서 그 소스의 「갱신」을 눌러 주세요. 그래도 안 보이면 배치 현황의 거부 건수를 확인해 주세요.

### 보낸 데이터를 대시보드에서 빼고 싶어요.

그 소스를 삭제하면 다음 데이터 갱신부터 빠져요. 연결과 전송 주소, API 키는 그대로이고, 소스를 다시 추가하면 데이터 소스 ID만 새 값으로 바뀌어요.

### 연결은 어떻게 진행되나요?

문의를 남겨 주시면 담당 엔지니어가 보낼 데이터와 구조를 함께 확인한 뒤 연결을 도와드려요.

### 무료로 써 볼 수 있나요?

최대 3주 무료 체험으로 유료 플랜과 같은 전체 기능을 써 볼 수 있어요. 카드 등록은 필요 없어요.