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

Xếp hạng thông báo

Tổng quan

Thông báo giá (OTA_HotelRateAmountNotifRQ) xác định mức giá lưu trú mỗi đêm cho từng tổ hợp loại phòng và gói giá trong phạm vi ngày cụ thể. Trong thông báo Giá, Google hỗ trợ giá dựa trên số người lưu trú, cho phép chỉ định nhiều mức giá mỗi đêm dựa trên số lượng tối đa số người lưu trú dự định.

Các phần sau đây trình bày các nguyên tắc chung, ví dụ cơ bản và trường hợp hướng dẫn giúp bạn bắt đầu thêm, cập nhật giá phòng cũng như gửi thông báo Giá.

Hành vi của tỷ lệ khớp

Khi người dùng yêu cầu số người lưu trú cụ thể, mức giá họ nhìn thấy sẽ phụ thuộc vào cách bạn xác định mức giá trong thông báo Giá. Phần này trình bày cách so khớp các yêu cầu của người dùng này với giá phòng của bạn, tuỳ thuộc vào số người lưu trú trong yêu cầu của họ và mức giá mà bạn xác định.

Nguyên tắc chính

Mức giá được xác định cho một số người lưu trú cụ thể sẽ áp dụng cho tất cả các mức sức chứa ít hơn, trừ phi có quy định khác.
Các yêu cầu về số người lưu trú trên mức đã xác định được coi là không khả thi.
Giá theo số người lưu trú áp dụng cho cả mô hình định giá theo ngày và mô hình định giá dựa trên LOS như mô tả dưới đây. Điều này có nghĩa là bạn có thể chỉ định giá cho từng sức chứa. Nếu không có giá cho sức chứa cụ thể, thì giá cho sức chứa cao nhất tiếp theo sẽ được sử dụng. Bạn cũng có thể xác định các khoản phí cho thêm khách và trẻ em bằng cách sử dụng AdditionalGuestAmounts hoặc ExtraGuestCharges được áp dụng cho sức chứa được xác định cho một phòng.

Lợi ích và ví dụ

Hiệu quả

Đối với nhiều mức người lưu trú có cùng mức giá, bạn không cần đặt giá cho từng mức người lưu trú. Bạn có thể đơn giản hoá thông báo bằng cách chỉ đặt giá trị cho số người lưu trú cao nhất mà loại phòng và gói giá hỗ trợ. Người dùng sẽ thấy mức giá đó cho mỗi số người lưu trú nhỏ hơn hoặc bằng giá trị bạn đã đặt.

Ví dụ: Mức giá cho loại phòng và gói giá sẽ giống nhau đối với số người lưu trú từ 1 đến 4. Sử dụng thông báo Xếp hạng để đặt một mức giá cho số người lưu trú tối đa là 4. Người dùng đang tìm kiếm phòng đơn, phòng đôi và phòng ba người sẽ thấy cùng một mức giá. Những người dùng tìm kiếm cấp độ 5 trở lên sẽ không thấy giá.

Điều khiển

Bạn có thể cung cấp mức giá riêng biệt cho số người lưu trú thay thế. Gửi một mức giá khác nhau cho từng giá trị của số người lưu trú nếu bạn muốn kiểm soát nhiều hơn cách Google so khớp yêu cầu với giá cho số người lưu trú.

Ví dụ: Nếu mức giá được xác định cho sức chứa 3 và 1, thì khi tìm kiếm phòng một người sẽ cho thấy mức giá cho phòng đơn, tìm kiếm cho phòng đôi sẽ cho thấy mức giá cho phòng ba người và người dùng tìm kiếm phòng 4 người trở lên sẽ không thấy giá cho phòng đơn.

Để biết thêm ví dụ về các trường hợp liên quan đến giá, hãy xem phần Hướng dẫn.

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 bài viết Phần tử giá và thuộc tính.

Cú pháp và giản đồ

Hãy tham khảo ví dụ về Cú pháp giá khi tạo thông báo Giá để đảm bảo bạn đang sử dụng đúng định dạng.

Bạn có thể sử dụng công cụ XML của bên thứ ba như xmllint để xác thực nguồn cấp dữ liệu của mình với giản đồ đã xuất bản trước khi gửi cho Google. Đối với giản đồ Thông báo giá, hãy xem Giản đồ Quảng cáo khách sạn.

Mô hình định giá

Giá theo ngày

Đây là mô hình định giá tiêu chuẩn được sử dụng cho hầu hết các cơ sở lưu trú. Mô hình định giá per-date dựa trên việc đặt các mức giá được tổng hợp trong các ngày lưu trú để đến với tổng giá phòng. Trong mô hình này, tất cả các mức giá trong phần tử Rate đều được hiểu là áp dụng cho một phạm vi ngày lưu trú được chỉ định trong <StatusApplicationControl>.

Giá dựa trên LOS

