Diese Seite wurde von der Cloud Translation API übersetzt.

Nachricht bewerten

Überblick

Die Preisnachricht (OTA_HotelRateAmountNotifRQ) definiert die Preise pro Übernachtung für jede Kombination aus Zimmertyp und Preisplan für bestimmte Zeiträume. Im Rahmen der Preisnachricht unterstützt Google Preise auf der Belegungsbasis, sodass je nach maximaler Anzahl von beabsichtigten Personen unterschiedliche Übernachtungspreise angegeben werden können.

In den folgenden Abschnitten werden allgemeine Richtlinien, ein einfaches Beispiel und Szenarien behandelt, die Ihnen den Einstieg in das Hinzufügen und Aktualisieren von Preisen sowie das Senden einer Preisnachricht erleichtern.

Verhalten der Abgleichsrate

Wenn Nutzer eine bestimmte Belegung anfordern, hängt der Preis, der ihnen angezeigt wird, davon ab, wie Sie die Preise in Ihrer Preisnachricht definieren. In diesem Abschnitt erfahren Sie, wie diese Nutzeranfragen je nach Belegung der Anfrage mit Ihren Preisen abgeglichen werden und welche Preise Sie festlegen.

Grundprinzipien

Ein für eine bestimmte Belegung festgelegter Preis gilt für alle geringerer Belegungen, sofern nicht anders angegeben.
Anfragen für Belegungen, die über den festgelegten Werten liegen, werden nicht als möglich angesehen.
Die bebelegungsbasierten Preise gelten sowohl für Preise pro Datum als auch für auf der Aufenthaltsdauer basierende Preismodelle, die unten beschrieben werden. Das bedeutet, dass Sie Preise 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. Mit AdditionalGuestAmounts oder ExtraGuestCharges können Sie auch Gebühren für zusätzliche Gäste und Kinder festlegen. Diese werden bis zur für ein Zimmer festgelegten Kapazität angewendet.

Vorteile und Beispiele

Effizienz

Bei mehreren Belegungen mit demselben Preis müssen Sie nicht für jede Belegung einen eigenen Preis festlegen. Sie können Ihre Nachrichten vereinfachen, indem Sie nur die höchste Belegung festlegen, die vom Zimmertyp und Preisplan unterstützt wird. Nutzer sehen diesen Preis für jede Belegung, die kleiner oder gleich Ihrem festgelegten Wert ist.

Beispiel: Die Preise für einen Zimmertyp und einen Preisplan sind für die Belegungen eins bis vier dieselben. Verwenden Sie die Preisnachricht, um einen Preis für eine maximale Belegung von 4 Personen festzulegen. Nutzer, die nach Einzel-, Doppel- und Dreibettzimmern suchen, sehen denselben Preis. Nutzer, die nach 5 oder höher suchen, sehen keine Preise.

Steuerung

Gesonderte Preise für alternative Belegungen können explizit angegeben werden. Senden Sie einen anderen Preis für jeden Belegungswert, wenn Sie mehr Kontrolle darüber haben möchten, wie Google Anfragen mit Belegungsraten abgeglichen.

Beispiel: Wenn für Belegungen 3 und 1 Preise definiert sind, wird bei Suchanfragen nach Einzelbelegung der Preis für Einzelzimmer und bei einer Suche mit Doppelzimmern der Preis für ein Dreibettzimmer angezeigt. Nutzer, die ab 4 Jahren suchen, sehen keine Preise.

Weitere Beispiele für verschiedene preisbezogene Szenarien finden Sie unter Anleitungen.

Erforderliche und optionale Elemente

Die XML-Referenz enthält Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu Attributen und untergeordneten Elementen finden Sie unter Preiselemente und Attribute.

Syntax und Schemas

Verwenden Sie das Beispiel zur Preissyntax als Referenz, wenn Sie die Preisnachricht erstellen, um sicherzustellen, dass 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. Das Schema für Preisnachrichten finden Sie unter Schemas für Hotelanzeigen.

Preismodelle

Preis pro Datum

