Übermittlungsmodi für Preise

Der Übermittlungsmodus bestimmt, wie Preisaktualisierungen für Hotel- und Reiseplankombinationen an Google gesendet werden. Sie und Ihr Technical Account Manager (TAM) arbeiten während der Erstkonfiguration zusammen, um den Übermittlungsmodus einzurichten.

Übersicht der Übermittlungsmodi

Standardmäßig kann ein Hotel bis zu 330 Tage im Voraus und bis zu 30 Nächte im Voraus angefragt werden. Sie können jedoch die maximale Anzahl der Reisepläne (Kombination aus Check-in-Datum und Aufenthaltsdauer) bestimmen.

Je mehr Reisepläne Sie anbieten, desto mehr Auktionen nehmen Sie teil. Je mehr Reisepläne Sie jedoch unterstützen, desto mehr Daten müssen Sie an Google senden, damit Ihre Preisdaten korrekt sind.

Bei den typischen Methoden zum Aktualisieren von Preisen werden Transaktionsnachrichten auf eine der folgenden Arten verwendet:

  • ARI (Push): Ein Preisübermittlungsfeed, der Preispläne, Verfügbarkeit und Hotelmetadaten verwendet, um vordefinierte Preisstrategien für Ihre Unterkünfte festzulegen. Im Gegensatz zu „Pull-Preise“ und „Geänderte Preise“ fragen ARI-Feeds keine bestimmten Preise oder Reisepläne ab. Stattdessen senden Sie Push-Nachrichten mit einer Teilmenge von Informationen, die ein Preismodell für Ihre Unterkünfte basierend auf verschiedenen Preisdetails, Einschränkungen und Verfügbarkeit darstellen. ARI-Feeds verwenden die OTA-XML-Spezifikation (OTA_HotelRateAmountNotifRQ und OTA_HotelAvailNotifRQ), um Verfügbarkeit und Preise zu definieren. Wenden Sie sich an Ihren Account Manager, um mehr über den ARI-Übermittlungsmodus zu erfahren und herauszufinden, ob dieser Feedtyp für Ihr Konto am besten geeignet ist. Weitere Informationen finden Sie unter ARI verwenden.

  • Pull: Google fragt regelmäßig Ihren Dienst ab, um seinen Cache mit Preis- und Verfügbarkeitsdaten zu aktualisieren. Bei diesem Modell sendet Google eine Anfrage an Ihren Server und dieser antwortet mit aktualisierten Daten. Dieses Modell eignet sich am besten, wenn Sie nicht genau wissen, wann sich Preisinformationen ändern, oder wenn sich Preisinformationen im Laufe des Tages zu unregelmäßigen Zeiten ändern. Die Preise bleiben im Cache, bis die Algorithmen von Google auf Grundlage des partnerspezifischen Verlaufs der Preisänderungen feststellen, dass die Preise veraltet sind. Weitere Informationen finden Sie unter Pull-Übermittlungsmodus verwenden.

  • Geänderte Preise (früher „Pull with Hints“): Ähnlich wie beim Pull-Modus, mit der Ausnahme, dass Google nur Daten für einen Teil der Unterkünfte anfordert, nicht für alle Unterkünfte. In diesem Modus kann der Netzwerktraffic bei der Aktualisierung von Preisen und Verfügbarkeit für Ihre Unterkünfte erheblich reduziert werden. Die Preise bleiben für unbegrenzte Zeit im Cache, bis sie aktualisiert werden. Weitere Informationen finden Sie unter Geänderte Preise verwenden.

Mit Transaktionsnachrichten können Sie nicht nur Preise aktualisieren, sondern auch Unterkünfte aus Ihrem Inventar entfernen. Weitere Informationen finden Sie unter Inventar entfernen.

Weitere Informationen zum Bereitstellen von Preisaktualisierungen einschließlich Beispielen für Transaktionsnachrichten finden Sie unter Preise aktualisieren.

Livepreisabfragen

