Évaluer le message

Présentation

Le message Rate (OTA_HotelRateAmountNotifRQ) définit le tarif taux d'occupation pour chaque combinaison de type de chambre et de plan tarifaire à une date spécifique plages. Dans le message de tarif, Google prend en charge les tarifs en fonction du nombre de personnes, permettant de spécifier différents tarifs par nuit en fonction du nombre maximal des occupants prévus.

Les sections suivantes fournissent des consignes générales, un exemple de base et des instructions pour vous lancer dans l'ajout et la mise à jour des tarifs, et l'envoi d'une Évaluez le message.

Comportement du taux de correspondance

Lorsque les utilisateurs demandent un nombre de personnes spécifique, le tarif affiché dépend de comment vous définissez les prix dans votre message de tarifs. Cette section explique comment des utilisateurs sont mis en correspondance avec vos tarifs en fonction du nombre de personnes requête et les tarifs que vous définissez.

Principes clés

  • Un tarif défini pour un nombre de personnes spécifique s'applique à tous les nombres de personnes moins nombreux. sauf indication contraire.

  • Les demandes de nombre de personnes supérieur à celles définies sont considérées comme impossibles.

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

Avantages et exemples

Efficacité

Pour plusieurs nombres de personnes avec le même tarif, vous n'avez pas besoin de définir un pour chaque nombre de personnes. Vous pouvez simplifier vos messages en définissant uniquement la valeur du nombre de personnes la plus élevée compatible avec le type de chambre et le plan tarifaire. Les utilisateurs verront ce tarif pour chaque nombre de personnes inférieur ou égal au nombre défini .

Exemple:Les tarifs d'un type de chambre et d'un plan tarifaire sont identiques pour nombre de personnes un à quatre. Utilisez le message "Tarif" afin de définir un tarif pour le tarif maximal. 4 personnes. Utilisateurs recherchant des personnes simples, doubles ou triples connaîtra le même taux. Aucun tarif ne s'affichera pour les utilisateurs qui recherchent les enfants de cinq ans ou plus.

Contrôle

Vous pouvez indiquer explicitement des prix différents selon le nombre de personnes. Envoyer un tarif différent pour chaque nombre de personnes si vous souhaitez mieux contrôler Google met en correspondance les demandes et les tarifs en fonction du nombre de personnes.

Exemple:Si les tarifs sont définis pour trois personnes et une personne, un nombre de personnes individuel affiche le tarif pour les célibataires, la recherche d'une chambre pour deux personnes affiche le taux d'occupation trois. Si vous recherchez "4 personnes et plus", taux de conversion.

Pour obtenir plus d'exemples de scénarios liés aux tarifs, consultez la section Guides d'utilisation

Éléments obligatoires et facultatifs

La documentation de référence XML fournit une description des éléments obligatoires et facultatifs. Pour en savoir plus sur et les éléments enfants, consultez la section Éléments de tarif et Attributs :

Syntaxe et schémas

Utilisez la syntaxe des taux. comme référence lorsque vous créez le message Rate, afin de vous assurer vous suivez le bon format.

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 message Tarif consultez la page Schémas Hotel Ads.

Modèles de tarification

Tarification à la date

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

Tarifs basés sur la DDS

Le modèle de tarification en fonction de la durée du séjour est basé sur des prix définis pour un date d'arrivée et durée du séjour. Les tarifs indiqués dans les Le modèle de tarification basé sur la DDS est facturé à la journée. Par exemple, si vous envoyez un tarif de 100 € Pour une durée de 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 durée du séjour en spécifiant RatePlanType="26" sur les éléments StatusApplicationControl. Vous devez également définissez les attributs RateTimeUnit et UnitMultiplier sur les éléments Rate de votre XML. De cette façon, tous les tarifs indiqués dans l'élément Rate donné s'appliquent aux séjours. défini par les dates d'arrivée spécifiées dans <StatusApplicationControl> et Valeur de durée de séjour spécifiée pour UnitMultiplier.

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

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

Pour activer la tarification basée sur la DDS dans votre compte, vous devez en faire la demande auprès de votre TAM. ou contactez-nous.

Consignes ou actions

Tarification à la date

