ARI-Übersicht

„Verfügbarkeit, Preise und Bestand“ (Availability, Rates, and Inventory, ARI) ist ein Preisübermittlungsmodus, mit dem Übernachtungspreise, Verfügbarkeit und Inventar gesteuert und Einschränkungen für die Kombination dieser Elemente festgelegt werden. ARI bietet auch die Möglichkeit, Steuern, Gebühren und Werbeaktionen einzubeziehen.

Im Gegensatz zu den Übermittlungsmodi für reiseplanbasierte Preise (Pull-Preise und geänderte Preise) werden für ARI-Feeds keine spezifischen Preise oder Reisepläne abgefragt. Stattdessen senden Sie Push-Nachrichten, wenn neue oder geänderte Daten für Ihr Preismodell verfügbar sind, z. B. Änderungen der Preisdetails, Einschränkungen und Verfügbarkeit.

Vorteile

ARI bietet folgende Vorteile:

• Bandbreiteneffizienz: Erhöht die Bandbreiteneffizienz, indem die Menge der zu übertragenden Daten reduziert wird. Wenn Sie täglich ARI-Daten und nur inkrementelle Änderungen senden, kann Google Preise und Aktualisierungen für eine Vielzahl von Werten für den Vorabkauf und die Aufenthaltsdauer berechnen.

• Preisgenauigkeit: Verbessert die Preisgenauigkeit durch ein Push-on-Change-Ereignismodell, das Live-Updates ermöglicht.

• Bessere Abdeckung der Preise: Durch die Verwendung detaillierter Daten, die in verschiedene Reisepläne kombiniert werden, wird eine größere Abdeckung der Preise (Anzahl der Reisepläne mit Preisen) erreicht.

• Flexibilität: Sie können Werbeaktionen und Pakete flexibler anbieten.

• Einfache Bedienung: Die Daten werden so übertragen, wie sie in Ihrem System gespeichert sind. So müssen Preise für viele Reisepläne 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.

Wichtiger Hinweis :Sie müssen die vier Nachrichtentypen – Transaktion, Preis, Inventar und Verfügbarkeit – senden, bevor Preise verfügbar sind. Wir empfehlen, die Größe von ARI-Nachrichten auf <OTA_HotelRateAmountNotifRQ> 5 MB zu begrenzen und die Uploadrate auf 400 Dateien pro Sekunde zu beschränken.

ARI verwendet die folgenden Anfragenachrichten:

• Transaction (Unterkunftsdaten). Hier werden die Informationen zum Zimmertyp und zum Paket (Preisplan) definiert.

• OTA_HotelRateAmountNotifRQ: Definiert die Preise pro Belegung pro Tag oder pro Aufenthaltsdauer pro Produkt (Kombination aus Zimmertyp und Preisplan) für bestimmte Zeiträume.

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

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

• 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) Hiermit werden Aktionspreise für bestimmte Buchungen, Aufenthalte und Nutzer definiert.

• RateModifications. (Optional) Hiermit werden Preisänderungsregeln für bestimmte Buchungen, Aufenthalte und Nutzer definiert.

• ExtraGuestCharges: Optional. Hiermit wird festgelegt, wie die 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.

Wichtiger Hinweis: Die Nachrichtendaten werden mit bereits übertragenen Daten zusammengeführt. Daher müssen Sie nur neue oder geänderte Daten senden.

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.

• Die maximale Aktualisierungsrate auf Kontoebene beträgt 400 Nachrichten pro Sekunde. Wird dieses Limit überschritten, 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 die 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.

Wichtig: Die Log-Datei ist sowohl für Hotels als auch für Ferienunterkünfte verfügbar.

Es gibt zwei Möglichkeiten, den LoG-Wert eines Hotels festzulegen: über das 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.

• Verwenden Sie den Parameter filter mit liveOnGoogle = TRUE im Endpunkt hotelViews.list, um eine Liste aller Ihrer auf Google angezeigten Hotels abzurufen.

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

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