Лента цен

Лента цен содержит информацию о ценах на все круизные маршруты. Он включает в себя самую дешевую цену каюты в круизе для каждого типа валюты. Вы можете загружать каналы цен в формате CSV.

В Google доступны следующие валюты:

  • USD
  • CAD
  • AUD
  • GBP

Доллар США — единственная доступная валюта для интеграции с Google. Вы можете указать другие поддерживаемые валюты, но отображается только валюта USD. Дополнительные валюты из списка будут поддерживаться в будущем. См. список других поддерживаемых валют и соответствующий трехбуквенный код валюты.

Ключевые компоненты

В фиде цен есть обязательные поля, нечувствительные к регистру. Некоторые поля являются необязательными и их можно оставить пустыми. Отправка дополнительных данных улучшает качество данных.

Он имеет следующие обязательные поля:

  • sail_id : уникальный идентификатор плавания для конкретной поездки.

  • currency_code : уникальный трехбуквенный код конкретной валюты.

  • cruise_line : название круизной линии.

  • starting_price : общая стоимость круизного маршрута, включая налоги.

  • sail_url : URL-адрес целевой страницы, на которой отображается информация о ценах.

Поля

Имя поля Необходимый? Тип Описание
sail_id Required string Уникальный идентификатор плавания для конкретной поездки по маршруту с датой начала и окончания. Например, для маршрута на 5 ночей с 3 остановками sail_id уникален и остается одинаковым для всех 3 остановок. Пример sail_id — ABC12345 .

Примечание. sail_id currency_code объединяются, образуя составной первичный ключ, и должны быть уникальными.

currency_code Required currency Трехбуквенный код валюты для цены. Например, 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_url для одного и того же sail_id и currency_code . Например, 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"
  }
]