ตัวแปรและเงื่อนไข

โฆษณาโรงแรมและลิงก์การจองแบบไม่เสียค่าใช้จ่ายมีลิงก์ไปยังหน้า Landing Page ที่ผู้ใช้ สามารถจองห้อง คุณกำหนดวิธีที่ Google สร้างลิงก์เพื่อรวม ข้อมูลเพิ่มเติมเกี่ยวกับผู้ใช้และแผนการเดินทางของผู้ใช้ ตัวอย่างเช่น คุณสามารถใส่ข้อมูล เช่น รหัสโรงแรม ภาษา รหัสสกุลเงิน และวันที่เช็คอินใน URL

ภาพรวม

คุณกำหนด URL ของหน้า Landing Page ในไฟล์หน้า Landing Page เมื่อโฆษณาหรือฟรี ลิงก์การจองปรากฏขึ้น ข้อมูลแบบไดนามิกใน URL จะถูกแทนที่ด้วย มูลค่าจริง หากต้องการเพิ่มค่าแบบไดนามิกใน URL ของหน้า Landing Page ให้ใช้ ไวยากรณ์ต่อไปนี้:

<URL>https://partner_url?param_id=(variable_name)</URL>

ตัวอย่างต่อไปนี้แสดง URL ที่ใช้ชื่อตัวแปรของ Google แทน รหัสโรงแรมและแผนการเดินทางจริง:

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

เมื่อมีการสร้างลิงก์หน้า Landing Page สำหรับหน้าผลการค้นหา Google แทนที่ตัวแปรด้วยค่าจริงเพื่อให้มั่นใจว่า URL จะมี ข้อมูลแบบไดนามิก เช่น หากผู้ใช้จองห้องพักสำหรับ 6 คืนตั้งแต่วันที่ 23/5/2023 สำหรับโรงแรม #42 Google จะแสดงลิงก์ก่อนหน้า ดังนี้

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

ค่าที่ Google กําหนดให้กับตัวแปรในสตริงการค้นหาจะขึ้นอยู่กับ ข้อมูลที่เกี่ยวข้องในฟีดราคาโรงแรม ฟีดข้อมูลโรงแรม และการตั้งค่าผู้ใช้

เช่น มีการกำหนดค่าของตัวแปร LENGTH ให้กับองค์ประกอบ <Nights> จากฟีดราคาของแผนการเดินทางที่เกี่ยวข้อง ในทำนองเดียวกัน ค่าของ ตัวแปร PARTNER-HOTEL-ID ได้รับการกำหนดในองค์ประกอบ <id> จากข้อมูลโรงแรม ฟีดที่ตรงกับเกณฑ์การค้นหาของผู้ใช้

ตัวแปรบางส่วนเป็นชุดย่อยขององค์ประกอบฟีดราคา ตัวอย่างเช่น พารามิเตอร์ ตัวแปร CHECKINDAY, CHECKINMONTH และ CHECKINYEAR จะดึงข้อมูลจากตัวแปร องค์ประกอบ <Checkin> เดี่ยวในฟีดราคา ระบบจะคํานวณตัวแปรอื่นๆ ตามภาษาของผู้ใช้และการตั้งค่าอื่นๆ ของไคลเอ็นต์

ดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งที่มาของค่าตัวแปรได้ที่ ภาพรวมราคาและ ข้อมูลโรงแรม

ตัวแปร URL

ตารางต่อไปนี้อธิบายตัวแปรที่คุณใช้เพื่อ สร้าง URL ของหน้า Landing Page

