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

Hotel Ads และลิงก์การจองแบบไม่เสียค่าใช้จ่ายมีลิงก์ไปยังหน้า 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 ใช้พารามิเตอร์นี้และค่าของพารามิเตอร์นี้สำหรับระบุการเข้าชมที่มีการยืนยันอัตโนมัติของ 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 รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรที่ระบุภาษาที่แสดงของโฆษณาหรือลิงก์การจองแบบไม่เสียค่าใช้จ่าย ระบบจะอนุมานค่าของตัวแปร 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> มี 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 (การคลิกโฆษณาโรงแรมและลิงก์การจองแบบไม่เสียค่าใช้จ่าย)

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

ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า 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

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

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