Biến và điều kiện

Quảng cáo khách sạn và đường liên kết miễn phí để đặt phòng bao gồm các đường liên kết đến trang đích nơi người dùng có thể đặt phòng. Bạn có thể xác định cách Google tạo đường liên kết để đường liên kết đó có thêm thông tin về người dùng và hành trình của họ. Ví dụ: bạn có thể thêm các thông tin như mã khách sạn, ngôn ngữ, mã tiền tệ và ngày nhận phòng vào URL.

Tổng quan

Bạn xác định URL trang đích trong tệp trang đích. Khi quảng cáo hoặc đường liên kết miễn phí để đặt phòng xuất hiện, thông tin động trong URL sẽ được thay thế bằng các giá trị thực tế. Để thêm giá trị động vào URL trang đích, hãy sử dụng cú pháp sau:

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

Ví dụ sau đây cho thấy một URL sử dụng tên biến của Google thay vì mã khách sạn và hành trình thực tế:

Ví dụ 1

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

Ví dụ 2

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

Khi đường liên kết đến trang đích được tạo cho trang kết quả tìm kiếm, Google sẽ thay thế các biến bằng giá trị thực tế để đảm bảo URL chứa thông tin động. Ví dụ: Nếu người dùng đặt phòng cho 6 đêm từ ngày 23/5/2023 tại khách sạn số 42, thì Google sẽ hiển thị đường liên kết trước đó như sau:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Giá trị mà Google chỉ định cho các biến trong chuỗi truy vấn phụ thuộc vào dữ liệu tương ứng trong Nguồn cấp dữ liệu giá khách sạn, Nguồn cấp dữ liệu danh sách khách sạn và chế độ cài đặt của người dùng.

Ví dụ: giá trị của biến LENGTH được gán cho phần tử <Nights> từ nguồn cấp dữ liệu giá của hành trình liên quan. Tương tự, giá trị của biến PARTNER-HOTEL-ID được xác định trong phần tử <id> từ Nguồn cấp dữ liệu danh sách khách sạn khớp với tiêu chí tìm kiếm của người dùng.

Một số biến là tập hợp con của các phần tử trong nguồn cấp dữ liệu giá. Ví dụ: các biến CHECKINDAY, CHECKINMONTH và CHECKINYEAR được trích xuất từ một phần tử <Checkin> duy nhất trong nguồn cấp dữ liệu giá. Các biến khác được tính toán dựa trên ngôn ngữ của người dùng và các chế độ cài đặt khác của ứng dụng.

Để biết thêm thông tin về nguồn của các giá trị biến, hãy tham khảo bài viết tổng quan về giá và Danh sách khách sạn.

Biến URL

Bảng sau đây mô tả các biến có sẵn mà bạn có thể sử dụng để tạo URL trang đích:

Logic có điều kiện trong URL

Bạn có thể sử dụng các lệnh đặc biệt trong phần tử <URL> của tệp trang đích để tạo điểm cuối theo điều kiện.

Logic có điều kiện hỗ trợ các câu lệnh sau:

• if_statement: Nếu true, thì các giá trị theo điều kiện này sẽ được chèn vào URL, nếu không thì các giá trị theo lệnh ELSE sẽ được chèn.

• for_statement: Tạo điều kiện vòng lặp FOR lặp lại trên số lượng giá trị được cung cấp.

Câu lệnh IF và FOR bao gồm:

Ví dụ về IF-AD-CLICK

Bạn có thể tạo một khối điều kiện để kiểm tra xem người dùng có nhấp vào quảng cáo hoặc đường liên kết miễn phí để đặt phòng hay không, nhằm chuyển hướng đến trang đích của bạn.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Trong ví dụ này, nếu người dùng không nhấp vào quảng cáo, kết quả sẽ là URL sau:

https://www.partner.com?hid=123&adType=0

Nếu người dùng nhấp vào quảng cáo, kết quả sẽ là URL sau:

