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

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

ภาพรวม

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

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

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

ตัวอย่างที่ 1

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

ตัวอย่างที่ 2

<URL>https://www.partnerdomain.com/hotel/(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) ตัวระบุทางเลือกสําหรับที่พัก ชื่อแอตทริบิวต์นี้ระบุไว้ในฟีดข้อมูลโรงแรม การมีรหัสแยกต่างหากจะเป็นประโยชน์ในกรณีที่คุณต้องใช้ตัวระบุที่พักตัวหนึ่งสำหรับข้อมูลฟีดและใช้ตัวระบุที่พักอีกตัวหนึ่งสำหรับระบบการจอง
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-ADS-CLICK-SOURCE Optional ระบุว่า Google Ads เป็นแหล่งที่มาของการคลิก โดยค่าที่เป็นไปได้มีดังนี้
  • bl: ลิงก์การจองแบบชำระเงิน
  • tpa: โฆษณาโปรโมชันการท่องเที่ยว
  • tfsa: ฟีดการเดินทางในโฆษณา Search
  • pm: แคมเปญ Performance Max หรือ Performance Max สำหรับเป้าหมายการท่องเที่ยว

    • หมายเหตุ: หากการคลิกมาจาก พารามิเตอร์นี้ว่างเปล่าสำหรับ Google Search ไม่ใช่ Google Ads
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 สร้างลิงก์สำหรับการทดสอบหรือการตรวจสอบอัตโนมัติ ค่าจะเป็น 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

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

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

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;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 รายการนอกเหนือจากรายการตัวแปรที่ใช้ได้