카탈로그를 시작하기 전에

카탈로그를 아직 사용할 수 없는 지역에서 보고 계신 것 같습니다. Pinterest Business에서 카탈로그를 사용할 수 있는 곳을 확인하세요.

자세히 알아보기

카탈로그를 설정하기 전에 다음 단계를 완료해야 합니다. 아래 링크를 클릭하면 필요한 섹션으로 이동합니다.

카탈로그가 내게 맞는 도구인가요?

카탈로그는 웹사이트에서 제품을 판매하는 비즈니스용으로 설계된 피드 수집 도구입니다. 카탈로그를 사용하려면 다음이 필요합니다.

  • Pinterest Business 계정
  • 데이터 소스- 제품 및 해당 속성 목록이 담긴 파일로 제품 카탈로그 또는 제품 피드라고도 함
  • 소유권이 표시된 웹사이트
  • 배송 정책, 환불 정책, 연락처를 쉽고 명확하게 찾을 수 있으며 Pinterest의 판매자 가이드라인을 충족하는 웹사이트
  • 데이터 소스 호스팅- Pinterest로 매일 전송할 수 있는 제품의 데이터 소스를 지속적으로 호스팅 및 저장하는 방법

위의 조건이 충족되지 않은 상태에서 쇼핑 핀을 만들고 싶은 경우 전자상거래 웹사이트와 제휴를 맺고 Pinterest를 위한 제품 형식을 지정할 수도 있습니다. 현재로서는 GoDataFeed와 Productsup을 이용할 수 있습니다. 또한 다른 방식으로도 Pinterest에서 콘텐츠를 홍보할 수 있습니다.

데이터 소스 개요

데이터 소스란?

데이터 소스(일반적으로 제품 카탈로그, 제품 피드, 데이터 피드로 알려짐)는 제품 및 해당 속성이 특정한 방식으로 구성된 목록 파일입니다. 이 파일은 매일 처리되어 제품으로부터 동적으로 핀을 생성합니다.

데이터 소스 작동 방식

Pinterest에 데이터 소스를 제출하려면 Pinterest가 데이터 소스 파일에 액세스할 수 있는 URL 링크를 제공해야 합니다. Pinterest는 파일을 인증하고 통과한 각 항목에 대해 제품 핀을 만듭니다. 데이터 소스 사양에 대한 자세한 내용을 확인하세요.

데이터 소스 유지하기

데이터 소스를 호스팅하면 재고가 있는 제품의 업데이트 정보를 지속적으로 제공합니다. Pinterest는 회원님의 데이터 소스를 매일 수집하고 오류 발생 시 회원님께 이를 알립니다. 정확한 최신 제품 정보를 제공하려면 가능한 한 신속하게 오류를 검토하고 수정하는 것이 중요합니다.

오류 유형에 따라 전체 피드가 업데이트되지 않았거나, 피드 일부 항목이 업데이트되지 않았거나, 모범 사례에 맞춰 일부 내용을 변경해야 하는 경우가 있을 수 있습니다. 오류 메시지 문제 해결에 대해 자세히 알아보세요.

데이터 소스에 대한 자세한 정보:

  • 매일 업데이트하세요. 데이터 소스는 24시간마다 수집됩니다. 제품 세부 정보를 최신으로 유지하려면 이용 가능한 데이터 소스 전체를 매일 업데이트하세요. 예약 또는 온디맨드 수집은 지원하지 않습니다.
  • 데이터 소스를 호스팅하세요. FTP/SFTP 서버 또는 HTTP/HTTPS 직접 다운로드 링크에서 데이터 소스를 호스팅하세요. 사용자 에이전트가 액세스할 수 있어야 하며 IP 또는 SSH 키 화이트리스트를 요구할 수 없습니다. 직접 다운로드 링크를 사용하는 경우 Pinterest가 파일에 액세스하기 위해 필요한 추가 탐색이 없어야 합니다. Pinterest는 데이터 소스 호스팅을 제공하지 않습니다.
  • 제품은 최대 500만 개입니다. 계정당 최대 500만 개의 제품을 처리할 수 있습니다. 데이터 소스에 제품이 500만 개 이상이라면 처음 500만 개의 행을 처리합니다.
  • 비즈니스 계정당 데이터 소스는 1개입니다.

Pinterest에 소유권 표시 웹사이트 보유

