ARI-Übersicht

Verfügbarkeit, Preise und Bestand (ARI, Availability, Rates, and Inventory) ist ein Übermittlungsmodus der Preise, der Übernachtungspreise, Verfügbarkeit und Bestand steuert und Einschränkungen dafür vorgibt, wie diese kombiniert werden können. ARI bietet auch die Möglichkeit, Steuern, Gebühren und Angebote flexibel anzugeben.

Im Gegensatz zu den reiseplanbasierten Übermittlungsmodi, „Pull“ und „Geänderte Preise“, werden bei ARI-Feeds keine bestimmten Preise oder Reisepläne abgefragt. Stattdessen senden Sie Push-Nachrichten, wenn Ihr Preismodell neue oder geänderte Daten enthält, z. B. Änderungen an Preisdetails, Einschränkungen und Verfügbarkeit.

Vorteile

ARI bietet die folgenden Vorteile:

  • Bandbreiteneffizienz: Erhöht die Bandbreiteneffizienz, indem das zu übertragende Datenvolumen reduziert wird. Durch das Senden nächtlicher ARI-Daten und nur inkrementeller Änderungen kann Google Preise und Aktualisierungen für eine Vielzahl von Werten für Vorauskäufe und Aufenthaltsdauer berechnen.

  • Preisgenauigkeit: Verbessert die Preisgenauigkeit, indem ein Push-on-Change-Ereignismodell verwendet wird, um Live-Updates bereitzustellen.

  • Höhere Preisabdeckung: Diese Option erzielt eine höhere Preisabdeckung (Anzahl der Reisepläne mit Preisen), indem detaillierte Daten verwendet werden, die in verschiedenen Reiseplänen kombiniert werden.

  • Flexibilität: Ermöglicht mehr Flexibilität beim Anbieten von Angeboten und Paketen.

  • Nutzerfreundlichkeit: Überträgt Daten in einer Weise, die ihrer Speicherung in Ihrem System entspricht, sodass Preise für viele Reisepläne nicht berechnet oder im Cache gespeichert werden müssen.

Arten von Anfragenachrichten

ARI-Nachrichten, die an Google gesendet werden, werden als ARI-Anfragenachrichten bezeichnet. Anschließend gibt Google Antwortnachrichten zurück, die auf Erfolg oder Misserfolg hinweisen.

ARI folgt den Standardprotokollen von OpenTravel Alliance (OTA) für einige der wichtigsten Nachrichtentypen zum Definieren von Verfügbarkeit und Inventar.

ARI verwendet die folgenden Anfragenachrichten:

  • Transaction (Unterkunftsdaten). Definiert den Zimmertyp und die Paketinformationen (Preisplan).

  • OTA_HotelRateAmountNotifRQ. Definiert die auf der Aufenthaltsdauer basierenden Belegungsraten pro Produkt (Kombination aus Zimmertyp und Preisplan) für bestimmte Zeiträume.

  • OTA_HotelAvailNotifRQ. Definiert Verfügbarkeit und Einschränkungen basierend auf dem Zimmertyp und den Preisplänen. Das Inventar kann auch mit dieser Nachricht aktualisiert werden, aber OTA_HotelInvCountNotifRQ wird bevorzugt.

  • OTA_HotelInvCountNotifRQ. Definiert das physische Zimmerinventar oder die Anzahl der zum Verkauf verfügbaren Zimmer.

  • TaxFeeInfo (optional): Definiert Steuern und Gebühren pro Unterkunft. Diese Nachricht ist nicht erforderlich, wenn AmountAfterTax in der OTA_HotelRateAmountNotifRQ-Nachricht angegeben ist.

  • Promotions (optional): Definiert Aktionspreise für bestimmte Buchungen, Aufenthalte und Nutzer.

  • RateModifications (optional): Definiert Preisänderungsregeln für bestimmte Buchungen, Aufenthalte und Nutzer.

  • ExtraGuestCharges. (Optional) Legt fest, wie Preise für Kinder und zusätzliche Erwachsene konfiguriert werden sollen.