Mô hình tính giá dựa trên thời gian lưu trú (LOS) dựa trên các mức giá được đặt cho tổ hợp ngày đến và thời gian lưu trú. Các mức giá được chỉ định trong mô hình định giá dựa trên mức LoS là giá mỗi ngày. Ví dụ: nếu bạn gửi mức giá 100 USD cho thời gian lưu trú là 3, thì tổng giá sẽ được tính là 3x100=300 USD.

Bạn có thể sử dụng mô hình định giá dựa trên LOS bằng cách chỉ định RatePlanType="26" trên các phần tử StatusApplicationControl. Bạn cũng cần đặt thuộc tính RateTimeUnit và UnitMultiplier trên các phần tử Rate trong XML. Điều này khiến tất cả các mức giá trong phần tử Rate nhất định đều được áp dụng cho các lượt lưu trú được xác định theo ngày đến được chỉ định trong <StatusApplicationControl> và giá trị LOS được chỉ định cho UnitMultiplier.

Bạn có thể sử dụng cả mô hình đặt giá theo ngày và LOS trong một tài khoản. Tuy nhiên, mỗi cơ sở lưu trú chỉ nên sử dụng một mô hình đặt giá duy nhất. Hãy ghi nhớ những điểm sau đây khi triển khai tính năng đặt giá dựa trên LOS:

Không thể kết hợp mức giá cho những khoảng thời gian lưu trú khác nhau khi sử dụng giá dựa trên LOS. Ví dụ: không kết hợp được mức LOS là 3 với LOS là 1 để định giá mức LOS là 4. Bạn phải chỉ định rõ ràng tỷ lệ LOS là 4.
Mức giá 1 đêm theo giá dựa trên LOS không được dùng làm mức giá mỗi đêm riêng lẻ trong mức giá theo ngày.
Mỗi cơ sở lưu trú chỉ nên sử dụng giá dựa trên LOS hoặc giá theo ngày, tuỳ thuộc vào cách giá hiển thị trong hệ thống của bạn.

Để bật giá dựa trên LOS cho tài khoản của bạn, hãy gửi yêu cầu thông qua TAM của bạn hoặc liên hệ với chúng tôi.

Nguyên tắc hoặc biện pháp xử lý

Giá theo ngày

Delta: Chỉ thêm hoặc cập nhật đơn giá theo sức chứa cho các tổ hợp loại phòng, gói giá và ngày lưu trú đã chỉ định trong <StatusApplicationControl>.

Theo mặc định, thông tin cập nhật giá sẽ sử dụng thao tác Delta.
Bản cập nhật Delta không làm thay đổi mức giá đã lưu trữ trước đó của các mức sức chứa khác. Ví dụ: Nếu bạn đã chỉ định mức giá cho phòng một người và phòng hai người và gửi thông tin cập nhật về mức giá Delta cho phòng một người, thì mức giá cho phòng hai người sẽ không thay đổi.

Overlay: Xoá mọi mức giá hiện tại theo sức chứa cho loại phòng, gói giá và ngày được chỉ định trong <StatusApplicationControl> rồi thay thế bằng giá mới. Ví dụ: Nếu bạn đã chỉ định giá cho phòng một người và phòng hai người và bạn gửi thông tin cập nhật Overlay cho phòng một người, Google sẽ xoá tất cả các mức giá trước đó (cả phòng một người và phòng đôi) và chỉ còn giá cho phòng một người sau khi cập nhật.

Remove: Xoá mọi mức giá hiện tại cho mỗi người lưu trú đối với loại phòng, gói giá và ngày đã chỉ định trong <StatusApplicationControl>.

Giá dựa trên LOS

Delta: Chỉ thêm hoặc cập nhật giá phòng theo giá trị LOS cho các tổ hợp loại phòng, gói giá và ngày nhận phòng đã chỉ định trong <StatusApplicationControl>. Thay thế tất cả các mức giá theo sức chứa được liên kết với các giá trị LOS mới cập nhật.

Theo mặc định, thông tin cập nhật giá sẽ sử dụng thao tác Delta.
Bản cập nhật Delta không làm thay đổi mức giá đã lưu trữ trước đó của các khoảng thời gian lưu trú khác. Ví dụ: nếu bạn đã chỉ định mức giá cho LOS 1 và 2 và gửi nội dung cập nhật về giá Delta cho LOS 1, thì mức giá mỗi người lưu trú của LOS 2 sẽ không thay đổi.
Bản cập nhật Delta sẽ ghi đè mọi mức giá đã lưu trữ trước đây theo sức chứa trong thời gian lưu trú đã cho. Ví dụ: nếu bạn đã chỉ định mức giá cho phòng một người và hai người cho LOS 1, đồng thời gửi thông tin cập nhật về giá Delta cho LOS 1 mà chỉ có mức giá cho phòng một người, thì mức giá cho phòng hai người sẽ bị xoá.

Overlay: Xoá mọi mức giá hiện có theo sức chứa cho LOS, loại phòng, gói giá và ngày nhận phòng đã chỉ định trong <StatusApplicationControl> rồi thay thế bằng mức giá mới. Ví dụ: nếu bạn đã chỉ định mức giá cho LOS 1 và 2, đồng thời bạn gửi nội dung cập nhật Overlay cho LOS 1, Google sẽ xoá tất cả các mức giá trước đó (cả LOS 1 và 2) và chỉ còn mức giá LOS 1 sau khi cập nhật.

