حالت های تحویل قیمت

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

مرور کلی روش‌های تحویل

به طور پیش‌فرض، می‌توان تا ۳۳۰ روز قبل از خالی بودن اتاق و تا ۳۰ شب اقامت، از هتل استعلام گرفت، اما می‌توانید حداکثر تعداد برنامه‌های سفر (ترکیبی از تاریخ ورود و مدت اقامت) را تعیین کنید.

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

روش‌های معمول به‌روزرسانی قیمت‌ها از پیام‌های تراکنش به یکی از روش‌های زیر استفاده می‌کنند:

  • ARI (Push) : یک فید تحویل قیمت که از برنامه‌های نرخ، در دسترس بودن و فراداده‌های هتل برای تنظیم استراتژی‌های قیمت‌گذاری از پیش تعریف‌شده برای املاک شما استفاده می‌کند. برخلاف Pull و Changed Pricing، فیدهای ARI برای قیمت‌ها یا برنامه‌های سفر خاص پرس‌وجو نمی‌کنند. در عوض، شما پیام‌هایی را ارسال می‌کنید که حاوی زیرمجموعه‌ای از اطلاعات هستند که نشان‌دهنده یک مدل قیمت‌گذاری برای املاک شما بر اساس جزئیات نرخ، محدودیت‌ها و در دسترس بودن مختلف هستند. فیدهای ARI از مشخصات OTA XML ( OTA_HotelRateAmountNotifRQ و OTA_HotelAvailNotifRQ ) برای تعریف در دسترس بودن و قیمت‌گذاری استفاده می‌کنند. برای کسب اطلاعات بیشتر در مورد حالت تحویل ARI و تعیین اینکه آیا این نوع فید برای حساب شما مناسب‌تر است یا خیر، با مدیر حساب خود تماس بگیرید. برای اطلاعات بیشتر، به بخش استفاده از ARI مراجعه کنید.

  • کشیدن (Pull) : گوگل به طور منظم از سرویس شما درخواست می‌کند تا حافظه پنهان (cache) داده‌های قیمت‌گذاری و در دسترس بودن را به‌روزرسانی کند. در این مدل، گوگل درخواستی را به سرور شما ارسال می‌کند و سرور شما با داده‌های به‌روز شده پاسخ می‌دهد. این مدل در صورتی بهترین گزینه است که دقیقاً نمی‌دانید اطلاعات قیمت‌گذاری چه زمانی تغییر می‌کند، یا اگر اطلاعات قیمت‌گذاری در طول روز به طور نامنظم تغییر می‌کند. قیمت‌ها در حافظه پنهان باقی می‌مانند تا زمانی که الگوریتم‌های گوگل، بر اساس سابقه تغییر قیمت قبلی خاص شریک، تشخیص دهند که قیمت‌ها قدیمی شده‌اند. برای اطلاعات بیشتر، به استفاده از حالت تحویل کشیدن (Pull Delivery Mode) مراجعه کنید.

  • قیمت‌گذاری تغییر یافته (قبلاً Pull with Hints نام داشت): مشابه Pull است، با این تفاوت که گوگل فقط داده‌های مربوط به زیرمجموعه‌ای از املاک را درخواست می‌کند، نه همه املاک. این حالت می‌تواند میزان ترافیک شبکه را هنگام به‌روزرسانی قیمت‌ها و در دسترس بودن املاک شما به میزان قابل توجهی کاهش دهد. قیمت‌ها تا زمان به‌روزرسانی به طور نامحدود در حافظه پنهان باقی می‌مانند. برای اطلاعات بیشتر، به بخش «استفاده از قیمت‌گذاری تغییر یافته» مراجعه کنید.

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

برای اطلاعات بیشتر در مورد ارائه به‌روزرسانی‌های قیمت‌گذاری، از جمله نمونه‌هایی از پیام‌های تراکنش، به به‌روزرسانی قیمت‌ها مراجعه کنید.