https://www.partner.com?hid=123&adType=1

Ví dụ về IF-CLICK-TYPE-HOTEL

Bạn có thể tạo một khối điều kiện để kiểm tra xem người dùng có chọn một khách sạn không có Gói phòng rõ ràng hay không. Giá trị của phần tử <RatePlanID> trong khối <Room Bundle> của Thông báo giao dịch sẽ được đặt thành giá gói phòng liên kết ngầm định mà người dùng đã chọn.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Trong ví dụ này, nếu người dùng không chọn Gói dịch vụ phòng, thì kết quả sẽ là URL sau:

https://partner.com/landing?hid=123

Nếu người dùng chọn một Gói dịch vụ phòng, thì kết quả sẽ là URL sau:

https://partner.com/landing_room?hid=123

Ví dụ về IF-CLICK-TYPE-ROOM

Bạn có thể tạo khối điều kiện, khối này sẽ kiểm tra xem người dùng có chọn RoomBundle hay không.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Trong ví dụ này, nếu người dùng không chọn Gói phòng, thì kết quả sẽ là URL sau:

https://partner.com/landing?hid=123

Nếu người dùng chọn một Gói dịch vụ phòng, thì kết quả sẽ là URL sau:

https://partner.com/landing_room?hid=123

Ví dụ về IF-CLOSE-RATE-RULE-IDS

Bạn có thể tạo một khối điều kiện để kiểm tra xem người dùng có được hưởng mức giá ưu đãi đặc biệt hoặc mức giá ưu đãi chọn lọc dành cho thành viên của chương trình khách hàng thân thiết hay không.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Trong ví dụ này, nếu người dùng không đủ điều kiện nhận mức giá riêng tư, thì kết quả sẽ là URL sau:

https://partner.com?hid=123

Nếu người dùng là thành viên của một chương trình khách hàng thân thiết và đủ điều kiện nhận mức giá ưu đãi chọn lọc, thì kết quả sẽ là URL sau:

https://partner.com?hid=123&rate_rule=sample_qr

Ví dụ sau đây là logic giá phòng có điều kiện với ngày nhận phòng, ngày trả phòng và thông tin chi tiết về số người lưu trú cùng các điều kiện IF lồng nhau để kiểm tra xem người dùng có đủ điều kiện nhận giá phòng riêng tư, giá phòng riêng tư có điều kiện hay giá phòng công khai hay không:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

Nếu người dùng đủ điều kiện nhận giá phòng riêng, thì kết quả sẽ là URL sau:

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

Nếu người dùng đủ điều kiện nhận mức giá riêng tư có điều kiện, thì kết quả sẽ là URL sau:

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

Nếu người dùng đủ điều kiện nhận giá công khai, thì kết quả sẽ là URL sau:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

Ví dụ về kiểu kết hợp IF-DEFAULT-DATE

Sử dụng câu lệnh có điều kiện IF-DEFAULT-DATE để đặt một tham số không phải ngày mà trang web của bạn có thể sử dụng để kích hoạt hành vi tuỳ chỉnh nếu người dùng không chọn ngày.

Ví dụ sau đây kiểm tra xem ngày mặc định có được sử dụng hay không:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Trong ví dụ này, nếu người dùng không chọn ngày, thì kết quả có thể tương tự như URL sau đây (cho thấy các lựa chọn ngày mặc định):

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Nếu người dùng chọn một ngày, thì kết quả có thể tương tự như URL sau, tuỳ thuộc vào hành trình mà họ chọn:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

Ví dụ về tham số IF-HOTEL-CAMPAIGN (Lượt nhấp vào quảng cáo khách sạn và đường liên kết miễn phí để đặt phòng)

Bạn có thể tạo khối điều kiện, khối này sẽ kiểm tra xem người dùng nhấp vào quảng cáo có nguồn gốc từ một chiến dịch khách sạn hay không.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Trong ví dụ này, nếu đó không phải là lượt nhấp vào URL của chiến dịch khách sạn (ví dụ: chiến dịch tìm kiếm thông thường), kết quả sẽ là URL sau:

