Übersicht über ARI

Verfügbarkeit, Preise und Bestand (Availability, Rates, and Inventory, ARI) ist ein Preisübermittlungsmodus, mit dem Übernachtungspreise, Verfügbarkeiten und Bestand gesteuert werden. Außerdem werden Einschränkungen für die Kombination dieser Elemente festgelegt. Mit ARI können Sie auch Steuern, Gebühren und Werbeaktionen einbeziehen.

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

Vorteile

ARI bietet folgende Vorteile:

  • Bandbreiteneffizienz: Die Bandbreiteneffizienz wird erhöht, indem die Menge der zu übertragenden Daten reduziert wird. Wenn Sie nächtliche ARI-Daten und nur inkrementelle Änderungen senden, kann Google Preise und Aktualisierungen für eine Vielzahl von Werten für Vorabkäufe und Aufenthaltsdauer berechnen.

  • Preisgenauigkeit: Die Preisgenauigkeit wird durch die Verwendung eines Push-on-Change-Ereignismodells verbessert, um Live-Updates zu ermöglichen.

  • Größere Preisabdeckung: Durch die Verwendung detaillierter Daten, die in verschiedenen Routen kombiniert werden, wird eine höhere Preisabdeckung (Anzahl der Routen mit Preisen) erreicht.

  • Flexibilität: Ermöglicht mehr Flexibilität bei der Bereitstellung von Angeboten und Paketen.

  • Einfache Nutzung: Die Daten werden so übertragen, wie sie in Ihrem System gespeichert sind. So müssen Preise für viele Routen nicht berechnet oder im Cache gespeichert werden.

Anfragenachrichtentypen

ARI-Nachrichten, die an Google gesendet werden, werden als „ARI-Anfragenachrichten“ bezeichnet. Google gibt daraufhin Antwortnachrichten zurück, die den Erfolg oder Misserfolg anzeigen.

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

ARI verwendet die folgenden Anfragenachrichten:

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

  • OTA_HotelRateAmountNotifRQ: Definiert die betragsmäßigen Belegungsraten pro Produkt (Kombination aus Zimmertyp und Preisplan) für bestimmte Zeiträume, entweder pro Datum oder basierend auf der Aufenthaltsdauer.

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

  • OTA_HotelInvCountNotifRQ. Definiert das physische Zimmerinventar oder die Anzahl der Zimmer, die verkauft werden können.

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

  • Promotions. (Optional) Definiert Angebotspreise für bestimmte Buchungen, Aufenthalte und Nutzer.

  • RateModifications. (Optional) Definiert Regeln für die Ratenänderung für bestimmte Buchungen, Aufenthalte und Nutzer.

  • ExtraGuestCharges: (Optional) Definiert, 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 Verfügbarkeit für Nutzer berechnet, wenn sie nach Ihren Unterkünften mit bestimmten Ab- und Anreiseterminen und der gewünschten Belegung suchen.

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

Push-Nachrichten

Zum Aktualisieren von ARI- und Unterkunftsinformationen senden Sie die zugehörigen Nachrichten jedes Mal, wenn sich Daten in Ihrem System ändern.

Beachten Sie beim Senden von Nachrichten die folgenden Richtlinien:

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

  • Verwenden Sie für den Endpunkt folgenden Basispfad:

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

  • Senden Sie Nachrichten über die Methode HTTP POST.

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

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

  • Verwenden Sie je nach aktualisierten 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 eingegangene Anfragenachricht mit HTTP 200 OK, wenn die Verbindung zum Server erfolgreich hergestellt wurde, und fügt einen Text mit einer Antwortnachricht hinzu, der angibt, ob Updates 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 vor dem nochmaligen Senden der Nachricht behoben werden. Sie können im Hotel Center auf der Seite „Feedstatus“ auch Probleme ansehen, die für bestimmte Nachrichten aufgetreten sind.

Live auf Google (LoG)

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

Mit der Funktion „Live auf Google“ können Sie die Unterkünfte in Ihrem Hotel Center-Konto für Anzeigen und kostenlose Buchungslinks aktivieren und deaktivieren – unabhängig vom Google Ads-Status und davon, ob für die Unterkunft Preise auf Google vorhanden sind.

Es gibt zwei Möglichkeiten, den LoG-Wert eines Hotels festzulegen: die 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 zu LoG finden Sie in der Hotel Center-Hilfe.

Travel Partner API, you can do the following: verwenden

  • Sie können den Status Ihrer Unterkünfte über das Hotel Center oder den hotelViews.list-Endpunkt abrufen.

  • Mit dem Parameter filter und liveOnGoogle = TRUE im Endpunkt hotelViews.list können Sie eine Liste aller Ihrer Hotels abrufen, die auf Google angezeigt werden.

  • 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 aktiv sind.

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