استعلام قیمت زنده

گوگل همچنین می‌تواند با استفاده از «پرسش‌های قیمت‌گذاری زنده» (Live Priceing Queries) در زمان حراج، درخواست به‌روزرسانی قیمت کند. «پرسش‌های قیمت‌گذاری زنده» درخواست‌های قیمت‌گذاری از سوی گوگل برای یک حراج فعلی هستند. اگر در بازه زمانی مشخص‌شده پاسخ دهید، تبلیغ شما باید در حراج نمایش داده شود.

گوگل پاسخ به یک درخواست قیمت‌گذاری زنده را درست مانند هر پیام تراکنش دیگری ذخیره می‌کند. در نتیجه، گوگل می‌تواند به جای ارسال یک درخواست قیمت‌گذاری زنده دیگر در آینده، قیمت را از حافظه پنهان خود ارائه دهد.

برای اطلاعات بیشتر، به «پرسش‌های قیمت‌گذاری زنده» مراجعه کنید.

زمینه

کوئری‌های Pull و Changed Pricing معمولاً اطلاعاتی در مورد کاربر مشخص نمی‌کنند، زیرا گوگل از پاسخ‌های شما برای پر کردن حافظه پنهانی (cache) استفاده می‌کند که ممکن است برای خدمت‌رسانی به طیف وسیعی از کاربران مختلف استفاده شود.

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

حالت تحویل ARI Push

با حالت تحویل ARI Push، هر زمان که نرخ‌های شبانه، موجودی، تعداد موجودی یا سایر محدودیت‌ها تغییر کند، به‌روزرسانی‌های تدریجی را به گوگل ارسال می‌کنید. برخلاف Pull یا Changed Pricing، ARI Push به شما امکان می‌دهد از یک مدل قیمت‌گذاری متفاوت برای به‌روزرسانی مؤثر اجزای مختلف اطلاعات قیمت‌گذاری به گوگل استفاده کنید.

نمودار زیر جریان درخواست و پاسخ را برای حالت تحویل ARI Push نشان می‌دهد:

شکل ۱

مرحله ۱: ارسال پیام‌های ARI Push به گوگل

برای به‌روزرسانی داده‌های خود با ARI Push، هر زمان که داده‌های شما تغییر کرد، یک پیام درخواست ARI ارسال کنید. حالت تحویل ARI Push از انواع مختلف پیام و استراتژی‌های قیمت‌گذاری پشتیبانی می‌کند. برای اطلاعات دقیق در مورد پیام‌های push، به استفاده از ARI مراجعه کنید.

قیمت‌های شما باید توسط گوگل ارائه شود و ظرف ۱۵ تا ۲۰ دقیقه پس از دریافت پیام، برای کاربران قابل مشاهده باشد.

مرحله ۲: تأیید کنید که داده‌ها با موفقیت توسط گوگل ذخیره شده‌اند

برای هر پیام ARI Push که دریافت می‌شود، گوگل با وضعیت اتصال HTTP و نتایج پردازش ARI پاسخ می‌دهد. در صورت موفقیت‌آمیز بودن اتصال به سرور، گوگل با HTTP 200 OK پاسخ می‌دهد. همچنین شامل یک بدنه با پیام پاسخ است که نشان می‌دهد آیا به‌روزرسانی‌ها با موفقیت اعمال شده‌اند یا با هشدارها یا خطاهای حالت تحویل مواجه شده‌اند.

آدرس‌های IP مجاز

برای اینکه بتوانید آدرس‌های IP که برای ارسال پیام‌های ARI به گوگل استفاده می‌کنید را در لیست قرار دهید، از صفحه تنظیمات قیمت ARI هتل سنتر استفاده کنید. با نحوه به‌روزرسانی تنظیمات قیمت خود در هتل سنتر آشنا شوید.

به‌روزرسانی متادیتای اتاق و بسته با ARI Push

