Nachricht bewerten

Übersicht

In der Nachricht „Rate“ (OTA_HotelRateAmountNotifRQ) werden die Übernachtungspreise pro Person für jede Kombination aus Zimmertyp und Preisplan für bestimmte Zeiträume definiert. Im Rahmen der Ratenmitteilung unterstützt Google die belegungsbasierte Preisgestaltung. So können unterschiedliche Preise pro Übernachtung basierend auf der maximalen Anzahl der vorgesehenen Gäste angegeben werden.

In den folgenden Abschnitten finden Sie allgemeine Richtlinien, ein einfaches Beispiel und Anleitungen, die Ihnen den Einstieg in das Hinzufügen und Aktualisieren von Raten und das Senden einer Ratenbenachrichtigung erleichtern.

Verhalten der Abgleichsrate

Wenn Nutzer bestimmte Belegungen anfragen, hängt der angezeigte Preis davon ab, wie Sie die Preise in Ihrer Ratenbenachrichtigung definieren. In diesem Abschnitt wird beschrieben, wie diese Nutzeranfragen je nach Belegung und den von Ihnen festgelegten Preisen mit Ihren Preisen abgeglichen werden.

Wichtige Grundsätze

  • Ein für eine bestimmte Belegung definierter Preis gilt für alle geringeren Belegungen, sofern nicht anders definiert.

  • Anfragen für Belegungen, die über die definierten Werte hinausgehen, werden als nicht möglich betrachtet.

  • Die belegungsbasierte Preisgestaltung gilt sowohl für die unten beschriebenen Preismodelle mit Preisen pro Datum als auch für die Preismodelle mit Preisen basierend auf der Aufenthaltsdauer. Das bedeutet, dass Sie Raten für jede Belegung angeben können. Wenn kein Preis für eine bestimmte Belegung vorhanden ist, wird der Preis für die nächsthöhere Belegung verwendet. Sie können auch Gebühren für zusätzliche Gäste und Kinder mit AdditionalGuestAmounts oder ExtraGuestCharges definieren, die bis zur für ein Zimmer definierten Kapazität angewendet werden.

Vorteile und Beispiele

Effizienz

Bei mehreren Belegungen mit demselben Preis müssen Sie nicht für jede Belegung einen Preis festlegen. Sie können Ihre Nachrichten vereinfachen, indem Sie nur den höchsten Belegungswert festlegen, der vom Zimmertyp und Tarif unterstützt wird. Nutzer sehen diesen Preis für jede Belegung, die kleiner oder gleich dem von Ihnen festgelegten Wert ist.

Beispiel: Die Preise für einen Zimmertyp und einen Preisplan sind für eine bis vier Personen gleich. Mit „Rate message“ können Sie einen Preis für eine maximale Belegung von 4 Personen festlegen. Nutzer, die nach Einzel-, Doppel- und Dreifachbelegung suchen, sehen denselben Preis. Nutzer, die nach 5 Sternen oder mehr suchen, sehen keine Raten.

Steuerung

Sie können explizit unterschiedliche Preise für alternative Belegungen angeben. Senden Sie für jeden Belegungswert einen anderen Tarif, wenn Sie mehr Kontrolle darüber haben möchten, wie Google Anfragen mit Belegungsraten abgleicht.

Beispiel:Wenn Preise für 3 und 1 Personen definiert sind, wird bei der Suche nach Einzelbelegung der Preis für Einzelbelegung angezeigt, bei der Suche nach Doppelbelegung der Preis für 3 Personen und bei der Suche nach 4 oder mehr Personen kein Preis.

Weitere Beispiele für verschiedene ratenbezogene Szenarien finden Sie in den Anleitungen.

Erforderliche und optionale Elemente

In der XML-Referenz finden Sie Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu Attributen und untergeordneten Elementen finden Sie unter Rate Elements & Attributes.

Syntax und Schemas

Verwenden Sie das Beispiel für die Raten-Syntax als Referenz, wenn Sie die Raten-Nachricht erstellen, damit Sie das richtige Format verwenden.

Sie können ein XML-Tool eines Drittanbieters wie xmllint verwenden, um Ihre Feeds mit den veröffentlichten Schemas zu validieren, bevor Sie sie an Google senden. Informationen zum Schema der Ratenbenachrichtigung finden Sie unter Hotelanzeigenschemas.

Preismodelle

Preise pro Datum

Dies ist das Standardpreismodell, das für die meisten Unterkünfte verwendet wird. Das per-date-Preismodell basiert auf der Festlegung von Preisen, die über die Aufenthaltsdaten hinweg addiert werden, um einen Gesamtpreis zu erhalten. In diesem Modell werden alle Raten unter einem Rate-Element als für einen im <StatusApplicationControl>-Element angegebenen Zeitraum gültig interpretiert.

Preise je nach Aufenthaltsdauer

