Nachricht zu Angeboten

Übersicht

In der Promotions-Nachricht werden Regeln für die Rabattierung von Preisen mit OTA_HotelRateAmountNotifRQ definiert. Für jeden Preis werden die definierten Angebote ausgewertet und der größte zulässige Rabatt wird auf den Preis angewendet. Dieser Mitteilungstyp ist optional. Sie müssen nur dann Angebote definieren, wenn sie in Ihrem System verwendet werden, um Rabatte auf Preise anzuwenden.

Sie können Angebote kombinieren und auf verschiedene Nutzerattribute anwenden, z. B. Gerätetypen (Mobilgeräte, Tablets, Computer) und Ländercodes.

Wichtiger Hinweis: Wenn mehrere Angebote für bestimmte Produktpreise (Zimmerkategorie + Tarif + Belegung) gelten, erhält der Nutzer das günstigste zulässige Angebot oder die günstigste zulässige Kombination von Angeboten. Die Rabatte werden automatisch angewendet.

Beispiele für verschiedene promotionsbezogene Szenarien finden Sie unter Anleitungen.

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

Richtlinien

In diesem Abschnitt werden die allgemeinen Richtlinien und speziellen Anleitungen für die Einrichtung von Angeboten behandelt.

Beachten Sie die folgenden Richtlinien für Werbeaktionen:

Aktionen

Löschen

Verwenden Sie eine delete-Aktion im <Promotion>-Element, um ein einzelnes Angebot anhand seiner ID zu löschen.

Overlay

Verwenden Sie im Element <HotelPromotions> die Aktion overlay, um alle Angebote für eine Property zu ersetzen.

Delta

Wenn keine Aktion angegeben ist, werden alle in <HotelPromotions> angegebenen Angebote hinzugefügt oder ersetzt. Wenn ein Angebot mit dieser ID noch nie hinzugefügt wurde oder gelöscht wurde, wird es hinzugefügt. Wenn eine Promotion mit dieser ID vorhanden ist, wird sie mit der neuen Definition überschrieben.

Allgemein

• Für jede Unterkunft kann es ein oder mehrere Angebote geben. Jedes Angebot hat bestimmte Bedingungen. Dieses Angebot kann nur angewendet werden, wenn die Bedingungen erfüllt sind.

• Angebote gelten für den Preis der Fahrstrecke. Es ist nicht möglich, einen maximalen Rabatt pro Gast festzulegen.

• Wenn ein Angebot nur für ein bestimmtes Datum, einen bestimmten Zimmertyp oder einen bestimmten Preisplan gelten soll, geben Sie dies in den Bedingungen für das Angebot an. Wenn das Angebot nicht für ein bestimmtes Datum, einen bestimmten Zimmertyp oder einen bestimmten Preisplan gilt, müssen diese nicht festgelegt werden.

• Jedes Angebot ist an eine bestimmte Unterkunft gebunden. Wenn Sie dasselbe Angebot für mehrere Properties verwenden, müssen Sie es für jede Property separat senden. Verwenden Sie das Attribut hotel_id des Elements <HotelPromotions>, um die Property-ID anzugeben.

• Sie können bis zu 99 Angebote einfügen. Wenden Sie sich an Ihren Google-TAM, wenn Sie mehr als das einbeziehen müssen.

• Mit dem Element <Stacking> können Sie angeben, wie Angebote kombiniert werden können. Standardmäßig verwendet Google den Stacking-Typ base. Das bedeutet, dass das beste infrage kommende Basisangebot ausgewählt und vor anderen Angeboten angewendet wird. base kann nur mit second oder any kombiniert werden, nicht mit einem anderen base oder none.

• Auch wenn mehrere Angebote gleichzeitig angewendet werden können, wird möglicherweise ein anderes einzelnes Angebot oder eine andere Kombination von Angeboten mit einem höheren Rabatt verwendet. Das Angebot (die Kombination) mit dem höchsten Rabatt wird auf die Buchung angewendet, wenn mehrere Angebote (Kombinationen von Angeboten) infrage kommen.

• Senden Sie eine Angebotsnachricht, wenn sich Änderungen ergeben, die sich auf Ihre Angebote auswirken.

  Wichtiger Hinweis: Pro Unterkunft sind nur bis zu 500 Werbeangebote zulässig. Mit der Nachricht <Promotions> können Sie Angebote aus einer Property entfernen.

Steuerbezogen

Das beste Angebot (oder die beste Kombination von Angeboten) wird auf den Betrag von AmountAfterTax angewendet. Wenn nur AmountBeforeTax angegeben ist, werden die Angebote auf AmountBeforeTax angewendet.

Beispiel

In diesem Abschnitt finden Sie ein einfaches Beispiel für eine Angebotsnachricht mit erforderlichen und optionalen Elementen. Nachdem Sie Ihre Datei vorbereitet haben, senden Sie sie über eine POST-Nachricht an diesen Endpunkt:

https://www.google.com/travel/hotels/uploads/promotions

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

Wichtig: Senden Sie Google jedes Mal eine aktualisierte Angebotsnachricht, wenn sich Ihre Angebote ändern.

Verwenden Sie für das Attribut hotel_id von <HotelPromotions> die eindeutige Hotel-ID, die Sie in Ihrem System zur Identifizierung der Unterkunft verwendet haben. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. Die Konsistenz mit Ihrem System ist entscheidend dafür, dass Ihre Daten bei Google richtig angezeigt werden.

UserCountry dient zum Auflisten der Nutzerstandorte (Länder), für die das Angebot gilt. Wenn angegeben, wird nur Nutzern in den aufgeführten Ländern der ermäßigte Preis angeboten.

Hinweis :Das Festlegen eines Ländercodes ist optional. Wenn kein Ländercode angegeben ist, wird Nutzern in allen Ländern der ermäßigte Preis angeboten.

