Modes d'envoi des prix

Le mode d'envoi détermine la façon dont vous envoyez à Google les mises à jour des prix pour les combinaisons d'hôtels et de séjours. Vous et votre responsable de compte technique (TAM) travaillez ensemble lors de la configuration initiale pour définir votre mode d'envoi.

Présentation des modes d'envoi

Par défaut, un hôtel peut être interrogé jusqu'à 330 jours à l'avance pour la disponibilité des chambres et jusqu'à 30 nuits de séjour. Toutefois, 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 participez à des 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.

Les méthodes habituelles de mise à jour des prix utilisent les 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 des séjours ou des prix spécifiques. À la place, vous envoyez des messages contenant un sous-ensemble d'informations qui représentent un modèle de tarification pour vos établissements en fonction de divers détails sur les 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 déterminer si ce type de flux convient le mieux à votre compte. Pour en savoir plus, consultez la page Utiliser ARI.

• Pull: nous interrogeons régulièrement votre service pour actualiser son cache contenant les données sur 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 à quel moment les informations tarifaires changent ou si ces informations 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 qu'ils sont devenus obsolètes, en se basant sur l'historique des changements de prix précédents 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 les données d'un sous-ensemble d'établissements, et non de tous les é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 restent indéfiniment dans le cache jusqu'à leur mise à jour. Pour en savoir plus, consultez la page Utiliser le prix modifié.

En plus de mettre à jour les 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 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 des enchères à l'aide de requêtes de prix en temps réel. Les requêtes de prix en temps réel sont des requêtes de prix envoyées par Google pour une mise aux enchères en cours. Si vous répondez dans les délais impartis, votre annonce devrait apparaître dans l'enchère.

Nous stockons la réponse aux requêtes de prix en temps réel comme n'importe quel autre message Transaction. Par conséquent, Google peut afficher le prix figurant dans son cache plutôt que d'envoyer une autre requête de prix en temps réel par la suite.

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

Important :En raison de la nouvelle interface de recherche, les requêtes en temps réel ne sont plus disponibles pour les utilisateurs de l'EEE.

Contexte

Les requêtes de type "Pull" et "Requête de prix modifiés" ne fournissent généralement pas d'informations sur l'utilisateur, car Google se sert de 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 pour vous 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 de manière à couvrir la grande majorité de ces requêtes. Vous verrez peut-être un grand nombre de contextes utilisateur pour les établissements ou les itinéraires très populaires, mais le nombre moyen de contextes utilisateur devrait être inférieur à 10. Vous pouvez renvoyer des prix supplémentaires ou ignorer des contextes utilisateur spécifiques. C'est à vous de décider du prix à renvoyer pour une requête donnée. Toutefois, le fait d'ignorer un contexte utilisateur suggéré peut entraîner une baisse du trafic.

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 la configuration pour commencer à vous envoyer des contextes utilisateur dans les requêtes.

Mode d'envoi ARI (Push)

Avec le mode d'envoi ARI (Push), vous envoyez des mises à jour incrémentielles à Google chaque fois que les tarifs par nuit, la disponibilité, les stocks 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 divers composants des informations tarifaires sur 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 divers 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 être visibles par les utilisateurs dans les 15 à 20 minutes suivant la réception du message.

Étape 2: Vérifiez 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 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 inclut également un corps avec un message de réponse indiquant si les mises à jour ont bien été appliquées, ou qu'il a rencontré des avertissements ou des erreurs liés au mode d'envoi.

Ajouter des adresses IP à la liste d'autorisation

Pour ajouter à la liste d'autorisation les adresses IP que vous utilisez pour transmettre des messages ARI à Google, accédez à la page des paramètres de prix ARI dans 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 avec le 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 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, 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 toutes les une, cinq et 20 minutes. Si le problème persiste après trois tentatives, arrêtez 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 Query à votre serveur pour demander les mises à jour des prix. Votre serveur répond à ces messages par des messages Transaction contenant des données actualisées sur les prix et les disponibilités.

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 de prix, Google traite généralement les nouvelles données de prix 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 demande

Par défaut, Google envoie des messages de demande pour tous les établissements définis dans votre liste d'hôtels. Cela peut signifier que vous devriez recevoir plusieurs messages Query pendant les processus de refacturation.

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).
• Elle 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 de tarification et de disponibilité.
• L'en-tête User-Agent est défini sur Google-HotelAdsPrices.

Important :De nombreux messages de demande peuvent vous être envoyés pour mettre à jour les prix de tous les hôtels. La taille des messages Transaction générés peut donc être très importante. Pour réduire la taille et le nombre de messages, nous vous recommandons d'utiliser la fonctionnalité Requête de prix modifiés.

Étape 2: message Transaction

Lorsque votre serveur reçoit un message de requête, il doit renvoyer 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 les prix.

Mettre à jour les métadonnées de chambres et de formules

En plus de mettre à jour les données tarifaires à l'aide du mode d'envoi Pull, vous pouvez également utiliser des messages Transaction pour mettre à jour les métadonnées de vos chambres et de vos formules. Pour en savoir plus, consultez la section Définir des métadonnées de chambres et de formules.

Mode d'envoi des prix modifié

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 cette fonctionnalité, vous envoyez à Google la liste des établissements dont les prix ont été mis à jour. Google répond par un message Query qui demande uniquement les prix de ces établissements.

Pour configurer le point de terminaison auquel Google envoie les messages Hint request, consultez votre responsable de compte technique (TAM). Vous devez définir ce paramètre lors de la configuration initiale.

Important :Si vous n'utilisez pas de messages de réponse d'indication, les messages de demande de Google demandent les données des all établissements 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.
• Google envoie à votre serveur, selon une fréquence spécifiée, un code temporel définissant 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 la fréquence sur 5 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 fournissant 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 à un message Hint request par un message Hint response. Ce message inclut les identifiants et les séjours 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 demande

Google reçoit 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 réside dans le fait que le message de demande ne contient désormais que les identifiants et les séjours des hôtels 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 nous déterminons les ID d'hôtels pour lesquels demander des 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 des messages Query que vous recevez de Google et celle des messages Transaction de votre réponse.

Étape 4: message Transaction

Vous envoyez un message Transaction contenant la 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.