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

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