ตัวแปร แนะนำ/ไม่บังคับ คำอธิบาย
ADVANCE-BOOKING-WINDOW Optional จำนวนวันของการจองล่วงหน้าก่อนวันที่เช็คอินใน เขตเวลาของโรงแรม ณ เวลาที่จอง เช่น 36
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) ตัวระบุทางเลือกสําหรับที่พัก ชื่อแอตทริบิวต์นี้ ที่ระบุไว้ในฟีดข้อมูลโรงแรม การมีรหัสแยกต่างหากจะมีประโยชน์ในกรณีต่อไปนี้ คุณต้องมีตัวระบุพร็อพเพอร์ตี้รายการหนึ่ง สำหรับข้อมูลฟีดและตัวระบุอีกรายการ ตัวระบุที่พักสำหรับเครื่องมือการจองของคุณ
CAMPAIGN-ID Recommended รหัสของแคมเปญ Google Ads ที่ต้องการเชื่อมโยงกับ URL ค่านี้จะว่างเปล่าหากการคลิกไม่ได้เชื่อมโยงกับ Google Ads แคมเปญ
CHECKINDAY Recommended วันแบบ 2 หลักที่กำหนดไว้ในองค์ประกอบ <Checkin> ของฟีดราคาโรงแรม เช่น 20
CHECKINDAY-OF-WEEK Optional วันของสัปดาห์ — Monday ถึง Sunday ที่มีการเช็คอินในเขตเวลาของโรงแรม ตัวอย่างเช่น Tuesday
CHECKINMONTH Recommended เดือนแบบ 2 หลักที่กำหนดไว้ใน <Checkin> ขององค์ประกอบฟีดราคาโรงแรม เช่น 05
CHECKINYEAR Recommended ปีแบบ 4 หลักที่กำหนดไว้ใน <Checkin> ขององค์ประกอบฟีดราคาโรงแรม เช่น 2023
CHECKOUTDAY Recommended วันแบบ 2 หลักที่คำนวณจาก <Nights> และ องค์ประกอบ <Checkin> ของฟีดราคาโรงแรม สำหรับ ตัวอย่างเช่น 26
CHECKOUTMONTH Recommended เดือนแบบ 2 หลักที่คำนวณจาก <Nights> และองค์ประกอบ <Checkin> ของฟีดราคาโรงแรม สำหรับ ตัวอย่างเช่น 05
CHECKOUTYEAR Recommended ปีแบบ 4 หลักที่คำนวณจาก <Nights> และองค์ประกอบ <Checkin> ของฟีดราคาโรงแรม สำหรับ ตัวอย่างเช่น 2023
CHILD-AGE Recommended (must be provided for child occupancy pricing) อายุสูงสุดของเด็กแต่ละคนตามที่ระบุไว้ใน <Child "age"> ของฟีดราคา ตัวแปรนี้ต้องใช้ร่วมกับ บล็อกแบบมีเงื่อนไข FOR-EACH-CHILD-AGE รายการ
CHILD-INDEX Optional ตัวแปรวนซ้ำที่จัดทำดัชนี 0 แสดงตัวนับสำหรับเด็กแต่ละคน ผู้เข้าพักและอายุของเด็กที่ระบุไว้ในแผนการเดินทาง ขณะที่ไม่ใช่ จำเป็น ตัวแปรนี้สามารถใช้ร่วมกับ บล็อกแบบมีเงื่อนไข FOR-EACH-CHILD-AGE รายการ
CLICK-TYPE Optional ระบุว่าผู้ใช้คลิกข้อมูลของโรงแรมมาตรฐานหรือไม่ หรือสำหรับแพ็กเกจห้องพัก โดยค่าที่เป็นไปได้มีดังนี้
  • hotel: ผู้ใช้คลิกข้อมูลมาตรฐาน ราคาห้องพัก
  • room: ผู้ใช้คลิกข้อมูลของห้อง กลุ่ม
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) รายการรหัสกฎเกี่ยวกับอัตราที่คั่นด้วยคอมมาสำหรับราคาที่ ไม่พร้อมใช้งาน แต่อาจใช้ได้หากผู้ใช้ได้ การเอาผิดเล็กน้อย โปรดทราบว่ารหัสกฎเกี่ยวกับอัตราสำหรับ อัตราส่วนลดเฉพาะบุคคล จะเติมข้อมูลที่นี่เสมอเมื่อตัวเลือก UI ที่เกี่ยวข้องปรากฏ แก่ผู้ใช้ได้
CUSTOM[1-5] Optional ค่าสำหรับช่องที่กำหนดเองซึ่งระบุไว้ใน <Result> ที่มีจำนวนอักขระสูงสุด 200 ตัวต่อช่องที่กำหนดเอง สำหรับข้อมูลเพิ่มเติม ข้อมูลที่อ้างถึง ภาพรวม ของข้อความ Transaction ช่องที่กำหนดเองจะใช้ไม่ได้เมื่อใช้ ARI
DATE-TYPE Optional ระบุว่าผู้ใช้เลือกวันที่เริ่มต้นหรือ วันที่ที่ระบุในการค้นหา โดยค่าที่เป็นไปได้มีดังนี้
  • default: ผู้ใช้คลิกโฆษณาโรงแรมหรือคลิกฟรี ลิงก์การจองที่ใช้วันที่เริ่มต้น
  • selected: ผู้ใช้คลิกโฆษณาโรงแรมหรือคลิกฟรี ลิงก์การจองที่มีการกำหนดวันที่ไว้