https://www.partner.com?hotelID=123&utm_campaign=87654321

Nếu người dùng nhấp vào URL của chiến dịch khách sạn, kết quả sẽ là URL sau:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

Điều này rất hữu ích khi bạn muốn phân biệt lưu lượng truy cập của các lượt nhấp vào chiến dịch khách sạn với các lượt nhấp khác.

CAMPAIGN-ID trống có lượt nhấp vào đường liên kết miễn phí để đặt phòng (FBL)

Nếu lượt nhấp là từ một Đường liên kết miễn phí để đặt phòng, thì IF-HOTEL-CAMPAIGN sẽ trả về TRUE và giá trị CAMPAIGN-ID được đặt thành trống như trong URL sau:

https://www.partner.com?hotelID=123&hotel_campaign=

Bạn có thể sử dụng câu lệnh có điều kiện IF-AD-CLICK để ngăn mã chiến dịch trống như trong ví dụ sau:

<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-MODIFICATIONS-IDS

Bạn có thể tạo một khối điều kiện để kiểm tra xem người dùng đã cập nhật thông báo Sửa đổi giá ARI hay chưa.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&amp;promo_applied=true&amp;mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>

Trong ví dụ này, nếu người dùng không sửa đổi thông báo Sửa đổi giá ARI, thì kết quả sẽ là URL sau:

https://partner.com?hid=123

Nếu người dùng cập nhật thông báo Sửa đổi giá ARI, thì kết quả sẽ là URL sau:

https://partner.com?hid=123&promo_applied=true&mod_ids=7

IF-PROMO-CODE

Bạn có thể tạo một khối điều kiện để kiểm tra xem mã khuyến mãi giảm giá có liên kết với giá phòng cho người dùng được chỉ định hay không. Giá phòng này được định cấu hình thông qua thông báo Khuyến mãi ARI hoặc quy tắc về giá phòng.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

Trong ví dụ này, nếu mã khuyến mãi không hợp lệ thì kết quả sẽ là URL sau:

https://partner.com?hid=123

Nếu người dùng có mã khuyến mãi hợp lệ và đủ điều kiện được chiết khấu, thì kết quả sẽ là URL sau:

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

Ví dụ về IF-PROMOTED (chỉ dành cho Quảng cáo khách sạn)

Bạn có thể tạo một khối điều kiện để kiểm tra xem người dùng có nhấp vào Quảng cáo cơ sở lưu trú hay không.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Trong ví dụ này, nếu người dùng không chọn Quảng cáo cơ sở lưu trú, thì kết quả sẽ là URL sau:

https://partner.com/0?hid=123

Nếu người dùng chọn một Quảng cáo cơ sở lưu trú, thì kết quả sẽ là URL sau:

https://partner.com/1?hid=123

Ví dụ về IF-RATE-RULE-ID

