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 giá mỗi đêm giá về số người lưu trú cho từng loại phòng và tổ hợp gói giá cho ngày cụ thể phạm vi ngày. Trong thông báo Giá, Google hỗ trợ việc đặt giá dựa trên số người lưu trú. cho phép chỉ định các mức giá mỗi đêm khác nhau dựa trên số lượng tối đa của những người lưu trú theo dự định.

Các phần sau bao gồm nguyên tắc chung, ví dụ cơ bản và hướng dẫn để bắt đầu thêm và cập nhật giá phòng, cũng như gửi Xếp hạng tin nhắn.

Hành vi so khớp tỷ lệ

Khi người dùng yêu cầu về sức chứa cụ thể, mức giá mà họ nhìn thấy sẽ phụ thuộc cách xác định giá trong thông báo Giá. Phần này đề cập đến cách 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ố người lưu trú trong khách sạn và tỷ lệ 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ả số người lưu trú thấp hơn, trừ phi có quy định khác.
Những yêu cầu về số người lưu trú trên mức đã xác định được coi là không thể thực hiện.
Mức giá dựa trên số người lưu trú áp dụng cho cả mô hình giá theo ngày và mô hình giá dựa trên LOS được mô tả bên dưới. Điều này có nghĩa là bạn có thể chỉ định mức giá cho mỗi số người lưu trú. Nếu không có giá cho một số người lưu trú cụ thể, thì giá dành cho số người lưu trú cao nhất tiếp theo sẽ được sử dụng. Bạn cũng có thể xác định khoản phí cho khách và trẻ em bổ sung sử dụng AdditionalGuestAmounts hoặc ExtraGuestCharges được áp dụng lên đến sức chứa đã xác định cho một phòng.

Lưu ý quan trọng: Mỗi cơ sở lưu trú có giới hạn là 100 khoản phí bổ sung cho khách lưu trú. Bạn có thể sử dụng tin nhắn ExtraGuestCharge để loại bỏ phí lưu trú bổ sung cho khách.

Lợi ích và ví dụ

Hiệu quả

Đối với nhiều phòng có sức chứa giống nhau, bạn không cần phải đặt giá cho mỗi người lưu trú. Bạn có thể đơn giản hoá thông báo của mình bằng cách chỉ đặt giá trị cao nhất cho số người lưu trú 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ú thấp hơn hoặc bằng mức giá mà bạn đã đặt giá trị.

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

Kiểm soát

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

Ví dụ: Nếu giá được xác định cho số người lưu trú là 3 và 1, thì mức giá cho phòng một người kết quả tìm kiếm sẽ hiển thị giá phòng đơn, tìm kiếm phòng hai người sẽ hiển thị tỷ lệ cho phòng 3 người và những người dùng tìm kiếm từ 4 người trở lên sẽ không thấy giá.

Để xem thêm ví dụ về nhiều trường hợp liên quan đến giá phòng, hãy xem 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 thông tin 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ề và các phần tử con, xem Thành phần giá & Thuộc tính.

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

Sử dụng Cú pháp giá làm ví dụ để tham khảo khi tạo Thông báo giá để đảm bảo theo đú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 với các giản đồ được xuất bản trước khi gửi cho Google. Đối với thông báo Xếp hạng 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á chuẩn được sử dụng cho hầu hết các cơ sở lưu trú. Mô hình đặt giá per-date dựa trên việc thiết lập mức giá được tổng hợp trên 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 phạm vi ngày lưu trú được chỉ định trong <StatusApplicationControl>.

Giá theo thời gian lưu trú

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

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 thuộc tính RateTimeUnit và UnitMultiplier trên các phần tử Rate trong XML. Việc này sẽ áp dụng tất cả mức giá trong phần tử Rate nhất định cho các lượt lưu trú được xác định theo ngày đến được chỉ định trong <StatusApplicationControl> và Đã chỉ định giá trị LOS cho UnitMultiplier.

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

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

