> For the complete documentation index, see [llms.txt](https://businessdaangn.gitbook.io/business.daangn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://businessdaangn.gitbook.io/business.daangn/ads-pro/tools/catalog/karrot.md). # 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 비율이 아닌 이미지의 경우 이미지의 일부가 잘릴 수 있어요. | |

• 최대 1000자

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

| | landing\_url | **랜딩페이지 URL** | String |

상품을 구매할 수 있는 페이지의 URL이에요. 광고 클릭시 해당 페이지로 이동해요.

앱스토어로 랜딩되는 URL은 허용되지 않아요.

광고 성과를 제대로 측정하기 위해서는 추적 가능한 URL 등록이 필요해요.

| |

• 최대 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 비율이 아닌 이미지의 경우 이미지의 일부가 잘릴 수 있어요. | |

• 최대 2000자

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

| | video\_url | 동영상 URL | String | 상품에 대한 비디오 URL이에요. | | • 최대 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(미성년자 구매 불가 상품이 아님)으로 인식해요.
|