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 để 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 để 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ể thê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 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ô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ì hành trình và mã khách sạn thực tế:
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 các giá trị thực tế để đảm bảo URL có bao gồm thông tin động. Ví dụ: nếu người dùng đặt phòng cho 6 đêm kể từ ngày 23 tháng 5 năm 2023 tại 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 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 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ụ: 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ề 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ể 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 phòng 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 của bạn. Việc có mã nhận dạng riêng sẽ rất hữu ích nếu bạn cần một giá trị nhận dạng cơ sở lưu trú trong thông tin của nguồn cấp dữ liệu và một giá trị nhận dạng khác 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 sẽ trống nếu lượt nhấp không được 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. Ví dụ: 20 . |
CHECKINDAY-OF-WEEK | Optional | Ngày trong tuần – từ Monday đến Sunday , khi 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 phần tử <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. 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 quy đị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 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 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 có đ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 để xem giá khách sạn tiêu chuẩn hay Gói dịch vụ phòng. Các giá trị có thể sử dụng là:
|
CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | Một 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 lẽ ra đã 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 luôn được điền tại đây khi nội dung 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 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 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à:
|
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à:
|
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) do người dùng chỉ định trong
hành trình. Phải có NUM-CHILDREN , FOR-EACH-CHILD-AGE hoặc cả hai thì mới có thể tham gia thành công vào các 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, do người dùng chỉ định cho hành trình. Giá trị này là tổng của 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ã nhận dạng 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à một 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 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 số IATA mà Google chỉ định (ví dụ: "01234567"), nếu bạn sử dụng một công ty 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 hỗ trợ 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 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, giá trị của biến này sẽ được gán cho thuộc tính Nếu bạn sử dụng
quy tắc giá, thì giá trị của biến này sẽ được gán cho phần tử |
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> đại diện cho giá trị nhận dạng duy nhất của 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 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ã đượ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.
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 | 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ừ các 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ừ các 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:
Giá trị của biến |
USER-LANGUAGE | Recommended | Mã ngôn ngữ gồm hai chữ cái theo tiêu chuẩn ISO 639-1 cho biết 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 các 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, 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 những đố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. Thuộc tính này sẽ là true nếu đường liên kết được Google 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 các 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 là
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 thì các giá trị tuân theo lệnhELSE
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ỉ á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ừ mộ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 một 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, phân giải thành false . Theo mặc định, hệ thống sẽ hiển thị true nếu một
mức giá ưu đãi chọn lọc
giao diện người dùng hiển thị với 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 có 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ừ
chiến dịch khách sạn, nếu không, 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ỉ áp dụng cho Quảng cáo khách sạn) | Recommended (if you use pay-per-stay Google Ads campaigns) | Nếu không, 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)
thì 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 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ỉ áp dụng 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, 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ã 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 được Google tạo để kiểm tra hoặc xác thực tự động, nếu không, 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 đ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á. Ví dụ: nếu <OccupancyDetails> bao gồm hai phần tử <Child age="17"> và <Child age=
"17"> , thì lệnh sẽ 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 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)&adType=1(ELSE)&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 có điều kiện để kiểm tra xem người dùng có chọn một khách sạn 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 định 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 có điều kiện để kiểm tra xem người dùng có chọn một Gói Room 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-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 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 sử dụng hay chưa:
<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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ể sẽ tương tự như URL hiển thị lựa chọn ngày mặc định sau đây:
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ể sẽ tương tự như URL sau đây, 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ừ mộ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)&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ả 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 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 lượt nhấp là 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à giá trị CAMPAIGN-ID
được đặt để 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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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à gán giá trị cho
thông số booking_source
dựa trên kết quả:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&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 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ú 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 một 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 đúng như vậy, 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 một tệp trang đích:
<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&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
kết hợp với USER-LIST-ID
để đặ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 trên Google Ads. Bạn có thể muốn làm như vậy nhằm mục đích theo dõi hoặc tuỳ chỉnh trang web của mì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)&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
, 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 cho mục đích kiểm thử hoặc 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)&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 độ tuổi tối đa của mỗi người lưu trú là trẻ em, như quy đị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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</URL>
Trong ví dụ này, nếu hành trình có 2 người lớn và 2 trẻ em lần lượt là 0 và 17 tuổi, 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. 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, đồng thời 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 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.
Tham 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, còn định dạng tệp trang đích là XML. Do đó, bạn phải sử dụng thực thể mã hoá "&" thay cho thực thể đó. Kết quả cuối cùng sẽ hiển thị ký tự "&" 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 thế dấu gạch chéo lên bằng "%2F;" trong phần tử
<URL>
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 được mã hoá URL. Để biết danh sách các ký tự phổ biến phải mã hoá URL, hãy tham khảo Bảng mã hoá URL.
- dấu cách (" "): Thay ký tự dấu cách bằng "%20;" trong phần tử
Giá trị cho một thông số duy nhất 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ếnCHECKINDAY
,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 sẽ xử lý các giá trị này. Tuy nhiên, các giá trị mà bạn truyền sẽ được giới hạn trong 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.