Feed URL 양식 - 당근 상품테이블

제한 사항

  • 파일 형식 제한 : CSV, TSV

  • 크기 제한 : 4GB

  • 계정별 파일 총량 제한: 8GB

    • 계정별 파일 총량이 8GB를 초과하게 되면 상품 등록과 업데이트가 원활하게 진행되지 않을 수 있어요.

상품 필수 속성

당근에 업로드할 때 반드시 필요한 속성이에요.

만약 해당 속성이 없거나, 지원되지 않는 형식으로 입력되어 있으면 상품을 등록할 수 없어요.

속성 id
속성이름
유형
설명
예시
비고

id

상품 ID

String

상품을 특정할 수 있는 ID예요.

sku1235456

• 글자수 최소 2자, 최대 100자 • 카탈로그 단위 상품 ID 중복 불가

title

제목

String

상품의 제목이에요. 광고 노출에 포함돼요.

[당근마켓] 여성 데님 청바지

• 최대 200자 • brandName과 동일한 값 불가

brand_name

브랜드 이름

Sting

상품의 브랜드 이름이예요. 광고 노출에 포함돼요.

당근마켓

• 최대 100자 • title과 동일한 값 불가

image_url

이미지 URL

String

상품의 이미지 URL이에요. 1:1 비율의 이미지를 권장하며, 1:1 비율이 아닌 이미지의 경우 이미지의 일부가 잘릴 수 있어요.

https://www.daangn.com/denimjean_image_001.jpg

• 최대 1000자 • Http/Https 형식을 지원해요. • 최대 10MiB 이미지 파일을 지원해요. • jpg. jpeg. png. 포맷만 지원해요. • 최소 200x200 픽셀 이상의 이미지만 지원해요.

landing_url

랜딩페이지 URL

String

상품을 구매할 수 있는 페이지의 URL이에요. 광고 클릭시 해당 페이지로 이동해요. 앱스토어로 랜딩되는 URL은 허용되지 않아요. 광고 성과를 제대로 측정하기 위해서는 추적 가능한 URL 등록이 필요해요.

https://www.daangn.com/articles/465249937

• 최대 2024자 • Https 형식만 지원해요.

price

가격

String

상품의 가격이에요. 원화만 지원해요. 할인된 가격이 있는 경우 할인 전 기본가격을 이 속성에 입력하고, 할인된 가격을 salePrice 속성에 입력해주세요. 숫자만 입력하거나 숫자 뒤에 KRW를 붙여주세요.

20000 또는 20000 KRW

• 원화만 지원 • 1원~10억원 금액만 지원

상품 선택 속성

상품을 더 효과적으로 관리하고 사용하기 위해 선택 속성을 포함할 수 있어요. 해당 속성이 없거나 형식이 없으면 해당 속성값은 입력되지 않은 상태로 상품이 등록돼요.

속성 id

속성이름

유형

설명

예시

비고

flea_market_category_id

당근마켓 상품 카테고리 ID

Int

당근마켓 중고거래 상품에 카테고리에요.

1007

google_product_category_id

구글 제품 카테고리 ID

Int

Google의 제품 카테고리에요.

204

• 텍스트 형태의 구글 제품 카테고리는 지원불가

sale_price

할인 가격

String

상품의 할인된 가격이에요. 할인된 가격이 있는 경우 할인된 가격이 광고에 노출되어요. 숫자만 입력하거나 숫자 뒤에 KRW를 붙여주세요.

18000 또는 18000 KRW

• 원화만 지원 • 1원~10억원 금액만 지원

sale_price_effective_date

할인가격 유효기간

두 개의 ISO-8601 timestamp

할인된 가격이 유효한 기간이에요. 설정된 기간에 해당되는 경우 salePrice 속성에 입력된 가격이 광고에 사용돼요.

2017-12-01T0:00/2017-12-31T0:00

  • 해당 값이 없을 경우 전체 기간 할인 가능한 상품으로 인식해요.

category_name_0

카테고리명

String

상품의 카테고리명이에요. 대분류~세분류 구분없이 모든 레벨의 카테고리를 한번에 넣을 수 있어요.

가전, 디지털 > 냉장고 > 양문형 냉장고or 여성/ 아우터 /카디건

