가격 피드

가격 피드에는 모든 크루즈 일정의 가격 정보가 포함됩니다. 각 통화 유형에 대해 크루즈의 가장 저렴한 선실 요금이 포함됩니다. 가격 피드는 CSV 형식으로 업로드할 수 있습니다.

Google에서 사용할 수 있는 통화는 다음과 같습니다.

  • USD
  • CAD
  • AUD
  • GBP

Google과 통합할 때 사용할 수 있는 통화는 미국 달러뿐입니다. 지원되는 다른 통화를 입력할 수 있지만 USD 통화만 표시됩니다. 향후 목록에 더 많은 통화가 추가될 예정입니다. 다른 지원되는 통화 목록과 해당하는 3자리 통화 코드를 참고하세요.

주요 구성요소

가격 피드에는 대소문자를 구분하지 않는 필수 입력란이 있습니다. 일부 필드는 선택사항이며 비워 둘 수 있습니다. 선택사항인 데이터를 전송하면 데이터 품질이 개선됩니다.

다음과 같은 필수 입력란이 있습니다.

  • sail_id: 특정 여정의 고유한 항해 식별자입니다.

  • currency_code: 특정 통화의 고유한 3자리 통화 코드입니다.

  • cruise_line: 크루즈 라인의 이름입니다.

  • starting_price: 세금을 포함한 크루즈 숙박 일정의 총 가격입니다.

  • sail_url: 가격 정보를 보여주는 방문 페이지의 URL입니다.

필드

필드 이름 필수 여부 유형 설명
sail_id Required string 시작일과 종료일이 있는 숙박 일정의 특정 이동에 대한 고유한 항해 식별자입니다. 예를 들어 3개의 중간 기착지가 있는 5박 일정의 경우 sail_id은 고유하며 세 중간 기착지 모두에서 동일하게 유지됩니다. sail_id의 예는 ABC12345입니다.

참고: sail_id 및 currency_code는 연결되어 복합 기본 키를 형성하며 고유해야 합니다.
currency_code Required currency 가격의 3자리 통화 코드입니다. 예를 들어 currency_code는 USD일 수 있습니다.

참고: sail_id 및 currency_code는 연결되어 복합 기본 키를 형성하며 고유해야 합니다.
cruise_line Required string 크루즈 라인의 이름입니다. cruise_line는 다른 회사를 대신하여 판매하는 애그리게이터에게 필요합니다. 예를 들면 Norwegian Cruise Line입니다.
starting_price Required decimal 세금을 포함한 크루즈 숙박 일정의 총 가격입니다. 세금 및 크루즈 요금을 포함한 총 가격입니다. 제품 URL을 열 때 파트너 웹사이트에 표시되는 값과 동일해야 합니다. 예를 들어 1000.00입니다.
sail_url Required URL 가격 정보를 표시하는 방문 페이지의 URL입니다. 예를 들면 https://partner.com/path.html&id=XYZ12345입니다.
offer_desc Optional string 가격 또는 객실 이름과 연결된 혜택에 대한 설명입니다. 예: Inside Cabin.
image_url Optional URL 숙박 일정을 나타내는 이미지의 URL입니다. 이미지는 선박 내부와 관련이 있어야 합니다(예: 선박 내부, 선박 갑판, 선박에 제공되는 기타 시설 이미지). 이미지는 등록된 정확한 캐빈이 아니어도 됩니다. 다른 객실 이미지를 사용할 수 있습니다. image_url의 예는 https://partner.com/images/XXXXX.jpg입니다.
brand_name Optional string 동일한 sail_id 및 currency_code에 여러 개의 sail_url를 허용하는 보조 키입니다. 예를 들면 Fancy Crusies입니다.
updated_at Optional datetime 이 항목이 마지막으로 업데이트된 날짜 및 시간으로, 협정 세계시(UTC)로 표시됩니다. 이 정보는 오래된 데이터를 식별하는 데 유용합니다. ISO 8601 형식을 따라야 합니다. 예를 들어 updated_at는 2025-01-22T00:00:00+00:00입니다.

예

다음은 왕복 항공편 1개와 편도 항공편 1개에 대한 가격 피드의 기본 예입니다.

예시에서는 CSV 및 JSON 형식을 모두 보여줍니다. sail_id, currency_code 필드는 연결되어 복합 기본 키를 형성하며 각 행마다 고유해야 합니다.

CSV

필수 입력란

다음은 가격 피드의 필수 입력란 예입니다.

sail_id; currency_code; cruise_line; starting_price; sail_url
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345

사용 가능한 모든 필드

다음은 가격 피드에서 사용할 수 있는 모든 필드의 예입니다.

sail_id; currency_code; cruise_line; starting_price; sail_url; offer_desc; image_url; brand_name; updated_at
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Fancy Cruises; 2025-06-20T00:00:00+00:00
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00

JSON (정보 제공용)

필수 입력란

다음은 가격 피드의 필수 입력란 예입니다.

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  }
]

사용 가능한 모든 필드

다음은 가격 피드에서 사용할 수 있는 모든 필드의 예입니다.

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Fancy Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  }
]