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

โฆษณาโรงแรมและลิงก์การจองแบบไม่เสียค่าใช้จ่ายมีลิงก์ไปยังหน้า 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

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

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

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

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

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

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

ตัวอย่าง 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&booking_source=commissions

• หากกำหนดหมายเลข IATA ให้กับ Google

  https://partner.com?hid=123&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 ดังนั้นคุณต้องใช้เอนทิตีที่เข้ารหัส "&" แทน เอาต์พุตสุดท้ายจะแสดงเครื่องหมาย "&" จริง อักขระ เช่น

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