Plik danych z cenami

Plik danych o cenach zawiera informacje o cenach wszystkich tras rejsów. Obejmuje najtańszą cenę kabiny na rejs w każdej walucie. Pliki danych o cenach możesz przesyłać w formacie CSV.

W Google dostępne są te waluty:

  • USD
  • CAD
  • AUD
  • GBP

USD to jedyna waluta dostępna w integracji z Google. Możesz podać inne obsługiwane waluty, ale wyświetlana będzie tylko waluta USD. W przyszłości będziemy obsługiwać więcej walut z tej listy. Zapoznaj się z listą innych obsługiwanych walut i odpowiadających im trzyliterowych kodów walut.

Kluczowe komponenty

Plik danych o cenach zawiera pola wymagane, w których nie jest rozróżniana wielkość liter. Niektóre pola są opcjonalne i można je pozostawić puste. Przesyłanie danych opcjonalnych poprawia jakość danych.

Zawiera te pola obowiązkowe:

  • sail_id: unikalny identyfikator rejsu dla konkretnej podróży.

  • currency_code: unikalny trzyliterowy kod waluty.

  • cruise_line: nazwa linii rejsowej.

  • starting_price: łączna cena rejsu, w tym podatki.

  • sail_url: adres URL strony docelowej, na której wyświetlają się informacje o cenie.

Pola

Nazwa pola Wymagany? Typ Opis
sail_id Required string Unikalny identyfikator rejsu dla konkretnej podróży w ramach planu podróży z datą rozpoczęcia i zakończenia. Jeśli na przykład trasa obejmuje 5 nocy i 3 przystanki, pole sail_id jest unikalne i pozostaje takie samo dla wszystkich 3 przystanków. Przykład pola sail_id: ABC12345.

Uwaga: sail_id i currency_code są łączone w celu utworzenia złożonego klucza podstawowego i muszą być unikalne.
currency_code Required currency Trzyliterowy kod waluty ceny. Na przykład, currency_code może mieć wartość USD.

Uwaga: sail_id i currency_code są łączone w celu utworzenia złożonego klucza podstawowego i muszą być unikalne.
cruise_line Required string Nazwa linii rejsowej. cruise_line jest wymagane w przypadku agregatorów, którzy sprzedają w imieniu innych firm. Na przykład, Norwegian Cruise Line.
starting_price Required decimal Łączna cena rejsu, w tym podatki. Łączna cena, w tym podatki i opłata za rejs. Powinna to być ta sama wartość wyświetlana w witrynie partnera po otwarciu adresu URL oferty. Na przykład 1000.00.
sail_url Required URL Adres URL strony docelowej, na której wyświetlają się informacje o cenie. Na przykład, https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Opis oferty powiązanej z ceną lub nazwą kabiny. Na przykład, Inside Cabin.
image_url Optional URL Adres URL obrazu przedstawiającego plan podróży. Obraz powinien być związany z wnętrzami rejsu, np. przedstawiać kabinę, pokład statku i inne udogodnienia na statku. Obraz nie musi przedstawiać dokładnie tej kabiny, która jest wymieniona w ofercie. Możesz użyć innego obrazu kabiny. Przykład pola image_url: https://partner.com/images/XXXXX.jpg
brand_name Optional string Klucz dodatkowy, który umożliwia używanie wielu sail_url's dla tego samego sail_id i currency_code. Na przykład, Fancy Crusies.
updated_at Optional datetime Data i godzina ostatniej aktualizacji tego wpisu w uniwersalnym czasie koordynowanym(UTC). Te informacje są przydatne do identyfikowania nieaktualnych danych. Powinny być zgodne z formatem ISO 8601. Na przykład pole updated_at to 2025-01-22T00:00:00+00:00.

Przykłady

Poniżej znajdziesz podstawowy przykład pliku danych o cenach dla 2 rejsów, z których jeden jest w jedną stronę, a drugi w obie strony.

Przykłady pokazują formaty CSV i JSON. Pola sail_id i currency_code są łączone w celu utworzenia złożonego klucza podstawowego i muszą być unikalne w każdym wierszu.

CSV

Pola wymagane

Poniżej znajdziesz przykład pól wymaganych w pliku danych o cenach:

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

Wszystkie dostępne pola

Poniższy przykład przedstawia wszystkie dostępne pola w pliku danych o cenach:

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 (w celach informacyjnych)

Pola wymagane

Poniżej znajdziesz przykład pól wymaganych w pliku danych o cenach:

[
  {
    "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"
  }
]

Wszystkie dostępne pola

Poniższy przykład przedstawia wszystkie dostępne pola w pliku danych o cenach:

[
  {
    "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"
  }
]