Modes d'envoi des prix

Le mode d'envoi détermine la manière dont vous nous envoyez vos mises à jour de prix pour les combinaisons d'hôtel et de séjour. Vous et votre responsable de compte technique (TAM) travaillez ensemble lors de la configuration initiale pour définir le mode d'envoi.

Présentation des modes d'envoi

Par défaut, un hôtel peut être interrogé jusqu'à 330 jours avant la disponibilité de la chambre et jusqu'à 30 nuits de séjour, mais vous pouvez déterminer le nombre maximal d'itinéraires (combinaison de la date d'arrivée et de la durée du séjour).

Plus vous proposez de séjours, plus vous pourrez participer aux enchères. Toutefois, plus vous proposez de séjours, plus vous devez envoyer de données à Google pour garantir l'exactitude de vos données tarifaires.

En général, les prix sont mis à jour via des messages Transaction de l'une des manières suivantes:

• ARI (Push): flux d'envoi des prix qui utilise les plans tarifaires, la disponibilité et les métadonnées des hôtels afin de définir des stratégies de tarification prédéfinies pour vos établissements. Contrairement aux modes Pull et Requête de prix modifiés, les flux ARI n'interrogent pas de prix ni de séjours spécifiques. À la place, vous transmettez des messages contenant un sous-ensemble d'informations qui représente un modèle de tarification pour vos établissements, en fonction des différents détails des tarifs, restrictions et disponibilités. Les flux ARI utilisent la spécification XML OTA (OTA_HotelRateAmountNotifRQ et OTA_HotelAvailNotifRQ) pour définir la disponibilité et les prix. Contactez votre responsable de compte pour en savoir plus sur le mode d'envoi ARI et pour déterminer si ce type de flux est le mieux adapté à votre compte. Pour en savoir plus, consultez la page Utiliser ARI.

• Pull: Google interroge régulièrement votre service pour actualiser son cache de données concernant les prix et les disponibilités. Dans ce modèle, Google envoie une requête à votre serveur, qui répond en fournissant les données mises à jour. Ce modèle est préférable si vous ne savez pas exactement quand les informations tarifaires changent ou si elles changent de manière irrégulière tout au long de la journée. Les prix restent dans le cache jusqu'à ce que les algorithmes de Google déterminent que les prix sont obsolètes d'après l'historique des modifications de prix précédentes d'un partenaire. Pour en savoir plus, consultez la section Utiliser le mode d'envoi pull.

• Requête de prix modifiés (anciennement Pull with Hints): semblable au mode Pull, à la différence que Google ne demande que les données d'un sous-ensemble d'établissements, et non de l'ensemble des établissements. Ce mode peut réduire considérablement le volume de trafic réseau lors de la mise à jour des prix et des disponibilités de vos établissements. Les prix sont conservés indéfiniment dans le cache jusqu'à ce qu'ils soient mis à jour. Pour en savoir plus, consultez la section Utiliser le mode Requête de prix modifiés.

En plus de mettre à jour vos prix, vous pouvez utiliser des messages Transaction pour supprimer des établissements de votre inventaire. Pour en savoir plus, consultez la section Supprimer des éléments de l'inventaire.

Pour en savoir plus sur la transmission de mises à jour de prix et obtenir des exemples de messages Transaction, consultez l'article Mettre à jour les prix.

Requêtes de prix en temps réel

Google peut également demander la mise à jour de certains prix au moment des enchères à l'aide des requêtes de prix en temps réel. Les requêtes de prix en temps réel sont des demandes de prix envoyées par Google pour une enchère en cours. Si vous répondez dans le délai spécifié, votre annonce doit apparaître dans l'enchère.

Nous stockons les réponses aux requêtes de prix en temps réel comme tout autre message Transaction. Ainsi, Google peut diffuser le prix figurant dans le cache au lieu d'envoyer une autre requête de prix en temps réel.

Pour en savoir plus, consultez Requêtes de prix en temps réel.

Important :En raison de la nouvelle expérience de recherche, les requêtes en direct ne sont plus disponibles pour les utilisateurs de l'EEE.

Contexte

Les requêtes Pull et Requête de prix modifiés ne spécifient généralement pas d'informations sur l'utilisateur, car Google utilise vos réponses pour remplir un cache qui peut servir à répondre aux besoins de différents utilisateurs.

