Đánh giá tin nhắn

Tổng quan

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

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

Hành vi về tỷ lệ khớp

Khi người dùng yêu cầu số lượng người lưu trú cụ thể, giá phòng mà họ thấy sẽ phụ thuộc vào cách bạn xác định giá trong thông báo Giá. Phần này trình bày cách các yêu cầu của người dùng được so khớp với mức giá của bạn, tuỳ thuộc vào số lượng người trong yêu cầu 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ố lượng người lưu trú cụ thể sẽ áp dụng cho tất cả số lượng người lưu trú ít hơn, trừ phi được xác định khác.

  • Yêu cầu về số người lưu trú vượt quá số người được xác định sẽ không được chấp nhận.

  • Mô hình định giá dựa trên 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 thời gian lưu trú như mô tả bên dưới. Điều này có nghĩa là bạn có thể chỉ định mức giá cho từng số lượng người lưu trú. Nếu không có giá cho một số lượng người lưu trú cụ thể, thì giá cho số lượng người lưu trú cao tiếp theo sẽ được sử dụng. Bạn cũng có thể xác định các khoản phí cho khách và trẻ em đi kèm bằng cách sử dụng AdditionalGuestAmounts hoặc ExtraGuestCharges. Các khoản phí này được áp dụng cho đến khi đạt đến số lượng khách tối đa được xác định cho một phòng.

Lợi ích và ví dụ

Hiệu quả

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

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

Kiểm soát

Bạn có thể cung cấp mức giá riêng biệt cho các số lượng người lưu trú khác một cách rõ ràng. Gửi một mức giá khác cho mỗi giá trị số người lưu trú nếu bạn muốn có nhiều quyền kiểm soát hơn đối với cách Google so khớp các yêu cầu với tỷ lệ lấp đầy.

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

Để biết thêm ví dụ về nhiều tình huống liên quan đến tốc độ, 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 Các phần tử và thuộc tính về tỷ giá.

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

Hãy tham khảo ví dụ về Cú pháp tỷ giá khi tạo thông báo Tỷ giá để đảm bảo bạn đang tuân 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 về giá, hãy xem lược đồ 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 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 mức giá được cộng lại trong các ngày lưu trú để tính ra tổng giá. 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 thời gian lưu trú

Mô hình định giá dựa trên thời gian lưu trú (LOS) dựa trên mức giá được đặt cho tổ hợp ngày đến và thời gian lưu trú. Mức giá được chỉ định theo mô hình định giá dựa trên thời gian lưu trú là mức giá mỗi ngày. Ví dụ: Nếu bạn gửi mức giá là 1.000.000 VND cho thời gian lưu trú là 3 ngày, thì tổng giá được tính là 3 x 1.000.000 VND=3.000.000 VND.

Bạn có thể sử dụng mô hình định giá dựa trên thời gian lưu trú bằng cách chỉ định RatePlanType="26" trên các phần tử StatusApplicationControl. Bạn cũng cần đặt các 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ả giá đều á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ị thời gian lưu trú được chỉ định cho UnitMultiplier.Rate

Bạn có thể sử dụng cả mô hình định giá theo ngày và mô hình định giá theo thời gian lưu trú 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 định giá. Hãy lưu ý những điểm sau khi triển khai mức giá dựa trên LOS:

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

Để bật tính năng định giá dựa trên thời gian lưu trú trong tài khoản của bạn, hãy gửi yêu cầu thông qua TAM hoặc liên hệ với chúng tôi.

Nguyên tắc hoặc hành động

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 được chỉ định về loại phòng, gói giá và ngày lưu trú được chỉ định trong <StatusApplicationControl>.

  • Theo mặc định, các bản cập nhật giá sử dụng thao tác Delta.
  • Thông tin cập nhật Delta không làm thay đổi bất kỳ mức giá nào đã lưu trước đó cho các mức độ sử dụng khác. Ví dụ: nếu bạn đã chỉ định giá cho phòng đơn và phòng đôi, đồng thời gửi thông tin cập nhật giá Delta cho phòng đơn, thì giá phòng đôi vẫn không thay đổi.

Overlay: Xoá mọi đơn 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 đơn giá mới. Ví dụ: nếu bạn đã chỉ định mức giá cho phòng một người và phòng hai người, đồng thời bạn gửi thông tin cập nhật Overlay cho phòng một người, thì Google sẽ xoá tất cả mức giá trước đó (cả phòng một người và phòng hai người) và chỉ giữ lại mức giá phòng một người sau khi cập nhật.

Remove: Xoá mọi đơn 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>.

Giá dựa trên thời gian lưu trú

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

  • Theo mặc định, các bản cập nhật giá sử dụng thao tác Delta.
  • Việc cập nhật Delta không làm thay đổi bất kỳ mức giá nào đã lưu trữ trước đó cho 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, đồng thời gửi thông tin cập nhật về mức giá Delta cho LOS 1, thì mức giá theo số người lưu trú của LOS 2 vẫn không thay đổi.
  • Bản cập nhật Delta sẽ ghi đè tất cả mức giá theo số người lưu trú đã lưu trữ trước đó cho thời gian lưu trú nhất định. Ví dụ: nếu bạn đã chỉ định giá phòng đơn và giá phòng đôi cho LOS 1, đồng thời gửi thông tin cập nhật giá Delta cho LOS 1 chỉ có giá phòng đơn, thì giá phòng đôi sẽ bị xoá.

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

Remove: Xoá tất cả đơn giá hiện tại 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 được chỉ định trong <StatusApplicationControl>.

Liên quan đến thuế

Nếu 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 loại thuế phức tạp, chẳng hạn như thuế và phí áp dụng cho mỗi lượt lưu trú (thay vì mỗi đêm) trong AmountAfterTax.

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

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

Bạn phải thêm tất cả các loại 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.v.), ngay cả khi người dùng 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 cách dùng 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 gửi/POST thông báo, hãy xem phần Gửi thông báo.

Đối với HotelCode, hãy sử dụng Mã nhận dạng riêng biệt của khách sạn mà bạn đã dùng trong hệ thống để 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> trong 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ã 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 Google hiển thị chính xác giá và dữ liệu của bạn.

Ví dụ này cho thấy cách đặt mức 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 những trường hợp bạn có thể gặp phải khi gửi thông báo về Giá.

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

Tình huống 1: Cách thay đổi giá theo số người lưu trú

Mô tả

Trước đây, giá theo đêm chỉ được xác định 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 tỷ lệ lấp đầy 1 mới bằng bản cập nhật có phạm vi Delta mặc định. Giá trị mới này không ảnh hưởng đến tỷ lệ sử dụng 2.

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

Mô tả

Trước đây, bạn đã xác định giá cho sức chứa từ 1 đến 4, nhưng giờ đây chỉ 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ả đơn giá theo sức chứa cho một cơ sở lưu trú, loại phòng, gói giá và(các) ngày nhất định. Trong trường hợp này, thao tác Overlay sẽ liệt kê giá cho số người lưu trú là 1 và 2.

Tình huống 3: Cách đặt cùng một mức giá cho nhiều tỷ lệ kín phòng

Mô tả

Bạn có thể bán một mức giá cho một số lượng người 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á tin nhắn bằng cách chỉ gửi thông tin cập nhật về mức giá cho số lượng người lưu trú tối đa có thể áp dụng.

Giải pháp

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