Feed del prezzo

Il feed del prezzo contiene informazioni sui prezzi di tutti gli itinerari delle crociere. È incluso il prezzo più basso della cabina per una crociera per ogni tipo di valuta. Puoi caricare feed dei prezzi in formato CSV.

Le seguenti valute sono disponibili con Google:

• USD
• CAD
• AUD
• GBP

Il dollaro statunitense è l'unica valuta disponibile per l'integrazione con Google. Puoi fornire altre valute supportate, ma viene visualizzata solo la valuta USD. Altre monete dell'elenco verranno supportate in futuro. Consulta l'elenco delle altre valute supportate e del codice valuta di tre lettere corrispondente.

Componenti chiave

Il feed del prezzo contiene campi obbligatori che non fanno distinzione tra maiuscole e minuscole. Alcuni campi sono facoltativi e possono essere lasciati vuoti. L'invio di dati facoltativi migliora la qualità dei dati.

Contiene i seguenti campi obbligatori:

• sail_id: un identificatore univoco della navigazione per una gita specifica.

• currency_code: un codice valuta di tre lettere univoco per la valuta specifica.

  Punto chiave: sail_id e currency_code vengono concatenati per formare una chiave primaria composita e devono essere univoci.

• cruise_line: il nome della compagnia di navigazione.

• starting_price: il prezzo totale dell'itinerario della crociera, incluse le tasse.

• sail_url: l'URL della pagina di destinazione che mostra le informazioni sul prezzo.

Campi

Nome campo	Obbligatorio?	Tipo	Descrizione
sail_id	Required	string	Identificatore univoco della navigazione per una determinata corsa nell'itinerario con data di inizio e di fine. Ad esempio, per un itinerario di 5 notti con 3 fermate, il valore sail_id è univoco e rimane invariato per tutte le 3 fermate. Un esempio di sail_id è ABC12345. Nota: sail_id e currency_code vengono concatenati per formare una chiave principale composita e devono essere univoci.
currency_code	Required	currency	Il codice valuta di tre lettere per il prezzo. Ad esempio, currency_code può essere USD. Nota: sail_id e currency_code vengono concatenati per formare una chiave principale composita e devono essere univoci.
cruise_line	Required	string	Il nome della compagnia di crociera. cruise_line è obbligatorio per gli aggregatori che vendono per conto di altre società. Ad esempio, Norwegian Cruise Line.
starting_price	Required	decimal	Il prezzo totale dell'itinerario della crociera, incluse le tasse. Il prezzo totale, incluse tasse e tariffa della crociera. Deve essere lo stesso valore visualizzato sul sito web del partner quando apri l'URL dell'offerta. Ad esempio 1000.00.
sail_url	Required	URL	L'URL della pagina di destinazione che mostra le informazioni sul prezzo. Ad esempio, https://partner.com/path.html&id=XYZ12345
offer_desc	Optional	string	Una descrizione dell'offerta associata al prezzo o al nome della cabina. Ad esempio, Inside Cabin.
image_url	Optional	URL	L'URL di un'immagine che rappresenta l'itinerario. L'immagine deve essere correlata agli interni della crociera, ad esempio un'immagine della cabina, della coperta della nave e di altre strutture presenti sulla nave. L'immagine non deve necessariamente raffigurare la baita esatta indicata. Puoi utilizzare un'immagine della cabina diversa. Un esempio di image_url è https://partner.com/images/XXXXX.jpg
brand_name	Optional	string	Chiave secondaria per consentire più sail_url per gli stessi sail_id e currency_code. Ad esempio: Fancy Crusies.
updated_at	Optional	datetime	La data e l'ora dell'ultimo aggiornamento di questa voce nel tempo universale coordinato(UTC). Queste informazioni sono utili per identificare i dati obsoleti. Deve essere nel formato ISO 8601. Ad esempio, updated_at è 2025-01-22T00:00:00+00:00.

Esempi

Di seguito è riportato un esempio di base di un feed del prezzo per due tratte, di cui una è di sola andata e l'altra è di andata e ritorno.

Gli esempi mostrano entrambi i formati CSV e JSON. I campi sail_id, currency_code vengono concatenati per formare la chiave primaria composta e devono essere univoci per ogni riga.

Punto chiave: non utilizzare il formato JSON, che è solo a scopo informativo. Tutti i feed devono essere in formato CSV.

CSV

Campi obbligatori

Di seguito è riportato un esempio dei campi obbligatori nel feed del prezzo:

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

Tutti i campi disponibili

L'esempio seguente è un esempio di tutti i campi disponibili nel feed prezzi:

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 (a scopo informativo)

Campi obbligatori

Di seguito è riportato un esempio dei campi obbligatori nel feed del prezzo:

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

Nota: tutti i feed devono essere in formato CSV. Non utilizzare il formato JSON.

Tutti i campi disponibili

L'esempio seguente è un esempio di tutti i campi disponibili nel feed prezzi:

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

Nota: tutti i feed devono essere in formato CSV. Non utilizzare il formato JSON.