Nachricht zu Angeboten

Übersicht

In der Nachricht „Angebote“ werden Regeln für Rabatte definiert: OTA_HotelRateAmountNotifRQ Die definierten Angebote für jeden Preis ausgewertet und der maximal zulässige Rabatt auf den zu zahlen. Dieser Mitteilungstyp ist optional. Sie müssen nur Angebote, wenn sie in Ihrem System zum Anwenden von Preisrabatten verwendet werden.

Sie können Angebote kombinieren und auf verschiedene Nutzerattribute anwenden. etwa Gerätetypen (Mobiltelefon, Tablet, Desktop-Computer) und Ländercodes.

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

Beispiele für verschiedene werbebezogene Szenarien finden Sie unter Anleitungen

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

Richtlinien

In diesem Abschnitt finden Sie allgemeine Richtlinien und spezielle Anweisungen für die Einstellung Werbeaktionen

Beachten Sie für Angebote die folgenden Richtlinien:

Aktionen

Löschen

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

Overlay

Verwenden Sie zum Ersetzen die Aktion overlay im Element <HotelPromotions> alle Angebote für eine Unterkunft.

Delta

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

Allgemein

• Es kann ein einzelnes Angebot oder eine Reihe von Angeboten für jede Unterkunft und jede Angebote bestimmte Bedingungen erfüllen. Dieses Angebot kann nur angewendet werden, wenn das erfüllt sind.

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

• Jedes Angebot ist mit einer bestimmten Property verknüpft. Wenn Sie dasselbe Angebot verwenden für mehrere Properties müssen Sie sie 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 angeben. Wenden Sie sich bei Bedarf an Ihren Google TAM. enthalten mehr Möglichkeiten.

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

• Auch wenn es mehrere Angebote gibt, die gleichzeitig angewendet werden können, kann es sein, dass dieser Stack nicht verwendet wird, ein einzelnes Angebot oder einen Stapel an Angeboten, bei denen der größere Rabatt angeboten wird. Die Angebot (Kombination) mit dem größten Rabatt wird auf die Buchung angewendet Mehrere Angebote (Kombinationen von) Angeboten sind zulässig.

• Bei allen Änderungen, die sich auf die Änderungen auswirken, muss die Nachricht „Angebote“ aktualisiert werden. Ihre Angebote zu präsentieren.

  Wichtiger Hinweis :Pro Unterkunft sind nur bis zu 500 Angebote zulässig. Sie können die <Promotions>, um Angebote aus einer Property zu entfernen.

Steuerbezogen

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

Beispiel

Dieser Abschnitt enthält ein einfaches Beispiel für eine Nachricht „Angebote“ mit erforderlichen und optionale Elemente. Sobald 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 Übertragen/Posten der Nachricht finden Sie unter Nachrichten senden

Wichtiger Hinweis :Sie müssen bei jedem Angebot eine aktualisierte Werbebotschaft an Google senden. ä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 übereinstimmen die Hotel-ID, die mit <id> in <listing> angegeben wurde im Hotellistenfeed. Einheitlichkeit mit deinem System ist entscheidend, dass Google Ihre Daten korrekt anzeigt.

In UserCountry werden die infrage kommenden Nutzerstandorte (Länder) aufgelistet für die Werbeaktion. Wenn angegeben, werden nur Nutzer in den aufgeführten Ländern hat den rabattierten Preis angeboten.

Hinweis :Das Festlegen eines Ländercodes ist optional. Wenn Sie nichts angeben, können Nutzer in In allen Ländern wird der rabattierte Preis angeboten.

In diesem Beispiel wird gezeigt, wie Sie einen Rabatt von 15% für einen Langzeitaufenthalt festlegen. Für Nutzer in den USA und Italien:

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

Szenario 1: So fügen Sie ein Rabattangebot für Langzeitaufenthalte hinzu

Beschreibung

Sie möchten an bestimmten Tagen eines verlängerten Aufenthalts Rabatte für Übernachtungen anbieten.

Lösung

Mit der Einstellung FreeNights können Sie die Art des angewendeten Rabatts je nach zur Anzahl der Übernachtungen.

Beispiel

Dieses Beispiel zeigt, wie Sie einen Rabatt von 20% für zwei Nächte alle 7 Nächte hinzufügen. den angegebenen Zeitraum der Buchung übernachtet haben. Für einen Reiseplan von 15 Übernachtungen Der Rabatt von 20% gilt für insgesamt 4 Nächte.

<?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, die für die Werbung. Wenn angegeben, werden nur Nutzer auf den aufgeführten Geräten angeboten den rabattierten Preis.

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 einen oder mehrere der folgenden Werte für den Gerätetyp fest: desktop, tablet, oder mobile.

Beispiel

Im folgenden Beispiel sehen Sie, wie ein Rabatt von 25% für Mobilgeräte und Tablet-Nutzer:

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

Beschreibung

Die aktuellen Angebote für eine Unterkunft sind veraltet oder falsch und müssen durch einen komplett neuen Satz ersetzt.

Lösung

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

Hinweis: Die Verwendung von overlay statt einzelner delete ist das empfohlene Methode zum Überschreiben aller Angebote für eine Unterkunft. Verwenden Sie die Methode delete, wenn Sie nur bestimmte Angebote für eine Property.

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>

Dann zeigt dieses Beispiel, wie mit overlay die vorhandene zwei Angebote mit einem einzigen Angebot von 15% Rabatt für die Unterkunft.

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

Beschreibung

Sie möchten ein oder alle Angebote entfernen (ohne Ersatz), weil in der Property alle Angebote entfernt wurden, ohne neue festzulegen, oder weil Sie einen Fehler gemacht haben und ihn korrigieren möchten.

Lösung

Verwenden Sie die Aktion delete, wenn Sie nur eine bestimmte Person löschen möchten. Werbeaktionen für eine Unterkunft und verwende die Aktion overlay (nicht delete), um sie zu entfernen alle bestehenden Angebote ersatzweise nutzen.

Hinweis: Die Verwendung von overlay (anstatt einzelner delete-Aktionen) ist die empfohlene Methode zum Überschreiben aller Angebote für eine Unterkunft.

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

Beispiele

Das folgende Beispiel zeigt, 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 ohne Ersatz entfernt werden können für eine 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" action="overlay"/>
</Promotions>

Szenario 5: Angebote kombinieren

Die Stapelung gibt an, wie bevorzugte Suchergebnisse kombiniert werden können. Wenn nicht angegeben, wird die type wird als base angenommen. Das bedeutet, dass das beste infrage kommende Basisangebot ausgewählt und angewendet haben. Wenn das type-Attribut von Stacking any ist, kann es mit anderen Angeboten kombiniert werden.

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

Beschreibung

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

Lösung

Mithilfe der Stapelung können Sie mehrere Rabatte pro Unterkunft festlegen. Ein Stack darf höchstens ein base und ein second, aber eine unbegrenzte Anzahl von any; und any kann mit den anderen Typen außer none kombiniert werden.

Beispiel

In diesem Beispiel wird gezeigt, wie base-, second- und any-Stapeltypen gestapelt werden. Bei einem kombinierten Rabatt von 15 %, 25 % und 10 % beträgt der 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>

Der kombinierte Rabatt für die gestapelten Angebote 1 bis 3 beträgt besser als der Rabatt für Angebot 4. Angebot 4 kann nicht kombiniert werden mit aufgrund des Stapeltyps (none) andere Angebote nutzen. Wenn Angebot 4 ein von mindestens 43 %, wird dieser anstelle der Kombination Angebote 1 bis 3.