Preisfeed

Der Preisfeed enthält Preisinformationen für alle Kreuzfahrtrouten. Sie enthält den günstigsten Kabinenpreis für eine Kreuzfahrt für jede Währung. Sie können Preisfeeds im CSV-Format hochladen.

Die folgenden Währungen sind bei Google verfügbar:

  • USD
  • CAD
  • AUD
  • GBP

USD ist die einzige verfügbare Währung für die Integration mit Google. Sie können andere unterstützte Währungen angeben, es wird aber nur USD angezeigt. In Zukunft werden weitere Währungen aus der Liste unterstützt. Liste der unterstützten Währungen und der entsprechenden dreistelligen Währungscodes

Schlüsselkomponenten

Der Preisfeed enthält Pflichtfelder, bei denen die Groß-/Kleinschreibung nicht beachtet wird. Einige Felder sind optional und können leer gelassen werden. Durch das Senden optionaler Daten wird die Datenqualität verbessert.

Es enthält die folgenden Pflichtfelder:

  • sail_id: Eine eindeutige Segel-ID für eine bestimmte Fahrt.

  • currency_code: Ein eindeutiger dreistelliger Währungscode für die jeweilige Währung.

  • cruise_line: Der Name der Kreuzfahrtlinie.

  • starting_price: Der Gesamtpreis des Kreuzfahrtplans einschließlich Steuern.

  • sail_url: Die URL der Landingpage, auf der die Preisinformationen angezeigt werden.

Felder

Feldname Erforderlich? Typ Beschreibung
sail_id Required string Eindeutige Segel-ID für eine bestimmte Reise im Reiseplan mit Start- und Enddatum. Beispiel: Bei einem Reiseplan mit 5 Übernachtungen und 3 Aufenthalten ist die sail_id eindeutig und bleibt für alle 3 Aufenthalte gleich. Ein Beispiel für sail_id ist ABC12345.

Hinweis:sail_id und currency_code werden verkettet, um einen zusammengesetzten Primärschlüssel zu bilden, und müssen eindeutig sein.
currency_code Required currency Der dreistellige Währungscode für den Preis. currency_code kann beispielsweise USD sein.

Hinweis:sail_id und currency_code werden verkettet, um einen zusammengesetzten Primärschlüssel zu bilden, und müssen eindeutig sein.
cruise_line Required string Der Name der Kreuzfahrtlinie. cruise_line ist für Aggregatoren erforderlich, die im Namen anderer Unternehmen verkaufen. Beispiel: Norwegian Cruise Line.
starting_price Required decimal Der Gesamtpreis der Kreuzfahrtroute, einschließlich Steuern. Der Gesamtpreis, einschließlich Steuern und Kreuzfahrtpreis. Dieser Wert sollte mit dem Wert übereinstimmen, der auf der Partnerwebsite angezeigt wird, wenn die Angebots-URL geöffnet wird. Beispiel: 1000.00.
sail_url Required URL Die URL der Landingpage, auf der die Preisinformationen angezeigt werden. Beispiel: https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Eine Beschreibung des Angebots, das mit dem Preis oder dem Namen der Kabine verknüpft ist. Beispiel: Inside Cabin.
image_url Optional URL Die URL eines Bildes, das die Reiseroute repräsentiert. Das Bild sollte sich auf die Innenräume des Kreuzfahrtschiffs beziehen, z. B. ein Bild der Kabine, des Schiffsdecks und anderer Einrichtungen auf dem Schiff. Das Bild muss nicht die genau angegebene Kabine zeigen. Sie können ein anderes Kabinenbild verwenden. Beispiel für ein image_url-Paar: https://partner.com/images/XXXXX.jpg
brand_name Optional string Sekundärschlüssel, um mehrere sail_url für dieselben sail_id und currency_code zuzulassen. Beispiel: Fancy Crusies
updated_at Optional datetime Das Datum und die Uhrzeit, zu der dieser Eintrag zuletzt in koordinierter Weltzeit(UTC) aktualisiert wurde. Diese Informationen sind nützlich, um veraltete Daten zu erkennen. Sie muss dem ISO 8601-Format entsprechen. Die updated_at ist beispielsweise 2025-01-22T00:00:00+00:00.

Beispiele

Das folgende Beispiel zeigt einen einfachen Preisfeed für zwei Segeltörns, von denen einer ein Hinflug und der andere ein Hin- und Rückflug ist.

In den Beispielen werden sowohl das CSV- als auch das JSON-Format verwendet. Die Felder sail_id und currency_code werden verkettet, um den zusammengesetzten Primärschlüssel zu bilden. Sie müssen für jede Zeile eindeutig sein.

CSV

Pflichtfelder

Hier ein Beispiel für die erforderlichen Felder im Preisfeed:

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

Alle verfügbaren Felder

Das folgende Beispiel zeigt alle verfügbaren Felder im Preisfeed:

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 (zur Information)

Pflichtfelder

Hier ein Beispiel für die erforderlichen Felder im Preisfeed:

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

Alle verfügbaren Felder

Das folgende Beispiel zeigt alle verfügbaren Felder im Preisfeed:

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