로그인

저희 지원센터에 오신 것을 환영합니다

광고 진행을 위한 작업과 라이브를 위해 도움을 드리겠습니다.

저희 지원센터에 오신 것을 환영합니다. 광고 진행을 위한 작업과 라이브를 위해 도움을 드리겠습니다.

Criteo 피드 사양 (호텔 & 숙박)

product feed는 사이트에 게재되는 모든 룸/숙박시설에 관한 체계적인 정보가 포함된 데이터 파일입니다. 이 정보는 다이내믹 광고를 구축하는데 사용됩니다.

이 페이지에서 feed에 포함할 수 있는 것과 각 필드를 포맷하는 방법에 대한 자세한 내용을 확인할 수 있습니다.

제품 피드를 구축하는 경우는 다음 사항을 유념하십시오.

  • 제품 정보에는 HTML 태그나 스타일 태그가 포함될 수 없습니다.
  • 피드의 제품 ID는 태그로 전달되는 제품 ID와 일치해야 합니다.
  • Criteo가 귀하 상품 feed를 가져올 수 있도록 이 포맷들 중 하나를 이용하십시오.

format

세부 내용

다운로드

CSV/TSV

이 포맷은 쉼표나 탭으로 구분되는 값에 기반합니다. 헤더는 파일의 첫 번째 행에서 선언이 되어야 합니다. 필드 명에는 공백이나 밑줄이 포함될 수 있습니다. (예: image_link 또는 image link)

 예시

XML

이 포맷은 XML 구조의 기본을 존중해야 합니다. 제품은 XML 노드 세트로 표현됩니다. 제품 목록은 <?xml 신고 태그로 시작해야 합니다. 

 예시

피드 가져오기에 사용될 수 있는 프로토콜에 대한 보다 자세한 정보는 Criteo가 피드를 가져오는 방법을 참조하십시오.

1. 제공할 제품 정보

1.1. 필수 입력항목

id

이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다.

id는 하나의 호텔 또는 리조트를 나타내는 고유한 알파벳 식별자입니다.

  • 문자 요구사항: id에는 ASCII 문자만 포함되어야 하며 따옴표가 들어가면 안됩니다.
  • 한도: 240
  • 유형: string
  • 예: H12896

title

이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다.

title은 도시명 및/또는 호텔/리조트의 이름입니다. 이는 배너에 노출되는 제품의 메인 텍스트로 사용됩니다.

  • 문자 요구사항: 이름은 문자로 시작해야 합니다.
  • 한도: 150
  • 유형: string
  • 예: 그랜드 호텔 뉴욕

link

이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다.