Remove: Xoá mọi mức giá hiện có theo sức chứa cho tất cả LOS của loại phòng, gói giá và ngày nhận phòng đã chỉ định trong <StatusApplicationControl>.

Liên quan đến thuế

Nếu các khoản thuế và phí đơn giản, bạn có thể chỉ định tổng số tiền bằng cách sử dụng AmountAfterTax. Bạn không thể trình bày các khoản thuế phức tạp, chẳng hạn như các khoản thuế và phí áp dụng cho mỗi lượt lưu trú (thay vì mỗi đêm) bằng AmountAfterTax.

Nhìn chung, bạn nên sử dụng TaxFeeInfo thay vì AmountAfterTax.

Nếu có thể, bạn nên bao gồm AmountBeforeTax (ngay cả khi bạn chỉ định AmountAfterTax) vì một số ngôn ngữ (ví dụ: Hoa Kỳ) hiển thị giá trước thuế theo mặc định.

Mọi khoản thuế và phí mà người dùng phải trả (thuế GTGT, thuế lưu trú, phí vệ sinh, thuế thành phố và các loại thuế khác) phải được bao gồm, ngay cả khi không thanh toán tại thời điểm đặt phòng hoặc không thanh toán trực tiếp cho cơ sở lưu trú.

Ví dụ:

Phần này cung cấp một ví dụ cơ bản về Thông báo giá sử dụng các phần tử bắt buộc và không bắt buộc. Sau khi chuẩn bị tệp, bạn phải gửi tệp cho Google bằng thông báo POST tới điểm cuối sau: https://www.google.com/travel/hotels/uploads/property_data

Để tìm hiểu thêm về cách đẩy/POST thông báo, hãy xem phần Đẩy thông báo.

Đối với HotelCode, hãy sử dụng mã khách sạn duy nhất mà bạn đã dùng trong hệ thống của mình để xác định cơ sở lưu trú. Giá trị này phải khớp với Mã khách sạn được chỉ định bằng <id> trong phần tử <listing> của Nguồn cấp dữ liệu danh sách khách sạn. Đối với <PackageID> và <RoomID>, hãy sử dụng cùng một mã mà bạn dùng trong hệ thống của mình cho các gói giá và loại phòng (tương ứng). Tính nhất quán với hệ thống là yếu tố rấ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.

Ví dụ này minh hoạ cách đặt giá bằng thao tác Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Hướng dẫn

Phần này cung cấp giải pháp cho các tình huống bạn có thể gặp phải khi gửi thông báo Giá.

Để biết ví dụ về cách thêm, xoá và cập nhật giá, hãy xem phần Ví dụ về giá.

Trường hợp 1: Cách thay đổi giá theo mỗi người lưu trú

Nội dung mô tả

Giá mỗi đêm được xác định chỉ cho phòng hai người (cũng áp dụng cho phòng một người), nhưng hiện tại có mức giá rẻ hơn cho phòng một người.

Giải pháp

Gửi mức giá mới cho số người lưu trú 1 bằng thông tin cập nhật mặc định về phạm vi Delta. Giá trị mới này không ảnh hưởng đến tỷ lệ kín phòng 2.

Trường hợp 2: Cách thay thế mức giá theo sức chứa mỗi người lưu trú của một cơ sở lưu trú

Nội dung mô tả

Trước đây, bạn đã xác định mức giá cho sức chứa từ 1 đến 4, nhưng hiện tại chỉ có mức sức chứa 1 và 2 là hợp lệ.

Giải pháp

Sử dụng NotifType="Overlay" để thay thế tất cả các mức giá cho số người lưu trú của một cơ sở lưu trú, loại phòng, gói giá và(các) ngày cụ thể. Trong trường hợp này, hành động Overlay sẽ liệt kê giá cho số người lưu trú 1 và 2.

Trường hợp 3: Cách đặt cùng một mức giá cho nhiều số người lưu trú

Nội dung mô tả

Bạn có thể bán mức giá cho một số người lưu trú nhất định cho một nhóm có ít người hơn. Trong trường hợp này, bạn có thể đơn giản hoá thông báo của mình bằng cách chỉ gửi thông tin cập nhật về giá cho số người lưu trú tối đa đang áp dụng.

Giải pháp

Nếu bạn có cùng một mức giá cho nhiều mức sức chứa, hãy đặt giá trị về số người lưu trú cao nhất được hỗ trợ theo loại phòng và gói giá. Sau đó, giá trị này sẽ tự động sử dụng giá trị đó cho các mức sức chứa thấp hơn. Nghĩa là không cần lặp lại cùng một mức giá mỗi đêm cho số người lưu trú từ 1 đến 6 người nếu tất cả đều giống nhau; bạn chỉ cần đặt mức giá đó cho 6 người.