Évaluer le message

Présentation

Le message sur le tarif (OTA_HotelRateAmountNotifRQ) définit les tarifs par nuit d'occupation de chaque type de chambre et de chaque plan tarifaire pour des plages de dates spécifiques. Dans le message "Tarif", Google accepte la tarification en fonction du nombre de personnes, ce qui permet de spécifier différents tarifs par nuit en fonction du nombre maximal de personnes prévues.

Les sections suivantes présentent des consignes générales, un exemple de base et des scénarios pratiques pour vous aider à ajouter et à mettre à jour des tarifs, et à envoyer un message sur les tarifs.

Comportement du taux de correspondance

Lorsque les utilisateurs demandent un nombre de personnes spécifique, le tarif qu'ils voient dépend de la manière dont vous définissez les prix dans votre message "Rate" (Tarif). Cette section explique comment les requêtes des utilisateurs sont mises en correspondance avec vos tarifs en fonction du nombre de personnes et des tarifs que vous définissez.

Principes clés

  • Un tarif défini pour un nombre de personnes spécifique s'applique à tous les utilisateurs dont le nombre de personnes est inférieur, sauf indication contraire.

  • Les demandes concernant un nombre de personnes supérieur à celui défini sont considérées comme impossibles.

  • Les tarifs basés sur le nombre de personnes s'appliquent à la fois aux modèles de tarification à la date et à la durée du séjour décrits ci-dessous. Cela signifie que vous pouvez spécifier des tarifs pour chaque nombre de personnes. Si aucun tarif pour un nombre de personnes spécifique n'existe, c'est le tarif du nombre de personnes suivant le plus élevé qui est utilisé. Vous pouvez également définir des frais pour les invités et les enfants supplémentaires en utilisant AdditionalGuestAmounts ou ExtraGuestCharges, qui s'appliquent à la capacité définie pour une chambre.

Avantages et exemples

Efficience

Si plusieurs personnes présentent le même tarif, vous n'avez pas besoin de définir un tarif pour chacune d'elles. Vous pouvez simplifier vos messages en ne définissant que le nombre le plus élevé possible pour le type de chambre et le plan tarifaire. Les utilisateurs verront ce tarif pour chaque nombre de personnes inférieur ou égal à la valeur que vous avez définie.

Exemple:Les tarifs pour un type de chambre et un plan tarifaire sont les mêmes pour un nombre de personnes compris entre un et quatre. Utilisez le message "Tarif" pour définir un tarif pour un maximum de 4 personnes. Ce tarif sera le même pour les utilisateurs qui recherchent une chambre simple, double ou triple. Les utilisateurs qui recherchent 5 ou plus ne verront pas les tarifs.

Contrôle

Vous pouvez indiquer explicitement des tarifs différents pour d'autres nombres de personnes. Envoyez un tarif différent pour chaque nombre de personnes si vous souhaitez mieux contrôler la manière dont Google met en correspondance les requêtes avec les taux d'occupation.

Exemple:Si des tarifs sont définis pour 3 personnes et 1 personnes, les recherches pour une personne seule afficheront le tarif pour célibataires, une recherche pour deux personnes affichera le tarif pour trois personnes, et les utilisateurs qui recherchent 4 personnes et plus ne verront pas les tarifs.

Pour plus d'exemples de scénarios liés aux tarifs, consultez les guides d'utilisation.

Éléments obligatoires et facultatifs

La référence XML fournit les descriptions des éléments obligatoires et facultatifs. Pour en savoir plus sur les attributs et les éléments enfants, consultez Éléments et attributs des tarifs.

Syntaxe et schémas

Utilisez l'exemple Syntaxe des tarifs comme référence lorsque vous créez le message sur les tarifs afin de vous assurer que vous suivez le format correct.

Vous pouvez utiliser un outil XML tiers tel que xmllint pour valider vos flux avec les schémas publiés avant de les envoyer à Google. Pour le schéma du message de tarif, consultez la section Schémas Hotel Ads.

Modèles de tarification

Tarification par date

Il s'agit du modèle tarifaire standard utilisé pour la plupart des établissements. Le modèle de tarification per-date repose sur la définition des tarifs, qui sont additionnés pour toutes les dates de séjour afin d'obtenir le prix total. Dans ce modèle, tous les tarifs d'un élément Rate sont interprétés comme s'appliquant à une plage de dates de séjour spécifiée dans <StatusApplicationControl>.

Tarifs basés sur la DDS