Jede Nachricht enthält eine Teilmenge von Informationen, anhand derer Google die Preise und die Verfügbarkeit berechnet, die Nutzern angezeigt werden, wenn sie nach Ihren Unterkünften mit bestimmten Check-in- und Check-out-Datumsangaben und der gewünschten Belegung suchen.

Weitere Informationen zu ARI finden Sie in der XML-Referenz.

Push-Nachrichten

Zum Aktualisieren von ARI- und Attributinformationen senden Sie die zugehörigen Nachrichten immer dann, wenn sich Daten in Ihrem System ändern.

Beachten Sie beim Senden von Nachrichten die folgenden Richtlinien:

  • Verwenden Sie das Selfservice-Tool auf der Seite mit den Preiseinstellungen des Hotel Centers, um Ihre IP-Adressen in unserem System hinzuzufügen oder zu aktualisieren.

  • Verwenden Sie für den Endpunkt den folgenden Basispfad:

    • https://www.google.com oder Host: www.google.com Port: 443

  • Senden Sie Nachrichten mit der Methode HTTP POST.

  • Setzen Sie den Content-Type-Header auf application/xml.

  • Auf Kontoebene gilt eine maximale Aktualisierungsrate von 400 Nachrichten pro Sekunde. Wird dieses Limit überschritten, wird der Fehlercode 6032 zurückgegeben.

  • Verwenden Sie abhängig von den zu aktualisierenden Daten die folgenden Pfade:

    • Transaction (Unterkunftsdaten): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Google antwortet auf jede empfangene Anfragenachricht mit einer HTTP 200 OK, wenn die Verbindung zum Server erfolgreich hergestellt wurde, und fügt einen Text mit einer Antwortnachricht ein, die angibt, ob die Aktualisierungen erfolgreich angewendet wurden oder ob Warnungen oder Fehler aufgetreten sind. Wenn Sie von Google als Antwort einen HTTP-Fehlercode erhalten, senden Sie die Nachricht noch einmal. Wenn der HTTP-Antworttext Warnungen oder Fehler enthält, sollten diese behoben werden, bevor die Nachricht noch einmal gesendet wird. Probleme, die für bestimmte Nachrichten aufgetreten sind, finden Sie auch im Hotel Center auf der Seite „Feedstatus“.

Live auf Google (LoG)

Mit Live auf Google (LoG) können Sie Ihre Hotels auf Google-Websites präsentieren. Da der Standardwert für das LoG eines Hotels true ist, werden alle neuen Hotels automatisch auf Google angezeigt.

Mit LoG können Sie Ihre Unterkünfte für Anzeigen und kostenlose Buchungslinks in Ihrem Hotel Center-Konto aktivieren und deaktivieren, unabhängig vom Google Ads-Status oder davon, ob für die Unterkunft Preise auf Google vorhanden sind. Dies gilt nur für Hotels und nicht für Ferienunterkünfte.

Es gibt zwei Möglichkeiten, den LoG-Wert eines Hotels festzulegen: den Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Weitere Informationen zum LoG finden Sie in der Hotel Center-Hilfe.

Travel Partner API, you can do the following: verwenden

  • Rufen Sie den Status Ihrer Unterkünfte im Hotel Center auf oder verwenden Sie den Endpunkt hotelViews.list.

  • Mithilfe des Parameters filter mit liveOnGoogle = TRUE im Endpunkt hotelViews.list können Sie eine Liste aller auf Google angezeigten Hotels abrufen.

  • Mit hotelViews.summary können Sie eine Zusammenfassung der Properties für ein bestimmtes Konto abrufen, einschließlich der Anzahl der Properties, die auf Google verfügbar sind.

Weitere Informationen zum Festlegen von LoG mithilfe der API finden Sie im hotelViews.list-Artikel und in der API-Referenz.