GOOGLE-SITE Optional ผลิตภัณฑ์และบริการของ Google ที่ผู้ใช้ดูข้อมูลราคาโรงแรม โดยค่าที่เป็นไปได้มีดังนี้
  • localuniversal: ผู้ใช้พบลิงก์การจองโรงแรม ผ่านการค้นหา google.com
  • mapresults: ผู้ใช้พบลิงก์การจองโรงแรม จนถึงวันที่ maps.google.com
  • verification: Google ใช้ค่านี้เมื่อดำเนินการ การทดสอบคุณภาพของข้อมูลในเว็บไซต์โดยอัตโนมัติ โดยระบบจะไม่เรียกเก็บเงินจากคุณสำหรับการค้นหาเหล่านี้ Google Analytics ใช้พารามิเตอร์นี้และค่าของพารามิเตอร์ในการระบุ การเข้าชมสำหรับการยืนยันโดยอัตโนมัติของโฆษณาโรงแรม
  • unknown: ผู้ใช้พบโฆษณาหรือลิงก์การจองแบบไม่เสียค่าใช้จ่าย ผ่านแหล่งที่มาที่ไม่ได้กำหนด
LENGTH Recommended ระยะเวลาในการเข้าพักตามจำนวนคืนที่กำหนดโดย องค์ประกอบ <Nights> ในฟีดราคาโรงแรม สำหรับ ตัวอย่างเช่น 3
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) จำนวนผู้ใหญ่ที่เข้าพักซึ่งผู้ใช้ระบุไว้สำหรับแผนการเดินทาง ตัวแปรนี้ต้องใช้ร่วมกับ NUM-CHILDREN, FOR-EACH-CHILD-AGE หรือทั้ง 2 อย่าง
NUM-CHILDREN Recommended จำนวนเด็กที่เข้าพัก (อายุ 0-17 ปี) ที่ระบุไว้ใน แผนการเดินทางของผู้ใช้ NUM-CHILDREN, ต้องระบุ FOR-EACH-CHILD-AGE หรือทั้ง 2 อย่างเพื่อ เข้าร่วมแผนการเดินทางกับเด็กที่เข้าพัก
NUM-GUESTS Recommended (if you don't send child occupancy pricing) จำนวนผู้เข้าพักทั้งหมด ทั้งผู้ใหญ่และเด็ก ที่ระบุไว้สำหรับ แผนการเดินทางของผู้ใช้ ค่านี้คือผลรวมของ ค่า NUM-ADULTS และ NUM-CHILDREN ถึง เพื่อให้ได้รับการมีส่วนร่วมสูงสุด เราขอแนะนำอย่างยิ่งให้ใช้ทั้ง NUM-ADULTS และ NUM-CHILDREN แทน
PACKAGE-ID Recommended (applies if you use Room Bundles) ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจในฟีดราคาโรงแรม สำหรับ แพ็กเกจมาตรฐาน รหัสแพ็กเกจคือค่าของฟิลด์ องค์ประกอบ <PackageID> ภายใน <Result> บล็อก รหัสแพ็กเกจสำหรับแพ็กเกจห้องพักคือค่าของแอตทริบิวต์ องค์ประกอบ <PackageID> ภายในองค์ประกอบ บล็อก <RoomBundle> หรือ <PackageData> ของข้อความ Transaction
PARTNER-CURRENCY Optional รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดโดย แอตทริบิวต์ currency ขององค์ประกอบ <Baserate> ในฟีดราคาโรงแรม เช่น USD หรือ CAD
PARTNER-HOTEL-ID Recommended ตัวระบุที่ไม่ซ้ำกันสำหรับโรงแรมที่กำหนดโดย องค์ประกอบ <id> ในฟีดข้อมูลโรงแรม
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพักในฟีดราคาโรงแรม สำหรับ ห้องมาตรฐาน รหัสห้องคือค่าของ องค์ประกอบ <RoomID> ภายใน <Result> บล็อก รหัสห้องพักสำหรับแพ็กเกจห้องพักคือค่าที่กำหนดให้ องค์ประกอบ <RoomID> ภายในองค์ประกอบ บล็อก <RoomBundle> หรือ <RoomData> ในข้อความ Transaction
PAYMENT-ID Optional (only applies to Ads) เปลี่ยนเป็นสตริงที่กำหนดไว้ล่วงหน้า commission หรือ หมายเลข IATA ที่กำหนด (เช่น "01234567") หากคุณใช้ค่าคอมมิชชัน หน่วยงานเรียกเก็บเงิน หากต้องการเปลี่ยนการจัดรูปแบบหมายเลข IATA หรือ สตริงที่กำหนดไว้ล่วงหน้า โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM)
PRICE-DISPLAYED-TAX (Optional) จำนวนภาษีที่แสดงต่อผู้ใช้ในสกุลเงินท้องถิ่นของผู้ใช้ ค่าของ PRICE-DISPLAYED-TAX คือค่าของแอตทริบิวต์ องค์ประกอบ <Tax> ในฟีดราคาโรงแรม ตัวอย่างเช่น "3.14"
PRICE-DISPLAYED-TOTAL (Optional) ค่าใช้จ่ายรวมของห้องที่แสดงต่อผู้ใช้ใน สกุลเงินท้องถิ่น ค่าของ PRICE-DISPLAYED-TOTAL คือค่า ผลรวมของ <Baserate>, <Tax> และ <OtherFees> องค์ประกอบจากฟีดราคาโรงแรม เช่น "152.13"
PROMO-CODE (Optional)

