Fiyat feed'i

Fiyat feed'i, tüm gemi seyahati planlarının fiyat bilgilerini içerir. Her para birimi türü için bir gemi yolculuğunun en ucuz kabin fiyatını içerir. Fiyat feed'lerini CSV biçiminde yükleyebilirsiniz.

Google ile aşağıdaki para birimleri kullanılabilir:

  • USD
  • CAD
  • AUD
  • GBP

Google ile entegrasyon için kullanılabilen tek para birimi ABD dolarıdır. Diğer desteklenen para birimlerini sağlayabilirsiniz ancak yalnızca ABD doları para birimi gösterilir. Gelecekte listedeki diğer para birimleri de desteklenecektir. Diğer desteklenen para birimlerinin ve karşılık gelen üç harfli para birimi kodunun listesine bakın.

Temel bileşenler

Fiyat feed'inde büyük/küçük harfe duyarlı olmayan zorunlu alanlar var. Bazı alanlar isteğe bağlıdır ve boş bırakılabilir. İsteğe bağlı verilerin gönderilmesi veri kalitesini artırır.

Aşağıdaki zorunlu alanları içerir:

  • sail_id: Belirli bir gezi için benzersiz bir yelkenli tanımlayıcısı.

  • currency_code: Belirli bir para birimi için benzersiz bir üç harfli para birimi kodu.

  • cruise_line: Yolcu gemisi şirketinin adı.

  • starting_price: Vergiler dahil, gemi seyahati planının toplam fiyatı.

  • sail_url: Fiyat bilgilerini gösteren açılış sayfasının URL'si.

Alanlar

Alan adı Zorunlu mu? Tür Açıklama
sail_id Required string Seyahat planındaki belirli bir gezi için başlangıç ve bitiş tarihi içeren benzersiz yelkenli tanımlayıcısı. Örneğin, 3 duraklı 5 gecelik bir seyahat planında sail_id benzersizdir ve 3 durak için de aynı kalır. sail_id örneği ABC12345.

Not: sail_id ve currency_code birleştirilerek bileşik birincil anahtar oluşturulur ve benzersiz olmalıdır.
currency_code Required currency Fiyatın üç harfli para birimi kodu. Örneğin, currency_code, USD olabilir.

Not: sail_id ve currency_code birleştirilerek bileşik birincil anahtar oluşturulur ve benzersiz olmalıdır.
cruise_line Required string Cruise şirketinin adı. cruise_line, diğer şirketler adına satış yapan toplayıcılar için gereklidir. Örneğin, Norwegian Cruise Line.
starting_price Required decimal Vergiler dahil, gemi seyahati planının toplam fiyatı. Vergiler ve gemi ücreti dahil toplam fiyat. Bu değer, teklif URL'si açıldığında iş ortağı web sitesinde gösterilen değerle aynı olmalıdır. Örneğin 1000.00.
sail_url Required URL Fiyat bilgilerini gösteren açılış sayfasının URL'si. Örneğin, https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Fiyat veya kabin adıyla ilişkili teklifin açıklaması. Örneğin, Inside Cabin.
image_url Optional URL Seyahat planını temsil eden bir resmin URL'si. Resim, kabin, gemi güvertesi ve gemide sunulan diğer olanaklar gibi gemi iç mekanlarıyla ilgili olmalıdır. Resmin, listelenen kabinin tam olarak aynısı olması gerekmez. Farklı bir kabin resmi kullanabilirsiniz. image_url örneği: https://partner.com/images/XXXXX.jpg
brand_name Optional string Aynı sail_url ve currency_code için birden fazla sail_id'ye izin veren ikincil anahtar. Örneğin, Fancy Crusies.
updated_at Optional datetime Bu girişin Eşgüdümlü Evrensel Saat(UTC) ile son güncellendiği tarih ve saat. Bu bilgiler, eski verileri belirlemek için yararlıdır. ISO 8601 biçiminde olmalıdır. Örneğin, updated_at değeri 2025-01-22T00:00:00+00:00'dir.

Örnekler

Aşağıda, birinin tek yön, diğerinin ise gidiş-dönüş olduğu iki yelkenli için fiyat feed'ine dair temel bir örnek verilmiştir.

Örneklerde hem CSV hem de JSON biçimleri gösterilmektedir. sail_id, currency_code alanları birleştirilerek bileşik birincil anahtar oluşturulur ve her satır için benzersiz olmalıdır.

CSV

Zorunlu alanlar

Aşağıda, fiyat feed'indeki zorunlu alanlarla ilgili bir örnek verilmiştir:

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

Kullanılabilir tüm alanlar

Aşağıdaki örnek, fiyat feed'indeki tüm alanlar için geçerli bir örnektir:

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 (bilgi amaçlı)

Zorunlu alanlar

Aşağıda, fiyat feed'indeki zorunlu alanlarla ilgili bir örnek verilmiştir:

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

Kullanılabilir tüm alanlar

Aşağıdaki örnek, fiyat feed'indeki tüm alanlar için geçerli bir örnektir:

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