Feed harga

Feed harga berisi informasi harga untuk semua itinerari kapal pesiar. Harga ini mencakup harga kabin termurah untuk pelayaran untuk setiap jenis mata uang. Anda dapat mengupload feed harga dalam format CSV.

Mata uang berikut tersedia di Google:

  • USD
  • CAD
  • AUD
  • GBP

USD adalah satu-satunya mata uang yang tersedia untuk integrasi dengan Google. Anda dapat memberikan mata uang lain yang didukung, tetapi hanya mata uang USD yang ditampilkan. Mata uang tambahan dari daftar ini akan didukung pada masa mendatang. Lihat daftar mata uang lain yang didukung dan kode mata uang tiga huruf yang sesuai.

Komponen utama

Feed harga memiliki kolom wajib diisi yang tidak peka huruf besar/kecil. Beberapa kolom bersifat opsional dan dapat dikosongkan. Mengirim data opsional akan meningkatkan kualitas data.

Kolom ini memiliki kolom wajib berikut:

  • sail_id: ID pelayaran unik untuk perjalanan tertentu.

  • currency_code: Kode mata uang tiga huruf unik untuk mata uang tertentu.

  • cruise_line: Nama perusahaan pelayaran.

  • starting_price: Harga total itinerari pelayaran termasuk pajak.

  • sail_url: URL halaman landing yang menampilkan informasi harga.

Kolom

Nama kolom Wajib? Jenis Deskripsi
sail_id Required string ID pelayaran unik untuk perjalanan tertentu dalam itinerari dengan tanggal mulai dan akhir. Misalnya, untuk itinerari 5 malam yang memiliki 3 perhentian, sail_id bersifat unik dan tetap sama untuk semua 3 perhentian. Contoh sail_id adalah ABC12345.

Catatan: sail_id dan currency_code digabungkan untuk membentuk kunci utama gabungan dan harus unik.
currency_code Required currency Tiga huruf kode mata uang untuk harga. Misalnya, currency_code dapat berupa USD.

Catatan: sail_id dan currency_code digabungkan untuk membentuk kunci utama gabungan dan harus unik.
cruise_line Required string Nama perusahaan pelayaran. cruise_line diperlukan untuk agregator yang menjual atas nama perusahaan lain. Sebagai contoh, Norwegian Cruise Line.
starting_price Required decimal Harga total itinerari pelayaran termasuk pajak. Harga total, termasuk pajak dan tarif kapal pesiar. Nilai ini harus sama dengan nilai yang ditampilkan di situs partner saat membuka URL penawaran. Misalnya 1000.00.
sail_url Required URL URL halaman landing yang menampilkan informasi harga. Misalnya, https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Deskripsi penawaran yang terkait dengan harga atau nama kabin. Contoh, Inside Cabin.
image_url Optional URL URL gambar yang mewakili itinerari. Gambar harus terkait dengan interior kapal pesiar seperti gambar kabin, dek kapal, dan fasilitas lainnya yang disediakan di kapal. Gambar tidak harus dari kabin yang tercantum. Anda dapat menggunakan gambar kabin yang berbeda. Contoh image_url adalah https://partner.com/images/XXXXX.jpg
brand_name Optional string Kunci sekunder untuk mengizinkan beberapa sail_url untuk sail_id dan currency_code yang sama. Misalnya, Fancy Crusies.
updated_at Optional datetime Tanggal dan waktu terakhir kali entri ini diperbarui dalam Waktu Universal Terkoordinasi(UTC). Informasi ini berguna untuk mengidentifikasi data yang sudah tidak berlaku. Format ini harus mengikuti format ISO 8601. Misalnya, updated_at adalah 2025-01-22T00:00:00+00:00.

Contoh

Berikut adalah contoh dasar feed harga untuk dua pelayaran, dengan satu pelayaran adalah perjalanan satu arah dan yang lainnya adalah perjalanan pulang-pergi.

Contoh ini menunjukkan format CSV dan JSON. Kolom sail_id, currency_code digabungkan untuk membentuk kunci utama gabungan dan harus unik untuk setiap baris.

CSV

Kolom wajib diisi

Berikut adalah contoh kolom yang diperlukan dalam feed Harga:

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

Semua kolom yang tersedia

Contoh berikut adalah contoh untuk semua kolom yang tersedia di feed Harga:

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 (untuk tujuan informasi)

Kolom wajib diisi

Berikut adalah contoh kolom yang diperlukan dalam feed Harga:

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

Semua kolom yang tersedia

Contoh berikut adalah contoh untuk semua kolom yang tersedia di feed Harga:

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