Übermittlungsmodi für Preise

Der Übermittlungsmodus bestimmt, wie Sie Preisaktualisierungen für Kombinationen aus Hotel und Reiseplan an Google senden. Sie und Ihr Technical Account Manager (TAM) arbeiten bei der Erstkonfiguration zusammen, um den Übermittlungsmodus einzurichten.

Übersicht der Übermittlungsmodi

Standardmäßig können Hotelanfragen bis zu 330 Tage im Voraus und für bis zu 30 Übernachtungen abgefragt werden. Sie können jedoch die maximale Anzahl der Reisepläne (Kombination aus Anreisedatum 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 zu entscheiden, ob dieser Feedtyp für Ihr Konto am besten geeignet ist. Weitere Informationen finden Sie unter ARI verwenden.

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

• Geänderte Preise (früher „Pull with Hints“): Ähnlich wie der Pull-Modus, mit dem Unterschied, dass Google nur Daten für einen Teil der Unterkünfte anfordert, nicht für alle Unterkünfte. In diesem Modus kann der Netzwerkverkehr beim Aktualisieren von Preisen und Verfügbarkeit für Ihre Unterkünfte erheblich reduziert werden. Die Preise bleiben für unbestimmte 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 auch zum Zeitpunkt der Auktion Preisaktualisierungen über Livepreisabfragen anfordern. Livepreisabfragen sind Preisanfragen von Google für eine aktuelle Auktion. Wenn Sie innerhalb der vorgegebenen Frist antworten, sollte Ihre Anzeige in der Auktion erscheinen.

Google speichert Antworten auf Livepreisabfragen wie jede andere Transaktionsnachricht. So 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 enthalten in der Regel keine Informationen über den Nutzer, da Google Ihre Antworten verwendet, um einen Cache zu füllen, der für verschiedene Nutzer verwendet werden kann.

Da es teuer für Sie sein kann, Preise zurückzugeben, die einem vollständigen Satz möglicher Nutzerkontexte entsprechen, wird eine Funktion getestet, wenn beliebte Nutzerkontexte als Teil der Abfrage angegeben werden. Die Nutzerkontexte basieren auf Nutzeranfragen, bei denen Sie die Möglichkeit hatten, einen Preis anzuzeigen, und sind so berechnet, dass die überwiegende Mehrheit der Nutzeranfragen abgedeckt wird. Für sehr beliebte Properties oder Reisepläne wird möglicherweise eine große Anzahl von Nutzerkontexten angezeigt. 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.

Tipp: Wenn Sie daran interessiert sind, beliebte Nutzerkontexte in von Google gesendeten Abfragen zu erhalten, wenden Sie sich an Ihren Technical Account Manager (TAM) (TAM). Er bestätigt, dass Sie bereit sind, solche Nachrichten zu empfangen, und nimmt dann eine Konfigurationsanpassung vor, damit Nutzerkontexte in Abfragen an Sie gesendet werden.

ARI Push-Übermittlungsmodus

Mit dem ARI Push-Übermittlungsmodus senden Sie inkrementelle Aktualisierungen 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 der Preisinformationen effizient an Google zu aktualisieren.

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

Schritt 1: ARI Push-Nachrichten an Google senden

Wenn Sie Ihre Daten mit ARI Push aktualisieren möchten, senden Sie bei jeder Änderung Ihrer Daten eine ARI-Anfragenachricht. 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 HTTP 200 OK, wenn die Verbindung zum Server erfolgreich ist. Außerdem enthält sie einen Textkörper 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, über die Sie ARI-Nachrichten an Google senden, auf die Zulassungsliste setzen. Informationen zum Aktualisieren Ihrer Preiseinstellungen im Hotel Center

Zimmer- und Paketmetadaten mit ARI Push aktualisieren

Mit dem Nachrichtentyp „Transaktion (Unterkunftsdaten)“ können Sie die aktiven Zimmertypen und Preispläne (Pakete) für jede Unterkunft definieren. Sie sollten Updates immer dann hochladen, 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 untergeordnete Elemente des Elements <PropertyDataSet>.

Verbindungs- oder Inhaltsfehler

Wenn Sie einen Fehler im Übermittlungsmodus erhalten, weil die XML-Datei falsch formatiert oder fehlerhaft 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-Zyklus des Pull-Modus:

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 sollten.

Die von Google an Ihren Server gesendeten Nachrichten mit 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.

Wichtiger Hinweis :Unter Umständen sind viele Anfragenachrichten erforderlich, um alle Preise für alle Hotels zu aktualisieren. Die resultierenden Transaktionsnachrichten sind dann sehr umfangreich. Wenn Sie die Größe und Anzahl der Nachrichten reduzieren möchten, empfehlen wir die Verwendung von Geänderte Preise.

Schritt 2: Transaktionsnachricht

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

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 Pull 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 der Unterkünfte 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. Das wäre bei der Erstkonfiguration der Fall gewesen.

Wichtiger Hinweis: Wenn Sie keine Hinweisantwortnachrichten implementieren, werden in den Anfragenachrichten von Google Daten für all-Unterkünfte angefordert, die in Ihrer Hotelliste aufgeführt sind.

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

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 regelmäßigen Abständen 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 eine Häufigkeit von 5 Minuten. Wenn Sie die Häufigkeit der 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 sowie 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 empfängt die Hinweisantwortnachricht und antwortet wie im Standardmodus „Pull“ mit einer Anfragenachricht. 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 von Google erhaltenen Anfragenachricht 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.