Dies ist das Standardpreismodell, das für die meisten Properties verwendet wird. Das Preismodell per-date basiert auf den festgelegten Preisen, die über die Aufenthaltsdaten hinweg summiert werden, um einen Gesamtpreis zu erhalten. In diesem Modell werden alle Preise unter einem Rate-Element so interpretiert, dass sie für einen in <StatusApplicationControl> angegebenen Aufenthaltszeitraum gelten.

Auf der Aufenthaltsdauer basierende Preise

Das auf der Aufenthaltsdauer basierende Preismodell basiert auf Preisen, die für eine Kombination aus Ankunftsdatum und Aufenthaltsdauer festgelegt sind. Preise, die unter dem auf der Aufenthaltsdauer basierenden Preismodell angegeben sind, gelten pro Tag. Wenn Sie beispielsweise einen Preis von 100 $für eine Aufenthaltsdauer von 3 senden, wird der Gesamtpreis so berechnet: 3 × 100$=300 $.

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

Sie können für ein einzelnes Konto sowohl ein datumsbasiertes als auch ein auf der Aufenthaltsdauer basierendes Preismodell nutzen. Für jede Unterkunft sollte jedoch nur ein einziges Preismodell verwendet werden. Beachten Sie bei der Implementierung der auf der Aufenthaltsdauer basierenden Preise Folgendes:

Preise für unterschiedliche Aufenthaltsdauern werden bei auf der Aufenthaltsdauer basierenden Preisen nicht kombiniert. Zum Beispiel wird ein Aufenthaltsdauerpreis von 3 nicht mit einer Aufenthaltsdauer von 1 kombiniert, um einen Preis von 4 zu berechnen. Die Aufenthaltsdauer von 4 muss explizit angegeben werden.
Der Preis für eine Übernachtung wird beim auf der Aufenthaltsdauer basierenden Preis nicht als einzelner Übernachtungspreis beim Preis pro Datum verwendet.
Für jede Unterkunft sollten nur auf der Aufenthaltsdauer basierende Preise oder Preise pro Datum verwendet werden, je nachdem, wie die Preise in Ihrem System dargestellt werden.

Um auf der Aufenthaltsdauer basierende Preise für Ihr Konto zu aktivieren, stellen Sie die Anfrage über Ihren TAM oder wenden Sie sich an uns.

Richtlinien oder Maßnahmen

Preis pro Datum

Delta: Sie können die Preise pro Belegung nur für die angegebenen Kombinationen aus Zimmertyp, Preisplan und Aufenthaltsdaten hinzufügen oder aktualisieren, die in <StatusApplicationControl> angegeben sind.

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

Overlay: Löschen Sie alle vorhandenen Preise pro Belegung für den Zimmertyp, den Preisplan und die Termine, die in <StatusApplicationControl> angegeben sind, und ersetzen Sie sie durch neue Preise. Wenn Sie beispielsweise Preise für Einzel- und Doppelzimmer angegeben haben und ein Overlay-Update für Einzelzimmer senden, entfernt Google alle vorherigen Preise (sowohl Einzel- als auch Doppelzimmer) und nur der Einzelzimmerpreis bleibt nach der Aktualisierung erhalten.

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

Auf der Aufenthaltsdauer basierende Preise

Delta: Sie können Preise pro Aufenthaltsdauer nur für die angegebenen Kombinationen aus Zimmertyp, Preisplan und Check-in-Datum hinzufügen oder aktualisieren, die in <StatusApplicationControl> angegeben sind. Ersetzt alle Preise pro Belegung, die mit den aktualisierten Werten für die Aufenthaltsdauer verknüpft sind.

Für Preisaktualisierungen wird standardmäßig die Aktion Delta verwendet.
Bei einer Delta-Aktualisierung werden zuvor gespeicherte Preise für andere Aufenthaltsdauern nicht geändert. Wenn Sie beispielsweise Preise für Aufenthaltsdauer 1 und 2 angegeben haben und für Aufenthaltsorte 1 eine Delta-Preisaktualisierung senden, bleiben die Preise von Aufenthaltsort 2 pro Belegung unverändert.
Durch eine Delta-Aktualisierung werden alle zuvor gespeicherten Preise pro Belegung für die angegebene Aufenthaltsdauer überschrieben. Wenn Sie beispielsweise Einzel- und Doppelbelegung für die Aufenthaltsdauer 1 angegeben haben und für die Aufenthaltsdauer 1 eine Preisaktualisierung Delta mit nur einem Preis für eine Einzelbelegung senden, wird der Preis für ein Doppelzimmer entfernt.

