با دسترسی به کاربران در جایی که هستند، تعامل با برنامه را تقویت کنید. Engage SDK را ادغام کنید تا توصیههای شخصیسازیشده و محتوای ادامهدار را مستقیماً به کاربران در چندین سطح دروندستگاهی، مانند مجموعهها، Entertainment Space، و «فروشگاه Play» ارائه دهید. این ادغام کمتر از ۵۰ کیلوبایت (فشردهشده) به میانگین APK اضافه میکند و برای اکثر برنامهها حدود یک هفته از زمان توسعهدهنده را میگیرد. در سایت کسبوکار ما بیشتر بدانید.
این راهنما حاوی دستورالعملهایی برای شرکای توسعهدهنده است تا محتوای سفر و رویدادها را به سطوح محتوای Engage ارائه دهند.
پشتیبانی دستهبندی و سطوح
واجدشرایط بودن سطح Engage SDK براساس دسته محتوای برنامه شما است. از جدول زیر برای تعیین واجدشرایط بودن برای سطوح خاص استفاده کنید:
| وضعیت | دستهبندی محتوا یا مورد استفاده | سطوح پشتیبانیشده |
|---|---|---|
|
پشتیبانیشده (واجدشرایط در همه سطوح) |
|
|
| پشتیبانی نمیشود |
|
مهارتهای Android
مشاهده در GitHubادغام Engage SDK
android skills add engage-sdk-integrationجزئیات یکپارچهسازی
این بخش مراحل، مدلهای داده، و اصطلاحات لازم برای ادغام با Engage SDK برای محتوای سفر و رویدادها را شرح میدهد.
اصطلاحات
این ادغام شامل انواع خوشههای زیر است: توصیه، ویژه، رزرو، و ادامه جستجو.
خوشههای توصیه پیشنهادهای شخصیسازیشده سفر و رویداد را از یک شریک توسعهدهنده نشان میدهد. این توصیهها میتواند برای کاربر شخصیسازی شود یا بهصورت عمومی (برای مثال، موارد پرطرفدار) باشد. از اینها برای نمایش دادن مقالهها، رویدادها، اقامتگاهها، یا توصیههای مکانهای جالب استفاده کنید.
- خوشه «توصیه» میتواند از فهرستگان
ArticleEntity،EventEntity،LodgingEntity،PointOfInterestEntity، یاStoreEntityساخته شود، اما نمیتواند ترکیبی از انواع مختلف نهاد باشد.
توصیههای شما ساختار زیر را دارند:
خوشه توصیهها: نمای میانای کاربری که حاوی گروهی از توصیهها از همان شریک توسعهدهنده است.
نهاد: شیئی که نشاندهنده یک مورد در خوشه است. این ادغام برخیاز نهادهایی را ارائه میدهد که بااستفاده از «خوشه توصیهها» ظاهر میشوند:
ArticleEntity: ArticleEntity نشاندهنده توصیهای برای محتوای نوشتاری مرتبط با سفر و رویداد است. میتوان از آن برای مقالات، پستهای وبلاگ، محتوای بازاریابی، گزیدههای خبری، و غیره استفاده کرد.
شکل ۱: میانای کاربر که یک ArticleEntity را در خوشه «توصیهها» نشان میدهد. EventEntity: EventEntity نشاندهنده رویدادی است که در آینده اتفاق میافتد. زمان شروع رویداد اطلاعات مهمی است که باید به کاربران منتقل شود.
شکل ۲: میانای کاربر که یک EventEntity را در خوشه «توصیهها» نشان میدهد. LodgingEntity: LodgingEntity نشاندهنده اقامتگاه است، مثل هتل، آپارتمان، خانه اجارهای برای اجاره کوتاهمدت و بلندمدت.
شکل ۳: میانای کاربر که یک LodgingEntity را در خوشه «توصیهها» نشان میدهد. StoreEntity: StoreEntity نشاندهنده فروشگاه، رستوران، کافه، و غیره است. این نوع محتوایی را برجسته میکند که در آن غذاخوری یا فروشگاه بخش مهمی از اطلاعاتی است که باید به کاربران منتقل شود.
شکل ۴: میانای کاربر که یک StoreEntity را در خوشه «توصیهها» نشان میدهد. PointOfInterestEntity: PointOfInterestEntity نشاندهنده مکانهای جالب مثل پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه گردشگری، مسیر پیادهروی، و غیره است. این موجودیت محتوایی را برجسته میکند که در آن مکان اطلاعات مهمی است که باید به کاربران منتقل شود. نباید برای اقامت، فروشگاه، یا محل غذاخوری استفاده شود.
شکل ۵: میانای کاربر که یک PointOfInterestEntity را در خوشه «توصیهها» نشان میدهد.
- خوشه «توصیه» میتواند از فهرستگان
خوشه رزرو محتوایی را نشان میدهد که اخیراً کاربران از چندین شریک توسعهدهنده در یک گروه میانای کاربر با آن تعامل داشتهاند. هر شریک توسعهدهنده میتواند حداکثر ۱۰ نهاد را در خوشه «رزرو» همهفرستی کند.
محتوای رزرو شما میتواند ساختار زیر را داشته باشد:
RestaurantReservationEntity: RestaurantReservationEntity نشاندهنده رزرو رستوران یا کافه است و به کاربران کمک میکند رزروهای آتی یا فعلی رستوران را پیگیری کنند.
شکل ۶. میانای کاربر که یک RestaurantReservationEntity را در خوشه «رزرو» نشان میدهد. EventReservationEntity: EventReservationEntity نشاندهنده رزرو رویداد است و به کاربران کمک میکند رزروهای رویدادهای آتی یا جاری را پیگیری کنند. رویدادها میتواند شامل موارد زیر باشد، اما به آنها محدود نمیشود:
- رویدادهای ورزشی مانند رزرو برای مسابقه فوتبال
- رویدادهای بازی مثل رزرو برای ورزشهای الکترونیک
- رویدادهای سرگرمی مانند رزرو فیلم در سینما، کنسرت، تئاتر، امضای کتاب
- رزروهای سفر یا مکانهای جالب مثل گشت با راهنما، بلیت موزه
- رزروهای اجتماعی / سمینار / کنفرانس
- رزرو جلسات آموزشی / تعلیمی
شکل ۷. میانای کاربر که یک EventReservationEntity را در خوشه «رزرو» نشان میدهد. LodgingReservationEntity: LodgingEntityReservation نشاندهنده رزرو اقامتگاه سفر است و به کاربران کمک میکند رزروهای آتی یا فعلی هتل یا اقامتگاه اجارهای را پیگیری کنند.
شکل ۸. رابط کاربری که یک LodgingReservationEntity را در خوشه «رزرو» نشان میدهد. TransportationReservationEntity: TransportationReservationEntity نشاندهنده رزرو حملونقل با هر حالتی است و به کاربران کمک میکند رزروهای پرواز، کشتی، قطار، اتوبوس، درخواست سواری، یا سفر دریایی آتی یا درحال انجام را پیگیری کنند.
شکل ۹. رابط کاربری که یک TransportationReservationEntity را در خوشه «رزرو» نشان میدهد. VehicleRentalReservationEntity: VehicleRentalReservationEntity نشاندهنده رزرو کرایه خودرو است و به کاربران کمک میکند رزروهای کرایه خودرو آتی یا جاری را پیگیری کنند.
شکل ۱۰. میانای کاربر که یک VehicleRentalReservationEntity را در خوشه «رزرو» نشان میدهد.
خوشه ویژه مجموعهای از نهادهای چندین شریک توسعهدهنده را در یک گروه میانای کاربر نمایش میدهد. یک خوشه «ویژه» وجود خواهد داشت که در نزدیکی بالای میانای کاربر با جایگذاری اولویتدار بالاتر از همه خوشههای «توصیه» ظاهر میشود. هر شریک توسعهدهنده میتواند حداکثر ۱۰ نهاد را در خوشه «ویژه» همهفرستی کند.
GenericFeaturedEntity: GenericFeaturedEntity با مورد «توصیه» تفاوت دارد زیرا مورد «ویژه» باید برای یک محتوای برتر از توسعهدهندگان استفاده شود و باید نشاندهنده مهمترین محتوایی باشد که برای کاربران جالب و مرتبط است.
شکل ۱۱: میانای کاربر که FeaturedCluster را با فهرستی از GenericFeaturedEntity نشان میدهد
خوشه ادامه جستجو به کاربران کمک میکند تا با نمایش فهرستی از پرسمانهای جستجویی که کاربر اخیراً در همه برنامههای سفر خود جستجو کرده است، سفر جستجوی قبلی خود را ازسر بگیرند. این خوشه در جایگاه دوم، بعداز رزروها و قبلاز خوشههای ویژه و توصیهشده سنجاق خواهد شد. هر شریک توسعهدهنده میتواند حداکثر ۳ نهاد را در خوشه «ادامه جستجو» همهفرستی کند.
- PointOfInterestEntity: PointOfInterestEntity نشاندهنده مکانهای جالب مانند پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه گردشگری، مسیر پیادهروی، و غیره است. این موجودیت محتوایی را که کاربر قبلاً جستجو کرده است برجسته میکند.
پیشکار
حداقل سطح میانای برنامهسازی کاربردی: ۱۹
کتابخانه com.google.android.engage:engage-core را به برنامهتان اضافه کنید:
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.6.0'
}
خلاصه
طراحی براساس پیادهسازی خدمات محدودکننده است.
دادههایی که کارخواه میتواند منتشر کند تابع محدودیتهای زیر برای انواع مختلف خوشه است:
| نوع خوشه | حدود خوشه | حداقل محدودیتهای نهاد در خوشه | حداکثر حد مجاز نهاد در خوشه |
|---|---|---|---|
| خوشه(های) توصیه | حداکثر ۷ | حداقل ۱ | حداکثر ۵۰ (ArticleEntity، EventEntity،
LodgingEntity، StoreEntity، یا
PointOfInterestEntity) |
| خوشه رزرو | حداکثر ۱ | حداقل ۱ | حداکثر ۲۰ (RestaurantReservationEntity،
EventReservationEntity،
LodgingReservationEntity،
TransportationReservationEntity، یا
VehicleRentalReservationEntity) |
| خوشه ویژه | حداکثر ۱ | حداقل ۱ | حداکثر ۲۰ (GenericFeaturedEntity) |
| ادامه دادن خوشه جستجو | حداکثر ۱ | حداقل ۱ | حداکثر ۳ (PointOfInterestEntity) |
مرحله ۱: ارائه دادههای نهاد
کیت توسعه نرمافزار نهادهای مختلفی را برای نمایش هر نوع مورد تعریف کرده است. از نهادهای زیر برای دسته «سفر و رویدادها» پشتیبانی میکنیم:
GenericFeaturedEntityArticleEntityEventEntityLodgingEntityStoreEntityPointOfInterestEntityRestaurantReservationEntityEventReservationEntityLodgingReservationEntityTransportationReservationEntityVehicleRentalReservationEntity
جدولهای زیر مشخصههای دردسترس و الزامات هر نوع را نشان میدهند.
GenericFeaturedEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| تصاویر پوستر | الزامی | اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: اگر نشان ارائه شده است، مطمئن شوید فضای امن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| عنوان | اختیاری | عنوان نهاد. | نوشتار آزاد اندازه توصیهشده نوشتار: ۵۰ نویسه |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| نشانها | اختیاری | هر نشان یا نوشتار آزاد (حداکثر ۱۵ نویسه) یا تصویر کوچک است. پردازش ویژه تجربه کاربری در بالای تصویر/ ویدیو، برای مثال، بهعنوان نشان رونهاد روی تصویر
|
|
| نشان - نوشتار | اختیاری | عنوان نشان توجه: برای نشان، نوشتار یا تصویر لازم است |
نوشتار آزاد اندازه توصیهشده نوشتار: حداکثر ۱۵ نویسه |
| نشان - تصویر | اختیاری | تصویر کوچک رفتار UX ویژه، برای مثال بهعنوان نشان همپوشان روی ریزعکس تصویر/ ویدیو. توجه: برای نشان، نوشتار یا تصویر لازم است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| دستههای محتوا | اختیاری | دسته محتوا را در نهاد شرح دهید. | فهرست انواع شمارشی برای راهنمایی، به بخش «دسته محتوا» مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
ArticleEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| تصاویر پوستر | اختیاری | اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: تصویر شدیداً توصیه میشود. اگر نشان ارائه شده است، مطمئن شوید که فضای ایمن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| منبع - عنوان | اختیاری | نام نویسنده، سازمان، یا گزارشگر | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۲۵ نویسه |
| منبع - تصویر | اختیاری | تصویری از منبع، مثل نویسنده، سازمان، گزارشگر | برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| نشانها | اختیاری | هر نشان یا نوشتار آزاد (حداکثر ۱۵ نویسه) یا تصویر کوچک است. پردازش UX ویژه روی تصویر/ ویدیو، برای مثال، بهعنوان نشان رونهاد روی تصویر
|
|
| نشان - نوشتار | اختیاری | عنوان نشان توجه: برای نشان، نوشتار یا تصویر لازم است |
نوشتار آزاد اندازه توصیهشده نوشتار: حداکثر ۱۵ نویسه |
| نشان - تصویر | اختیاری | تصویر کوچک رفتار UX ویژه، برای مثال بهعنوان نشان همپوشان روی ریزعکس تصویر/ ویدیو. توجه: برای نشان، نوشتار یا تصویر لازم است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| زمان انتشار محتوا | اختیاری | این مُهر زمان مبدأ برحسب میلیثانیه است که نشان میدهد محتوا چه زمانی در برنامه منتشر/ بهروزرسانی شده است. | مُهر زمان تاریخ برحسب میلیثانیه |
| زمان آخرین تعامل | اختیاری | مهر زمان مبدأ برحسب میلیثانیه که کاربر آخرین بار با این نهاد تعامل داشته است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| درصد پیشرفت | اختیاری | درصد کل محتوایی که کاربر تا امروز مصرف کرده است. |
مقدار عدد صحیح بین ۰ تا ۱۰۰. |
| دستههای محتوا | اختیاری | دسته محتوا را در نهاد شرح دهید. | فهرست انواع شمارشی برای راهنمایی، به بخش «دسته محتوا» مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
EventEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | رشته اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| زمان شروع بومیسازیشده - مُهر زمان | الزامی |
مُهر زمان مبدأ که انتظار میرود رویداد در آن زمان شروع شود. |
Joda-Time Instant |
| زمان شروع بومیسازیشده - منطقه زمانی | الزامی |
منطقه زمانی که انتظار میرود رویداد در آن شروع شود. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| حالت رویداد | الزامی | فیلدی برای نشان دادن اینکه رویداد مجازی، حضوری، یا هر دو خواهد بود. |
Enum: VIRTUAL، IN_PERSON، یا HYBRID |
| تصاویر پوستر | الزامی | اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: تصویر شدیداً توصیه میشود. اگر نشان ارائه شده است، مطمئن شوید که فضای ایمن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| مکان - کشور | الزامی مشروط | کشوری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهای IN_PERSON یا HYBRID الزامی است |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - شهر | الزامی مشروط | شهری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهای IN_PERSON یا HYBRID الزامی است |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - نشانی نمایشی | الزامی مشروط | نشانی یا نام محل برگزاری رویداد که باید به کاربر نشان داده شود. توجه: این مورد برای رویدادهای IN_PERSON یا HYBRID الزامی است |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Location - Street Address | اختیاری | نشانی خیابان (درصورت وجود) مکانی که رویداد در آن برگزار میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - ایالت | اختیاری | ایالت یا استان (درصورت وجود) که رویداد در آن میزبانی میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - کد پستی | اختیاری | کد پستی (درصورت وجود) مکانی که رویداد در آن میزبانی میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - محله | اختیاری | محلهای (درصورت وجود) که رویداد در آنجا میزبانی میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| زمان پایان | اختیاری |
مُهر زمان مبدأ زمانی که انتظار میرود رویداد بهپایان برسد. توجه:این مقدار برحسب میلیثانیه نشان داده میشود. |
مُهر زمان تاریخ برحسب میلیثانیه |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| نشانها | اختیاری |
هر نشان یا نوشتار آزاد (حداکثر ۱۵ نویسه) یا تصویر کوچک است. |
|
| نشان - نوشتار | اختیاری | عنوان نشان توجه: برای نشان، نوشتار یا تصویر لازم است |
نوشتار آزاد اندازه توصیهشده نوشتار: حداکثر ۱۵ نویسه |
| نشان - تصویر | اختیاری | تصویر کوچک رفتار UX ویژه، برای مثال بهعنوان نشان همپوشان روی ریزعکس تصویر/ ویدیو. توجه: برای نشان، نوشتار یا تصویر لازم است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| Price - CurrentPrice | الزامی مشروط |
قیمت فعلی بلیت/مجوز رویداد. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی بلیت/مجوز رویداد. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| دستههای محتوا | اختیاری | دسته محتوا را در نهاد شرح دهید. | فهرست انواع شمارشی واجدشرایط
برای راهنمایی، به بخش «دسته محتوا» مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
LodgingEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | رشته اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| تصاویر پوستر | الزامی |
اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: اگر نشان ارائه شده است، مطمئن شوید فضای امن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| مکان - کشور | الزامی | کشوری که اقامت در آن انجام میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - شهر | الزامی | شهری که اقامتگاه در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - نشانی نمایشی | الزامی | نشانیای که به کاربر نمایش داده خواهد شد. توصیه میکنیم برای اکثر موارد استفاده، نام شهر و احتمالاً استان یا کشور را اضافه کنید. فقط درصورتی نشانی خیابان یا محله را اضافه کنید که کاربر نزدیک مکان باشد، کاربر با مکان آشنا باشد، یا شهر در عنوان خوشه گنجانده شده باشد. اگر نشانی خیابان را اضافه میکنید، نشانی را بهصورت مختصر ارائه دهید و درصورت امکان از کوتهنوشت استفاده کنید (برای مثال، «St» برای «Street» یا «Ave» برای «Avenue»). | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Location - Street Address | اختیاری | نشانی خیابان (درصورت وجود) اقامتگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - ایالت | اختیاری | ایالت یا استان (درصورت وجود) که اقامتگاه در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - کد پستی | اختیاری | کد پستی (درصورت وجود) اقامتگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - محله | اختیاری | محله (درصورت وجود) اقامتگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانها | اختیاری |
هر نشان یا نوشتار آزاد (حداکثر ۱۵ نویسه) یا تصویر کوچک است. |
|
| نشان - نوشتار | اختیاری | عنوان نشان توجه: برای نشان، نوشتار یا تصویر لازم است |
نوشتار آزاد اندازه توصیهشده نوشتار: حداکثر ۱۵ نویسه |
| نشان - تصویر | اختیاری | تصویر کوچک رفتار UX ویژه، برای مثال بهعنوان نشان همپوشان روی ریزعکس تصویر/ ویدیو. توجه: برای نشان، نوشتار یا تصویر لازم است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| AvailabilityTimeWindow - Localized Start Time - Timestamp | اختیاری | مُهر زمان مبدأ که انتظار میرود اقامتگاه در آن زمان باز/ دردسترس باشد. | Joda-Time Instant |
| AvailabilityTimeWindow - Localized Start Time - Timezone | اختیاری | منطقه زمانی که انتظار میرود اقامتگاه در آن باز/ دردسترس باشد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| AvailabilityTimeWindow - Localized End Time - Timestamp | اختیاری | مُهر زمان مبدأ که تا آن زمان انتظار میرود محل اقامت باز/ دردسترس باشد. | Joda-Time Instant |
| AvailabilityTimeWindow - Localized End Time - Timezone | اختیاری | منطقه زمانی که انتظار میرود اقامتگاه در آن باز/ دردسترس باشد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| ردهبندی - مقدار حداکثر | اختیاری | حداکثر مقدار مقیاس ردهبندی. اگر مقدار فعلی ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - مقدار فعلی | اختیاری | مقدار فعلی مقیاس ردهبندی. اگر حداکثر مقدار ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - تعداد | اختیاری | تعداد ردهبندیهای اقامتگاه. توجه: اگر برنامهتان میخواهد نحوه نمایش این مورد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصر را که میتواند به کاربر نمایش داده شود ارائه دهید. برای مثال، اگر تعداد ۱٬۰۰۰٬۰۰۰ است، از کوتهنوشتهایی مثل ۱M استفاده کنید تا در اندازههای کوچکتر نمایشگر کوته نشود. |
رشته |
| ردهبندی - مقدار شمارش | اختیاری | تعداد ردهبندیهای اقامتگاه. توجه: اگر نمیخواهید منطق اختصار نمایش را خودتان مدیریت کنید، این فیلد را ارائه دهید. اگر هم «تعداد» و هم «مقدار تعداد» وجود داشته باشد، از «تعداد» برای نمایش به کاربران استفاده میکنیم |
بلند |
| Price - CurrentPrice | الزامی مشروط | قیمت فعلی اقامتگاه. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی اقامتگاه که در میانای کاربر خطخورده است. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
StoreEntity
شیء StoreEntity نشاندهنده فروشگاه تکی است که شرکای توسعهدهنده میخواهند منتشر کنند، مانند غذاخوری یا رستوران محبوبی که با تجربه سفر فرد مرتبط است.
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| تصاویر پوستر | الزامی | حداقل یک تصویر باید ارائه شود. | برای راهنمایی، مشخصات تصویر را ببینید. |
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | اختیاری | نام فروشگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| مکان | اختیاری | مکان فروشگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| نوشته راهنما | اختیاری | توضیح برای نمایش تبلیغ، رویداد، یا بهروزرسانی برای فروشگاه، درصورت وجود. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| ریزجزئیات نوشته راهنما | اختیاری | نوشتار چاپ نفیس برای نوشته راهنما. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| شرح | اختیاری | شرح فروشگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۹۰ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| دسته | اختیاری | دسته فروشگاه، در بافت مکانهای غذاخوری، میتواند غذاهایی مانند «فرانسوی»، «آمریکایی جدید»، «رامن»، «غذاهای عالی» باشد. |
نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| ردهبندی - مقدار حداکثر | اختیاری | حداکثر مقدار مقیاس ردهبندی. اگر مقدار فعلی ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - مقدار فعلی | اختیاری | مقدار فعلی مقیاس ردهبندی. اگر حداکثر مقدار ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - تعداد | اختیاری | تعداد ردهبندیهای اقامتگاه. توجه: اگر برنامهتان میخواهد نحوه نمایش این مورد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصر را که میتواند به کاربر نمایش داده شود ارائه دهید. برای مثال، اگر تعداد ۱٬۰۰۰٬۰۰۰ است، از کوتهنوشتهایی مثل ۱M استفاده کنید تا در اندازههای کوچکتر نمایشگر کوته نشود. |
رشته |
| ردهبندی - مقدار شمارش | اختیاری | تعداد ردهبندیهای اقامتگاه. توجه: اگر نمیخواهید منطق اختصار نمایش را خودتان مدیریت کنید، این فیلد را ارائه دهید. اگر هم «تعداد» و هم «مقدار تعداد» وجود داشته باشد، از «تعداد» برای نمایش به کاربران استفاده میکنیم |
بلند |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
PointOfInterestEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | رشته اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| تصاویر پوستر | الزامی مشروط |
اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: اگر نهاد بخشی از خوشه توصیهشده باشد، تصویر الزامی است. اگر نشان ارائه شده است، مطمئن شوید که فضای ایمن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| زمان آخرین تعامل | الزامی مشروط |
مهر زمان مبدأ زمانی که کاربر آخرین بار با این نهاد تعامل داشته است. توجه: اگر نهاد بخشی از خوشه ادامه جستجو باشد، این فیلد الزامی است. |
Joda-Time Instant |
| مکان - کشور | الزامی مشروط |
کشوری که نقطه موردعلاقه در آن اتفاق میافتد. توجه: اگر نهاد بخشی از خوشه توصیهشده باشد، این فیلد الزامی است. |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - شهر | الزامی مشروط |
شهری که نقطه موردعلاقه در آن واقع شده است. توجه: اگر نهاد بخشی از خوشه توصیهشده باشد، این فیلد الزامی است. |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - نشانی نمایشی | الزامی مشروط |
نشانیای که به کاربر نمایش داده خواهد شد. نشانی را بهطور خلاصه ارائه دهید و درصورت امکان از کوتهنوشت استفاده کنید (برای مثال، «St» بهجای «Street» یا «Ave» بهجای «Avenue»). این رشته ممکن است بسته به دستگاه و تنظیمات کاربر کوتاه شود. نام شهر را برای شناسایی واضح اضافه کنید. توجه: اگر نهاد بخشی از خوشه توصیهشده باشد، این فیلد الزامی است. |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۳۵ نویسه |
| Location - Street Address | اختیاری | نشانی خیابان (درصورت وجود) نقطه موردعلاقه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - ایالت | اختیاری | ایالت یا استان (درصورت وجود) که نقطه موردعلاقه در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - کد پستی | اختیاری | کد پستی (درصورت وجود) مکان نشاندار. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - محله | اختیاری | محله (درصورت وجود) نقطه موردعلاقه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| AvailabilityTimeWindow - Localized Start Time - Timestamp | اختیاری | مُهر زمان مبدأ زمانی که انتظار میرود مکان جالب باز/ دردسترس باشد. | Joda-Time Instant |
| AvailabilityTimeWindow - Localized Start Time - Timezone | اختیاری | منطقه زمانی که انتظار میرود مکان نشاندار در آن باز/ دردسترس باشد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| AvailabilityTimeWindow - Localized End Time - Timestamp | اختیاری | مُهر زمان مبدأ که انتظار میرود مکان جالب تا آن زمان باز/ دردسترس باشد. | Joda-Time Instant |
| AvailabilityTimeWindow - Localized End Time - Timezone | اختیاری | منطقه زمانی که انتظار میرود مکان نشاندار در آن باز/ دردسترس باشد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| نشانها | اختیاری |
هر نشان یا نوشتار آزاد (حداکثر ۱۵ نویسه) یا تصویر کوچک است. |
|
| نشان - نوشتار | اختیاری | عنوان نشان توجه: برای نشان، نوشتار یا تصویر لازم است |
نوشتار آزاد اندازه توصیهشده نوشتار: حداکثر ۱۵ نویسه |
| نشان - تصویر | اختیاری | تصویر کوچک رفتار UX ویژه، برای مثال بهعنوان نشان همپوشان روی ریزعکس تصویر/ ویدیو. توجه: برای نشان، نوشتار یا تصویر لازم است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| ردهبندی - مقدار حداکثر | اختیاری | حداکثر مقدار مقیاس ردهبندی. اگر مقدار فعلی ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - مقدار فعلی | اختیاری | مقدار فعلی مقیاس ردهبندی. اگر حداکثر مقدار ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - تعداد | اختیاری | تعداد ردهبندیهای مکان نشاندار. توجه: اگر برنامهتان میخواهد نحوه نمایش این مورد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصر را که میتواند به کاربر نمایش داده شود ارائه دهید. برای مثال، اگر تعداد ۱٬۰۰۰٬۰۰۰ است، از کوتهنوشتهایی مثل ۱M استفاده کنید تا در اندازههای کوچکتر نمایشگر کوته نشود. |
رشته |
| ردهبندی - مقدار شمارش | اختیاری | تعداد ردهبندیهای مکان نشاندار. توجه: اگر نمیخواهید منطق اختصار نمایش را خودتان مدیریت کنید، این فیلد را ارائه دهید. اگر هم «تعداد» و هم «مقدار تعداد» وجود داشته باشد، از «تعداد» برای نمایش به کاربران استفاده میکنیم |
بلند |
| Price - CurrentPrice | الزامی مشروط |
قیمت فعلی بلیت/مجوز ورود برای مکان جالب. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی بلیت/مجوز ورود برای مکان جالب. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. |
نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| دستههای محتوا | اختیاری | دسته محتوا را در نهاد شرح دهید. | فهرست انواع شمارشی واجدشرایط
برای راهنمایی، به بخش «دسته محتوا» مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
RestaurantReservationEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | رشته اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| زمان شروع رزرو بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ زمانی که انتظار میرود رزرو شروع شود. | Joda-Time Instant |
| زمان شروع رزرو بومیسازیشده - منطقه زمانی | الزامی | منطقه زمانی که انتظار میرود رزرو در آن شروع شود. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| مکان - کشور | الزامی | کشوری که رستوران در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - شهر | الزامی | شهری که رستوران در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - نشانی نمایشی | الزامی | نشانی رستوران که به کاربر نمایش داده خواهد شد. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Location - Street Address | اختیاری | نشانی خیابان (درصورت وجود) رستوران. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - ایالت | اختیاری | ایالت یا استان (درصورت وجود) که رستوران در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - کد پستی | اختیاری | کد پستی (درصورت وجود) رستوران. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - محله | اختیاری | محله (درصورت وجود) رستوران. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| تصاویر پوستر | اختیاری | اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است | برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| اندازه جدول | اختیاری | تعداد افراد در گروه رزرو | عدد صحیح > ۰ |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
EventReservationEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | رشته اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| زمان شروع بومیسازیشده - مُهر زمان | الزامی |
مُهر زمان مبدأ که انتظار میرود رویداد در آن زمان شروع شود. |
Joda-Time Instant |
| زمان شروع بومیسازیشده - منطقه زمانی | الزامی |
منطقه زمانی که انتظار میرود رویداد در آن شروع شود. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| حالت رویداد | الزامی | فیلدی برای نشان دادن اینکه رویداد مجازی، حضوری، یا هر دو خواهد بود. |
Enum: VIRTUAL، IN_PERSON، یا HYBRID |
| مکان - کشور | الزامی مشروط | کشوری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهای IN_PERSON یا HYBRID الزامی است |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - شهر | الزامی مشروط | شهری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهای IN_PERSON یا HYBRID الزامی است |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - نشانی نمایشی | الزامی مشروط | نشانی یا نام محل برگزاری رویداد که باید به کاربر نشان داده شود. توجه: این مورد برای رویدادهای IN_PERSON یا HYBRID الزامی است |
نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Location - Street Address | اختیاری | نشانی خیابان (درصورت وجود) مکانی که رویداد در آن برگزار میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - ایالت | اختیاری | ایالت یا استان (درصورت وجود) که رویداد در آن میزبانی میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - کد پستی | اختیاری | کد پستی (درصورت وجود) مکانی که رویداد در آن میزبانی میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - محله | اختیاری | محلهای (درصورت وجود) که رویداد در آنجا میزبانی میشود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| تصاویر پوستر | اختیاری | اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: تصویر شدیداً توصیه میشود. اگر نشان ارائه شده است، مطمئن شوید که فضای ایمن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| زمان پایان بومیسازیشده - مُهر زمان | اختیاری |
مُهر زمان مبدأ زمانی که انتظار میرود رویداد بهپایان برسد. |
Joda-Time Instant |
| زمان پایان بومیسازیشده - منطقه زمانی | اختیاری |
منطقه زمانی که انتظار میرود رویداد در آن پایان یابد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| فراهمساز خدمات - نام | اختیاری |
نام ارائهدهنده خدمات. توجه:برای رساننده خدمات، نوشتار یا تصویر الزامی است. |
نوشتار آزاد. برای مثال، نام سازماندهنده رویداد/تور |
| فراهمساز خدمات - تصویر | اختیاری |
نشانواره/تصویر ارائهدهنده خدمات. توجه:برای رساننده خدمات، نوشتار یا تصویر الزامی است. |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| نشانها | اختیاری |
هر نشان یا نوشتار آزاد (حداکثر ۱۵ نویسه) یا تصویر کوچک است. |
|
| نشان - نوشتار | اختیاری | عنوان نشان توجه: برای نشان، نوشتار یا تصویر لازم است |
نوشتار آزاد اندازه توصیهشده نوشتار: حداکثر ۱۵ نویسه |
| نشان - تصویر | اختیاری | تصویر کوچک رفتار UX ویژه، برای مثال بهعنوان نشان همپوشان روی ریزعکس تصویر/ ویدیو. توجه: برای نشان، نوشتار یا تصویر لازم است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شناسه رزرو | اختیاری | شناسه رزرو برای رزرو رویداد. | نوشتار آزاد |
| Price - CurrentPrice | الزامی مشروط |
قیمت فعلی بلیت/مجوز رویداد. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی بلیت/مجوز رویداد. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| ردهبندی - مقدار حداکثر | اختیاری | حداکثر مقدار مقیاس ردهبندی. اگر مقدار فعلی ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - مقدار فعلی | اختیاری | مقدار فعلی مقیاس ردهبندی. اگر حداکثر مقدار ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - تعداد | اختیاری | تعداد ردهبندیهای رویداد. توجه: اگر برنامهتان میخواهد نحوه نمایش این مورد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصر را که میتواند به کاربر نمایش داده شود ارائه دهید. برای مثال، اگر تعداد ۱٬۰۰۰٬۰۰۰ است، از کوتهنوشتهایی مثل ۱M استفاده کنید تا در اندازههای کوچکتر نمایشگر کوته نشود. |
رشته |
| ردهبندی - مقدار شمارش | اختیاری | تعداد ردهبندیهای رویداد. توجه: اگر نمیخواهید منطق اختصار نمایش را خودتان مدیریت کنید، این فیلد را ارائه دهید. اگر هم «تعداد» و هم «مقدار تعداد» وجود داشته باشد، از «تعداد» برای نمایش به کاربران استفاده میکنیم |
بلند |
| دستههای محتوا | اختیاری | دسته محتوا را در نهاد شرح دهید. | فهرست انواع شمارشی واجدشرایط
برای راهنمایی، به بخش «دسته محتوا» مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
LodgingReservationEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | نوشتار آزاد. برای مثال، «اقامت شما از ۱۲ دسامبر» اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| زمان اعلام حضور بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ که نشاندهنده زمان ورود برای رزرو است. | Joda-Time Instant |
| Localized Check-in Time - Timezone | الزامی | منطقه زمانی که زمان اعلام حضور برای رزرو در آن وجود دارد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| زمان تسویهحساب بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ که نشاندهنده زمان خروج برای رزرو است. | Joda-Time Instant |
| زمان تسویهحساب بومیسازیشده - منطقه زمانی | الزامی | منطقه زمانی که زمان تسویهحساب رزرو در آن قرار دارد. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| مکان - کشور | الزامی | کشوری که اقامتگاه در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - شهر | الزامی | شهری که اقامتگاه در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - نشانی نمایشی | الزامی | نشانیای که به کاربر نمایش داده خواهد شد. نشانی مختصر ارائه دهید و درصورت امکان از کوتهنوشت استفاده کنید (برای مثال، «St» برای «Street» (خیابان)، «Ave» برای «Avenue» (بلوار)). این رشته ممکن است بسته به دستگاه و تنظیمات کاربر کوتاه شود. نام شهر را برای شناسایی واضح درج کنید. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۳۵ نویسه |
| Location - Street Address | اختیاری | نشانی خیابان (درصورت وجود) اقامتگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - ایالت | اختیاری | ایالت یا استان (درصورت وجود) که اقامتگاه در آن واقع شده است. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - کد پستی | اختیاری | کد پستی (درصورت وجود) اقامتگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان - محله | اختیاری | محله (درصورت وجود) اقامتگاه. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| تصاویر پوستر | اختیاری |
اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است توجه: اگر نشان ارائه شده است، مطمئن شوید که فضای امن ۲۴ پیکسل مستقل از تراکم در بالا و پایین تصویر وجود داشته باشد |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| شناسه رزرو | اختیاری | شناسه رزرو برای رزرو اقامتگاه. | نوشتار آزاد |
| ردهبندی - مقدار حداکثر | اختیاری | حداکثر مقدار مقیاس ردهبندی. اگر مقدار فعلی ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - مقدار فعلی | اختیاری | مقدار فعلی مقیاس ردهبندی. اگر حداکثر مقدار ردهبندی نیز ارائه شده باشد، باید ارائه شود. |
عدد >= ۰٫۰ |
| ردهبندی - تعداد | اختیاری | تعداد ردهبندیهای اقامتگاه. توجه: اگر برنامهتان میخواهد نحوه نمایش این مورد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصر را که میتواند به کاربر نمایش داده شود ارائه دهید. برای مثال، اگر تعداد ۱٬۰۰۰٬۰۰۰ است، از کوتهنوشتهایی مثل ۱M استفاده کنید تا در اندازههای کوچکتر نمایشگر کوته نشود. |
رشته |
| ردهبندی - مقدار شمارش | اختیاری | تعداد ردهبندیهای اقامتگاه. توجه: اگر نمیخواهید منطق اختصار نمایش را خودتان مدیریت کنید، این فیلد را ارائه دهید. اگر هم «تعداد» و هم «مقدار تعداد» وجود داشته باشد، از «تعداد» برای نمایش به کاربران استفاده میکنیم |
بلند |
| Price - CurrentPrice | الزامی مشروط | قیمت فعلی اقامتگاه. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی اقامتگاه که در میانای کاربر خطخورده است. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
TransportationReservationEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | نوشتار آزاد. برای مثال، «SFO to SAN» (سانفرانسیسکو به سندیگو) اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| نوع حملونقل | الزامی | حالت/نوع حملونقل برای رزرو. | Enum: FLIGHT، TRAIN، BUS، یا FERRY |
| زمان خروج بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ که نشاندهنده زمان حرکت است. | Joda-Time Instant |
| زمان خروج بومیسازیشده - منطقه زمانی | الزامی | منطقه زمانی زمان خروج. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| زمان ورود بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ که نشاندهنده زمان ورود است. | Joda-Time Instant |
| زمان ورود بومیسازیشده - منطقه زمانی | الزامی | منطقه زمانی زمان ورود. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| شماره حملونقل | الزامی | شماره پرواز، شماره اتوبوس، شماره قطار، یا شماره کشتی/ کشتی کروز. | نوشتار آزاد |
| زمان سوار شدن بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ که نشاندهنده زمان سوار شدن برای رزرو است (درصورت وجود) | Joda-Time Instant |
| زمان سوار شدن بومیسازیشده - منطقه زمانی | الزامی | منطقه زمانی زمان سوار شدن برای رزرو (درصورت وجود) |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| مکان حرکت - کشور | اختیاری | کشور مبدأ. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان حرکت - شهر | اختیاری | شهر خروج. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Departure Location - Display Address | اختیاری | مکان عزیمت که به کاربر نمایش داده خواهد شد. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان حرکت - نشانی خیابان | اختیاری | نشانی خیابان (درصورت وجود) مکان خروج. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان حرکت - ایالت | اختیاری | ایالت یا استان (درصورت وجود) مکان عزیمت. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان خروج - کد پستی | اختیاری | کد پستی (درصورت وجود) مکان خروج. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان حرکت - محله | اختیاری | محله (درصورت وجود) مکان عزیمت. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان ورود - کشور | اختیاری | کشور ورود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان ورود - شهر | اختیاری | شهر ورود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Arrival Location - Display Address | اختیاری | مکان ورود که به کاربر نمایش داده خواهد شد. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان ورود - نشانی خیابان | اختیاری | نشانی خیابان (درصورت وجود) مکان ورود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان ورود - ایالت | اختیاری | ایالت یا استان (درصورت وجود) مکان ورود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان ورود - کد پستی | اختیاری | کد پستی (درصورت وجود) مکان ورود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| مکان ورود - محله | اختیاری | محله (درصورت وجود) مکان ورود. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| فراهمساز خدمات - نام | اختیاری |
نام ارائهدهنده خدمات. توجه:برای رساننده خدمات، نوشتار یا تصویر الزامی است. |
نوشتار آزاد. برای مثال، نام شرکت هواپیمایی |
| فراهمساز خدمات - تصویر | اختیاری |
نشانواره/تصویر ارائهدهنده خدمات. توجه:برای رساننده خدمات، نوشتار یا تصویر الزامی است. |
برای راهنمایی، مشخصات تصویر را ببینید. |
| تصاویر پوستر | اختیاری |
اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| شناسه رزرو | اختیاری | شناسه رزرو برای رزرو حملونقل. | نوشتار آزاد |
| Price - CurrentPrice | الزامی مشروط | قیمت فعلی رزرو. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی رزرو که در میانای کاربر خطخورده است. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
VehicleRentalReservationEntity
| مشخصه | الزام | شرح | قالب |
|---|---|---|---|
| شناسه منبع یکسان کنش | الزامی |
پیوند عمیق به نهاد در برنامه ارائهدهنده. توجه: میتوانید از پیوندهای عمیق برای اِسناد استفاده کنید. به این پرسشگان مراجعه کنید |
Uri |
| عنوان | الزامی | عنوان نهاد. | نوشتار آزاد. برای مثال، «Avis Union Square SF» اندازه نوشتار توصیهشده: حداکثر ۵۰ نویسه |
| زمان تحویل بومیسازیشده - مُهر زمان | الزامی | مُهر زمان مبدأ که نشاندهنده زمان تحویل گرفتن رزرو است. | Joda-Time Instant |
| زمان تحویل بومیسازیشده - منطقه زمانی | الزامی | منطقه زمانی زمان تحویل گرفتن برای رزرو. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| زمان برگشت بومیسازیشده - مُهر زمان | اختیاری | مُهر زمان مبدأ که نشاندهنده زمان خروج از هتل برای رزرو است. | Joda-Time Instant |
| زمان برگشت بومیسازیشده - منطقه زمانی | اختیاری | منطقه زمانی زمان خروج برای رزرو. |
Joda-Time DateTimeZone برای راهنمایی، مشخصات منطقه زمانی را ببینید. |
| Pickup Address - Country | اختیاری | کشور مکان سوار شدن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Pickup Address - City | اختیاری | شهر مکان سوار شدن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Pickup Address - Display Address | اختیاری | محل تحویل که به کاربر نمایش داده خواهد شد. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانی تحویل گرفتن - نشانی خیابان | اختیاری | نشانی خیابان (درصورت وجود) مکان سوار شدن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانی تحویل گرفتن - ایالت | اختیاری | ایالت یا استان (درصورت وجود) مکان سوار شدن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Pickup Address - Zip code | اختیاری | کد پستی (درصورت وجود) مکان سوار شدن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانی تحویل گرفتن - محله | اختیاری | محله (درصورت وجود) مکان سوار شدن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Return Address - Country | اختیاری | کشور مکان مرجوع کردن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانی برگشت - شهر | اختیاری | شهر مکان مرجوع کردن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانی فرستنده - نشانی نمایشی | اختیاری | مکان مرجوع کردن که به کاربر نمایش داده خواهد شد. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Return Address - Street Address | اختیاری | نشانی خیابان (درصورت وجود) مکان مرجوع کردن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Return Address - State | اختیاری | ایالت یا استان (درصورت وجود) مکان مرجوع کردن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| Return Address - Zip code | اختیاری | کد پستی (درصورت وجود) مکان مرجوع کردن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| نشانی فرستنده - محله | اختیاری | محله (درصورت وجود) مکان مرجوع کردن. | نوشتار آزاد اندازه نوشتار توصیهشده: حداکثر حدود ۲۰ نویسه |
| فراهمساز خدمات - نام | اختیاری |
نام ارائهدهنده خدمات. توجه:برای رساننده خدمات، نوشتار یا تصویر الزامی است. |
نوشتار آزاد. برای مثال، «Avis Car Rental» |
| فراهمساز خدمات - تصویر | اختیاری |
نشانواره/تصویر ارائهدهنده خدمات. توجه:برای رساننده خدمات، نوشتار یا تصویر الزامی است. |
برای راهنمایی، مشخصات تصویر را ببینید. |
| تصاویر پوستر | اختیاری |
اگر چند تصویر ارائه شده باشد، فقط ۱ تصویر را نشان میدهیم. نسبت ابعادی توصیهشده ۱۶:۹ است |
برای راهنمایی، مشخصات تصویر را ببینید. |
| شرح | اختیاری | یک پاراگراف نوشتار برای توصیف نهاد. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه توصیهشده نوشتار: ۱۸۰ نویسه |
| فهرست زیرنویس | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس یک خط نوشتار است. توجه: یا شرح یا فهرست زیرنویس به کاربر نشان داده میشود، نه هر دو. |
نوشتار آزاد اندازه نوشتار توصیهشده برای هر زیرنویس: حداکثر ۵۰ نویسه |
| شناسه تأیید | اختیاری | شناسه تأیید برای رزرو کرایه خودرو. | نوشتار آزاد |
| Price - CurrentPrice | الزامی مشروط | قیمت فعلی رزرو. اگر قیمت خطخورده ارائه شده باشد، باید ارائه شود. |
نوشتار آزاد |
| Price - StrikethroughPrice | اختیاری | قیمت اصلی رزرو که در میانای کاربر خطخورده است. | نوشتار آزاد |
| نوشته راهنمای قیمت | اختیاری | توضیح قیمت برای نمایش تبلیغ، رویداد، تخفیف عضو، درصورت دردسترس بودن. | نوشتار آزاد اندازه نوشتار توصیهشده: کمتر از ۴۵ نویسه (نوشتاری که خیلی طولانی باشد ممکن است با سهنقطه نشان داده شود) |
| DisplayTimeWindow (اختیاری) - پنجره زمانی را برای نمایش محتوا در سطح تنظیم کنید | |||
| مُهر زمان شروع | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا باید در سطح نشان داده شود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
| مُهر زمان پایان | اختیاری |
مُهر زمان مبدأ که پساز آن محتوا دیگر در سطح نشان داده نمیشود. اگر تنظیم نشده باشد، محتوا واجدشرایط نمایش در سطح است. |
مُهر زمان تاریخ برحسب میلیثانیه |
مشخصات تصویر
جدول زیر مشخصات لازم برای داراییهای تصویری را فهرست میکند:
| نسبت ابعادی | خوشه(های) پشتیبانیشده | حداقل پیکسل | پیکسلهای توصیهشده |
|---|---|---|---|
| افقی (۱۶:۹، ۱٫۹۱×۱) | ویژه، رزرو، ادامه جستجو، و توصیه (۱۶:۹ ترجیح داده میشود) | ۶۴۰×۳۶۰ (۱۶:۹) / ۶۰۰×۳۱۴ (۱٫۹۱×۱) | ۱۲۶۴×۷۱۲ (۱۶:۹) / ۱۲۰۰×۶۲۸ (۱.۹۱×۱) |
| مربع (۱×۱) | همه خوشهها (برای StoreEntity ترجیح داده میشود؛ برای تصاویر ارائهدهنده خدمات و نشان الزامی است) |
۳۰۰×۳۰۰ | 1200x1200 |
| عمودی (۴x۵) | توصیه | ۴۸۰×۶۰۰ | 960x1200 |
تصاویر باید در CDNهای عمومی میزبانی شوند تا Google بتواند به آنها دسترسی داشته باشد.
قالبهای فایل
PNG، JPG، GIF ایستا، WebP
حداکثر اندازه فایل
۵۱۲۰ کیلوبایت
توصیههای بیشتر
- ناحیه امن تصویر: محتوای مهم خود را در ۸۰٪ مرکزی تصویر قرار دهید.
- از پسزمینه شفاف استفاده کنید تا تصویر بهدرستی در تنظیمات زمینه «تیره» و «روشن» نمایش داده شود.
مشخصات منطقه زمانی
شناسه (برای مثال، «America/Los_Angeles») را به اختلاف ساعت (برای مثال، «-07:00») ترجیح دهید.
نمونه استفاده: DateTimeZone.forID("America/Los_Angeles")
دستهبندی محتوا
دسته محتوا به برنامهها اجازه میدهد محتوای متعلق به چندین دسته را منتشر کنند. این کار محتوا را با برخیاز دستههای ازپیش تعریفشده زیر مطابقت میدهد:
TYPE_EDUCATIONTYPE_SPORTSTYPE_MOVIES_AND_TV_SHOWSTYPE_BOOKSTYPE_AUDIOBOOKSTYPE_MUSICTYPE_DIGITAL_GAMESTYPE_TRAVEL_AND_LOCALTYPE_HOME_AND_AUTOTYPE_BUSINESSTYPE_NEWSTYPE_FOOD_AND_DRINKTYPE_SHOPPINGTYPE_HEALTH_AND_FITENESSTYPE_MEDICALTYPE_PARENTINGTYPE_DATING
تصاویر باید در CDNهای عمومی میزبانی شوند تا Google بتواند به آنها دسترسی داشته باشد.
رهنمودهای استفاده از دستههای محتوا
- برخیاز نهادها مثل ArticleEntity و GenericFeaturedEntity واجدشرایط استفاده از هرکدام از دستههای محتوا هستند. برای نهادهای دیگر مانند EventEntity، EventReservationEntity، PointOfInterestEntity، فقط زیرمجموعهای از این دستهها واجدشرایط هستند. پیشاز پر کردن فهرست، فهرست دستههای واجدشرایط برای نوع نهاد را بررسی کنید.
برای برخیاز دستههای محتوا، بهجای ترکیبی از نهادهای «عمومی» و ContentCategory، از نوع نهاد خاص استفاده کنید:
- TYPE_MOVIES_AND_TV_SHOWS - قبلاز استفاده از نهادهای عمومی، نهادهای موجود در راهنمای ادغام تماشا را بررسی کنید.
- TYPE_BOOKS - Check out the EbookEntity before using the generic entities.
- TYPE_AUDIOBOOKS - Check out AudiobookEntity before using the generic entities.
- TYPE_SHOPPING - Check out ShoppingEntity before using the generic entities.
- TYPE_FOOD_AND_DRINK - قبلاز استفاده از نهادهای عمومی، نهادهای راهنمای ادغام غذا را بررسی کنید.
فیلد ContentCategory اختیاری است و اگر محتوا به هیچیک از دستههای ذکرشده در بالا تعلق ندارد، باید خالی گذاشته شود.
درصورتیکه چند دسته محتوا ارائه شده است، آنها را بهترتیب ارتباط با محتوا ارائه دهید و مرتبطترین دسته محتوا را در ابتدای فهرست قرار دهید.
مرحله ۲: ارائه دادههای «خوشه»
توصیه میشود که کار انتشار محتوا در پسزمینه اجرا شود (برای مثال، بااستفاده از WorkManager) و بهصورت منظم یا براساس رویداد (برای مثال، هربار که کاربر برنامه را باز میکند یا وقتی کاربر چیزی به سبد خریدش اضافه میکند) زمانبندی شود.
AppEngageTravelClient مسئول انتشار خوشهها است.
میاناهای برنامهسازی کاربردی زیر برای انتشار خوشهها در کارخواه وجود دارد:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishReservationClusterpublishContinueSearchClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteReservationClusterdeleteContinueSearchClusterdeleteUserManagementClusterdeleteClusters
isServiceAvailable
از این API برای بررسی دردسترس بودن سرویس برای ادغام و امکان ارائه محتوا در دستگاه استفاده میشود.
برای Engage SDK نسخه ۱.۶.۰ و بالاتر (توصیهشده)
مهارتهای Android
مشاهده در GitHubادغام Engage SDK
android skills add engage-sdk-integrationUse the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.میتوانید دردسترس بودن سرویس را برای هر نوع خوشهای که قصد انتشار آن را دارید بررسی کنید. isServiceAvailable API شیء درخواست،
ServiceAvailabilityRequest را میپذیرد که حاوی انواع خوشهای است که باید
دردسترس بودن سرویس برای آنها بررسی شود. میتوانید مقادیر شمارشی ClusterType
موردنیاز برای ServiceAvailabilityRequest را در جدول زیر پیدا کنید.
| نوع خوشه | Cluster Type Constant | مقدار عدد صحیح |
|---|---|---|
| نامعلوم | TYPE_UNKNOWN |
0 |
| خوشه توصیه | TYPE_RECOMMENDATION |
1 |
| خوشه ویژه | TYPE_FEATURED |
2 |
| خوشه ادامه | TYPE_CONTINUATION |
3 |
| خوشه مدیریت کاربر | TYPE_ENGAGEMENT |
8 |
| خوشه اشتراک | TYPE_SUBSCRIPTION |
12 |
| ادامه دادن خوشه جستجو | TYPE_CONTINUE_SEARCH |
13 |
| خوشه رزرو | TYPE_RESERVATION |
14 |
کاتلین
val request = ServiceAvailabilityRequest.Builder()
.addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
.addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
.build()
client.isServiceAvailable(request).addOnCompleteListener { task ->
if (task.isSuccessful) {
val availabilityMap = task.result
if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
// Proceed with publishing continuation content
}
if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
// Proceed with publishing recommendation content
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
جاوا
ServiceAvailabilityRequest request =
new ServiceAvailabilityRequest.Builder()
.addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
.addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
.build();
client.isServiceAvailable(request).addOnCompleteListener(task -> {
if (task.isSuccessful()) {
Map<Integer, Boolean> availabilityMap = task.getResult();
if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
// Proceed with publishing continuation content
}
if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
// Proceed with publishing recommendation content
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
ویژگی دردسترس بودن مشروط سرویس
برخیاز برنامههای ادغامشده پیکربندی ویژهای را درخواست میکنند که سرویس Engage را بهطور متناوب فعال و غیرفعال میکند تا هزینههای ارائه کاهش یابد. بااینحال، این استراتژی دریافت محتوای متناوب تأثیر منفی بر تجربه کاربری دارد: محتوای قدیمی ارائه نخواهد شد و برخیاز سطوح ارائه نخواهند شد.
از نسخه ۱.۶.۰ به بعد، Engage SDK امکان بررسی دردسترس بودن برای انواع خوشههای خاص را فراهم میکند. اگر برنامهتان از انتقال متناوب استفاده میکند:
- خوشههای ادامه (مثل «رزرو» و «ادامه جستجو») بهطور پیشفرض در همه دستگاههای پشتیبانیشده فعال میمانند.
- انواع دیگر خوشهها (مانند «توصیهها») بهطور متناوب فعال و غیرفعال میشوند.
اگر این پیکربندی پیشفرض برای نیازهای شما مناسب نیست، با engage-developers@google.com تماس بگیرید.
برای نسخههای کیت توسعه نرمافزار قبلاز نسخه ۱.۶.۰ (منسوخشده)
کاتلین
client.isServiceAvailable.addOnCompleteListener { task ->
if (task.isSuccessful) {
// Handle IPC call success
if(task.result) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
جاوا
client.isServiceAvailable().addOnCompleteListener(task - > {
if (task.isSuccessful()) {
// Handle success
if(task.getResult()) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
publishRecommendationClusters
این میانای برنامهسازی کاربردی برای انتشار فهرستی از اشیای RecommendationCluster استفاده میشود.
کاتلین
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build()
)
.build()
)
جاوا
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
new RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build())
.build());
وقتی سرویس درخواست را دریافت میکند، کنشهای زیر در یک تراکنش انجام میشود:
- دادههای
RecommendationClusterموجود از شریک توسعهدهنده برداشته میشود. - دادههای درخواست تجزیه میشود و در «خوشه توصیههای» بهروزشده ذخیره میشود.
درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
publishFeaturedCluster
این میانای برنامهسازی کاربردی برای انتشار فهرستی از اشیای FeaturedCluster استفاده میشود.
کاتلین
client.publishFeaturedCluster(
PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
جاوا
client.publishFeaturedCluster(
new PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
new FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
وقتی سرویس درخواست را دریافت میکند، کنشهای زیر در یک تراکنش انجام میشود:
- دادههای
FeaturedClusterموجود از شریک توسعهدهنده برداشته میشود. - دادههای درخواست تجزیه میشود و در «خوشه ویژه» بهروزشده ذخیره میشود.
درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
publishReservationCluster
این API برای انتشار شیء ReservationCluster استفاده میشود.
کاتلین
client.publishReservationCluster(
PublishReservationClusterRequest.Builder()
.setReservationCluster(
ReservationCluster.Builder()
.addLodgingReservationEntity(lodgingReservationEntity)
.addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
.addTransportationReservationEntity(transportationReservationEntity)
.addEventReservationEntity(eventReservationEntity)
.addRestaurantReservationEntity(restaurantReservationEntity)
.build())
.build())
جاوا
client.publishReservationCluster(
new PublishReservationClusterRequest.Builder()
.setReservationCluster(
new ReservationCluster.Builder()
.addLodgingReservationEntity(lodgingReservationEntity)
.addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
.addTransportationReservationEntity(transportationReservationEntity)
.addEventReservationEntity(eventReservationEntity)
.addRestaurantReservationEntity(restaurantReservationEntity)
.build())
.build());
وقتی سرویس درخواست را دریافت میکند، کنشهای زیر در یک تراکنش انجام میشود:
- دادههای
ReservationClusterموجود از شریک توسعهدهنده برداشته میشود. - دادههای درخواست تجزیه میشود و در «خوشه رزرو» بهروزشده ذخیره میشود.
درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
publishContinueSearchCluster
این میانای برنامهسازی کاربردی برای انتشار فهرستی از اشیای ContinueSearchCluster استفاده میشود.
کاتلین
client.publishContinueSearchCluster(
PublishContinueSearchClusterRequest.Builder()
.setContinueSearchCluster(
ContinueSearchCluster.Builder()
.addPointOfInterestEntity(entity1)
.addPointOfInterestEntity(entity2)
.build())
.build())
جاوا
client.publishContinueSearchCluster(
new PublishContinueSearchClusterRequest.Builder()
.setContinueSearchCluster(
new ContinueSearchCluster.Builder()
.addPointOfInterestEntity(entity1)
.addPointOfInterestEntity(entity2)
.build())
.build());
وقتی سرویس درخواست را دریافت میکند، کنشهای زیر در یک تراکنش انجام میشود:
- دادههای
ContinueSearchClusterموجود از شریک توسعهدهنده برداشته میشود. - دادههای درخواست تجزیه میشود و در «خوشه ادامه جستجو» بهروزشده ذخیره میشود.
درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
publishUserAccountManagementRequest
از این میانای برنامهسازی کاربردی برای انتشار کارت «ورود به سیستم» استفاده میشود . کنش ورود به سیستم، کاربران را به صفحه ورود به سیستم برنامه هدایت میکند تا برنامه بتواند محتوا منتشر کند (یا محتوای شخصیسازیشدهتری ارائه دهد)
فراداده زیر بخشی از کارت ورود به سیستم است -
| مشخصه | الزام | شرح |
|---|---|---|
| شناسه منبع یکسان کنش | الزامی | پیوند عمیق به کنش (یعنی پیمایش به صفحه ورود به سیستم برنامه) |
| تصویر | اختیاری - اگر ارائه نشود، عنوان باید ارائه شود |
تصویر نشاندادهشده در کارت تصاویر با نسبت ابعادی ۱۶×۹ و وضوح ۱۲۶۴×۷۱۲ |
| عنوان | اختیاری - اگر ارائه نشود، تصویر باید ارائه شود | عنوان روی کارت |
| متن کنش | اختیاری | نوشتار نشاندادهشده در «دعوت به اقدام» (یعنی ورود به سیستم) |
| زیرنویس | اختیاری | زیرنویس اختیاری روی کارت |
کاتلین
var SIGN_IN_CARD_ENTITY =
SignInCardEntity.Builder()
.addPosterImage(
Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build()
client.publishUserAccountManagementRequest(
PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
جاوا
SignInCardEntity SIGN_IN_CARD_ENTITY =
new SignInCardEntity.Builder()
.addPosterImage(
new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build();
client.publishUserAccountManagementRequest(
new PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
وقتی سرویس درخواست را دریافت میکند، کنشهای زیر در یک تراکنش انجام میشود:
- دادههای
UserAccountManagementClusterموجود از شریک توسعهدهنده برداشته میشود. - دادههای درخواست تجزیه میشود و در خوشه UserAccountManagementCluster بهروزشده ذخیره میشود.
درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
updatePublishStatus
اگر بهدلیل هرگونه مشکل داخلی کسبوکار، هیچکدام از خوشهها منتشر نشد، اکیداً توصیه میکنیم وضعیت انتشار را بااستفاده از میانای برنامهسازی کاربردی updatePublishStatus بهروز کنید. این موضوع مهم است زیرا :
- ارائه وضعیت در همه سناریوها، حتی زمانی که محتوا منتشر شده است (STATUS == PUBLISHED)، برای پر کردن داشبوردهایی که از این وضعیت صریح برای انتقال سلامت و سایر معیارهای ادغام شما استفاده میکنند، حیاتی است.
- اگر محتوایی منتشر نشده باشد اما وضعیت ادغام خراب نباشد (STATUS == NOT_PUBLISHED)، Google میتواند از راهاندازی هشدارها در داشبوردهای سلامت برنامه جلوگیری کند. این کد تأیید میکند که محتوا بهدلیل شرایطی که از دیدگاه ارائهدهنده انتظار میرود منتشر نشده است.
- این کار به توسعهدهندگان کمک میکند تا اطلاعات آماری درباره زمان انتشار دادهها درمقابل عدم انتشار آنها ارائه دهند.
- Google ممکن است از کدهای وضعیت برای ترغیب کاربر به انجام کنشهای خاصی در برنامه استفاده کند تا کاربر بتواند محتوای برنامه را ببیند یا بر آن غلبه کند.
فهرست کدهای وضعیت انتشار واجدشرایط عبارتاند از :
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
اگر محتوا بهدلیل وارد نشدن کاربر به سیستم منتشر نشود، Google توصیه میکند «کارت ورود به سیستم» منتشر شود. اگر ارائهدهندگان به هر دلیلی نتوانند «کارت ورود به سیستم» را منتشر کنند، توصیه میکنیم با کد وضعیت NOT_PUBLISHED_REQUIRES_SIGN_IN، میانای برنامهسازی کاربردی updatePublishStatus را فراخوانی کنید.
کاتلین
client.updatePublishStatus(
PublishStatusRequest.Builder()
.setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
.build())
جاوا
client.updatePublishStatus(
new PublishStatusRequest.Builder()
.setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
.build());
deleteRecommendationsClusters
این میانای برنامهسازی کاربردی برای حذف محتوای «خوشههای توصیهشده» استفاده میشود.
کاتلین
client.deleteRecommendationsClusters()
جاوا
client.deleteRecommendationsClusters();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از «خوشههای توصیهشده» برمیدارد. درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteFeaturedCluster
این میانای برنامهسازی کاربردی برای حذف محتوای «خوشه ویژه» استفاده میشود.
کاتلین
client.deleteFeaturedCluster()
جاوا
client.deleteFeaturedCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از «خوشه ویژه» برمیدارد. درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteReservationCluster
این میانای برنامهسازی کاربردی برای حذف محتوای «خوشه رزرو» استفاده میشود.
کاتلین
client.deleteReservationCluster()
جاوا
client.deleteReservationCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از «خوشه رزرو» برمیدارد. درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteUserManagementCluster
این API برای حذف محتوای خوشه UserAccountManagement استفاده میشود.
کاتلین
client.deleteUserManagementCluster()
جاوا
client.deleteUserManagementCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از خوشه UserAccountManagement برمیدارد. درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteContinueSearchCluster
این میانای برنامهسازی کاربردی برای حذف محتوای «خوشه ادامه جستجو» استفاده میشود.
کاتلین
client.deleteContinueSearchCluster()
جاوا
client.deleteContinueSearchCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از «خوشه ادامه جستجو» برمیدارد. درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteClusters
این میانای برنامهسازی کاربردی برای حذف محتوای نوع خوشه دادهشده استفاده میشود.
کاتلین
client.deleteClusters(
DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_RESERVATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
.build())
جاوا
client.deleteClusters(
new DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_RESERVATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
.build());
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از همه خوشههای منطبق با انواع خوشه مشخصشده برمیدارد. مشتریان میتوانند یک یا چند نوع خوشه را برای ارسال انتخاب کنند. درصورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
مدیریت کردن خطا
توصیه میشود به نتیجه تکلیف از APIهای انتشار گوش دهید تا بتوانید اقدام پیگیری برای بازیابی و ارسال مجدد تکلیف موفق انجام دهید.
کاتلین
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(..)
.build())
.addOnCompleteListener { task ->
if (task.isSuccessful) {
// do something
} else {
val exception = task.exception
if (exception is AppEngageException) {
@AppEngageErrorCode val errorCode = exception.errorCode
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
}
جاوا
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(...)
.build())
.addOnCompleteListener(
task -> {
if (task.isSuccessful()) {
// do something
} else {
Exception exception = task.getException();
if (exception instanceof AppEngageException) {
@AppEngageErrorCode
int errorCode = ((AppEngageException) exception).getErrorCode();
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
});
خطا بهصورت AppEngageException برگردانده میشود و علت آن بهصورت کد خطا درج میشود.
| کد خطا | نام خطا | توجه |
|---|---|---|
1 |
SERVICE_NOT_FOUND |
این سرویس در دستگاه ارائهشده دردسترس نیست. |
2 |
SERVICE_NOT_AVAILABLE |
سرویس در دستگاه ارائهشده دردسترس است، اما در زمان تماس دردسترس نیست (برای مثال، صریحاً غیرفعال شده است). |
3 |
SERVICE_CALL_EXECUTION_FAILURE |
اجرای تکلیف بهدلیل مشکلات رشتهای ناموفق بود. در این مورد، میتوان دوباره امتحان کرد. |
4 |
SERVICE_CALL_PERMISSION_DENIED |
تماسگیرنده مجاز به برقراری تماس سرویس نیست. |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
درخواست حاوی دادههای نامعتبر است (برای مثال، بیشتر از تعداد مجاز خوشهها). |
6 |
SERVICE_CALL_INTERNAL |
خطایی در سمت سرویس وجود دارد. |
7 |
SERVICE_CALL_RESOURCE_EXHAUSTED |
فراخوانی سرویس بیشازحد انجام میشود. |
مرحله ۳: مدیریت کردن هدفهای همهفرستی
علاوهبر برقراری تماسهای میانای برنامهسازی کاربردی محتوای انتشار ازطریق کار، لازم است
BroadcastReceiver
راهاندازی شود تا
درخواست انتشار محتوا دریافت شود.
هدف از هدفهای همهفرستی عمدتاً فعالسازی مجدد برنامه و اجبار به همگامسازی دادهها است. هدفهای همهفرستی برای ارسال مکرر طراحی نشدهاند. این رویداد فقط زمانی راهاندازی میشود که «سرویس تعامل» تشخیص دهد محتوا ممکن است قدیمی باشد (برای مثال، یک هفته از آن گذشته باشد). بهاینترتیب، اطمینان بیشتری وجود دارد که کاربر میتواند تجربه محتوای جدیدی داشته باشد، حتی اگر برنامه برای مدت طولانی اجرا نشده باشد.
BroadcastReceiver باید به دو روش زیر راهاندازی شود:
نمونهای از کلاس
BroadcastReceiverرا بهطور پویا بااستفاده ازContext.registerReceiver()ثبت کنید. این اجازه ارتباط از برنامههایی را که هنوز در حافظه فعال هستند ممکن میکند.
کاتلین
class AppEngageBroadcastReceiver : BroadcastReceiver(){
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received
// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}
fun registerBroadcastReceivers(context: Context){
var context = context
context = context.applicationContext
// Register Recommendation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Featured Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Continue Search Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Reservation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
}
جاوا
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received
// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}
public static void registerBroadcastReceivers(Context context) {
context = context.getApplicationContext();
// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
}
پیادهسازی را با برچسب
<receiver>در فایلAndroidManifest.xmlبهصورت ایستا اعلام کنید. این به برنامه اجازه میدهد تا زمانی که درحال اجرا نیست، اهداف پخش را دریافت کند و همچنین به برنامه اجازه میدهد تا محتوا را منتشر کند.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
</intent-filter>
</receiver>
</application>
هدفهای زیر توسط سرویس ارسال میشود:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONتوصیه میشود هنگام دریافت این هدف، تماسpublishRecommendationClustersرا شروع کنید.com.google.android.engage.action.PUBLISH_FEATUREDتوصیه میشود هنگام دریافت این هدف، تماسpublishFeaturedClusterرا شروع کنید.com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCHتوصیه میشود هنگام دریافت این هدف، تماسpublishContinueSearchClusterرا شروع کنید.com.google.android.engage.action.travel.PUBLISH_RESERVATIONتوصیه میشود هنگام دریافت این قصد، تماسpublishReservationClusterرا شروع کنید.
گردش کار یکپارچهسازی
برای راهنمای گامبهگام درباره درستیسنجی ادغام پساز تکمیل، به گردش کار ادغام توسعهدهنده Engage مراجعه کنید.
پرسشگان
برای پرسشگان، به پرسشگان Engage SDK مراجعه کنید.
تماس
اگر درطول فرایند ادغام سؤالی داشتید، با
engage-developers@google.com تماس بگیرید.
مراحل بعدی
پساز تکمیل این ادغام، مراحل بعدی شما به شرح زیر است:
- ایمیلی به
engage-developers@google.comارسال کنید و فایل APK یکپارچهشدهتان را که برای آزمایش توسط Google آماده است پیوست کنید. - Google درستیسنجی و بازبینی را بهصورت داخلی انجام میدهد تا مطمئن شود که ادغام طبق انتظار کار میکند. اگر تغییری لازم باشد، Google با جزئیات لازم با شما تماس میگیرد.
- وقتی آزمایش تکمیل شد و نیازی به تغییر نبود، Google با شما تماس میگیرد تا به شما اطلاع دهد که میتوانید انتشار APK بهروزشده و ادغامشده را در «فروشگاه Play» شروع کنید.
- پساز اینکه Google تأیید کرد APK بهروزشده شما در «فروشگاه Play» منتشر شده است، خوشههای توصیه، ویژه، رزرو، و ادامه جستجو شما ممکن است منتشر شوند و برای کاربران قابلمشاهده باشند.