Delta: ajoutez ou mettez à jour les tarifs par nombre de personnes uniquement pour les valeurs combinaisons de type de chambre, de plan tarifaire et de dates de séjour spécifiées dans <StatusApplicationControl>

  • Les mises à jour de taux utilisent l'action Delta par défaut.
  • Une mise à jour de Delta n'a aucune incidence sur les tarifs précédemment enregistrés pour d'autres le nombre de personnes. Par exemple, si vous avez indiqué des tarifs pour des séjours simples et chambres doubles, puis envoyer une mise à jour du tarif Delta pour l'unique le tarif d'une chambre double ne change pas.

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

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

Tarifs basés sur la DDS

Delta: ajoutez ou mettez à jour les taux par valeur de durée du séjour uniquement pour les valeurs spécifiées combinaisons 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 avec les nouvelles valeurs de durée de séjour.

  • Les mises à jour de taux utilisent l'action Delta par défaut.
  • Une mise à jour de Delta n'a aucune incidence sur les tarifs précédemment enregistrés pour d'autres la durée du séjour. Par exemple, si vous avez indiqué des tarifs pour les séjours 1 et 2, et envoyez une mise à jour des tarifs de Delta pour un séjour de 1, puis pour les tarifs par nombre de personnes de 2 pour les séjours de 2 restent inchangées.
  • Une mise à jour de 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 valeurs simples et tarif d'une chambre double pour un séjour de 1, et envoi d'une mise à jour du tarif Delta pour les séjours 1 avec un tarif d'une seule personne, celui d'une chambre double est supprimé.

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

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

Taxes

Si les taxes et les frais sont simples, le montant total peut être indiqué en utilisant AmountAfterTax Les taxes complexes, telles que les taxes et les frais applicables par (et non par nuit) ne peut pas être représenté 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, "US") affichent le paramètre par défaut, hors taxes.

Ensemble des taxes et frais qu'un utilisateur doit payer (TVA, taxe de séjour, frais de ménage, ville taxes, etc.) doivent être incluses, même si elles n'ont pas été payées au moment de la réservation payé directement à l'établissement.

Exemple

Cette section fournit un exemple de base de message Rate avec les champs obligatoires et éléments facultatifs. Une fois votre fichier préparé, vous devez l'envoyer à Google via un message POST au point de terminaison suivant: https://www.google.com/travel/hotels/uploads/property_data

Pour en savoir plus sur la méthode push/POST du message, consultez la section Transférer des messages.

Pour HotelCode, saisissez l'identifiant d'hôtel unique que vous avez indiqué dans votre système pour identifiant l'établissement. Cette valeur doit correspondre à l'identifiant de l'hôtel spécifié via <id> dans l'élément <listing> dans le flux Hotel List Feed. Pour <PackageID> et <RoomID>, utilisez les mêmes ID que utiliser dans votre système pour les plans tarifaires et les types de chambres (respectivement). Cohérence avec votre système est essentiel pour garantir 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 Évaluez les messages.

Pour obtenir des exemples sur la façon d'ajouter, de supprimer et de mettre à jour des taux, consultez la section Taux Exemples.

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

Description

Auparavant, les tarifs par nuit étaient définis uniquement pour une chambre double s'applique à une personne seule), mais le tarif est plus bas le nombre de personnes.

Solution

Envoyez le nouveau tarif pour un nombre de personnes 1 à l'aide de la mise à jour par défaut de portée Delta. Cette nouvelle n'a pas d'incidence sur le tarif pour deux personnes.

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

Description

Vous aviez défini des prix pour les nombres de 1 à 4 personnes, mais vous ne le faites plus les nombres de personnes 1 et 2 sont valides.

Solution

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

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

Description

Vous pouvez vendre un tarif pour un nombre de personnes donné à un groupe comportant moins de personnes. Dans ce 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 nombres de personnes, définissez le nombre le plus élevé. acceptée par le type de chambre et le plan tarifaire, de sorte qu'elle utilise cette valeur pour le nombre de personnes moins élevé. Autrement dit, il n'est pas nécessaire de répéter la même un tarif par nuit pour un nombre de personnes de 1 à 6, à condition qu'ils soient identiques ; je le définis sur 6.