위치:
OpenAI에 대한 제품 피드 필드 참조
필수 필드, 선택적 필드 및 B2C Commerce 특성에 대한 기본 매핑을 포함하여 OpenAI와 함께 사용되는 제품 피드 필드에 대한 참조 정보입니다.
기본 매핑 작동 방식
OpenAI용 제품 피드는 데이터 기반 매핑 시스템을 사용하여 B2C Commerce 제품 데이터를 OpenAI에 필요한 형식으로 변환합니다. B2C Commerce가 표준 B2C Commerce 특성을 사용하여 값을 파생할 수 있는 경우 값이 파생되는 방법을 지정하는 기본 매핑을 생성합니다.
- 필드 매핑 : 이름 , 브랜드또는가격과 같은 단일 B2C Commerce 제품 특성에 직접 매핑합니다.
- 파생 매핑 : 여러 특성에서 값을 계산하거나 설명에서 HTML을 제거하거나 통화 코드로 가격 형식을 지정하는 등의 변환을 적용할 수 있습니다.
-
상수 매핑 : 모든 제품에 고정 값을 사용합니다. 예를 들어, is_eligible_checkout는 항상
false입니다. ChatGPT의 빠른 체크아웃은 지원되지 않습니다. - 대체 매핑 : 먼저 기본 특성에 매핑한 다음, 해당 제품의 기본 특성이 비어 있는 경우 대체 특성으로 대체합니다. 예를 들어title은name을 사용하며, name이 비어 있으면masterProductName으로 대체됩니다.
Overridable(재정의 가능)로 표시된 필드를 사용자 지정할 수 있습니다. 예, Business Manager에서 가능합니다. 재정의 가능으로 표시된 필드: 아니요는 시스템에서 관리되며 필드 매핑 테이블에 표시되지만 매핑을 변경할 수는 없습니다.
자동 필드 서식 지정
B2C Commerce는 필드 값이 피드에 기록되기 전에 해당 값에 자동 서식을 적용합니다. 이 형식 지정은 기본 매핑을 유지하는지 아니면 다른 특성으로 재정의하는지에 관계없이 발생합니다. 기본 매핑을 재정의할 때 B2C Commerce가 변환을 처리하므로 OpenAI의 형식과 일치하도록 카탈로그 데이터를 조정할 필요가 없습니다.
서식은 다음과 같이 적용됩니다.
-
날짜 : 날짜 및 날짜/시간 값은
yyyy-mm-dd(ISO 8601)로 형식이 지정됩니다. 잘못된 날짜는 피드에서 생략됩니다. -
부울 : 값은
true또는false로 변환됩니다. - 숫자 : 숫자 값은 필요한 전체 자릿수(예: 소수점이 없는 정수 또는 등급 및 가격의 소수점 두 자리)로 형식이 지정됩니다. 유효하지 않거나 null 값은 생략됩니다.
- 가격 : 양수 값은 소수점 이하 두 자리로 서식이 지정되고 통화 코드와 연결됩니다.
- 묘사 : HTML 태그는 텍스트에서 제거됩니다.
- 열거형 : 가용성및age_group과 같은 값은 미리 정의된 허용 값에 대해 검증됩니다.
변형에 대한 맞춤형 특성 상속
맞춤형 특성을 OpenAI 필드에 매핑하면 B2C Commerce에서 다음 상속 체인을 사용하여 변형 제품의 특성 값을 자동으로 확인합니다.
- 변형 제품 : B2C Commerce는 먼저 변형 제품에서 특성 값을 확인합니다.
- 변형 그룹 : 변형에 특성 값이 없으면 B2C Commerce에서 변형 그룹을 확인합니다(해당하는 경우).
- 마스터 제품 : 변형 그룹에 값이 없으면 B2C Commerce가 마스터 제품을 확인합니다.
이 상속 체인은 마스터 또는 변형 그룹 수준에서 정의된 맞춤형 특성이 중복 데이터를 입력할 필요 없이 변형에 의해 자동으로 상속되도록 합니다.
제품 적격성
두 개의 레이어가 피드에 표시되는 제품을 제어합니다.
- 제품 필터 규칙 : OpenAI로 전송되는 제품을 결정하는 구성 가능한 포함 및 제외 규칙입니다. 기본적으로 규칙은 온라인 상태이고 검색 가능한 제품과 일치하지만 사용자가 조정할 수 있습니다. 제품 피드에 대한 제품 필터 규칙을참조하십시오.
-
자동 제외 : 필터 규칙에 관계없이 B2C Commerce는 항상 피드에서 다음을 제외합니다.
- 마스터 제품(변형이 대신 내보내짐)
- 변형 그룹(변형이 대신 내보내짐)
- 제품 세트. ChatGPT는 제품 세트에 필요한 동적 구성 요소 선택을 처리할 수 없습니다. 고정 구성 요소가 있는 번들이 지원되며 독립 실행형 제품으로 OpenAI에 전송됩니다.
표시 가격 파생
가격필드는 제품의 정가(정가)에 매핑됩니다. B2C Commerce에는 "정가" 개념이 내장되어 있지 않습니다. 스토어프런트 팀은 다양한 Price Book 전략을 사용하여 정가를 구현합니다. 이러한 다양성을 수용하기 위해 B2C Commerce는 다음 두 단계로 피드의 정가를 도출합니다.
- 선택한 표시 Price Book . 일반 설정 탭의정가 정보에서 Price Book을 선택하면 B2C Commerce에서 해당 Price Book의 가격을 사용합니다. 드롭다운에는 활성 상태이며 피드 통화의 가격이 포함된 Price Book만 포함됩니다. 나중에 선택한 Price Book을 비활성화하는 경우표시 Price Book이 다른 Price Book을 가리키도록 다시 구성합니다.
-
판매 Price Book 경로 . 표시 Price Book을 선택하지 않으면 B2C Commerce는 B2C Commerce 가격 엔진이 제품에 대해 선택한 판매 Price Book에서 표시 가격을 가져옵니다. 가격 엔진은 활성 Price Book뿐만 아니라 제품에 적용 가능한 모든 Price Book을 평가하고 소스 Price Book과 함께 최적(최저) 가격을 반환합니다. 해당 판매 Price Book에서 B2C Commerce는 다음 두 가지 규칙 중 하나를 적용합니다.
- 판매 Price Book에 상위 Price Book이 있는 경우 B2C Commerce는 상위 체인을 루트로 이동하고 루트 Price Book에서 가격을 반환합니다. 이는 SFRA 및 SiteGenesis 스토어프런트의 기본 동작과 일치합니다.
- 판매 Price Book에 상위 Price Book이 없는 경우, B2C Commerce는 제품에 해당하는 모든 Price Book에서 최고 가격을 반환합니다. 이는 PWA Kit 스토어프런트의 기본 동작과 일치합니다.
일반 설정 탭에서표시 Price Book을 설정하는 것은 피드의 표시 가격이 구매자가 스토어프런트에서 보는 가격과 일치하도록 하는 가장 신뢰할 수 있는 방법입니다. 특히 맞춤형 가격 책정 로직, 영역 기반 가격 책정 또는 다중 통화 Price Book을 사용하는 스토어프런트의 경우 더욱 그렇습니다.
판매 가격 파생
sale_price필드는 B2C Commerce salePrice특성과 구성된통화에 매핑됩니다. salePrice값은 단일 Price Book에서 가져오지 않습니다. B2C Commerce 가격 엔진은 Price Book 계층 구조 또는 계층 구조 구성 여부에 관계없이제품에 적용 가능한 모든 Price Book 중에서 최적(최저) 가격을선택합니다.
동일한 엔진이 스토어프런트에 표시되는 가격을 채우기 때문에 OpenAI로 전송되는sale_price값은 구매자가 사이트에서 보는 것과 일치합니다.
해결된 판매 가격이 해결된 정가( 가격필드)와 같으면 B2C Commerce는 해당 제품의 피드 항목에서sale_price생략합니다. 이렇게 하면 실제로 판매되지 않는 제품에 대해 ChatGPT에 취소선 가격이 표시되지 않습니다. 표시 가격 파생을참조하십시오.
스토어프런트에서 영역 기반 또는 지역 기반 Price Book 선택과 같은 맞춤형 가격 책정 로직을 사용하는 경우 기본 판매 가격 계산이 구매자에게 표시되는 것과 일치하지 않을 수 있습니다. 이러한 경우 일반 설정 탭에서표시 Price Book을 설정하는 것이 피드를 스토어프런트에 맞추는 가장 신뢰할 수 있는 방법입니다.
필수 입력 사항
다음 필드는 올바른 제품 피드 항목에 필요합니다. 필수 필드가 누락된 제품은 여전히 피드에 포함되지만 OpenAI는 해당 개별 행을 거부할 수 있습니다. 제품 피드 미리보기를 사용하여 필수 필드가 누락된 제품을 식별하고 일일 피드 동기화를 켜기 전에 수정하십시오. 제품 피드 미리보기를참조하십시오.
- General Settings(일반 설정 ) 탭의Business Details(비즈니스 세부 정보 ) 섹션에서 다음을 구성하십시오.
- seller_name : ChatGPT에서 구매자에게 표시되는 스토어 또는 브랜드 이름입니다.
- Catalog(카탈로그 ) 탭의Field Mapping(필드 매핑 ) 섹션에서Override with constant value or pattern(상수 값 또는 패턴으로 재정의)을사용하여 구성합니다.
- seller_url : 스토어프런트 홈페이지의 URL입니다.
- return_policy : 반품 정책 페이지를 가리키는 URL입니다.
| OpenAI 필드 | 유형 | 기본 SFCC 매핑 | 설명 | 재정의 가능 |
|---|---|---|---|---|
| item_id | string | id (제품 ID) | 제품 고유 식별자(SKU)입니다. 피드 업데이트 전반에 걸쳐 안정적으로 유지하세요. | 예 |
| group_id | string | masterProductId (변형), id (비변형) | 변형 그룹 ID입니다. 변형 제품의 경우masterProductId를 사용합니다. 변형이 아닌 제품의 경우 제품 ID를 사용합니다. | 예 |
| 제목 | string | name , 비어 있는 경우masterProductName으로 대체합니다. | 대화형 인터페이스에 적합한 제품명입니다. 홍보 문구를 사용하지 마세요. | 예 |
| description | string | longDescription , 비어 있는 경우shortDescription (HTML 제거)으로 대체합니다. | OpenAI 모델이 제품을 이해하는 데 사용하는 전체 제품 설명입니다. HTML 태그는 자동으로 제거됩니다. | 예 |
| 브랜드 | string | 브랜드 (비어 있는 경우 상속 계층 구조를 통해 대체: variant, variant group, master) | 브랜드 이름입니다. | 예 |
| url | string | productUrl (생성됨) | 제품 세부 정보 페이지 URL입니다. Einstein 구성의 호스트 이름과 함께 Product-Show 파이프라인 작업을 사용하여 생성됩니다. PWA Kit 및 헤드리스 스토어프런트의 경우 URL 패턴을 별도로 구성합니다. | 예 |
| image_url | string | 선택한 이미지 보기 유형 또는 기본 보기 유형 조회 | 기본 제품 이미지 URL입니다. 일반 설정 탭의이미지 보기 유형에서 보기 유형을 선택하면 B2C Commerce에서 해당 보기 유형을 사용합니다. 그렇지 않으면 B2C Commerce가 "대형" 보기 유형을 시도하고 사용 가능한 첫 번째 보기 유형으로 대체합니다. 대체 시 적합하지 않은 보기 유형(예: 견본 보기)이 선택될 수 있으므로 Salesforce에서는 특정 보기 유형을 선택하는 것이 좋습니다. 사용 가능한 이미지가 없으면 피드에서 필드가 생략됩니다. 번들 제품의 경우 기본 이미지에는 번들의 모든 제품이 표시됩니다. 홍보용 오버레이 없이 고해상도 이미지를 사용합니다. | 예 |
| price | number | 선택한 정가 또는 판매 가격-북 경로 | 통화 코드가 있는 일반(목록) 제품 가격(예: "79.99 USD")입니다. 일반 설정 탭의정가에서 Price Book을 선택하면 B2C Commerce에서 해당 Price Book을 사용합니다. 그렇지 않으면 B2C Commerce는 B2C Commerce 가격 엔진에서 선택한 판매 Price Book에서 표시 가격을 파생합니다. 표시 가격 파생을참조하십시오. 양수 값만 포함됩니다. | 아니요 |
| 가용성 | string | 가용성 (파생됨) | 재고 상태. B2C Commerce 재고 수준을 미리 정의된 5가지 값( in_stock , out_of_stock , pre_order , 이월 주문 , 알 수 없음 ) 중 하나에 매핑하여 파생된 값입니다. |
아니요 |
| product_category | string | categoryPath | 검색 및 추천을 위한 시맨틱 제품 카테고리(예: "Apparel & Accessories > Clothing Shirts > "). | 예 |
| seller_name | string | (구성 필요) | 구매자에게 표시되는 스토어 또는 브랜드 이름입니다. 일반 설정 탭의 비즈니스 세부 정보 섹션에서 이 값을 구성합니다. | 예 |
| seller_url | string | (구성 필요) | 스토어프런트 홈페이지의 URL입니다. 카탈로그 탭의 필드 매핑 섹션에서 Override with constant value or pattern을 사용하여 이 값을 구성합니다. | 예 |
| return_policy | string | (구성 필요) | 스토어의 반품 정책 페이지에 대한 URL입니다. 카탈로그 탭의 필드 매핑 섹션에서 Override with constant value or pattern을 사용하여 이 값을 구성합니다. | 예 |
| is_eligible_search | 부울 |
true (상수) |
제품이 ChatGPT 검색 결과에 표시될 수 있는지 여부를 제어합니다. 기본적으로 피드의 모든 제품은 검색에서 검색 가능합니다( true ). 제품별 검색 검색 가능성을 제어하려면 이 필드를 사용자 지정 부울 특성(예: c_chatGPT_eligible )으로 재정의하십시오. 값이 false인 제품은 여전히 피드에 표시되지만 ChatGPT 검색에서는 검색할 수 없습니다. |
예 |
| is_eligible_checkout | 부울 |
false (상수) |
ChatGPT 내에서 직접 구매가 허용되는지 여부를 제어합니다. 항상false로 설정합니다. 구매자는 사이트로 리디렉션됩니다. |
아니요 |
| target_countries | string |
미국 (상수) |
상품의 타겟 국가입니다. 2자리 ISO 3166 국가 코드를 사용합니다. | 아니요 |
| store_country | string |
미국 (상수) |
매장 국가. 2자리 ISO 3166 국가 코드를 사용합니다. | 아니요 |
| listing_has_variations | string | masterProductId에서 파생됨 | 목록 항목에 변형이 있는지 여부를 나타냅니다. 제품에 마스터 제품 ID가 있는 경우 자동으로true로 설정됩니다. |
아니요 |
선택적 필드
다음 필드는 선택 사항이며 ChatGPT에서 제품 목록을 향상시킬 수 있습니다. 선택적 필드는 매핑된 특성 또는 상수 값이 비어 있는 경우 피드에서 생략됩니다.
| OpenAI 필드 | 유형 | 기본 SFCC 매핑 | 설명 | 재정의 가능 |
|---|---|---|---|---|
| gtin (영문) | string | EAN , 비어 있는 경우UPC로 폴백 | 국제 거래 품목 번호(UPC/EAN)입니다. 둘 다 비어 있는 경우 피드에서 생략됩니다. 제품 일치를 개선합니다. | 예 |
| 엠피엔(MPN) | string | 엠피엔(MPN) | 제조업체 부품 번호입니다. | 예 |
| marketplace_seller | string | (없음) | 판매자가 제3자 법인인 경우 판매자 또는 체크아웃 지점에seller_name선택적 필드입니다. | 예 |
| additional_image_urls | string | 추가이미지링크 | 풍부한 프레젠테이션을 위한 추가 이미지 URL. 쉼표로 구분된 목록입니다. | 예 |
| video_url | string | (없음) | 제품 동영상 URL입니다. | 예 |
| model_3d_url | string | (없음) | 제품 시각화를 위한 3D 모델 URL입니다. | 예 |
| sale_price | number | salePrice + 통화 | 통화 코드가 있는 할인된 가격(예: "59.99 USD"). B2C Commerce 가격 엔진은 적용 가능한 모든 Price Book에서salePrice를 최상의 가격으로 파생합니다. B2C Commerce는 해결된 판매 가격이 해결된가격과 같을 때 이 필드를 생략합니다. 판매 가격 파생을참조하십시오. | 예 |
| sale_price_start_date | date | 'salePriceStart' | ISO 8601 형식의 판매 가격 시작 날짜(예: "2025-07-01")입니다. 비어 있거나 유효하지 않은 경우 생략됩니다. | 예 |
| sale_price_end_date | date | 'salePriceEnd' | ISO 8601 형식의 판매 가격 종료 날짜(예: "2025-07-15")입니다. 비어 있거나 유효하지 않은 경우 생략됩니다. | 예 |
| shipping_price | string | (없음) | 배송 방법/비용/지역( country:region:service_class:price ) 형식입니다. |
아니요 |
| variant_dict | string | variationAttributes (JSON으로) | JSON 형식의 변형 특성(예: {"color": "blue", "size"): "M"}입니다. |
아니요 |
| review_count | number | (없음) | 제품 리뷰 수입니다. | 예 |
| star_rating | number | (없음) | 5점 만점의 평균 리뷰 평점(예: "4.50") | 예 |
| store_review_count | number | (없음) | 브랜드/매장 리뷰 수입니다. | 예 |
| store_star_rating | number | (없음) | 평균 매장 평점 5점 만점. | 예 |
| 높이 , 너비 , 길이 | number | (없음) | 제품 치수. 제공된 경우dimensions_unit가 필요합니다. | 예 |
| dimensions_unit | string | (없음) | 치수 단위 약어(예: "in" 또는 "cm")입니다. 차원 값을 제공하는 경우 필수입니다. | 예 |
| 무게 | number | (없음) | 제품 무게. 제공된 경우item_weight_unit가 필요합니다. | 예 |
| item_weight_unit | string | (없음) | "lb" 또는 "kg"과 같은 중량 단위 약어입니다. 가중치가 제공되는 경우 필수입니다. | 예 |
| condition(조건) | string | (없음) | 상품 상태(예: "새 상품", "중고" 또는 "리퍼브 상품") | 예 |
| 성별 | string | (없음) | 의도된 성별 잠재고객(예: '남성', '여성', '남녀 공용') | 예 |
| size | string | (없음) | 단어, 약어 또는 숫자로 표현된 제품 크기(예: "Small", "XL" 또는 "12")입니다. | 예 |
| color | string | (없음) | 제품 색상. | 예 |
| 재료 | string | (없음) | "면" 또는 "가죽"과 같은 주요 제품 재료. | 예 |
| age_group | string | (없음) | 대상 연령대. 값 : 신생아 , 유아 , 유아 , 어린이 , 성인 . |
예 |
| accepts_returns | 부울 | (없음) | 제품이 반품을 허용하는지 여부( true또는false ). |
예 |
| return_deadline_in_days | number | (없음) | 반납 마감 날 수, 예를 들어 "14"또는 "30". | 예 |
| accepts_exchanges | 부울 | (없음) | 제품이 교환을 받는지 (true또는 false) 확인하기. |
예 |
| is_digital | 부울 | (없음) | 제품이 디지털( true또는false )인지 여부를 나타냅니다. |
예 |
