가격 피드

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

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

  • USD
  • CAD
  • AUD
  • GBP

USD는 Google과의 통합에 사용할 수 있는 유일한 통화입니다. 지원되는 다른 통화를 제공할 수 있지만 USD 통화만 표시됩니다. 목록에 있는 추가 통화는 향후 지원될 예정입니다. 지원되는 다른 통화 및 해당 3자리 통화 코드 목록을 참고하세요.

주요 구성요소

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

다음과 같은 필수 필드가 있습니다.

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

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

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

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

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

필드

필드 이름 필수 여부 유형 설명
sail_id Required string 시작일과 종료일이 있는 운항 일정의 특정 여행에 대한 고유한 항해 식별자입니다. 예를 들어 3개의 정차 지점이 있는 5박 운항 일정의 경우 sail_id는 고유하며 3개의 정차 지점 모두에서 동일하게 유지됩니다. 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's를 허용하는 보조 키입니다. 예를 들어, Fancy Crusies.
updated_at Optional datetime 이 항목이 협정 세계시(UTC)로 마지막으로 업데이트된 날짜와 시간입니다. 이 정보는 비활성 데이터를 식별하는 데 유용합니다. ISO 8601 형식을 따라야 합니다. 예를 들어 updated_at은 2025-01-22T00:00:00+00:00입니다.

예

다음은 두 개의 항해에 대한 가격 피드의 기본 예입니다. 한 항해는 편도 여행이고 다른 항해는 왕복 여행입니다.

예에서는 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"
  }
]