Étant donné qu'il peut être coûteux de renvoyer des prix correspondant à un ensemble complet de contextes utilisateur possibles, une fonctionnalité est en cours de test dans laquelle des contextes utilisateur courants sont spécifiés dans le cadre de la requête. Les contextes utilisateur sont basés sur les requêtes des utilisateurs pour lesquelles vous avez eu l'opportunité d'afficher un prix. Ils sont calculés pour couvrir la grande majorité de ces requêtes. Il est possible que vous voyiez un grand nombre de contextes utilisateur pour des établissements ou des séjours très populaires, mais le nombre moyen de contextes utilisateur doit être inférieur à 10. Vous pouvez renvoyer des prix supplémentaires ou ignorer les contextes utilisateur spécifiés. C'est à vous de décider du prix à renvoyer pour une requête donnée. Toutefois, si vous ignorez un contexte utilisateur suggéré, le trafic risque d'être moins élevé.

Conseil :Si vous souhaitez recevoir des contextes utilisateur courants dans les requêtes envoyées par Google, contactez votre responsable de compte technique (TAM). Il confirmera que vous êtes prêt à recevoir ces messages, puis ajustera votre configuration pour commencer à vous envoyer des contextes utilisateur dans des requêtes.

Mode d'envoi ARI (Push)

Le mode d'envoi ARI (Push) vous permet d'envoyer des mises à jour incrémentielles à Google chaque fois que les tarifs par nuit, la disponibilité, les inventaires ou d'autres restrictions changent. Contrairement aux modes Pull ou Requête de prix modifiés, les flux ARI (Push) vous permettent d'utiliser un autre modèle de tarification pour mettre à jour efficacement divers composants des informations tarifaires dans Google.

Le schéma suivant illustre le flux de requêtes et de réponses pour le mode d'envoi ARI (Push) :

Étape 1: Envoyez des messages ARI (Push) à Google

Pour mettre à jour vos données avec le mode ARI (Push), envoyez un message de requête ARI chaque fois que vos données changent. Le mode d'envoi ARI (Push) est compatible avec différents types de messages et stratégies de tarification. Pour en savoir plus sur la transmission de messages, consultez la page Utiliser ARI.

Vos prix doivent être diffusés par Google et visibles par les utilisateurs dans les 15 à 20 minutes suivant la réception d'un message.

Étape 2: Vérifiez que les données sont bien mises en cache par Google

Pour chaque message ARI (Push) reçu, Google répond avec l'état de la connexion HTTP et les résultats du traitement ARI. Google répond par un code HTTP 200 OK si la connexion au serveur aboutit. Il comprend également un corps avec un message de réponse indiquant si les mises à jour ont bien été appliquées, ou si le mode d'envoi a reçu des avertissements ou des erreurs.

Ajouter des adresses IP à la liste d'autorisation

Pour ajouter à la liste d'autorisation toutes les adresses IP que vous utilisez pour envoyer des messages ARI à Google, accédez à la page Paramètres des prix ARI de Hotel Center. Découvrez comment mettre à jour vos paramètres de prix dans Hotel Center.

Mettre à jour les métadonnées de chambres et de formules à l'aide du mode ARI (Push)

Utilisez le type de message Transaction (Données sur un établissement) pour définir les types de chambres actifs et les plans tarifaires (forfaits) pour chaque établissement. Vous devez envoyer des mises à jour chaque fois que des types de chambres ou des plans tarifaires sont ajoutés, supprimés ou modifiés. Dans ce cas, vous envoyez un message XML avec les nouvelles informations dans les éléments <RoomData> et <PackageData>. Ces éléments sont des enfants de l'élément <PropertyDataSet>.

Erreurs de connexion ou de contenu

Si vous recevez une erreur de mode d'envoi en raison d'un format XML incorrect ou d'un format incorrect, recherchez la résolution recommandée dans Messages d'erreur concernant l'état du flux.

Si vous recevez une erreur de connexion HTTP lors de l'envoi d'un message ARI à Google, relancez la requête à des intervalles de 1, 5 et 20 minutes. Si le problème persiste après trois tentatives, cessez d'envoyer des messages et contactez l'assistance Google.

Mode d'envoi Pull

Avec le mode d'envoi pull, Google envoie régulièrement des messages de requête à votre serveur pour demander des mises à jour de prix. Votre serveur répond à ces messages par des messages Transaction contenant les données de prix et de disponibilité mises à jour.

Le schéma suivant illustre le flux requête/réponse lors de l'utilisation du mode d'envoi Pull:

Après avoir reçu les mises à jour des prix, Google traite généralement les nouvelles données de tarification et de disponibilité dans un délai d'environ cinq minutes.

Les sections suivantes décrivent chacune de ces étapes plus en détail.

Étape 1: Message de requête

Par défaut, Google envoie des messages de requête pour tous les établissements définis dans votre liste d'hôtels. Cela peut signifier que vous devez recevoir plusieurs messages Query pendant les processus de mise à jour des tarifs.

Les messages de requête de prix que Google envoie à votre serveur présentent les caractéristiques suivantes:

