โฆษณาโรงแรมและลิงก์การจองแบบไม่เสียค่าใช้จ่ายจะมีลิงก์ไปยังหน้า 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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)</URL>
ตัวอย่างที่ 2
<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&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) | ตัวระบุทางเลือกสําหรับที่พัก ชื่อแอตทริบิวต์นี้ระบุไว้ในฟีดข้อมูลโรงแรม การมีรหัสแยกกันจะมีประโยชน์ในกรณีที่คุณต้องการตัวระบุที่พัก 1 รายการสำหรับข้อมูลฟีด และตัวระบุที่พักอีก 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 | ระบุว่าผู้ใช้คลิกข้อมูลสำหรับราคาห้องพักมาตรฐานหรือแพ็กเกจห้องพัก ค่าที่เป็นไปได้มีดังนี้
|
| CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | รายการรหัสกฎเกี่ยวกับอัตราที่คั่นด้วยคอมมาสำหรับราคาที่ไม่พร้อมใช้งาน แต่จะพร้อมใช้งานได้หากผู้ใช้ดำเนินการเล็กน้อย โปรดทราบว่ารหัสกฎเกี่ยวกับอัตราสำหรับราคาสำหรับลูกค้าที่เข้าเกณฑ์จะแสดงที่นี่เสมอเมื่อมีการแสดงตัวเลือก UI ที่เกี่ยวข้องต่อผู้ใช้ |
| Optional | เลิกใช้งานแล้ว: ค่าสำหรับช่องที่กำหนดเองซึ่งระบุไว้ในองค์ประกอบ <Result> โดยมีจำนวนอักขระสูงสุด 200 ตัวต่อช่องที่กำหนดเอง ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของข้อความธุรกรรม ฟิลด์ที่กำหนดเองจะใช้ไม่ได้เมื่อใช้ ARI
ตัวแปร CUSTOM จะแสดงเฉพาะเมื่อคุณส่งราคาในข้อความธุรกรรม
|
|
| DATE-TYPE | Optional | ระบุว่าผู้ใช้เลือกวันที่เริ่มต้นหรือวันที่ที่เจาะจงซึ่งระบุไว้ในการค้นหา ค่าที่เป็นไปได้มีดังนี้
|
| GOOGLE-ADS-CLICK-SOURCE | Optional | ระบุว่า Google Ads เป็นแหล่งที่มาของการคลิก ค่าที่เป็นไปได้มีดังนี้
หมายเหตุ: หากการคลิกมาจาก Google Search ไม่ใช่ Google Ads พารามิเตอร์นี้จะว่างเปล่า |
| GOOGLE-SITE | Optional | ผลิตภัณฑ์และบริการของ Google ที่ผู้ใช้ดูข้อมูลราคาโรงแรมของคุณ
ค่าที่เป็นไปได้มีดังนี้
|
| LENGTH | Recommended | ระยะเวลาในการเข้าพักในแง่ของจำนวนคืนที่กำหนดโดยองค์ประกอบ <Nights> ในฟีดราคาโรงแรม เช่น 3 |
| MODIFICATION-IDS | Optional | หากคุณใช้การแก้ไขราคา ARI ค่าของตัวแปรนี้จะเป็นแอตทริบิวต์ |
| 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> ของข้อความธุรกรรม |
| 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> ในข้อความธุรกรรม |
| Optional (only applies to Ads) | เลิกใช้งาน: เปลี่ยนเป็นสตริง commission ที่กำหนดไว้ล่วงหน้า หรือหมายเลข IATA ที่กำหนดให้กับ Google (เช่น "01234567") หากคุณใช้เอเจนซีรวบรวมค่าคอมมิชชัน หากต้องการเปลี่ยนการจัดรูปแบบหมายเลข IATA หรือสตริงที่กำหนดไว้ล่วงหน้า โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) |
|
| PRICE-DISPLAYED-FEES | (Optional) | จำนวนค่าธรรมเนียมที่รวมอยู่ในภาษีและค่าธรรมเนียมทั้งหมด ซึ่งแสดงต่อผู้ใช้ในสกุลเงินท้องถิ่น
ค่าของ PRICE-DISPLAYED-FEES คือค่าขององค์ประกอบ <Fee> ในข้อความธุรกรรม สำหรับ ARI ค่าธรรมเนียมนี้คือจำนวนค่าธรรมเนียมที่คำนวณตามข้อความ TaxFeeInfo เช่น "60.14" |
| 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 ระบบจะกำหนดค่าของตัวแปรนี้ให้กับแอตทริบิวต์ หากคุณใช้
กฎอัตรา ระบบจะกำหนดค่าของตัวแปรนี้ให้กับองค์ประกอบ |
| RATE-PLAN-ID | Recommended (only applies if you use RoomBundles) | รหัสตามที่กำหนดโดยองค์ประกอบ <RatePlanID> ในบล็อก <RoomBundle> ของฟีดราคา <RatePlanID> แสดงถึงตัวระบุที่ไม่ซ้ำกันสำหรับชุดค่าผสมของข้อมูลห้องพักและแพ็กเกจ และควรมีความยาวไม่เกิน 50 อักขระเพื่อให้ได้ประสิทธิภาพสูงสุด ดูข้อมูลเพิ่มเติมได้ที่
แพ็กเกจห้องพัก |
| 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 อาจเป็นค่าใดค่าหนึ่งต่อไปนี้
ระบบจะอนุมานค่าของตัวแปร |
| 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 ไม่เช่นนั้นจะแทรกค่าที่เป็นไปตามคำสั่งELSEfor_statement: สร้างเงื่อนไข FOR loop ที่ทำซ้ำตามจำนวนค่าที่ระบุ
คำสั่ง IF และ FOR ประกอบด้วยข้อมูลต่อไปนี้
| เงื่อนไข | แนะนำ/ไม่บังคับ | คำอธิบาย |
|---|---|---|
| IF-AD-CLICK (โฆษณาโรงแรมเท่านั้น) | 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-DATE | Optional | แสดงผลเป็น true หากผู้ใช้คลิกข้อมูลโรงแรมที่ใช้วันที่เริ่มต้น มิฉะนั้นจะแสดงผลเป็น false |
| IF-HOTEL-CAMPAIGN | Optional | เปลี่ยนเป็น true หากการคลิกของผู้ใช้มาจากแคมเปญโรงแรม ไม่เช่นนั้นจะเปลี่ยนเป็น false ความแตกต่างนี้เป็นประโยชน์ต่อพาร์ทเนอร์ที่มีแคมเปญหลายประเภทใน Google Ads เพื่อจัดสรรการระบุแหล่งที่มา |
| IF-MODIFICATION-IDS | Optional | เปลี่ยนเป็น true หากผู้ใช้คลิกราคาที่มีการแก้ไขโดยการแก้ไขราคา ARI ไม่เช่นนั้นจะเปลี่ยนเป็น false |
| (โฆษณาโรงแรมเท่านั้น) | Recommended (if you use pay-per-stay Google Ads campaigns) | เลิกใช้งาน: เปลี่ยนเป็น true สำหรับโรงแรมในโปรแกรมค่าคอมมิชชันแบบจ่ายต่อการเข้าพัก (PPS) ไม่เช่นนั้นจะเปลี่ยนเป็น false |
| IF-PROMO-CODE | Optional | เปลี่ยนเป็น true หากผู้ใช้คลิกราคาที่อิงตามโปรโมชัน ARI หรือกฎราคาที่มี PromoCode ที่ระบุ ไม่เช่นนั้นจะเปลี่ยนเป็น false |
| IF-PROMOTED (โฆษณาโรงแรมเท่านั้น) | 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)&adType=1(ELSE)&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> ของข้อความธุรกรรมเป็นราคาแพ็กเกจห้องพักที่เชื่อมโยงโดยนัยซึ่งผู้ใช้เลือกไว้
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า 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?hid=123
หากผู้ใช้เลือกแพ็กเกจห้องพัก ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com/landing_room?hid=123
ตัวอย่าง IF-CLICK-TYPE-ROOM
คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้เลือก RoomBundle หรือไม่
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า 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-CLOSE-RATE-RULE-IDS
คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้มีราคาลดพิเศษหรืออัตราส่วนลดเฉพาะบุคคลสำหรับสมาชิกในโปรแกรมสะสมคะแนนหรือไม่
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>
ในตัวอย่างนี้ หากผู้ใช้ไม่มีสิทธิ์รับราคาแบบส่วนตัว ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com?hid=123
หากผู้ใช้เป็นสมาชิกของโปรแกรมสะสมคะแนนและมีสิทธิ์ได้รับราคาเฉพาะบุคคล ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com?hid=123&rate_rule=sample_qr
ตัวอย่างต่อไปนี้คือตรรกะราคาสำหรับลูกค้าที่เข้าเกณฑ์ซึ่งมีรายละเอียดวันที่เช็คอิน วันที่เช็คเอาต์ และจำนวนผู้เข้าพัก พร้อมเงื่อนไข IF ที่ซ้อนกันเพื่อตรวจสอบว่าผู้ใช้มีสิทธิ์ได้รับราคาสำหรับลูกค้าที่เข้าเกณฑ์หรือราคาสำหรับลูกค้าที่เข้าเกณฑ์แบบส่วนตัวหรือราคาสาธารณะหรือไม่
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYear)&checkoutDay=(CHECKOUTDAY)&checkoutMonth=(CHECKOUTMONTH)&checkoutYear(CHECKOUTYear)&num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&promo_type=member_signup&rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&promo_type=conditional&rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>
หากผู้ใช้มีสิทธิ์ใช้ราคาแบบส่วนตัว ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr
หากผู้ใช้มีสิทธิ์ได้รับราคาสำหรับลูกค้าที่เข้าเกณฑ์และอัตราส่วนลดเฉพาะบุคคล ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users
หากผู้ใช้มีสิทธิ์ได้รับราคาสำหรับบุคคลทั่วไป ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public
ตัวอย่าง IF-DEFAULT-DATE
ใช้คำสั่งแบบมีเงื่อนไข IF-DEFAULT-DATE เพื่อตั้งค่าพารามิเตอร์ที่ไม่ใช่วันที่ซึ่งเว็บไซต์ของคุณสามารถใช้เพื่อทริกเกอร์ลักษณะการทำงานที่กำหนดเองได้หากผู้ใช้ไม่ได้เลือกวันที่
ตัวอย่างต่อไปนี้จะตรวจสอบว่ามีการใช้วันที่เริ่มต้นหรือไม่
<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)(IF-DEFAULT-DATE)&popup_datepicker=true(ELSE)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>
ในตัวอย่างนี้ หากไม่ได้คลิก URL ของแคมเปญโรงแรม (เช่น แคมเปญ Search ปกติ) ผลลัพธ์จะเป็น URL ต่อไปนี้
https://www.partner.com?hotelID=123&utm_campaign=87654321
หากผู้ใช้คลิก URL ของแคมเปญโรงแรม ผลลัพธ์จะเป็น URL ต่อไปนี้
https://www.partner.com?hotelID=123&hotel_campaign=12345678
ซึ่งจะเป็นประโยชน์เมื่อคุณต้องการแยกการเข้าชมจากการคลิกแคมเปญโรงแรมออกจากการคลิกอื่นๆ
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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>
IF-MODIFICATIONS-IDS
คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้ได้อัปเดตข้อความการแก้ไขราคา ARI หรือไม่
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page
<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&promo_applied=true&mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>
ในตัวอย่างนี้ หากผู้ใช้ไม่ได้แก้ไขข้อความการแก้ไขราคา ARI ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com?hid=123
หากผู้ใช้อัปเดตข้อความการแก้ไขราคา ARI ผลลัพธ์ที่ได้คือ URL ต่อไปนี้
https://partner.com?hid=123&promo_applied=true&mod_ids=7
IF-PROMO-CODE
คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่ารหัสโปรโมชันสำหรับส่วนลดลิงก์กับราคาสำหรับผู้ใช้ที่ระบุซึ่งกำหนดค่าผ่านข้อความโปรโมชัน ARI หรือกฎราคาหรือไม่
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page
<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&promotion_code=(PROMO-CODE)&discount_applied=true(ENDIF)</URL>
ในตัวอย่างนี้ หากรหัสโปรโมชันไม่ถูกต้อง ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com?hid=123
หากผู้ใช้มีรหัสโปรโมชันที่ถูกต้องและมีสิทธิ์ได้รับส่วนลด ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true
ตัวอย่าง IF-PROMOTED (โฆษณาโรงแรมเท่านั้น)
คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้คลิกโฆษณาโปรโมชันที่พักหรือไม่
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page
<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>
ในตัวอย่างนี้ หากผู้ใช้ไม่ได้เลือกโฆษณาโปรโมชันที่พัก ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com/0?hid=123
หากผู้ใช้เลือกโฆษณาโปรโมชันที่พัก ผลลัพธ์จะเป็น URL ต่อไปนี้
https://partner.com/1?hid=123
ตัวอย่าง IF-RATE-RULE-ID
คุณสามารถสร้างบล็อกแบบมีเงื่อนไขที่ตรวจสอบว่าผู้ใช้เลือกราคาสำหรับลูกค้าที่เข้าเกณฑ์หรือไม่ และหากเลือก ระบบจะใช้ค่าขององค์ประกอบ <RateRuleID> ในบล็อก <Rate> ของข้อความธุรกรรม
ดูข้อมูลเพิ่มเติม
ตัวอย่างต่อไปนี้ใช้คำสั่งนี้ในไฟล์หน้า Landing Page
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&rate_rule=(RATE-RULE-ID)(ELSE)(ENDIF)</URL>
ในตัวอย่างนี้ หากผู้ใช้ไม่ได้เลือกราคาสำหรับลูกค้าที่เข้าเกณฑ์ ผลลัพธ์จะเป็น URL ต่อไปนี้
https://www.partner.com?hid=123
หากผู้ใช้เลือกราคาสำหรับลูกค้าที่เข้าเกณฑ์ ผลลัพธ์จะเป็น URL ต่อไปนี้
https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)
ตัวอย่าง 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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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)&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
- เว้นวรรค (" "): แทนที่อักขระเว้นวรรคด้วย "%20;" ในองค์ประกอบ
ค่าสำหรับพารามิเตอร์เดียวสามารถสร้างจากตัวแปรหลายรายการ ตัวอย่างต่อไปนี้สร้างพารามิเตอร์เดียว
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 รายการ นอกเหนือจากรายการตัวแปรที่ใช้ได้