Trang này được dịch bởi Cloud Translation API.

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 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 để thê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ã đơn vị 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 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 đườ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 có chứa thông tin độ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 cho 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 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 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 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à tập hợp con 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ừ 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 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:

Biến	Đề xuất/không bắt buộc	Nội dung mô tả
ADVANCE-BOOKING-WINDOW	Optional	Số ngày đặt trước trước ngày nhận phòng theo 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 nguồn cấp dữ liệu và một giá trị nhận dạng khác của cơ sở lưu trú cho công cụ đặt phòng.
CAMPAIGN-ID	Recommended	Mã của chiến dịch trên Google Ads mà bạn muốn liên kết với URL này. Trường này sẽ trống nếu lượt nhấp không liên kết với chiến dịch trên Google Ads.
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. Ví dụ: `20`.
CHECKINDAY-OF-WEEK	Optional	Ngày trong tuần — từ `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 viết dưới dạng 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. Ví dụ: `05`.
CHECKINYEAR	Recommended	Năm gồm bốn 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. Ví dụ: `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. 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ẻ theo chỉ định trong 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 có đ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 cho từng người 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ể 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 nhấp vào trang thông tin để tìm giá khách sạn tiêu chuẩn hay để tìm hiểu về Gói dịch vụ phòng. Các giá trị có thể sử dụng là: `hotel`: Người dùng nhấp vào trang thông tin để xem giá phòng tiêu chuẩn. `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 của những mức giá không có sẵn, nhưng có thể đã xuất hiện 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 luôn được điền sẵn tại đây khi người dùng nhìn thấy cách xử lý tương ứng trên giao diện người dùng.
CUSTOM[1-5]	Optional	Giá trị cho các trường tuỳ chỉnh được xác định trong phần tử `<Result>` có giới hạn 200 ký tự cho mỗi trường tuỳ chỉnh. Để biết thêm thông tin, hãy tham khảo bài viết Tổng quan về Thông báo giao dịch. Các trường tuỳ chỉnh sẽ không có sẵn khi 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ể được cung cấp trong nội dung tìm kiếm. Các giá trị có thể sử dụng 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 có 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 đường liên kết miễn phí để đặt phòng có đặt ngày.
GOOGLE-SITE	Optional	Sản phẩm 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 thực hiện quy trình kiểm tra chất lượng dữ liệu tự động trên trang web của bạn. Bạn sẽ không bị tính phí cho 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ố này để xác định lưu lượng truy cập vào quy trình xác minh tự động của 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ố người lưu trú là người lớn 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) do người dùng chỉ định trong hành trình. Cần phải có `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` hoặc cả hai để tham gia vào hành trình có được khi có người lưu trú là trẻ em.
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ăng tối đa khả năng tham gia, 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 duy nhất của gói kỳ nghỉ trong Nguồn cấp dữ liệu giá khách sạn. Đối với một 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 khối `<RoomBundle>` hoặc `<PackageData>` của Thông báo giao dịch.
PARTNER-CURRENCY	Optional	Mã đơn vị 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 riêng biệt của khách sạn được xác định bằng 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 gán cho phần tử `<RoomID>` trong khối `<RoomBundle>` hoặc `<RoomData>` trong Thông báo giao dịch.
PAYMENT-ID	Optional (only applies to Ads)	Phân giải thành một chuỗi được xác định trước `commission` 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 Giám đốc Quản lý Khách hàng về 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 chi phí của 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 các phần tử `<Baserate>`, `<Tax>` và `<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 chương trình khuyến mãi ARI, thì giá trị của biến này sẽ đượ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, thì đó là một 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 khối `<RoomBundle>` của nguồn cấp dữ liệu giá. `<RatePlanID>` là giá trị nhận dạng duy nhất của tổ hợp dữ liệu phòng và gói dịch vụ. Để 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 khối `<Rate>` của nguồn cấp dữ liệu giá. Để biết thêm thông tin, hãy tham khảo Giá phòng có điều kiện.
USER-COUNTRY	Recommended	Mã quốc gia gồm hai chữ cái cho biết vị trí của người dùng. Thông tin này được trích xuất từ chế độ 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 nội tệ của người dùng. 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ừ chế độ cài đặt ứng dụng của người dùng.
USER-LANGUAGE	Recommended	Mã ngôn ngữ theo ISO 639-1 gồm hai chữ cái xác đị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 biến `USER-LANGUAGE` đượ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 thông tin người dùng. Danh sách đối tượng được dùng làm cơ sở để đặt hệ số điều chỉnh giá thầu. Nếu người dùng nằm trong nhiều danh sách đối tượng, thì danh sách đối tượng có mức điều chỉnh giá thầu lớn nhất sẽ được chọn. Mối quan hệ giữa các đối tượng có mức điều chỉnh giá thầu lớn nhất được quyết định ngẫu nhiên.
VERIFICATION	Optional	Giá trị boolean xác minh xem đường liên kết có được Google tạo để kiểm tra hoặc xác thực tự động hay không. Giá trị là `true` nếu đường liên kết do Google tạo để kiểm tra hoặc xác thực tự động, nếu không thì giá trị này sẽ là `false`.

