Tổng quan
Thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) ARI xác định thông tin về các loại phòng và gói dịch vụ (hoặc gói giá) của mỗi cơ sở lưu trú. Mỗi dữ liệu loại phòng đều có một giá trị nhận dạng riêng biệt (RoomID), tên, nội dung mô tả và URL được bản địa hoá cho ảnh phòng. Mỗi gói dữ liệu đều có một giá trị nhận dạng riêng biệt (PackageID), tên, nội dung mô tả, số người lưu trú và các giá trị gia tăng theo ngôn ngữ địa phương.
Bạn có thể dùng thông báo Giao dịch để làm những việc sau:
- Xác định dữ liệu cho một hoặc nhiều tài sản.
- Xác định loại phòng và thông tin về gói dịch vụ cho từng cơ sở lưu trú.
- Kiểm soát các sản phẩm.
Ngoài ra, bạn có thể đặt các thao tác để thực hiện những việc sau:
Thêm một loại phòng và gói dịch vụ vào một cơ sở lưu trú.
Xoá một loại phòng và gói dịch vụ khỏi cơ sở lưu trú.
Thêm điểm khách hàng thân thiết, một chương trình phần thưởng vào gói hoặc cơ sở lưu trú.
Để xem ví dụ về thông báo giao dịch, hãy xem bài viết Ví dụ về giao dịch (Dữ liệu của cơ sở lưu trú).
Phần tử bắt buộc và không bắt buộc
Tài liệu tham khảo XML cung cấp nội dung mô tả về các phần tử bắt buộc và không bắt buộc. Để biết thông tin chi tiết về các thuộc tính và phần tử con, hãy xem Các phần tử và thuộc tính của giao dịch (Dữ liệu của cơ sở lưu trú).
Cú pháp và giản đồ
Hãy tham khảo ví dụ về Cú pháp Giao dịch (Dữ liệu về tài sản) khi bạn tạo thông báo Giao dịch để đảm bảo bạn đang làm theo đúng định dạng.
Bạn có thể sử dụng một công cụ XML của bên thứ ba như xmllint để xác thực nguồn cấp dữ liệu bằng các giản đồ đã xuất bản trước khi gửi cho Google. Để biết lược đồ thông báo Giao dịch, hãy xem lược đồ Quảng cáo khách sạn.
Nguyên tắc
Hãy làm theo các nguyên tắc sau đây đối với thông báo Giao dịch:
- Việc cần làm:
delta: Dùng để thêm hoặc cập nhật các loại phòng và gói mới (gói giá).overlay: Sử dụng để thay thế tất cả các loại phòng và gói của một cơ sở lưu trú bằng một bộ mới. Bạn phải cung cấp thông tin cho tất cả các loại phòng và gói giá mà bạn vẫn muốn bán.- Ngôn ngữ được hỗ trợ:
Chỉ định từ 1 đến 2 ngôn ngữ (tiếng Anh và ngôn ngữ địa phương cho tài sản nếu cần) cho các trường Tên, Nội dung mô tả và Phụ đề. Bạn có thể thêm nhiều hơn 2 ngôn ngữ nếu cần.
- Loại phòng và gói dịch vụ:
Khi cập nhật một loại phòng hoặc gói dịch vụ, bạn phải gửi tất cả thông tin liên quan cho loại phòng hoặc gói dịch vụ đó. Ví dụ: khi thêm ảnh, bạn cũng phải thêm tên và nội dung mô tả.
<AllowablePackageIDs>và<AllowableRoomIDs>là không bắt buộc, và nếu bạn không đặt, thì bạn có thể kết hợp bất kỳ loại phòng và gói giá nào. Bạn vẫn phải gửi tình trạng phòng và giá phòng bằng mã loại phòng và mã gói giá. Những phần tử này cho phép bạn kiểm soát các sản phẩm cũng như vô hiệu hoá những tổ hợp mà hệ thống của bạn không còn hỗ trợ.Gửi cho Google một thông báo Giao dịch cập nhật bất cứ khi nào có thay đổi về loại phòng hoặc gói dịch vụ, hoặc những thông tin quan trọng về loại phòng hoặc gói dịch vụ cần được thêm.
- Điểm khách hàng thân thiết:
Để thêm hoặc loại trừ chương trình phần thưởng trong gói của bạn, hãy thiết lập cấu hình Điểm khách hàng thân thiết với Google. Thao tác này sẽ hiển thị số điểm đã kiếm được liên kết với gói đó. Tìm hiểu thêm về Điểm khách hàng thân thiết.
Sử dụng phần tử
<MilesIncluded>để xác định hoặc cập nhật chiến dịch khách hàng thân thiết. Hãy xem Giao dịch(Dữ liệu của cơ sở lưu trú) để biết thêm thông tin. Bạn có thể thêm điểm khách hàng thân thiết bằng<PackageData>.
Ví dụ:
Phần này cung cấp một ví dụ cơ bản về thông báo Giao dịch ARI bằng cách sử dụng các phần tử bắt buộc và không bắt buộc. Để thêm hoặc cập nhật loại phòng và gói dịch vụ, bạn sử dụng một thao tác cho delta để thêm hoặc cập nhật loại phòng và gói dịch vụ, hoặc overlay để thay thế tất cả các định nghĩa về loại phòng và gói dịch vụ (xoá các mục cũ).
Bạn cần chỉ định một đến hai ngôn ngữ (tiếng Anh và ngôn ngữ địa phương cho tài sản nếu cần) cho các trường Tên, Nội dung mô tả và Phụ đề. Sau đó, hãy thêm thông tin dữ liệu về tài sản, bao gồm cả đường liên kết đến ảnh.
Đối với <PropertyID> và <RoomID>, hãy sử dụng cùng mã nhận dạng mà bạn dùng trong hệ thống của mình cho gói giá và loại phòng (tương ứng). Tính nhất quán với hệ thống của bạn là yếu tố quan trọng để đảm bảo rằng Google đang hiển thị chính xác giá và dữ liệu của bạn.
Sau khi chuẩn bị tệp, bạn phải gửi tệp đó cho Google thông qua một thông báo POST đến điểm cuối sau: https://www.google.com/travel/hotels/uploads/property_data
Để tìm hiểu thêm về cách truyền/ĐĂNG thông báo, hãy xem phần Truyền thông báo.
Ví dụ sau đây cho thấy cách đặt thông báo Giao dịch bằng thao tác delta:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
<PropertyDataSet action="delta">
<Property>PROPERTYID</Property>
<RoomData>
<RoomID>ROOMID</RoomID>
<Name><Text text="ROOM NAME" language="en"/></Name>
<Description>
<Text text="ROOM DESCRIPTION TEXT" language="en"/>
</Description>
<Capacity>4</Capacity>
<PhotoURL>
<Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
<URL>https://LINK TO PHOTO</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>BASE</PackageID>
<Name><Text text="Internet Special" language="en"/></Name>
<Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
<Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
</PackageData>
</PropertyDataSet>
</Transaction>
Để xem thêm ví dụ, chẳng hạn như cách sử dụng thao tác overlay, thêm một loại phòng và gói dịch vụ vào dữ liệu hiện có của cơ sở lưu trú, cũng như xoá các loại phòng và gói dịch vụ hiện có, hãy xem Ví dụ về giao dịch (Dữ liệu của cơ sở lưu trú).
Hướng dẫn
Phần này cung cấp giải pháp cho các trường hợp bạn có thể gặp phải khi gửi Thông báo giao dịch.
Tình huống 1: Cách xoá dữ liệu loại phòng
Làm cách nào để xoá loại phòng và/hoặc dữ liệu gói dịch vụ hiện có?
Mô tả
Bạn đã gửi nhiều loại phòng, bao gồm cả phòng cỡ giường lớn và phòng cỡ giường đôi cho khách sạn. Tất cả các loại phòng có giường cỡ Queen đều không hoạt động trong quá trình sửa chữa và hiện chỉ có các loại phòng có giường cỡ King.
Giải pháp
- Bạn không cần cập nhật tình trạng phòng trống, giá hoặc khoảng không quảng cáo mỗi đêm cho những mã loại phòng và mã gói dịch vụ đã bị xoá hoặc huỷ kích hoạt.
- Nếu loại phòng hoặc gói đã bị xoá hoặc huỷ kích hoạt, hãy gửi một thông báo Giao dịch mới có
action="overlay"chỉ bao gồm các loại phòng và gói vẫn đang hoạt động, đồng thời loại trừ loại phòng hoặc gói đã bị xoá.
Mẫu
Đoạn mã XML này cho biết cách sử dụng thao tác overlay để xoá một loại phòng.
Sau đây là thao tác delta ban đầu, bao gồm các loại phòng King và Queen:
<PropertyDataSet action="delta">
<Property>Property_1</Property>
<RoomData>
<RoomID>King</RoomID>
<Name>
<Text text="King" language="en"/>
</Name>
<Capacity>2</Capacity>
</RoomData>
<PackageData>
<PackageID>Standard</PackageID>
<Name>
<Text text="Standard" language="en"/>
</Name>
<Description>
<Text text="Standard rate" language="en"/>
</Description>
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
<RoomData>
<RoomID>Queen</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<Capacity>2</Capacity>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
</PropertyDataSet>
Sau đó, bạn có thể đặt overlay để xoá loại phòng Queen và giữ lại loại phòng King:
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>King</RoomID>
<Name>
<Text text="King" language="en"/>
</Name>
<Capacity>2</Capacity>
</RoomData>
<PackageData>
<PackageID>Standard</PackageID>
<Name>
<Text text="Standard" language="en"/>
</Name>
<Description>
<Text text="Standard rate" language="en"/>
</Description>
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
Tình huống 2: Cách kiểm soát sản phẩm bằng AllowablePackageIDs
Làm cách nào để kiểm soát sản phẩm (kết hợp loại phòng và gói dịch vụ) khi gói dịch vụ được nhóm theo loại phòng?
Mô tả
Bạn có một số gói chỉ áp dụng cho một số loại phòng. Ví dụ: nếu cơ sở lưu trú của bạn có 4 loại phòng (bao gồm cả phòng Tổng thống) và 6 gói khác nhau, nhưng chỉ một vài gói đủ điều kiện cho phòng Tổng thống, thì bạn có thể chỉ định điều kiện.
Giải pháp
Gửi một thông báo Giao dịch mới cập nhật, trong đó chỉ định những sản phẩm có trong gói bằng cách sử dụng <AllowablePackageIDs>.
Mẫu
Đoạn mã XML này cho biết cách sử dụng <AllowablePackageIDs> để chỉ định các gói được dùng với một loại phòng nhất định. Ở đây, loại phòng Penthouse suite chỉ cho phép sử dụng gói Penthouse trọn gói hoặc gói Bữa sáng miễn phí, trong khi loại phòng King suite chỉ cho phép sử dụng gói King trọn gói hoặc gói Cho phép mang theo thú cưng.
<RoomData>
<RoomID>penthouse_suite</RoomID>
<AllowablePackageIDs>
<AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
<AllowablePackageID>free_breakfast</AllowablePackageID>
</AllowablePackageIDs>
<!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
<RoomID>king_suite</RoomID>
<AllowablePackageIDs>
<AllowablePackageID>king_all_inclusive</AllowablePackageID>
<AllowablePackageID>pet_friendly</AllowablePackageID>
</AllowablePackageIDs>
<!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
<PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
<PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
<PackageID>pet_friendly</PackageID>
</PackageData>
Tình huống 3: Cách điều khiển sản phẩm bằng AllowableRoomIDs
Làm cách nào để kiểm soát sản phẩm (tổ hợp loại phòng và gói dịch vụ) khi loại phòng được nhóm theo gói dịch vụ?
Mô tả
Một tổ hợp loại phòng và gói dịch vụ không còn được bán dưới dạng sản phẩm hoặc bạn muốn kiểm soát những gì có trong một gói dịch vụ mới. Ví dụ: bạn chỉ muốn chỉ định một số loại phòng nhất định, chẳng hạn như phòng cỡ King và phòng cỡ Queen có hướng nhìn ra biển, kèm theo một gói dịch vụ.
Giải pháp
Gửi một thông báo Giao dịch mới cập nhật, trong đó nêu rõ các sản phẩm có trong gói bằng phần tử <AllowableRoomIDs>.
Mẫu
Đoạn mã XML này cho biết cách sử dụng <AllowableRoomID> để chỉ định loại phòng King và Queen có tầm nhìn hướng ra biển trong gói.
<PackageID>RO</PackageID>
<AllowableRoomIDs>
<AllowableRoomID>king_oceanview</AllowableRoomID>
<AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>