Để bật giá dựa trên thời gian lưu trú (LOS) trên tài khoản của bạn, hãy gửi yêu cầu thông qua Nhà quản lý hỗ trợ kỹ thuật (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 mức giá mỗi người lưu trú cho một số người được chỉ định các kiểu kết hợp loại phòng, gói giá và ngày lưu trú được chỉ định ở <StatusApplicationControl>.

Theo mặc định, các bản cập nhật giá sẽ 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á được lưu trữ trước đó cho các số người lưu trú. Ví dụ: nếu bạn đã chỉ định mức giá cho một và phòng hai người và gửi thông tin cập nhật giá Delta cho phòng đơn phòng có người lưu trú, thì mức giá cho phòng hai người vẫn không thay đổi.

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

Remove: Xoá tất cả giá hiện tại theo số người lưu trú cho loại phòng đó, gói giá và ngày được chỉ định trong <StatusApplicationControl>.

Giá theo thời gian lưu trú

Delta: Chỉ thêm hoặc cập nhật mức giá theo giá trị thời gian lưu trú cho một đơn vị lưu trú được chỉ định các kiểu kết hợp 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 bằng các giá trị LOS được cập nhật.

Theo mặc định, các yêu cầu cập nhật giá phòng sẽ sử dụng thao tác Delta.
Việc cập nhật Delta không làm thay đổi giá phòng đã lưu trữ trước đó cho các thời gian lưu trú. Ví dụ: nếu bạn đã chỉ định mức giá cho LOS 1 và 2, rồi gửi thông tin cập nhật giá Delta cho ngày lưu trú 1, sau đó gửi giá mỗi người lưu trú của LOS 2 vẫn không thay đổi.
Nội dung cập nhật của Delta sẽ thay thế mọi mức giá theo số người lưu trú được lưu trữ trước đó cho thời gian lưu trú nhất định. Ví dụ: nếu bạn đã chỉ định duy nhất và mức giá cho phòng hai người cho ngày LOS 1 và gửi thông tin cập nhật giá Delta cho ngày LOS 1 chỉ có một 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á tất cả giá hiện tại theo số người lưu trú cho thời gian lưu trú, phòng loại, gói giá và ngày nhận phòng được chỉ định ở <StatusApplicationControl> và thay thế chúng bằng các 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 thông tin cập nhật về Overlay cho LOS 1 thì Google sẽ xoá tất cả các mức giá trước đó (cả LOS 1 và 2) và chỉ có tỷ lệ LOS 1 là được giữ nguyên sau khi cập nhật.

Remove: Xoá tất cả đơn giá hiện tại theo số người lưu trú 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. Các khoản thuế phức tạp, chẳng hạn như các khoản thuế và phí áp dụng theo thời gian lưu trú (thay vì mỗi đêm) không thể được biểu thị 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 thêm AmountBeforeTax (ngay cả khi bạn chỉ định AmountAfterTax) vì một số ngôn ngữ nhất định (ví dụ: Hoa Kỳ) hiển thị giá trước thuế theo mặc định.

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

Ví dụ:

Phần này đưa ra một ví dụ cơ bản về một Thông báo giá sử dụng các trường bắt buộc và các phần tử không bắt buộc. Sau khi chuẩn bị tệp, bạn phải gửi tệp đó đến Google bằng cách sử 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 đẩy/ĐĂNG 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ã khách sạn duy nhất mà bạn đã sử 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 sử dụ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ột mã nhận dạng mà bạn sử dụng trong hệ thống của bạn cho các gói giá và loại phòng (tương ứng). Sự đều đặn với hệ thống của bạn là rất quan trọng để đảm bảo rằng Google hiển thị chính xác giá và dữ liệu của bạn.

Ví dụ sau cho thấy cách đặt mức giá bằng hành động 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 trường hợp mà bạn có thể gặp phải khi gửi tin nhắn Đánh giá.

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

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

Mô tả

Trước đây, mức giá mỗi đêm được xác định là chỉ cho phòng hai người (hiện cũng có áp dụng cho phòng một người), nhưng hiện có mức giá rẻ hơn cho phòng đơn số người lưu trú.

Giải pháp

Gửi giá mới cho số người lưu trú 1 bằng cách sử dụng thông tin cập nhật mặc định trong phạm vi Delta. Thông tin mới này không ảnh hưởng đến giá cho số người lưu trú 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 hiện tại chỉ áp dụng số người lưu trú 1 và 2 là hợp lệ.

Giải pháp

Sử dụng NotifType="Overlay" để thay thế tất cả mức giá cho số người lưu trú của một cơ sở lưu trú cụ thể, loại phòng, gói giá và(các) ngày. Trong trường hợp này, hành động Overlay sẽ niêm yết 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 mức sức chứa

Mô tả

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

Giải pháp

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