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:

Biến Đề xuất/không bắt buộc Mô tả
ADVANCE-BOOKING-WINDOW Optional Số ngày đặt phòng trước trước ngày nhận phòng trong múi giờ của khách sạn tại thời điểm đặt phòng. Ví dụ: 36.
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) Giá trị nhận dạng thay thế cho cơ sở lưu trú của bạn. Tên thuộc tính này được chỉ định trong nguồn cấp dữ liệu danh sách khách sạn. Việc có mã nhận dạng riêng sẽ hữu ích nếu bạn cần một giá trị nhận dạng cơ sở lưu trú cho thông tin của nguồn cấp dữ liệu và một giá trị khác mã nhận dạng cơ sở lưu trú cho công cụ đặt phòng.
CAMPAIGN-ID Recommended Mã của chiến dịch Google Ads mà bạn muốn liên kết với URL. Trường này trống nếu lượt nhấp không được liên kết với Google Ads chiến dịch.
CHECKINDAY Recommended Ngày gồm hai chữ số được xác định trong phần tử <Checkin> của Nguồn cấp dữ liệu giá khách sạn. Ví dụ: 20.
CHECKINDAY-OF-WEEK Optional Ngày trong tuần —Monday đến Sunday, thời điểm nhận phòng, theo múi giờ của khách sạn. Ví dụ: Tuesday.
CHECKINMONTH Recommended Tháng gồm hai chữ số được xác định trong phần tử <Checkin> của Nguồn cấp dữ liệu giá khách sạn. Ví dụ: 05.
CHECKINYEAR Recommended Năm gồm bốn chữ số được xác định trong <Checkin> của Nguồn cấp dữ liệu giá khách sạn. Ví dụ: 2023.
CHECKOUTDAY Recommended Ngày gồm hai chữ số được tính từ phần tử <Nights> và <Checkin> của Nguồn cấp dữ liệu giá khách sạn. Cho ví dụ: 26.
CHECKOUTMONTH Recommended Tháng gồm hai chữ số được tính từ phần tử <Nights> và <Checkin> của Nguồn cấp dữ liệu giá khách sạn. Ví dụ: 05.
CHECKOUTYEAR Recommended Năm gồm bốn chữ số được tính từ phần tử <Nights> và <Checkin> của Nguồn cấp dữ liệu giá khách sạn. Ví dụ: 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) Độ tuổi tối đa của mỗi trẻ như được chỉ định trong Các phần tử <Child "age"> của nguồn cấp dữ liệu giá. Bạn phải dùng biến này cùng với một khối điều kiện FOR-EACH-CHILD-AGE.
CHILD-INDEX Optional Biến vòng lặp 0 được lập chỉ mục đại diện cho bộ đếm từng khách lưu trú là trẻ em và tuổi của trẻ được chỉ định trong hành trình. Mặc dù không bắt buộc, nhưng bạn chỉ có thể sử dụng biến này cùng với một khối điều kiện FOR-EACH-CHILD-AGE.
CLICK-TYPE Optional Cho biết liệu người dùng có nhấp vào trang thông tin của một khách sạn chuẩn hay không hoặc cho Gói dịch vụ phòng. Các giá trị có thể có là:
  • hotel: Người dùng nhấp vào trang thông tin chuẩn giá phòng.
  • room: Người dùng nhấp vào trang thông tin của Gói dịch vụ phòng.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) Danh sách mã quy tắc giá được phân tách bằng dấu phẩy dành cho giá phòng chưa xác định được, nhưng lẽ ra có thể xác định được nếu người dùng thực hiện một hành động nhỏ. Xin lưu ý rằng mã quy tắc giá cho mức giá ưu đãi chọn lọc sẽ luôn được điền sẵn tại đây khi biện pháp xử lý giao diện người dùng tương ứng hiển thị cho người dùng.
CUSTOM[1-5] Optional Giá trị cho các trường tuỳ chỉnh được xác định trong <Result> có giới hạn 200 ký tự cho mỗi trường tùy chỉnh. Để biết thêm thông tin, tham khảo Tổng quan của Thông báo giao dịch. Bạn không thể sử dụng trường tuỳ chỉnh khi sử dụng ARI.
DATE-TYPE Optional Cho biết liệu người dùng đã chọn ngày mặc định hay một ngày cụ thể ngày tháng được cung cấp trong nội dung tìm kiếm. Các giá trị có thể có là:
  • default: Người dùng nhấp vào quảng cáo khách sạn hoặc đường liên kết miễn phí để đặt phòng sử dụng ngày mặc định.
  • selected: Người dùng nhấp vào quảng cáo khách sạn hoặc quảng cáo miễn phí đường liên kết đặt phòng kèm theo ngày đã đặt.