Google kann Preisaktualisierungen zum Zeitpunkt der Auktion auch mithilfe von Livepreisabfragen anfordern. Livepreisabfragen sind Preisanfragen von Google für eine aktuelle Auktion. Wenn Sie innerhalb des festgelegten Zeitraums antworten, sollte Ihre Anzeige in der Auktion erscheinen.

Google speichert Antworten auf Livepreisabfragen ebenso wie andere Transaktionsnachrichten. Dadurch kann Google den Preis aus seinem Cache bereitstellen, anstatt in Zukunft eine weitere Livepreisabfrage zu senden.

Weitere Informationen finden Sie unter Livepreisabfragen.

Kontext

Pull- und geänderte Preise geben in der Regel keine Informationen über den Nutzer an, da Google Ihre Antworten verwendet, um einen Cache zu füllen, der für eine Vielzahl verschiedener Nutzer verwendet werden kann.

Da es teuer sein kann, Preise zurückzugeben, die einem vollständigen Satz möglicher Nutzerkontexte entsprechen, wird eine Funktion getestet, bei der beliebte Nutzerkontexte als Teil der Abfrage angegeben sind. Die Nutzerkontexte basieren auf Nutzeranfragen, bei denen Sie die Möglichkeit hatten, einen Preis anzuzeigen. Sie wurden so berechnet, dass sie die überwiegende Mehrheit der Nutzeranfragen abdecken. Möglicherweise sehen Sie eine große Anzahl von Nutzerkontexten für sehr beliebte Unterkünfte oder Reisepläne. Die durchschnittliche Anzahl der Nutzerkontexte sollte jedoch weniger als 10 betragen. Sie können zusätzliche Preise zurückgeben oder bestimmte Nutzerkontexte ignorieren. Sie entscheiden, welche Preise für eine bestimmte Abfrage zurückgegeben werden sollen. Wenn Sie einen vorgeschlagenen Nutzerkontext ignorieren, kann dies jedoch zu weniger Zugriffen führen.

ARI Push-Übermittlungsmodus

Mit dem ARI Push-Übermittlungsmodus senden Sie inkrementelle Updates an Google, wenn sich Übernachtungspreise, Verfügbarkeit, Inventarzahlen oder andere Einschränkungen ändern. Im Gegensatz zu „Pull-Preise“ oder „Geänderte Preise“ können Sie mit ARI Push ein anderes Preismodell verwenden, um verschiedene Komponenten von Preisinformationen effizient auf Google zu aktualisieren.

Das folgende Diagramm zeigt den Anfrage- und Antwortfluss für den ARI Push-Übermittlungsmodus:

fig1

Schritt 1: ARI Push-Nachrichten an Google senden

Zum Aktualisieren Ihrer Daten mit ARI Push senden Sie jedes Mal eine ARI-Anfragenachricht, wenn sich Ihre Daten ändern. Der ARI Push-Übermittlungsmodus unterstützt verschiedene Nachrichtentypen und Preisstrategien. Ausführliche Informationen zum Senden von Nachrichten finden Sie unter ARI verwenden.

Ihre Preise sollten von Google bereitgestellt und für Nutzer innerhalb von 15 bis 20 Minuten nach Erhalt der Nachricht sichtbar sein.

Schritt 2: Prüfen, ob die Daten von Google im Cache gespeichert werden

Auf jede empfangene ARI Push-Nachricht antwortet Google mit dem HTTP-Verbindungsstatus und den ARI-Verarbeitungsergebnissen. Google antwortet mit einer HTTP 200 OK, wenn die Verbindung zum Server erfolgreich ist. Sie enthält auch einen Text mit einer Antwortnachricht, die angibt, ob die Aktualisierungen erfolgreich angewendet wurden oder ob Warnungen oder Fehler im Übermittlungsmodus aufgetreten sind.

IP-Adressen auf die Zulassungsliste setzen

Auf der Seite mit den Hotel Center-ARI-Preiseinstellungen können Sie alle IP-Adressen auf die Zulassungsliste setzen, über die Sie ARI-Nachrichten an Google senden. Informationen zum Aktualisieren der Preiseinstellungen im Hotel Center