Das Preismodell basierend auf der Aufenthaltsdauer basiert auf Preisen, die für eine Kombination aus Anreisedatum und Aufenthaltsdauer festgelegt wurden. Die Preise, die im auf der Aufenthaltsdauer basierenden Preismodell angegeben sind, gelten pro Tag. Wenn Sie beispielsweise einen Preis von 100 $für einen Aufenthalt von 3 Nächten senden, wird der Gesamtpreis als 3 × 100$=300$berechnet.

Sie können das auf der Aufenthaltsdauer basierende Preismodell verwenden, indem Sie RatePlanType="26" für StatusApplicationControl-Elemente angeben. Außerdem müssen Sie die Attribute RateTimeUnit und UnitMultiplier für Rate-Elemente in Ihrem XML festlegen. Dadurch gelten alle Preise unter dem angegebenen Rate-Element für Aufenthalte, die durch die in <StatusApplicationControl> angegebenen Anreisedaten und den für UnitMultiplier angegebenen Wert für die Aufenthaltsdauer definiert sind.

Sie können sowohl datumsbezogene als auch auf der Aufenthaltsdauer basierende Preismodelle in einem einzigen Konto verwenden. Für jede Unterkunft sollte jedoch nur ein Preismodell verwendet werden. Beachten Sie bei der Implementierung von Preisen auf Grundlage der Aufenthaltsdauer die folgenden Punkte:

  • Preise für verschiedene Aufenthaltsdauern werden bei der Verwendung von auf der Aufenthaltsdauer basierenden Preisen nicht kombiniert. Eine Aufenthaltsdauer von 3 Tagen wird beispielsweise nicht mit einer Aufenthaltsdauer von 1 Tag kombiniert, um den Preis für eine Aufenthaltsdauer von 4 Tagen zu berechnen. Die Wahrscheinlichkeit für einen LOS von 4 muss explizit angegeben werden.
  • Der Preis für eine Übernachtung bei auf der Aufenthaltsdauer basierenden Preisen wird nicht als Preis für eine einzelne Nacht bei Preisen pro Datum verwendet.
  • Für jede Unterkunft sollte entweder die Preisgestaltung auf Grundlage der Aufenthaltsdauer oder die Preisgestaltung pro Datum verwendet werden, je nachdem, wie die Preise in Ihrem System dargestellt werden.

Wenn Sie auf der Aufenthaltsdauer basierende Preise für Ihr Konto aktivieren möchten, wenden Sie sich an Ihren TAM oder kontaktieren Sie uns.

Richtlinien oder Aktionen

Preise pro Datum

Delta: Fügen Sie die Preise pro Person nur für die angegebenen Kombinationen aus Zimmertyp, Preisplan und Aufenthaltsdaten, die in <StatusApplicationControl> angegeben sind, hinzu oder aktualisieren Sie diese.

  • Für Ratenaktualisierungen wird standardmäßig die Aktion Delta verwendet.
  • Durch eine Delta-Aktualisierung werden zuvor gespeicherte Preise für andere Belegungen nicht geändert. Wenn Sie beispielsweise Preise für Einzel- und Doppelzimmer angegeben haben und eine Delta-Preisaktualisierung für das Einzelzimmer senden, bleibt der Preis für das Doppelzimmer unverändert.

Overlay: Löschen Sie alle vorhandenen Preise pro Person für den Zimmertyp, den Preisplan und die Termine, die in <StatusApplicationControl> angegeben sind, und ersetzen Sie diese durch neue Preise. Wenn Sie beispielsweise Preise für Einzel- und Doppelzimmer angegeben haben und ein Overlay-Update für ein Einzelzimmer senden, entfernt Google alle vorherigen Preise (sowohl für Einzel- als auch für Doppelzimmer). Nach dem Update ist nur noch der Preis für das Einzelzimmer vorhanden.

Remove: Löschen Sie alle vorhandenen Preise pro Person für den Zimmertyp, den Preisplan und die Termine, die in <StatusApplicationControl> angegeben sind.

Preise je nach Aufenthaltsdauer

Delta: Fügen Sie Preise pro LOS-Wert nur für die angegebenen Kombinationen aus Zimmertyp, Preisplan und Check-in-Terminen hinzu, die in <StatusApplicationControl> angegeben sind, oder aktualisieren Sie diese. Ersetzt alle Belegungsraten, die mit den aktualisierten LOS-Werten verknüpft sind.

  • Für Ratenaktualisierungen wird standardmäßig die Aktion Delta verwendet.
  • Durch eine Delta-Aktualisierung werden zuvor gespeicherte Preise für andere Aufenthaltsdauern nicht geändert. Wenn Sie beispielsweise Raten für LOS 1 und 2 angegeben haben und eine Delta-Ratenaktualisierung für LOS 1 senden, bleiben die Raten pro Belegung für LOS 2 unverändert.
  • Bei einer Delta-Aktualisierung werden alle zuvor gespeicherten Belegungsraten für den angegebenen Zeitraum überschrieben. Wenn Sie beispielsweise Preise für Einzel- und Doppelbelegung für LOS 1 angegeben haben und eine Delta-Preisaktualisierung für LOS 1 mit nur einem Preis für Einzelbelegung senden, wird der Preis für Doppelbelegung entfernt.