데이터 소스의 모든 랜딩 페이지 URL에는 Pinterest에 소유권 표시 웹사이트로 등록된 웹 도메인이 있어야 합니다. 비즈니스는 여러 도메인의 소유권을 표시할 수 있지만 각 도메인은 오직 하나의 Pinterest Business 계정만이 소유권을 표시할 수 있습니다. 웹사이트 소유권 표시 방법을 알아보세요.

데이터 소스 준비

피드를 설정하기 전에 제품 및 해당 속성 목록이 포함된 파일인 데이터 소스를 만들어야 합니다.

카탈로그 데이터 소스 호스팅 요구 사항

FTP/SFTP 서버에서 자체 호스팅을 제공하거나 HTTP/HTTPS 직접 다운로드 링크를 설정해야 합니다. Pinterest는 사용자용 호스팅을 제공하지 않습니다. 데이터 소스 위치는 사용자 에이전트가 액세스할 수 있어야 하며 IP 또는 SSH 키 화이트리스트를 요구할 수 없습니다. HTTP/HTTPS 형태의 직접 다운로드 링크를 사용하는 경우 링크에는 Pinterest가 파일에 액세스하기 위해 필요한 추가 탐색이 없어야 합니다

카탈로그 데이터 소스 형식 요구 사항

지원 형식:

형식 팁:

  • csv를 사용하는 경우 파싱 문제를 피하기 위해 값이 큰 따옴표로 묶입니다.
  • 이 외에 다른 부동 구분자(쉼표, 탭)를 사용하면 항목 또는 파일이 제대로 처리되지 않을 수 있습니다.
  • 각 행에 동일한 수의 구분자가 사용되었는지 확인하여 모든 행과 열의 구분자를 올바르게 설정되었는지 확인합니다.
  • 피드 사양의 경우 필수 및 설정 값은 반드시 표준화된 미국 영어를 사용해야 합니다.
  • 탭 또는 쉼표를 구분자로 사용한 파일의 데이터 소스 파일은 일반 텍스트, UTF-8 또는 Latin1으로 인코딩된 파일이어야 합니다.

제품 데이터 요구 사항

Pinterest 판매자 가이드라인을 준수해야 합니다. 가이드라인을 위반한 제품 또는 계정은 삭제될 수 있습니다.

필수 및 선택 필드

필수 필드는 7개입니다. 필수 필드 중 하나라도 누락되거나 형식이 올바르지 않으면 전체 피드가 수집되지 않습니다.

필수 필드:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

Pinterest가 제품을 피너에게 매핑하는 데 도움이 되는 선택 필드도 있습니다. 제공하는 정보가 많을수록 피너에게 보다 관련성 높은 핀이 표시됩니다. 피드에 세부 정보를 추가하고 관련성을 높이려면 선택 필드도 추가하는 것이 좋습니다.

필수 필드

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
id

사용자가 만든 고유 ID로 제품을 나타냄.

유니코드 문자만 허용됨.

최대 127자 DS0294-L 필수
title 제품명. 방문 페이지 제품과 이름이 같아야 함. 색상, 크기 등 다양한 세부 사항 포함. 최대 500자 여성 데님 셔츠, 라지 필수
description 제품 설명. 이 필드는 HTML을 지원하지 않으며 최적의 서비스를 위해 일반 텍스트로 작성되어야 함. 최대 10,000자 최고급 품질의 일본 데님으로 만든 캐주얼 핏 데님 셔츠  필수
link 제품 방문 페이지. 링크는 동일한 제품으로 연결되고 동일한 데이터를 보여 주어야 함. 인증 페이지를 사용하지 않는 게 좋음. URL은 http:// 또는 https://로 시작해야 함.  최대 511자 https://www.example.com/cat/womens-clothing/denim-shirt-0294 필수
image_link

제품 이미지 링크. URL은 사용자 에이전트가 액세스할 수 있어야 하며 정확한 이미지를 전송해야 함. 링크에 템플릿 또는 자리표시자 이미지가 없어야 함. http:// 또는 https://로 시작해야 함.

쉼표가 이미지 링크의 일부인 경우 현재 Pinterest에서 쉼표를 포함한 이미지 링크를 처리할 수 없으므로 쉼표를 인코딩하거나 삭제해야 함.

  https://scene.example.com/image/image.jpg 필수
