امتیاز دادن به پیام

نمای کلی

پیام نرخ ( OTA_HotelRateAmountNotifRQ ) نرخ اشغال شبانه را برای هر نوع اتاق و ترکیب طرح نرخ برای محدوده های تاریخی خاص تعریف می کند. به عنوان بخشی از پیام نرخ، Google از قیمت‌گذاری مبتنی بر اشغال پشتیبانی می‌کند و امکان تعیین نرخ‌های متفاوت شبانه بر اساس حداکثر تعداد سرنشینان مورد نظر را فراهم می‌کند.

بخش‌های زیر دستورالعمل‌های کلی، یک مثال اساسی و سناریوهای چگونگی شروع کار با افزودن و به‌روزرسانی نرخ‌ها و ارسال پیام رتبه‌بندی را پوشش می‌دهند.

رفتار نرخ تطبیق

از آنجایی که کاربران اشغال‌های خاصی را درخواست می‌کنند، نرخی که می‌بینند به نحوه تعریف قیمت‌ها در پیام Rate بستگی دارد. این بخش نحوه تطبیق این درخواست‌های کاربر با نرخ‌های شما بسته به اشغال درخواست آنها و نرخ‌هایی که شما تعریف می‌کنید را پوشش می‌دهد.

اصول کلیدی

• نرخی که برای یک سکونت خاص تعریف شده است، برای همه اشغال های کمتر اعمال می شود، مگر اینکه طور دیگری تعریف شده باشد.

• درخواست برای اشغال بالاتر از موارد تعریف شده امکان پذیر نیست.

• قیمت‌گذاری مبتنی بر اشغال برای هر دو مدل قیمت‌گذاری بر اساس تاریخ و مدل‌های قیمت‌گذاری مبتنی بر LOS که در زیر توضیح داده شده است اعمال می‌شود. این بدان معنی است که شما می توانید نرخ برای هر اشغال را مشخص کنید. اگر نرخی برای یک اشغال خاص وجود نداشته باشد، نرخ بالاترین اشغال بعدی استفاده می شود. همچنین می‌توانید با استفاده از AdditionalGuestAmounts یا ExtraGuestCharges برای مهمانان و کودکان اضافی که تا ظرفیت تعیین‌شده برای یک اتاق اعمال می‌شود، هزینه‌هایی را تعیین کنید.

  نکته کلیدی: برای هر ملک محدودیت 100 هزینه مهمان اضافی وجود دارد. می توانید از پیام ExtraGuestCharge برای حذف هزینه های اضافی مهمان استفاده کنید.

مزایا و مثال ها

کارایی

برای چندین اشغال با مقدار نرخ یکسان، نیازی به تعیین نرخ برای هر اشغال ندارید. شما می توانید پیام های خود را با تنظیم تنها بالاترین مقدار اشغال که توسط نوع اتاق و طرح نرخ پشتیبانی می شود، ساده کنید. کاربران آن نرخ را برای هر اشغال کمتر یا مساوی مقدار تعیین شده شما خواهند دید.

مثال: نرخ‌های نوع اتاق و طرح نرخ برای افراد یک تا چهار یکسان است. از پیام Rate برای تعیین یک نرخ برای حداکثر اشغال 4 استفاده کنید. کاربرانی که برای اشغال یک، دو و سه نفره جستجو می کنند، همان نرخ را خواهند دید. کاربرانی که 5 و بالاتر را جستجو می کنند، نرخ ها را نمی بینند.

کنترل کنید

نرخ های متمایز برای اشغال های جایگزین را می توان به صراحت ارائه کرد. اگر می‌خواهید کنترل بیشتری بر نحوه مطابقت درخواست‌ها با نرخ اشغال توسط Google داشته باشید، نرخ متفاوتی برای هر مقدار اشغال ارسال کنید.

مثال: اگر نرخ‌ها برای اشغال‌های 3 و 1 تعریف شده باشد، جستجوهای تک‌نفره نرخ تک‌نفره را نشان می‌دهد، جستجوی دو نفره نرخ اشغال سه‌گانه را نشان می‌دهد و کاربرانی که 4 و بالاتر را جستجو می‌کنند، نرخ‌ها را نمی‌بینند.

نکته کلیدی: برای یک اتاق مشخص و طرح نرخ می‌تواند حداکثر 50 نرخ اشغال در هر ملک وجود داشته باشد.

برای مثال‌های بیشتر از سناریوهای مختلف مرتبط با نرخ، به دستورالعمل‌ها مراجعه کنید.