หากคุณใช้ ARI โปรโมชัน ระบบจะกำหนดค่าของตัวแปรนี้ให้กับแอตทริบิวต์ id ของ <Promotion> ที่ใช้ ถ้า มีการใช้โปรโมชันหลายรายการ ซึ่งเป็นรายการที่คั่นด้วยคอมมาของ รหัสโปรโมชันตามลำดับที่กำหนดเอง

หากคุณใช้ กฎเกี่ยวกับอัตรา ระบบจะกำหนดค่าของตัวแปรนี้ให้กับองค์ประกอบ PromoCode หากใช้กฎเกี่ยวกับอัตราที่เกี่ยวข้อง
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) รหัสตามที่กำหนดโดยองค์ประกอบ <RatePlanID> ในไฟล์ การบล็อก <RoomBundle> ของฟีดราคา <RatePlanID> แสดงถึงตัวระบุที่ไม่ซ้ำกัน สำหรับชุดค่าผสมของข้อมูลห้องพักและแพ็กเกจ สำหรับข้อมูลเพิ่มเติม โปรดดูข้อมูลเพิ่มเติมที่ แพ็กเกจห้องพัก
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) รหัสตามที่กำหนดโดยแอตทริบิวต์ rate_rule_id ภายใน การบล็อก <Rate> ของฟีดราคา สำหรับข้อมูลเพิ่มเติม อ้างอิงถึง ราคาสำหรับลูกค้าที่เข้าเกณฑ์

หมายเหตุ: เฉพาะราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคลเท่านั้น ที่ไม่ได้ซ่อนจะแสดงขึ้นมา
USER-COUNTRY Recommended ตัวอักษร 2 ตัว รหัสประเทศที่ระบุสถานที่ตั้งของผู้ใช้ ช่วงเวลานี้ จะดึงมาจากการตั้งค่าไคลเอ็นต์ของผู้ใช้ สำหรับ ตัวอย่างเช่น US หรือ FR
USER-CURRENCY Recommended รหัสสกุลเงิน 3 ตัวอักษรที่ระบุสกุลเงินท้องถิ่นของผู้ใช้ สกุลเงิน ค่าของตัวแปร USER-CURRENCY คือ อนุมานจากการตั้งค่าไคลเอ็นต์ของผู้ใช้ เช่น USD หรือ CAD
USER-DEVICE Recommended ประเภทอุปกรณ์ของผู้ใช้ ค่าของ USER-DEVICE สามารถ เป็นอย่างใดอย่างหนึ่งต่อไปนี้
  • mobile
  • tablet
  • desktop
  • unknown

ค่าของตัวแปร USER-DEVICE จะอนุมานจาก การตั้งค่าไคลเอ็นต์ของผู้ใช้
USER-LANGUAGE Recommended ตัวอักษร 2 ตัว รหัสภาษา ISO 639-1 ที่ระบุภาษาที่แสดงของ โฆษณาหรือลิงก์การจองแบบไม่เสียค่าใช้จ่าย ค่าของ USER-LANGUAGE จะอนุมานจากการตั้งค่าไคลเอ็นต์ของผู้ใช้ ตัวอย่างเช่น en หรือ fr
USER-LIST-ID (กำหนดไว้ใน Google Ads) Optional (only applies if you use Audience Lists in Google Ads) รหัสรายชื่อผู้ใช้ Google Ads ที่มีรายการกลุ่มเป้าหมายหรือผู้ใช้ ระบบใช้รายการกลุ่มเป้าหมายเป็นพื้นฐานสำหรับ การตั้งราคาเสนอ การปรับเปลี่ยน หากผู้ใช้เป็นส่วนหนึ่งของรายการกลุ่มเป้าหมายหลายรายการ มีการเลือกรายการกลุ่มเป้าหมายที่มีการปรับราคาเสนอมากที่สุดไว้ ความเสมอภาคระหว่าง กลุ่มเป้าหมายที่มีการปรับราคาเสนอมากที่สุดจะได้รับการตัดสินใจแบบสุ่ม
VERIFICATION Optional บูลีนที่ยืนยันว่า Google สร้างลิงก์สำหรับ การทดสอบหรือการตรวจสอบอัตโนมัติ หากลิงก์สร้างขึ้นจะเป็น true Google สำหรับการทดสอบหรือการตรวจสอบอัตโนมัติ ไม่เช่นนั้นจะเป็น false

