Feed harga

Feed harga berisi informasi harga untuk semua itinerari pelayaran. 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 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 boleh dikosongkan. Mengirim data opsional akan meningkatkan kualitas data.

Memiliki kolom wajib diisi 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: Total harga 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 rencana perjalanan 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 primer gabungan dan harus unik.
currency_code Required currency Kode mata uang tiga huruf untuk harga. Misalnya, currency_code dapat berupa USD.

Catatan: sail_id dan currency_code digabungkan untuk membentuk kunci primer 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 Total harga rencana perjalanan kapal pesiar termasuk pajak. Total harga, termasuk pajak dan tarif pelayaran. 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 rencana perjalanan. Gambar harus terkait dengan interior kapal pesiar seperti gambar kabin, dek kapal dan fasilitas lain yang disediakan di kapal. Gambar tidak harus berupa kabin yang sama persis dengan 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 saat entri ini terakhir diperbarui dalam Coordinated Universal Time(UTC). Informasi ini berguna untuk mengidentifikasi data yang tidak valid. Formatnya harus mengikuti 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 sekali jalan dan yang lainnya adalah perjalanan pulang pergi.

Contoh 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 untuk kolom wajib diisi 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 untuk kolom wajib diisi 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"
  }
]