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 fournit des contraintes sur la façon dont ces éléments peuvent être combinés. Les flux ARI permettent également d'inclure les taxes, les frais et les promotions de manière flexible.

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

Avantages

Les flux ARI offrent les avantages suivants:

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

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

  • Couverture tarifaire étendue: permet d'augmenter la couverture des prix (nombre d'itinéraires avec des prix) en utilisant des données précises combinées dans différents itinéraires.

  • Flexibilité: cette option offre une plus grande flexibilité pour proposer des promotions et des forfaits.

  • Facilité d'utilisation: transmet les données en fonction de la manière dont elles sont stockées sur votre système, évitant ainsi d'avoir à 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 de l'opération.

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

ARI utilise les messages de requête suivants:

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

  • OTA_HotelRateAmountNotifRQ : définit le taux d'occupation par date ou en fonction de la durée du 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 des chambres physiques ou le nombre de chambres disponibles à la vente.

  • TaxFeeInfo (facultatif) : définit les taxes et les frais par é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 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é affichés lorsque les utilisateurs recherchent vos établissements avec des dates d'arrivée et de départ spécifiques, et le nombre de personnes souhaité.

Pour en savoir plus sur les flux 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.

Suivez les consignes ci-dessous lorsque vous envoyez des messages:

  • Utilisez l'outil en libre-service de la page 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 au niveau du compte est de 400 messages par seconde au maximum. Si vous dépassez cette limite, le code d'erreur 6032 est renvoyé.

  • Utilisez les chemins d'accès 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. Il inclut un corps contenant 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, vous devez les corriger avant de renvoyer le message. Vous pouvez également consulter les problèmes rencontrés pour des messages spécifiques sur la page "État du flux" de Hotel Center.

En ligne sur Google (LoG)

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

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

Il existe deux façons de définir la valeur de lot 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 le LoG, consultez l'aide Hotel Center.

Utiliser Travel Partner API, you can do the following:

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

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

  • Obtenez un résumé des établissements d'un compte spécifique, y compris le nombre d'établissements en ligne sur Google, à l'aide de hotelViews.summary.

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