ตรรกะแบบมีเงื่อนไขใน URL

คุณใช้คำสั่งพิเศษในองค์ประกอบ <URL> ของไฟล์หน้า Landing Page เพื่อทำสิ่งต่อไปนี้ได้ สร้างปลายทางอย่างมีเงื่อนไข

ตรรกะแบบมีเงื่อนไขรองรับคำสั่งต่อไปนี้

  • if_statement: หากเป็น true ค่าที่เป็นไปตามพารามิเตอร์นี้ ระบบจะแทรกเงื่อนไขใน URL หรือมิฉะนั้นค่าที่ตามหลัง แทรกคำสั่ง ELSE แล้ว

  • for_statement: สร้างเงื่อนไขวนซ้ำ FOR ที่ทำซ้ำ เกี่ยวกับจำนวนค่าที่ระบุ

โดยคำสั่ง IF และ FOR มีดังนี้

เงื่อนไข แนะนำ/ไม่บังคับ คำอธิบาย
IF-AD-CLICK (Hotel Ads เท่านั้น) Optional เปลี่ยนเป็น true หากการคลิกของผู้ใช้มาจากโฆษณา เปลี่ยนเป็น false หากการคลิกของผู้ใช้มาจาก ลิงก์การจอง
IF-CLICK-TYPE-HOTEL Optional เปลี่ยนเป็น true หากผู้ใช้คลิกข้อมูลสำหรับ หรือเปลี่ยนเป็น false
IF-CLICK-TYPE-ROOM Optional เปลี่ยนเป็น true หาก ผู้ใช้คลิกรายชื่อสำหรับ แพ็กเกจห้องพัก มิเช่นนั้นให้เปลี่ยนเป็น false
IF-CLOSE-RATE-RULE-IDS Optional เปลี่ยนเป็น true หากราคาสำหรับลูกค้าที่เข้าเกณฑ์อย่างน้อย 1 รายการเดิมคือ ไม่พร้อมใช้งานเนื่องจากผู้ใช้ไม่มีสิทธิ์ มิเช่นนั้นให้เปลี่ยนเป็น false โดยค่าเริ่มต้น ค่าจะเป็น trueหาก อัตราส่วนลดเฉพาะบุคคล ตัวเลือก UI แสดงต่อผู้ใช้
IF-DEFAULT-RATE Optional เปลี่ยนเป็น true หากผู้ใช้คลิกข้อมูลโรงแรม ที่ใช้วันที่เริ่มต้น มิเช่นนั้น จะเปลี่ยนเป็น false
IF-HOTEL-CAMPAIGN Optional เปลี่ยนเป็น true หากการคลิกของผู้ใช้มาจาก แคมเปญโรงแรม มิเช่นนั้นให้เปลี่ยนเป็น false ช่วงเวลานี้ ความแตกต่างนั้นมีประโยชน์สำหรับพาร์ทเนอร์ที่มีแคมเปญหลายประเภท อยู่ใน Google Ads เพื่อจัดสรรการระบุแหล่งที่มา
IF-PAYMENT-ID (Hotel Ads เท่านั้น) Recommended (if you use pay-per-stay Google Ads campaigns) เปลี่ยนเป็น true สำหรับโรงแรมที่จ่ายต่อการเข้าพัก (PPS) หากเป็นกรณีอื่น โปรแกรมค่าคอมมิชชันจะเปลี่ยนเป็น false
IF-PROMO-CODE Optional เปลี่ยนเป็น true หากผู้ใช้คลิกอัตราที่ อิงตามโปรโมชัน ARI หรือกฎเกี่ยวกับอัตราที่มี PromoCode ที่ระบุ มิเช่นนั้นให้เปลี่ยนเป็น false
IF-PROMOTED (Hotel Ads เท่านั้น) Recommended (if you use Promoted hotels) เปลี่ยนเป็น true หากผู้ใช้คลิกพร็อพเพอร์ตี้ โฆษณาโปรโมชัน หรือเปลี่ยนเป็น false
IF-RATE-RULE-ID Optional เปลี่ยนเป็น true หากผู้ใช้เลือก ราคาสำหรับลูกค้าที่เข้าเกณฑ์ มิเช่นนั้นให้เปลี่ยนเป็น false
IF-USER-LIST-ID (กำหนดไว้ใน Google Ads) Optional เปลี่ยนเป็น true หากผู้ใช้เป็นสมาชิกของ Google Ads รหัสรายชื่อลูกค้าที่คุณระบุเมื่อตั้งค่าตัวคูณราคาเสนอสำหรับกลุ่มเป้าหมาย มิเช่นนั้นให้เปลี่ยนเป็น false
IF-VERIFICATION Optional เปลี่ยนเป็น true หาก Google สร้างลิงก์สำหรับ หรือการทดสอบอัตโนมัติ หรือเปลี่ยนเป็น false
ELSE Recommended (if you use any conditional IF statements) หากไม่เป็นไปตามเงื่อนไขก่อนหน้า ค่าที่เป็นไปตามเงื่อนไขนี้ ระบบจะแทรกเงื่อนไขใน URL
END-IF Optional (required if you have any IF conditional statements) สิ้นสุดบล็อกแบบมีเงื่อนไขของคำสั่ง IF
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) ดำเนินการครั้งเดียวสำหรับแต่ละรายการ <Child "age"> ในฟีดราคา สำหรับ ตัวอย่างเช่น ถ้า <OccupancyDetails> มี <Child age="17"> และ <Child age= "17"> คำสั่งจะทำงาน 2 ครั้ง
END-FOR-EACH Optional (required if using FOR-EACH block) สิ้นสุดบล็อกแบบมีเงื่อนไขของคำสั่ง FOR-EACH