Overlay: Löschen Sie alle vorhandenen Preise pro Belegung für die Aufenthaltsdauer, den Zimmertyp, den Preisplan und die Check-in-Daten, die in <StatusApplicationControl> angegeben sind, und ersetzen Sie sie durch neue Preise. Wenn Sie beispielsweise Preise für Aufenthaltsdauer 1 und 2 angegeben haben und ein Overlay-Update für Aufenthaltsdauer 1 senden, entfernt Google alle vorherigen Preise (sowohl Aufenthaltsdauer 1 als auch Aufenthaltsdauer 2) und nur der Preis für Aufenthaltsdauer 1 bleibt nach der Aktualisierung bestehen.

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

Steuerbezogen

Wenn Steuern und Gebühren einfach sind, kann der Gesamtbetrag mit AmountAfterTax angegeben werden. Komplexe Steuern, z. B. für Steuern und Gebühren, die pro Aufenthalt (anstatt 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 verwenden, auch wenn Sie AmountAfterTax angeben, da in bestimmten Sprachen (z. B. USA) standardmäßig der Preis vor Steuern angezeigt wird.

Alle Steuern und Gebühren, die Nutzer zahlen müssen (MwSt., Aufenthaltssteuer, Reinigungsgebühren, Stadtsteuer usw.), müssen enthalten sein, auch wenn diese nicht bei der Buchung oder nicht direkt für die Unterkunft bezahlt werden.

Beispiel

Dieser Abschnitt enthält ein einfaches Beispiel für eine Preisnachricht mit erforderlichen und optionalen Elementen. Nachdem du deine Datei vorbereitet hast, musst du sie mit einer POST-Nachricht an den folgenden Endpunkt an Google senden: https://www.google.com/travel/hotels/uploads/property_data

Weitere Informationen zum Übertragen/POSTen von Nachrichten finden Sie unter Nachrichten senden.

Verwenden Sie für HotelCode die eindeutige Hotel-ID, die Sie in Ihrem System zur Identifizierung der Unterkunft verwendet haben. Dieser Wert muss mit der Hotel-ID übereinstimmen, die im Hotellistenfeed mit <id> im Element <listing> 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 dafür, dass Google Ihre Preise und Daten korrekt anzeigt.

In diesem Beispiel wird gezeigt, wie Preise mit einer Delta-Aktion festgelegt werden:

<?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, auf die Sie beim Senden von Preisnachrichten stoßen könnten.

Beispiele zum Hinzufügen, Entfernen und Aktualisieren von Preisen finden Sie unter Preisbeispiele.

Szenario 1: Preise pro Belegung ändern

Beschreibung

Früher wurden Übernachtungspreise nur für ein Doppelzimmer definiert (gilt auch für Einzelbelegung). Jetzt gibt es einen günstigeren Preis für Einzelbelegung.

Lösung

Senden Sie den neuen Preis für Belegung 1 mit dem standardmäßigen Update auf Delta-Ebene. Dieser neue Wert wirkt sich nicht auf den Preis für Belegung 2 aus.

Szenario 2: Preise pro Belegung für eine Unterkunft ersetzen

Beschreibung

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

Lösung

Verwenden Sie NotifType="Overlay", um alle Belegungspreise für eine bestimmte Unterkunft, Zimmertyp, Preisplan und Daten zu ersetzen. In diesem Szenario würde die Aktion Overlay die Preise für Belegung 1 und 2 auflisten.

Szenario 3: Den gleichen 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 Szenario können Sie Ihre Nachrichten vereinfachen, indem Sie nur die Preisaktualisierung für die geltende maximale Belegung senden.

Lösung

Wenn Sie für mehrere Belegungen denselben Preis haben, legen Sie den höchsten Wert für die Belegung fest, der vom Zimmertyp und Preisplan unterstützt wird. Dieser Wert wird automatisch für niedrigere Belegungen verwendet. Sie müssen also nicht denselben Übernachtungspreis für die Belegungen 1 bis 6 wiederholen, wenn alle Belegungen gleich sind. Legen Sie einfach nur sechs fest.