Zimmer- und Paketmetadaten mit ARI Push aktualisieren

Verwenden Sie den Nachrichtentyp „Transaktion (Unterkunftsdaten)“, um die aktiven Zimmertypen und Preispläne (Pakete) für jede Unterkunft zu definieren. Sie sollten Updates immer dann senden, wenn Zimmertypen oder Preispläne hinzugefügt, entfernt oder geändert werden. In diesem Fall senden Sie eine XML-Nachricht mit den neuen Informationen in den Elementen <RoomData> und <PackageData>. Diese Elemente sind dem Element <PropertyDataSet> untergeordnet.

Verbindungs- oder Inhaltsfehler

Wenn Sie einen Fehler im Übermittlungsmodus erhalten, weil die XML-Datei fehlerhaft oder falsch formatiert ist, finden Sie die empfohlene Lösung unter Fehlermeldungen zum Feedstatus.

Wenn Sie beim Senden einer ARI-Nachricht an Google einen HTTP-Verbindungsfehler erhalten, wiederholen Sie die Anfrage in Intervallen von 1, 5 und 20 Minuten. Wenn das Problem nach drei Wiederholungsversuchen weiterhin besteht, beenden Sie das Senden von Nachrichten und wenden Sie sich an den Google-Support.

Pull-Übermittlungsmodus

Im Pull-Übermittlungsmodus sendet Google regelmäßig Anfragenachrichten an Ihren Server, um Preisaktualisierungen anzufordern. Ihr Server antwortet auf diese Nachrichten mit Transaktionsnachrichten, die aktualisierte Preis- und Verfügbarkeitsdaten enthalten.

Das folgende Diagramm zeigt den Anfrage/Antwort-Ablauf des Pull-Modus:

fig2

Nach Erhalt der Preisaktualisierungen verarbeitet Google die neuen Preis- und Verfügbarkeitsdaten in der Regel innerhalb von etwa 5 Minuten.

In den folgenden Abschnitten werden die einzelnen Schritte ausführlicher beschrieben.

Schritt 1: Anfragenachricht

Standardmäßig sendet Google Anfragenachrichten für alle Unterkünfte, die in Ihrer Hotelliste aufgeführt sind. Dies könnte bedeuten, dass Sie während der Preisneuberechnung mehrere Anfragenachrichten erhalten.

Die von Google an Ihren Server gesendeten Nachrichten zu Preisanfragen haben die folgenden Eigenschaften:

  • Das Stammelement ist <Query>.
  • Wird an den Endpunkt gesendet, der bei der Erstkonfiguration definiert wurde. Weitere Informationen erhalten Sie von Ihrem Technical Account Manager (TAM).
  • Verwendet die HTTP-Methode POST. Wenn Sie HTTPS verwenden, müssen Sie die Domain von einer offiziellen Zertifizierungsstelle signieren lassen.
  • Der Header Content-Type ist auf application/xml festgelegt.
  • Jede Nachricht enthält bis zu 100 Unterkünfte, für die Google Preis- und Verfügbarkeitsdaten anfordert.
  • Der Header User-Agent ist auf Google-HotelAdsPrices festgelegt.

Schritt 2: Transaktionsnachricht

Wenn Ihr Server eine Anfragenachricht erhält, muss er mit einer Transaktionsnachricht antworten, die Preisinformationen für die angeforderten Reisepläne enthält.

Das Stammelement einer Transaktionsnachricht ist <Transaction>. Weitere Informationen finden Sie unter Transaktionsnachrichten und Preise aktualisieren.

Zimmer- und Paketmetadaten aktualisieren

Neben der Aktualisierung von Preisdaten mit dem Pull-Modus können Sie auch Transaktionsnachrichten verwenden, um Ihre Zimmer- und Paketmetadaten zu aktualisieren. Weitere Informationen finden Sie unter Zimmer- und Paketmetadaten definieren.

