ฟีดราคา

ฟีดราคามีข้อมูลราคาสำหรับแผนการเดินทางของเรือสำราญทั้งหมด ซึ่งรวมถึงราคาห้องพักที่ถูกที่สุดสำหรับเรือสำราญสำหรับสกุลเงินแต่ละประเภท คุณสามารถอัปโหลดฟีดราคาในรูปแบบ 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 หลายรายการสำหรับ sail_id และ currency_code เดียวกัน เช่น Fancy Crusies
updated_at Optional datetime วันที่และเวลาที่อัปเดตรายการนี้ครั้งล่าสุดตามเวลาสากลเชิงพิกัด(UTC) ข้อมูลนี้มีประโยชน์ในการระบุข้อมูลที่ล้าสมัย โดยควรเป็นไปตามรูปแบบ ISO 8601 เช่น updated_at คือ 2025-01-22T00:00:00+00:00

ตัวอย่าง

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

ตัวอย่างแสดงทั้งรูปแบบ 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"
  }
]