2026년 8월 31일 확인: Pinterest 카탈로그는 데이터 수집과 배포를 별도로 처리합니다. 파일은 정상적으로 다운로드되어도 개별 제품 행은 실패할 수 있으며, 제품 수집에 성공해도 자연 검색이나 유료 배포 대상이 되지 않을 수 있습니다.
권장 절차: 진단 데이터를 내보내고 실패한 피드를 보존한 다음, 한 번에 오류 유형 하나씩 고쳐 다음 예약 수집 결과와 비교합니다. 대시보드 요약만 보고 전체 피드를 다시 작성하지 마세요.
올바른 진단 단계부터 시작하기
Pinterest 카탈로그 진단 기능은 다음 두 문제를 구분합니다.
- 수집 문제: 업로드 실패, 제품 행 실패, 메타데이터 경고
- 배포 문제: 광고나 자연 노출 대상이 될 수 없는 제품
문제가 발생한 탭에서 상세 정보를 내보냅니다. 카탈로그, 데이터 소스, 수집 시각, 전체 제품 수, 성공한 행 수, 경고 수, 실패 수를 기록하세요.
제품 행보다 먼저 피드 접근 확인하기
Pinterest 카탈로그 요구사항에 따르면 호스팅된 데이터 소스는 지원되는 HTTP/HTTPS, FTP/SFTP 또는 WebDAV 방식으로 직접 다운로드할 수 있어야 합니다. IP나 SSH 키 허용 목록 또는 추가 탐색 단계를 요구해서는 안 되며, 직접 URL의 포트는 80 또는 443이어야 합니다.
- 100: Pinterest가 데이터 소스를 다운로드하지 못했습니다. URL, 인증 정보, 리디렉션, HTTP 상태, 요청 시 파일이 직접 반환되는지 확인하세요.
- 152: 데이터 소스에 필요한 최소 유효 행이 없습니다. 헤더와 제품 행이 하나 이상 있는지, Pinterest 크롤러가 접근할 수 있는지 확인하세요.
- 2: 데이터 소스가 변경되지 않아 수집이 일찍 종료되었습니다. 이는 경고이며 피드 실패를 뜻하는 것은 아닙니다.
- 1013: 제품 수가 크게 변했습니다. 내보내기 페이지 처리, 필터, 상위 데이터 생성 작업에서 제품이 누락되지 않았는지 확인하세요.
필수 제품 필드 수정하기
- 107: 설명이 없습니다. 실제 제품 설명을 입력하세요.
- 111: 필수 필드인
image_link가 없습니다. 외부에서 접근할 수 있는 제품 이미지 URL을 입력하세요. - 112: 재고 상태가 없습니다. in stock, out of stock, preorder처럼 지원되는 값을 사용하세요.
- 113: 가격 형식이 올바르지 않습니다. 숫자 가격과 올바른 ISO 4217 통화 코드를 입력하세요.
- 151: 필수 가격이 없습니다. 제품의 실제 현재 가격을 추가하세요.
- 1001: 이미지를 찾지 못했습니다. 응답 상태, 리디렉션, 경로의 대소문자, 공개 접근 가능 여부를 확인하세요.
- 1007: 이미지 파일이 올바르지 않습니다. 지원되는 정상 이미지로 바꾸고 URL을 업데이트하세요.
쇼핑몰 관리 시스템 안의 제품 값만 보지 말고 실제로 내보낸 파일을 검사하세요.
식별자, 도메인, 중복 문제 수정하기
- 123: 항목 ID가 중복되었습니다. 서로 다른 제품과 옵션마다 변경되지 않는 고유 ID가 필요합니다.
- 139: 항목 링크가 소유권 인증 도메인과 일치하지 않습니다. 대상 호스트를 수정하거나 올바른 웹사이트의 소유권을 인증하세요.
- 179: GTIN 형식이 올바르지 않습니다. Pinterest가 허용하는 길이는 하이픈 없이 8자리, 12자리, 13자리 또는 14자리입니다.
- 154: 제품 유형이 너무 많습니다. Pinterest는 목록에서 최대 5개를 지원합니다.
오류 139를 우회하려고 모든 제품 링크를 바꾸기 전에 웹사이트 소유권 인증 가이드에서 관련 절차를 먼저 확인하세요.
가격, 통화, 배송, 할인가 필드 수정하기
- 125: 할인가가 정상가 또는 표시 가격보다 높습니다. 원본 값과 적용 기간을 수정하세요.
- 169: 판매 지역에 맞지 않는 통화로 보입니다. 판매 시장과 피드 설정을 확인하세요.
- 180: 가격 관련 필드의 통화가 서로 다릅니다. 항목 하나의 맥락에서는 올바른 통화 하나만 사용하세요.
- 182: 할인가가 정상가보다 지나치게 낮습니다. 실제 할인인지, 소수점이나 통화 오류가 아닌지 확인하세요.
- 131: 배송 형식이 올바르지 않습니다. Pinterest는 필수 콜론을 포함한 country:region:service:price 구조를 요구합니다.
분류 체계 및 메타데이터 경고 수정하기
- 126: Google 제품 카테고리 단계가 너무 적습니다. 해당 제품에 적용되는 가장 구체적인 분류 경로를 입력하세요.
- 157: Google 제품 카테고리가 없습니다.
- 158: Google 제품 카테고리 형식이 올바르지 않습니다.
- 116: 제품 상태가 없습니다. new, used, refurbished처럼 지원되는 값을 사용하세요.
- 155: 추가 이미지가 10개를 넘습니다. 목록 수를 줄이세요.
- 115: 설명이 10,000자를 넘어 초과 부분이 잘립니다.
경고가 있어도 수집은 될 수 있지만 제품 매칭이나 배포 품질이 낮아질 수 있습니다. 먼저 실패 항목을 수정한 다음, 영향을 받은 행이 많은 경고부터 처리하세요.
Shopify 및 정책 관련 코드 수정하기
- 4057: Shopify 제품이 Pinterest 판매 채널에 활성화되어 있지 않거나 제공되지 않습니다.
- 4058: 제품이 필수 조건인 Shopify 호스팅 온라인 스토어에서 판매 가능한 상태가 아닙니다.
- 4059: 제품 정보가 데이터 소스의 기본 언어로 번역되지 않았습니다.
- 4042: 제품이 판매자 가이드라인을 충족하지 않습니다. 위반 제품을 삭제하거나 수정하세요. 메타데이터 형식만 고쳐서는 정책상 자격 미달 문제가 해결되지 않습니다.
코드가 추가되거나 변경될 수 있으므로 항상 Pinterest 공식 오류 코드 문서에서 최신 설명을 확인하세요.
통제된 수정 절차 사용하기
- 실패한 피드와 내보낸 진단 데이터를 보관합니다.
- 영향을 받은 행을 오류 코드별로 묶습니다.
- 행 단위 오류보다 파일 단위 실패를 먼저 수정합니다.
- 일회성 CSV 사본만 고치지 말고 상위 쇼핑몰 원본 데이터를 수정합니다.
- 인코딩, 구분자, 필수 헤더, 표본 행을 로컬에서 검사합니다.
- 새 데이터 소스를 게시하고 직접 다운로드되는지 확인합니다.
- 다음 수집을 기다리거나 Pinterest가 지원하는 방법으로 실행합니다.
- 수치를 비교하고 진단 데이터를 다시 내보냅니다.
카탈로그와 리치 핀 및 판매자 상태 함께 점검하기
카탈로그는 페이지 단위의 리치 핀 마크업과 다릅니다. 제품 페이지에도 정확한 최신 데이터가 표시되어야 합니다. 페이지 메타데이터는 리치 핀 가이드에서 확인하세요. 카탈로그 성공 여부가 자격 요건에 포함된다면 인증 판매자 점검 가이드에서 자격 요건을 확인하세요.
카탈로그 문제 해결 원칙
실패한 입력 파일을 보존하고 오류 코드 유형별로 상위 원본 데이터를 수정한 뒤 다음 수집 결과를 수치로 확인하세요. 파일 업로드가 성공으로 표시된다고 모든 제품이 배포 대상이라는 뜻은 아닙니다.
Pinterest 활용 체계 계속 만들기
다음 단계에 맞는 가이드를 이어서 읽어 보세요.