price 제품 가격. 미화로 표시되지 않은 가격은 ISO-4217에 통화를 포함해야 함. 통화가 포함되지 않으면 미화로 기본 설정됨. 공백 여부와 관계 없이 숫자로 된 가격 값 뒤에 통화를 붙일 수 있음. 통화는 표준 ISO-4217 코드를 따라야 함. 가격 값은 0이 허용되지 않음. 통화 기호를 사용할 수 없음.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
필수
availability 제품 재고 상태. ‘in stock’, ‘out of stock’, ‘preorder’ 중 하나여야 함. in stock
out of stock
preorder
in stock 필수

선택적 일반 속성

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
product_type 사용자 지정 제품 분류 체계에 따른 제품 분류. 하위 범주는 “ > “로 구분하여 전송해야 함. >의 앞뒤에는 공백이 있어야 함. 쉼표나 파이프 등의 다른 구분자는 인식되지 않음.

L0 > L1 > L2 > L3 > L4

최대 1,000자

의류 > 여성 > 셔츠 > 데님 선택
additional_image_link

추가 제품 이미지 링크. 각 추가 이미지는 쉼표로 구분. 전체 문자열을 따옴표로 묶는 것이 좋음. http:// 또는 https://로 시작해야 함.

쉼표가 이미지 링크의 일부인 경우 현재 Pinterest에서 쉼표를 포함한 이미지 링크를 처리할 수 없으므로 쉼표를 인코딩하거나 삭제해야 함.
 

Pinterest에서는 전송된 모든 추가 이미지 링크에 대해 새로운 핀을 생성함.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" 선택
mobile_link 방문 페이지의 모바일 최적화 버전. http:// 또는 https://로 시작해야 함.   https://m.example.com/cat/womens-clothing/denim-shirt-0294 선택
sale_price 제품의 할인가. sale_price는 정가보다 낮아야 함. 정가와 동일한 설정의 통화를 포함해야 함. 미화로 표시되지 않은 가격은 ISO-4217에 통화를 포함해야 함. 통화가 포함되지 않으면 미화로 기본 설정됨. 공백 여부와 관계 없이 숫자로 된 가격 값 뒤에 통화를 붙일 수 있음. 0은 허용되지 않음. 통화 기호를 사용할 수 없음.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
선택

선택적 제품 ID

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
item_group_id 제품의 상위 ID  최대 127자 DS0294 세부 사항이 다양한 항목에 필수

브랜드

제품 브랜드   Josie’s Denim 선택
gtin 고유한 범용 제품 식별자 숫자 3234567890126 선택
mpn 제조업체 부품 번호란 제품 제조업체가 동일한 제조업체의 모든 제품 중 특정 제품을 구분하기 위해 제품에 부여한 문자와 숫자를 말함.  문자와 숫자 "mpn":
"PI12345NTEREST"
선택

선택적 제품 특성

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부

색상

제품의 기본 색상   파랑 선택
성별 제품과 관련된 성별. 전송 시 ‘male’, ‘female’, ‘unisex’ 중 하나여야 함. male
female
unisex
female 선택
age_group 제품에 인구 통계학적 범위를 적용하기 위한 연령대. ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ 중 하나여야 함. newborn
infant
toddler
kids
adult
adult 선택
소재 제품을 만드는 데 사용된 소재   선택
패턴 제품에 사용된 패턴 설명   격자 무늬 선택
크기 제품 크기   M 선택
size_type 크기에 대한 추가 설명. 전송 시 ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ 중 하나여야 함. regular
petite
plus
big_and_tall
maternity
regular 선택
size_system 제품을 제출하는 국가의 크기 체계를 나타냄 국가 코드

US
UK

선택

선택적 세금 및 배송 데이터

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
세금 각각의 세금 속성 그룹은 country:region:rate(필수):tax_ship의 4가지 하위 속성으로 구성됨.
빈 값에도 반드시 콜론이 필요함.
country:region:rate(필수):tax_ship US:1025433:6.00:y 선택
배송 각각의 배송 속성 그룹은 country, region, service, price(필수)의 4가지 하위 속성으로 구성됨.
빈 값에도 반드시 콜론이 필요함.
country:region:service:price(필수)

US:CA:Ground:0 USD

US::Express:13.12

선택

shipping_weight

제품 무게. 숫자 문자열과 단위 사이에 공백이 있어야 함. <numeric> <metric> 3 kg
5 lbs
선택
shipping_width 제품을 배송하는 데 필요한 패키지 너비. 숫자 문자열과 단위 사위에 공백이 있어야 함. <numeric> <metric> 16 in 선택
shipping_height 제품을 배송하는 데 필요한 패키지 높이. 숫자 문자열과 단위 사위에 공백이 있어야 함. <numeric> <metric> 12in 선택

