Übersicht
Die Preisnachricht (OTA_HotelRateAmountNotifRQ
) definiert die Übernachtung.
Belegungspreise für jede Kombination aus Zimmertyp und Preisplan für ein bestimmtes Datum
Bereiche. Im Rahmen der Preisnachricht unterstützt Google nutzungsbasierte Preise,
Sie können damit unterschiedliche Übernachtungspreise basierend auf der maximalen Anzahl
der beabsichtigten Personen.
In den folgenden Abschnitten finden Sie allgemeine Richtlinien, ein einfaches Beispiel und eine Anleitung. die Ihnen dabei helfen sollen, Preise hinzuzufügen und zu aktualisieren Nachricht bewerten.
Verhalten der Abgleichsrate
Wenn Nutzer eine bestimmte Belegung anfordern, hängt der Preis, den sie sehen, von wie Sie Preise in Ihrer Preisnachricht definieren. In diesem Abschnitt wird erläutert, wie diese Nutzeranfragen anhand der Belegung ihrer Anfrage und der von Ihnen festgelegten Preise Ihren Preisen zugeordnet werden.
Grundprinzipien
Ein Preis, der für eine bestimmte Belegung definiert ist, gilt für alle geringeren Belegungen, sofern nicht anders definiert.
Anfragen für Belegungen über diesen definierten Belegungen werden als nicht möglich angesehen.
Die belegungsabhängigen Preise gelten sowohl für die Preise pro Datum als auch für die unten beschriebenen LOS-basierten Preismodelle. Sie können also Preise für jede Belegung angeben. Wenn für eine bestimmte Belegung kein Preis vorhanden ist, wird der Preis für wird die nächsthöhere Belegung verwendet. Sie können auch Gebühren für weitere Gäste und Kinder nutzen
AdditionalGuestAmounts
oderExtraGuestCharges
Dieser wird bis zur für einen Raum definierten Kapazität angewendet.
Vorteile und Beispiele
- Effizienz
Für mehrere Belegungen mit demselben Preis müssen Sie keine Preis pro Belegung. Sie können Ihre Nachrichten vereinfachen, indem Sie nur die höchster Belegungswert, der vom Zimmertyp und Preisplan unterstützt wird. Nutzer sehen diesen Preis für jede Belegung, die kleiner oder gleich Ihrem festgelegten Wert ist Wert.
Beispiel: Die Preise für einen Zimmertyp und einen Preisplan sind für 1 bis 4 Belegungen. Verwenden Sie die Preisnachricht, um einen Preis für einen maximalen Belegung von 4 Personen. Nutzer, die nach einer Einzel-, Doppel- oder Dreibettbelegung suchen wird derselbe Preis angezeigt. Nutzern, die nach „5“ oder höher suchen, werden keine Preise angezeigt.
- Steuerung
Gesonderte Preise für alternative Belegungen können explizit angegeben werden. Senden unterschiedliche Preise für jeden Belegungswert festlegen, Google gleicht Anfragen mit Belegungsraten ab.
Beispiel:Wenn Preise für 3 und 1 Belegung definiert sind, gilt eine Einzelbelegung. wird der Einzelpreis angezeigt, bei der Suche nach einem Doppelzimmer und Nutzer, die nach einer Belegung mit 4 Personen und höher suchen, Raten.
Weitere Beispiele für verschiedene preisbezogene Szenarien finden Sie unter Anleitungen
Erforderliche und optionale Elemente
In der XML-Referenz finden Sie Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu und untergeordneten Elementen, siehe Preiselemente und Attribute:
Syntax und Schemas
Verwenden Sie die Preissyntax. Beispiel als Referenz verwenden, wenn Sie die Rate-Nachricht erstellen, um sicherzustellen, das richtige Format verwendet wird.
Sie können ein XML-Tool eines Drittanbieters wie xmllint verwenden, um Ihre Feeds mit veröffentlichten Schemas vor der Übermittlung an Google zu prüfen. Das Schema für Preisnachrichten finden Sie unter Hotelanzeigen-Schemas.
Preismodelle
Preis pro Datum
Dies ist das Standardpreismodell für die meisten Unterkünfte. Das per-date
Preismodell basiert auf der Festlegung von Preisen, die über den Aufenthaltszeitraum addiert werden, um
zu einem Gesamtpreis. Bei diesem Modell sind alle Preise unter einem Rate
-Element
als auf einen Aufenthaltszeitraum interpretiert, der in den
<StatusApplicationControl>
.
Auf der Aufenthaltsdauer basierende Preise
Das auf der Aufenthaltsdauer basierende Preismodell basiert auf Preisen, die für einen Kombination aus Ankunftsdatum und Aufenthaltsdauer. Die Preise, die in den Auf der Aufenthaltsdauer basierende Preismodelle gelten pro Tag. Wenn Sie beispielsweise einen Preis von 100 € für eine Aufenthaltsdauer von 3 $ berechnet sich der Gesamtpreis wie folgt: 3 × 100 $=300 $.
Sie können das auf der Aufenthaltsdauer basierende Preismodell nutzen, indem Sie
RatePlanType="26"
für StatusApplicationControl
-Elemente. Außerdem müssen Sie
Legen Sie die Attribute RateTimeUnit
und UnitMultiplier
für Rate
-Elemente in Ihrem
XML. Dadurch gelten alle Preise unter dem angegebenen Rate
-Element für Aufenthalte
definiert durch die in <StatusApplicationControl>
angegebenen Ankunftsdaten und die
Wert der Aufenthaltsdauer für UnitMultiplier
angegeben.
Sie können sowohl datumsbasierte als auch auf Aufenthaltsdauer basierende Preismodelle in einem einzigen Konto, sollte jedoch für jede Unterkunft nur ein einziges Preismodell verwendet werden. Beachten Sie beim Implementieren von auf der Aufenthaltsdauer basierenden Preisen die folgenden Punkte:
- Preise für verschiedene Aufenthaltsdauern werden bei Aufenthalten basierend auf der Aufenthaltsdauer nicht kombiniert Preise. Beispielsweise wird eine Aufenthaltsdauer von 3 nicht mit einer Aufenthaltsdauer von 1, um einen Preis von 4 für die Aufenthaltsdauer festzulegen. Bei der Aufenthaltsrate von 4 muss explizit angegeben werden, angegeben ist.
- Der Preis für 1 Nacht in auf der Aufenthaltsdauer basierenden Preisen wird nicht als Einzelnachtspreis verwendet. Preismodell pro Datum.
- Für jede Unterkunft sollten nur die auf der Aufenthaltsdauer basierenden Preise oder die Preise pro Tag verwendet werden je nachdem, wie die Preise in Ihrem System dargestellt werden.
Um auf der Aufenthaltsdauer basierende Preise in Ihrem Konto zu aktivieren, stellen Sie die Anfrage über Ihren TAM oder kontaktieren Sie uns.
Richtlinien oder Maßnahmen
- Preis pro Datum
Delta
: Fügen Sie die Preise pro Person nur für die in<StatusApplicationControl>
angegebenen Kombinationen aus Zimmertyp, Preisplan und Aufenthaltsdaten hinzu oder aktualisieren Sie diese.- Für Preisaktualisierungen wird standardmäßig die Aktion
Delta
verwendet. - Eine Aktualisierung von
Delta
ändert keine zuvor gespeicherten Preise für andere Belegungen. Wenn Sie z. B. Preise für einfache und Doppelzimmern gebucht sind und eine Preisaktualisierung in Höhe vonDelta
für das Einzelzimmer Belegung bleibt, bleibt der Preis für ein Doppelzimmer unverändert.
- Für Preisaktualisierungen wird standardmäßig die Aktion
Overlay
: Löschen Sie alle vorhandenen Preise pro Belegung für den Zimmertyp. Preisplan und die in<StatusApplicationControl>
angegebenen Termine mit neuen Preisen. Wenn Sie z. B. Preise für einfache und Doppelzimmern gebucht werden und Sie senden eineOverlay
-Aktualisierung für Einzelbelegung entfernt Google alle vorherigen Preise (sowohl Einzel- als auch Doppelpreise). Belegungen) und nur der Preis für eine Einzelbelegung bleibt nach der Aktualisierung erhalten.Remove
: Löschen Sie alle vorhandenen Preise pro Belegung für den Zimmertyp. Preisplan und die in<StatusApplicationControl>
angegebenen Termine.- Preise je nach Aufenthaltsdauer
Delta
: Fügen Sie Preise pro LOS-Wert nur für die in<StatusApplicationControl>
angegebenen Kombinationen aus Zimmertyp, Preisplan und Check-in-Datum hinzu oder aktualisieren Sie diese. Ersetzt alle Preise pro Belegung, die mit mit den aktualisierten Werten für die Aufenthaltsdauer.- Für Preisaktualisierungen wird standardmäßig die Aktion
Delta
verwendet. - Eine Aktualisierung von
Delta
ändert keine zuvor gespeicherten Preise für andere Aufenthaltsdauer. Wenn Sie z. B. Preise für die Aufenthaltsdauer 1 und 2 angegeben haben, und eine Aktualisierung des PreisesDelta
für die Aufenthaltsdauer 1 und dann die Preise pro Belegung für die Aufenthaltsdauer 2 senden bleiben unverändert. - Eine
Delta
-Aktualisierung überschreibt alle zuvor gespeicherten Preise pro Belegung für die angegebene Aufenthaltsdauer. Wenn Sie z. B. einfache und Preise für Doppelzimmer für die Aufenthaltsdauer 1 und eine Aktualisierung des Preises vonDelta
für Aufenthaltsdauer 1. mit nur einem Einzelbelegungspreis wird der Preis für Doppelbelegung entfernt.
- Für Preisaktualisierungen wird standardmäßig die Aktion
Overlay
: Löschen Sie alle vorhandenen Preise pro Belegung für die Aufenthaltsdauer, das Zimmer Typ, Preisplan und Check-in-Daten, die in<StatusApplicationControl>
angegeben sind und ersetzen Sie sie durch neue Preise. Wenn Sie z. B. Preise für LOS 1 und 2 und Sie senden eine Aktualisierung in Höhe vonOverlay
für LOS 1, entfernt Google alle vorherigen Preise (sowohl die Aufenthaltsdauer 1 als auch die Aufenthaltsdauer 2) und nur der Preis für die Aufenthaltsdauer 1 bleibt unverändert. nach der Aktualisierung.Remove
: Löschen Sie alle vorhandenen Preise pro Belegung für die gesamte Aufenthaltsdauer der Zimmertyp, Preisplan und Check-in-Daten angegeben in<StatusApplicationControl>
.- Steuerbezogen
Wenn Steuern und Gebühren einfach sind, kann der Gesamtbetrag mit
AmountAfterTax
Komplexe Steuern, beispielsweise für Steuern und Gebühren pro Aufenthalt (anstatt pro Nacht) kann inAmountAfterTax
nicht dargestellt werden.Im Allgemeinen empfiehlt Google die Verwendung von
TaxFeeInfo
stattAmountAfterTax
.Wenn möglich, sollten Sie
AmountBeforeTax
einfügen (auch wenn SieAmountAfterTax
), da in bestimmten Sprachen (z. B. USA) der Messwert ohne Steuern.Alle Steuern und Gebühren, die der Nutzer zahlen muss (MwSt., Aufenthaltssteuer, Reinigungsgebühren, Stadt). Steuern usw.) enthalten, auch wenn sie nicht zum Zeitpunkt der Buchung bezahlt werden oder nicht direkt an die Unterkunft gezahlt.
Beispiel
Dieser Abschnitt enthält ein einfaches Beispiel für eine Rate-Nachricht mit den erforderlichen und
optionale Elemente. Nachdem Sie Ihre Datei vorbereitet haben, müssen Sie sie mithilfe
eine POST-Nachricht an folgenden Endpunkt:
https://www.google.com/travel/hotels/uploads/property_data
Weitere Informationen zum Übertragen von Nachrichten per Push oder POSTEN finden Sie unter Nachrichten senden.
Verwenden Sie für HotelCode
die eindeutige Hotel-ID, die Sie in Ihrem System für
zur Identifizierung der Unterkunft. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mithilfe von
<id>
im <listing>
-Element
im Hotellisten-Feed ein. Verwenden Sie für <PackageID>
und <RoomID>
dieselben IDs wie
die Sie in Ihrem System für Preispläne bzw. Zimmertypen verwenden können. Consistency (Einheitlichkeit)
mit Ihrem System verknüpft ist, ist wichtig,
um sicherzustellen, dass Google
Ihre Preise und Daten.
In diesem Beispiel wird gezeigt, wie Sie Preise mit einer Delta
-Aktion festlegen:
<?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>
Anleitungen
In diesem Abschnitt finden Sie Lösungen für Szenarien, die beim Senden Nachrichten bewerten
Beispiele für das Hinzufügen, Entfernen und Aktualisieren von Raten finden Sie unter Rate Beispiele.
Szenario 1: Preise pro Person ändern
Beschreibung
Zuvor wurden Übernachtungspreise nur für Doppelbelegungen festgelegt. gilt für Einzelbelegung, aber jetzt gibt es einen günstigeren Preis für Einzelzimmer Belegung.
Lösung
Senden Sie den neuen Preis für Belegung 1 mit dem standardmäßigen Delta
-bezogenen Update. Diese neue
hat keinen Einfluss auf den Belegung 2-Preis.
Szenario 2: So ersetzen Sie Preise pro Belegung für eine Unterkunft
Beschreibung
Sie haben zuvor Preise für die Belegungen 1 bis 4 festgelegt, aber jetzt nur Die Belegungen 1 und 2 sind gültig.
Lösung
Verwenden Sie NotifType="Overlay"
, um alle Belegungsraten für eine bestimmte Unterkunft zu ersetzen.
Zimmertyp, Preisplan und Datum. In diesem Szenario würde die Aktion Overlay
Preise für die Belegung 1 und 2 auflisten.
Szenario 3: Gleiche Preise für mehrere Belegungen festlegen
Beschreibung
Ein Preis für eine bestimmte Belegung kann an eine Gruppe mit weniger Personen verkauft werden. In dieser können Sie Ihre Nachrichten vereinfachen, indem Sie nur die Ratenaktualisierung für maximal mögliche Belegung.
Lösung
Wenn Sie für mehrere Belegungen denselben Preis haben, legen Sie die höchste Belegung fest. Wert, der vom Zimmertyp und Preisplan unterstützt wird, und er wird automatisch verwendet diesen Wert für niedrigere Belegungen. Das heißt, Sie müssen nicht dieselben Übernachtungspreis für Belegungen von 1 bis 6 Personen, wenn alle gleich sind; stelle es einfach auf 6 ein.