عناصر مورد نیاز و اختیاری

مرجع XML توضیحاتی در مورد عناصر مورد نیاز و اختیاری ارائه می دهد. برای جزئیات بیشتر در مورد ویژگی‌ها و عناصر فرزند، به Rate Elements & Attributes مراجعه کنید.

نحو و طرحواره

هنگام ایجاد پیام Rate از مثال Rate Syntax به عنوان مرجع استفاده کنید تا مطمئن شوید که از فرمت صحیح پیروی می کنید.

می‌توانید از یک ابزار XML شخص ثالث مانند xmllint برای تأیید اعتبار فیدهای خود با طرح‌واره‌های منتشر شده قبل از ارسال آنها به Google استفاده کنید. برای طرح پیام رتبه‌بندی، به طرح‌های تبلیغات هتل مراجعه کنید.

مدل های قیمت گذاری

قیمت گذاری بر اساس تاریخ

این مدل قیمت گذاری استانداردی است که برای اکثر املاک استفاده می شود. مدل قیمت‌گذاری per-date مبتنی بر تعیین نرخ‌هایی است که در تاریخ‌های اقامت خلاصه می‌شوند تا به قیمت کل برسند. در این مدل، همه نرخ‌ها تحت یک عنصر Rate به‌عنوان اعمال محدوده‌ای از تاریخ‌های اقامت مشخص شده در <StatusApplicationControl> تفسیر می‌شوند.

قیمت گذاری مبتنی بر LOS

مدل قیمت‌گذاری مبتنی بر LOS (طول مدت اقامت) بر اساس نرخ‌های تعیین‌شده برای ترکیب تاریخ ورود و مدت اقامت است. نرخ‌های مشخص‌شده در مدل قیمت‌گذاری مبتنی بر LOS در روز هستند. به عنوان مثال، اگر نرخ 100 دلار را برای مدت اقامت 3 ارسال کنید، قیمت کل 3x100 دلار = 300 دلار محاسبه می شود.

می توانید با تعیین RatePlanType="26" در عناصر StatusApplicationControl از مدل قیمت گذاری مبتنی بر LOS استفاده کنید. همچنین باید ویژگی های RateTimeUnit و UnitMultiplier را روی عناصر Rate در XML خود تنظیم کنید. این باعث می‌شود که همه نرخ‌ها در عنصر Rate داده‌شده برای اقامت‌های تعریف‌شده توسط تاریخ‌های ورود مشخص‌شده در <StatusApplicationControl> و مقدار LOS مشخص‌شده برای UnitMultiplier اعمال شوند.

شما می توانید از هر دو مدل قیمت گذاری بر اساس تاریخ و LOS در یک حساب واحد استفاده کنید، با این حال، هر دارایی فقط باید از یک مدل قیمت گذاری واحد استفاده کند. هنگام اجرای قیمت گذاری مبتنی بر LOS نکات زیر را در نظر داشته باشید:

• هنگام استفاده از قیمت‌گذاری مبتنی بر LOS، نرخ‌ها برای مدت‌های مختلف اقامت ترکیب نمی‌شوند. به عنوان مثال، نرخ LOS 3 با LOS 1 ترکیب نمی شود تا نرخ LOS 4 را قیمت گذاری کند. نرخ LOS 4 باید به صراحت مشخص شود.
• نرخ 1 شب در قیمت گذاری مبتنی بر LOS به عنوان یک نرخ شب جداگانه در قیمت گذاری هر تاریخ استفاده نمی شود.
• بسته به نحوه نمایش نرخ ها در سیستم شما، هر دارایی فقط باید از قیمت گذاری مبتنی بر LOS یا قیمت گذاری در هر تاریخ استفاده کند.

برای فعال کردن قیمت گذاری مبتنی بر LOS در حساب خود، درخواست را از طریق TAM خود ارسال کنید یا با ما تماس بگیرید .

رهنمودها یا اقدامات

قیمت گذاری بر اساس تاریخ

Delta : نرخ‌های هر نفر را فقط برای ترکیب‌های مشخص شده از نوع اتاق، برنامه نرخ و تاریخ‌های اقامت مشخص‌شده در <StatusApplicationControl> اضافه یا به‌روزرسانی کنید.

