Plik danych z cenami

Plik danych o cenach zawiera informacje o cenach wszystkich planów podróży wycieczek statkiem. Obejmuje ona najtańszą cenę kabiny na rejs dla każdego typu waluty. Pliki danych o cenach możesz przesyłać w formacie CSV.

Google obsługuje te waluty:

  • USD
  • CAD
  • AUD
  • GBP

USD to jedyna waluta dostępna w przypadku integracji z Google. Możesz podać inne obsługiwane waluty, ale wyświetlana jest tylko waluta USD. W przyszłości dodamy kolejne waluty z tej listy. Zobacz listę obsługiwanych walut i odpowiadających im 3-literowych kodów walut.

Kluczowe komponenty

Plik danych o cenach zawiera wymagane pola, w których wielkość liter nie jest rozróżniana. Niektóre pola są opcjonalne i mogą być puste. Wysyłanie opcjonalnych danych poprawia ich jakość.

Zawiera te wymagane pola:

  • sail_id: unikalny identyfikator żeglugi dla konkretnego rejsu.

  • currency_code: unikatowy trzyliterowy kod waluty dla danej waluty.

  • cruise_line: nazwa linii wycieczkowej.

  • starting_price: łączna cena trasy wycieczki morskiej, w tym podatki.

  • sail_url: adres URL strony docelowej, która zawiera informacje o cenie.

Pola

Nazwa pola Wymagany? Typ Opis
sail_id Required string Unikalny identyfikator rejsu dla konkretnej podróży w planie podróży z datą rozpoczęcia i zakończenia. Na przykład w przypadku planu podróży na 5 nocy z 3 przystankami wartość sail_id jest unikalna i nie zmienia się w przypadku wszystkich 3 przystanków. Przykładem właściwości sail_id jest ABC12345.

Uwaga: wartości sail_id i currency_code są łączone, aby utworzyć złożony klucz podstawowy. Muszą być niepowtarzalne.
currency_code Required currency Trzyliterowy kod waluty dla ceny. np. pole currency_code może być polem USD.

Uwaga: wartości sail_id i currency_code są łączone, aby utworzyć złożony klucz podstawowy. Muszą być niepowtarzalne.
cruise_line Required string Nazwa linii wycieczkowej. cruise_line jest wymagany w przypadku agregatorów, którzy sprzedają w imieniu innych firm. Na przykład:Norwegian Cruise Line.
starting_price Required decimal Łączny koszt trasy rejsu, w tym podatki. Łączna cena, w tym podatki i opłata za rejs. Powinna to być ta sama wartość, która jest 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 znajdują 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 symbolizującego plan podróży. Obraz powinien przedstawiać wnętrze statku, np. kabinę, pokład lub inne udogodnienia. Zdjęcie nie musi przedstawiać kabiny, która jest wymieniona w ofercie. Możesz użyć innego obrazu kabiny. Przykładem image_url jest:https://partner.com/images/XXXXX.jpg
brand_name Optional string Drugi klucz, który umożliwia tworzenie wielu sail_url 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. Powinien on być w formacie ISO 8601. Na przykład updated_at to 2025-01-22T00:00:00+00:00.

Przykłady

Poniżej znajdziesz podstawowy przykład pliku danych z cenami dotyczący 2 rejsów, z których jeden to podróż w jedną stronę, a drugi w obie strony.

Przykłady pokazują formaty CSV i JSON. Pola sail_id i currency_code są łączone, aby utworzyć złożony klucz podstawowy. Muszą być unikalne dla każdego wiersza.

CSV

Pola wymagane

Poniżej znajduje się przykład wymaganych pól 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żej znajdziesz przykład wszystkich dostępnych pól 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 (informacje)

Pola wymagane

Poniżej znajduje się przykład wymaganych pól 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żej znajdziesz przykład wszystkich dostępnych pól 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"
  }
]