از نوع پیام تراکنش (داده‌های ویژگی) برای تعریف انواع اتاق‌های فعال و طرح‌های نرخ (بسته‌ها) برای هر ویژگی استفاده کنید. شما باید هر زمان که انواع اتاق یا طرح‌های نرخ اضافه، حذف یا اصلاح می‌شوند، به‌روزرسانی‌ها را ارسال کنید. در این حالت، شما یک پیام XML با اطلاعات جدید در عناصر <RoomData> و <PackageData> ارسال می‌کنید. این عناصر فرزندان عنصر <PropertyDataSet> هستند.

خطاهای اتصال یا محتوا

اگر به دلیل ناقص یا نادرست بودن XML، خطای حالت تحویل دریافت کردید، راه‌حل پیشنهادی را در پیام‌های خطای وضعیت فید پیدا کنید.

اگر هنگام ارسال پیام ARI به گوگل، خطای اتصال HTTP دریافت کردید، درخواست را در فواصل ۱، ۵ و ۲۰ دقیقه دوباره امتحان کنید. اگر مشکل پس از ۳ بار تلاش مجدد همچنان ادامه داشت، ارسال پیام را متوقف کرده و با پشتیبانی گوگل تماس بگیرید.

حالت تحویل را بکشید

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

نمودار زیر جریان درخواست/پاسخ Pull را نشان می‌دهد:

شکل ۲

پس از دریافت به‌روزرسانی‌های قیمت، گوگل معمولاً داده‌های قیمت‌گذاری و موجودی جدید را تقریباً ظرف ۵ دقیقه پردازش می‌کند.

بخش‌های بعدی هر یک از این مراحل را با جزئیات بیشتری شرح می‌دهند.

مرحله ۱: پیام پرس‌وجو

به‌طور پیش‌فرض، گوگل برای تمام هتل‌های تعریف‌شده در فهرست هتل‌های شما پیام‌های استعلام ارسال می‌کند. این می‌تواند به این معنی باشد که شما باید در طول فرآیندهای تغییر قیمت، چندین پیام استعلام دریافت کنید.

پیام‌های استعلام قیمت که گوگل به سرور شما ارسال می‌کند، ویژگی‌های زیر را دارند:

  • عنصر ریشه <Query> است.
  • به نقطه پایانی تعریف شده در پیکربندی اولیه شما ارسال شد. برای اطلاعات بیشتر، با مدیر حساب فنی (TAM) خود تماس بگیرید.
  • از روش HTTP POST استفاده می‌کند. (اگر از HTTPS استفاده می‌کنید، باید دامنه را توسط یک مرجع صدور گواهینامه رسمی امضا کنید.)
  • هدر Content-Type روی application/xml تنظیم شده است.
  • هر پیام شامل حداکثر ۱۰۰ ملک است که گوگل درخواست اطلاعات قیمت و موجودی آنها را دارد.
  • هدر User-Agent روی Google-HotelAdsPrices تنظیم شده است.

مرحله ۲: پیام تراکنش

وقتی سرور شما یک پیام Query دریافت می‌کند، باید با یک پیام تراکنش که حاوی اطلاعات قیمت‌گذاری برای برنامه‌های سفر درخواستی است، پاسخ دهد.

عنصر ریشه یک پیام تراکنش <Transaction> است. برای اطلاعات بیشتر، به پیام‌های تراکنش و به‌روزرسانی قیمت‌ها مراجعه کنید.

به‌روزرسانی متادیتای اتاق و بسته

علاوه بر به‌روزرسانی داده‌های قیمت‌گذاری با Pull، می‌توانید از پیام‌های تراکنش برای به‌روزرسانی فراداده‌های اتاق و بسته خود نیز استفاده کنید. برای اطلاعات بیشتر، به تعریف فراداده‌های اتاق و بسته مراجعه کنید.

تغییر در نحوه‌ی تحویل قیمت‌گذاری

