Modes d'envoi des prix

Le mode d'envoi détermine la façon dont vous envoyez à Google 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 de diffusion 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 envoyez 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 sur les prix et les disponibilités. Dans ce modèle, Google envoie une requête à votre serveur, qui répond avec des 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 qu'ils sont obsolètes d'après l'historique des modifications 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, à la différence que Google ne demande des données que pour un sous-ensemble d'établissements, et non pour l'ensemble des établissements. 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 sont conservés indéfiniment dans le cache jusqu'à ce qu'ils soient modifiés. 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 l'envoi de nouveaux prix et voir des exemples de messages Transaction, consultez la section Mettre à jour les prix.

Requêtes de prix en temps réel

Google peut également demander la mise à jour de certaines 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 requêtes de prix envoyées par Google pour une enchère en cours. Si vous répondez dans le délai imparti, votre annonce devrait apparaître dans l'enchère.

Google stocke les réponses aux requêtes de prix en temps réel comme tout autre message Transaction. Par conséquent, Google peut afficher le prix figurant dans son cache au lieu d'envoyer une autre requête de prix en temps réel.

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

Contexte

Les requêtes Pull et Requête de prix modifiés ne fournissent 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 la requête. Les contextes utilisateur sont basés sur les requêtes des utilisateurs pour lesquelles vous avez eu l'occasion d'afficher un prix. Ils sont calculés pour couvrir la grande majorité des requêtes. Vous verrez peut-être 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 quels prix renvoyer pour une requête donnée. Toutefois, ignorer un contexte utilisateur suggéré peut entraîner une diminution 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). Ils confirmeront que vous êtes prêt à recevoir ces messages, puis ajusteront la configuration pour commencer à vous envoyer des contextes utilisateur dans les 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 différents composants des informations tarifaires vers Google.

Le schéma suivant illustre le flux de requêtes et de réponses 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 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 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 envoie une réponse 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 les adresses IP que vous utilisez pour envoyer des messages ARI à Google, accédez à la page des paramètres de tarification ARI de Hotel Center. Découvrez comment modifier vos paramètres de prix dans Hotel Center.

Mettre à jour les métadonnées de chambres et de formules à l'aide du flux ARI

Utilisez le type de message Transaction (Données sur un établissement) pour définir les types de chambres et les plans tarifaires (forfaits) actifs 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 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 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, 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 de demande de mise à jour des prix à votre serveur. Votre serveur répond à ces messages par des messages de transaction contenant des données mises à jour sur les prix et les disponibilités.

Le schéma suivant illustre le flux requête/réponse 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 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 demande

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 devriez 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 s'afficher pour 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.

Mettre à jour les 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 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 des 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 Query qui demande uniquement les prix des établissements en question.

Pour configurer le point de terminaison auquel Google envoie des messages Hint request, consultez votre responsable de compte technique (TAM). Vous l'aurez 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 votre 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 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 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 fournissant tous les prix qui ont été modifiés depuis ce code temporel. 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 indique les ID et les séjours des établissements dont les prix ont changé depuis la dernière fois que vous avez reçu un message Hint Request et 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

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 réside dans le fait que le message de requête ne contient désormais que les identifiants et les séjours 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>.

Lors de la détermination des 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 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 Query de Google. L'élément racine d'un message Transaction est <Transaction>. Pour en savoir plus, consultez la section Mode d'envoi Pull.