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>

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

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 liên kết trang đích được tạo cho trang kết quả tìm kiếm, Google thay thế biến bằng các giá trị thực tế để đảm bảo rằng URL bao gồm thông tin linh động. Ví dụ: nếu người dùng đặt phòng cho 6 đêm, bắt đầu từ ngày 23 tháng 5 năm 2023 tại khách sạn số 42, Google 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 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> trong nguồn cấp dữ liệu về 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> 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à nhóm nhỏ 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ể dùng để tạo URL trang đích của bạn:

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

Bạn có thể sử dụng 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 là true thì các giá trị tuân theo điều kiện được chèn vào URL, nếu không các giá trị theo sau Đã chèn lệnh ELSE.

• 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 điều kiện để kiểm tra xem người dùng đã 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.

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

Ví dụ sau đây sử dụng lệnh này trong một 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 điều kiện để kiểm tra xem người dùng có chọn một Room hay không Gói.

Ví dụ sau đây sử dụng lệnh này trong một 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, 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, thì kết quả có thể cũng tương tự vào URL sau đây để hiển thị 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 (Số 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 một 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ả 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ã CAMPAIGN-ID trống có lượt nhấp FBL

Nếu đây là lượt nhấp từ một đường liên kết miễn phí để đặt phòng, thì IF-HOTEL-CAMPAIGN sẽ trả về Giá trị TRUE và 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ỉ dành cho 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 Phí hoa hồng, thì kết quả là một trong các URL sau:

• Nếu Google không được chỉ định số IATA nào:

  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ỉ dành cho 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 một 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ú, thì kết quả sẽ là URL sau:

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

Ví dụ về IF-RATE-QU-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 nên thực hiện theo phương pháp này để theo dõi hoặc tuỳ chỉnh trang web của mình cho 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, kết quả là URL sau:

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

Nếu Google tạo URL để kiểm thử 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ể xây dựng một khối điều kiện điền độ tuổi tối đa của mỗi khối người lưu trú là trẻ em, theo 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 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 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 của bạn. 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 ngoặc đơn mở và đóng.

• 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ị "&" 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 <URL> phần tử

  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. Chiến lược phát hành đĩa đơn ví dụ sau đây tạo một tham 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 xử lý các giá trị này. Tuy nhiên, các giá trị mà bạn chuyển được giới hạn ở 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.