Übermittlungsmodus für Preise geändert

Mit „Geänderte Preise“ können Sie die Größe und Menge von Abfrage- und Transaktionsnachrichten für Preisaktualisierungen reduzieren. Wenn Sie „Geänderte Preise“ verwenden, senden Sie Google eine Liste von Unterkünften mit aktualisierten Preisen. Google antwortet mit einer Anfragenachricht, in der nur die Preise dieser Unterkünfte abgefragt werden.

Wenden Sie sich an Ihren Technical Account Manager (TAM), um den Endpunkt zu konfigurieren, an den Google Hinweisanfragenachrichten sendet. Sie hätten diese bei der Erstkonfiguration eingerichtet.

Das folgende Diagramm zeigt den Anfrage- und Antwortfluss für „Geänderte Preise“:

fig3

In den folgenden Abschnitten werden die einzelnen Schritte dieses Ablaufs beschrieben.

Schritt 1: Hinweisanfragenachricht

Die Hinweisanfragenachrichten, die Google an Ihren Server sendet, haben folgende Eigenschaften:

  • Das Stammelement ist <HintRequest>.
  • Wird an den Endpunkt gesendet, der bei der Erstkonfiguration definiert wurde. Weitere Informationen erhalten Sie von Ihrem Technical Account Manager (TAM).
  • Verwenden Sie die HTTP-Methode POST. Wenn Sie HTTPS verwenden, müssen Sie die Domain von einer offiziellen Zertifizierungsstelle signieren lassen.
  • Der Header Content-Type ist auf application/xml festgelegt.
  • Google sendet in einer bestimmten Häufigkeit einen Zeitstempel an Ihren Server, der angibt, wann Sie zuletzt auf eine Hinweisanfragenachricht geantwortet haben.
  • Der Header User-Agent ist auf Google-HotelAdsPrices festgelegt.

Wir empfehlen, die Häufigkeit auf 5 Minuten festzulegen. Wenn Sie die Häufigkeit von Hinweisanfragenachrichten festlegen oder ändern möchten, wenden Sie sich an uns.

Wenn Sie eine Hinweisanfragenachricht von Google erhalten, antworten Sie mit allen Preisen, die seit diesem Zeitstempel aktualisiert wurden. Weitere Informationen finden Sie unter Hinweisanfragenachrichten.

Schritt 2: Hinweisantwortnachricht

Ihr Server antwortet auf eine Hinweisanfragenachricht mit einer Hinweisantwortnachricht. Diese Nachricht enthält die Hotel-IDs und Reisepläne für Unterkünfte, deren Preise sich geändert haben, seit Sie das letzte Mal eine Hinweisanfragenachricht erhalten und beantwortet haben.

Das Stammelement einer Hinweisantwortnachricht ist <Hint>. Weitere Informationen finden Sie unter Hinweisantwortnachrichten.

Schritt 3: Anfragenachricht

Google erhält die Hinweisantwortnachricht und antwortet mit einer Anfragenachricht, genau wie im Standardmodus „Pull“. Der Unterschied besteht darin, dass die Anfragenachricht jetzt nur die Hotel-IDs und Reisepläne für die Unterkünfte enthält, die Sie in der Hinweisantwortnachricht angegeben haben. Das Stammelement einer Abfragenachricht ist <Query>.

Beim Bestimmen der Hotel-IDs, für die mit „Geänderte Preise“ Preise angefordert werden sollen, ignoriert Google den Inhalt Ihres Hotellistenfeeds. Dadurch wird die Größe der Anfragenachricht, die Sie von Google erhalten, und die Größe der Transaktionsnachricht Ihrer Antwort erheblich reduziert.

Schritt 4: Transaktionsnachricht

Sie senden eine Transaktionsnachricht mit Preisaktualisierungen als Antwort auf die Anfragenachrichten von Google. Das Stammelement einer Transaktionsnachricht ist <Transaction>. Weitere Informationen finden Sie unter Pull-Übermittlungsmodus.