• به‌روزرسانی‌های Rate به‌طور پیش‌فرض از عملکرد Delta استفاده می‌کنند.
• به‌روزرسانی Delta نرخ‌های ذخیره‌شده قبلی را برای سایر افراد تغییر نمی‌دهد. به عنوان مثال، اگر برای اتاق‌های یک‌نفره و دو نفره، نرخ‌هایی را مشخص کرده باشید و برای اتاق‌های تک‌نفره نرخ Delta را ارسال کنید، نرخ اقامت دو نفره بدون تغییر باقی می‌ماند.

Overlay : همه نرخ‌های موجود برای هر نفر را برای نوع اتاق، طرح نرخ و تاریخ‌های مشخص‌شده در <StatusApplicationControl> حذف کنید و آنها را با نرخ‌های جدید جایگزین کنید. برای مثال، اگر نرخ‌هایی را برای اتاق‌های یک‌نفره و دو نفره مشخص کرده‌اید، و به‌روزرسانی Overlay برای اتاق‌های تک نفره ارسال کنید، Google همه نرخ‌های قبلی (اعم از تک‌نفره و دو نفره) را حذف می‌کند و فقط نرخ اشغال یک‌نفره پس از به‌روزرسانی باقی می‌ماند. .

Remove : همه نرخ‌های موجود برای هر نفر را برای نوع اتاق، طرح نرخ و تاریخ‌های مشخص‌شده در <StatusApplicationControl> حذف کنید.

نکته کلیدی: برای مدل‌های قیمت‌گذاری براساس Per-date و LOS-based محدودیت 5000 محصول برای نوع اتاق و ترکیب بسته‌ها در هر ملک وجود دارد. می توانید از انواع اعلان های Overlay و Remove برای حذف محصولات تعریف شده قبلی استفاده کنید.

قیمت گذاری مبتنی بر LOS

Delta : نرخ‌ها را به ازای هر مقدار LOS فقط برای ترکیب‌های مشخص شده از نوع اتاق، طرح نرخ و تاریخ‌های ورود مشخص شده در <StatusApplicationControl> اضافه یا به‌روزرسانی کنید. همه نرخ‌های اشغال مرتبط با مقادیر به‌روزشده LOS را جایگزین می‌کند.

• به‌روزرسانی‌های Rate به‌طور پیش‌فرض از عملکرد Delta استفاده می‌کنند.
• به‌روزرسانی Delta نرخ‌های ذخیره‌شده قبلی را برای سایر مدت اقامت تغییر نمی‌دهد. به عنوان مثال، اگر نرخ‌هایی را برای LOS 1 و 2 مشخص کرده‌اید، و یک به‌روزرسانی نرخ Delta برای LOS 1 ارسال کرده‌اید، در این صورت نرخ‌های هر اشغال LOS 2 بدون تغییر باقی می‌ماند.
• یک به‌روزرسانی Delta ، تمام نرخ‌های ذخیره‌شده قبلی در هر اشغال را برای مدت اقامت معین بازنویسی می‌کند. به عنوان مثال، اگر نرخ اشغال یک و دو را برای LOS 1 مشخص کرده باشید و یک به روز رسانی نرخ Delta را برای LOS 1 تنها با یک نرخ اشغال واحد ارسال کنید، نرخ اشغال دو برابر حذف می شود.

Overlay : همه نرخ‌های موجود برای هر نفر را برای LOS، نوع اتاق، طرح نرخ و تاریخ‌های ورود مشخص شده در <StatusApplicationControl> حذف کنید و آنها را با نرخ‌های جدید جایگزین کنید. به عنوان مثال، اگر نرخ‌هایی را برای LOS 1 و 2 مشخص کرده باشید و یک به‌روزرسانی Overlay برای LOS 1 ارسال کنید، Google همه نرخ‌های قبلی (هر دو LOS 1 و 2) را حذف می‌کند و فقط نرخ LOS 1 پس از به‌روزرسانی باقی می‌ماند.

Remove : همه نرخ‌های موجود برای هر نفر را برای همه LOS نوع اتاق، طرح نرخ و تاریخ‌های ورود مشخص شده در <StatusApplicationControl> حذف کنید.

مربوط به مالیات

اگر مالیات ها و کارمزدها ساده باشند، کل مبلغ را می توان با استفاده از AmountAfterTax مشخص کرد. مالیات‌های پیچیده، مانند مالیات‌ها و هزینه‌هایی که برای هر اقامت (به‌جای هر شب) اعمال می‌شوند، نمی‌توانند در AmountAfterTax ارائه شوند.

