Nachricht zu Angeboten

Überblick

In der Nachricht „Angebote“ sind Regeln für Rabattierungen mit OTA_HotelRateAmountNotifRQ definiert. Für jeden Preis werden die definierten Angebote ausgewertet und der höchste zulässige Rabatt auf den Preis angewendet. Dieser Nachrichtentyp ist optional und Sie müssen Angebote nur dann definieren, wenn sie in Ihrem System zum Anwenden von Preisrabatten verwendet werden.

Angebote lassen sich kombinieren und auf verschiedene Nutzerattribute wie Gerätetypen (Smartphones, Tablets, Computer) und Ländercodes anwenden.

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

Beispiele für verschiedene Szenarien im Zusammenhang mit Angeboten finden Sie in Anleitungen.

In den folgenden Abschnitten werden allgemeine Richtlinien, ein einfaches Beispiel und Szenarien erläutert, die Ihnen den Einstieg in das Hinzufügen und Aktualisieren von Angeboten erleichtern.

Richtlinien

In diesem Abschnitt werden die allgemeinen Richtlinien und spezielle Anleitungen zum Festlegen von Angeboten behandelt.

Halten Sie sich an die folgenden Richtlinien für Angebote:

Aktionen

Löschen

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

Overlay

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

Delta

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

Allgemein

• Für jede Unterkunft kann es ein einzelnes Angebot oder eine Reihe von Angeboten geben, wobei jede Werbeaktion eine Reihe von Bedingungen hat. Dieses Angebot kann nur angewendet werden, wenn die Bedingungen erfüllt sind.

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

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

• Sie können bis zu 99 Angebote angeben. Wenden Sie sich an Ihren Google-TAM, wenn Sie mehr Angaben machen müssen.

• Mit dem Element <Stacking> legen Sie fest, wie Angebote kombiniert werden können. Standardmäßig verwendet Google den Stapeltyp base. Das bedeutet, dass das am besten geeignete Basisangebot zuerst ausgewählt und angewendet wird, bevor andere Angebote berücksichtigt werden. base kann nur mit second oder any und nicht mit einem anderen base oder none kombiniert werden.

• Selbst wenn es einen Stapel mit mehreren Angeboten gibt, die zusammen angewendet werden können, ist diese Gruppe möglicherweise nicht die, die verwendet wird, wenn es ein weiteres einzelnes Angebot oder einen Stapel von Angeboten gibt, die den höheren Rabatt bieten. Das Angebot (Kombination) mit dem größten Rabatt wird auf die Buchung angewendet, wenn mehrere Angebote (Kombinationen) infrage kommen.

• Senden Sie eine Nachricht zu Werbeaktionen immer dann, wenn Änderungen vorgenommen werden, die sich auf Ihre Angebote auswirken.

Steuerbezogen

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

Beispiel

Dieser Abschnitt enthält ein einfaches Beispiel für eine Mitteilung zu Angeboten mit erforderlichen und optionalen Elementen. Wenn Sie Ihre Datei vorbereitet haben, senden Sie sie über eine POST-Nachricht an diesen Endpunkt an Google:

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

Weitere Informationen zum Übertragen/POSTen von Nachrichten per Push/POST finden Sie unter Nachrichten per Push übertragen.

Wichtiger Hinweis :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 wichtig, damit Google Ihre Daten korrekt anzeigt.

Mit UserCountry werden die Nutzerstandorte (Länder) aufgelistet, für die das Angebot gilt. Wenn angegeben, wird der ermäßigte Preis nur für Nutzer in den aufgeführten Ländern angeboten.

Hinweis: Das Festlegen eines Ländercodes ist optional. Wenn nicht angegeben, wird Nutzern in jedem Land 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, auf die Sie beim Einrichten von Angeboten stoßen könnten.

Szenario 1: Rabattangebot für Langzeitaufenthalte hinzufügen

Beschreibung

Sie möchten an bestimmten Tagen eines längeren Aufenthalts vergünstigte Übernachtungen anbieten.

Lösung

Verwenden Sie die Einstellung FreeNights, um die Art des Rabatts abhängig von der Anzahl der Übernachtungen anzupassen.

Beispiel

Dieses Beispiel zeigt, wie Sie im angegebenen Buchungszeitraum einen Rabatt von 20% für zwei Nächte pro sieben Übernachtungen hinzufügen können. Bei einem Reiseplan mit 15 Nächten wird ein Rabatt von 20% für insgesamt 4 Nächte gewährt.

<?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

Legen Sie devices fest, um die Nutzergeräte anzugeben, die für die Werbeaktion infrage kommen. Wenn angegeben, wird der ermäßigte Preis nur für Nutzer auf den aufgeführten Geräten angeboten.

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

Beschreibung

Sie möchten angeben, für welche Art von Nutzergerät das Angebot gilt.

Lösung

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

Beispiel

Das folgende Beispiel zeigt, wie ein Rabatt von 25% für Nutzer von Mobilgeräten und Tablets angegeben 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">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

Szenario 3: Alte durch neue Angebote ersetzen

Beschreibung

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

Lösung

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

Hinweis: Wir empfehlen, alle Angebote für eine Unterkunft mit overlay anstelle eines einzelnen delete zu überschreiben. Verwenden Sie die Aktion delete, wenn Sie nur bestimmte Angebote für eine Unterkunft löschen möchten.

Beispiel

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

<?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 einem Rabatt von 15% 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: Eine oder alle Angebote entfernen

Beschreibung

Sie möchten ein oder alle Angebote (ohne Ersatz) entfernen, da alle Angebote der Property entfernt wurden, ohne neue festzulegen, oder weil ein Fehler aufgetreten ist und Sie den Fehler beheben müssen.

Lösung

Verwenden Sie die Aktion delete, wenn Sie nur bestimmte einzelne Angebote für eine Unterkunft löschen möchten, und die Aktion overlay (nicht delete), um alle vorhandenen Angebote ersatzlos zu entfernen.

Hinweis: Wir empfehlen, alle Angebote für eine Unterkunft mit overlay anstelle einzelner delete-Aktionen zu überschreiben.

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

Samples

Im folgenden Beispiel wird gezeigt, wie Sie nur ein Angebot für eine Unterkunft löschen:

<?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 ohne Ersatz für eine Property 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: Werbeaktionen stapeln

So legen Sie fest, wie Angebote kombiniert werden können. Wenn keine Angabe erfolgt, wird type als base angenommen. Das bedeutet, dass das beste zulässige Basisangebot zuerst ausgewählt und angewendet wird, bevor andere Angebote berücksichtigt werden. Wenn das type-Attribut von Stacking den Wert any hat, kann es mit jedem anderen Angebot kombiniert werden.

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

Beschreibung

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

Lösung

Verwenden Sie die Option „Stapel“, um mehrere Rabatte pro Unterkunft festzulegen. Ein Stack kann höchstens eine base und eine second, aber eine unbegrenzte Anzahl von any enthalten. any kann mit den anderen Typen außer none kombiniert werden.

Beispiel

In diesem Beispiel wird gezeigt, wie die Stapeltypen base, second und any gestapelt werden. Bei einem kombinierten Rabatt von 15%, 25 % und 10 % ergibt ein Preis von 100 $insgesamt 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>

Beachten Sie, dass der kombinierte Rabatt für die kombinierten Angebote 1 bis 3 besser ist als der Rabatt für Angebot 4. Angebot 4 kann aufgrund seines Stapeltyps (none) nicht mit anderen Angeboten kombiniert werden. Wenn Angebot 4 einen Rabatt von 43% oder mehr hat, wird es anstelle der Kombination der Angebote 1 bis 3 verwendet.