Le modèle de tarification basé sur la durée du séjour est basé sur les tarifs définis pour une combinaison date d'arrivée/durée du séjour. Les tarifs indiqués dans le modèle de tarification basé sur la DDS sont par jour. Par exemple, si vous envoyez un tarif de 100 $pour un séjour de 3, le prix total est calculé comme suit : 3 x 100$=300 $.

Vous pouvez utiliser le modèle de tarification basé sur la DDS en spécifiant RatePlanType="26" sur les éléments StatusApplicationControl. Vous devez également définir les attributs RateTimeUnit et UnitMultiplier au niveau des éléments Rate de votre code XML. Tous les tarifs de l'élément Rate donné s'appliquent aux séjours définis par les dates d'arrivée spécifiées dans <StatusApplicationControl> et par la valeur de durée de séjour spécifiée pour UnitMultiplier.

Vous pouvez utiliser les modèles de tarification à la date et basés sur la durée du séjour dans un même compte. Cependant, chaque établissement ne doit utiliser qu'un seul modèle de tarification. Tenez compte des points suivants lorsque vous implémentez la tarification basée sur la DDS:

  • Les tarifs pour des durées de séjour différentes ne sont pas combinés lorsque vous utilisez la tarification basée sur la durée du séjour. Par exemple, un tarif de DDS de 3 n'est pas combiné avec une DDS de 1 afin de fixer le prix d'un taux de DDS de 4. Le taux de DDS de 4 doit être explicitement spécifié.
  • Le tarif 1 nuit avec la tarification basée sur la durée du séjour n'est pas utilisé comme tarif par nuit individuel dans la tarification à la date.
  • Chaque établissement ne doit utiliser que la tarification basée sur la DDS ou la tarification à la date, en fonction de la représentation des tarifs dans votre système.

Pour activer la tarification basée sur la durée du séjour dans votre compte, adressez votre demande à votre TAM ou contactez-nous.

Consignes ou actions

Tarification par date

Delta: permet d'ajouter ou de mettre à jour les tarifs par nombre de personnes uniquement pour les combinaisons spécifiées de type de chambre, de plan tarifaire et de dates de séjour spécifiées dans <StatusApplicationControl>.

  • Par défaut, les mises à jour des taux utilisent l'action Delta.
  • Une mise à jour de Delta ne modifie pas les tarifs précédemment stockés pour les autres nombres de personnes. Par exemple, si vous avez spécifié des tarifs pour des chambres simples et pour deux, et que vous envoyez une mise à jour Delta du tarif pour une chambre individuelle, le tarif pour deux personnes reste inchangé.

Overlay: supprimez tous les tarifs par nombre de personnes existants pour le type de chambre, le plan tarifaire et les dates spécifiés dans <StatusApplicationControl>, puis remplacez-les par les nouveaux tarifs. Par exemple, si vous avez spécifié des tarifs pour des chambres simples et doubles et que vous envoyez une mise à jour Overlay pour une chambre pour 1 personne, Google supprimera tous les tarifs précédents (chambres simples et doubles), et seul le tarif pour une personne simple sera conservé après la mise à jour.

Remove: supprime tous les tarifs par nombre de personnes existants pour le type de chambre, le plan tarifaire et les dates spécifiés dans <StatusApplicationControl>.

Tarifs basés sur la DDS

Delta: permet d'ajouter ou de mettre à jour les tarifs par valeur de durée de séjour uniquement pour les combinaisons spécifiées de type de chambre, de plan tarifaire et de dates d'arrivée spécifiées dans <StatusApplicationControl>. Remplace tous les tarifs par nombre de personnes associés aux valeurs de durée de séjour mises à jour.

  • Par défaut, les mises à jour des taux utilisent l'action Delta.
  • Une mise à jour de Delta n'affecte pas les tarifs précédemment stockés pour d'autres durées de séjour. Par exemple, si vous avez spécifié des tarifs pour les DDS 1 et 2, et que vous envoyez une mise à jour Delta des tarifs pour les DDS 1, les tarifs par nombre de personnes de LOS 2 restent inchangés.
  • Une mise à jour Delta écrase tous les tarifs par nombre de personnes précédemment stockés pour la durée de séjour donnée. Par exemple, si vous avez spécifié des tarifs pour une chambre simple et pour deux personnes pour la première personne de séjour et que vous envoyez une mise à jour du tarif Delta pour une chambre de niveau 1 avec un seul tarif, le tarif pour deux personnes est supprimé.