• 최대 750자

category_name_1

카테고리명 (대분류)

String

상품의 카테고리 중 가장 큰 단위의 대분류 카테고리예요.

디지털/가전

• 최대 50자

category_name_2

카테고리명 (중분류)

String

상품의 카테고리 중 두번째 단위의 중분류 카테고리예요.

휴대폰

• 최대 50자

category_name_3

카테고리명 (소분류)

String

상품의 카테고리 중 세번째 단위의 소분류 카테고리예요.

skt

• 최대 50자

category_name_4

카테고리명 (세분류)

String

상품의 카테고리 중 마지막 단위의 세분류 카테고리예요.

갤럭시

• 최대 50자

description

상품 설명

String

상품에 대한 상세 설명이에요.

온고지신의 정신으로 오직 6년근 100% 홍삼만을 담은 우리 몸을 위한 순수 홍삼 스틱입니다.

• 최대 1000자

additional_image_url

추가 이미지

String

상품의 추가 이미지 URl이에요. 1:1 비율의 이미지를 권장하며, 1:1 비율이 아닌 이미지의 경우 이미지의 일부가 잘릴 수 있어요.

https://www.daangn.com/denimjean_image_002.jpg

• 최대 2000자 • Http/Https 형식을 지원해요. • jpg. jpeg. png. 포맷만 지원해요. • 최대 10MiB 이미지 파일을 지원해요. • 최소 200x200 픽셀 이상의 이미지만 지원해요.

video_url

동영상 URL

String

상품에 대한 비디오 URL이에요.

https://www.daangn.com/denimjean_video_001.jpg

• 최대 1000자

search_keywords

검색 키워드

String

상품에 관련된 검색 키워드 리스트예요.

물방울패턴원피스|2016 S/S신상 원피스|결혼식 아이템|여친룩

• 최대 100자

gender

성별

String

상품의 타겟 성별이에요.

UNISEX

• 지원되는 입력값: - FEMALE (여성) - MALE (남성) - UNISEX (남녀공용)

is_brand_certification

브랜드 인증 여부

String

브랜드 인증여부를 확인하기 위한 태그예요.

Y

availability

재고

String

상품의 재고 상태에 대한 정보예요. 재고가 없거나 판매가 중단된 상품의 경우 광고에 사용되지 않아요.

IN_STOCK

• 지원되는 입력값: - IN_STOCK (있음) - OUT_OF_STOCK (없음) - PREORDER (주문제작) - DISCONTINUED (판매중단)

  • 해당 값이 없을 경우 전체 in stock(재고 있음)으로 인식해요.

condition

상품 상태

String

상품의 상태값이에요.

NEW

• 지원되는 입력값 - NEW (새상품) - USED (중고) - REFURBISHED (리퍼)

custom_label_0

사용자 속성 0

String

카탈로그 관리자가 자유롭게 사용할 수 있는 속성 값이에요.

3월 프로모션

• 최대 100자

custom_label_1

사용자 속성 1

String

카탈로그 관리자가 자유롭게 사용할 수 있는 속성 값이에요.

프리미엄 브랜드

• 최대 100자

custom_label_2

사용자 속성 2

String

카탈로그 관리자가 자유롭게 사용할 수 있는 속성 값이에요.

특가이벤트

• 최대 100자

custom_label_3

사용자 속성 3

String

카탈로그 관리자가 자유롭게 사용할 수 있는 속성 값이에요.

여름한정

• 최대 100자

custom_label_4

사용자 속성 4

String

카탈로그 관리자가 자유롭게 사용할 수 있는 속성 값이에요.

가성비

• 최대 100자

color

색상

String

상품의 색상이에요.

빨강

• 최대 200자

size

사이즈

String

상품의 사이즈예요.

L

• 최대 200자

is_adult

미성년자 구매 불가 상품

String

미성년자가 구매할 수 없는 성인용 상품을 구분하기 위한 속성이에요. 성인용 상품은 등록되지 않아요.

N

• 지원되는 입력값: - Y - N

  • 해당 값이 없을 경우 N(미성년자 구매 불가 상품이 아님)으로 인식해요.

마지막 업데이트