ตัวอย่าง IF-AD-CLICK

คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้คลิกโฆษณาหรือ ลิงก์การจองแบบไม่เสียค่าใช้จ่ายเพื่อเปลี่ยนเส้นทางไปยังหน้า Landing Page

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

ในตัวอย่างนี้ หากผู้ใช้ไม่ได้คลิกโฆษณา ผลลัพธ์จะเป็นดังนี้ URL

https://www.partner.com?hid=123&adType=0

หากผู้ใช้คลิกโฆษณา ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hid=123&adType=1

ตัวอย่าง IF-CLICK-TYPE-HOTEL

คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้เลือกโรงแรมหรือไม่ โดยไม่มีแพ็กเกจห้องพักที่ชัดเจน ค่าขององค์ประกอบ <RatePlanID> ในค่า บล็อก <Room Bundle> ของข้อความ Transaction จะได้รับการตั้งค่าโดยปริยาย ราคาแพ็กเกจห้องพักที่เกี่ยวข้องที่ผู้ใช้เลือก

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

ในตัวอย่างนี้ หากผู้ใช้เลือกแพ็กเกจห้องพัก ผลลัพธ์จะเป็นดังนี้ URL

https://partner.com/landing_room?hid=123

หากผู้ใช้ไม่ได้เลือกแพ็กเกจห้องพัก ผลลัพธ์จะเป็น URL ต่อไปนี้

https://partner.com/landing?hid=123

ตัวอย่าง IF-CLICK-TYPE-ROOM

คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้เลือกห้องหรือไม่ กลุ่ม

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

ในตัวอย่างนี้ หากผู้ใช้ไม่ได้เลือกแพ็กเกจห้องพัก ผลลัพธ์จะเป็น URL ต่อไปนี้

https://partner.com/landing?hid=123

หากผู้ใช้เลือกแพ็กเกจห้องพัก ผลลัพธ์จะเป็น URL ต่อไปนี้

https://partner.com/landing_room?hid=123

ตัวอย่าง IF-DEFAULT-DATE

ใช้คำสั่ง IF-DEFAULT-DATE แบบมีเงื่อนไขเพื่อตั้งค่าพารามิเตอร์ที่ไม่ใช่วันที่ที่ แล้วเว็บไซต์จะสามารถเรียกใช้ลักษณะการทํางานที่กําหนดเองได้หากผู้ใช้ไม่ได้เลือก วันที่

ตัวอย่างต่อไปนี้จะตรวจสอบว่ามีการใช้วันที่เริ่มต้นหรือไม่

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

ในตัวอย่างนี้ หากผู้ใช้ไม่ได้เลือกวันที่ ผลลัพธ์อาจคล้ายกัน ไปยัง URL ต่อไปนี้ที่แสดงการเลือกวันที่เริ่มต้น

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

หากผู้ใช้เลือกวันที่ ผลลัพธ์อาจคล้ายกับ URL ต่อไปนี้ ตามแผนการเดินทางที่เลือก

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

ตัวอย่าง IF-HOTEL-CAMPAIGN (การคลิกโฆษณาโรงแรมและลิงก์การจองแบบไม่เสียค่าใช้จ่าย)

คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้คลิกโฆษณาที่ มาจากแคมเปญโรงแรม

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