In diesem Beispiel wird gezeigt, wie Sie einen Rabatt von 15% für einen längeren Aufenthalt für Nutzer in den USA und Italien festlegen:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

Weitere Beispiele finden Sie unter Beispiele für Angebote.

Anleitungen

In diesem Abschnitt finden Sie Lösungen für Szenarien, die beim Einrichten von Angeboten auftreten können.

Szenario 1: So fügen Sie ein Rabattangebot für längere Aufenthalte hinzu

Beschreibung

Sie möchten an bestimmten Tagen eines längeren Aufenthalts ermäßigte Übernachtungen anbieten.

Lösung

Mit der Einstellung FreeNights können Sie den Rabatt anpassen, der je nach Anzahl der Übernachtungen angewendet wird.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie für den angegebenen Zeitraum von Buchungsdaten einen Rabatt von 20% für zwei Übernachtungen bei einem Aufenthalt von jeweils sieben Übernachtungen hinzufügen. Bei einem Reiseplan mit 15 Übernachtungen gilt ein Rabatt von 20% für insgesamt 4 Übernachtungen.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

Szenario 2: Gerätetypen festlegen

Sie legen devices fest, um die Nutzergeräte anzugeben, für die das Angebot gilt. Wenn angegeben, wird nur Nutzern auf den aufgeführten Geräten der ermäßigte Preis angeboten.

Hinweis :Wenn nicht angegeben, wird Nutzern auf beliebigen Geräten der ermäßigte Preis angeboten.

Beschreibung

Sie möchten angeben, welcher Typ von Nutzergerät für das Angebot infrage kommt.

Lösung

Legen Sie den Gerätetyp auf einen oder mehrere der folgenden Werte fest: desktop, tablet oder mobile.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie einen Rabatt von 25% für Nutzer von Mobilgeräten und Tablets angeben:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

Szenario 3: Alte Angebote durch neue ersetzen

Beschreibung

Die aktuellen Angebote für eine Unterkunft sind veraltet oder falsch und müssen durch eine komplett neue Reihe ersetzt werden.

Lösung

Verwenden Sie die Aktion overlay, um die Angebote zu ersetzen.

Hinweis :Es wird empfohlen, overlay anstelle von einzelnen delete zu verwenden, um alle Angebote für eine Property zu überschreiben. Verwenden Sie die Aktion delete, wenn Sie nur bestimmte Werbeaktionen für eine Property löschen möchten.

Beispiel

Im folgenden Beispiel sind die ursprünglichen beiden Rabatte von 20% und 30% für die Unterkunft zu sehen.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

In diesem Beispiel wird gezeigt, wie Sie mit overlay die beiden vorhandenen Angebote durch ein einzelnes Angebot mit 15% Rabatt für die Unterkunft ersetzen.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Szenario 4: Ein oder alle Angebote entfernen

Beschreibung

Sie möchten ein oder mehrere Angebote entfernen (ohne Ersatz), weil für die Unterkunft alle Angebote entfernt wurden, ohne dass neue festgelegt wurden, oder weil Sie einen Fehler gemacht haben, den Sie korrigieren müssen.

Lösung

Verwenden Sie die Aktion delete, wenn Sie nur bestimmte einzelne Angebote für eine Unterkunft löschen möchten. Mit der Aktion overlay (nicht delete) entfernen Sie alle vorhandenen Angebote ohne Ersatz.

Hinweis :Die Verwendung von overlay (anstatt einzelner delete-Aktionen) ist die empfohlene Methode, um alle Angebote für eine Property zu überschreiben.

Weitere Informationen zum Ersetzen von Angeboten mit overlay finden Sie unter Szenario 3.

Beispiele

Im folgenden Beispiel wird gezeigt, wie nur ein Angebot für eine Unterkunft gelöscht wird:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

In diesem Beispiel wird gezeigt, wie alle Angebote für eine Unterkunft ohne Ersatz entfernt werden:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

Szenario 5: Angebote kombinieren

Mit „Stapeln“ wird angegeben, wie Angebote kombiniert werden können. Wenn nicht angegeben, wird type als base angenommen. Das bedeutet, dass das beste infrage kommende Basisangebot ausgewählt und vor anderen Angeboten angewendet wird. Wenn das Attribut type von Stacking any ist, kann es mit anderen Angeboten kombiniert werden.

Hinweis :Das Angebot (die Kombination) mit dem höchsten Rabatt wird auf die Buchung angewendet, wenn mehrere Angebotskombinationen infrage kommen.

Beschreibung

Der Nutzer soll die Möglichkeit haben, mehrere Promotions gleichzeitig für dieselbe Unterkunft zu verwenden.

Lösung

Mit der Funktion „Stapeln“ können Sie mehrere Rabatte pro Unterkunft festlegen. Ein Stack kann maximal ein base und ein second, aber eine unbegrenzte Anzahl von any enthalten. any kann mit den anderen Typen kombiniert werden, mit Ausnahme von none.

Beispiel

In diesem Beispiel wird gezeigt, wie die Stacking-Typen base, second und any gestapelt werden. Bei einem kombinierten Rabatt von 15%, 25 % und 10 % beträgt der Gesamtpreis für einen Artikel mit einem Preis von 100 $ 57,38 $ (100 $ × 0,85 × 0,75 × 0,9).

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Der kombinierte Rabatt für die Angebote 1 bis 3 ist höher als der Rabatt für Angebot 4. Angebot 4 kann aufgrund des Stacking-Typs (none) nicht mit anderen Angeboten kombiniert werden. Wenn Angebot 4 einen Rabatt von 43% oder mehr hätte, würde es anstelle der Kombination der Angebote 1 bis 3 verwendet werden.