Modes d'envoi des prix

Le mode d'envoi détermine la façon dont vous transmettez à Google vos mises à jour de prix pour les combinaisons hôtel/séjour.

Vous et votre responsable de compte technique (TAM) travaillez ensemble pendant la configuration initiale pour déterminer le mode d'envoi.

Présentation des modes d'envoi

Par défaut, nos partenaires peuvent recevoir des demandes de disponibilité de chambres jusqu'à 330 jours à l'avance pour des séjours allant jusqu'à 30 nuits. Cependant, vous pouvez choisir le nombre de séjours (combinaison date d'arrivée/durée du séjour) pour chaque hôtel.

Plus vous proposez de séjours, plus vous pourrez participer aux enchères. Toutefois, un grand nombre de séjours possibles implique une grande quantité de données à envoyer à Google pour que vos prix soient toujours à jour.

En général, les prix sont mis à jour via des messages Transaction selon l'une des méthodes suivantes :

  • ARI (Push) : flux d'envoi de prix qui utilise les plans tarifaires, la disponibilité et les métadonnées de l'hôtel afin d'établir 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 ne recherchent pas de séjours ni de prix spécifiques. À la place, les partenaires envoient des messages contenant un sous-ensemble d'informations qui représentent un modèle de tarification pour vos établissements en fonction des divers détails des tarifs, des restrictions et de la disponibilité. Les flux ARI s'appuient sur 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 adapté à votre compte. Pour en savoir plus, consultez la page Utiliser ARI.
  • Pull : Google vous demande régulièrement de transmettre vos prix et vos disponibilités afin d'actualiser le cache de données. Avec cette méthode, Google envoie une requête à votre serveur, qui répond en transmettant les données à jour. Ce modèle est le plus adapté aux partenaires qui ne savent pas exactement quand les informations tarifaires changent ou si ces informations sont modifiées 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 qu'ils sont devenus obsolètes (en fonction de l'historique des modifications de prix précédentes du 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, sauf que Google demande uniquement des données relatives à un sous-ensemble d'établissements, et non à la totalité. L'utilisation de ce mode peut considérablement réduire le volume de trafic réseau lors de la mise à jour des prix et des disponibilités de vos établissements. Les prix restent dans le cache jusqu'à ce qu'ils soient mis à jour. Pour en savoir plus, consultez la page Utiliser le mode Requête de prix modifiés.

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

Pour en savoir plus sur la transmission de prix mis à jour et accéder à des exemples de messages Transaction, consultez la page Mettre à jour des prix.

Requêtes de prix en temps réel

Google peut également vous demander de mettre à jour certains prix au moment d'une enchère au moyen de requêtes de prix en temps réel. Il s'agit de requêtes que Google vous envoie lorsque l'enchère est en cours. Si vous répondez dans les délais impartis, votre annonce apparaît dans l'enchère.

Google stocke les réponses aux requêtes de prix en temps réel comme tous les autres messages Transaction. Ainsi, au lieu de vous envoyer une autre requête de prix en temps réel, Google peut reprendre le prix qui figure dans le cache.

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

Utiliser ARI (Push)

Avec le mode d'envoi ARI (Push), vous envoyez des mises à jour à 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, le mode ARI (Push) vous permet d'utiliser un autre modèle de tarification pour mettre à jour efficacement différentes composantes des informations de tarification sur Google.

Le schéma suivant illustre le flux requête/réponse pour le mode d'envoi ARI (Push) :

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

Pour mettre à jour vos données avec le mode ARI (Push), envoyez un message de requête ARI à chaque modification de vos données. 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érifier que les données ont bien été mises en cache par Google

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

Ajouter des adresses IP à la liste d'autorisation

Afin d'ajouter à la liste d'autorisation les adresses IP que vous utilisez pour transmettre les messages ARI à Google, accédez à la page des paramètres de prix ARI 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 (formules) de chaque établissement. Vous devez transmettre une mise à jour chaque fois que vous ajoutez, supprimez ou modifiez des types de chambres ou des plans tarifaires. Dans ce cas, vous envoyez un message XML contenant 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, recherchez la solution recommandée sur la page 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, réessayez la requête après 1 minute, 5 minutes et 20 minutes. Si le problème persiste après trois tentatives, arrêtez d'envoyer vos messages et contactez l'assistance Google.

Utiliser le mode d'envoi Pull

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

Le schéma suivant illustre le flux requête/réponse pour le mode d'envoi Pull :

Après avoir reçu les mises à jour de 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 de manière détaillée.

Étape 1 : message Query

Par défaut, Google envoie des messages Query pour tous les établissements définis dans votre liste d'hôtels. De ce fait, vous pouvez recevoir plusieurs messages Query pendant les processus de mise à jour des prix.

Les messages Query sur les 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).
  • Ils utilisent la méthode HTTP POST. (Si vous utilisez HTTPS, le domaine doit être signé 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 a besoin de connaître les prix et les disponibilités.
  • L'en-tête User-Agent est défini sur "Google-HotelAdsPrices".

Étape 2 : message Transaction

Lorsque votre serveur reçoit un message Query, 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 pages Messages Transaction et Mettre à jour des prix.

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

En plus de mettre à jour les données tarifaires via le mode Pull, vous pouvez également utiliser des messages Transaction pour actualiser les métadonnées de vos chambres et de vos formules. Pour plus d'informations, consultez la section Définir des métadonnées de chambres et de formules.

Utiliser le mode Requête de prix modifiés

Le mode Requête de prix modifiés permet de réduire la taille et la quantité de messages Query et Transaction pour les mises à jour de prix. Lorsque vous l'utilisez, vous envoyez à Google la liste des établissements pour lesquels les prix ont changé. Google répond par un message Query qui demande uniquement les prix des établissements en question.

Pour configurer le point de terminaison auquel Google envoie ses messages Hint request, adressez-vous à votre responsable de compte technique (TAM). Vous aurez probablement réglé ce point lors de la configuration initiale.

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

Les sections suivantes décrivent toutes les é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 <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).
  • Utilisez la méthode HTTP POST. (Si vous utilisez HTTPS, le domaine doit être signé par une autorité de certification officielle.)
  • L'en-tête Content-Type est défini sur "application/xml".
  • Google envoie un horodatage à votre serveur selon une fréquence définie. Cet horodatage indique la date et l'heure de votre dernière réponse à un message Hint request.
  • L'en-tête User-Agent est défini sur "Google-HotelAdsPrices".

Nous vous recommandons de définir une fréquence de 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, votre serveur répond en envoyant tous les prix qui ont été modifiés depuis la date et l'heure indiquées. Pour plus d'informations, reportez-vous à la page Messages Hint request.

Étape 2 : message Hint reponse

Votre serveur répond à un message Hint request par un message Hint response. Ce message indique les ID d'hôtel et les séjours correspondant aux établissements 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 Hint response est <Hint>. Pour en savoir plus, consultez la page Messages Hint response.

Étape 3 : message Query

Google reçoit le message Hint response et y répond par un message Query, comme avec le mode d'envoi Pull standard. La différence réside dans le fait que le message Query contient uniquement les ID et les itinéraires correspondant aux établissements que vous avez spécifiés dans votre message Hint response. L'élément racine d'un message Query est <Query>.

Lors de la détermination des ID d'hôtel pour lesquels les prix sont demandés avec le mode Requête de prix modifiés, Google ignore le contenu de votre flux Hotel List Feed. Cette méthode permet de réduire considérablement la taille des messages Query que Google envoie et celle des messages Transaction de vos réponses.

Étape 4 : message Transaction

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