Présentation des flux ARI

ARI (disponibilité, tarifs et inventaire) est un mode d'envoi des prix qui contrôle les tarifs par nuit, la disponibilité et l'inventaire, et qui définit des contraintes liées à leur combinaison. Les flux ARI permettent également d'inclure des taxes, des frais et des promotions.

Contrairement aux modes d'envoi des prix basés sur le séjour, les modes Pull et Requête de prix modifiés, les flux ARI ne sont pas interrogés pour des prix ou des séjours spécifiques. À la place, vous transmettez des messages lorsque votre modèle de tarification comporte de nouvelles données ou des données modifiées, par exemple lorsque des changements ont été apportés aux détails des tarifs, aux restrictions et à la disponibilité.

Avantages

Les flux ARI offrent les avantages suivants:

  • Efficacité de la bande passante: augmente l'efficacité de la bande passante en réduisant le volume de données à transmettre. En envoyant des données ARI la nuit et uniquement des modifications incrémentielles, Google peut calculer les prix et les mises à jour pour un large éventail de valeurs d'achat à l'avance et de durée de séjour.

  • Précision des prix: améliore la précision des prix en utilisant un modèle d'événement "push on change" pour fournir des informations en direct.

  • Meilleure couverture des prix: permet d'obtenir une couverture des prix plus élevée (nombre de séjours avec prix) en utilisant des données précises, combinées à différents itinéraires.

  • Flexibilité: permet d'offrir plus de flexibilité lorsque vous proposez des promotions et des packages.

  • Facilité d'utilisation: transmet les données d'une manière adaptée à la manière dont elles sont stockées sur votre système, ce qui vous évite de devoir calculer ou mettre en cache les prix pour de nombreux séjours.

Types de messages de requête

Les messages ARI envoyés à Google sont appelés messages de "requête" ARI. Google renvoie ensuite des messages de "réponse" indiquant la réussite ou l'échec.

Les flux ARI suivent les protocoles standards de OpenTravel Alliance (OTA) pour certains des principaux types de messages permettant de définir la disponibilité et l'inventaire.

ARI utilise les messages de requête suivants:

  • Transaction (Données sur un établissement). Définit le type de chambre et les informations sur la formule (plan tarifaire).

  • OTA_HotelRateAmountNotifRQ : définit les taux d'occupation par date ou en fonction de la DDS par produit (combinaison de type de chambre et de plan tarifaire) pour des plages de dates spécifiques.

  • OTA_HotelAvailNotifRQ : définit la disponibilité et les restrictions en fonction du type de chambre et des plans tarifaires. Vous pouvez également mettre à jour l'inventaire à l'aide de ce message, mais il est préférable d'utiliser OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ : définit l'inventaire des chambres physiques ou le nombre de chambres disponibles à la vente.

  • TaxFeeInfo (facultatif) : définit les taxes et les frais pour chaque établissement. Ce message n'est pas obligatoire si AmountAfterTax est spécifié dans le message OTA_HotelRateAmountNotifRQ.

  • Promotions (facultatif) : définit des tarifs promotionnels pour certaines réservations, certains séjours et certains utilisateurs.

  • RateModifications (facultatif) : définit les règles de modification des tarifs pour certaines réservations, certains séjours et certains utilisateurs.

  • ExtraGuestCharges (facultatif) : définit la configuration des tarifs pour les enfants et les adultes supplémentaires.

Chaque message contient un sous-ensemble d'informations permettant à Google de calculer les prix et la disponibilité présentés aux utilisateurs lorsqu'ils recherchent vos établissements avec des dates d'arrivée et de départ spécifiques, ainsi que le nombre de personnes souhaité.

Pour en savoir plus sur ARI, consultez la documentation de référence XML.

Messages push

Pour mettre à jour les flux ARI et les informations sur les établissements, envoyez les messages associés chaque fois que les données changent dans votre système.

Pour envoyer des messages, suivez les instructions ci-dessous:

  • Utilisez l'outil en libre-service de la page des paramètres de prix de Hotel Center pour ajouter ou mettre à jour vos adresses IP dans notre système.

  • Utilisez le chemin de base suivant pour le point de terminaison:

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

  • Envoyez des messages à l'aide de la méthode HTTP POST.

  • définir l'en-tête Content-Type sur application/xml ;

  • La fréquence de mise à jour maximale au niveau du compte est de 400 messages par seconde. Si vous dépassez cette limite, un code d'erreur 6032 est renvoyé.

  • Utilisez les chemins d'accès suivants en fonction des données mises à jour:

    • Transaction (Données sur l'établissement): /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

Pour chaque message de requête reçu, Google envoie une réponse HTTP 200 OK si la connexion au serveur a réussi et inclut un corps avec un message de réponse indiquant si les mises à jour ont bien été appliquées, ou si des avertissements ou des erreurs ont été détectés. Si Google répond par un code d'erreur HTTP, renvoyez le message. Si le corps de la réponse HTTP contient des avertissements ou des erreurs, ceux-ci doivent être corrigés avant de renvoyer le message. Vous pouvez également afficher les problèmes rencontrés pour des messages spécifiques sur la page "État du flux" dans Hotel Center.

En ligne sur Google (LoG)

La fonctionnalité "En ligne sur Google" (LoG) vous permet d'afficher vos hôtels sur les sites Web de Google. Étant donné que la valeur par défaut de la LoG d'un hôtel est true, tous les nouveaux hôtels sont automatiquement affichés sur Google.

Utilisez LoG pour activer et désactiver les annonces et les liens de réservation gratuits pour vos établissements dans votre compte Hotel Center, quel que soit l'état de Google Ads ou que les tarifs de l'établissement aient été fournis sur Google. Cela ne s'applique qu'aux hôtels, pas aux locations de vacances.

Il existe deux façons de définir la valeur LoG d'un hôtel: la 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.

Pour en savoir plus sur les LoG, consultez l'aide Hotel Center.

Avec le Travel Partner API, you can do the following:

  • Affichez l'état de vos établissements via Hotel Center ou utilisez le point de terminaison hotelViews.list.

  • Récupérez la liste de tous vos hôtels affichés sur Google à l'aide du paramètre filter avec liveOnGoogle = TRUE dans le point de terminaison hotelViews.list.

  • Obtenez un résumé des propriétés d'un compte spécifique, y compris le nombre d'établissements disponibles sur Google, en utilisant hotelViews.summary.

Pour en savoir plus sur la configuration de la définition d'un loG à l'aide de l'API, consultez l'article hotelViews.list et la documentation de référence de l'API.