GOOGLE-ADS-CLICK-SOURCE Optional Cho biết Google Ads là nguồn của lượt nhấp. Các giá trị có thể sử dụng là:
  • bl: Đường liên kết có tính phí để đặt phòng
  • tpa: Quảng cáo khuyến mãi du lịch
  • tfsa: Nguồn cấp dữ liệu du lịch trong quảng cáo Tìm kiếm
  • pm: Chiến dịch Tối đa hoá hiệu suất hoặc Tối đa hoá hiệu suất cho mục tiêu về du lịch Mục tiêu của chiến dịch.

    • Lưu ý: Nếu lượt nhấp bắt nguồn từ Google Tìm kiếm chứ không phải Google Ads, thông số này trống
GOOGLE-SITE Optional Tài sản của Google mà người dùng sử dụng để xem dữ liệu giá khách sạn của bạn. Các giá trị có thể sử dụng là:
  • localuniversal: Người dùng tìm thấy đường liên kết đặt phòng khách sạn thông qua google.com tìm kiếm.
  • mapresults: Người dùng tìm thấy đường liên kết đặt phòng khách sạn thông qua maps.google.com.
  • verification: Google sử dụng giá trị này khi biểu diễn kiểm tra chất lượng dữ liệu tự động trên trang web của bạn. Bạn không bị tính phí các truy vấn này. Google Analytics có thể sử dụng thông số này và giá trị của thông số để xác định lưu lượng truy cập vào quy trình xác minh tự động đối với Quảng cáo khách sạn.
  • unknown: Người dùng tìm thấy quảng cáo hoặc đường liên kết miễn phí để đặt phòng thông qua một nguồn chưa xác định.
LENGTH Recommended Thời gian lưu trú theo số đêm được xác định bằng phần tử <Nights> trong Nguồn cấp dữ liệu giá khách sạn. Ví dụ: 3.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Số lượng người lớn lưu trú do người dùng chỉ định cho hành trình. Bạn phải dùng biến này cùng với NUM-CHILDREN, FOR-EACH-CHILD-AGE hoặc cả hai.
NUM-CHILDREN Recommended Số người lưu trú là trẻ em (0 – 17 tuổi) được chỉ định trong hành trình của người dùng. Để có thể tham gia vào hành trình thành công khi có người lưu trú là trẻ em, cần phải có NUM-CHILDREN, FOR-EACH-CHILD-AGE hoặc cả hai.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) Tổng số người lưu trú, cả người lớn và trẻ em, do người dùng chỉ định cho hành trình. Giá trị này là tổng của Các giá trị NUM-ADULTS và NUM-CHILDREN. Để tối đa hoá cơ hội đấu giá, bạn nên sử dụng cả NUM-ADULTS và NUM-CHILDREN.
PACKAGE-ID Recommended (applies if you use Room Bundles) Giá trị nhận dạng riêng biệt của gói dịch vụ trong Nguồn cấp dữ liệu giá khách sạn. Đối với gói tiêu chuẩn, mã gói là giá trị của phần tử <PackageID> trong khối <Result>. Đối với Gói dịch vụ phòng, mã gói là giá trị của Phần tử <PackageID> trong phần tử Khối <RoomBundle> hoặc <PackageData> cho thông báo Giao dịch.
PARTNER-CURRENCY Optional Mã tiền tệ gồm ba chữ cái được xác định bằng thuộc tính currency của phần tử <Baserate> trong Nguồn cấp dữ liệu giá khách sạn. Ví dụ: USD hoặc CAD .
PARTNER-HOTEL-ID Recommended Giá trị nhận dạng duy nhất của khách sạn do Phần tử <id> trong Nguồn cấp dữ liệu danh sách khách sạn.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) Giá trị nhận dạng duy nhất của phòng trong Nguồn cấp dữ liệu giá khách sạn. Đối với phòng tiêu chuẩn, mã phòng là giá trị của phần tử <RoomID> trong khối <Result>. Đối với Gói dịch vụ phòng, mã phòng là giá trị được chỉ định cho Phần tử <RoomID> trong phần tử Khối <RoomBundle> hoặc <RoomData> trong thông báo Giao dịch.
PAYMENT-ID Optional (only applies to Ads) Chuyển thành một chuỗi commission được xác định sẵn hoặc số IATA do Google chỉ định (ví dụ: "01234567") nếu bạn sử dụng một đại lý thu phí hoa hồng. Để thay đổi định dạng của số IATA hoặc chuỗi được xác định trước, hãy liên hệ với Nhà quản lý tài khoản kỹ thuật (TAM) của bạn.
PRICE-DISPLAYED-TAX (Optional) Số tiền thuế mà người dùng nhìn thấy bằng nội tệ của người dùng. Giá trị của PRICE-DISPLAYED-TAX là giá trị của phần tử <Tax> trong Nguồn cấp dữ liệu giá khách sạn. Ví dụ: "3,14".
PRICE-DISPLAYED-TOTAL (Optional) Tổng phí thuê phòng mà người dùng nhìn thấy bằng nội tệ của người dùng. Giá trị của PRICE-DISPLAYED-TOTAL là tổng của <Baserate>, <Tax> và Các phần tử <OtherFees> trong Nguồn cấp dữ liệu giá khách sạn. Ví dụ: "152,13".
PROMO-CODE (Optional)

