با دسترسی به کاربران خود در هر کجا که هستند، تعامل با برنامه را افزایش دهید. Engage SDK را ادغام کنید تا توصیههای شخصیسازیشده و محتوای مداوم را مستقیماً به کاربران در سطوح مختلف روی دستگاه، مانند Collections ، Entertainment Space و Play Store ارائه دهید. این ادغام کمتر از ۵۰ کیلوبایت (فشردهشده) به میانگین APK اضافه میکند و برای اکثر برنامهها حدود یک هفته از زمان توسعهدهنده را میگیرد. برای اطلاعات بیشتر به سایت تجاری ما مراجعه کنید.
این راهنما شامل دستورالعملهایی برای شرکای توسعهدهنده است تا محتوای سفر و رویدادها را به سطوح محتوای Engage ارائه دهند.
جزئیات ادغام
اصطلاحات
این ادغام شامل انواع خوشههای زیر است: توصیه ، ویژه ، رزرو و ادامه جستجو .
خوشههای توصیه، پیشنهادهای شخصیسازیشدهی سفر و رویداد را از یک شریک توسعهدهندهی منفرد نشان میدهند. این توصیهها میتوانند برای کاربر شخصیسازی شده یا عمومی شوند (برای مثال، موارد پرطرفدار). از این موارد برای ارائهی توصیههای مقالات، رویدادها، اقامتگاهها یا مکانهای دیدنی استفاده کنید.
- یک خوشه توصیه میتواند از فهرستهای
ArticleEntity،EventEntity،LodgingEntity،PointOfInterestEntityیاStoreEntityساخته شود، اما ترکیبی از انواع مختلف موجودیتها نیست.
توصیههای شما ساختار زیر را دارند:
خوشه توصیه: یک نمای رابط کاربری که شامل گروهی از توصیهها از یک شریک توسعهدهنده است.
موجودیت: شیئی که یک آیتم واحد را در یک خوشه نشان میدهد. این ادغام، موجودیتهایی را ارائه میدهد که با استفاده از خوشه توصیه، نمایان میشوند:
ArticleEntity : ArticleEntity یک پیشنهاد برای محتوای متنی مرتبط با سفر و رویدادها ارائه میدهد. میتوان از آن برای مقالات، پستهای وبلاگ، محتوای بازاریابی، گزیدههای خبری و غیره استفاده کرد.
شکل ۱: رابط کاربری که یک ArticleEntity واحد را در خوشه توصیهها نشان میدهد. EventEntity : EventEntity نشان دهنده رویدادی است که در آینده اتفاق میافتد. زمان شروع رویداد، بخش مهمی از اطلاعات است که باید به کاربران منتقل شود.
شکل ۲: رابط کاربری که یک EventEntity واحد را در خوشه توصیهها نشان میدهد. LodgingEntity : LodgingEntity نشان دهنده یک اقامتگاه، مانند هتل، آپارتمان، خانه تعطیلات برای اجاره کوتاه مدت و بلند مدت است.
شکل ۳: رابط کاربری که یک LodgingEntity واحد را در خوشه توصیهها نشان میدهد. StoreEntity : StoreEntity نشاندهنده یک فروشگاه، رستوران، کافه و غیره است. این عنصر، محتوایی را برجسته میکند که در آن یک محل غذاخوری یا فروشگاه، بخش مهمی از اطلاعات است که باید به کاربران منتقل شود.
شکل ۴: رابط کاربری که یک StoreEntity واحد را در خوشه توصیهها نشان میدهد. PointOfInterestEntity : PointOfInterestEntity نشاندهنده یک مکان مورد علاقه مانند پمپ بنزین، محل برگزاری رویداد، پارک تفریحی، موزه، جاذبه گردشگری، مسیر پیادهروی و غیره است. این مکان، محتوایی را برجسته میکند که در آن مکان، اطلاعات مهمی است که باید به کاربران منتقل شود. نباید از آن برای اقامت، فروشگاه یا محل غذاخوری استفاده شود.
شکل ۵: رابط کاربری که یک PointOfInterestEntity واحد را در خوشه توصیهها نشان میدهد.
- یک خوشه توصیه میتواند از فهرستهای
خوشه رزرو ، محتوایی را که اخیراً توسط کاربران چندین شریک توسعهدهنده در یک گروهبندی رابط کاربری واحد مورد استفاده قرار گرفته است، نشان میدهد. هر شریک توسعهدهنده مجاز به پخش حداکثر ۱۰ موجودیت در خوشه رزرو خواهد بود.
محتوای رزرو شما میتواند ساختار زیر را داشته باشد:
RestaurantReservationEntity : RestaurantReservationEntity نشاندهنده رزرو برای یک رستوران یا کافه است و به کاربران کمک میکند تا رزروهای آینده یا جاری رستوران را پیگیری کنند.
شکل ۶. رابط کاربری که یک RestaurantReservationEntity واحد را در یک خوشه Reservation نشان میدهد. EventReservationEntity : EventReservationEntity نشاندهنده رزرو برای یک رویداد است و به کاربران کمک میکند تا رزرو رویدادهای آینده یا در حال انجام را پیگیری کنند. رویدادها میتوانند شامل موارد زیر باشند، اما محدود به آنها نیستند:
- رویدادهای ورزشی مانند رزرو مسابقه فوتبال
- رویدادهای بازی مانند رزرو برای eSports
- رویدادهای سرگرمی مانند رزرو فیلم در سینما، کنسرت، تئاتر، امضای کتاب
- رزرو سفر یا مکانهای مورد علاقه مانند تورهای گردشگری، بلیط موزه
- رزروهای اجتماعی / سمینار / کنفرانس
- رزرو جلسات آموزشی/تربیتی
شکل ۷. رابط کاربری که یک EventReservationEntity واحد را درون یک خوشه Reservation نشان میدهد. LodgingReservationEntity : LodgingEntityReservation نشاندهنده رزرو برای اقامتگاه مسافرتی است و به کاربران کمک میکند تا رزروهای هتل یا اجاره تعطیلات آینده یا در حال انجام را پیگیری کنند.
شکل ۸. رابط کاربری که یک LodgingReservationEntity واحد را در یک خوشه Reservation نشان میدهد. TransportationReservationEntity : TransportationReservationEntity نشاندهنده رزرو حمل و نقل با هر روشی است و به کاربران کمک میکند تا رزروهای پرواز، کشتی، قطار، اتوبوس، تاکسی اینترنتی یا سفر دریایی آینده یا در حال انجام را پیگیری کنند.
شکل ۹. رابط کاربری که یک TransportationReservationEntity واحد را درون یک خوشه Reservation نشان میدهد. VehicleRentalReservationEntity : VehicleRentalReservationEntity نشاندهنده رزرو اجاره خودرو است و به کاربران کمک میکند تا رزروهای اجاره خودرو در آینده یا در حال انجام را پیگیری کنند.
شکل ۱۰. رابط کاربری که یک VehicleRentalReservationEntity واحد را در یک خوشه Reservation نشان میدهد.
خوشه ویژه ، مجموعهای از موجودیتها را از چندین شریک توسعهدهنده در یک گروهبندی رابط کاربری نمایش میدهد. یک خوشه ویژه وجود خواهد داشت که در نزدیکی بالای رابط کاربری با اولویت بالاتر از همه خوشههای توصیه نمایش داده میشود. هر شریک توسعهدهنده مجاز به پخش حداکثر 10 موجودیت در خوشه ویژه خواهد بود.
موجودیت ویژه عمومی (GenericFeaturedEntity) : موجودیت ویژه عمومی با آیتم توصیه (Recommendation item) متفاوت است، زیرا آیتم ویژه باید برای یک محتوای برتر از توسعهدهندگان استفاده شود و باید مهمترین محتوایی را که برای کاربران جالب و مرتبط خواهد بود، نشان دهد.
شکل 11: رابط کاربری که یک FeaturedCluster را با لیستی از GenericFeaturedEntity نشان میدهد
خوشه «ادامه جستجو» با نمایش فهرستی از جستجوهایی که کاربر اخیراً در تمام برنامههای سفر خود جستجو کرده است، به کاربران کمک میکند تا سفر جستجوی سفر قبلی خود را از سر بگیرند. این خوشه در جایگاه دوم، پس از رزروها و قبل از خوشههای ویژه و توصیهشده، پین خواهد شد. هر شریک توسعهدهنده مجاز خواهد بود تا حداکثر ۳ موجودیت را در خوشه «ادامه جستجو» پخش کند.
- PointOfInterestEntity: PointOfInterestEntity نشاندهنده یک مکان مورد علاقه مانند پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه گردشگری، مسیر پیادهروی و غیره است. این عنصر، محتوایی را که کاربر قبلاً جستجو کرده است، برجسته میکند.
پیش کار
حداقل سطح API: ۱۹
کتابخانه 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.5.12'
}
خلاصه
طراحی بر اساس پیادهسازی یک سرویس محدود (bound service) است.
دادههایی که یک کلاینت میتواند منتشر کند، برای انواع مختلف خوشهها مشمول محدودیتهای زیر است:
| نوع خوشه | محدودیتهای خوشه | حداقل محدودیت موجودیت در یک خوشه | حداکثر محدودیتهای موجودیت در یک خوشه |
|---|---|---|---|
| خوشه(های) پیشنهادی | حداکثر ۷ عدد | حداقل ۱ | حداکثر ۵۰ ( ArticleEntity ، EventEntity ، LodgingEntity ، StoreEntity یا PointOfInterestEntity ) |
| خوشه رزرو | حداکثر ۱ | حداقل ۱ | حداکثر ۲۰ ( RestaurantReservationEntity ، EventReservationEntity ، LodgingReservationEntity ، TransportationReservationEntity ، یا VehicleRentalReservationEntity ) |
| خوشه ویژه | حداکثر ۱ | حداقل ۱ | حداکثر 20 ( GenericFeaturedEntity ) |
| ادامه جستجو در خوشه | حداکثر ۱ | حداقل ۱ | حداکثر ۳ ( PointOfInterestEntity ) |
مرحله ۱: ارائه دادههای موجودیت
SDK برای نمایش هر نوع آیتم، موجودیتهای مختلفی تعریف کرده است. ما از موجودیتهای زیر برای دستهبندی سفر و رویدادها پشتیبانی میکنیم:
-
GenericFeaturedEntity -
ArticleEntity -
EventEntity -
LodgingEntity -
StoreEntity -
PointOfInterestEntity -
RestaurantReservationEntity -
EventReservationEntity -
LodgingReservationEntity -
TransportationReservationEntity -
VehicleRentalReservationEntity
نمودارهای زیر ویژگیها و الزامات موجود برای هر نوع را شرح میدهند.
GenericFeaturedEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| تصاویر پوستر | مورد نیاز | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: اگر نشان ارائه میشود، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| عنوان | اختیاری | عنوان نهاد. | متن رایگان اندازه متن پیشنهادی: ۵۰ کاراکتر |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| نشانها | اختیاری | هر نشان یا متن آزاد (حداکثر ۱۵ کاراکتر) یا تصویر کوچک است. جلوههای ویژه UX روی تصویر/ویدئو، مثلاً به عنوان پوشش نشان روی تصویر
| |
| نشان - متن | اختیاری | عنوان برای نشان توجه: برای نشان، متن یا تصویر الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ۱۵ کاراکتر |
| نشان - تصویر | اختیاری | تصویر کوچک جلوههای ویژه تجربه کاربری، برای مثال به صورت پوشش نشان روی تصویر کوچک تصویر/ویدئو. توجه: برای نشان، متن یا تصویر الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| دسته بندی محتوا | اختیاری | دسته بندی محتوای موجود در موجودیت را شرح دهید. | فهرست Enumها برای راهنمایی به بخش دستهبندی محتوا مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
ArticleEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | متن رایگان اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| تصاویر پوستر | اختیاری | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: تصویر اکیداً توصیه میشود. در صورت ارائه نشان، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| منبع - عنوان | اختیاری | نام نویسنده، سازمان یا گزارشگر | متن رایگان اندازه متن پیشنهادی: کمتر از ۲۵ کاراکتر |
| منبع - تصویر | اختیاری | تصویری از منبع مانند نویسنده، سازمان، خبرنگار | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| نشانها | اختیاری | هر نشان یا متن آزاد (حداکثر ۱۵ کاراکتر) یا تصویر کوچک است. جلوههای ویژه UX روی تصویر/ویدئو، مثلاً به عنوان پوشش نشان روی تصویر
| |
| نشان - متن | اختیاری | عنوان برای نشان توجه: برای نشان، متن یا تصویر الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ۱۵ کاراکتر |
| نشان - تصویر | اختیاری | تصویر کوچک جلوههای ویژه تجربه کاربری، برای مثال به صورت پوشش نشان روی تصویر کوچک تصویر/ویدئو. توجه: برای نشان، متن یا تصویر الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| زمان انتشار محتوا | اختیاری | این نشانگر زمانیِ epoch بر حسب میلیثانیه است که نشان میدهد محتوا در چه زمانی در برنامه منتشر/بهروزرسانی شده است. | مهر زمانی عصر بر حسب میلی ثانیه |
| آخرین زمان نامزدی | اختیاری | مهر زمانیِ آخرین تعامل کاربر با این موجودیت بر حسب میلیثانیه. | مهر زمانی عصر بر حسب میلی ثانیه |
| درصد پیشرفت | اختیاری | درصد کل محتوای مصرفشده توسط کاربر تا به امروز. | یک مقدار صحیح بین ۰ تا ۱۰۰. |
| دسته بندی محتوا | اختیاری | دسته بندی محتوای موجود در موجودیت را شرح دهید. | فهرست Enumها برای راهنمایی به بخش دستهبندی محتوا مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
EventEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| زمان شروع محلی - مهر زمان | مورد نیاز | مهر زمانیِ دورهای که انتظار میرود رویداد در آن شروع شود. | جودا-تایم فوری |
| زمان شروع محلی - منطقه زمانی | مورد نیاز | منطقه زمانی که انتظار میرود رویداد در آن شروع شود. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| حالت رویداد | مورد نیاز | فیلدی برای مشخص کردن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود. | Enum: مجازی، حضوری یا ترکیبی |
| تصاویر پوستر | مورد نیاز | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: تصویر اکیداً توصیه میشود. در صورت ارائه نشان، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| مکان - کشور | مشروط مورد نیاز | کشوری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهایی که IN_PERSON یا HYBRID هستند، الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - شهر | مشروط مورد نیاز | شهری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهایی که IN_PERSON یا HYBRID هستند، الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - نمایش آدرس | مشروط مورد نیاز | آدرس یا نام مکانی که رویداد در آن برگزار خواهد شد که باید به کاربر نمایش داده شود. توجه: این مورد برای رویدادهایی که IN_PERSON یا HYBRID هستند، الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) مکانی که رویداد در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - ایالت | اختیاری | ایالت یا استانی (در صورت وجود) که رویداد در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) محل برگزاری رویداد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| موقعیت مکانی - محله | اختیاری | محله (در صورت وجود) که رویداد در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| زمان پایان | اختیاری | مهر زمانیِ دورهای که انتظار میرود رویداد در آن پایان یابد. نکته: این مقدار بر حسب میلیثانیه نمایش داده میشود. | مهر زمانی عصر بر حسب میلی ثانیه |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| نشانها | اختیاری | هر نشان یا متن آزاد (حداکثر ۱۵ کاراکتر) یا تصویر کوچک است. | |
| نشان - متن | اختیاری | عنوان برای نشان توجه: برای نشان، متن یا تصویر الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ۱۵ کاراکتر |
| نشان - تصویر | اختیاری | تصویر کوچک جلوههای ویژه تجربه کاربری، برای مثال به صورت پوشش نشان روی تصویر کوچک تصویر/ویدئو. توجه: برای نشان، متن یا تصویر الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی بلیط/کارت ورود به رویداد. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی بلیط/کارت ورود به رویداد. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| دسته بندی محتوا | اختیاری | دسته بندی محتوای موجود در موجودیت را شرح دهید. | فهرست Enumهای واجد شرایط
برای راهنمایی به بخش دستهبندی محتوا مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
LodgingEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| تصاویر پوستر | مورد نیاز | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: اگر نشان ارائه میشود، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| مکان - کشور | مورد نیاز | کشوری که محل اقامت در آن اتفاق میافتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - شهر | مورد نیاز | شهری که محل اقامت در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - نمایش آدرس | مورد نیاز | آدرسی که به کاربر نمایش داده میشود. در بیشتر موارد استفاده، توصیه میکنیم نام شهر و در صورت امکان استان یا کشور را نیز ذکر کنید. فقط در صورتی آدرس خیابان یا محله را ذکر کنید که کاربر در نزدیکی محل باشد، با آن آشنا باشد یا شهر در عنوان خوشه گنجانده شده باشد. اگر آدرس خیابان را ذکر میکنید، آدرس مختصری ارائه دهید و در صورت امکان از اختصارات استفاده کنید (برای مثال، "خیابان" برای "خیابان"، "خیابان" برای "خیابان"). | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - ایالت | اختیاری | ایالت یا استانی (در صورت وجود) که محل اقامت در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| موقعیت مکانی - محله | اختیاری | محله (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| نشانها | اختیاری | هر نشان یا متن آزاد (حداکثر ۱۵ کاراکتر) یا تصویر کوچک است. | |
| نشان - متن | اختیاری | عنوان برای نشان توجه: برای نشان، متن یا تصویر الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ۱۵ کاراکتر |
| نشان - تصویر | اختیاری | تصویر کوچک جلوههای ویژه تجربه کاربری، برای مثال به صورت پوشش نشان روی تصویر کوچک تصویر/ویدئو. توجه: برای نشان، متن یا تصویر الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| پنجره زمان دسترسی - زمان شروع محلی - مهر زمانی | اختیاری | مهر زمانیِ دورهای که انتظار میرود اقامتگاه باز/در دسترس باشد. | جودا-تایم فوری |
| پنجره زمان دسترسی - زمان شروع محلی - منطقه زمانی | اختیاری | منطقه زمانی که انتظار میرود اقامتگاه در آن باز/در دسترس باشد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| پنجره زمان دسترسی - زمان پایان محلی - مهر زمان | اختیاری | مهر زمانی دورهای که انتظار میرود اقامتگاه تا آن زمان باز/در دسترس باشد. | جودا-تایم فوری |
| پنجره زمان دسترسی - زمان پایان محلی - منطقه زمانی | اختیاری | منطقه زمانی که انتظار میرود اقامتگاه در آن باز/در دسترس باشد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| رتبهبندی - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبهبندی. اگر مقدار فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - ارزش فعلی | اختیاری | مقدار فعلی مقیاس رتبهبندی. اگر حداکثر مقدار رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - تعداد | اختیاری | تعداد امتیازهای مربوط به اقامتگاه. نکته: اگر برنامه شما میخواهد نحوه نمایش این عدد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصری را که میتواند به کاربر نمایش داده شود، ارائه دهید. برای مثال، اگر تعداد ۱,۰۰۰,۰۰۰ است، استفاده از اختصاراتی مانند ۱M را در نظر بگیرید تا در اندازههای کوچکتر صفحه نمایش کوتاه نشود. | رشته |
| رتبهبندی - مقدار شمارش | اختیاری | تعداد امتیازهای مربوط به اقامتگاه. توجه: اگر نمیخواهید خودتان منطق نمایش اختصارات را مدیریت کنید، این فیلد را وارد کنید. اگر هم تعداد و هم مقدار تعداد وجود داشته باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد. | بلند |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی اقامتگاه. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی اقامتگاه، که در فاکتور خط خورده است. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
StoreEntity
شیء StoreEntity نشاندهنده یک فروشگاه شخصی است که شرکای توسعهدهنده میخواهند منتشر کنند، مانند یک رستوران یا غذاخوری محبوب که به تجربه سفر فرد مرتبط است.
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| تصاویر پوستر | مورد نیاز | حداقل یک تصویر باید ارائه شود. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | اختیاری | نام فروشگاه. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| مکان | اختیاری | موقعیت مکانی فروشگاه. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| فراخوان | اختیاری | در صورت امکان، برای تبلیغ، رویداد یا بهروزرسانی فروشگاه، فراخوان دهید. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| چاپ خوب را بنویسید | اختیاری | متن چاپی زیبا برای توضیحات. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| توضیحات | اختیاری | توضیحی در مورد فروشگاه. | متن رایگان اندازه متن پیشنهادی: کمتر از ۹۰ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| دسته بندی | اختیاری | دسته بندی یک فروشگاه، در زمینه رستورانها، میتواند شامل غذاهایی مانند «فرانسوی»، «نیو امریکن»، «رامِن» یا «فوقالعاده» باشد. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| رتبهبندی - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبهبندی. اگر مقدار فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - ارزش فعلی | اختیاری | مقدار فعلی مقیاس رتبهبندی. اگر حداکثر مقدار رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - تعداد | اختیاری | تعداد امتیازهای مربوط به اقامتگاه. نکته: اگر برنامه شما میخواهد نحوه نمایش این عدد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصری را که میتواند به کاربر نمایش داده شود، ارائه دهید. برای مثال، اگر تعداد ۱,۰۰۰,۰۰۰ است، استفاده از اختصاراتی مانند ۱M را در نظر بگیرید تا در اندازههای کوچکتر صفحه نمایش کوتاه نشود. | رشته |
| رتبهبندی - مقدار شمارش | اختیاری | تعداد امتیازهای مربوط به اقامتگاه. توجه: اگر نمیخواهید خودتان منطق نمایش اختصارات را مدیریت کنید، این فیلد را وارد کنید. اگر هم تعداد و هم مقدار تعداد وجود داشته باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد. | بلند |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
PointOfInterestEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| تصاویر پوستر | مشروط مورد نیاز | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: اگر نهاد بخشی از خوشه توصیهها باشد، تصویر الزامی است. اگر نشان ارائه میشود، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| آخرین زمان نامزدی | مشروط مورد نیاز | مهر زمانیِ آخرین باری که کاربر با این موجودیت تعامل داشته است. توجه: اگر موجودیت بخشی از خوشه جستجوی ادامه باشد، این فیلد الزامی است. | جودا-تایم فوری |
| مکان - کشور | مشروط مورد نیاز | کشوری که نقطه مورد نظر در آن اتفاق میافتد. توجه: اگر نهاد بخشی از خوشه توصیه باشد، این فیلد الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - شهر | مشروط مورد نیاز | شهری که نقطه مورد نظر در آن اتفاق میافتد. توجه: اگر نهاد بخشی از خوشه توصیه باشد، این فیلد الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - نمایش آدرس | مشروط مورد نیاز | آدرسی که به کاربر نمایش داده میشود. یک آدرس مختصر ارائه دهید و در صورت امکان از اختصارات استفاده کنید (برای مثال، "St" برای "Street"، "Ave" برای "Avenue"). این رشته ممکن است بسته به دستگاه و تنظیمات کاربر کوتاه شود. برای شناسایی بهتر، نام شهر را نیز ذکر کنید. توجه: اگر نهاد بخشی از خوشه توصیه باشد، این فیلد الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~35 کاراکتر |
| مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) نقطه مورد نظر. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - ایالت | اختیاری | ایالت یا استانی (در صورت وجود) که نقطه مورد نظر در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) نقطه مورد نظر. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| موقعیت مکانی - محله | اختیاری | محله (در صورت وجود) نقطه مورد نظر. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| پنجره زمان دسترسی - زمان شروع محلی - مهر زمانی | اختیاری | مهر زمانیِ دورهای که انتظار میرود نقطه مورد نظر باز/در دسترس باشد. | جودا-تایم فوری |
| پنجره زمان دسترسی - زمان شروع محلی - منطقه زمانی | اختیاری | منطقه زمانی که انتظار میرود نقطه مورد نظر در آن باز/در دسترس باشد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| پنجره زمان دسترسی - زمان پایان محلی - مهر زمان | اختیاری | مهر زمانی دورهای که انتظار میرود نقطه مورد نظر تا آن زمان باز/در دسترس باشد. | جودا-تایم فوری |
| پنجره زمان دسترسی - زمان پایان محلی - منطقه زمانی | اختیاری | منطقه زمانی که انتظار میرود نقطه مورد نظر در آن باز/در دسترس باشد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| نشانها | اختیاری | هر نشان یا متن آزاد (حداکثر ۱۵ کاراکتر) یا تصویر کوچک است. | |
| نشان - متن | اختیاری | عنوان برای نشان توجه: برای نشان، متن یا تصویر الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ۱۵ کاراکتر |
| نشان - تصویر | اختیاری | تصویر کوچک جلوههای ویژه تجربه کاربری، برای مثال به صورت پوشش نشان روی تصویر کوچک تصویر/ویدئو. توجه: برای نشان، متن یا تصویر الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| رتبهبندی - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبهبندی. اگر مقدار فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - ارزش فعلی | اختیاری | مقدار فعلی مقیاس رتبهبندی. اگر حداکثر مقدار رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - تعداد | اختیاری | تعداد امتیازهای مربوط به نقطه مورد نظر. نکته: اگر برنامه شما میخواهد نحوه نمایش این عدد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصری را که میتواند به کاربر نمایش داده شود، ارائه دهید. برای مثال، اگر تعداد ۱,۰۰۰,۰۰۰ است، استفاده از اختصاراتی مانند ۱M را در نظر بگیرید تا در اندازههای کوچکتر صفحه نمایش کوتاه نشود. | رشته |
| رتبهبندی - مقدار شمارش | اختیاری | تعداد امتیازهای مربوط به نقطه مورد نظر. توجه: اگر نمیخواهید خودتان منطق نمایش اختصارات را مدیریت کنید، این فیلد را وارد کنید. اگر هم تعداد و هم مقدار تعداد وجود داشته باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد. | بلند |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی بلیط/کارت ورود به نقطه مورد نظر. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی بلیط/کارت ورود به نقطه مورد نظر. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| دسته بندی محتوا | اختیاری | دسته بندی محتوای موجود در موجودیت را شرح دهید. | فهرست Enumهای واجد شرایط
برای راهنمایی به بخش دستهبندی محتوا مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
RestaurantReservationEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| زمان شروع رزرو محلی - مهر زمان | مورد نیاز | مهر زمانیِ دورهای که انتظار میرود رزرو از آن شروع شود. | جودا-تایم فوری |
| زمان شروع رزرو محلی - منطقه زمانی | مورد نیاز | منطقه زمانی که انتظار میرود رزرو از آن شروع شود. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| مکان - کشور | مورد نیاز | کشوری که رستوران در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - شهر | مورد نیاز | شهری که رستوران در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - نمایش آدرس | مورد نیاز | آدرس رستوران که به کاربر نمایش داده خواهد شد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) رستوران. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - ایالت | اختیاری | ایالت یا استانی (در صورت وجود) که رستوران در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) رستوران. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| موقعیت مکانی - محله | اختیاری | محله رستوران (در صورت وجود). | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| تصاویر پوستر | اختیاری | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| اندازه میز | اختیاری | تعداد افراد در گروه رزرو | عدد صحیح > 0 |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
EventReservationEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| زمان شروع محلی - مهر زمان | مورد نیاز | مهر زمانیِ دورهای که انتظار میرود رویداد در آن شروع شود. | جودا-تایم فوری |
| زمان شروع محلی - منطقه زمانی | مورد نیاز | منطقه زمانی که انتظار میرود رویداد در آن شروع شود. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| حالت رویداد | مورد نیاز | فیلدی برای مشخص کردن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود. | Enum: مجازی، حضوری یا ترکیبی |
| مکان - کشور | مشروط مورد نیاز | کشوری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهایی که IN_PERSON یا HYBRID هستند، الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - شهر | مشروط مورد نیاز | شهری که رویداد در آن اتفاق میافتد. توجه: این مورد برای رویدادهایی که IN_PERSON یا HYBRID هستند، الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - نمایش آدرس | مشروط مورد نیاز | آدرس یا نام مکانی که رویداد در آن برگزار خواهد شد که باید به کاربر نمایش داده شود. توجه: این مورد برای رویدادهایی که IN_PERSON یا HYBRID هستند، الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) مکانی که رویداد در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - ایالت | اختیاری | ایالت یا استانی (در صورت وجود) که رویداد در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) محل برگزاری رویداد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| موقعیت مکانی - محله | اختیاری | محله (در صورت وجود) که رویداد در آن برگزار میشود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| تصاویر پوستر | اختیاری | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: تصویر اکیداً توصیه میشود. در صورت ارائه نشان، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| زمان پایان محلی - مهر زمان | اختیاری | مهر زمانیِ دورهای که انتظار میرود رویداد در آن پایان یابد. | جودا-تایم فوری |
| زمان پایان محلی - منطقه زمانی | اختیاری | منطقه زمانی که انتظار میرود رویداد در آن پایان یابد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| ارائه دهنده خدمات - نام | اختیاری | نام ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات الزامی است. | متن آزاد. به عنوان مثال، نام برگزارکننده رویداد/تور |
| ارائه دهنده خدمات - تصویر | اختیاری | لوگو/تصویر ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| نشانها | اختیاری | هر نشان یا متن آزاد (حداکثر ۱۵ کاراکتر) یا تصویر کوچک است. | |
| نشان - متن | اختیاری | عنوان برای نشان توجه: برای نشان، متن یا تصویر الزامی است. | متن رایگان اندازه متن پیشنهادی: حداکثر ۱۵ کاراکتر |
| نشان - تصویر | اختیاری | تصویر کوچک جلوههای ویژه تجربه کاربری، برای مثال به صورت پوشش نشان روی تصویر کوچک تصویر/ویدئو. توجه: برای نشان، متن یا تصویر الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| شناسه رزرو | اختیاری | شناسه رزرو برای رزرو رویداد. | متن رایگان |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی بلیط/کارت ورود به رویداد. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی بلیط/کارت ورود به رویداد. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| رتبهبندی - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبهبندی. اگر مقدار فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - ارزش فعلی | اختیاری | مقدار فعلی مقیاس رتبهبندی. اگر حداکثر مقدار رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - تعداد | اختیاری | تعداد رتبهبندیهای این رویداد. نکته: اگر برنامه شما میخواهد نحوه نمایش این عدد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصری را که میتواند به کاربر نمایش داده شود، ارائه دهید. برای مثال، اگر تعداد ۱,۰۰۰,۰۰۰ است، استفاده از اختصاراتی مانند ۱M را در نظر بگیرید تا در اندازههای کوچکتر صفحه نمایش کوتاه نشود. | رشته |
| رتبهبندی - مقدار شمارش | اختیاری | تعداد رتبهبندیهای این رویداد. توجه: اگر نمیخواهید خودتان منطق نمایش اختصارات را مدیریت کنید، این فیلد را وارد کنید. اگر هم تعداد و هم مقدار تعداد وجود داشته باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد. | بلند |
| دسته بندی محتوا | اختیاری | دسته بندی محتوای موجود در موجودیت را شرح دهید. | فهرست Enumهای واجد شرایط
برای راهنمایی به بخش دستهبندی محتوا مراجعه کنید. |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
LodgingReservationEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | پیامک رایگان. برای مثال، «اقامت شما از ۱۲ دسامبر» اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| زمان ورود محلی - مهر زمان | مورد نیاز | مهر زمانی عصر که نشان دهنده زمان ورود برای رزرو است. | جودا-تایم فوری |
| زمان ورود محلی - منطقه زمانی | مورد نیاز | منطقه زمانی که زمان ورود برای رزرو در آن قرار دارد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| زمان خروج محلی - مهر زمان | مورد نیاز | مهر زمانی عصر که نشان دهنده زمان خروج برای رزرو است. | جودا-تایم فوری |
| زمان خروج محلی - منطقه زمانی | مورد نیاز | منطقه زمانی که زمان خروج برای رزرو در آن قرار دارد. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| مکان - کشور | مورد نیاز | کشوری که اقامتگاه در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - شهر | مورد نیاز | شهری که اقامتگاه در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - نمایش آدرس | مورد نیاز | آدرسی که به کاربر نمایش داده میشود. یک آدرس مختصر ارائه دهید و در صورت امکان از اختصارات استفاده کنید (برای مثال، "St" برای "Street"، "Ave" برای "Avenue"). این رشته ممکن است بسته به دستگاه و تنظیمات کاربر کوتاه شود. برای شناسایی بهتر، نام شهر را نیز ذکر کنید. | متن رایگان اندازه متن پیشنهادی: حداکثر ~35 کاراکتر |
| مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - ایالت | اختیاری | ایالت یا استانی (در صورت وجود) که محل اقامت در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| موقعیت مکانی - محله | اختیاری | محله (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| تصاویر پوستر | اختیاری | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. توجه: اگر نشان ارائه میشود، فضای امن ۲۴ dps را در بالا و پایین تصویر تضمین کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| شناسه رزرو | اختیاری | شناسه رزرو برای رزرو اقامتگاه. | متن رایگان |
| رتبهبندی - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبهبندی. اگر مقدار فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - ارزش فعلی | اختیاری | مقدار فعلی مقیاس رتبهبندی. اگر حداکثر مقدار رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
| رتبهبندی - تعداد | اختیاری | تعداد امتیازهای مربوط به اقامتگاه. نکته: اگر برنامه شما میخواهد نحوه نمایش این عدد به کاربران را کنترل کند، این فیلد را ارائه دهید. رشته مختصری را که میتواند به کاربر نمایش داده شود، ارائه دهید. برای مثال، اگر تعداد ۱,۰۰۰,۰۰۰ است، استفاده از اختصاراتی مانند ۱M را در نظر بگیرید تا در اندازههای کوچکتر صفحه نمایش کوتاه نشود. | رشته |
| رتبهبندی - مقدار شمارش | اختیاری | تعداد امتیازهای مربوط به اقامتگاه. توجه: اگر نمیخواهید خودتان منطق نمایش اختصارات را مدیریت کنید، این فیلد را وارد کنید. اگر هم تعداد و هم مقدار تعداد وجود داشته باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد. | بلند |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی اقامتگاه. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی اقامتگاه، که در فاکتور خط خورده است. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
TransportationReservationEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | متن آزاد. به عنوان مثال، "SFO به SAN" اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| نوع حمل و نقل | مورد نیاز | روش/نوع حمل و نقل برای رزرو. | Enum: پرواز، قطار، اتوبوس یا کشتی |
| زمان حرکت محلی - مهر زمان | مورد نیاز | مهر زمانیِ عصر که نشان دهنده زمان حرکت است. | جودا-تایم فوری |
| زمان حرکت محلی - منطقه زمانی | مورد نیاز | منطقه زمانی زمان حرکت. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| زمان رسیدن محلی - مهر زمان | مورد نیاز | مهر زمانیِ دوره که نشان دهنده زمان رسیدن است. | جودا-تایم فوری |
| زمان رسیدن محلی - منطقه زمانی | مورد نیاز | منطقه زمانی زمان رسیدن. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| شماره حمل و نقل | مورد نیاز | شماره پرواز، شماره اتوبوس، شماره قطار یا شماره کشتی/سفر دریایی. | متن رایگان |
| زمان سوار شدن محلی - مهر زمان | مورد نیاز | مهر زمانی عصر که نشان دهنده زمان سوار شدن برای رزرو است (در صورت وجود) | جودا-تایم فوری |
| زمان سوار شدن به هواپیما به صورت محلی - منطقه زمانی | مورد نیاز | منطقه زمانی سوار شدن به هواپیما برای رزرو (در صورت وجود) | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| محل عزیمت - کشور | اختیاری | کشور مبدا. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل حرکت - شهر | اختیاری | شهر مبدا. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل حرکت - نمایش آدرس | اختیاری | محل حرکت به کاربر نمایش داده خواهد شد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل حرکت - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل عزیمت - ایالت | اختیاری | ایالت یا استان محل عزیمت (در صورت وجود). | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل حرکت - کد پستی | اختیاری | کد پستی (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل حرکت - محله | اختیاری | محله (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - کشور | اختیاری | کشور ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - شهر | اختیاری | شهر ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - نمایش آدرس | اختیاری | محل رسیدن که به کاربر نمایش داده خواهد شد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - کد پستی | اختیاری | کد پستی (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| محل ورود - محله | اختیاری | محله (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| ارائه دهنده خدمات - نام | اختیاری | نام ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات الزامی است. | متن رایگان. به عنوان مثال، نام شرکت هواپیمایی |
| ارائه دهنده خدمات - تصویر | اختیاری | لوگو/تصویر ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| تصاویر پوستر | اختیاری | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| شناسه رزرو | اختیاری | شناسه رزرو برای رزرو حمل و نقل. | متن رایگان |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی رزرو. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی رزرو، که در رابط کاربری خط خورده است. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
VehicleRentalReservationEntity
| ویژگی | مورد نیاز | توضیحات | قالب |
|---|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به موجودیت در برنامه ارائه دهنده. توجه: میتوانید از لینکهای عمیق برای ارجاع استفاده کنید. به این سوالات متداول مراجعه کنید. | اوری |
| عنوان | مورد نیاز | عنوان نهاد. | متن آزاد. به عنوان مثال، "Avis Union Square SF" اندازه متن پیشنهادی: حداکثر ۵۰ کاراکتر |
| زمان تحویل محلی - مهر زمان | مورد نیاز | مهر زمانی عصر که نشان دهنده زمان تحویل گرفتن رزرو است. | جودا-تایم فوری |
| زمان تحویل محلی - منطقه زمانی | مورد نیاز | منطقه زمانی برای تحویل گرفتن رزرو. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| زمان بازگشت محلی - مهر زمان | اختیاری | مهر زمانی عصر که نشان دهنده زمان خروج برای رزرو است. | جودا-تایم فوری |
| زمان بازگشت محلی - منطقه زمانی | اختیاری | منطقه زمانی زمان خروج برای رزرو. | جودا-زمان تاریخ و زمانمنطقه زمانی برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید. |
| آدرس تحویل - کشور | اختیاری | کشور محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس تحویل - شهر | اختیاری | شهر محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس تحویل - آدرس نمایش داده شده | اختیاری | محل تحویل کالا که به کاربر نمایش داده خواهد شد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس تحویل - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس تحویل - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس تحویل - کد پستی | اختیاری | کد پستی (در صورت وجود) محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس تحویل - محله | اختیاری | محله (در صورت وجود) محل تحویل گرفتن. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - کشور | اختیاری | کشور محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - شهر | اختیاری | شهر محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - آدرس نمایش داده شده | اختیاری | مکان بازگشتی که به کاربر نمایش داده خواهد شد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - کد پستی | اختیاری | کد پستی (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| آدرس برگشت - محله | اختیاری | محله (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
| ارائه دهنده خدمات - نام | اختیاری | نام ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات الزامی است. | متن رایگان. به عنوان مثال، "اجاره خودرو Avis" |
| ارائه دهنده خدمات - تصویر | اختیاری | لوگو/تصویر ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات الزامی است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| تصاویر پوستر | اختیاری | در صورت ارائه چندین تصویر، فقط ۱ تصویر نمایش داده میشود. نسبت تصویر توصیه شده ۱۶:۹ است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
| توضیحات | اختیاری | یک پاراگراف متن برای توصیف موجودیت. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: ۱۸۰ کاراکتر |
| فهرست زیرنویسها | اختیاری | حداکثر ۳ زیرنویس، که هر زیرنویس شامل یک خط متن است. توجه: یا توضیحات یا فهرست زیرنویسها به کاربر نمایش داده میشود، نه هر دو. | متن رایگان اندازه متن پیشنهادی برای هر زیرنویس: حداکثر ۵۰ کاراکتر |
| شناسه تأیید | اختیاری | شناسه تأیید رزرو اجاره خودرو. | متن رایگان |
| قیمت - قیمت فعلی | مشروط مورد نیاز | قیمت فعلی رزرو. در صورت ارائه قیمت خط خورده، باید ارائه شود. | متن رایگان |
| قیمت - قیمت ضربدری | اختیاری | قیمت اصلی رزرو، که در رابط کاربری خط خورده است. | متن رایگان |
| اطلاع از قیمت | اختیاری | اعلام قیمت برای ارائه تخفیف ویژه، رویداد، و تخفیف برای اعضا، در صورت وجود. | متن رایگان اندازه متن پیشنهادی: کمتر از ۴۵ کاراکتر (متن خیلی طولانی ممکن است بیضی نشان دهد) |
| DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید | |||
| شروع مهر زمانی | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا باید روی سطح نمایش داده شود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
| مهر زمان پایان | اختیاری | مهر زمانیِ دورهای که پس از آن محتوا دیگر روی سطح نمایش داده نمیشود. اگر تنظیم نشده باشد، محتوا واجد شرایط نمایش روی سطح است. | مهر زمانی عصر بر حسب میلی ثانیه |
مشخصات تصویر
مشخصات مورد نیاز برای تصاویر در این جدول ذکر شده است:
| نسبت ابعاد | حداقل پیکسلها | پیکسلهای توصیهشده |
|---|---|---|
مربع (۱x۱) ترجیحی | ۳۰۰x۳۰۰ | ۱۲۰۰x۱۲۰۰ |
| منظره (۱.۹۱x۱) | ۶۰۰x۳۱۴ | ۱۲۰۰x۶۲۸ |
| پرتره (۴x۵) | ۴۸۰x۶۰۰ | ۹۶۰x۱۲۰۰ |
تصاویر باید روی CDN های عمومی میزبانی شوند تا گوگل بتواند به آنها دسترسی داشته باشد.
فرمتهای فایل
PNG، JPG، GIF ثابت، WebP
حداکثر اندازه فایل
۵۱۲۰ کیلوبایت
توصیههای اضافی
- ناحیه امن تصویر: محتوای مهم خود را در مرکز ۸۰٪ تصویر قرار دهید.
- از یک پسزمینه شفاف استفاده کنید تا تصویر در تنظیمات تم تیره و روشن به درستی نمایش داده شود.
مشخصات منطقه زمانی
شناسه (مثلاً "America/Los_Angeles") را به آفست (مثلاً "-07:00") ترجیح دهید.
نمونه کاربرد: DateTimeZone.forID("America/Los_Angeles")
دسته بندی محتوا
دستهبندی محتوا به برنامهها اجازه میدهد تا محتوای متعلق به چندین دستهبندی را منتشر کنند. این دستهبندی، محتوا را با برخی از دستهبندیهای از پیش تعریفشده، مانند موارد زیر، مرتبط میکند:
-
TYPE_EDUCATION -
TYPE_SPORTS -
TYPE_MOVIES_AND_TV_SHOWS -
TYPE_BOOKS -
TYPE_AUDIOBOOKS -
TYPE_MUSIC -
TYPE_DIGITAL_GAMES -
TYPE_TRAVEL_AND_LOCAL -
TYPE_HOME_AND_AUTO -
TYPE_BUSINESS -
TYPE_NEWS -
TYPE_FOOD_AND_DRINK -
TYPE_SHOPPING -
TYPE_HEALTH_AND_FITENESS -
TYPE_MEDICAL -
TYPE_PARENTING -
TYPE_DATING
تصاویر باید روی CDN های عمومی میزبانی شوند تا گوگل بتواند به آنها دسترسی داشته باشد.
دستورالعملهای استفاده از دستهبندیهای محتوا
- برخی از موجودیتها مانند ArticleEntity و GenericFeaturedEntity واجد شرایط استفاده از هر یک از دستهبندیهای محتوا هستند. برای موجودیتهای دیگر مانند EventEntity ، EventReservationEntity ، PointOfInterestEntity ، فقط زیرمجموعهای از این دستهبندیها واجد شرایط هستند. قبل از پر کردن لیست، لیست دستهبندیهای واجد شرایط برای یک نوع موجودیت را بررسی کنید.
برای برخی از دستههای محتوا، به جای ترکیبی از موجودیتهای عمومی و دسته محتوا، از نوع موجودیت خاص استفاده کنید:
- نوع_فیلمها_و_نمایشهای_تلویزیون - قبل از استفاده از موجودیتهای عمومی، موجودیتهای موجود در راهنمای ادغام Watch را بررسی کنید.
- TYPE_BOOKS - قبل از استفاده از موجودیتهای عمومی ، EbookEntity را بررسی کنید.
- TYPE_AUDIOBOOKS - قبل از استفاده از موجودیتهای عمومی، AudiobookEntity را بررسی کنید.
- TYPE_SHOPPING - قبل از استفاده از موجودیتهای عمومی ، ShoppingEntity را بررسی کنید.
- نوع غذا و نوشیدنی - قبل از استفاده از موجودیتهای عمومی، موجودیتها را از راهنمای ادغام غذا بررسی کنید.
فیلد ContentCategory اختیاری است و اگر محتوا به هیچ یک از دستههای ذکر شده قبلی تعلق ندارد، باید خالی گذاشته شود.
در صورتی که چندین دسته محتوا ارائه شده باشد، آنها را به ترتیب ارتباط با محتوا ارائه دهید و مرتبطترین دسته محتوا در ابتدا قرار گیرد.
مرحله ۲: ارائه دادههای خوشهای
توصیه میشود که کار انتشار محتوا در پسزمینه اجرا شود (برای مثال، با استفاده از WorkManager ) و به صورت منظم یا بر اساس یک رویداد (مثلاً هر بار که کاربر برنامه را باز میکند یا وقتی کاربر چیزی را به سبد خرید خود اضافه میکند) برنامهریزی شود.
AppEngageTravelClient مسئول انتشار خوشهها است.
API های زیر برای انتشار خوشه ها در کلاینت وجود دارد:
-
isServiceAvailable -
publishRecommendationClusters -
publishFeaturedCluster -
publishReservationCluster -
publishContinueSearchCluster -
publishUserAccountManagementRequest -
updatePublishStatus -
deleteRecommendationsClusters -
deleteFeaturedCluster -
deleteReservationCluster -
deleteContinueSearchCluster -
deleteUserManagementCluster -
deleteClusters
isServiceAvailable
این API برای بررسی اینکه آیا سرویس برای ادغام در دسترس است و آیا محتوا میتواند روی دستگاه ارائه شود، استفاده میشود.
کاتلین
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
این API برای انتشار فهرستی از اشیاء 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
این API برای انتشار فهرستی از اشیاء FeaturedCluster استفاده میشود.
کاتلین
client.publishFeaturedCluster(
PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
جاوا
client.publishFeaturedCluster(
new PublishFeaturedClustersRequest.Builder()
.addFeaturedCluster(
new FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
وقتی سرویس درخواست را دریافت میکند، اقدامات زیر در یک تراکنش انجام میشود:
- دادههای
FeaturedClusterموجود از شریک توسعهدهنده حذف میشوند. - دادههای حاصل از درخواست، تجزیه و تحلیل شده و در Featured Cluster بهروزرسانیشده ذخیره میشوند.
در صورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
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
این API برای انتشار فهرستی از اشیاء 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
این API برای انتشار کارت ورود به سیستم استفاده میشود. عمل ورود به سیستم، کاربران را به صفحه ورود به سیستم برنامه هدایت میکند تا برنامه بتواند محتوا را منتشر کند (یا محتوای شخصیسازیشدهتری ارائه دهد).
فرادادههای زیر بخشی از کارت ورود به سیستم هستند -
| ویژگی | مورد نیاز | توضیحات |
|---|---|---|
| اکشن اوری | مورد نیاز | پیوند عمیق به اقدام (یعنی به صفحه ورود به برنامه هدایت میشود) |
| تصویر | اختیاری - در صورت عدم ارائه، عنوان باید ارائه شود | تصویر نشان داده شده روی کارت تصاویر با نسبت تصویر ۱۶x۹ و وضوح تصویر ۱۲۶۴x۷۱۲ |
| عنوان | اختیاری - در صورت عدم ارائه، تصویر باید ارائه شود | عنوان روی کارت |
| متن اکشن | اختیاری | متن نمایش داده شده در فراخوان عمل (مثلاً ورود) |
| زیرنویس | اختیاری | زیرنویس اختیاری روی کارت |
کاتلین
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
اگر به هر دلیل داخلی تجاری، هیچ یک از کلاسترها منتشر نشدهاند، اکیداً توصیه میکنیم وضعیت انتشار را با استفاده از API مربوط به updatePublishStatus بهروزرسانی کنید. این مهم است زیرا:
- ارائه وضعیت در همه سناریوها، حتی زمانی که محتوا منتشر شده است (وضعیت == منتشر شده)، برای پر کردن داشبوردهایی که از این وضعیت صریح برای انتقال سلامت و سایر معیارهای ادغام شما استفاده میکنند، بسیار مهم است.
- اگر هیچ محتوایی منتشر نشده باشد اما وضعیت ادغام خراب نباشد (STATUS == NOT_PUBLISHED)، گوگل میتواند از نمایش هشدارها در داشبوردهای سلامت برنامه جلوگیری کند. این تأیید میکند که محتوا به دلیل وضعیت مورد انتظار از دیدگاه ارائهدهنده منتشر نشده است.
- این به توسعهدهندگان کمک میکند تا بینشی در مورد زمان انتشار دادهها در مقابل عدم انتشار آنها ارائه دهند.
- گوگل ممکن است از کدهای وضعیت برای ترغیب کاربر به انجام اقدامات خاص در برنامه استفاده کند تا بتواند محتوای برنامه را ببیند یا از آن عبور کند.
لیست کدهای وضعیت انتشار واجد شرایط عبارتند از:
// 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
اگر محتوا به دلیل عدم ورود کاربر منتشر نشود، گوگل انتشار کارت ورود به سیستم را توصیه میکند. اگر به هر دلیلی ارائه دهندگان خدمات قادر به انتشار کارت ورود به سیستم نیستند، توصیه میکنیم API مربوط به updatePublishStatus را با کد وضعیت NOT_PUBLISHED_REQUIRES_SIGN_IN فراخوانی کنید.
کاتلین
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());
deleteRecommendationClusters
این API برای حذف محتوای خوشههای توصیه استفاده میشود.
کاتلین
client.deleteRecommendationClusters()
جاوا
client.deleteRecommendationClusters();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از خوشههای توصیه حذف میکند. در صورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteFeaturedCluster
این API برای حذف محتوای Featured Cluster استفاده میشود.
کاتلین
client.deleteFeaturedCluster()
جاوا
client.deleteFeaturedCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از Featured Cluster حذف میکند. در صورت بروز خطا، کل درخواست رد شده و وضعیت موجود حفظ میشود.
deleteReservationCluster
این API برای حذف محتوای Reservation Cluster استفاده میشود.
کاتلین
client.deleteReservationCluster()
جاوا
client.deleteReservationCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از Reservation Cluster حذف میکند. در صورت بروز خطا، کل درخواست رد شده و وضعیت موجود حفظ میشود.
deleteUserManagementCluster
این API برای حذف محتوای کلاستر UserAccountManagement استفاده میشود.
کاتلین
client.deleteUserManagementCluster()
جاوا
client.deleteUserManagementCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از کلاستر UserAccountManagement حذف میکند. در صورت بروز خطا، کل درخواست رد شده و وضعیت موجود حفظ میشود.
deleteContinueSearchCluster
این API برای حذف محتوای Continue Search Cluster استفاده میشود.
کاتلین
client.deleteContinueSearchCluster()
جاوا
client.deleteContinueSearchCluster();
وقتی سرویس درخواست را دریافت میکند، دادههای موجود را از خوشه جستجوی ادامه حذف میکند. در صورت بروز خطا، کل درخواست رد میشود و وضعیت موجود حفظ میشود.
deleteClusters
این API برای حذف محتوای یک نوع خوشه داده شده استفاده میشود.
کاتلین
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 | اجرای وظیفه به دلیل مشکلات نخبندی (threading) با شکست مواجه شد. در این صورت، میتوان آن را دوباره امتحان کرد. |
4 | SERVICE_CALL_PERMISSION_DENIED | تماس گیرنده مجاز به برقراری تماس خدماتی نیست. |
5 | SERVICE_CALL_INVALID_ARGUMENT | درخواست شامل دادههای نامعتبر است (برای مثال، بیش از تعداد مجاز خوشهها). |
6 | SERVICE_CALL_INTERNAL | در سمت سرویس خطایی رخ داده است. |
7 | SERVICE_CALL_RESOURCE_EXHAUSTED | تماس با سرویس خیلی زیاد انجام میشود. |
مرحله ۳: مدیریت اهداف پخش
علاوه بر فراخوانیهای API مربوط به انتشار محتوا از طریق یک job، لازم است یک BroadcastReceiver نیز راهاندازی شود تا درخواست انتشار محتوا را دریافت کند.
هدف از اعلانهای هدف عمدتاً فعالسازی مجدد برنامه و همگامسازی اجباری دادهها است. اعلانهای هدف برای ارسال مکرر طراحی نشدهاند. این اعلانها فقط زمانی فعال میشوند که سرویس Engage تشخیص دهد محتوا ممکن است قدیمی باشد (مثلاً یک هفته قدیمی). به این ترتیب، حتی اگر برنامه برای مدت طولانی اجرا نشده باشد، اطمینان بیشتری وجود دارد که کاربر میتواند تجربه محتوای جدیدی داشته باشد.
BroadcastReceiver باید به دو روش زیر تنظیم شود:
با استفاده از
Context.registerReceiver()یک نمونه از کلاسBroadcastReceiverرا به صورت پویا ثبت کنید. این کار امکان ارتباط از برنامههایی را که هنوز در حافظه فعال هستند، فراهم میکند.
کاتلین
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خود تعریف کنید. این به برنامه اجازه میدهد تا در زمانی که در حال اجرا نیست، اهداف پخش (broadcast intents) را دریافت کند و همچنین به برنامه اجازه میدهد تا محتوا را منتشر کند.
<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توصیه میشود هنگام دریافت این intent، یک فراخوانیpublishRecommendationClustersآغاز شود. -
com.google.android.engage.action.PUBLISH_FEATUREDتوصیه میشود هنگام دریافت این intent، یک فراخوانیpublishFeaturedClusterآغاز شود. -
com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCHتوصیه میشود هنگام دریافت این intent، یک فراخوانیpublishContinueSearchClusterآغاز شود. -
com.google.android.engage.action.travel.PUBLISH_RESERVATIONتوصیه میشود هنگام دریافت این intent، یک فراخوانیpublishReservationClusterآغاز شود.
گردش کار یکپارچهسازی
برای راهنمای گام به گام تأیید ادغام پس از تکمیل، به گردش کار ادغام توسعهدهنده مراجعه کنید.
سوالات متداول
برای سوالات متداول به بخش سوالات متداول Engage SDK مراجعه کنید.
تماس
در صورت وجود هرگونه سوال در طول فرآیند ادغام، engage-developers@google.com تماس بگیرید.
مراحل بعدی
پس از تکمیل این ادغام، مراحل بعدی به شرح زیر است:
- یک ایمیل به
engage-developers@google.comارسال کنید و APK یکپارچه خود را که آماده آزمایش توسط گوگل است، پیوست کنید. - گوگل یک بررسی داخلی انجام میدهد تا مطمئن شود که ادغام طبق انتظار کار میکند. در صورت نیاز به تغییرات، گوگل با شما تماس میگیرد و جزئیات لازم را ارائه میدهد.
- وقتی آزمایش کامل شد و نیازی به تغییر نبود، گوگل با شما تماس میگیرد تا به شما اطلاع دهد که میتوانید APK بهروزرسانیشده و یکپارچهشده را در فروشگاه Play منتشر کنید.
- پس از اینکه گوگل تأیید کرد که APK بهروزرسانیشده شما در فروشگاه Play منتشر شده است، خوشههای توصیه ، ویژه ، رزرو و ادامه جستجو ممکن است منتشر شده و برای کاربران قابل مشاهده باشند.