상품 정보 연동하기

블럭스 서비스에 상품 정보를 연동하는 방법을 소개합니다.

상품 정보는 유저가 어떤 상품을 조회하거나 구매했는지를 이해하고, 개인화된 추천이나 랜딩 페이지, 상품 기반 캠페인에 활용하기 위한 핵심 데이터입니다.

상품 정보를 연동하면 개인화된 추천 캠페인을 사용할 수 있습니다. 예를 들어, 유저가 자주 보는 카테고리의 상품을 추천하거나, 장바구니에 담긴 상품과 유사한 아이템을 메시지로 제안할 수 있습니다.

상품 정보는 크게 두 가지로 나뉘어요.

구분	설명	예시
기본 상품 정보	메시지 발송에 꼭 필요한 필수 상품 정보	item_id, price, category, brand, image_url
커스텀 상품 정보	서비스 특성에 따라 자유롭게 정의하는 상품 정보	is_promotion, rating, subscription_only

예시 데이터

item_id	item_name	category_id_1	category_name_1	brand_id	brand_name	price
A1234	스트라이프 셔츠	C1234	셔츠	B1234	브랜드 A	10000
B1234	슬림핏 데님 팬츠	C5678	팬츠	B5678	브랜드 B	23000

연동 방식

고객님 서비스의 전체 상품 정보가 담긴 파일의 URL을 준비하세요.

.csv, .txt, .csv.gz, .jsonl, .parquet 형식의 파일만 지원해요.
상품 정보 파일의 크기가 10GB를 넘거나, 상품 목록의 개수가 1,000만 개를 넘는 경우에는 블럭스 담당자에게 문의하세요.

연동 방식을 결정하고 상품 파일 URL을 연동하세요.

상품 파일 URL을 이용하는 방법과 AWS S3 버킷을 이용하는 방법이 있어요.

매일 연동한 URL의 파일을 업데이트하세요.

업데이트하는 상품 정보 파일은 전체 상품 정보를 포함해야 해요.
* 새로 업로드하는 상품 정보는 기존의 모든 상품 정보를 대체해요. 기존 상품 정보는 모두 삭제되고, 새로 업로드한 상품 정보만 남아요.
블럭스는 고객님 서비스에 영향이 적은 특정 시간(예: 오전 3시)에 연동한 URL에 접근하여 상품 정보를 저장합니다.

상품 파일 URL

상품 정보가 담긴 파일의 URL을 이용하는 방식이에요. 블럭스는 해당 URL에 접근해서 상품 정보를 저장합니다.

고객님 서비스의 최신 상품 정보가 담긴 ① 파일의 URL, ② 값 구분자, ③ 인코딩 방식을 블럭스 담당자에게 전달하세요.
상품 데이터 속성 맵핑 정보를 블럭스 담당자에게 전달하세요. 연동할 데이터는 기본 상품 정보와 커스텀 상품 정보를 참고해주세요.

AWS S3 버킷

직접 블럭스의 AWS S3 버킷에 상품 정보 파일을 업로드하는 방식이에요.

블럭스의 AWS S3 버킷에 접근할 때 사용할 IAM ID의 ARN을 전달하세요.

전달한 IAM ID에 아래의 IAM 정책을 추가하세요. 클라이언트 아이디(CLIENT ID)는 연동 키에서 확인하세요.

{
   "Version": "2012-10-17",
   "Statement": [
       {
           "Sid": "VisualEditor0",
           "Effect": "Allow",
           "Action": [
               "s3:GetObject",
               "s3:PutObject",
               "s3:DeleteObject",
           ],
           "Resource": [
               "arn:aws:s3:::blux-external/`${APPLICATION ID}`/*"
           ]
       }
   ]
}   

고객님 서비스의 최신 상품 정보가 담긴 파일을 아래 경로에 업로드하세요.
```
s3://blux-external/${APPLICATION ID}/items/catalog.csv
```

기본 상품 정보

기본 상품 정보는 상품 기반 캠페인 및 추천에서 공통적으로 사용되는 정보입니다.

컬럼명	타입	설명	필수 여부
item_id	string	상품 식별자입니다.	✔️
item_name	string	상품 이름입니다.	✔️
category_id_1	string	상품 대분류 식별자입니다.	✔️
category_name_1	string	상품 대분류 이름입니다.	✔️
category_id_2	string	상품 중분류 식별자입니다.	✔️
category_name_2	string	상품 중분류 이름입니다.	✔️
category_id_3	string	상품 소분류 식별자입니다.
category_name_3	string	상품 소분류 이름입니다.
brand_id	string	상품 브랜드 식별자입니다.	✔️
brand_name	string	상품 브랜드 이름입니다.	✔️
price	number	할인된 상품 가격입니다.	✔️
retail_price	number	상품 가격입니다. 할인 전 가격을 입력하세요.	✔️
is_soldout	boolean	상품 품절 여부입니다. 상품이 품절되었으면 `true`를 입력하세요.
image_url	string	상품 대표 이미지 URL입니다. 외부 접근이 가능해야 해요.	✔️
item_url	string	상품 상세페이지 URL입니다.	✔️

* 카테고리 ID를 입력할 경우, 이름도 함께 입력해주세요.

* 대분류 ~ 소분류까지 최대 3개까지 연동 가능하며, 그 이상은 블럭스 담당자에게 문의해주세요.

(선택) 커스텀 상품 정보

커스텀 상품 정보는 새로운 상품 정보를 추가하고 추천 알고리즘에 더 다양한 조건을 반영하고 싶을 때 사용됩니다.

속성명, 설명, 타입 정보를 함께 전달해주세요.

컬럼명	타입	설명	예시
is_promotion	boolean	현재 프로모션 상품 여부	`true`
tag	string[]	상품 태그	`["추천", "신상"]`
rating	number	유저 리뷰 평균 평점	4.5

* 연동 가능한 타입은 String, Number, Boolean, Date, Array of String 타입이에요.

* 이외의 타입으로 연동하고자 하시는 경우 블럭스 담당자에게 문의해주세요.

연동 방식​

상품 파일 URL​

AWS S3 버킷​

기본 상품 정보​

(선택) 커스텀 상품 정보​

연동 방식

상품 파일 URL

AWS S3 버킷

기본 상품 정보

(선택) 커스텀 상품 정보