Feed del prezzo

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

Con Google sono disponibili le seguenti valute:

• 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. In futuro verranno supportate altre valute dell'elenco. Consulta l'elenco delle altre valute supportate e il codice valuta di tre lettere corrispondente.

Componenti chiave

Il feed dei prezzi 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.

Ha i seguenti campi obbligatori:

• sail_id: un identificatore univoco della navigazione per un viaggio specifico.

• 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 crociera.

• 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 un determinato viaggio nell'itinerario con data di inizio e di fine. Ad esempio, per un itinerario di 5 notti con 3 tappe, il sail_id è univoco e rimane lo stesso per tutte e 3 le tappe. Un esempio di sail_id è ABC12345. Nota:sail_id e currency_code vengono concatenati per formare una chiave primaria 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 primaria 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 si apre 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, del ponte della nave e di altre strutture fornite sulla nave. L'immagine non deve necessariamente rappresentare la cabina esatta elencata. Puoi utilizzare un'immagine diversa della cabina. Un esempio di image_url è https://partner.com/images/XXXXX.jpg
brand_name	Optional	string	Chiave secondaria per consentire più sail_url per lo stesso sail_id e currency_code. Ad esempio: Fancy Crusies.
updated_at	Optional	datetime	La data e l'ora in cui questa voce è stata aggiornata l'ultima volta in UTC(Coordinated Universal Time). Queste informazioni sono utili per identificare i dati obsoleti. Deve seguire il 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 dei prezzi per due viaggi in barca, uno di sola andata e l'altro di andata e ritorno.

Gli esempi mostrano i formati CSV e JSON. I campi sail_id, currency_code vengono concatenati per formare la chiave primaria composita 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 per i campi obbligatori nel feed dei prezzi:

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 mostra tutti i campi disponibili nel feed dei 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 per i campi obbligatori nel feed dei prezzi:

[
  {
    "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 mostra tutti i campi disponibili nel feed dei 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.