ฟีดราคา

ฟีดราคารวมข้อมูลราคาสำหรับแผนการเดินทางทั้งหมดของเรือสำราญ ซึ่งรวมถึงราคาห้องพักที่ถูกที่สุดสำหรับเรือสำราญในสกุลเงินแต่ละประเภท คุณสามารถอัปโหลดฟีดราคาในรูปแบบ CSV ได้

สกุลเงินต่อไปนี้พร้อมให้บริการใน Google

  • USD
  • CAD
  • AUD
  • GBP

USD เป็นสกุลเงินเดียวที่พร้อมให้บริการสำหรับการผสานรวมกับ Google คุณสามารถระบุสกุลเงินอื่นๆ ที่รองรับได้ แต่ระบบจะแสดงเฉพาะสกุลเงิน USD ระบบจะรองรับสกุลเงินเพิ่มเติมจากรายการในอนาคต โปรดดูรายการ สกุลเงินอื่นๆ ที่รองรับ และรหัสสกุลเงิน 3 ตัวอักษรที่เกี่ยวข้อง

คอมโพเนนต์หลัก

ฟีดราคามีช่องที่ต้องกรอกซึ่งไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ บางช่องเป็นช่องที่ไม่บังคับและคุณสามารถเว้นว่างไว้ได้ การส่งข้อมูลที่ไม่บังคับจะช่วยปรับปรุงคุณภาพของข้อมูล

ฟีดราคามีช่องที่ต้องกรอกต่อไปนี้

  • sail_id: ตัวระบุการล่องเรือที่ไม่ซ้ำกันสำหรับการเดินทางที่เฉพาะเจาะจง
  • currency_code: รหัสสกุลเงิน 3 ตัวอักษร ที่ไม่ซ้ำกันสำหรับสกุลเงินที่เฉพาะเจาะจง

  • cruise_line: ชื่อบริษัทเรือสำราญ

  • starting_price: ราคารวมของแผนการเดินทางของเรือสำราญ ซึ่งรวมภาษีแล้ว

  • sail_url: URL ของหน้า Landing Page ที่แสดงข้อมูลราคา

ช่อง

ชื่อช่อง จำเป็นหรือไม่ ประเภท คำอธิบาย
sail_id Required string ตัวระบุการล่องเรือที่ไม่ซ้ำกันสำหรับการเดินทางที่เฉพาะเจาะจงในแผนการเดินทางที่มี วันที่เริ่มต้นและวันที่สิ้นสุด ตัวอย่างเช่น สำหรับแผนการเดินทาง 5 คืนที่มี 3 จุดแวะพัก sail_id จะไม่ซ้ำกันและยังคงเหมือนกันทั้งหมดสำหรับจุดแวะพักทั้ง 3 จุด ตัวอย่าง sail_id คือ ABC12345

หมายเหตุ: ระบบจะนำ sail_id และ currency_code มาต่อกันเพื่อสร้างคีย์หลักแบบผสมและต้องไม่ซ้ำกัน

currency_code Required currency รหัสสกุลเงิน 3 ตัวอักษร สำหรับราคา ตัวอย่างเช่น currency_code อาจเป็น USD

หมายเหตุ: ระบบจะนำ sail_id และ currency_code มาต่อกันเพื่อสร้างคีย์หลักแบบผสมและต้องไม่ซ้ำกัน

cruise_line Required string ชื่อบริษัทเรือสำราญ cruise_line เป็นสิ่งจำเป็นสำหรับ ผู้รวบรวมข้อมูลที่ขายในนามของบริษัทอื่นๆ ตัวอย่างเช่น Norwegian Cruise Line
starting_price Required decimal ราคารวมของแผนการเดินทางของเรือสำราญ ซึ่งรวมภาษีแล้ว ราคารวม ซึ่งรวมภาษีและค่าโดยสารเรือสำราญ ค่านี้ควรเป็นค่าเดียวกับที่แสดงในเว็บไซต์ของพาร์ทเนอร์เมื่อเปิด URL ของข้อเสนอ ตัวอย่างเช่น 1000.00
sail_url Required URL URL ของหน้า Landing Page ที่แสดงข้อมูลราคา ตัวอย่างเช่น https://partner.com/path.html&id=XYZ12345
offer_desc Optional string คำอธิบายของข้อเสนอที่เชื่อมโยงกับราคาหรือชื่อห้องพัก ตัวอย่างเช่น Inside Cabin
image_url Optional URL URL ของรูปภาพที่แสดงถึงแผนการเดินทาง รูปภาพควรเกี่ยวข้องกับการตกแต่งภายในของเรือสำราญ เช่น รูปภาพห้องพัก ดาดฟ้าเรือ และสิ่งอำนวยความสะดวกอื่นๆ ที่มีในเรือ รูปภาพไม่จำเป็นต้องเป็น ห้องพักที่แสดงรายการ คุณสามารถใช้รูปภาพห้องพักอื่นได้ ตัวอย่าง image_url คือ https://partner.com/images/XXXXX.jpg
brand_name Optional string คีย์รองเพื่อให้มี sail_url's หลายรายการสำหรับ sail_id และ currency_code เดียวกัน ตัวอย่างเช่น Fancy Crusies
updated_at Optional datetime วันที่และเวลาที่อัปเดตข้อมูลนี้ล่าสุดใน เวลาสากลเชิงพิกัด(UTC) ข้อมูลนี้มีประโยชน์สำหรับการ ระบุข้อมูลที่ล้าสมัย โดยควรเป็นไปตามรูปแบบ ISO 8601 ตัวอย่างเช่น updated_at คือ 2025-01-22T00:00:00+00:00

ตัวอย่าง

ตัวอย่างต่อไปนี้เป็นตัวอย่างพื้นฐานของฟีดราคาสำหรับการล่องเรือ 2 รายการ โดยการล่องเรือ 1 รายการเป็นการเดินทางเที่ยวเดียว และอีกรายการเป็นการเดินทางไปกลับ

ตัวอย่างแสดงทั้งรูปแบบ CSV และ JSON ระบบจะนำช่อง sail_id และ currency_code มาต่อกันเพื่อสร้างคีย์หลักแบบผสมและต้องไม่ซ้ำกันในแต่ละแถว

CSV

ฟิลด์ที่จำเป็น

ตัวอย่างต่อไปนี้แสดงฟิลด์ที่ต้องกรอกในฟีดราคา

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

ฟิลด์ที่พร้อมใช้งานทั้งหมด

ตัวอย่างต่อไปนี้แสดงฟิลด์ที่พร้อมใช้งานทั้งหมดในฟีดราคา

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 (เพื่อวัตถุประสงค์ในการให้ข้อมูล)

ฟิลด์ที่จำเป็น

ตัวอย่างต่อไปนี้แสดงฟิลด์ที่ต้องกรอกในฟีดราคา

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

ฟิลด์ที่พร้อมใช้งานทั้งหมด

ตัวอย่างต่อไปนี้แสดงฟิลด์ที่พร้อมใช้งานทั้งหมดในฟีดราคา

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