Fiyat feed'i

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

Google'da 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. Listedeki diğer para birimleri gelecekte desteklenecektir. Diğer desteklenen para birimlerinin listesine ve karşılık gelen üç harfli para birimi koduna bakın.

Temel bileşenler

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

Şu zorunlu alanlara sahiptir:

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

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

  • cruise_line: Yolcu gemisi şirketinin adı.

  • starting_price: Vergiler dahil kruvaziyer seyahat 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 seyahat tanımlayıcısı. Örneğin, 3 durak içeren 5 gecelik bir seyahat planı için sail_id benzersizdir ve tüm 3 durak için aynı kalır. sail_id örneği ABC12345'dur.

Not: sail_id ve currency_code, birleşik bir birincil anahtar oluşturmak için birleştirilir 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şik bir birincil anahtar oluşturmak için birleştirilir ve benzersiz olmalıdır.
cruise_line Required string Kruvaziyer ş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, seyahat 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 imkanların resmi gibi gemi içi alanlarla ilgili olmalıdır. Resim, listelenen kabinin tam olarak aynısı olmamalıdır. Farklı bir kabin resmi kullanabilirsiniz. image_url örneği: https://partner.com/images/XXXXX.jpg
brand_name Optional string Aynı sail_id ve currency_code için birden fazla sail_url'e izin veren ikincil anahtar. Örneğin, Fancy Crusies.
updated_at Optional datetime Bu girişin Eşgüdümlü Evrensel Zaman(UTC) diliminde son güncellendiği tarih ve saat. Bu bilgiler, eski verileri belirlemek için yararlıdır. ISO 8601 biçimine uygun olmalıdır. Örneğin, updated_at değeri 2025-01-22T00:00:00+00:00'tır.

Örnekler

Aşağıda, biri tek yönlü diğeri gidiş dönüş olmak üzere iki seyahat 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şik birincil anahtarı oluşturmak için birleştirilir ve her satır için benzersiz olmalıdır.

CSV

Zorunlu alanlar

Aşağıda, fiyat feed'indeki zorunlu alanlara ö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'inde bulunan tüm alanlara ö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ıdır)

Zorunlu alanlar

Aşağıda, fiyat feed'indeki zorunlu alanlara ö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'inde bulunan tüm alanlara ö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"
  }
]