Biế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 một cách 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ị tuân theo điều kiện này sẽ được chèn vào URL, nếu không các giá trị tuân theo lệnh ELSE sẽ được chèn.
for_statement: Tạo điều kiện lặp FOR để lặp lại 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	Nội dung 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ừ đường liên kết miễn phí để đặ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 của 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 của Gói dịch vụ phòng, nếu không, 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, hãy phân giải thành `false`. Theo mặc định, giá trị này là `true` nếu biện pháp xử lý giao diện người dùng mức giá ưu đãi chọn lọc 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 sử dụng ngày mặc định, nếu không, 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ừ một chiến dịch khách sạn, nếu không sẽ phân giải thành `false`. Sự khác biệt này sẽ giúp ích cho những đối tác có nhiều loại chiến dịch trong Google Ads cần phân bổ mô hình phân bổ.
IF-PAYMENT-ID (chỉ dành 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` cho các khách sạn trong chương trình hoa hồng Trả tiền cho mỗi lần 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 giá dựa trên chương trình khuyến mãi ARI hoặc quy tắc giá có `PromoCode` nhất định; nếu không, 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 Quảng cáo cơ sở lưu trú, nếu không sẽ 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 một mã danh sách khách hàng Google Ads mà bạn chỉ định khi đặt hệ số giá thầu cho danh sách đối tượng. Nếu không, phân giải thành `false`.
IF-VERIFICATION	Optional	Phân giải thành `true` nếu đường liên kết do Google tạo để kiểm thử hoặc xác thực tự động, nếu không, hãy phân giải thành `false`.
ELSE	Recommended (if you use any conditional IF statements)	Nếu không đáp ứng điều kiện trước đó, thì các giá trị tuân theo đ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 có điều kiện cho 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á. Ví dụ: nếu `<OccupancyDetails>` bao gồm 2 phần tử `<Child age="17">` và `<Child age= "17">`, thì lệnh này sẽ thực thi 2 lần.
END-FOR-EACH	Optional (required if using FOR-EACH block)	Kết thúc khối có điều kiện cho 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 hay đườ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, 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 mà 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á của 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 điều kiện để kiểm tra xem người dùng có chọn Gói dịch vụ 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 một tham số không phải ngày mà 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 ngày.

Ví dụ sau đây sẽ 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)<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ể tương tự như URL sau đây, thể hiện 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ể 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ề 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ừ 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, 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), 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 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 FBL

Nếu lượt nhấp đó đến 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>

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ó bắt nguồn từ chương trình hoa hồng PPS hay không và chỉ định giá trị cho thông 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ả sẽ là một trong các URL sau:

Nếu Google chưa được chỉ định số IATA nào cho Google:

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 đ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ú, thì 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 đúng như vậy, thì hệ thống sẽ sử dụng giá trị của phần tử <RateRuleID> trong khối <Rate> của thông báo giao dịch.

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, 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 đặ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 cùng với USER-LIST-ID để đặt một thông số trên trang web cho khách hàng thuộc một danh sách đối tượng nhất định của Google Ads. Bạn nê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 là thành viên của danh sách đối tượng 12345678, 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 tra 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, 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 có độ 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 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 các biến để truyền hành trình và thông tin 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.

Các quy tắc chung sau đây á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.
Bạn chỉ có thể chuyển tham số chuỗi truy vấn sau dấu chấm hỏi ("?") trong URL.
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ì ký hiệ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 thực thể đó. Kết quả cuối cùng sẽ hiển thị một ký tự "&" thực tế. Ví dụ:
```

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>


<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 phần tử <URL>
Không phải tất cả ký tự không thuộc bảng chữ cái đều phải được mã hoá URL. Ví dụ: bạn không cần mã hoá URL bằng dấu gạch nối ("-"). Để biết danh sách các ký tự thông thường phải được mã hoá URL, hãy tham khảo Bảng mã hoá URL.
Giá trị của một thông số có thể được tạo từ nhiều biế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 dẫn đến 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 tham 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 truyền sẽ bị giới hạn trong danh sách các biến hiện có.
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.