Bạn có thể tạo một khối điều kiện để kiểm tra xem người dùng có chọn một giá phòng có điều kiện hay không. Nếu có, thì giá trị của phần tử <RateRuleID> trong khối <Rate> của thông báo giao dịch sẽ được sử dụng. Tìm hiểu thêm.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;rate_rule=(RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Trong ví dụ này, nếu người dùng không chọn giá phòng có điều kiện, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123

Nếu người dùng chọn một giá phòng có điều kiện, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

Ví dụ về IF-USER-LIST-ID (được xác định trong Google Ads)

Nếu đặt hệ số giá thầu cho danh sách đối tượng trong một chiến dịch khách sạn trên Google Ads, bạn có thể sử dụng IF-USER-LIST-ID cùng với USER-LIST-ID để đặt một tham số trên trang web của mình cho một khách hàng thuộc một danh sách đối tượng nhất định trên Google Ads. Bạn có thể muốn làm như vậy cho mục đích theo dõi hoặc để tuỳ chỉnh trang web của mình cho các thành viên trong danh sách đối tượng.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

Trong ví dụ này, nếu người dùng không phải là thành viên của danh sách đối tượng, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123

Nếu người dùng là thành viên của danh sách đối tượng 12345678, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123&audience_list=12345678

Ví dụ về kiểu kết hợp IF-VERIFICATION

Nếu cần kiểm tra xem Google có tạo URL để kiểm thử hoặc xác thực hay không, bạn có thể sử dụng IF-VERIFICATION.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

Trong ví dụ này, nếu Google không tạo URL để kiểm tra hoặc xác thực, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123

Nếu Google tạo URL để kiểm tra hoặc xác thực, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123&isgoogle=true

Ví dụ về FOR-EACH-CHILD-AGE

Bạn có thể tạo một khối có điều kiện để điền độ tuổi tối đa của mỗi trẻ em, như được chỉ định trong Nguồn cấp dữ liệu giá khách sạn.

Ví dụ sau đây sử dụng lệnh này trong tệp trang đích:

<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>

Trong ví dụ này, nếu hành trình có 2 người lớn và 2 trẻ em lần lượt là 0 và 17 tuổi, thì kết quả sẽ là URL sau:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Nếu hành trình có 2 người lớn và 0 trẻ em, thì kết quả sẽ là URL sau:

https://www.partner.com?adults=2&children=0&hid=123

Quy tắc chung khi tạo URL

Tất cả các biến đều không bắt buộc. Bạn không bắt buộc phải chèn bất kỳ biến nào vào URL trang đích. Tuy nhiên, việc sử dụng các biến để truyền thông tin về hành trình và người dùng thường mang lại trải nghiệm tốt hơn cho người dùng và giúp bạn tuân thủ các chính sách của Google.

Các quy tắc chung sau đây áp dụng khi xác định URL được tạo trong tệp trang đích:

• Tất cả các biến đều được đặt trong dấu ngoặc đơn mở và đóng.

• Các tham số chuỗi truy vấn phải được phân tách bằng ký hiệu và ("&") trong kết quả cuối cùng. Vì dấu và (&) là một ký tự đặc biệt trong XML và định dạng tệp trang đích là XML. Do đó, bạn phải sử dụng thực thể được mã hoá "&" thay cho ký tự này. Kết quả cuối cùng sẽ hiển thị ký tự "&" thực tế. Ví dụ:

  <!-- 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>
  

  Bạn cũng phải mã hoá URL cho các ký tự đặc biệt mà bạn có thể đưa vào URL trang đích. Ví dụ:

  • dấu cách (" "): Thay thế các ký tự dấu cách bằng "%20;" trong phần tử <URL>
  • dấu gạch chéo lên ("/"): Thay thế dấu gạch chéo lên bằng "%2F;" trong phần tử <URL>

  Không phải tất cả các ký tự không phải chữ cái đều phải được mã hoá URL. Ví dụ: dấu gạch nối ("-") không cần phải được mã hoá URL. Để biết danh sách các ký tự phổ biến phải được mã hoá URL, hãy tham khảo bài viết Mã hoá URL.

• Bạn có thể tạo giá trị cho một tham số từ nhiều biến. Ví dụ sau đây tạo một tham số duy nhất, checkinDate, từ các biến CHECKINDAY,CHECKINMONTH và CHECKINYEAR:

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  Ví dụ này sẽ tạo ra một URL có thể có dạng như sau:

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• Bạn có thể sử dụng bất kỳ mã nhận dạng nào cho tên của các tham số chuỗi truy vấn. Máy chủ của bạn xử lý các giá trị này. Tuy nhiên, các giá trị mà bạn truyền bị giới hạn trong danh sách các biến có sẵn.

• Bạn có thể sử dụng tối đa 5 biến tuỳ chỉnh ngoài danh sách các biến có sẵn.