1 - 개요
feed는 사이트에서 판매하는 전체 상품들에 대한 상품 정보를 가진 파일입니다. 다이나믹 배너에 노출시킬 상품 정보를 feed에서 가져오는 정보를 사용합니다.
이 페이지에서 feed에 포함할 수 있는 것과 각 필드를 포맷하는 방법에 대한 자세한 내용을 확인할 수 있습니다.
2 - Criteo가 지원하는 Feed 포맷
Criteo가 귀하 상품 feed를 가져올 수 있도록 이 포맷들 중 하나를 이용하십시오.
|
Feed 포맷 |
세부 내용 |
다운로드 |
|
TSV |
이 포맷은 탭 분리 값을 기반으로 합니다. 헤더는 파일의 첫 번째 행에 놓여야 합니다. 필드 명은 공백이나 밑줄을 포함할 수 있습니다 (예 : image_link 또는 image link) |
|
|
CSV |
이 포맷은 콤마 분리 값을 기반으로 합니다. 헤더는 파일의 첫 번째 행에 놓여야 합니다. 필드 명은 공백이나 밑줄을 포함할 수 있습니다 (예: image_link 또는 image link) |
|
|
XML |
이 포맷은 XML 구조의 기본을 존중해야 합니다. 제품은 XML 노드 세트로 표현됩니다. 제품 목록은 <?xml 신고 태그로 시작해야 합니다. |
3 - 제공하는 제품 정보
모든 필드명은 영어로 해야 합니다. 상품 정보는 HTML 태그나 스타일 태그를 포함할 수 없습니다.
3.1 - 크리테오 광고를 진행하기 위한 필수 필드
3.1.1 id
|
이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다. ID는 하나의 제품에만 해당되는 고유한 제품 식별자입니다. ID를 제품에 할당하고 가져오면, 다른 제품에는 같은 ID를 사용할 수 없으며, 특정 제품을 변경하는 데도 사용할 수 없습니다. item_group_id가 채워진 경우, 자녀 ID / SKU로 ID를 채웁니다. |
문자 요구 사항: id는 ASCII 문자만 포함해야 하며 따옴표를 포함할 수 없습니다.
제한: 240
유형: String
예: abc123-검정색-7.5
3.1.2 title
|
이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다. 표제는 제품의 name이고, 보통 제품 상세 페이지에 나옵니다. 이것은 특정 제품의 배너에 주요 텍스트 설명자로 사용됩니다.
|
문자 요구사항: name은 문자나 숫자로 시작해야 합니다.
제한: 150
유형: String
예: 작업용 부츠 - 사이즈 7.5
3.1.3 description
|
Description은 제품명 외에 제품에 대한 자세한 정보를 제공하는 짧은 문장입니다. 배너 디자인 때문에, 짧은 설명 (50자 미만)이 Criteo 포맷과 레이아웃에 더 잘 맞을 수 있지만, 모든 포맷과 레이아웃에 Description이 있는 것은 아닙니다. |
문자 요구사항: Description은 문자나 숫자로 시작해야 합니다. style, embed, object, anchor 태그를 포함하여 이 필드의 모든 HTML은 제거되어야 합니다.
제한: 5000
유형: String
예: 일상적 사용에 우수함.
3.1.4 google_product_category
|
카테고리 레벨 속성은 전송되는 제품의 카테고리를 Google 제품 분류에 따라 나타냅니다. 상품이 여러 카테고리에 포함되어 있다면, 가장 관련성이있는 것만 전달되어야 합니다. |
문자 요구 사항: 저희는 ID들과 전체 카테고리 경로 둘 모두를 허용합니다.
유형: String
예: 여성용> 신발> 작업용 부츠 또는 2271
3.1.5 link
|
이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다. link는 제품의 전용 상세 페이지입니다. 일반적으로 제품마다 고유한 link를 가지지만 반드시 그럴 필요는 없습니다. 이 URL을 클릭하는 경우 제공되는 상품 정보는 피드에서 제공되는 정보와 일치해야 합니다. 모든 URL(http : // 또는 https : //)에 프로토콜을 지정하십시오. |
문자 요구 사항: link는 제품 상세 페이지의 전체 URL 앞에 프로토콜로 (http:// 또는 https://) 시작해야 합니다. 모든 기호는 인코딩해야 합니다. 예. $은 %24로 교체해야 합니다.
제한: 1024
유형: String
예: http://www.example.com/product/working-boots
3.1.6 image_link
|
이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다. image_link는 특정 제품의 이미지 파일의 경로를 지정하는 URL입니다. image_link는 배너에 제품 이미지를 표시하는 데 사용됩니다. 이미지는 최소 800x800 픽셀에 크기는 16MB 미만이 좋습니다.이미지에는 image/png, image/gif, image/jpeg 등의 Content-Type 헤더가 있어야 합니다. cURL을 통해 이미지에 대한 액세스를 제한하는 경우, Criteo 배너에 이미지가 노출될 수 있도록, Criteo의 user-agent를 허용 목록에 포함시켜야 합니다: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn. |
문자 요구 사항: image_link는 제품 이미지의 전체 URL 앞에 http://나 https://로 시작해야 합니다. 모든 기호는 인코딩해야 합니다. 예. $은 %24로 교체해야 합니다.
제한: 2000
유형: String
예: http://www.example.com/product/image/working-boots.png
3.1.7 additional_image_link
|
이는 제조사의 권장 판매 가격입니다. 특정 제품이 "할인 판매 중"인 경우, 가격 필드는 더 높은 가격으로 채워집니다. 가격에는 사이트에서 사용되는 통화와 같은 통화가 사용되어야 합니다. 가격은 마침표 (.)를 십진 구분 기호로 사용하는 숫자이어야 하며 천단위 구분 기호(,)를 사용하면 안됩니다. |
문자 요구 사항: 십진 구분자는 천 단위 구분자가 없는 마침표 (.)이어야 합니다.
제한: 14
유형: String
예: 1299.99
3.1.10 sale_price
|
sale_price는 제품을 사이트에서 구매할 수 있는 Price이고 임의의 제품이 할인 중인 경우, sale_price는 낮은 가격으로 채워집니다. sale_price는 사이트와 동일한 통화로 해야 합니다. sale_price는 천단위 구분자(,) 없이 숫자로만 전달되어야 합니다. |
문자 요구 사항: 십진 구분자는 천 단위 구분자가 없는 마침표 (.)이어야 합니다.
유형: String
제한: 50
예: 0001234560012
3.1.12 mpn
MPN은 제품의 제조업체를 식별하는 고유 번호입니다.
제한: 70
유형: String
예: 4060882
3.1.13 브랜드
|
이 필드는 Criteo 후원제품에 필요합니다 brand는 제품 브랜드명을 나타냅니다. 일부 제품은 특정 브랜드 정보가 없울 수 있습니다. 이 경우에 이 정보는 제공할 필요가 없습니다. |
주의할 점: 문자나 숫자 중 어느 하나로 시작해야 하며 ASCII 문자만 포함할 수 있습니다. 스타일 태그를 포함하여,이 필드에서 모든 HTML 태그를 제거합니다.
제한: 70
유형: String
예: Criteo
3.1.15 product_type
|
이 필드는 Criteo 후원제품에 필요합니다 product_type은 제품이 속한 카테고리(카테고리 목록)입니다. product_type 필드에는 머천다이징 카테고리 또는 이 제품의 머천다이징 카테고리 세트가 표시됩니다. 이는 웹 사이트 카테고리와 일치해야 합니다. 계층 구조의 각 레벨은 ">"로 구분되어야 합니다. 제품이 여러 카테고리로 제공되는 경우, 기본 카테고리를 시작으로 쉼표 (,)로 다른 카테고리들을 구분해 보내주십시오. product_type은 대소문자를 구분해야 합니다. 한 상품에는 woman용(소문자)을, 다른 상품에는 Women용(대문자)를 사용하면, Criteo는 이를 두 개의 서로 다른 카테고리로 간주합니다. |
문자 요구사항: product_type는 문자나 숫자 중 어느 하나로 시작해야 하며 ASCII 문자만 포함할 수 있습니다. 카테고리 사이의 구분자는 > (> for XML feeds)이어야 합니다. 저희는 전체 카테고리 경로만 지원합니다. 제품이 여러 카테고리로 제공되는 경우, 먼저 기본 카테고리로 쉼표 (,) 로 구분된 다른 카테고리들을 보내주십시오. 경로 카테고리 ID를 허용하지 않습니다. ID는 product_type_key 입력란에 입력해야 합니다.
제한: 500
유형: String
예:
- 단일: 컴퓨팅 > 키보드 및 마우스 > 마우스 > 무선 마우스
- 다중: 컴퓨팅 > 키보드 및 마우스 > 마우스 > 무선 마우스, 선물 > 포 대드 > 마우스
3.1.16 product_type_key
|
이 필드는 Criteo 후원제품에 필요합니다 이 필드는 product_type 또는 product_type 세트의 고유 ID 및 계층을 나열합니다. 계층 구조의 각 키는 ">"로 구분해야 합니다. 제품이 여러 카테고리로 제공되는 경우, 배열에서 먼저 기본 카테고리를 쉼표 (,) 로 구분하여 보주십시오. |
문자 요구 사항: product_type은 ASCII 문자만 포함할 수 있습니다. 카테고리 사이의 구분자는 > (>; XML feed의 경우)이어야 합니다. 제품이 여러 카테고리로 제공되는 경우, 먼저 기본 카테고리로 쉼표 (,) 로 구분된 다른 카테고리들을 보내주십시오.
제한: 500
유형: String
예:
- 단일: XY1 > YZ1 > Z1
- 다중: XY1 > YZ1 > Z1 , AB1 > BC2 > A
3.1.17 number_of_reviews
|
이 필드는 Criteo 후원제품을 위해 권합니다 이 필드에는 해당 제품에 대한 리뷰 수가 포함됩니다. 이 정보를 광고에 표시하려면 number_of_review가 필요합니다. |
제한: 8
유형: 정수
예: 2456
3.1.18 product_rating
|
이 필드는 Criteo 후원제품을 위해 권합니다 이 필드는 해당 제품의 평점을 나타냅니다. 이 정보를 광고에 표시하려면 product_rating이 필요합니다. |
문자 요구 사항: 십진 구분자는 천 단위 구분자가 없는 마침표 (.)이어야 합니다.
제한: 8
유형: String
예: 4.5
3.1.19 필터
|
이 필드는 Criteo 후원제품에 필요합니다 필터는 동일한 카테고리의 제품 간 차이를 지정하는 속성입니다. 필터는 속성 name 값 쌍의 쉼표 구분 목록으로 제공되어야 합니다. 이 필터들은 웹 사이트에서 사용할 수있고 이 제품과 일치하는 필터 목록과 일치해야 합니다. 이것은 Criteo 후원 제품에게 중요합니다. |
문자 요구 사항 : 키 = 값 쌍은 쉼표 (,)로 구분되어야 하며 다중 값은 파이프 (|)로 구분해야 합니다.
제한: 2000
유형: String
예: : 색상 = 적색|흑색, 사이즈 = XL, 화면 크기= 15 "
3.2 - 추가할 수 있는 필드
3.2.1 mobile_link
mobile_link는 제품 방문 페이지의 모바일 최적화 버전 link입니다. 이 URL은 'link' 필드에 제공하는 것과는 달라야 합니다. 모바일 link를 제공하면, 고객의 사용자 경험을 향상시키고 방문 페이지 로딩 시간을 줄일 수 있습니다.
문자 요구 사항: link는 제품 상세 페이지의 전체 URL 앞에 프로토콜로 (http:// 또는 https://) 시작해야 합니다. 모든 기호는 인코딩해야 합니다. 예. $은 %24로 교체해야 합니다.
제한: 2000
유형: String
예: http://m.example.com/product/working-boots
3.2.2 조건
조건은 세 가지 서로 다른 허용 값으로 제품을 한정하는 데 사용됩니다: 'new', 'refurbished' 및 'used'.
문자 요구 사항: 세 가지 값만 허용됩니다:
- 'new' [신제품]
- 'refurbished' [보수품]
- 'used' [중고품]
유형: String
예 신규
---
상품 옵션
3.2.3 item_group_id
item_group_id는 고유의 parent-level(최상위 레벨) 상품 ID입니다. 이것은 하위 상품들의 콜렉션으로 표현될 수 있는 하나의 상품을 나타내는 알파벳 문자들을 포함할 수 있습니다. item_group_id가 상품에 할당되고 가져오면, item_group_id는 다른 상품에 사용될 수 없거나 특정 상품 변경에 사용될 수 없습니다. item_group_id는 상품 컬렉션을 나타낼 수 있기 때문에, 여러 상품들이 item_group_id 대해 동일한 값을 가질 수 있습니다
문자 요구 사항: item_group_id는 ASCII 문자만 포함할 수 있으며 따옴표를 포함할 수 없습니다.
제한: 240
유형: String
예: abc123
3.2.4 색상
세부 사항: 이 속성은 제품의 주요 색상(들)을 나타냅니다.
제한: 100
유형: String
예: 검정색
3.2.5 성별
성별에 따라 다른 항목 그룹의 모든 제품에 필요합니다.
문자 요구 사항: 세 가지 값만 허용됩니다:
- 'male'[남성]
- 'female'[여성]
- 'unisex'[남녀 공용]
유형: String
예: 남성
3.2.6 age_group
이 속성은 제품 대상 연령 그룹을 표시하는 데 사용됩니다.
문자 요구 사항: 다섯 가지 값만 허용됩니다:
- 'newborn'[신생아]
- 'infant'[유아]
- 'toddler'[아기]
- 'kids'[아이들]
- 'adult'[성인]
유형: String
예: adult
3.2.7 재료
이 속성은 제품이 구성되는 재료 또는 직물을 나타냅니다. 재료에 따라 다른 항목 그룹의 모든 제품에 필요합니다.
제한: 200
유형: String
예: 가죽
3.2.8 패턴
이 속성은 해당 제품의 패턴이나 그래픽 프린트를 나타냅니다. 패턴에 따라 특정 항목 그룹에 속한 모든 제품에 필요합니다.
제한: 100
유형: String
예: 줄무늬
3.2.9 사이즈
이 속성은 제품 사이즈를 나타냅니다. 사이즈에 따라 다른 항목 그룹의 모든 제품에 필요합니다.
제한: 100
유형: String
예: L
3.2.10 size_type
귀하는 크기 유형을 추가하여 제품 사이즈를 조정할 수 있습니다.
문자 요구 사항: 다섯 가지 값만 허용됩니다:
- 'regular'[일반]
- 'petite'[작음]
- 'plus'[플러스]
- 'big and tall'[크고 키가 큼]
- 'maternity'[임산부용]
제한: 없음
유형: String
예: 보통
3.2.11 size_system
세부 사항: 귀하는 사이즈 시스템을 추가하여 제품의 국가 사이즈 시스템을 지정할 수 있습니다.
문자 요구 사항: 11가지 승인 값이 있습니다: US, UK, EU, DE, FR, JP, CN (중국), IT, BR, MEX, AU
제한: 없음
유형: String
예: US
---
시장 판매자용
3.2.12 cross_sellers_product_id
이 필드는 귀하가 시장이고 여러 판매자들을 위해 제품을 재판매하는 경우에만 필요합니다.
cross_sellers_product_id는 여러 판매자들이 판매한 동일한 제품을 나타내는 여러 ID를 그룹화 한 고유한 제품 식별자입니다. cross_sellers_product_id가 제품에 할당되고 가져오게 되면 cross_sellers_product_id는 다른 제품에 사용되지 않을 수도 있고 특정 제품의 cross_sellers_product_id가 변경될 수도 있습니다. cross_sellers_product_id는 제품 모음을 나타내므로 여러 제품의 cross_sellers_product_id 값이 같을 수 있습니다.
문자 요구 사항: cross_sellers_id는 문자 또는 숫자로 시작해야 하며 ASCII 문자만 포함할 수 있습니다.
제한: 250
유형: String
예: abc123
3.2.13 seller_name
이 필드는 귀하가 시장이고 여러 판매자들을 위해 제품을 재판매하는 경우에만 필요합니다.
seller_name은 판매자의 표시 name을 식별합니다. 이 name은 일반적으로 판매자의 페이지 또는 구매 상자의 특정 제품과 함께 표시되는 name입니다. seller_name과 seller_id 사이에 일대일 관계가 있어야합니다.
제한: 200
유형: String
예: 내 전자제품 가게
3.2.14 seller_id
이 필드는 귀하가 시장이고 여러 판매자들을 위해 제품을 재판매하는 경우에만 필요합니다.
seller_id는 소매 업체 사이트의 판매자를 나타내는 고유 식별자입니다. seller_id와 seller_name 사이에 일대일 관계가 있어야합니다.
제한: 200
유형: String
예: 3265fd
---
배송 정보
3.2.15 배송
이 속성은 가격과 서비스를 나타내면서 지원하는 각 국가의 배송 세부 사항을 지정하는 데 사용됩니다
유형: String
예:
<shipping>
<country>US</country>
<service>Standard</service>
<price>15.5 USD</price>
</shipping>
3.2.16 shipping_weight
shipping_weight은 제품 중량을 나타냅니다.
문자 요구 사항: 다음 단위들만 허용됩니다: lb, oz, g, kg
유형: String
예: 1kg
3.2.17 shipping_height
shipping_height은 제품 높이를 나타냅니다.
3.2.18 shipping_width
shipping_weight은 제품 폭을 나타냅니다.
3.2.19 shipping_length
세부 사항: shipping_height은 제품 높이를 나타냅니다.
3.2.20 shipping_label
이 속성은 상하기 쉽거나 대량이거나 프로모션과 같은 값을 사용하여 특정 상품에 라벨을 다는데 사용할 수 있습니다.
제한: 100
유형: String
예: 프로모션
---
제품 패키지 및 번들
3.2.21 멀티 팩
이 속성은 동일 제품 팩을 지정합니다.
유형: 정수
예: 2
3.2.22 is_bundle
이 속성은 다른 상품의 그룹을 지정합니다.
유형: Boolean
예: 거짓
3.2.23 promotion_id
세부 사항: 이 속성은 프로모션 ID를 지정합니다.
제한: String
유형: 60
예: 123654
3.2.24 promo_text
세부 정보 :이 필드에는 이 제품의 홍보 문구가 포함되어 있습니다.
제한: String
유형: 60
예: 특별 구매
---
추가 속성
3.2.25 custom_label_0
제품에 대한 자세한 사용자 정의 정보를 추가합니다.
문자 요구 사항: 사용자 지정 레이블 중 5개 레벨만 허용함 (0에서 4까지)
제한: 100
유형: String
3.2.27 adwords_redirect
구글 쇼핑의 모든 클릭을 별도로 추적할 URL.
제한: 200
유형: URL
예: http://www.mywebsite.com/productpage.html
3.2.28 excluded_destination
'excluded destination' 속성은 귀하 제품 데이터에 나타나지만 해당 상품이 특정 지역에서 노출되는 것을 방지할 수 있습니다.
3.2.30 unit_pricing_measure
'unit pricing measure' 속성은 항목의 측정 및 치수를 정의합니다. 예, 25floz 혹은 15oz.
예: 15oz
3.2.31 unit_pricing_base_measure
'unit pricing base measure' 속성은 단위 price 분모의 기본 설정을 지정합니다.‘ 예. 50floz.
예: 50oz
3.2.32 display_ads_title
이 필드는 원하는 경우 ( 'title'과 다른) 디스플레이 광고에서 다른 title을 표시하는 데 사용할 수 있습니다.
짧은 title은 저희 디스플레이 배너에 들어갈 가능성이 더 있지만, 더 긴 title은 Criteo 검색에 더 잘 작동하기 때문에 저희는 'title'에서 전체/긴 title을 'display_ads_title'에서 더 짧은 title을 권장합니다.
글자 수 제한: 150 (25 권장)
유형: string
3.2.33 display_ads_value
품목 Price와 동일한 통화의 품목 마진이 있습니다. 다수 마진은 실제 제품 마진을 숨기는 데 사용할 수도 있지만 제품들에서 일치해야 합니다.
값 제한 : 제품 Price의 10배
유형: string
예 : 299.99
3.2.34 map_price
map_price 필드는 제품의 "최소 광고주 Price"를 나타냅니다. 이 필드 값은 저희 광고에 표시되지 않고 어떤 이유로 귀하가 map_price에 대해 열등한 광고 Price를 표시할 수 없는 경우 지정해야 합니다. 제품의 현재 Price가 map_price보다 낮은 경우, Price는 광고에 표시되지 않습니다.
문자 요구 사항: "원"이나 천단위 구분자(,)를 포함하지 않는 숫자로만 전달되어야 합니다.
유형: string
예 : 1299.99
3.2.34 model_number
model_number는 일련의 하나의 제품을 다른 것과 차별화하는 데 사용됩니다. model_number는 종종 같은 범주의 유사 제품을 차별화하기 위해 브랜드가 사용합니다. 동일 model_number는 때로는 서로 다른 ID 값과 유사 변동 제품 상에 나타날 수 있습니다.
제한: 200
문자 요구 사항: model_number는 ASCII 문자만 포함할 수 있습니다.
유형: String
예 AXY27
카탈로그 구조 예시
XML feed의 예
XML
|
<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0"> <channel> <title>Your Website</title> <link>http://www.yoursite.com/us/</link> <description>Your Website</description> <item> <g:id>abc123-black-7.5</g:id> <g:title>Working Boots Size 7.5</g:title> <g:description>Excellent for daily use</g:description> <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category> <g:link>http://www.example.com/product/working-boots</g:link> <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link> <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link> <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link> <g:availability>in stock</g:availability> <g:price>1299.99</g:price> <g:sale_price>1199.99</g:sale_price> <g:gtin>0001234560012</g:gtin> <g:brand>Criteo</g:brand> <g:adult>no</g:adult> <g:product_type>Women’s > Shoes > Working Boots</g:product_type> <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link> <g:condition>new</g:condition> <g:availability>in stock</g:availability> <g:availability_date>2016-06-25T13:00-0800</g:availability_date> <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date> <g:item_group_id>abc123</g:item_group_id> <g:color>Black</g:color> <g:gender>male</g:gender> <g:age_group>adult</g:age_group> <g:material>leather</g:material> <g:pattern>Striped</g:pattern> <g:size>L</g:size> <g:size_type>regular</g:size_type> <g:size_system>US</g:size_system> <g:shipping> <g:country>US</g:country> <g:service>Standard</g:service> <g:price>5.5 USD</g:price> </g:shipping> <g:shipping_weight>1 kg</g:shipping_weight> <g:shipping_label>promotion</g:shipping_label> <g:multipack>2</g:multipack> <g:is_bundle>FALSE</g:is_bundle> <g:custom_label_0>custom data 0</g:custom_label_0> <g:custom_label_1>custom data 1</g:custom_label_1> <g:custom_label_2>custom data 2</g:custom_label_2> <g:custom_label_3>custom data 3</g:custom_label_3> <g:custom_label_4>custom data 4</g:custom_label_4> <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date> <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect> <g:excluded_destination>Shopping</g:excluded_destination> <g:expiration_date>2016-07-24</g:expiration_date> <g:unit_pricing_measure>15oz</g:unit_pricing_measure> <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure> </item> </channel> </rss> |