Overlay: Löschen Sie alle vorhandenen Preise pro Person für die Aufenthaltsdauer, den Zimmertyp, den Preisplan und die Check-in-Termine, die in <StatusApplicationControl> angegeben sind, und ersetzen Sie diese durch neue Preise. Wenn Sie beispielsweise Preise für LOS 1 und 2 angegeben haben und ein Overlay-Update für LOS 1 senden, entfernt Google alle vorherigen Preise (sowohl für LOS 1 als auch für LOS 2). Nach dem Update ist nur noch der Preis für LOS 1 vorhanden.

Remove: Löschen Sie alle vorhandenen Preise pro Person für alle Aufenthaltsdauern des Zimmertyps, des Preisplans und der Check-in-Termine, die in <StatusApplicationControl> angegeben sind.

Steuerbezogen

Wenn Steuern und Gebühren einfach sind, kann der Gesamtbetrag mit AmountAfterTax angegeben werden. Komplexe Steuern, z. B. Steuern und Gebühren, die pro Aufenthalt (und nicht pro Nacht) anfallen, können in AmountAfterTax nicht dargestellt werden.

Im Allgemeinen empfiehlt Google die Verwendung von TaxFeeInfo anstelle von AmountAfterTax.

Wenn möglich, sollten Sie AmountBeforeTax angeben, auch wenn Sie AmountAfterTax angeben, da in bestimmten Ländern (z. B. in den USA) standardmäßig der Preis vor Steuern angezeigt wird.

Alle Steuern und Gebühren, die ein Nutzer zahlen muss (z. B. Mehrwertsteuer, Kurtaxe, Reinigungsgebühren, City Tax), sollten angegeben werden, auch wenn sie nicht bei der Buchung oder nicht direkt an die Unterkunft gezahlt werden.

Beispiel

In diesem Abschnitt finden Sie ein einfaches Beispiel für eine Ratenbenachrichtigung mit erforderlichen und optionalen Elementen. Nachdem Sie die Datei vorbereitet haben, müssen Sie sie mit einer POST-Nachricht an den folgenden Endpunkt an Google senden: https://www.google.com/travel/hotels/uploads/property_data

Weitere Informationen zum PUSH- oder POST-Vorgang für die Nachricht finden Sie unter Nachrichten pushen.

Verwenden Sie für HotelCode die eindeutige Hotel-ID, die Sie in Ihrem System zur Identifizierung des Hotels verwendet haben. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. Verwenden Sie für <PackageID> und <RoomID> dieselben IDs, die Sie in Ihrem System für Preispläne bzw. Zimmertypen verwenden. Die Konsistenz mit Ihrem System ist entscheidend, damit Google Ihre Preise und Daten richtig anzeigt.

In diesem Beispiel wird gezeigt, wie Sie Raten 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 von Ratenbenachrichtigungen auftreten können.

Beispiele für das Hinzufügen, Entfernen und Aktualisieren von Preisen finden Sie unter Preisbeispiele.

Szenario 1: Preisgestaltung pro Belegung ändern

Beschreibung

Übernachtungspreise wurden bisher nur für Doppelbelegung definiert (was auch für Einzelbelegung gilt), aber jetzt gibt es einen günstigeren Preis für Einzelbelegung.

Lösung

Senden Sie die neue Rate für Belegung 1 mit der Standardaktualisierung mit dem Bereich Delta. Dieser neue Wert hat keine Auswirkungen auf die Belegungsrate 2.

Szenario 2: Belegungsraten für eine Unterkunft ersetzen

Beschreibung

Sie haben zuvor Preise für die Belegungen 1 bis 4 definiert, jetzt sind aber nur noch die Belegungen 1 und 2 gültig.

Lösung

Verwenden Sie NotifType="Overlay", um alle Belegungspreise für eine bestimmte Unterkunft, einen bestimmten Zimmertyp, einen bestimmten Preisplan und ein bestimmtes Datum bzw. bestimmte Daten zu ersetzen. In diesem Szenario würden mit der Aktion Overlay Raten für die Belegungen 1 und 2 aufgeführt.

Szenario 3: Denselben Preis für mehrere Belegungen festlegen

Beschreibung

Ein Preis für eine bestimmte Belegung kann an eine Gruppe mit weniger Personen verkauft werden. In diesem Fall können Sie Ihre Nachrichten vereinfachen, indem Sie nur die Ratenaktualisierung für die anwendbare maximale Belegung senden.

Lösung

Wenn Sie für mehrere Belegungen denselben Preis haben, legen Sie den höchsten Belegungswert fest, der vom Zimmertyp und Preisplan unterstützt wird. Dieser Wert wird dann automatisch für niedrigere Belegungen verwendet. Das heißt, Sie müssen den gleichen Übernachtungspreis für Belegungen von 1 bis 6 nicht wiederholen, wenn er für alle gleich ist. Legen Sie ihn einfach für 6 fest.