Overlay: supprimez tous les tarifs par nombre de personnes existants pour la durée de séjour, le type de chambre, le plan tarifaire et les dates d'arrivée spécifiés dans <StatusApplicationControl>, puis remplacez-les par les nouveaux tarifs. Par exemple, si vous avez spécifié des tarifs pour les DDS 1 et 2, et que vous envoyez une mise à jour Overlay pour les DDS 1, Google supprimera tous les tarifs précédents (LOS 1 et 2). Seul le tarif DDS 1 sera conservé après la mise à jour.

Remove: supprimez tous les tarifs par nombre de personnes existants pour toutes les durées de séjour du type de chambre, du plan tarifaire et des dates d'arrivée spécifiés dans <StatusApplicationControl>.

Informations fiscales

Si les taxes et les frais sont simples, le montant total peut être spécifié à l'aide de AmountAfterTax. Les taxes complexes, telles que les taxes et les frais qui s'appliquent par séjour (et non par nuit), ne peuvent pas être représentées dans AmountAfterTax.

En général, Google recommande d'utiliser TaxFeeInfo plutôt que AmountAfterTax.

Si possible, vous devez inclure AmountBeforeTax (même si vous spécifiez AmountAfterTax), car certains paramètres régionaux (par exemple, les États-Unis) affichent le prix hors taxes par défaut.

Toutes les taxes et tous les frais qu'un utilisateur doit payer (TVA, taxe de séjour, frais de ménage, taxe de ville, etc.) doivent être inclus, même s'ils ne sont pas réglés au moment de la réservation ou ne sont pas versés directement à l'établissement.

Exemple

Cette section fournit un exemple de base de message de tarif utilisant les éléments obligatoires et facultatifs. Après avoir préparé votre fichier, vous devez l'envoyer à Google à l'aide d'un message POST au point de terminaison suivant : https://www.google.com/travel/hotels/uploads/property_data

Pour en savoir plus sur l'envoi/la publication du message, consultez la section Transférer des messages.

Pour HotelCode, indiquez l'ID d'hôtel unique que vous avez utilisé dans votre système pour identifier l'établissement. Cette valeur doit correspondre à l'identifiant de l'hôtel spécifié à l'aide de la valeur <id> dans l'élément <listing> du flux Hotel List Feed. Pour <PackageID> et <RoomID>, utilisez les mêmes identifiants que ceux que vous utilisez dans votre système pour les plans tarifaires et les types de chambres (respectivement). La cohérence avec votre système est essentielle pour nous assurer que Google affiche correctement vos prix et vos données.

Cet exemple montre comment définir des tarifs à l'aide d'une action Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Guides pratiques

Cette section fournit des solutions aux scénarios que vous pouvez rencontrer lors de l'envoi de messages sur les tarifs.

Pour obtenir des exemples d'ajout, de suppression et de mise à jour des taux, consultez la section Exemples de tarifs.

Scénario 1: Modifier le prix par nombre de personnes

Description

Auparavant, les tarifs par nuit étaient définis uniquement pour une chambre double (ce qui s'applique également à une personne pour une seule personne), mais ils sont désormais moins chers pour une personne seule.

Solution

Envoyez le nouveau tarif "Occupation 1" à l'aide de la mise à jour de champ d'application Delta par défaut. Cette nouvelle valeur n'a pas d'incidence sur le tarif "Nombre d'occupation 2".

Scénario 2: Remplacer les tarifs par nombre de personnes pour un établissement

Description

Vous avez précédemment défini des tarifs de 1 à 4, mais seules les valeurs 1 et 2 sont désormais valides.

Solution

Utilisez NotifType="Overlay" pour remplacer tous les taux d'occupation pour un établissement, un type de chambre, un plan tarifaire et des dates donnés. Dans ce scénario, l'action Overlay affiche les tarifs pour le nombre de personnes 1 et 2.

Scénario 3: Définir le même tarif pour plusieurs nombres de personnes

Description

Un tarif pour un certain nombre de personnes peut être vendu à un groupe comportant moins de personnes. Dans ce scénario, vous pouvez simplifier vos messages en n'envoyant que la mise à jour du tarif pour le nombre maximal de personnes applicable.

Solution

Si vous proposez le même prix pour plusieurs personnes, définissez la valeur la plus élevée compatible avec le type de chambre et le plan tarifaire. L'application utilisera alors automatiquement cette valeur si le nombre de personnes est plus faible. Autrement dit, il n'est pas nécessaire de répéter le même tarif par nuit pour les valeurs de 1 à 6 si elles sont toutes identiques. Il vous suffit de le définir sur 6.