حالت‌های ارائه قیمت‌گذاری

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

نمای کلی حالت‌های ارسال

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

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

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

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

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

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

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

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

پُرسمان‌های قیمت‌گذاری زنده

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

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

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

نکته کلیدی: به‌دلیل تجربه «جستجوی» جدید، «پرس‌وجوی زنده» برای کاربران منطقه اقتصادی اروپا دردسترس محدود است.

زمینه

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

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

نکته کلیدی: کشور کاربر تنها بافت پشتیبانی‌شده در «قیمت‌گذاری کششی» یا «تغییر قیمت» است. جزئیات اشغال و زمینه‌های نوع دستگاه باید ازطریق «پُرسمان قیمت‌گذاری زنده با زمینه» ارسال شود. به نمونه‌های با پُرسمان‌های بافت مراجعه کنید.

نکته: اگر مایلید بافت‌های کاربر محبوب را در پُرسمان‌هایی که Google ارسال می‌کند دریافت کنید، با «مدیر فنی حساب» (TAM) خود تماس بگیرید. آن‌ها تأیید می‌کنند که شما برای دریافت چنین پیام‌هایی آماده هستید، سپس پیکربندی را اصلاح می‌کنند تا ارسال زمینه‌های کاربر در پُرسمان‌ها به شما را آغاز کنند.

حالت ارسال ARI Push

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

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

مرحله ۱: ارسال پیام‌های «فشار ARI» به Google

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

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

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

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

نشانی‌های IP فهرست مجازها

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

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

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

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

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

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

حالت تحویل کششی

با حالت تحویل «کشیدن»، Google به‌طور دوره‌ای پیام‌های پرسمان را به سرور شما ارسال می‌کند تا به‌روزرسانی‌های قیمت را درخواست کند. سرور شما با پیام‌های تراکنش که حاوی داده‌های به‌روزشده قیمت و دردسترس بودن است به این پیام‌ها پاسخ می‌دهد.

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

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

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

مرحله ۱: پیام پرسمان

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

پیام‌های «پرسمان» قیمت‌گذاری که Google به سرور شما ارسال می‌کند دارای ویژگی‌های زیر است:

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

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

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

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

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

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

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

حالت تحویل «قیمت‌گذاری تغییریافته»

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

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

نکته کلیدی: اگر پیام‌های «پاسخ خوانایاری» را پیاده‌سازی نکنید، پیام‌های «پرسمان» Google داده‌های مربوط به all ملک شناسایی‌شده در «فهرست هتل» شما را درخواست می‌کنند.

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

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

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

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

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

توصیه می‌کنیم بسامد را روی ۵ دقیقه تنظیم کنید. برای تنظیم یا اصلاح بسامد پیام‌های «درخواست خوانایاری»، با ما تماس بگیرید.

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

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

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

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

مرحله ۳: پیام پرسمان

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

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

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

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