ในตัวอย่างนี้ หากผู้ใช้คลิก URL ของแคมเปญโรงแรม ผลลัพธ์จะเป็น URL ต่อไปนี้:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

หากไม่ได้คลิก URL ของแคมเปญโรงแรม (เช่น แคมเปญในเครือข่าย Search ปกติ) ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hotelID=123&utm_campaign=87654321

ซึ่งจะมีประโยชน์เมื่อคุณต้องการแยกความแตกต่างของการเข้าชมการคลิกแคมเปญโรงแรม จากคลิกอื่นๆ ทั้งหมด

CAMPAIGN-ID ว่างเปล่าซึ่งมีการคลิก FBL

หากการคลิกมาจากลิงก์การจองแบบไม่เสียค่าใช้จ่าย IF-HOTEL-CAMPAIGN จะกลับมา ค่า TRUE และ CAMPAIGN-ID ได้รับการตั้งค่าให้ว่างดังที่แสดงใน URL ต่อไปนี้:

https://www.partner.com?hotelID=123&hotel_campaign=

คุณสามารถใช้คำสั่งแบบมีเงื่อนไขของ IF-AD-CLICK เพื่อป้องกันไม่ให้รหัสแคมเปญว่างเปล่า เนื่องจาก ที่แสดงในตัวอย่างต่อไปนี้

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

ตัวอย่าง IF-PAYMENT-ID (Hotel Ads เท่านั้น)

ใช้คำสั่ง IF-PAYMENT-ID แบบมีเงื่อนไขเพื่อทำให้ URL แตกต่างกันโดยขึ้นอยู่กับว่า จากโปรแกรมค่าคอมมิชชัน PPS หรือไม่ ตัวอย่างด้านล่าง ตรวจสอบว่าการคลิกมาจากโปรแกรมค่าคอมมิชชัน PPS หรือไม่ และกำหนดมูลค่าให้กับ พารามิเตอร์ booking_source ตามผลลัพธ์:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

หากโรงแรมเป็นส่วนหนึ่งของโปรแกรมค่าคอมมิชชัน ผลลัพธ์จะเป็นหนึ่งใน URL ต่อไปนี้

  • หากไม่ได้กำหนดหมายเลข IATA ให้กับ Google
    https://partner.com?hid=123&amp;booking_source=commissions
  • หากกำหนดหมายเลข IATA ให้กับ Google
    https://partner.com?hid=123&amp;booking_source=01234567

หากไม่ใช่ ผลลัพธ์จะเป็น URL ต่อไปนี้

https://partner.com?hid=123&booking_source=cpc

ตัวอย่าง IF-PROMOTED (Hotel Ads เท่านั้น)

คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้คลิก โฆษณาโปรโมชันที่พัก

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

ในตัวอย่างนี้ หากผู้ใช้เลือกโฆษณาโปรโมชันที่พัก ผลลัพธ์ คือ URL ต่อไปนี้

https://partner.com/1?hid=123

หากผู้ใช้ไม่ได้เลือกโฆษณาโปรโมชันที่พัก ผลลัพธ์จะเป็น URL ต่อไปนี้:

https://partner.com/0?hid=123

ตัวอย่าง IF-RATE-RULE-ID

คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้เลือก ราคาสำหรับลูกค้าที่เข้าเกณฑ์ หากเป็นเช่นนั้น ค่าของ <RateRuleID> ในบล็อก <Rate> ของข้อความธุรกรรมจะถูกนำมาใช้

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

ในตัวอย่างนี้ หากผู้ใช้ไม่ได้เลือกราคาสำหรับลูกค้าที่เข้าเกณฑ์ ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hid=123

หากผู้ใช้เลือกราคาสำหรับลูกค้าที่เข้าเกณฑ์ ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hid=123&customerType=42

ตัวอย่าง IF-USER-LIST-ID (กำหนดไว้ใน Google Ads)

หากคุณตั้งค่าตัวคูณราคาเสนอสำหรับรายการกลุ่มเป้าหมายในแคมเปญโรงแรมใน Google Ads คุณสามารถใช้ IF-USER-LIST-ID ร่วมกับ USER-LIST-ID เพื่อตั้งค่า บนเว็บไซต์สำหรับลูกค้าที่อยู่ใน Google Ads บางรายการ รายการกลุ่มเป้าหมาย ซึ่งคุณอาจต้องดำเนินการดังกล่าวเพื่อวัตถุประสงค์ในการติดตาม หรือเพื่อปรับแต่ง เว็บไซต์สำหรับสมาชิกของรายการกลุ่มเป้าหมาย

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

ในตัวอย่างนี้ หากผู้ใช้ไม่ได้เป็นสมาชิกของรายการกลุ่มเป้าหมาย ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hid=123

