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

โฆษณาโรงแรมและลิงก์การจองแบบไม่เสียค่าใช้จ่ายมีลิงก์ไปยังหน้า 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 มีข้อมูลแบบไดนามิก เช่น หากผู้ใช้จองห้องพักโรงแรม #42 ไว้ 6 คืนตั้งแต่วันที่ 23/5/2023 เป็นต้นไป 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) ตัวระบุทางเลือกสําหรับที่พัก มีการระบุชื่อแอตทริบิวต์นี้ในฟีดข้อมูลโรงแรม การมีรหัสแยกต่างหากจะมีประโยชน์ในกรณีที่คุณต้องการตัวระบุที่พัก 1 รายการสำหรับข้อมูลฟีดและใช้ตัวระบุที่พักอีกตัวหนึ่งสำหรับเครื่องมือการจอง
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 ใช้พารามิเตอร์นี้และค่าของพารามิเตอร์นี้ในการระบุการเข้าชมที่มีการยืนยันอัตโนมัติของ Hotel Ads ได้
  • 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 ที่กำหนดให้กับ Google (เช่น "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 สร้างลิงก์สำหรับการทดสอบหรือการตรวจสอบอัตโนมัติ หาก Google สร้างลิงก์สำหรับการทดสอบหรือการตรวจสอบอัตโนมัติ มิเช่นนั้น Google จะเป็น true หากลิงก์ดังกล่าวจะเป็น 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) ดำเนินการ 1 ครั้งสำหรับองค์ประกอบ <Child "age"> แต่ละรายการในฟีดราคา เช่น หาก <OccupancyDetails> มีองค์ประกอบ 2 รายการ ได้แก่ <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 (การคลิก Hotel Ads และลิงก์การจองแบบไม่เสียค่าใช้จ่าย)

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

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า 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 รายการ นอกเหนือจากรายการตัวแปรที่ใช้ได้