| วัตถุประสงค์ | ตั้งค่า ฝัง และดูแลรักษา Cloudbeds Booking Engine Immersive Experience 2.0 บนเว็บไซต์ของที่พักของคุณ |
| เหมาะสำหรับ | ผู้ดูแลระบบที่พัก ผู้จัดการ เจ้าของ และนักพัฒนาเว็บไซต์ที่รับผิดชอบการปรับใช้งาน |
| ใช้เมื่อ | คุณต้องการติดตั้ง กำหนดค่า ปรับแต่ง หรือแก้ไขปัญหา Immersive Experience 2.0 บนเว็บไซต์ของที่พัก |
| ข้อกำหนด | การเข้าถึงพรีเมียมเอ็มเบด โดเมนเว็บไซต์ รหัสที่พัก และการเข้าถึง HTML ของเว็บไซต์ของคุณ |
| ผลลัพธ์ที่คาดหวัง | Immersive Experience 2.0 โหลดบนเว็บไซต์ที่พักที่ได้รับอนุญาตโดยใช้สคริปต์โหลดเดอร์ที่รองรับและโหมดฝังที่เลือก |
| ข้อจำกัด | เทมเพลตหรือผู้สร้างเว็บไซต์แบบไม่ใช้โค้ดอาจจัดการสคริปต์ที่กำหนดเองแตกต่างกัน หลีกเลี่ยงการวางแทคคอมโพเนนต์เว็บ Immersive Experience 2.0 ภายใน iframe |
บทนำ
Cloudbeds Booking Engine Immersive Experience 2.0 ฝังกระบวนการจองโดยตรงบนเว็บไซต์ของที่พักของคุณโดยไม่ใช้การซ่อนผ่าน iframe เว็บไซต์ของคุณต้องได้รับอนุญาตผ่านโดเมนที่อยู่ในไวต์ลิสต์ และต้องติดตั้งสคริปต์โหลดเดอร์ที่รองรับใน HTML ของเว็บไซต์ก่อนที่คอมโพเนนต์เว็บจะสามารถแสดงผลได้
ใช้คู่มือนี้สำหรับการติดตั้งและพิจารณาทางเทคนิคที่อาจส่งผลต่อกระบวนการจอง รวมถึงแพลตฟอร์มการจัดการความยินยอม (Consent Management Platforms - CMPs), ตัวสร้างเว็บไซต์, การติดตาม, พารามิเตอร์การค้นหา และการปรับแต่งสไตล์ สำหรับภาพรวมทั่วไปของเครื่องมือการจอง ดูได้ที่ Cloudbeds Booking Engine: ทุกเรื่องที่ต้องรู้.
สารบัญ
- เกี่ยวกับ Immersive Experience 2.0
- ติดตั้ง Immersive Experience 2.0
- การยินยอมคุกกี้และการตั้งค่า CMP
- ข้อควรพิจารณาในการตั้งค่าและการแก้ไขปัญหา
- พารามิเตอร์การค้นหาและการติดตาม
- ปรับแต่ง Immersive Experience 2.0
เกี่ยวกับ Immersive Experience 2.0
Cloudbeds Booking Engine Immersive Experience 2.0 เป็นส่วนประกอบบนเว็บที่ช่วยให้ผู้เข้าพักสามารถค้นหาสถานะห้องว่าง เลือกห้องและอัตรา กรอกรายละเอียดผู้เข้าพัก และชำระเงินได้โดยตรงจากเว็บไซต์ของที่พักของคุณ สามารถติดตั้งเป็นประสบการณ์เต็มหน้า หรือเปิดจากปุ่มจองตอนนี้ได้
ประโยชน์หลัก
Immersive Experience 2.0 นำเสนอ ฟีเจอร์เอกลักษณ์เฉพาะ ที่ออกแบบมาเพื่อยกระดับประสบการณ์การจองของผู้เข้าพักบนเว็บไซต์ของคุณ:
- อัตราการเปลี่ยนเป็นยอดจองสูงขึ้น: คลิกน้อยลง โหลดเร็วขึ้น และประสบการณ์แบรนด์ที่สอดคล้องกันช่วยเพิ่มยอดจอง
- ปรับแต่งได้มากขึ้น: สร้างประสบการณ์ผู้เข้าพักที่เอกลักษณ์และน่าจดจำโดยไม่ถูกจำกัดด้วย iframe มาตรฐาน
- การเติบโตที่ขับเคลื่อนด้วยข้อมูล: เข้าถึงข้อมูลเชิงลึกและตัวชี้วัดสำคัญเพื่อปรับปรุงกระบวนการจองและเพิ่มการจองโดยตรง
- ความน่าเชื่อถือที่เพิ่มขึ้น: กระบวนการจองที่ปลอดภัยและราบรื่นช่วยสร้างความมั่นใจให้ผู้เข้าพัก กระตุ้นให้พวกเขาทำการจองจนเสร็จสมบูรณ์
ส่วนประกอบบนเว็บเทียบกับ iframe
แตกต่างจากระบบที่ใช้ iframe ส่วนประกอบ บนเว็บที่รวมกันนี้ มีข้อดีดังนี้:
- โหลดเว็บไซต์ได้เร็วขึ้น
- การปรับแต่งแบรนด์ที่ดีขึ้น
- กระบวนการจองที่ เป็นหนึ่งเดียว ทำให้ผู้เข้าพักอยู่บนเว็บไซต์ตั้งแต่การค้นหาเริ่มต้นจนถึงชำระเงินเสร็จสมบูรณ์
รูปลักษณ์
Immersive Experience 2.0 มีตัวเลือกการฝังที่ยืดหยุ่นสองแบบ เพื่อให้เหมาะกับการออกแบบเว็บไซต์และกระบวนการใช้งานของที่พัก คุณสามารถเลือกฝัง ประสบการณ์เต็มหน้า หรือสร้างและฝัง ป๊อปอัพ Immersive Experience ได้
- การฝังแบบเต็มหน้า ทำงานตามที่ชื่อบอกไว้: คือการวางเครื่องมือการจองทั้งหมด ไว้ภายในหน้าหนึ่งของเว็บไซต์ของคุณโดยตรง เพื่อมอบประสบการณ์การจองที่ต่อเนื่องและเต็มรูปแบบให้กับผู้เข้าพักตั้งแต่ต้นจนจบ
การฝังแบบเต็มหน้าจะทำให้ผู้เข้าพักอยู่บนเว็บไซต์ของที่พักขณะค้นหาที่พักที่มี, ตรวจสอบอัตรา และสร้างการจองของพวกเขา
ในระหว่างการเช็กเอาต์ ผู้เข้าพักจะกรอกรายละเอียดติดต่อ ข้อมูลเพิ่มเติมที่ไม่บังคับ ผู้เข้าพักเพิ่มเติม และการตั้งค่าการสื่อสารโดยไม่ต้องออกจากกระบวนการจองที่ฝังอยู่
ก่อนที่จะทำการจองเสร็จสมบูรณ์ ผู้เข้าพักสามารถตรวจสอบข้อกำหนดและเงื่อนไขของที่พัก เช่น การเช็กอิน เช็กเอาต์ การยกเลิก และอื่นๆ
- ตัวเลือกการฝังแบบป๊อปอัพ เป็นทางเลือกที่ทันสมัยและเรียบง่าย เมื่อผู้เข้าพักคลิกปุ่ม “จองตอนนี้” แผงด้านข้าง จะเลื่อนเข้ามาอย่างนุ่มนวลจาก ขอบหน้าจอ มอบประสบการณ์การจองที่ครบถ้วนแต่กะทัดรัดโดยไม่ต้องออกจากหน้าปัจจุบัน
ในการปรับใช้แบบป๊อปอัพ ผู้เข้าพักจะเปิด Immersive Experience จากปุ่มจองตอนนี้ของที่พัก ขณะที่เว็บไซต์เดิมยังคงแสดงอยู่เบื้องหลังแผงการจอง
กระบวนการจองประกอบด้วย:
- การค้นหาสถานะห้องว่าง
- การเลือกห้อง
- การแสดงอัตรา
- โอกาสในการอัปเซล
- การกรอกข้อมูลผู้เข้าพัก
- การประมวลผลการชำระเงินอย่างปลอดภัย
ภายในกระบวนการจอง Immersive Experience 2.0 (ทั้งแบบป๊อปอัปและเต็มหน้า) รายละเอียดการค้นหาของผู้เข้าพัก รวมถึงวัน จำนวนผู้เข้าพัก รหัสโปรโมชั่น ห้องที่เลือก และความคืบหน้าในการเช็กเอาต์ จะถูกเก็บรักษาโดยอัตโนมัติเป็นเวลาสูงสุด 10 นาที หากผู้เข้าพักออกจากกระบวนการจองชั่วคราวและกลับเข้ามาภายในเวลานี้ พวกเขาจะสามารถดำเนินการต่อจากจุดที่ค้างไว้ได้ทันที ช่วยให้ประสบการณ์การจองราบรื่นขึ้นและลดโอกาสที่ผู้เข้าพักจะยกเลิก
การกำหนดราคาและสถานะห้องว่าง
การเข้าถึง Immersive Experience 2.0 ขึ้นอยู่กับการสมัครสมาชิก Cloudbeds ของคุณ หากแพ็กเกจของคุณรวม พรีเมียมเอ็มเบด คุณสามารถเข้าถึง Immersive Experience 2.0 ได้จากส่วน พรีเมียม ใน แท็บฝัง
หากแพ็กเกจของคุณไม่มีพรีเมียมเอ็มเบด ส่วนพรีเมียมอาจแสดงตัวเลือก ติดต่อฝ่ายขาย คลิกที่ ติดต่อฝ่ายขาย เพื่อขอข้อมูลเพิ่มเติมเกี่ยวกับการอัปเกรดเป็นแพ็กเกจที่รวมพรีเมียมเอ็มเบด
พรีเมียมเอ็มเบดรวม Immersive Experience 2.0 และโซลูชันส่วนประกอบเว็บที่เกี่ยวข้อง ส่วนเบสิกเอ็มเบดยังคงมีให้สำหรับการปรับใช้งานที่ง่ายขึ้นโดยใช้วิดเจ็ต
วิธีการชำระเงินแบบกำหนดเองและการรองรับเกตเวย์
- คำแนะนำเกี่ยวกับการรองรับเกตเวย์: เรา ไม่แนะนำ ให้ใช้เกตเวย์การชำระเงินที่ไม่ได้รับการรองรับใน Immersive Experience เมื่อเกตเวย์เหล่านี้ไม่ได้อยู่ในโดเมนของ Cloudbeds แล้ว เราจะไม่สามารถควบคุมความปลอดภัยหรือการปฏิบัติตามมาตรฐาน PCI ได้
- ข้อจำกัดในปัจจุบัน: วิธีการชำระเงินแบบกำหนดเอง ควรใช้เฉพาะในสภาพแวดล้อมที่โฮสต์เท่านั้นในขณะนี้
- การรองรับในอนาคต: ทีม Cloudbeds Payments กำลังพัฒนาการรองรับอย่างเป็นทางการสำหรับเกตเวย์เหล่านี้ผ่านการเชื่อมต่อแบบกำหนดเองภายในอินเตอร์เฟสของ PMS ฟีเจอร์นี้มีกำหนดเปิดตัวในปี 2569 ลูกค้าจะได้รับรายละเอียดเพิ่มเติมเกี่ยวกับช่วงเวลาที่แน่นอนเมื่อใกล้ถึงวันส่งมอบ
- ช่องทางการสนับสนุน: สำหรับคำแนะนำเฉพาะด้านการปรับใช้งานหรือคำถามเกี่ยวกับวิธีการชำระเงินแบบกำหนดเอง กรุณาติดต่อ ทีม Cloudbeds Payments โดยตรง ทีมนี้ดูแล SDK การชำระเงินทั้งหมดและเป็นผู้ที่เหมาะสมที่สุดในการช่วยเหลือคุณ
ติดตั้ง Immersive Experience 2.0
ทำการตั้งค่าตามขั้นตอนด้านล่างเพื่ออนุญาตโดเมนเว็บไซต์ของคุณ โหลดสคริปต์ Immersive Experience ที่รองรับ และเพิ่มส่วนประกอบ Booking Engine ลงในเว็บไซต์ของคุณ ขั้นตอนนี้ใช้ได้ทั้งกับการติดตั้งแบบเต็มหน้าและปุ่ม จองตอนนี้
ค่าที่แสดงเป็น {PARAMETER} คือค่าตัวอย่าง ให้แทนที่ด้วยค่าจริงของคุณและลบวงเล็บปีกกาออก
ห้ามวางแท็กส่วนประกอบเว็บ Immersive Experience 2.0 ภายใน iframe เพราะอาจทำให้เกิดปัญหาการเลื่อนหน้า และต้องเพิ่มรายการทั้งหมดในโซ่ iframe ลงในไวต์ลิสต์ ซึ่งไม่แนะนำ
ขั้นตอนที่ 1: ยืนยันการเข้าถึง Premium Embeds
สำคัญ: การเข้าถึงพรีเมียมเอ็มเบดขึ้นอยู่กับการสมัครสมาชิก Cloudbeds ของคุณค่ะ
- ถ้าพรีเมียมเอ็มเบดรวมอยู่ในแพ็กเกจของคุณ คุณสามารถเข้าถึงตัวเลือก Immersive Experience 2.0 ได้จาก เครื่องมือการจอง > ฝัง > พรีเมียม ค่ะ
- ถ้าพรีเมียมเอ็มเบดไม่รวมอยู่ในแพ็กเกจของคุณ ส่วนพรีเมียมอาจแสดงตัวเลือก ติดต่อฝ่ายขาย คลิกที่ ติดต่อฝ่ายขาย เพื่อขอข้อมูลเพิ่มเติมเกี่ยวกับการอัปเกรดเป็นแพ็กเกจที่รวมพรีเมียมเอ็มเบดค่ะ
- ถ้าคุณเป็นลูกค้า Cloudbeds Websites คุณสามารถติดต่อทีม Cloudbeds Websites เพื่อขอคำแนะนำเกี่ยวกับการปรับใช้งานและคำขอเปิดใช้งานได้ค่ะ
ขั้นตอนที่ 2: เพิ่มโดเมนของคุณในโดเมนที่อนุญาต
เพิ่มโดเมนที่จะติดตั้ง Immersive Experience 2.0 ในส่วน โดเมนที่อนุญาต ของพรีเมียมเอ็มเบดที่เลือก คุณสามารถเพิ่มโดเมนได้สูงสุด 5 โดเมนค่ะ
- จาก เมนูบัญชี ของคุณ
, เลือก การตั้งค่า
- คลิกที่ เครื่องมือการจอง
- คลิกแท็บ ฝัง
- ในส่วน พรีเมียม เลือกตัวเลือก Immersive Experience ที่คุณต้องการติดตั้ง
- ในบัตร โดเมนที่อนุญาต คลิก เพิ่มโดเมน
- กรอกโดเมนที่จะติดตั้ง Immersive Experience แล้วบันทึกการเปลี่ยนแปลงของคุณค่ะ
รองรับทั้งโดเมนหลักและซับโดเมน เช่น my-hotel.com และ booking.my-hotel.com ค่ะ
โดเมนที่อยู่ในรายการขาว: วิธีตรวจสอบรูปแบบโดเมนที่ถูกต้อง
บางครั้งโดเมนของเว็บไซต์อาจถูกตั้งค่าให้ต้องมี www รวมอยู่ด้วย เพื่อครอบคลุมทั้งสองกรณี ให้ตรวจสอบรูปแบบโดเมนที่เว็บไซต์ของคุณใช้ก่อนที่จะเพิ่มเข้าไป
- เปิดเว็บไซต์ของคุณและดูที่ URL ในเบราว์เซอร์ของคุณ
- ตรวจสอบว่า URL มี www หรือไม่ เช่น อาจแสดงเป็น https://www.yourdomain.com หรือ https://yourdomain.com
เมื่อทราบแล้วว่าเว็บไซต์ของคุณใช้รูปแบบใด ให้กรอกโดเมนที่ตรงกันในช่อง โดเมนที่อยู่ในรายการขาว เช่น หากเว็บไซต์ของคุณแสดงพร้อม www ให้เพิ่มโดเมนของคุณเป็น www.yourdomain.com
ทำไมต้องเพิ่มโดเมนในรายการขาว
Immersive Experience เป็นส่วนประกอบเว็บ ไม่ใช่ iframe มันทำงานบนเว็บไซต์ของคุณและส่งคำขอ API ไปยังบริการของ Cloudbeds จากโดเมนของคุณ การเพิ่มโดเมนในรายการขาวจะบอก Cloudbeds ว่า ต้นทาง ใดได้รับอนุญาต เพื่อให้คำขอข้ามโดเมนเหล่านั้นได้รับการยอมรับ
ขั้นตอนที่ 3: เพิ่มสคริปต์ Immersive Experience
เพิ่มสคริปต์ต่อไปนี้ในองค์ประกอบ <head> ของเอกสาร HTML บนเว็บไซต์ของคุณ:
<script
data-entry="immersive"
src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
nonce="+imGC13HmyB6zTZ1eTnZMw=="
integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
crossorigin="anonymous"
type="text/plain"
data-categories="essential"
></script>หากเว็บไซต์ของคุณใช้แพลตฟอร์มจัดการความยินยอม (Consent Management Platform - CMP) ให้ตั้งค่า CMP ให้เสร็จก่อนเผยแพร่การปรับใช้งาน ความต้องการของ CMP จะแตกต่างกันไปตามผู้ให้บริการ
ขั้นตอนที่ 4: ฝังเครื่องมือการจอง
คุณสามารถแสดง Immersive Experience ได้สองวิธี:
- โหมดมาตรฐาน (ฝังเต็มหน้า): หรือที่เรียกว่า “ฝังเต็มหน้า” เป็นโหมดค่าเริ่มต้นที่แอปเครื่องมือการจองถูกรวมอย่างเต็มที่ในเว็บไซต์เจ้าของสถานที่ ในการฝัง ให้ใส่โค้ดต่อไปนี้ใน HTML ตำแหน่งที่ต้องการแสดงผล:
<cb-immersive-experience mode="standard" property-code="{PROPERTY_CODE}" />- โหมดป๊อบอัป (ปุ่มจองตอนนี้): โหมดนี้จะแสดงแอปเครื่องมือการจองในรูปแบบป๊อบอัปที่มีตำแหน่งคงที่และโอเวอร์เลย์ ในการเพิ่มปุ่ม จองตอนนี้ ที่เปิด Immersive Experience ในป๊อบอัป:
<cb-book-now-button property-code="{PROPERTY_CODE}" />หากคุณไม่ระบุแอตทริบิวต์ mode คอมโพเนนต์จะตั้งค่าเป็น มาตรฐาน โดยอัตโนมัติ
ค้นหา รหัสที่พัก ของคุณ
ไปที่ เมนูบัญชี > การกำหนดค่า > เครื่องมือการจอง > แท็บสรุป รหัสของคุณคือค่าตัวอักษรและตัวเลข 6 หลักที่อยู่ท้ายลิงก์เครื่องมือการจองของคุณ:
https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}
ในตัวอย่างด้านล่าง ส่วนที่เน้นคือรหัสที่พักที่คุณควรใช้ในโค้ดฝัง (แทนที่วงเล็บปีกกาและค่าภายในโค้ดของคุณ)
การยินยอมคุกกี้และการตั้งค่า CMP
หากเว็บไซต์ของคุณใช้แพลตฟอร์มจัดการความยินยอม (Consent Management Platform - CMP) ให้กำหนดค่า Immersive Experience เพื่อให้ทรัพยากรของ Cloudbeds ที่จำเป็นถูกจัดเป็นทรัพยากรสำคัญและไม่ถูกบล็อกก่อนที่กระบวนการจองจะโหลดเสร็จ ทำตามการตั้งค่าที่เฉพาะเจาะจงสำหรับผู้ให้บริการด้านล่างก่อนเผยแพร่การเปลี่ยนแปลงเว็บไซต์
ใช้การตั้งค่าที่เฉพาะเจาะจงสำหรับผู้ให้บริการ CMP ของคุณ:
-
Cookiebot:
data-cookieconsent="ignore" -
OneTrust:
data-ignore-consent="true" -
Quantcast:
data-quantcast-ignore="true" - Termly: เพิ่มแม็ปบล็อกแบบกำหนดเองด้านล่างก่อนสคริปต์ Termly โดยแนะนำให้อยู่ใกล้จุดเริ่มต้นของ HTML
<script data-termly-config>
window.TERMLY_CUSTOM_BLOCKING_MAP = {
"cloudbeds.com": "essential",
"clientstream.launchdarkly.com": "essential",
"clientsdk.launchdarkly.com": "essential",
"tile.openstreetmap.org": "essential",
"tokenex.com": "essential",
"stripe.com": "essential",
"stripe.network": "essential",
"braintreegateway.com": "essential",
"dlocal.com": "essential",
"authorize.net": "essential",
"pagosonline.net": "essential",
"paypal.com": "essential",
"adyen.com": "essential"
};
</script>จัดประเภทตัวโหลด Immersive Experience ว่าจำเป็นหรือสำคัญในค่ากำหนด CMP ของคุณ ใช้จุดเริ่มต้นตัวโหลดปัจจุบันด้านล่าง การใช้งานโดยตรงของ cb-immersive-experience.js ถือว่าเลิกใช้แล้ว
<script
data-entry="immersive"
src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
nonce="+imGC13HmyB6zTZ1eTnZMw=="
integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
crossorigin="anonymous"
type="text/plain"
data-categories="essential"
></script>การยอมรับความยินยอมจะไม่ช่วยปลดบล็อกสคริปต์ที่พยายามโหลดไปแล้ว หลังจากยอมรับความยินยอม ผู้เข้าพักต้องรีเฟรชหน้าจอเพื่อให้แม็ป ภาพ และทรัพยากรการชำระเงินที่ถูกบล็อกก่อนหน้านี้แสดงขึ้นมาได้ครับ
ข้อควรพิจารณาในการตั้งค่าและการแก้ไขปัญหา
ส่วนด้านล่างนี้เน้นพฤติกรรมและรายละเอียดการปรับใช้งานที่เป็นประโยชน์ในการทราบก่อนเปิดใช้งานครับ
ความเข้ากันได้กับผู้สร้างเว็บไซต์
Immersive Experience ได้รับการ ทดสอบกับเว็บไซต์ที่สร้างขึ้นเอง เท่านั้น ผู้สร้างเว็บไซต์แบบเทมเพลตหรือไม่ใช้โค้ดอาจจัดการสคริปต์ที่กำหนดเองแตกต่างกัน ซึ่งอาจส่งผลต่อฟังก์ชันการทำงาน
- การแทรกโค้ดในส่วนหัว: ยืนยันว่าคุณสามารถเพิ่ม Immersive Experience <script> ในส่วน <head> ของหน้าเว็บได้
- การเพิ่มในไวต์ลิสต์: ตรวจสอบให้แน่ใจว่าโดเมนที่ใช้งานจริง (และโดเมนสำหรับสเตจหรือดูตัวอย่าง) ได้ถูกเพิ่มในบัตร โดเมนที่อยู่ในไวต์ลิสต์ เพื่อให้คำขอ API ได้รับการยอมรับ คุณสามารถเพิ่มโดเมนได้สูงสุด 5 โดเมน
- CSS/JS ที่กำหนดเอง: สไตล์หรือสคริปต์ที่เพิ่มในส่วนปรับแต่งของเครื่องมือการจองจะ ไม่ ถูกนำไปใช้โดยอัตโนมัติกับ Immersive Experience; ให้เพิ่มใน HTML ของเว็บไซต์ของคุณแทน
- หน้าชำระเงิน: ขั้นตอนการชำระเงินอาจแตกต่างกันไปขึ้นอยู่กับ วิธีการชำระเงินที่เลือก
- หากผู้เข้าพักเลือกใช้ Apple Pay, Google Pay หรือ ตัวเลือกการชำระเงินจากบุคคลที่สามอื่น ๆ พวกเขาจะถูก เปลี่ยนเส้นทางไปยังหน้าของบุคคลที่สามนั้น เพื่อดำเนินการชำระเงินให้เสร็จสิ้น
- เมื่อการทำรายการสำเร็จ พวกเขาจะถูก เปลี่ยนเส้นทางกลับ มายังหน้ายืนยันของ Immersive Experience
- ลิงก์ลึกและพารามิเตอร์: พารามิเตอร์การค้นหาจะถูกอ่านเฉพาะตอนโหลดครั้งแรกเท่านั้น หากคุณเปลี่ยน URL หลังจากที่แอปโหลดแล้ว ให้รีโหลดหน้าเว็บเพื่อให้พารามิเตอร์มีผล
พอร์ทัล
เครื่องมือการจองจะแสดงองค์ประกอบหลายอย่างในตำแหน่งคงที่บนหน้าจอ เช่น:
- โมดอล
- เคล็ดลับเครื่องมือ
- ปฏิทิน
- ตัวตรวจสอบอัตรา
- แบนเนอร์รถเข็นช็อปปิ้ง (บนมือถือ)
- ตัวเลือกภาษาและสกุลเงิน
องค์ประกอบเหล่านี้จะแสดงภายใน พอร์ทัล ซึ่งหมายความว่าแทนที่จะเป็นไปตามโครงสร้างของต้นไม้ DOM พวกมันจะถูกห่อหุ้มด้วยองค์ประกอบที่มีคลาสคงที่ .cb-portal และถูกเพิ่มไว้ที่ส่วนท้ายของ body พอร์ทัลเหล่านี้มีค่า z-index ที่แตกต่างกันตามชั้นที่สอดคล้องกันใน บริบทการซ้อนทับ ของเรา
เว็บไซต์ส่วนใหญ่มีบริบทการซ้อนทับของตัวเอง และขึ้นอยู่กับวิธีที่กำหนดบนแกน z เสมือน พวกมันอาจจะขัดแย้งหรือไม่ขัดแย้งกับบริบทการซ้อนทับของ Immersive Experience ก็ได้
ตัวอย่างเช่น หากไม่ได้กำหนดอย่างถูกต้อง ตัวตรวจสอบอัตราของ Immersive Experience อาจแสดงอยู่เหนือเมนูนำทางบนมือถือของเว็บไซต์ที่พัก หรือองค์ประกอบลอยบนเว็บไซต์ที่พักอาจแสดงอยู่เหนือปุ่ม “จองตอนนี้” ในแบนเนอร์รถเข็นช็อปปิ้งบนมือถือ ทำให้ปุ่มถูกบล็อกและผู้ใช้งานไม่สามารถดำเนินการจองต่อได้
ปัจจุบัน เรามีพอร์ทัล 4 ประเภท ได้แก่ โมดอล, ป๊อปโอเวอร์, สติกกี้ และ เคล็ดลับเครื่องมือ ประเภทของพอร์ทัลที่ใช้ในแต่ละกรณีขึ้นอยู่กับประเภทขององค์ประกอบที่พอร์ทัลนั้นใช้ ดังนั้น โมดอลทั้งหมดจะใช้พอร์ทัล โมดอล ปฏิทินป๊อปโอเวอร์และตัวเลือกภาษาและสกุลเงินจะใช้พอร์ทัล ป๊อปโอเวอร์ ส่วนแบนเนอร์รถเข็นช็อปปิ้งบนมือถือและตัวตรวจสอบอัตราจะใช้พอร์ทัล สติกกี้ เป็นต้น
ขึ้นอยู่กับประเภทของพอร์ทัล ค่า z-index ที่ Immersive Experience ใช้สำหรับคุณสมบัติ CSS มีดังนี้:
-
โมดอล:
1400 -
ป๊อปโอเวอร์:
1500 -
สติกกี้:
1100 -
เคล็ดลับเครื่องมือ:
1800
การแก้ไขปัญหาเรื่องการซ้อนทับขององค์ประกอบ
เมื่อเจอปัญหาองค์ประกอบที่แสดงโดย Immersive Experience ซ้อนทับกับองค์ประกอบอื่นจากเว็บไซต์หลัก เราแนะนำให้ค้นหาพอร์ทัล (องค์ประกอบที่มีคลาสคงที่ .cb-portal ) ที่บรรจุองค์ประกอบนั้นไว้ และปรับค่า z-index ให้เหมาะสม หรือปรับค่า z-index ขององค์ประกอบจากเว็บไซต์หลักแทน
ค่าของ z-index สำหรับประเภทต่าง ๆ ของพอร์ทัลที่แสดงผลโดย Immersive Experience สามารถปรับแต่งได้โดยการกำหนดตัวแปร CSS ใหม่ที่ใช้สำหรับวัตถุประสงค์นี้ ดังตัวอย่างด้านล่างนี้:
<style>
/* ขอบเขตไปยังรากของเครื่องมือการจองเมื่อทำการเขียนทับ */
.cb-bookingengine-root {
--booking-engine-zIndices-sticky: 1100;
--booking-engine-zIndices-modal: 1400;
--booking-engine-zIndices-popover: 1500;
--booking-engine-zIndices-tooltip: 1800;
}
</style>
เครื่องมือตรวจสอบอัตรา ถูกรวมไว้ในแพ็กเกจ Cloudbeds Booking Engine ทุกแพ็กเกจ ยกเว้นแผนระบบดั้งเดิม ที่พักที่ใช้แพ็กเกจที่ยังใช้งานอยู่สามารถเปิดใช้งานได้โดยไม่มีค่าใช้จ่ายเพิ่มเติมค่ะ
พารามิเตอร์การค้นหาและการติดตาม
Immersive Experience สามารถอ่านพารามิเตอร์การค้นหาที่รองรับได้เมื่อแอปพลิเคชันโหลดครั้งแรก และสามารถทำงานร่วมกับเครื่องมือการวิเคราะห์และโฆษณาบนพอร์ทัลได้ ใช้ส่วนอ้างอิงด้านล่างเมื่อคุณต้องการส่งค่าการค้นหา กำหนดค่าการติดตาม หรือทำความเข้าใจพารามิเตอร์ Google Hotel Ads ค่ะ
พารามิเตอร์การค้นหา
ประสบการณ์แบบอินเทอร์แอคทีฟรองรับพารามิเตอร์การค้นหาเดียวกับเวอร์ชันที่เจ้าของสถานที่เป็นผู้ดูแล พารามิเตอร์จะถูกอ่านเพียงครั้งเดียวเมื่อโหลดครั้งแรกและจะไม่อัปเดตแบบไดนามิกครับ
| ชื่อ | ประเภท | คำอธิบาย | ตัวอย่าง |
| adults | จำนวน | จำนวนผู้ใหญ่สำหรับการจอง ใช้เมื่อค้นหาที่พักที่มี | adults=2 |
| allotment_block_code | ข้อความ | รหัสบล็อกโควตาที่ใช้เมื่อดึงข้อมูลที่พักสำหรับวันที่เลือก | allotment_block_code=b123456 |
| checkin | ปี-เดือน-วัน (YYYY-MM-DD) | วันที่เช็กอินที่เลือก | checkin=2025-12-01 |
| checkout | ปี-เดือน-วัน (YYYY-MM-DD) | วันที่เช็กเอาต์ที่เลือก หากระบุ checkin แต่ไม่ระบุ checkout จะตั้งค่าเป็นวันถัดไปโดยอัตโนมัติ | checkout=2025-12-01 |
| currency | รหัสสกุลเงิน ISO-4217 3 ตัวอักษร | สกุลเงินที่เลือก หากไม่ระบุ เครื่องมือการจองจะใช้ค่าเริ่มต้นของที่พัก | currency=brl |
| เด็ก | จำนวน | จำนวนเด็กสำหรับการจอง ใช้เมื่อค้นหาที่พักที่มี | kids=1 |
| promo | ข้อความ | รหัสโปรโมชั่นที่ใช้เมื่อดึงข้อมูลที่พักสำหรับวันที่เช็คอินและวันที่เช็กเอาต์ที่เลือก | promo=superpromo |
| rate_plan | ข้อความแยกด้วยเครื่องหมายเซมิโคลอน | ใช้กรองผลลัพธ์ที่พักตามแผนราคา ซึ่งตรงกับ “ชื่อแผนราคาส่วนตัว” ใน PMS (ระบบบริหารจัดการที่พัก) | rate_plan=3DAYSTAY;LOWSEASON |
| rid | ข้อความตัวเลขแยกด้วยเครื่องหมายเซมิโคลอน | รายการรหัสห้องพักเพื่อกรองผลลัพธ์ที่พัก | rid=27434;23421 |
| room_type | ข้อความ 3 ตัวอักษรแยกด้วยเครื่องหมายเซมิโคลอน | ตรงกับ “ตัวย่อห้องพัก” ใน PMS และใช้กรองผลลัพธ์ที่พัก หากไม่มีวันที่เช็กอินและวันที่เช็กเอาต์ เครื่องมือการจองจะเลือกวันพรุ่งนี้และวันถัดไปโดยอัตโนมัติ | room_type=PRI;SHA |
| utm_source | ข้อความ | ใช้ระบุแหล่งที่มาของแคมเปญการตลาด (เช่น Google, TripAdvisor, Trivago) | utm_source=Google |
การติดตามและการวิเคราะห์
Immersive Experience รองรับพารามิเตอร์การค้นหาเหมือนกับเวอร์ชันที่โฮสต์ พารามิเตอร์จะถูกอ่านจากตำแหน่งของหน้าต่างเพียงครั้งเดียวตอนโหลดแอปพลิเคชันครั้งแรก ซึ่งหมายความว่าการเปลี่ยนแปลงพารามิเตอร์การค้นหาแบบไดนามิกจะไม่มีผลต่อ Immersive Experience หลังจากที่โหลดแล้ว
นอกจากนี้ Immersive Experience จะไม่อัปเดต URL ของหน้าต่างเหมือนกับเวอร์ชันที่โฮสต์หลังจากการกระทำของผู้ใช้งานบางอย่าง (เช่น การเลือกวันที่เช็กอินและวันที่เช็กเอาต์)
- Google Analytics 4 / GTM: ต้องตั้งค่า Google Tag ID หรือ GTM Container ID บนเว็บไซต์ของที่พัก
- Google Ads: การติดตาม Conversion ต้องตั้งค่าเองบนเว็บไซต์ของที่พัก
- Meta Pixel: ต้องเพิ่มสคริปต์ Meta Pixel ในส่วน <head> ของ HTML เพื่อเริ่มต้นใช้งาน
สำหรับรายละเอียดการกำหนดค่าเพิ่มเติม โปรดดูเอกสารของแต่ละแพลตฟอร์มการติดตาม
เพิ่มสคริปต์ Google Tag Manager (GTM) หรือ Google Analytics 4 (GA4) ด้วยตนเองในส่วน <head> ของ HTML ของคุณเพื่อเปิดใช้งานการติดตาม
พารามิเตอร์การค้นหาของ Google Hotel Ads
พารามิเตอร์เหล่านี้จะถูกแนบโดย Google Hotel Ads และเครื่องมือการจองจะส่งไปยังเซิร์ฟเวอร์ในคำขอเมื่อทำการจอง:
| พารามิเตอร์ |
| gha_advance_booking_window |
| gha_campaign_id |
| gha_google_site |
| gha_is_ad_click |
| gha_is_click_type_hotel |
| gha_is_click_type_room |
| gha_is_hotel_campaign |
| gha_is_promoted |
| gha_length |
| gha_payment_id |
| gha_price_displayed_total |
| gha_promo_code |
| gha_user_country |
| gha_user_currency |
| gha_user_device |
| gha_user_language |
| gha_user_list_id |
ปรับแต่ง Immersive Experience 2.0
ปรับแต่ง Immersive Experience โดยใช้คุณสมบัติของส่วนประกอบ รวมถึง CSS/JS ของคุณเองบนพอร์ทัลของคุณค่ะ
โค้ดที่ปรับแต่งเองอาจต้องได้รับการดูแลรักษาเป็นระยะเวลานาน
- เมื่อเครื่องมือการจองมีการพัฒนา การปรับแต่งที่คุณทำเองอาจหยุดทำงานหรือจำเป็นต้องมีการอัปเดตค่ะ
- เมื่อเป็นไปได้ ควรทดสอบการเปลี่ยนแปลงบนสำเนาทดสอบหรือร่างของพอร์ทัลก่อนที่จะเผยแพร่จริงนะคะ
คุณสมบัติของส่วนประกอบสำหรับ cb-immersive-experience และ cb-book-now-button
แอตทริบิวต์เหล่านี้ใช้ร่วมกันได้ทั้งในโหมด มาตรฐาน และ ป๊อบอัป (ดู การฝังเครื่องมือการจอง)
แอตทริบิวต์ต่อไปนี้ทั้งหมดเป็น ไม่บังคับ (ยกเว้น property-code) และทั้งส่วนประกอบเว็บ cb-immersive-experience และ cb-book-now-button รองรับแอตทริบิวต์เหล่านี้
| ชื่อ | ประเภท | จำเป็น | ค่าที่ตั้งไว้ | คำอธิบาย |
| สกุลเงิน (*) | รหัสสกุลเงิน ISO-4217 3 ตัวอักษร | ไม่ใช่ | สกุลเงินเริ่มต้นของที่พัก | สกุลเงินที่จะใช้สำหรับการโหลดเริ่มต้นของประสบการณ์เสมือนจริง (Immersive Experience) |
| disable-css-title-reset | yes | no | ไม่ใช่ | no | yes ควรใช้ถ้าที่พักต้องการกำหนดกฎ CSS ของตัวเองสำหรับหัวเรื่องใน UI (h1… h6) |
| hide-custom-header | yes | no | ไม่ใช่ | no | ใช้เพื่อซ่อนส่วนหัวที่กำหนดเองที่ตั้งไว้ใน PMS |
| hide-custom-footer | yes | no | ไม่ใช่ | no | ใช้เพื่อซ่อนส่วนท้ายที่กำหนดเองที่ตั้งไว้ใน PMS |
| hide-property-info | ใช่ | ไม่ใช่ | ไม่ใช่ | ไม่ใช่ | ใช้เพื่อซ่อนส่วนข้อมูลของที่พักในทุกหน้า |
| ignore-search-params (*) | ใช่ | ไม่ใช่ | ไม่ใช่ | ไม่ใช่ | Immersive Experience จะอ่านพารามิเตอร์ใน URL ของเว็บไซต์เจ้าของสถานที่โดยค่าเริ่มต้น และใช้พารามิเตอร์เหล่านั้นในการโหลดแอปพลิเคชันครั้งแรก รองรับพารามิเตอร์เดียวกับที่เครื่องมือการจองที่โฮสต์ไว้รองรับ |
| lang (*) | ตรวจจับอัตโนมัติ | รหัสภาษาระดับ 2 ตัว ISO 639-1 | ไม่ใช่ | ภาษามาตรฐานของที่พัก | ภาษาที่จะใช้ในการโหลด Immersive Experience ครั้งแรก หากไม่ได้ระบุไว้ Immersive Experience จะตรวจสอบแอตทริบิวต์ lang ของ HTML หากไม่ได้กำหนดเช่นกัน จะใช้ภาษามาตรฐานของที่พัก หากระบุค่าเป็นตรวจจับอัตโนมัติ Immersive Experience จะโหลดเป็นภาษาของเบราว์เซอร์ผู้ใช้งาน |
| mode | มาตรฐาน | ป๊อบอัป | ไม่ใช่ | มาตรฐาน | โหมดที่ใช้แสดง Immersive Experience ควรใช้โหมด ป๊อบอัป เมื่อ Immersive Experience ถูกแสดงภายในคอนเทนเนอร์ที่มีความสูงคงที่หรือความสูงสูงสุด |
| property-code (*) | รหัสตัวอักษรและตัวเลข 6 หลักที่ระบุที่พักของคุณ | ใช่ | ไม่สามารถใช้ได้ | รหัสตัวอักษรและตัวเลข 6 หลักที่แทนที่พัก ซึ่งเป็นรหัสเดียวกับที่ใช้ใน URL ของเครื่องมือการจอง: https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}. |
แอตทริบิวต์ที่ถูกกำหนดให้โหลดครั้งแรกจะถูกอ่านเพียงครั้งเดียวเมื่อแอปเริ่มทำงาน การเปลี่ยนแปลงแอตทริบิวต์เหล่านี้ในที่พักของคุณภายหลังจะไม่ส่งผลต่อประสบการณ์ Immersive ที่โหลดไปแล้ว
แอตทริบิวต์กำหนดเองของปุ่ม จองตอนนี้
ตัวเลือกเหล่านี้ใช้กับคอมโพเนนต์ cb-book-now-button (ดูที่ส่วน ฝังเครื่องมือการจอง) และช่วยให้คุณกำหนดสไตล์ปุ่ม รวมถึงควบคุมฉลากและขนาดของป๊อบอัปได้
| แอตทริบิวต์ | คำอธิบาย |
| class-name | คลาส CSS สำหรับกำหนดสไตล์ปุ่ม |
| close-label | ฉลากกำหนดเองสำหรับปุ่มปิด |
| height | ความสูงของป๊อบอัป |
| width | ความกว้างของป๊อบอัป |
ตัวอย่างปุ่ม จองตอนนี้ พร้อมฉลาก ขนาด และคลาส CSS:
<cb-book-now-button
property-code="{PROPERTY_CODE}"
class-name="cb-book-now-button"
label="จองตอนนี้"
height="90vh"
width="90vw"
/>
เพิ่ม CSS และ JavaScript กำหนดเองสำหรับ Immersive Experience
CSS หรือ JavaScript กำหนดเองที่เพิ่มในช่องปรับแต่งของเครื่องมือการจองจะไม่ถูกนำไปใช้กับ Immersive Experience โดยอัตโนมัติ คุณต้องเพิ่มด้วยตนเองในเอกสาร HTML
เพิ่มแอตทริบิวต์ data-cb-immersive-experience-root ในแท็ก style และ script เพื่อหลีกเลี่ยงความขัดแย้ง
ตัวอย่าง CSS กำหนดเอง:
<style data-cb-immersive-experience-root>
:is(#cb-bookingengine, .cb-bookingengine-root) {
h1 {
font-family: serif;
font-size: 24px;
}
}
</style>
ขั้นตอนถัดไป
หลังจากติดตั้งและทดสอบ Immersive Experience 2.0 บนโดเมนที่ได้รับอนุญาตของคุณแล้ว ให้รีวิวคำแนะนำใน แท็บฝังของ Cloudbeds Booking Engine เมื่อคุณต้องการเปรียบเทียบหรือกำหนดค่าตัวเลือกฝังอื่นๆ ครับ
ข้อคิดเห็น
โปรด ลงชื่อเข้าใช้ เพื่อแสดงข้อคิดเห็น