Présentation des flux ARI

Le mode d'envoi des prix ARI (Availability, Rates and Inventory) contrôle les tarifs par nuit, la disponibilité et l'inventaire, et définit des contraintes sur la façon dont ils peuvent être combinés. L'ARI permet également d'inclure des taxes, des frais et des promotions.

Contrairement aux modes d'envoi des prix basés sur les séjours, "Pull" et "Requête de prix modifiés", les flux ARI ne reçoivent pas de requêtes portant sur des prix ou des séjours spécifiques. À la place, vous envoyez des messages lorsque des données nouvelles ou modifiées sont disponibles pour votre modèle de tarification, par exemple des modifications des tarifs, des restrictions et de la disponibilité.

Avantages

L'ARI offre 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 chaque 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 mises à jour en temps réel.

  • Couverture tarifaire plus large: permet d'obtenir une couverture tarifaire plus large (nombre d'itinéraires avec des prix) en utilisant des données précises combinées à différents itinéraires.

  • Flexibilité: offre une plus grande flexibilité en proposant des promotions et des packages.

  • Facilité d'utilisation: transmet les données de manière à s'adapter à la façon dont elles sont stockées sur votre système, ce qui évite de calculer ou de mettre en cache les prix de nombreux itinéraires.

Types de messages de requête

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

ARI suit 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 le package (plan tarifaire).

  • OTA_HotelRateAmountNotifRQ : définit les montants des tarifs d'occupation par date ou par durée de séjour 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. L'inventaire peut également être mis à jour à l'aide de ce message, mais OTA_HotelInvCountNotifRQ est préférable.

  • OTA_HotelInvCountNotifRQ : définit l'inventaire physique des chambres 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 des règles de modification des tarifs pour certaines réservations, certains séjours et certains utilisateurs.

  • ExtraGuestCharges (facultatif) : définit la façon dont les tarifs doivent être configurés 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, et un 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 modification des données dans votre système.

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

  • Utilisez l'outil en libre-service de la page "Paramètres des 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 ;

  • Le taux de mise à jour maximal au niveau du compte est de 400 messages par seconde. Si vous dépassez cette limite, le code d'erreur 6032 est renvoyé.

  • Utilisez les chemins suivants en fonction des données mises à jour:

    • Transaction (Données sur un é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 renvoie une réponse HTTP 200 OK si la connexion au serveur a abouti, et inclut un corps avec un message de réponse indiquant si les mises à jour ont été correctement appliquées, ou ont généré des avertissements ou des erreurs. 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, ils doivent être corrigés avant que le message ne soit renvoyé. 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 direct sur Google vous permet de présenter vos hôtels sur les sites Web Google. Étant donné que la valeur par défaut de LoG pour un hôtel est true, tous les nouveaux hôtels s'affichent automatiquement sur Google.

Utilisez En ligne sur Google pour activer ou désactiver les annonces et les liens de réservation gratuits pour vos établissements dans votre compte Hotel Center, quel que soit leur état dans Google Ads et que les tarifs de l'établissement aient été fournis à Google ou non.

Il existe deux façons de définir la valeur LoG d'un hôtel: 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 journaux des opérations, consultez l'aide Hotel Center.

Utiliser Travel Partner API, you can do the following:

  • Consultez 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écapitulatif des propriétés d'un compte spécifique, y compris le nombre de propriétés diffusées sur Google, à l'aide de hotelViews.summary.

Pour savoir comment définir LoG à l'aide de l'API, consultez l'article hotelViews.list et la documentation de référence de l'API.