«قیمت‌گذاری تغییر یافته» به کاهش اندازه و تعداد پیام‌های «درخواست و تراکنش» برای به‌روزرسانی‌های قیمت کمک می‌کند. وقتی از «قیمت‌گذاری تغییر یافته» استفاده می‌کنید، فهرستی از املاکی که قیمت‌هایشان به‌روز شده است را برای گوگل ارسال می‌کنید. گوگل با یک پیام درخواست پاسخ می‌دهد که فقط قیمت آن املاک را می‌پرسد.

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

نمودار زیر جریان درخواست و پاسخ برای تغییر قیمت‌گذاری را نشان می‌دهد:

شکل ۳

بخش‌های زیر هر یک از مراحل این جریان را شرح می‌دهند.

مرحله ۱: پیام درخواست راهنمایی

پیام‌های درخواست راهنمایی که گوگل به سرور شما ارسال می‌کند، ویژگی‌های زیر را دارند:

  • عنصر ریشه <HintRequest> است.
  • به نقطه پایانی تعریف شده در پیکربندی اولیه شما ارسال شد. برای اطلاعات بیشتر، با مدیر حساب فنی (TAM) خود تماس بگیرید.
  • از روش HTTP POST استفاده کنید. (اگر از HTTPS استفاده می‌کنید، باید دامنه را توسط یک مرجع صدور گواهینامه رسمی امضا کنید.)
  • هدر Content-Type روی application/xml تنظیم شده است.
  • در یک بازه زمانی مشخص، گوگل یک مهر زمانی به سرور شما ارسال می‌کند که آخرین باری که به یک پیام درخواست راهنمایی پاسخ داده‌اید را مشخص می‌کند.
  • هدر User-Agent روی Google-HotelAdsPrices تنظیم شده است.

توصیه می‌کنیم که تعداد دفعات ارسال پیام را روی ۵ دقیقه تنظیم کنید. برای تنظیم یا تغییر تعداد دفعات ارسال پیام‌های درخواست راهنمایی، با ما تماس بگیرید .

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

مرحله ۲: پیام پاسخ راهنمایی

سرور شما به پیام درخواست راهنمایی با یک پیام پاسخ راهنمایی پاسخ می‌دهد. این پیام شامل شناسه هتل و برنامه‌های سفر برای املاکی است که قیمت آنها از آخرین باری که پیام درخواست راهنمایی دریافت و به آن پاسخ داده‌اید، تغییر کرده است.

عنصر ریشه یک پیام پاسخ به نکته، <Hint> است. برای اطلاعات بیشتر، به پیام‌های پاسخ به نکته مراجعه کنید.

مرحله ۳: پیام پرس‌وجو

گوگل پیام پاسخ راهنما را دریافت می‌کند و با یک پیام پرس‌وجو پاسخ می‌دهد، درست مانند حالت استاندارد Pull. تفاوت این است که پیام پرس‌وجو اکنون فقط شامل شناسه‌های هتل و برنامه‌های سفر برای هتل‌هایی است که شما در پیام پاسخ راهنما مشخص کرده‌اید. عنصر ریشه یک پیام پرس‌وجو <Query> است.

هنگام تعیین اینکه برای کدام شناسه‌های هتل باید با استفاده از «قیمت‌گذاری تغییر یافته» درخواست قیمت کنید، گوگل محتویات فید فهرست هتل شما را نادیده می‌گیرد. این کار اندازه پیام «پرس‌وجو» که از گوگل دریافت می‌کنید و اندازه پیام «تراکنش» پاسخ شما را تا حد زیادی کاهش می‌دهد.

مرحله ۴: پیام تراکنش

شما یک پیام تراکنش به همراه به‌روزرسانی قیمت را به عنوان پاسخی به پیام‌های جستجوی گوگل ارسال می‌کنید. عنصر ریشه یک پیام تراکنش <Transaction> است. برای اطلاعات بیشتر، به حالت تحویل Pull مراجعه کنید.