Nếu bạn sử dụng ARI khuyến mãi, thì giá trị của biến này được gán cho thuộc tính id của <Promotion> được áp dụng. Nếu áp dụng nhiều chương trình khuyến mãi, biến này sẽ ở dạng danh sách mã khuyến mãi được phân tách bằng dấu phẩy theo thứ tự tuỳ ý.

Nếu bạn sử dụng quy tắc giá, thì giá trị của biến này sẽ được chỉ định cho phần tử PromoCode nếu áp dụng quy tắc giá tương ứng.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Mã nhận dạng được xác định bằng phần tử <RatePlanID> trong một khối <RoomBundle> của nguồn cấp dữ liệu giá. <RatePlanID> đại diện cho giá trị nhận dạng riêng biệt của tổ hợp dữ liệu phòng và dữ liệu gói. Để biết thêm thông tin, hãy xem bài viết Gói dịch vụ phòng.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Mã nhận dạng được xác định bằng thuộc tính rate_rule_id trong một khối <Rate> của nguồn cấp dữ liệu giá. Để biết thêm thông tin, tham chiếu tới Giá phòng có điều kiện.

Lưu ý: Chỉ những mức giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc không bị ẩn mới xuất hiện.
USER-COUNTRY Recommended gồm hai chữ cái mã quốc gia cho biết vị trí của người dùng. Chiến dịch này thông tin được trích xuất từ cài đặt ứng dụng của người dùng. Ví dụ: US hoặc FR.
USER-CURRENCY Recommended Mã đơn vị tiền tệ gồm ba chữ cái cho biết địa phương của người dùng đơn vị tiền tệ. Giá trị của biến USER-CURRENCY được suy ra từ chế độ cài đặt ứng dụng của người dùng. Ví dụ: USD hoặc CAD .
USER-DEVICE Recommended Loại thiết bị của người dùng. Giá trị của USER-DEVICE có thể là một trong những giá trị sau:
  • mobile
  • tablet
  • desktop
  • unknown

Giá trị của biến USER-DEVICE được suy ra từ cài đặt máy khách của người dùng.
USER-LANGUAGE Recommended gồm hai chữ cái Mã ngôn ngữ ISO 639-1 chỉ định ngôn ngữ hiển thị của quảng cáo hoặc đường liên kết miễn phí để đặt phòng. Giá trị của USER-LANGUAGE biến được suy ra từ chế độ cài đặt ứng dụng của người dùng. Ví dụ: en hoặc fr.
USER-LIST-ID (được xác định trong Google Ads) Optional (only applies if you use Audience Lists in Google Ads) Mã danh sách người dùng Google Ads chứa danh sách đối tượng hoặc người dùng của bạn. Danh sách đối tượng được dùng làm cơ sở cho việc đặt mức điều chỉnh giá thầu. Nếu người dùng thuộc nhiều danh sách đối tượng, danh sách đối tượng có điều chỉnh giá thầu lớn nhất sẽ được chọn. Trận đấu giữa những đối tượng có mức điều chỉnh giá thầu lớn nhất sẽ được quyết định ngẫu nhiên.
VERIFICATION Optional Giá trị boolean xác minh liệu đường liên kết có được Google tạo cho kiểm thử hoặc xác thực tự động. Giá trị là true nếu đường liên kết đã được tạo để kiểm tra hoặc xác thực tự động, nếu không thì giá trị sẽ là false.

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:

