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 đường liên kết đến các trang đích mà 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 đó bao gồm tất cả thông tin bổ sung về người dùng và hành trình của họ. Ví dụ: bạn có thể đưa 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 hiển thị thì thông tin động trong URL sẽ được thay thế bằng 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>

Các 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 tạo đường liên kết đến trang đích 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 bao gồm cả thông tin động. Ví dụ: nếu người dùng đặt phòng 6 đêm từ ngày 23/5/2023 cho khách sạn #42, 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 gán cho các biến trong chuỗi truy vấn tuỳ 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 có liên quan. Tương tự, giá trị của biến PARTNER-HOTEL-ID được xác định trong phần tử <id> của 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ử nguồn cấp dữ liệu giá. Ví dụ: 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à chế độ cài đặt ứng dụng khác.

Để biết thêm thông tin về nguồn 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 các điểm cuối có đ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ị áp dụng điều kiện này sẽ được chèn vào URL, nếu không thì các giá trị áp dụng lệnh ELSE sẽ được chèn.

• for_statement: Tạo điều kiện lặp FOR, lặp lại dựa 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 có đ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 để chuyển hướng đến trang đích của bạn 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-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, thì 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 có đ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 dịch vụ 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 dịch vụ phòng được liên kết ngầm 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 chọn Gói dịch vụ phòng, thì kết quả sẽ là URL sau:

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

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

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

Bạn có thể tạo một khối có điều kiện để kiểm tra xem người dùng có chọn Gói phòng 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 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 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-DEFAULT-DATE

Sử dụng câu lệnh có điều kiện IF-DEFAULT-DATE để đặt thông số không phải ngày tháng 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 sẽ kiểm tra xem ngày mặc định đã được sử dụng hay chưa:

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

Trong ví dụ này, nếu người dùng không chọn ngày, kết quả có thể sẽ 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, kết quả có thể sẽ tương tự như URL sau đây, tuỳ thuộc vào hành trình mà người dùng chọn:

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

Ví dụ về 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 một khối có điều kiện để kiểm tra xem người dùng có nhấp vào quảng cáo bắt nguồn 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 người dùng nhấp vào URL của chiến dịch khách sạn, thì kết quả sẽ là URL sau:

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

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), thì kết quả sẽ là URL sau:

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

Đ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 mọi lượt nhấp khác.

Mã chiến dịch trống có lượt nhấp vào đường liên kết miễn phí để đặt phòng

Nếu lượt nhấp đến 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 để tránh để trống mã chiến dịch 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>

Ví dụ về IF-PAYMENT-ID (chỉ đối với Quảng cáo khách sạn)

Sử dụng câu lệnh có điều kiện IF-PAYMENT-ID để thay đổi URL dựa trên việc liệu lượt nhấp có bắt nguồn từ chương trình hoa hồng PPS hay không. Ví dụ dưới đây kiểm tra xem lượt nhấp có bắt nguồn từ chương trình hoa hồng PPS hay không và chỉ định giá trị cho tham số booking_source dựa trên kết quả:

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

Nếu khách sạn tham gia Chương trình hoa hồng, thì kết quả sẽ là một trong các URL sau:

• Nếu Google chưa được chỉ định số IATA:

  https://partner.com?hid=123&booking_source=commissions

• Nếu Google được chỉ định số IATA:

  https://partner.com?hid=123&booking_source=01234567

Nếu không, kết quả sẽ là URL sau:

https://partner.com?hid=123&booking_source=cpc

Ví dụ về IF-PROMOTED (chỉ đối với Quảng cáo khách sạn)

Bạn có thể tạo một khối có đ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 chọn Quảng cáo cơ sở lưu trú, thì kết quả sẽ là URL sau:

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

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

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

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

Bạn có thể tạo một khối có điều kiện để kiểm tra xem người dùng có chọn 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.

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;customerType=42(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 giá phòng có điều kiện, thì kết quả sẽ là URL sau:

https://www.partner.com?hid=123&customerType=42

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

Nếu đặt hệ số giá thầu cho danh sách đối tượng trong 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 thông số trên trang web của mình cho 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 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 thuộc 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 thuộc 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ề IF-VERIFICATION

Nếu cần kiểm tra xem Google có tạo URL để kiểm thử hay xác thực tự động 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 sẵn độ tuổi tối đa của mỗi người lưu trú là trẻ em, theo quy đị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 tuổi lần lượt là 0 và 17, 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ả biến đều là không bắt buộc. Bạn không cần phải chèn bất kỳ biến nào vào URL trang đích của mình. Tuy nhiên, việc sử dụng biến để chuyển thông tin về hành trình và người dùng thường tạo ra 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.

Sau đây là các quy tắc chung áp dụng khi xác định URL đã tạo trong tệp trang đích:

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

• Thông số chuỗi truy vấn phải được phân tách bằng ký hiệu ("&") trong kết quả cuối cùng. Vì ký hiệu & 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ể mã hoá "&" thay cho ký hiệu 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á thành URL 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 ký tự dấu cách bằng "%20;" trong phần tử <URL>
  • dấu gạch chéo lên ("/"): Thay dấu gạch chéo lên bằng "%2F;" trong phần tử <URL>

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

• Giá trị của một thông số duy nhất có thể được tạo từ nhiều biến. Ví dụ sau đây tạo một thông số duy nhất là 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 tạo nên URL có thể có dạng sau:

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

• Bạn có thể sử dụng bất kỳ mã nào cho tên thông số chuỗi truy vấn. Máy chủ của bạn sẽ xử lý các giá trị này. Tuy nhiên, giá trị mà bạn chuyển sẽ 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.