หากผู้ใช้เป็นสมาชิกของรายการกลุ่มเป้าหมาย 12345678 ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hid=123&audience_list=12345678

ตัวอย่าง IF-VERIFICATION

หากคุณต้องการตรวจสอบว่า Google สร้าง URL สำหรับการทดสอบหรือเป็นแบบอัตโนมัติ คุณสามารถใช้ IF-VERIFICATION ได้

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

ในตัวอย่างนี้ หาก Google ไม่ได้สร้าง URL สำหรับการทดสอบหรือการตรวจสอบ ผลลัพธ์จะเป็น URL ต่อไปนี้

https://www.partner.com?hid=123

หาก Google สร้าง URL สำหรับการทดสอบหรือการตรวจสอบ ผลลัพธ์จะเป็น URL ต่อไปนี้:

https://www.partner.com?hid=123&isgoogle=true

ตัวอย่าง FOR-EACH-CHILD-AGE

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

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

ในตัวอย่างนี้ หากแผนการเดินทางมีผู้ใหญ่ 2 คนและเด็ก 2 คนที่มีอายุ 0 และ 17 ปี ผลลัพธ์จะเป็น URL ต่อไปนี้ตามลำดับ

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

หากแผนการเดินทางมีผู้ใหญ่ 2 คนและเด็ก 0 คน ผลลัพธ์จะเป็นดังนี้ URL

https://www.partner.com?adults=2&children=0&hid=123

กฎทั่วไปเมื่อสร้าง URL

ตัวแปรทั้งหมดเป็นค่าที่ไม่บังคับ คุณไม่จำเป็นต้องแทรกตัวแปรใน URL ของหน้า Landing Page อย่างไรก็ตาม การใช้ตัวแปรเพื่อส่งแผนการเดินทางและผู้ใช้ จะให้ประสบการณ์การใช้งานที่ดีกว่าสำหรับผู้ใช้ และช่วยให้คุณ เป็นไปตามนโยบายของ Google

กฎทั่วไปต่อไปนี้จะมีผลเมื่อกำหนด URL ที่สร้างขึ้นในหน้า Landing Page ไฟล์ของหน้า:

  • ตัวแปรทั้งหมดจะอยู่ในวงเล็บเปิดและปิด

  • พารามิเตอร์สตริงการค้นหาจะส่งตามหลังเครื่องหมายคำถาม ("?") ได้เท่านั้น ใน URL

  • พารามิเตอร์สตริงการค้นหาต้องคั่นด้วยเครื่องหมาย "และ" ("&") ในพารามิเตอร์ เอาต์พุตสุดท้าย เนื่องจากเครื่องหมายแอมเพอร์แซนด์เป็นอักขระพิเศษใน XML และแท็ก ในรูปแบบไฟล์ของหน้า Landing Page คือ XML ดังนั้นคุณต้องใช้เอนทิตีที่เข้ารหัส "&amp;" แทน เอาต์พุตสุดท้ายจะแสดงเครื่องหมาย "&" จริง อักขระ เช่น

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>

<!-- Do NOT do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>

    นอกจากนี้ คุณต้องเข้ารหัส URL สำหรับอักขระพิเศษที่อาจรวมอยู่ใน URL ของหน้า Landing Page เช่น

    • เว้นวรรค (" "): แทนที่อักขระเว้นวรรคด้วย "%20;" ในองค์ประกอบ <URL>
    • เครื่องหมายทับ ("/"): แทนที่เครื่องหมายทับด้วย "%2F;" ในช่วง<URL> องค์ประกอบ

    อักขระที่ไม่ใช่ตัวอักษรบางตัวไม่ต้องเข้ารหัส URL ตัวอย่างเช่น ขีดกลางสั้น ("-") ไม่จำเป็นต้องเข้ารหัส URL สำหรับรายการที่ใช้บ่อย อักขระที่ต้องมีการเข้ารหัส URL โปรดดู ตารางการเข้ารหัส URL

  • ค่าสำหรับพารามิเตอร์เดียวจะสร้างขึ้นจากตัวแปรหลายรายการได้ ตัวอย่างต่อไปนี้สร้างพารามิเตอร์เดี่ยว checkinDate จาก ตัวแปร CHECKINDAY,CHECKINMONTH และ CHECKINYEAR:

    <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

    ตัวอย่างนี้ทำให้เกิด URL ที่อาจมีลักษณะดังต่อไปนี้

    https://www.partnerdomain.com?checkinDate=7/23/1971

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

  • คุณสามารถใช้ตัวแปรที่กำหนดเองได้สูงสุด 5 รายการนอกเหนือจากรายการ ตัวแปร