위치:
Google의 제품 피드 필드 참조
필수 필드, 선택 필드 및 B2C Commerce 특성에 대한 기본 매핑을 포함하여 Google에서 사용되는 제품 피드 필드에 대한 참조 정보입니다.
기본 매핑 작동 방식
Google의 제품 피드는 데이터 기반 매핑 시스템을 사용하여 B2C Commerce 제품 데이터를 Google에 필요한 형식으로 변환합니다. B2C Commerce가 표준 B2C Commerce 특성을 사용하여 값을 파생할 수 있는 경우 값이 파생되는 방법을 지정하는 기본 매핑을 생성합니다.
- 필드 매핑 : 이름 , 브랜드또는가격과 같은 단일 B2C Commerce 제품 특성에 직접 매핑합니다.
- 파생 매핑 : 여러 특성에서 값을 계산하거나 설명에서 HTML을 제거하거나 통화 코드로 가격 형식을 지정하는 등의 변환을 적용할 수 있습니다.
- 상수 매핑 : 모든 제품에 고정 값을 사용합니다.
- 대체 매핑 : 먼저 기본 특성에 매핑한 다음, 해당 제품의 기본 특성이 비어 있는 경우 대체 특성으로 대체합니다. 예를 들어title은name을 사용하며, name이 비어 있으면masterProductName으로 대체됩니다.
Overridable(재정의 가능)로 표시된 필드를 사용자 지정할 수 있습니다. 예, Business Manager에서 가능합니다. 재정의 가능으로 표시된 필드: 아니요는 시스템에서 관리되며 필드 매핑 테이블에 표시되지만 매핑을 변경할 수는 없습니다.
자동 필드 서식 지정
B2C Commerce는 필드 값이 피드에 기록되기 전에 해당 값에 자동 서식을 적용합니다. 이 형식 지정은 기본 매핑을 유지하는지 아니면 다른 특성으로 재정의하는지에 관계없이 발생합니다. 기본 매핑을 재정의할 때 B2C Commerce에서 변환을 처리하므로 Google 형식에 맞게 카탈로그 데이터를 조정할 필요가 없습니다.
서식은 다음과 같이 적용됩니다.
- 날짜 : 날짜 및 날짜/시간 값은 ISO 8601로 형식이 지정됩니다. 잘못된 날짜는 피드에서 생략됩니다.
-
부울 : 값은
true또는false로 변환됩니다. - 숫자 : 숫자 값은 필요한 정밀도(예: 소수점이 없는 정수 또는 가격의 소수점 두 자리)로 형식이 지정됩니다. 유효하지 않거나 null 값은 생략됩니다.
- 가격 : 양수 값은 소수점 이하 두 자리로 서식이 지정되고 통화 코드와 연결됩니다.
- 묘사 : HTML 태그는 텍스트에서 제거됩니다.
- 열거형 : 가용성및age_group과 같은 값은 미리 정의된 허용 값에 대해 검증됩니다.
변형에 대한 맞춤형 특성 상속
맞춤형 특성을 Google 필드에 매핑하면 B2C Commerce에서 다음 상속 체인을 사용하여 변형 제품의 특성 값을 자동으로 확인합니다.
- 변형 제품 : B2C Commerce는 먼저 변형 제품에서 특성 값을 확인합니다.
- 변형 그룹 : 변형에 특성 값이 없으면 B2C Commerce에서 변형 그룹을 확인합니다(해당하는 경우).
- 마스터 제품 : 변형 그룹에 값이 없으면 B2C Commerce가 마스터 제품을 확인합니다.
이 상속 체인은 마스터 또는 변형 그룹 수준에서 정의된 맞춤형 특성이 중복 데이터를 입력할 필요 없이 변형에 의해 자동으로 상속되도록 합니다.
제품 적격성
두 개의 레이어가 피드에 표시되는 제품을 제어합니다.
- 제품 필터 규칙 : Google로 전송할 제품을 결정하는 구성 가능한 포함 및 제외 규칙입니다. 기본적으로 규칙은 온라인 상태이고 검색 가능한 제품과 일치하지만 사용자가 조정할 수 있습니다. 제품 피드에 대한 제품 필터 규칙을참조하십시오.
-
자동 제외 : 필터 규칙에 관계없이 B2C Commerce는 항상 피드에서 다음을 제외합니다.
- 마스터 제품(변형이 대신 내보내짐)
- 변형 그룹(변형이 대신 내보내짐)
- 제품 세트. 구성요소가 고정된 번들은 지원되며 독립형 제품으로 Google에 전송됩니다.
제품이 피드에 포함된 후included_destination , excluded_destination , 일시중지필드를 매핑하여 Google에서 제품이 표시되는 위치를 추가로 제어할 수 있습니다. 예를 들어excluded_destination사용하면 제품을 쇼핑 광고에 표시하지 않고 무료 등록정보에는 제출할 수 있습니다. 선택적 필드 테이블을 참조하십시오.
표시 가격 파생
가격필드는 제품의 정가(정가)에 매핑됩니다. 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 중에서 최적(최저) 가격을 선택합니다.
스토어프런트에 표시되는 가격은 동일한 엔진으로 채워지므로 Google로 전송되는sale_price값은 구매자가 사이트에서 보는 값과 일치합니다.
해결된 판매 가격이 해결된 정가( 가격필드)와 같으면 B2C Commerce는 해당 제품의 피드 항목에서sale_price생략합니다. 이렇게 하면 Google에서 판매 중이 아닌 제품에 취소선 가격이 표시되는 것을 방지할 수 있습니다. 표시 가격 파생을참조하십시오.
스토어프런트에서 영역 기반 또는 지역 기반 Price Book 선택과 같은 맞춤형 가격 책정 로직을 사용하는 경우 기본 판매 가격 계산이 구매자에게 표시되는 것과 일치하지 않을 수 있습니다. 이러한 경우 일반 설정 탭에서표시 Price Book을 설정하는 것이 피드를 스토어프런트에 맞추는 가장 신뢰할 수 있는 방법입니다.
필수 입력 사항
다음 필드는 올바른 제품 피드 항목에 필요합니다. 필수 입력란이 누락된 제품은 피드에 계속 포함되지만 Google에서는 이러한 개별 행을 거부할 수 있습니다. 제품 피드 미리보기를 사용하여 필수 필드가 누락된 제품을 식별하고 일일 피드 동기화를 켜기 전에 수정하십시오. 제품 피드 미리보기를참조하십시오.
| Google 필드 | 유형 | 기본 SFCC 매핑 | 설명 | 재정의 가능 |
|---|---|---|---|---|
| id | string | id (제품 ID) | 제품 고유 식별자(SKU)입니다. B2C Commerce에서 관리합니다. 피드 업데이트 전반에 걸쳐 안정적으로 유지하세요. | 아니요 |
| 제목 | string | name , 비어 있는 경우masterProductName으로 대체합니다. | 제품 제목입니다. 홍보 문구를 사용하지 마세요. | 예 |
| description | string | longDescription , 비어 있는 경우shortDescription (HTML 제거)으로 대체합니다. | 전체 제품 설명입니다. HTML 태그는 자동으로 제거됩니다. | 예 |
| 린하르트 | string | productUrl (생성됨) | 제품 세부 정보 페이지 URL입니다. Einstein 구성의 호스트 이름을 사용하여 생성됩니다. PWA Kit 및 헤드리스 스토어프런트의 경우 URL 패턴을 별도로 구성합니다. 제품 피드의 URL 패턴 구성을참조하십시오. | 예 |
| image_link | string | 선택한 이미지 보기 유형 또는 기본 보기 유형 조회 | 기본 제품 이미지 URL입니다. 일반 설정 탭의이미지 보기 유형에서 보기 유형을 선택하면 B2C Commerce에서 해당 보기 유형을 사용합니다. 그렇지 않으면 B2C Commerce가 "대형" 보기 유형을 시도하고 사용 가능한 첫 번째 보기 유형으로 대체합니다. 대체 시 적합하지 않은 보기 유형(예: 견본 보기)이 선택될 수 있으므로 Salesforce에서는 특정 보기 유형을 선택하는 것이 좋습니다. 홍보용 오버레이 없이 고해상도 이미지를 사용합니다. | 예 |
| 가용성 | string | 가용성 (파생됨) | 재고 상태. B2C Commerce 재고 수준을 Google 가용성 값에 매핑하여 파생된 값( in_stock , out_of_stock , 사전 주문 , 이월 주문 ). 시스템에 의해 관리됩니다. |
아니요 |
| price | number | 가격과통화결합(선택한 정가 또는 판매 가격-북 경로) | 통화 코드가 있는 일반(목록) 제품 가격(예: "15.00 USD") 일반 설정 탭의정가에서 Price Book을 선택하면 B2C Commerce에서 해당 Price Book을 사용합니다. 그렇지 않으면 B2C Commerce는 B2C Commerce 가격 엔진에서 선택한 판매 Price Book에서 표시 가격을 파생합니다. 표시 가격 파생을참조하십시오. 양수 값만 포함됩니다. | 예 |
선택적 필드
다음 입력란은 선택사항이며 Google의 제품 목록을 개선하는 데 사용할 수 있습니다. 선택적 필드는 매핑된 특성 또는 상수 값이 비어 있는 경우 피드에서 생략됩니다. 기본 매핑이 있는 필드는 해당 값을 자동으로 파생합니다. 기본 매핑이 없는 필드("(없음)"으로 표시됨)는 특성을 매핑하거나 상수 값 또는 패턴을 설정할 때만 채워집니다.
| Google 필드 | 유형 | 기본 SFCC 매핑 | 설명 | 재정의 가능 |
|---|---|---|---|---|
| sale_price | number | 판매 가격이 활성 상태인 경우salePrice와통화를결합합니다 | 통화 코드가 있는 할인된 가격(예: "10.00 USD")입니다. B2C Commerce는 해결된 판매 가격이 해결된가격과 같을 때 이 필드를 생략합니다. 판매 가격 파생을참조하십시오. | 예 |
| sale_price_effective_date | date | salePriceStart및salePriceEnd를 결합합니다. | ISO 8601 형식의 판매 가격 날짜 범위(예: "2016-02-24T11:07+0100/2016-02-29T23:07+0100"). | 예 |
| availability_date | date | inStockDate (영문) | 사전 주문 제품을 사용할 수 있게 되는 날짜(예: "2016-02-24T11:07+0100"). | 예 |
| expiration_date | date | onlineTo | 제품이 피드에 더 이상 표시되지 않아야 하는 날짜(예: "2016-07-11T11:07+0100"). | 예 |
| 브랜드 | string | 브랜드 | 브랜드 이름입니다. | 예 |
| gtin (영문) | string | EAN을 사용할 수 없는 경우upc로 대체합니다. | 국제 거래 품목 번호(UPC/EAN)입니다. 제품 일치를 개선합니다. | 예 |
| 엠피엔(MPN) | string | 엠피엔(MPN) | 제조업체 부품 번호입니다. | 예 |
| identifier_exists | 부울 | 제품에 표준 식별자(EAN, UPC, MPN 또는 브랜드)가 있는지 여부에서 계산 | 제품에 표준 식별자가 있는지 여부를 나타냅니다. | 예 |
| is_bundle | 부울 | bundleProductIds가채워지면true로 평가됩니다. |
제품이 번들인지 여부를 나타냅니다. B2C Commerce에서 관리합니다. | 아니요 |
| item_group_id | string | masterProductId (영문) | "AB12345"와 같이 동일한 마스터 제품을 공유하는 제품 변형을 그룹화합니다. | 예 |
| product_type | string | categoryPath (전체 경로) | 판매자 정의 제품 카테고리(예: "Home > Women > Dresses > Maxi Dresses") | 예 |
| google_product_category | string | (없음) | Google에서 정의한 제품 카테고리(예: '의류&, 액세서리, 의류, > 겉옷>, > 코트, & 재킷') | 예 |
| additional_image_link | string | 추가이미지링크 | 풍부한 프레젠테이션을 위한 추가 이미지 URL. | 예 |
| lifestyle_image_link | string | (없음) | 라이프스타일 이미지 URL. | 예 |
| mobile_link | string | (없음) | 모바일에 최적화된 방문 페이지 URL. | 예 |
| virtual_model_link | string | (없음) | 가상 모델(3D) 자산 URL입니다. | 예 |
| ads_redirect | string | (없음) | 광고 트래픽을 리디렉션하는 데 사용되는 URL(예: 추적 매개변수가 포함된 트래픽)입니다. | 예 |
| color | string | (없음) | 제품 색상. | 예 |
| 재료 | string | (없음) | "가죽"과 같은 주요 제품 재료. | 예 |
| pattern | string | (없음) | "물방울 무늬"와 같은 제품 패턴입니다. | 예 |
| size | string | (없음) | 제품 크기(예: "XL") | 예 |
| size_system | string | (없음) | 크기 체계(예: "US") | 예 |
| size_type | string | (없음) | 크기 유형(예: "레귤러") | 예 |
| 성별 | string | (없음) | 의도된 성별 잠재고객(예: '남성', '여성', '남녀 공용') | 예 |
| age_group | string | (없음) | 대상 연령대. 값 : 신생아 , 유아 , 유아 , 어린이 , 성인 . |
예 |
| 성인 | 부울 | (없음) | 제품이 성인용인지 여부를 나타냅니다. | 예 |
| condition(조건) | string | (없음) | 상품 상태(예: "새 상품", "중고" 또는 "리퍼브 상품") | 예 |
| 멀티팩 | number | (없음) | 판매자 정의 패키지 상품에 포함된 동일 제품 수입니다. | 예 |
| product_highlight | string | (없음) | 주요 제품 하이라이트(예: "수천 개의 앱 지원") | 예 |
| short_title | string | (없음) | 제한된 게재위치에 사용되는 짧은 제목(예: '폴로 셔츠')입니다. | 예 |
| structured_title | string | (없음) | AI 생성 콘텐츠에 대한 제목의 출처를 포함한 구조화된 제목입니다. | 예 |
| structured_description | string | (없음) | AI 생성 콘텐츠에 대한 설명의 출처를 포함한 구조화된 설명입니다. | 예 |
| custom_label_0–custom_label_4 | string | (없음) | 보고 및 입찰을 위해 제품을 분류하는 데 사용되는 맞춤 라벨(예: "계절별", "재고 정리" 또는 "베스트셀러"). | 예 |
| product_length , product_width , product_height | number | (없음) | 단위가 있는 제품 치수(예: "20인치"). | 예 |
| product_weight | number | (없음) | 단위가 있는 제품 중량(예: "3.5lb"). | 예 |
| unit_pricing_measure | string | unitQuantity와unitMeasure를 결합합니다. | 판매된 제품의 치수 및 치수(예: "1.5kg"). | 예 |
| unit_pricing_base_measure | string | (없음) | 가격을 위한 제품의 기본 측정값(예: "100g")입니다. | 예 |
| energy_efficiency_class | string | (없음) | 에너지 효율 등급(예: "A+"). | 예 |
| min_energy_efficiency_class | string | (없음) | 제품 라벨의 가장 낮은 에너지 효율 등급(예: "A+++"). | 예 |
| max_energy_efficiency_class | string | (없음) | 제품 라벨의 최고 에너지 효율 등급(예: "D"). | 예 |
| 인증 | string | (없음) | "EC:EPREL:123456"과 같은 제품 인증. | 예 |
| consumer_notice | string | (없음) | 법령 65 경고와 같은 소비자 고지 사항. | 예 |
| cost_of_goods_sold | number | (없음) | 통화 코드와 함께 판매된 상품 원가(예: "8.00 USD")입니다. | 예 |
| auto_pricing_min_price | number | (없음) | 자동 할인의 최소 가격(예: "15.00 USD") | 예 |
| maximum_retail_price | number | (없음) | 최대 소매 가격(인도와 같은 일부 지역에서 사용됨)(예: "15.00 INR"). | 예 |
| 할부 | string | (없음) | 할부 결제 세부 정보(예: "6:30 EUR:199 EUR") | 예 |
| subscription_cost | string | (없음) | 구독 비용 세부 정보(예: "월:12:35.00USD") | 예 |
| loyalty_program | string | (없음) | 로열티 프로그램 혜택(예: "my_loyalty_program:silver:10 USD::10::free_member_shipping"). | 예 |
| promotion_id | string | (없음) | 프로모션 식별자(예: "ABC123") | 예 |
| 배송 | string | (없음) | 배송비 세부 정보(예: "US:CA:Overnight:16.00 USD") | 예 |
| free_shipping_threshold | string | (없음) | 무료 배송을 위한 최소 주문 가격(예: "US:16.00 USD"). | 예 |
| carrier_shipping | string | (없음) | 배송업체에서 계산한 배송(예: "US:80302:USPS_MEDIA_MAIL:1:3:2:5") | 예 |
| shipping_label | string | (없음) | 배송 규칙을 할당하는 데 사용되는 레이블(예: "부패하기 쉬운")입니다. | 예 |
| shipping_length , shipping_width , shipping_height | number | (없음) | 배송을 계산하는 데 사용되는 패키지 규격(예: "22인치"). | 예 |
| shipping_weight | number | (없음) | 배송을 계산하는 데 사용되는 패키지 중량(예: "3kg"). | 예 |
| min_handling_time | number | (없음) | 최소 상품 배송 준비 시간(예: "1") | 예 |
| max_handling_time | number | (없음) | 최대 상품 취급 시간(예: "3") | 예 |
| shipping_handling_business_days | string | (없음) | 주문이 처리되는 영업일(예: "US:Mon-Sat") | 예 |
| shipping_transit_business_days | string | (없음) | 주문이 운송 중인 영업일(예: "US:Mon-Sat") | 예 |
| ships_from_country | string | (없음) | 제품이 배송되는 국가입니다. 2자리 ISO 3166 국가 코드(예: "US")를 사용합니다. | 예 |
| return_policy_label | string | (없음) | 반품 정책을 할당하는 데 사용되는 레이블(예: "90일")입니다. | 예 |
| included_destination | string | (없음) | 제품이 포함되어야 하는 대상(예: "Shopping_ads") | 예 |
| excluded_destination | string | (없음) | 제품을 제외해야 하는 대상(예: "Shopping_ads") | 예 |
| shopping_ads_excluded_country | string | (없음) | 쇼핑 광고에서 제외된 국가(예: 'DE') | 예 |
| 일시정지 | string | (없음) | 대상에서 항목(예: "ads")을 일시 중지합니다. | 예 |
| native_commerce | 부울 | (없음) | 제품이 네이티브 상거래(스토어프런트가 아닌 Google 노출 영역 내에서 직접 발생하는 구매 경험)에 적합한지 여부를 나타냅니다. 제품별로 이 부울을 설정하여 자격을 제어합니다. 이 필드에는 기본 매핑이 없으므로 매핑하지 않는 한 제품이 적격으로 플래그가 지정되지 않습니다. | 예 |
| external_seller_id | string | (없음) | 복수 판매자 계정의 판매자 식별자(예: "SellerPublicName1991"). | 예 |
| merchant_item_id | string | (없음) | 판매자가 제공한 체크아웃 항목 식별자(예: "some_checkout_item_id_1") | 예 |
추가 옵션 필드(제품 세부 정보)
필드 매핑 표의추가 선택적 필드섹션을 사용하여 기술 사양 또는 기타 특성을 Google의product_detail필드로 보낼 수 있습니다. 각 항목에 대해 B2C Commerce 특성을 매핑하고, 선택적으로 관련 세부 정보를 그룹화할 섹션 이름을 제공합니다. 특성 추가를 클릭하여 다른 제품 세부 정보를 추가합니다.
product_detail필드는 다른 필드에서 다루지 않는 제품의 측면에 대한 읽기 쉽고 구조화된 정보를 구매자에게 제공하며, Google이 검색 및 AI 기반 환경에서 제품을 노출하는 데 도움이 됩니다. 허용되는 특성 및 형식 요구사항의 전체 목록은 Google Merchant Center 도움말에서제품 세부정보[product_detail]를 참조하십시오.
