Le mode d'envoi détermine la manière 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 sur la disponibilité des chambres et jusqu'à 30 nuits, 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 participez aux enchères. Toutefois, plus vous proposez de séjours, plus vous devez envoyer de données à Google pour garantir l'exactitude des données tarifaires.
Les méthodes de mise à jour des prix utilisent généralement les messages Transaction de l'une des manières suivantes:
ARI (Push): flux de diffusion des prix qui utilise des plans tarifaires, la disponibilité et des métadonnées d'hôtel pour 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 les prix ni les 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 de divers détails sur les tarifs, restrictions et disponibilités. Les flux ARI utilisent la spécification XML OTA (
OTA_HotelRateAmountNotifRQetOTA_HotelAvailNotifRQ) pour définir la disponibilité et les tarifs. 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 tarifaires et de disponibilité. Dans ce modèle, Google envoie une requête à votre serveur, qui répond en renvoyant 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 les informations tarifaires 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 devenus obsolètes, en fonction de l'historique des modifications de prix spécifiques à un partenaire. Pour en savoir plus, consultez la section Utiliser le mode d'envoi Pull.
Requête de prix modifiés (anciennement Pull avec "Conseil"): semblable au mode Pull, sauf que Google ne demande des données que pour un sous-ensemble d'établissements et non pour tous. Ce mode peut réduire considérablement le trafic réseau lorsque vous mettez à jour les prix et la disponibilité de vos établissements. Les prix restent indéfiniment dans le cache jusqu'à leur mise à jour. Pour en savoir plus, consultez Utiliser la requête de prix modifiés.
En plus de mettre à jour les prix, vous pouvez utiliser les 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 mises à jour des prix et obtenir des exemples de messages Transaction, consultez la page Mettre à jour les prix.
Requêtes de prix en temps réel
Google peut également demander des mises à jour de prix au moment des enchères avec les requêtes de prix en temps réel. Les requêtes de prix en temps réel sont des demandes de prix de Google pour une mise aux enchères en cours. Si vous répondez dans le délai imparti, votre annonce doit apparaître dans le système d'enchères.
Google stocke la réponse à une requête de prix en temps réel comme tout autre message Transaction. C'est pourquoi Google peut afficher le prix à partir de 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 spécifient généralement pas d'informations sur l'utilisateur, car Google utilise vos réponses pour remplir un cache qui peut être utilisé pour servir différents utilisateurs.
Étant donné que cela peut s'avérer coûteux pour vous de renvoyer des prix correspondant à un ensemble complet de contexte utilisateur possible, une fonctionnalité est en cours de test lorsque la requête inclut des contextes d'utilisateur populaires. Les contextes d'utilisation sont basés sur les requêtes des utilisateurs, qui vous ont permis d'afficher un prix. Ils sont calculés pour couvrir la grande majorité des requêtes. Un grand nombre de contextes utilisateur peut s'afficher 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 des contextes utilisateur spécifiques. C'est à vous de décider des prix à afficher pour une requête donnée. Toutefois, si vous ignorez un contexte utilisateur suggéré, vous risquez de réduire le trafic.
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é, le nombre d'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 divers composants des informations tarifaires.
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 à Google
Pour mettre à jour vos données avec le flux ARI (Push), envoyez un message de requête ARI à chaque modification des 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 devraient ê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 Google a bien mis en cache les données
Pour chaque message push ARI reçu, Google répond par l'état de la connexion HTTP et les résultats du traitement ARI. Google répond par 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 s'il a rencontré des erreurs ou des avertissements en 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 les messages ARI à Google, accédez à la page Paramètres des prix ARI. Découvrez comment mettre à jour vos paramètres de prix dans Hotel Center.
Mettre à jour les métadonnées des chambres et des formules avec le flux ARI (Push)
Utilisez le type de message Transaction (Données sur un établissement) pour définir les types de chambres et les plans tarifaires (packages) actifs pour chaque établissement.
Vous devez installer les mises à 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 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 à 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 requête à votre serveur pour demander des mises à jour des prix. Votre serveur répond à ces messages avec 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 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 recevrez plusieurs messages de requête au cours des processus de refacturation.
Les messages de requête de prix que Google envoie à votre serveur présentent les caractéristiques suivantes:
- L'élément racine est
<Query>. - Envoyé 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 demander à l'autorité de certification officielle de signer le domaine.) - L'en-tête
Content-Typeest défini surapplication/xml. - Chaque message inclut jusqu'à 100 établissements pour lesquels Google demande des données de tarification et de disponibilité.
- L'en-tête
User-Agentest défini surGoogle-HotelAdsPrices.
É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 Messages Transaction et Mettre à jour les prix.
Mettre à jour les métadonnées de Room et de formule
En plus de mettre à jour les données tarifaires avec le mode Pull, vous pouvez utiliser les messages Transaction pour mettre à jour les métadonnées de vos chambres et de vos séjours organisés. Pour en savoir plus, consultez Définir des métadonnées de chambres et de formules.
Mode d'envoi des prix modifié
La modification des prix 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 la requête de prix modifiés, vous envoyez à Google la liste des établissements dont les prix ont été mis à jour. Google répond 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 de demande d'indication, consultez votre responsable de compte technique (TAM). Cela s'est produit lors de la configuration initiale.
Le schéma suivant illustre le flux de requêtes et de réponses pour la requête de prix modifiés:
Les sections suivantes décrivent chacune des étapes de ce flux.
Étape 1: Message de demande d'indication
Les messages de demande d'indication que Google envoie à votre serveur présentent les caractéristiques suivantes:
- L'élément racine est
<HintRequest>. - Envoyé 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 demander à l'autorité de certification officielle de signer le domaine.) - L'en-tête
Content-Typeest défini surapplication/xml. - À une fréquence donnée, Google envoie à votre serveur un code temporel qui définit la dernière fois que vous avez répondu à un message de demande d'indication.
- L'en-tête
User-Agentest défini surGoogle-HotelAdsPrices.
Nous vous recommandons de définir la fréquence sur cinq minutes. Pour définir ou modifier la fréquence des messages de demande d'indication, contactez-nous.
Lorsque vous recevez un message de demande d'indication de la part de Google, vous répondez en indiquant tous les prix qui ont été modifiés depuis cette date. Pour en savoir plus, consultez la section Messages de demande d'indication.
Étape 2: Message de réponse d'indication
Votre serveur répond au message de demande d'indication par un message de réponse d'indication. Ce message indique les ID et les séjours des hôtels dont les prix ont changé depuis la dernière fois où vous avez reçu un message de demande d'indication 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 requête
Google reçoit le message de réponse d'indication et répond par un message de demande, comme pour le mode pull standard. La différence est que le message de requête ne contient plus que les ID et les séjours d'hôtels pour les é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 nous déterminons les ID d'hôtel pour lesquels les prix doivent être demandés avec la requête de prix modifiés, Google ignore le contenu de votre flux Hotel List Feed. Cela réduit considérablement la taille du message de requête que vous recevez de Google et la taille du message Transaction de votre réponse.
Étape 4: message Transaction
Vous envoyez un message Transaction avec la mise à jour des prix en réponse aux messages de requête de Google. L'élément racine d'un message Transaction est <Transaction>. Pour en savoir plus, consultez la section Mode d'envoi pull.