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, CHECKINMONTHCHECKINYEAR đượ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á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 của bạ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 trên 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, khi việc nhận phòng diễn ra, 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 <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ừ <Nights><Checkin> phần tử 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ừ <Nights><Checkin> của Nguồn cấp dữ liệu giá khách sạn. Cho ví dụ: 05.
CHECKOUTYEAR Recommended Năm gồm bốn chữ số được tính bằng giá trị <Nights><Checkin> của Nguồn cấp dữ liệu giá khách sạn. Cho ví dụ: 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) Độ tuổi tối đa của mỗi trẻ theo quy định trong Các phần tử <Child "age"> của nguồn cấp dữ liệu giá. Bạn phải sử dụng biến này cùng với một FOR-EACH-CHILD-AGE khối có điều kiện.
CHILD-INDEX Optional Biến vòng lặp 0 được lập chỉ mục đại diện cho bộ đếm cho mỗi thành phần con Khách lưu trú và tuổi của trẻ em được chỉ định trong hành trình. Mặc dù không phải bắt buộc, bạn chỉ có thể sử dụng biến này cùng với FOR-EACH-CHILD-AGE khối có điều kiện.
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 một Phòng Gói.
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 cho những mức giá không có sẵn, nhưng có thể đã có sẵ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 sẽ luôn được điền sẵn vào đây khi phiên bản 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. Trường tuỳ chỉnh không có sẵn 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 quảng cáo miễn phí đường liên kết đặ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 quảng cáo miễn phí đường liên kết đặt phòng kèm theo ngày đã đặt.
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ể có 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í cho những 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 xác minh tự động cho 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 không xác định.
LENGTH Recommended Thời gian lưu trú theo số đêm do Phần tử <Nights> trong Nguồn cấp dữ liệu giá khách sạn. Cho 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. Biến này phải được sử dụng 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. NUM-CHILDREN, FOR-EACH-CHILD-AGE hoặc cả hai là bắt buộc để thành công tham gia vào hành trình 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, được chỉ định cho hành trình của người dùng. Giá trị này là tổng của Các giá trị NUM-ADULTSNUM-CHILDREN. Người nhận tối đa hoá tỷ lệ tham gia, nên sử dụng cả hai Thay vào đó, NUM-ADULTSNUM-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 <Result> chặn. Đố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> về 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ởi 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à một giá trị của Phần tử <RoomID> trong <Result> chặn. Đố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) Phân giải thành chuỗi được xác định trước commission hoặc chuỗi số IATA được chỉ định (ví dụ: "01234567"), nếu bạn sử dụng số tiền hoa hồng công ty thu hồi nợ. Để thay đổi định dạng của số IATA hoặc chuỗi định sẵn, 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í phòng mà người dùng nhìn thấy trong thông tin của họ nội tệ. 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. Đây là danh sách được phân tách bằng dấu phẩy mã khuyến mại theo thứ tự tùy ý.

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á. Chiến lược phát hành đĩa đơn <RatePlanID> đại diện cho giá trị nhận dạng duy nhất cho tổ hợp dữ liệu về phòng và gói dịch vụ. Để biết thêm thông tin, hãy xem 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ỉ giá phòng có điều kiện hoặc giá ưu đãi chọn lọc mà không bị ẩ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. Cho 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 là suy ra từ 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 các trạng thái 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 đặt giá thầu điều chỉnh. 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ể 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:

Điều kiện Đề xuất/không bắt buộc Mô tả
IF-AD-CLICK (chỉ áp dụng 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 một hoặc nhiều giá phòng có điều kiện là không khả dụng vì người dùng không đủ điều kiện, nếu không, giải quyết 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 hình thức Trả tiền cho mỗi lượt lưu trú (PPS) chương trình hoa hồng sẽ 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, sẽ 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 cho kiểm thử hoặc xác thực tự động, nếu không thì 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 đượ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 lần thực thi 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"><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 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ị TRUECAMPAIGN-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&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ỉ đố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á "&amp;" đú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)&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á 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, CHECKINMONTHCHECKINYEAR:

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