به طور کلی، گوگل استفاده از TaxFeeInfo به جای AmountAfterTax توصیه می کند.

در صورت امکان، باید AmountBeforeTax اضافه کنید (حتی اگر AmountAfterTax را مشخص کنید) زیرا مناطق خاصی (مثلاً ایالات متحده) به طور پیش فرض قیمت قبل از مالیات را نشان می دهند.

همه مالیات‌ها و هزینه‌هایی که کاربر باید بپردازد (مالیات بر ارزش افزوده، مالیات اقامت، هزینه نظافت، مالیات شهری و غیره) باید شامل شود، حتی اگر در زمان رزرو پرداخت نشده باشد یا مستقیماً به ملک پرداخت نشده باشد.

مثال

این بخش یک مثال اساسی از پیام Rate با استفاده از عناصر مورد نیاز و اختیاری را ارائه می دهد. پس از تهیه فایل خود، باید آن را با استفاده از یک پیام POST به نقطه پایانی زیر به Google ارسال کنید: https://www.google.com/travel/hotels/uploads/property_data

برای کسب اطلاعات بیشتر در مورد نحوه فشار دادن/پست کردن پیام، به ارسال پیام‌ها مراجعه کنید.

توجه: هر زمان که قیمت‌های شبانه‌تان تغییر کرد، پیامی به Google ارسال کنید.

برای HotelCode ، از شناسه هتل منحصربه‌فردی که در سیستم خود برای شناسایی ملک استفاده کرده‌اید، استفاده کنید. این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید لیست هتل مطابقت داشته باشد. برای <PackageID> و <RoomID> ، از همان شناسه هایی که در سیستم خود استفاده می کنید برای برنامه های نرخ و انواع اتاق (به ترتیب) استفاده کنید. سازگاری با سیستم شما برای اطمینان از اینکه Google قیمت ها و داده های شما را به درستی نمایش می دهد بسیار مهم است.

این مثال نحوه تنظیم نرخ ها را با استفاده از یک اقدام 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>

چگونه

این بخش راه حل هایی را برای سناریوهایی که ممکن است هنگام ارسال پیام های رتبه بندی با آنها روبرو شوید ارائه می دهد.

برای مثال‌هایی از نحوه افزودن، حذف و به‌روزرسانی نرخ‌ها، به مثال‌های رتبه‌بندی مراجعه کنید.

سناریو 1: نحوه تغییر قیمت برای هر نفر

توضیحات

قبلاً نرخ شبانه فقط برای دو نفره تعریف شده بود (که برای یک نفره هم صدق می کند)، اما اکنون نرخ ارزان تری برای یک نفره وجود دارد.

راه حل

با استفاده از به‌روزرسانی پیش‌فرض با محدوده Delta ، نرخ اشغال 1 جدید را ارسال کنید. این مقدار جدید بر میزان اشغال 2 تأثیری ندارد.

سناریو 2: نحوه جایگزینی نرخ هر سکونت برای یک ملک

توضیحات

شما قبلاً نرخ‌هایی را برای اشغال‌های 1 تا 4 تعریف کرده‌اید، اما اکنون فقط اشغال‌های 1 و 2 معتبر هستند.

راه حل

از NotifType="Overlay" برای جایگزینی همه نرخ‌های اشغال برای یک ملک، نوع اتاق، طرح نرخ و تاریخ(های) معین استفاده کنید. در این سناریو، عمل Overlay نرخ‌های اشغال 1 و 2 را فهرست می‌کند.

سناریو 3: نحوه تعیین نرخ یکسان برای چندین اشغال

توضیحات

نرخ برای یک اشغال خاص می تواند به گروهی با افراد کمتر فروخته شود. در این سناریو، می‌توانید پیام‌های خود را فقط با ارسال به‌روزرسانی نرخ برای حداکثر اشغال قابل اجرا ساده کنید.

راه حل

اگر برای چند اشغال قیمت یکسان دارید، بالاترین مقدار اشغال را تنظیم کنید که توسط نوع اتاق و طرح نرخ پشتیبانی می‌شود و به طور خودکار از این مقدار برای اشغال‌های کمتر استفاده می‌کند. یعنی نیازی به تکرار همان نرخ شبانه برای اشغال‌های 1-6 نیست، اگر همه آنها یکسان هستند. فقط آن را برای 6 تنظیم کنید.

توجه: اگر NumberOfGuests تنظیم نشده باشد، مقدار اشغال پیش‌فرض 2 است.