선택적 성인 제품 플래그

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
adult “adult”로 간주되는 항목을 제출하는 경우 이 속성을 TRUE로 설정. Pinterest에는 표시되지 않음. TRUE
FALSE
true 선택

선택적 사용자 정의 라벨

제품의 사용자 정의 분류입니다. 계절 상품, 프로모션 상품, 많이 팔린 상품 등 목적에 맞춰 사용될 수 있습니다. 최대 5개까지 사용자 정의 라벨을 사용할 수 있습니다.

사용자 정의 라벨을 사용한 카탈로그에 제품 그룹을 만들 수 있습니다.

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
custom_label_0 제품의 사용자 정의 분류. 최대 1,000자

많이 팔린 상품

여름 프로모션

선택
custom_label_1 제품의 사용자 정의 분류. 최대 1,000자   선택
custom_label_2 제품의 사용자 정의 분류. 최대 1,000자   선택
custom_label_3 제품의 사용자 정의 분류. 최대 1,000자   선택
custom_label_4 제품의 사용자 정의 분류. 최대 1,000자   선택

선택적 쇼핑 광고 필드

열 이름 설명 구문/지원되는 값 예시 필수 항목 여부
ad_link 광고주가 Pinterest 쇼핑 광고 트래픽을 추적하는 데 사용할 개별 URL을 지정할 수 있음. 추적을 포함한 전체 URL을 전송해야 하며 추적 매개변수만 전송하면 안 됨. 현재 노출수 추적은 지원되지 않음. http:// 또는 https://로 시작해야 함. 문자열 URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest 선택
condition 제품 상태. ‘new’, ‘used’, ‘refurbished’ 중 하나여야 함. new
used
refurbished
new 선택
google_product_category 표준화된 Google Product Taxonomy에 따른 제품 분류. 정해진 분류 체계이며 텍스트 값과 숫자 코드가 모두 허용됨. 전체 분류 체계 의류 및 액세서리 > 의류 > 셔츠 및 상의
212
선택

 

Required and optional fields

There are 7 required fields. If any of these fields are missing, or are not properly formatted, your entire feed will fail ingestion.

Required fields:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

There are also optional fields you can add to help Pinterest better map your products to Pinners. The more information you provide, the more relevant your Pins will be to the Pinners who see them. We strongly recommend adding our optional fields as well to add more detail to your feed and improve relevancy.

Required fields

Column name Description Syntax/supported values Example Requirement
id

The user-created unique ID that represents the product.

Only Unicode characters are accepted.

Max 127 characters DS0294-L required
title The name of the product. Must be the same name as the product from the landing page. Include the variant details, such as color and size. Max 500 characters Women’s denim shirt, large required
description Description of the product. This field does not support HTML and must be in plain text for optimal experience. Max 10,000 characters Casual fit denim shirt made with the finest quality Japanese denim.  required
link The landing page for the product. The link must lead directly to the same product and showcase the same data. We recommend against hardwalls. The URL must start with http:// or https://  Max 511 characters https://www.example.com/cat/womens-clothing/denim-shirt-0294 required
image_link

The link to the product image. The URL must be accessible by a user-agent, and send the accurate image. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.

  https://scene.example.com/image/image.jpg required
price The price of the product. The price should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. Currency should follow the standard ISO-4217 code. We do not accept 0 values for price. Do not use currency symbols.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
required
availability The availability of the product. Must be one of the following values: ‘in stock’, ‘out of stock’, ‘preorder’. in stock
out of stock
preorder
in stock required

Optional general attributes

Column name Description Syntax/supported values Example Requirement
product_type The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by “ > “. The > must be wrapped by spaces. We do not recognize any other delimiters such as comma or pipe.

L0 > L1 > L2 > L3 > L4

Max 1000 characters

Clothing > Women’s > Shirts > Denim optional
additional_image_link

The links to additional images for your product. Separate each additional image with comma. We recommend enclosing the whole string with quotes. Must begin with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.
 

We will create a new pin for every additional image link sent.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" optional
mobile_link The mobile-optimized version of your landing page. Must begin with http:// or https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 optional
sale_price The discounted price of the product. The sale_price must be lower than the price. Include currency in the same setup as price. It should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. We do not accept 0 values. Do not use currency symbols.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
optional

