Preisfeed

Der Preisfeed enthält Preisinformationen für alle Kreuzfahrtreisepläne. Er enthält den niedrigsten 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

US-Dollar ist die einzige verfügbare Währung für die Einbindung in Google. Sie können auch andere unterstützte Währungen angeben, aber nur US-Dollar wird angezeigt. Weitere Währungen aus der Liste werden in Zukunft unterstützt. Eine Liste der anderen unterstützten Währungen und der entsprechenden dreistelligen Währungscodes finden Sie hier.

Schlüsselkomponenten

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

Sie enthält die folgenden Pflichtfelder:

  • sail_id: Eine eindeutige Kennung für eine bestimmte Fahrt.

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

  • cruise_line: Der Name der Reederei.

  • starting_price: Der Gesamtpreis der Kreuzfahrt inklusive Steuern.

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

Felder

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

Hinweis:sail_id und currency_code werden zu einem zusammengesetzten Primärschlüssel zusammengefügt 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 zu einem zusammengesetzten Primärschlüssel zusammengefügt und müssen eindeutig sein.
cruise_line Required string Der Name der Kreuzfahrtgesellschaft. cruise_line ist für Dienstleister erforderlich, die im Namen anderer Unternehmen verkaufen. Beispiel: Norwegian Cruise Line.
starting_price Required decimal Der Gesamtpreis der Kreuzfahrt, einschließlich Steuern. Der Gesamtpreis, einschließlich Steuern und Kreuzfahrtpreis. Dieser Wert muss 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 Kabinennamen verknüpft ist. Beispiel: Inside Cabin.
image_url Optional URL Die URL eines Bildes, das den Reiseplan darstellt. Das Bild sollte sich auf die Innenräume des Kreuzfahrtschiffs beziehen, z. B. ein Bild der Kabine, des Schiffsdecks und anderer Einrichtungen an Bord. Das Bild muss nicht genau die aufgelistete Kabine zeigen. Sie können ein anderes Bild für die Kabine verwenden. Ein Beispiel für ein image_url ist https://partner.com/images/XXXXX.jpg.
brand_name Optional string Sekundärer Schlüssel, der mehrere sail_url für dieselbe sail_id und currency_code zulässt. Beispiel: Fancy Crusies
updated_at Optional datetime Datum und Uhrzeit der letzten Aktualisierung dieses Eintrags in koordinierter Weltzeit(UTC). Diese Informationen sind hilfreich, um veraltete Daten zu identifizieren. Sie muss dem ISO 8601-Format entsprechen. Angenommen, updated_at ist 2025-01-22T00:00:00+00:00.

Beispiele

Im Folgenden finden Sie ein einfaches Beispiel für einen Preisfeed für zwei Fahrten, wobei eine Fahrt eine einfache Fahrt und die andere eine Hin- und Rückfahrt ist.

Die Beispiele zeigen sowohl CSV- als auch JSON-Formate. Die Felder sail_id und currency_code werden zusammengeführt, um den zusammengesetzten Primärschlüssel zu bilden. Sie müssen für jede Zeile eindeutig sein.

CSV

Pflichtfelder

Im Folgenden finden Sie ein Beispiel für die erforderlichen Felder in einem 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 in einem 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 (nur zu Informationszwecken)

Pflichtfelder

Im Folgenden finden Sie ein Beispiel für die erforderlichen Felder in einem 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 in einem 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"
  }
]