2026년 8월 27일 검증됨: Pinterest 카탈로그는 수집과 배포를 분리합니다. 파일이 성공적으로 다운로드될 수 있지만 개별 제품이 실패할 수 있으며, 제품이 성공적으로 수집되더라도 유기적 또는 유료 배포에 적합하지 않을 수 있습니다.
최선의 방법: 진단(export Diagnostics) 정보를 내보내고, 실패한 피드를 유지하며, 한 번에 하나의 오류 유형을 수정하고, 다음 예정된 수집과 비교하십시오. 대시보드 요약에서 전체 피드를 다시 작성하지 마십시오.
정확한 진단 레이어부터 시작하세요
- 수집 문제: 업로드 실패, 행 실패, 메타데이터 경고;
- 배포 문제: 광고 또는 유기적 노출에 적합하지 않은 제품.
영향을 받은 탭에서 내보내기 세부 정보. 카탈로그 기록, 데이터 소스, 수집 타임스탬프, 총 제품 수, 성공한 행, 경고 및 실패 기록.
행을 디버깅하기 전에 피드 접근 권한을 확인하십시오.
Pinterest의 카탈로그 요구 사항 호스팅된 소스는 지원되는 HTTP/HTTPS, FTP/SFTP, 또는 WebDAV를 통해 직접 다운로드할 수 있어야 합니다. IP/SSH 키 화이트리스트나 추가 탐색이 필요해서는 안 되며, 직접 URL 포트는 80 또는 443이어야 합니다.
- 100: Pinterest에서 데이터 소스를 다운로드할 수 없습니다. URL, 자격 증명, 리다이렉트, 상태, 직접 파일 응답을 테스트하세요.
- 152: 소스에 최소 유효 행이 부족합니다. 헤더와 최소 하나의 제품 행, 크롤러 접근 여부를 확인하세요.
- 2: 소스가 변경되지 않아 수집이 일찍 종료되었습니다. 이는 경고일 뿐이며, 반드시 피드 실패를 의미하지는 않습니다.
- 1013: 제품 수가 크게 변경되었습니다. 내보낸 페이지네이션, 필터 또는 업스트림 작업이 제품을 누락하지 않았는지 확인하세요.
필수 제품 필드 수정 필요
- 107: 설명이 누락되었습니다. 실제 제품 설명을 입력하세요.
- 111: 누락됨
이미지 링크접근 가능한 제품 이미지 URL을 제공하세요. - 112: 재고 상태 누락. '재고 있음', '재고 없음', '예약 주문'과 같은 지원되는 값을 사용하세요.
- 113: 잘못된 가격 형식. 올바른 ISO-4217 통화 코드를 사용하여 숫자 형식의 가격을 제공하세요.
- 151: 필수 가격 누락. 제품의 실제 현재 가격을 추가하세요.
- 1001: 이미지를 찾을 수 없음. 상태, 리디렉션, 대소문자 경로, 공개 여부를 확인하세요.
- 1007: 잘못된 이미지 파일. 유효한 지원 이미지로 교체하고 URL을 업데이트하세요.
정확하게 내보낸 파일을 검증하세요. 단순히 커머스 CMS 안의 제품 값만이 아니라.
식별자, 도메인, 중복 항목을 수정하세요.
- 123: 중복된 항목 ID. 각 고유 항목/변형은 안정적인 고유 ID가 필요합니다.
- 139: 항목 링크가 검증된 도메인과 일치하지 않습니다. 대상 호스트를 수정하거나 올바른 웹사이트를 지정하세요.
- 179: GTIN은 잘못된 형식입니다. Pinterest 문서는 대시 없이 8, 12, 13 또는 14자리의 숫자가 유효하다고 명시하고 있습니다.
- 154: 제품 유형이 너무 많습니다. Pinterest는 목록에서 최대 다섯 개까지 지원합니다.
사용하십시오 웹사이트 클레임 가이드 모든 제품 링크를 코드 139를 우회하도록 변경하기 전에
가격, 통화, 배송 및 세일 필드를 수정하세요
- 125: 세일 가격이 정가/리스트 가격을 초과합니다. 원본 값과 유효 날짜를 수정하세요.
- 169: 판매 위치에서 통화가 비정상적으로 보입니다. 시장 및 피드 구성을 확인하십시오.
- 180: 가격 관련 필드에 일관되지 않은 통화가 포함되어 있습니다. 항목별로 하나의 올바른 통화를 사용하십시오.
- 182: 판매 가격이 정가보다 훨씬 낮습니다. 소수점 또는 통화 오류가 아닌 정당한 가격인지 확인하십시오.
- 131: 배송 형식이 잘못되었습니다. Pinterest는 문서화된 국가:지역:서비스:가격 구조와 필요한 콜론을 기대합니다.
분류 및 메타데이터 경고를 수정하십시오.
- 126: Google 제품 카테고리의 수준이 너무 적습니다; 가장 구체적으로 적용 가능한 분류 경로를 제공하십시오.
- 157: Google 제품 카테고리가 없습니다.
- 158: Google 제품 카테고리 형식이 잘못되었습니다.
- 116: 상품 상태가 없습니다; 새 상품, 중고, 리퍼브와 같은 지원되는 값을 사용하십시오.
- 155: 추가 이미지가 10개 이상입니다; 목록을 제한하십시오.
- 115: 설명은 10,000자를 초과하여 잘림.
경고는 업로드를 허용할 수 있지만 일치율이나 배포 품질을 낮출 수 있습니다. 먼저 오류를 수정한 후, 영향을 받는 행 수에 따라 경고를 수정하세요.
Shopify 및 정책별 코드를 수정하세요.
- 4057: Shopify 제품이 Pinterest 판매 채널에서 활성화/사용 가능하지 않습니다.
- 4058: 제품에 필요한 Shopify 호스팅 온라인 스토어 가용성이 없습니다.
- 4059: 제품이 데이터 소스의 기본 언어로 번역되지 않았습니다.
- 4042: 제품이 판매자 가이드라인을 준수하지 않습니다. 규정을 준수하지 않는 항목을 제거하거나 수정하세요; 메타데이터 형식만으로 정책 적격성을 해결할 수 없습니다.
항상 현재 문구를 확인하세요 Pinterest 공식 오류 코드 참조, 코드가 추가되거나 수정될 수 있습니다.
통제된 수정 주기를 사용하십시오.
- 실패한 피드와 내보낸 진단 자료를 보관하십시오.
- 영향을 받은 행을 오류 코드별로 그룹화하십시오.
- 행 수준 오류보다 파일 수준 실패를 먼저 수정하십시오.
- 일회성 CSV 복사뿐만 아니라 상류 상거래 데이터를 수정하십시오.
- 인코딩, 구분자, 필수 헤더 및 샘플 행을 로컬에서 검증하십시오.
- 새 소스를 게시하고 직접 다운로드를 확인하십시오.
- 다음 지원되는 수집을 기다리거나 트리거하십시오.
- 카운트를 비교하고 진단 자료를 다시 내보내십시오.
카탈로그를 리치 핀과 판매자 상태와 연결하십시오.
카탈로그는 페이지 수준의 리치 핀 마크업과 동일하지 않습니다. 제품 페이지는 여전히 정확하고 최신 데이터를 표시해야 합니다. 사용하세요 리치 핀 가이드 페이지 메타데이터와 카탈로그 성공이 자격 요건의 일부일 때 검증된 상점 감사 을 확인하세요.
카탈로그 규칙
실패한 입력을 유지하고, 코드 패밀리별로 상위 소스를 수정하며, 다음 수집을 정량적으로 검증하세요. 초록색 파일 업로드가 모든 제품이 배포 자격이 있음을 증명하지는 않습니다.
Pinterest 시스템 구축을 계속하세요
다음 단계에 맞는 가이드를 계속 진행하세요:
Notestopin Chrome 확장을 얻으십시오.
모든 Pin에 개인 노트를 추가하고, 그들을 표시하고, 나중에 저장소를 검색합니다.
Chrome에 추가하기
Pinterest 리치 핀이 작동하지 않거나 업데이트되지 않나요? 소스를 테스트하세요