Optional product identifier

Column name Description Syntax/supported values Example Requirement
item_group_id The parent ID of the product.  Max 127 characters DS0294 required for items with multiple variants

brand

The brand of the product.   Josie’s Denim optional
gtin The unique universal product identifier. Numeric 3234567890126 optional
mpn Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer.  Alphanumeric "mpn":
"PI12345NTEREST"
optional

Optional product characteristics

Column name Description Syntax/supported values Example Requirement

color

The primary color of the product   blue optional
gender The gender associated with the product. Must be one of the following values if sent: ‘male’, ‘female’, ‘unisex’ male
female
unisex
female optional
age_group The age group to apply a demographic range to the product. Must be the one of the following values: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ newborn
infant
toddler
kids
adult
adult optional
material The material used to make the product.   cotton optional
pattern Description of the pattern used for the product.   plaid optional
size The size of the product.   M optional
size_type Additional description for the size. Must be one of the following values if sent: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ regular
petite
plus
big_and_tall
maternity
regular optional
size_system Indicates the country’s sizing system in which you are submitting your product. Country code

US
UK

optional

Optional tax and shipping data

Column name Description Syntax/supported values Example Requirement
tax Each tax attribute group can consist of 4 sub-attributes: country:region:rate (required):tax_ship
All colons, even for blank values, are required.
country:region:rate(required):tax_ship US:1025433:6.00:y optional
shipping Each delivery attribute group can consist of 4 sub-attributes: country, region, service, and price (required).
All colons, even for blank values, are required.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

optional

shipping_weight

The weight of the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 3 kg
5 lbs
optional
shipping_width The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 16 in optional
shipping_height The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 12 in optional

Optional adult product flag

Column name Description Syntax/supported values Example Requirement
adult Set this attribute to TRUE if you are submitting items that are considered “adult”. These will not be shown on Pinterest. TRUE
FALSE
true optional

Optional custom labels

Custom grouping of products. These can be used for a variety of purposes such as seasonal, promotions, best sellers. We accept up to 5 different custom labels.

You will be able to create product groups in Catalogs using custom labels.

Column name Description Syntax/supported values Example Requirement
custom_label_0 Custom grouping of products. Max 1000 characters

Best sellers

Summer promotion

optional
custom_label_1 Custom grouping of products. Max 1000 characters   optional
custom_label_2 Custom grouping of products. Max 1000 characters   optional
custom_label_3 Custom grouping of products. Max 1000 characters   optional
custom_label_4 Custom grouping of products. Max 1000 characters   optional

Optional shopping ad fields

Column name Description Syntax/supported values Example Requirement
ad_link Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking, do not send tracking parameters only. At this time we do not support impression tracking. Must begin with http:// or https:// string URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest optional
condition The condition of the product. Must be one of the following values: ‘new’, ‘used’, ‘refurbished’. new
used
refurbished
new optional
google_product_category The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. Full taxonomy Apparel & Accessories > Clothing > Shirts & Tops
212
optional

 

Pinterest 태그 설정

Pinterest 태그는 전환 통찰력을 수집하고 사이트에서 수행한 행동을 기반으로 독자를 구축하기 위해 웹사이트에 넣는 자바스크립트 코드입니다.

쇼핑 관련 필드는 반드시 Pinterest 태그를 통해 전송하세요.

  • PageVisits, AddToCart, Checkouts 의 전환 유형이 구현된 Pinterest 태그가 반드시 있어야 합니다.
  • PageVisit, AddToCart, Checkouts을 위한 속성으로 “product_id”에 이벤트 데이터를 전달해야 합니다. 
    • Product_id는 항목 아래로 전달되어야 합니다(전환 보기 페이지에는 표시되지 않음).
    • Tag Helper Chrome Extension을 사용하여 제품 세부 정보 페이지로  제품 ID를 다시 전달했는지 한 번 더 확인하세요.
  • 태그로 전달한 product_id 데이터는 데이터 소스에 제공된 "item_group_id" 또는 "id"와 일치해야 합니다.
  • 최근 7일 동안 제품 ID로 다시 전달한 PageVisit 및 AddtoCart 이벤트를 합한 수가 최소 10만 건 이상이어야 합니다.
     

다음 단계

Pinterest 데이터 소스 수집 가이드에서 제품 피드를 Pinterest에 연결하는 방법을 알아보세요.

아직 도움이 필요하세요?
문의하기