• L'élément racine est <Query>.
• Ils sont envoyés au point de terminaison défini lors de la configuration initiale. Pour en savoir plus, contactez votre responsable de compte technique (TAM).
• Utilise la méthode HTTP POST. (Si vous utilisez HTTPS, vous devez faire signer le domaine par une autorité de certification officielle.)
• L'en-tête Content-Type est défini sur application/xml.
• Chaque message inclut jusqu'à 100 établissements pour lesquels Google demande des données sur les tarifs et les disponibilités.
• L'en-tête User-Agent est défini sur Google-HotelAdsPrices.

Important :De nombreux messages de requête peuvent vous inviter à mettre à jour les prix de tous les hôtels, et les messages Transaction qui en résultent peuvent être très volumineux. Pour réduire la taille et le nombre des messages, nous vous recommandons d'utiliser le mode Requête de prix modifiés.

Étape 2: message Transaction

Lorsque votre serveur reçoit un message de requête, il doit répondre par un message Transaction contenant les informations tarifaires des séjours demandés.

L'élément racine d'un message Transaction est <Transaction>. Pour en savoir plus, consultez les sections Messages Transaction et Mettre à jour les prix.

Modifier les métadonnées des chambres et des formules

En plus de mettre à jour les données tarifaires avec le mode Pull, vous pouvez également utiliser les messages Transaction pour mettre à jour les métadonnées de vos chambres et de vos formules. Pour en savoir plus, consultez Définir des métadonnées de chambres et de formules.

Mode d'envoi "Requête de prix modifiés"

Le mode Requête de prix modifiés permet de réduire la taille et la quantité des messages de requête et de transaction pour les mises à jour de prix. Lorsque vous utilisez le mode Requête de prix modifiés, vous envoyez à Google la liste des établissements dont les prix ont été modifiés. Nous répondons par un message de requête qui ne demande que les prix de ces établissements.

Pour configurer le point de terminaison auquel Google envoie des messages Hint request, consultez votre responsable de compte technique (TAM). Vous devez l'avoir défini lors de la configuration initiale.

Important :Si vous n'implémentez pas de messages de réponse d'indication, les messages Query de Google demandent des données pour les établissements all identifiés dans votre liste d'hôtels.

Le schéma suivant illustre le flux de requêtes et de réponses pour le mode Requête de prix modifiés:

Les sections suivantes décrivent chacune des étapes de ce flux.

Étape 1: message Hint request

Les messages Hint request que Google envoie à votre serveur présentent les caractéristiques suivantes:

• L'élément racine est <HintRequest>.
• Ils sont envoyés au point de terminaison défini lors de la configuration initiale. Pour en savoir plus, contactez votre responsable de compte technique (TAM).
• Utilisez la méthode HTTP POST. (Si vous utilisez HTTPS, vous devez faire signer le domaine par une autorité de certification officielle.)
• L'en-tête Content-Type est défini sur application/xml.
• À une fréquence spécifiée, Google envoie à votre serveur un horodatage qui définit la dernière fois que vous avez répondu à un message Hint request.
• L'en-tête User-Agent est défini sur Google-HotelAdsPrices.

Nous vous recommandons de définir la fréquence sur cinq minutes. Pour définir ou modifier la fréquence des messages Hint request, contactez-nous.

Lorsque vous recevez un message Hint request de la part de Google, vous répondez en indiquant tous les prix qui ont été modifiés depuis cet horodatage. Pour en savoir plus, consultez la section Messages Hint request.

Étape 2: message de réponse d'indication

Votre serveur répond au message Hint request par un message Hint response. Ce message indique les identifiants et les itinéraires des hôtels dont les prix ont changé depuis la dernière fois que vous avez reçu un message Hint request et que vous y avez répondu.

L'élément racine d'un message de réponse d'indication est <Hint>. Pour en savoir plus, consultez la section Messages de réponse d'indication.

Étape 3: Message de requête

Nous recevons le message de réponse d'indication et y répond par un message de demande, comme avec le mode d'envoi Pull standard. La différence est que le message de requête ne contient désormais que les ID et les itinéraires correspondant aux établissements que vous avez spécifiés dans le message de réponse d'indication. L'élément racine d'un message de requête est <Query>.

Lorsque vous choisissez les ID d'hôtels pour lesquels demander les prix avec le mode Requête de prix modifiés, Google ignore le contenu de votre flux Hotel List Feed. Cela permet de réduire considérablement la taille du message de requête que vous recevez de Google et celle du message Transaction de votre réponse.

Étape 4: message Transaction

Vous envoyez un message Transaction contenant une mise à jour des prix en réponse aux messages de demande de Google. L'élément racine d'un message Transaction est <Transaction>. Pour en savoir plus, consultez la section Mode d'envoi pull.