Übermittlungsmodi für Preise

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

Übersicht über Übermittlungsmodi

Standardmäßig kann ein Hotel bis zu 330 Tage im Voraus und für bis zu 30 Übernachtungen angefragt werden. Sie können jedoch die maximale Anzahl der Reisepläne (Kombination aus Anreisedatum und Aufenthaltsdauer) festlegen.

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 Nachrichten vom Typ Transaktion 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, die einen Teil der Informationen enthalten, die ein Preismodell für Ihre Unterkünfte darstellen, das auf verschiedenen Preisdetails, Einschränkungen und Verfügbarkeit basiert. 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 sendet regelmäßig Anfragen an Ihren Dienst, um seinen Cache mit Preis- und Verfügbarkeitsdaten zu aktualisieren. Bei diesem Modell sendet Google eine Anfrage an Ihren Server, von dem dieser mit aktualisierten Daten antwortet. Dieses Modell ist am besten geeignet, wenn Sie nicht genau wissen, wann sich Preisinformationen ändern, oder wenn sich Preisinformationen im Laufe des Tages unregelmäßig ändern. Preise bleiben im Cache, bis die Algorithmen von Google anhand der partnerspezifischen bisherigen Preisänderungen feststellen, dass die Preise veraltet sind. Weitere Informationen finden Sie unter Verwendung des Pull-Übermittlungsmodus.

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

Mit Transaktionsnachrichten können Sie nicht nur Preise aktualisieren, sondern auch Hotels 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 mit Livepreisabfragen anfordern. Livepreisabfragen sind Preisanfragen von Google für eine aktuelle Auktion. Wenn Sie innerhalb der angegebenen Frist antworten, sollte Ihre Anzeige an der Auktion teilnehmen.

Google speichert Antworten auf Livepreisabfragen genauso wie jede andere Transaktionsnachricht. So kann Google den Preis aus seinem Cache in Zukunft bereitstellen, anstatt eine weitere Livepreisabfrage zu senden.

Weitere Informationen finden Sie unter Livepreisabfragen.

Wichtiger Hinweis :Aufgrund der neuen Suche ist die Liveabfrage für Nutzer im EWR nicht mehr verfügbar.

Kontext

Pull- und geänderte Preise geben in der Regel keine Informationen über den Nutzer an, da Google Ihre Antworten zum Füllen eines Cache verwendet, der möglicherweise für eine Vielzahl verschiedener Nutzer verwendet werden kann.

Da es für Sie teuer sein kann, Preise zurückzugeben, die einem vollständigen Satz möglicher Nutzerkontexte entsprechen, wird ein Feature getestet, bei dem beliebte Nutzerkontexte im Rahmen der Abfrage angegeben werden. Die Nutzerkontexte basieren auf Nutzeranfragen, bei denen Sie die Möglichkeit hatten, einen Preis anzugeben, und sind so berechnet, dass sie die überwiegende Mehrheit der Nutzeranfragen abdecken. Für sehr beliebte Unterkünfte oder Reisepläne wird möglicherweise eine große Anzahl von Nutzerkontexten angezeigt. Die durchschnittliche Anzahl von Nutzerkontexten 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. Wenn Sie einen vorgeschlagenen Nutzerkontext ignorieren, kann dies jedoch zu weniger Zugriffen führen.

Tipp: Wenn Sie beliebte Nutzerkontexte in von Google gesendeten Abfragen erhalten möchten, wenden Sie sich an Ihren Technical Account Manager (TAM) (TAM). Er bestätigt, dass Sie zum Empfangen solcher Nachrichten bereit sind, und nimmt dann eine Konfigurationsanpassung vor, um Nutzerkontexte in Abfragen an Sie zu senden.

ARI Push-Übermittlungsmodus

Mit dem ARI Push-Übermittlungsmodus senden Sie inkrementelle Aktualisierungen an Google, wenn sich die Übernachtungspreise, Verfügbarkeit, Inventarzahlen oder andere Einschränkungen ändern. Im Gegensatz zu „Pull“ oder „Geänderte Preise“ können Sie bei ARI Push ein anderes Preismodell verwenden, um verschiedene Komponenten von 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.

Die Preise sollten von Google bereitgestellt werden und für Nutzer innerhalb von 15 bis 20 Minuten nach Eingang einer Nachricht sichtbar sein.

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

Google antwortet auf jede empfangene ARI Push-Nachricht 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 es 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

Verwenden Sie die Seite mit den Hotel Center-ARI-Preiseinstellungen, um alle IP-Adressen, die Sie zum Übertragen von ARI-Nachrichten an Google verwenden, auf die Zulassungsliste zu 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 per Push-Befehl 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 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

Mit dem 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 wird jeder dieser 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 kann 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 groß. Wir empfehlen die Verwendung von Geänderte Preise, um die Größe und Anzahl der Nachrichten zu reduzieren.

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

Sie können nicht nur Preisdaten im Pull-Modus aktualisieren, sondern auch Ihre Zimmer- und Paketmetadaten mithilfe von Transaktionsnachrichten aktualisieren. Weitere Informationen finden Sie unter Zimmer- und Paketmetadaten definieren.

Übermittlungsmodus für geänderte Preise

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 angefordert werden.

Wenden Sie sich an Ihren Technical Account Manager (TAM), um den Endpunkt zu konfigurieren, an den Google Hinweisanfragenachrichten sendet. Sie müssen dies bei der Erstkonfiguration eingerichtet haben.

Wichtiger Hinweis: Wenn Sie keine Hinweisantwortnachrichten implementieren, werden in den Anfragenachrichten von Google Daten für all Unterkünfte abgefragt, 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, die Häufigkeit auf 5 Minuten festzulegen. Kontaktieren Sie uns, um die Häufigkeit von Hinweisanfragenachrichten festzulegen oder zu ändern.

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 empfängt die Hinweisantwortnachricht und antwortet mit einer Anfragenachricht, genau wie beim standardmäßigen Pull-Modus. 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 Anfragenachricht ist <Query>.

Beim Bestimmen der Hotel-IDs, für die mit „Geänderte Preise“ Preise angefragt 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.