link는 특정 호텔의 캘린더 페이지나 검색 결과 페이지로 연결되어 특별 할인 가격이 표시될 수 있도록 해주는 링크입니다. 성인 수, 어린이 수 등 사용자가 보다 신속하게 입력을 할 수 있도록 유용한 추가 정보를 전달할 수 있습니다. 모든 URL에 프로토콜(http:// or https://)을 지정하십시오.

  • 문자 요구사항: link는 프로토콜(http:// 또는 https://)로 시작하고 제품 상세 페이지의 전체 URL 이 그 뒤에 위치하도록 합니다. 모든 기호는 인코딩 되어야 합니다. 예: $은 %24로 교체되어야 합니다. 영어 알파벳이 아닌 비 ASCII 문자가 포함될 수 있습니다.
  • 글자 수 제한: 1024
  • 유형: string
  • 예: http://www.travelsite.com/hotels/london.html

image_link

이 필드는 feed에 있는 모든 제품에 필요하며 비어두거나/공란으로 둘 수 없습니다.

bigimage는 특정 제품의 이미지로 파일 경로를 지정해주는 URL입니다. bigimage는 배너에 제품의 이미지를 표시하는데 사용됩니다. 이미지는 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는 프로토콜(http:// 또는 https://)로 시작을 하고 제품 이미지의 전체 URL 이 그 뒤에 위치해하도록 합니다. 모든 기호는 인코딩 되어야 합니다. 예: $은 %24로 교체되어야 합니다. 영어 알파벳이 아닌 비 ASCII 문자가 포함될 수 있습니다.
  • 글자 수 제한: 2000
  • 유형: string
  • 예: http://www.mysite.com/images/grandnewyork_b.jpg

상품 가격

price는 항공편의 가격입니다. 휴가 패키지 가격이 될 수도 있습니다. 가격에는 사이트와 동일한 통화가 사용되어야 합니다. 가격에는 천단위 구분자(,) 없이 마침표(.)와 숫자만 사용할 수 있습니다.

  • 문자 요구 사항: "원"이나 천단위 구분자(,)를 포함하지 않는 숫자로만 전달되어야 합니다.
  • 글자 수 제한: 14
  • 유형: string
  • : 199.99

대분류 카테고리

COS 옵티마이저를 사용하는 경우라면, COS-기반 카테고리를 사용해 categoryid1을 채울 수 있습니다. (그렇지 않은 경우는 CRO-기반) 예를 들어, 도시-국가 쌍 또는 고유한 위치 식별자가 사용될 수 있습니다.

  • 문자 요구사항: categoryid1은 문자나 숫자 중 어느 하나로 시작해야 하며 ASCII 문자만 포함할 수 있습니다. 
  • 글자 수 제한: 500
  • 유형: string
  • : 플로리다주 마이애미

1.2. 적극 권장되는 필드

다음 필드들은 필수항목은 아니지만, 캠페인을 보다 쉽게 관리하고 실적과 고객 경험을 향상시키는데 도움을 줄 수 있기 때문에 사용을 적극 권장합니다.

별점

호텔/리조트에 대한 사용자 평점(소수점으로 구분)

  • 문자 요구사항: 1에서 5까지의 숫자 (0.5점 단위)
  • 글자 수 제한: 없음
  • 유형: 숫자
  • : 4.5

sale_price

sale_price는 호텔/리조트의 할인 이전 가격입니다. 특정 호텔/리조트가 "할인 판매 중"인 경우, 가격 필드는 이보다 높은 가격으로 채워집니다. 가격에는 사이트와 동일한 통화가 사용되어야 합니다. 가격에는 천단위 구분자(,) 없이 마침표(.)와 숫자만 사용할 수 있습니다.

  • 문자 요구 사항: "원"이나 천단위 구분자(,)를 포함하지 않는 숫자로만 전달되어야 합니다.
  • 글자 수 제한: 14
  • 유형: string
  • : 129.99

상품 상세 설명

이 필드는 Facebook 광고를 실행하는데 필요한 필수 입력사항입니다.

description은 호텔/리조트의 이름입니다.

  • 문자 요구사항: Description은 문자로 시작해야 합니다.
  • 한도: 5000
  • 유형: string
  • 예: 그랜드 뉴욕은 활기찬 도시의 심장부에 위치합니다.

중분류 카테고리

categoryid2는 리조트/호텔/항공편의 지역 또는 하위 지역 등 고유한 위치 식별자로 채워질 수 있습니다.

  • 문자 요구사항: categoryid2은 문자나 숫자 중 어느 하나로 시작해야 하며 ASCII 문자만 포함할 수 있습니다. 
  • 글자 수 제한: 500
  • 유형: string
  • Example: Alsace

additional_image_link

additional_image_link는 특정 제품의 이미지 파일 경로를 지정하는 URL입니다. additional_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.

  • 문자 요구사항: additional_image_link는 http:// (https:// 아님))로 시작하고 상품 이미지의 전체 URL 이 그 뒤에 위치하도록 합니다 . 모든 기호는 인코딩 되어야 합니다. 예: $은 %24로 교체되어야 합니다. 그러나, additional_image_link에는 쿼리 문자열(? 뒤의 모든 문자)에 기호가 포함될 수 없습니다.
  • 글자 수 제한: 2000
  • 유형: string
  • : http://www.mysite.com/images/grandnewyork_s.jpg

1.3. 권장되는 필드

소분류 카테고리

categoryid3은 테마(가족, 스포츠, 자연 등)나 휴가 유형으로 채워질 수 있습니다.

  • 문자 요구사항: categoryid3은 문자나 숫자 중 어느 하나로 시작해야 하며 ASCII 문자만 포함할 수 있습니다. 
  • 글자 수 제한: 500
  • 유형: Float
  • : 4

availability

availability는 특정 제품이 사이트에서 구입 가능한지 여부를 표시합니다. availability는 3개 값 중 선택이 가능합니다. 1. 사전주문 (현재 판매되지는 않지만 구매 가능), 2. 품절 (배송 안되며 주문 불가), 3. 재고 보유 (배송되며 주문 가능) 품절로 표시된 항목은 배너에 표시되지 않습니다.

  • 문자 요구 사항: availability는 다음의 세 가지 값 중 하나로 채워져야 합니다:
    • 사전 주문
    • 품절
    • 재고
  • 한도: 16
  • 유형: string
  • 예: in stock
도움이 되었습니까?
0명 중 0명이 도움이 되었다고 했습니다.
Zendesk 제공