Điều kiện Đề xuất/không bắt buộc Mô tả
IF-AD-CLICK (chỉ dành cho Quảng cáo khách sạn) Optional Phân giải thành true nếu lượt nhấp của người dùng bắt nguồn từ quảng cáo. Phân giải thành false nếu lượt nhấp của người dùng bắt nguồn từ lượt nhấp miễn phí đường liên kết đặt phòng.
IF-CLICK-TYPE-HOTEL Optional Phân giải thành true nếu người dùng nhấp vào trang thông tin cho khách sạn, nếu không, phân giải thành false.
IF-CLICK-TYPE-ROOM Optional Phân giải thành true nếu người dùng đã nhấp vào trang thông tin về Gói dịch vụ phòng, nếu không sẽ phân giải thành false.
IF-CLOSE-RATE-RULE-IDS Optional Phân giải thành true nếu không có một hoặc nhiều giá phòng có điều kiện do người dùng không đủ điều kiện, nếu không, phân giải thành false. Theo mặc định, truenếu một mức giá ưu đãi chọn lọc Nội dung trong giao diện người dùng hiển thị cho người dùng.
IF-DEFAULT-RATE Optional Phân giải thành true nếu người dùng nhấp vào trang thông tin khách sạn nơi sử dụng ngày mặc định, nếu không thì phân giải thành false.
IF-HOTEL-CAMPAIGN Optional Phân giải thành true nếu lượt nhấp của người dùng bắt nguồn từ chiến dịch khách sạn, nếu không, phân giải thành false. Chiến dịch này sự khác biệt rất hữu ích đối với những đối tác có nhiều loại chiến dịch có trong Google Ads để phân bổ giá trị đóng góp.
IF-PAYMENT-ID (chỉ áp dụng cho Quảng cáo khách sạn) Recommended (if you use pay-per-stay Google Ads campaigns) Phân giải thành true đối với khách sạn trong chương trình hoa hồng Trả tiền cho mỗi lượt lưu trú (PPS); nếu không, phân giải thành false.
IF-PROMO-CODE Optional Phân giải thành true nếu người dùng nhấp vào tỷ lệ dựa trên một chương trình khuyến mãi ARI hoặc quy tắc giá có một PromoCode nhất định; nếu không, sẽ phân giải thành false.
IF-PROMOTED (chỉ dành cho Quảng cáo khách sạn) Recommended (if you use Promoted hotels) Phân giải thành true nếu người dùng nhấp vào một Tài sản Quảng cáo khuyến mãi, nếu không thì phân giải thành false.
IF-RATE-RULE-ID Optional Phân giải thành true nếu người dùng chọn giá phòng có điều kiện, nếu không, phân giải thành false.
IF-USER-LIST-ID (được xác định trong Google Ads) Optional Phân giải thành true nếu người dùng là thành viên của Google Ads mã danh sách khách hàng mà bạn chỉ định khi đặt hệ số giá thầu cho đối tượng danh sách, nếu không, sẽ phân giải thành false.
IF-VERIFICATION Optional Phân giải thành true nếu liên kết được Google tạo để kiểm thử hoặc xác thực tự động, nếu không sẽ phân giải thành false.
ELSE Recommended (if you use any conditional IF statements) Nếu không đáp ứng được điều kiện trước đó, thì các giá trị áp dụng điều kiện này sẽ được chèn vào URL.
END-IF Optional (required if you have any IF conditional statements) Kết thúc khối điều kiện câu lệnh IF.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) Thực thi một lần cho mỗi phần tử <Child "age"> trong nguồn cấp dữ liệu giá. Cho Ví dụ: nếu <OccupancyDetails> bao gồm hai thuộc tính các phần tử <Child age="17"> và <Child age= "17">, sau đó lệnh thực thi hai lần.
END-FOR-EACH Optional (required if using FOR-EACH block) Kết thúc khối điều kiện câu lệnh FOR-EACH.

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&amp;booking_source=commissions
  • Nếu Google được chỉ định số IATA:
    https://partner.com?hid=123&amp;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á "&amp;" 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.