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 chứa đườ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 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ể bao gồm các thông tin như mã khách sạn, ngôn ngữ, mã đơn vị tiền tệ và ngày nhận phòng trong URL.

Tổng quan

Bạn xác định URL trang đích trong tệp trang đích. Khi có quảng cáo hoặc miễn phí đường liên kết đặt phòng xuất hiện, trong đó thông tin linh độ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 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ế:

<URL>https://www.partnerdomain.com?hotelID=(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/5/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 Danh sách khách sạn Nguồn cấp dữ liệu 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ụ: Các biến CHECKINDAY, CHECKINMONTH và CHECKINYEAR được trích xuất từ <Checkin> đơn lẻ trong nguồn cấp dữ liệu giá. Các biến khác sẽ đượ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ề các nguồn giá trị biến, hãy tham khảo 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ể 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 là true thì các giá trị tuân theo điều kiện sẽ được chèn vào URL, nếu không thì 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 một 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ẽ như sau URL:

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 một Gói dịch vụ phòng, thì kết quả sẽ như sau URL:

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 một tham số không phải là ngày Sau đó, 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 một 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 ngày, kết quả có thể tương tự như URL sau, tuỳ theo hành trình họ đã 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 đ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ừ một chiến dịch khách sạn.

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 từ bất kỳ nhấp chuột nào 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 IF-AD-CLICK câu lệnh có điều kiện để tránh việc mã chiến dịch trống như 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 lượt nhấp đó có phải là kết quả của chương trình hoa hồng PPS hay không. Ví dụ bên dưới kiểm tra xem một lượt nhấp có đến từ chương trình hoa hồng PPS hay không và chỉ định một 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:

  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 đ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ú.

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ả 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ể xây dựng một khối có điều kiện để kiểm tra xem người dùng đã chọn một giá phòng có điều kiện và nếu đúng như vậy thì giá trị của <RateRuleID> Phần tử trong khối <Rate> của thông báo giao dịch được sử dụng.

Ví dụ sau đây sử dụng lệnh này trong một 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, kết quả sẽ là URL sau:

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

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

Nếu bạn đặt hệ số giá thầu cho danh sách đối tượng trong chiến dịch khách sạn trong Google Ads, bạn có thể sử dụng IF-USER-LIST-ID kết hợp với USER-LIST-ID để đặt thông số trên trang web của bạn cho một khách hàng thuộc một số Google Ads nhất định danh sách đối tượng. Bạn có thể muốn làm như vậy nhằm mục đích theo dõi hoặc để tuỳ chỉ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, kết quả là URL sau:

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

Ví dụ về IF-VERIFICATION

Nếu bạn cần kiểm tra xem Google tạo URL cho mục đích thử nghiệm hay tự động xác thực, 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 tra hoặc xác thực, 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 đ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 một 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 từ 0 đến 17 tuổi tương ứng, 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ẽ như sau URL:

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 các biến để chuyển 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à hỗ trợ 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 đã tạo trong trang đích tệp trang:

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

• Bạn chỉ có thể chuyển tham số chuỗi truy vấn sau dấu chấm hỏi ("?") trong URL.

• Tham số chuỗi truy vấn phải được phân tách bằng ký hiệu ("&") trong đầu ra 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ể được mã hoá "&" đúng chỗ. 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)&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 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á URL tất cả các ký tự không phải ký tự 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ải được mã hoá thành URL, hãy tham khảo Bảng mã hoá URL.

• Giá trị cho 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 ra một URL có thể giống như 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 của 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 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 biến.