Google در حال ساخت یک سطح روی دستگاه است که برنامه های کاربران را بر اساس عمودی سازماندهی می کند و یک تجربه همهجانبه جدید را برای مصرف شخصی و کشف محتوای برنامه امکان پذیر می کند. این تجربه تمام صفحه به شرکای توسعهدهنده فرصتی میدهد تا بهترین محتوای غنی خود را در یک کانال اختصاصی خارج از برنامه خود به نمایش بگذارند.
این سند حاوی دستورالعملهایی برای شرکای توسعهدهنده است تا محتوای جدیدی مانند رزرواسیون، رویدادها، مکانهای اقامتی، مکانهای دیدنی، افراد و سایر محتواها را ادغام کنند. با استفاده از Engage SDK برای پر کردن این سطح جدید، ممکن است به هیچ یک از این دستهها تعلق نداشته باشند.
جزئیات یکپارچه سازی
اصطلاحات
این ادغام شامل سه نوع خوشه زیر است: توصیه ، ویژه و ادامه .
خوشههای توصیه ، پیشنهادهای شخصیشده از یک شریک توسعهدهنده را نشان میدهند. این یک نمای رابط کاربری است که شامل گروهی از توصیههای یک شریک توسعهدهنده است.
ArticleEntity : ArticleEntity که یک توصیه مبتنی بر متن برای محتوای مرتبط با بیش از یک دسته محتوا را نشان می دهد. آیتم ArticleEntity به توسعه دهندگان این امکان را می دهد که محتوای متنی و تصویری متنوعی را با ابرداده های بیشتری برای بیان اطلاعات به کاربران در مقایسه با GenericFeaturedEntity ارائه دهند. مثال: محتوای بازاریابی، قطعه خبر
EventEntity : EventEntity نشان دهنده رویدادی است که در آینده اتفاق می افتد. زمان شروع رویداد یک بخش مهم از اطلاعات است که باید به کاربران منتقل شود.
LodgingEntity : LodgingEntity نشان دهنده محل اقامتی مانند هتل، آپارتمان، خانه تعطیلات برای اجاره کوتاه مدت و بلند مدت است.
StoreEntity : StoreEntity یک فروشگاه، رستوران، کافه و غیره را نشان میدهد. محتوایی را که در آن مکان غذاخوری یا فروشگاه، بخش مهمی از اطلاعات است که باید به کاربران منتقل شود، برجسته میکند.
PointOfInterestEntity : PointOfInterestEntity نشان دهنده مکان مورد علاقه مانند، پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه توریستی، مسیر پیاده روی و غیره است. محتوایی را برجسته می کند که در آن مکان یک قطعه اطلاعات مهم است که باید به کاربران منتقل شود. نباید برای اقامت، فروشگاه یا محل غذاخوری استفاده شود.
PersonEntity : PersonEntity نماینده یک شخص است. توصیهها میتواند برجسته کردن یک فرد در دستههایی مانند سلامت و تناسب اندام، ورزش، دوستیابی و غیره باشد.
خوشه Continuation محتوایی را نشان میدهد که اخیراً توسط کاربران چند شریک توسعهدهنده در یک گروه UI واحد درگیر شده است. هر شریک توسعه دهنده مجاز است حداکثر 10 موجودیت را در خوشه Continuation پخش کند.
محتوای ادامه شما می تواند ساختار زیر را داشته باشد:
ArticleEntity : ArticleEntity که یک توصیه مبتنی بر متن برای محتوای مرتبط با بیش از یک دسته محتوا را نشان می دهد. این موجودیت می تواند برای نشان دادن مقالات خبری ناتمام یا سایر محتوایی که کاربر مایل است از جایی که آن را ترک کرده است به مصرف خود ادامه دهد، استفاده شود. مثال: محتوای بازاریابی، قطعه خبر
RestaurantReservationEntity : RestaurantReservationEntity نشان دهنده رزرو یک رستوران یا کافه است و به کاربران کمک می کند تا رزروهای رستوران آتی یا در حال انجام را پیگیری کنند.
EventReservationEntity : EventReservationEntity یک رزرو برای یک رویداد را نشان می دهد و به کاربران کمک می کند رزرو رویدادهای آینده یا در حال انجام را پیگیری کنند. رویدادها می توانند شامل موارد زیر باشند، اما نه محدود به آنها:
- رویدادهای ورزشی مانند رزرو برای یک مسابقه فوتبال
- رویدادهای بازی مانند رزرو برای ورزش های الکترونیکی
- رویدادهای سرگرمی مانند رزرو فیلم در سینما، کنسرت، تئاتر، امضای کتاب
- رزرو سفر یا نقاط مورد علاقه مانند تورهای راهنما، بلیط موزه
- اجتماعی / سمینار / کنفرانس ها رزرو
- آموزش / رزرو جلسات آموزشی
LodgingReservationEntity : LodgingEntityReservation نشاندهنده رزرو اقامتگاه مسافرتی است و به کاربران کمک میکند رزروهای آتی یا جاری هتل یا تعطیلات را ردیابی کنند.
TransportationReservationEntity : TransportationReservationEntity نشان دهنده یک رزرو برای حمل و نقل با هر حالتی است و به کاربران کمک می کند تا رزروهای مربوط به پرواز، کشتی، قطار، اتوبوس، سواری-تگرگ یا کروز آینده یا جاری را پیگیری کنند.
VehicleRentalReservationEntity : VehicleRentalReservationEntity یک رزرو خودروی اجاره ای را نشان می دهد و به کاربران کمک می کند تا رزروهای اجاره خودروی آینده یا در حال انجام را پیگیری کنند.
خوشه Featured یک نمای رابط کاربری است که قهرمان انتخاب شده
GenericFeaturedEntity
از بسیاری از شرکای توسعه دهنده در یک گروه UI به نمایش می گذارد. یک خوشه ویژه وجود دارد که در نزدیکی بالای رابط کاربری ظاهر شده است، با اولویت بالاتر از همه خوشههای توصیه. هر شریک توسعهدهنده مجاز است یک موجودیت واحد از نوع پشتیبانیشده را در «ویژگیها» با تعداد زیادی نهاد (احتمالاً از انواع مختلف) از چندین برنامهنویس برنامه در خوشه ویژه پخش کند.GenericFeaturedEntity : GenericFeaturedEntity با آیتم توصیه تفاوت دارد زیرا آیتم Featured باید برای یک محتوای برتر از توسعه دهندگان استفاده شود و باید مهمترین محتوایی را نشان دهد که برای کاربران جالب و مرتبط باشد.
قبل از کار
حداقل سطح API: 19
کتابخانه 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.2'
}
خلاصه
طراحی بر اساس اجرای یک سرویس محدود است.
دادههایی که مشتری میتواند منتشر کند مشمول محدودیتهای زیر برای انواع مختلف خوشه است:
نوع خوشه | محدودیت های خوشه ای | حداقل محدودیت موجودیت در یک خوشه | حداکثر محدودیت موجودیت در یک خوشه |
---|---|---|---|
خوشه(های) توصیه | حداکثر 5 | حداقل 5 | حداکثر 25 ( ArticleEntity ، EventEntity ، LodgingEntity ، StoreEntity ، PointOfInterestEntity ، یا PersonEntity ) |
خوشه ادامه | حداکثر 1 | حداقل 1 | حداکثر 10 ( ArticleEntity ، EventReservationEntity ، LodgingReservationEntity ، TransportationReservationEntity ، یا VehicleRentalReservationEntity ) |
خوشه ویژه | حداکثر 1 | حداقل 1 | حداکثر 10 ( GenericFeaturedEntity ) |
مرحله 1: داده های موجودیت را ارائه دهید
SDK موجودیت های مختلفی را برای نشان دادن هر نوع مورد تعریف کرده است. ما نهادهای زیر را برای دسته دیگر پشتیبانی می کنیم:
-
GenericFeaturedEntity
-
ArticleEntity
-
EventEntity
-
LodgingEntity
-
StoreEntity
-
PointOfInterestEntity
-
PersonEntity
-
RestaurantReservationEntity
-
EventReservationEntity
-
LodgingReservationEntity
-
TransportationReservationEntity
-
VehicleRentalReservationEntity
نمودارهای زیر ویژگی ها و الزامات موجود برای هر نوع را مشخص می کند.
GenericFeaturedEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
تصاویر پوستر | مورد نیاز | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
عنوان | اختیاری | عنوان نهاد. | متن رایگان اندازه متن پیشنهادی: 50 کاراکتر |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. درمان ویژه UX در بالای تصویر/فیلم، به عنوان مثال، به عنوان همپوشانی نشان روی تصویر
| |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
دسته بندی های محتوا | اختیاری | دسته بندی محتوا را در موجودیت توضیح دهید. | فهرست Enums برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید. |
ArticleEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | متن رایگان اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
تصاویر پوستر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
منبع - عنوان | اختیاری | نام نویسنده، سازمان یا گزارشگر | متن رایگان اندازه متن پیشنهادی: زیر 25 کاراکتر |
منبع - تصویر | اختیاری | تصویری از منبع مانند نویسنده، سازمان، گزارشگر | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. درمان ویژه UX در بالای تصویر/ویدئو، به عنوان مثال به عنوان پوشش نشان روی تصویر
| |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
زمان انتشار محتوا | اختیاری | این مهر زمانی در میلی ثانیه در زمانی است که محتوا در برنامه منتشر شد/بهروزرسانی شد. | مهر زمانی دوره در میلی ثانیه |
آخرین زمان نامزدی | مشروط مورد نیاز است | مهر زمانی دوره در میلی ثانیه زمانی که کاربر آخرین بار با این موجودیت تعامل داشت. توجه: اگر این موجودیت بخشی از خوشه ادامه باشد، این فیلد ضروری است. | مهر زمانی دوره در میلی ثانیه |
درصد پیشرفت | مشروط مورد نیاز است | درصد محتوای کامل مصرف شده توسط کاربر تا به امروز. توجه: اگر این موجودیت بخشی از خوشه ادامه باشد، این فیلد ضروری است. | مقدار int بین 0 تا 100 شامل. |
دسته بندی های محتوا | اختیاری | دسته بندی محتوا را در موجودیت توضیح دهید. | فهرست Enums برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید. |
EventEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
زمان شروع | مورد نیاز | مهر زمانی دورانی که انتظار می رود رویداد شروع شود. توجه: این در میلی ثانیه نمایش داده می شود. | مهر زمانی دوره در میلی ثانیه |
حالت رویداد | مورد نیاز | فیلدی برای نشان دادن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود. | تعداد: VIRTUAL، IN_PERSON، یا HYBRID |
تصاویر پوستر | مورد نیاز | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
مکان - کشور | مشروط مورد نیاز است | کشوری که رویداد در آن رخ می دهد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | مشروط مورد نیاز است | شهری که رویداد در آن اتفاق می افتد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | مشروط مورد نیاز است | آدرس یا نام محل برگزاری رویداد که باید به کاربر نمایش داده شود. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) مکانی که رویداد در آن میزبانی می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت یا استان (در صورت وجود) که رویداد در آن میزبانی می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) مکانی که رویداد در آن میزبانی می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله ای (در صورت وجود) که رویداد در آن برگزار می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
زمان پایان | اختیاری | مهر زمانی دوره ای که انتظار می رود رویداد به پایان برسد. توجه: این در میلی ثانیه نمایش داده می شود. | مهر زمانی دوره در میلی ثانیه |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. | |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی بلیط/گذرنامه برای رویداد. در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی بلیط/گذرنامه برای رویداد. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
دسته بندی های محتوا | اختیاری | دسته بندی محتوا را در موجودیت توضیح دهید. | فهرست فهرست های واجد شرایط
برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید. |
LodgingEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
تصاویر پوستر | مورد نیاز | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
مکان - کشور | مورد نیاز | کشوری که اقامت در آن اتفاق می افتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | مورد نیاز | شهری که در آن اقامتگاه اتفاق می افتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | مورد نیاز | آدرس اقامتگاهی که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت یا استان (در صورت وجود) که اقامتگاه در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) اقامتگاه. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. | |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
AvailabilityTimeWindow - زمان شروع | اختیاری | زمانی که انتظار میرود اقامتگاه باز/در دسترس باشد، مهر زمانی دوره در میلیثانیه است. | مهر زمانی دوره در میلی ثانیه |
AvailabilityTimeWindow - زمان پایان | اختیاری | مهر زمانی دوره در میلی ثانیه که انتظار میرود اقامتگاه باز/در دسترس باشد. | مهر زمانی دوره در میلی ثانیه |
رتبه - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه - ارزش فعلی | اختیاری | ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه بندی - شمارش | اختیاری | شمارش رتبه بندی برای اقامتگاه. توجه: اگر برنامه شما نحوه نمایش تعداد به کاربران را کنترل میکند، این قسمت را وارد کنید. از یک رشته مختصر استفاده کنید. به عنوان مثال، اگر تعداد 1,000,000 باشد، از مخففهایی مانند 1M استفاده کنید تا این تعداد در اندازههای نمایشگر کوچکتر کوتاه نشود. | رشته |
رتبه بندی - مقدار شمارش | اختیاری | شمارش رتبه بندی برای اقامتگاه. توجه: اگر خودتان منطق مخفف نمایشگر را مدیریت نمیکنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، تعداد به کاربران نمایش داده می شود. | طولانی |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی اقامتگاه در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی اقامتگاه، که در UI مشخص شده است. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
StoreEntity
شی StoreEntity
نشان دهنده یک فروشگاه فردی است که شرکای توسعه دهنده می خواهند منتشر کنند، مانند یک رستوران یا یک فروشگاه مواد غذایی.
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
تصاویر پوستر | مورد نیاز | حداقل یک تصویر باید ارائه شود. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | اختیاری | نام فروشگاه. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
مکان | اختیاری | موقعیت فروشگاه. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
فراخوانی | اختیاری | فراخوانی برای ارائه تبلیغات، رویداد یا بهروزرسانی برای فروشگاه، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
چاپ ریز چاپ | اختیاری | متن چاپ دقیق برای فراخوانی. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
توضیحات | اختیاری | توضیحات فروشگاه | متن رایگان اندازه متن توصیه شده: کمتر از 90 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
رتبه - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه - ارزش فعلی | اختیاری | ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه بندی - شمارش | اختیاری | شمارش رتبه بندی برای اقامتگاه. توجه: اگر برنامه شما میخواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازههای نمایشگر کوچکتر کوتاه نشود. | رشته |
رتبه بندی - مقدار شمارش | اختیاری | شمارش رتبه بندی برای اقامتگاه. توجه: اگر نمیخواهید منطق مخفف نمایش را خودتان مدیریت کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد | طولانی |
PointOfInterestEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
تصاویر پوستر | مورد نیاز | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
مکان - کشور | مورد نیاز | کشوری که نقطه مورد علاقه در آن اتفاق می افتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | مورد نیاز | شهری که نقطه دیدنی در آن اتفاق می افتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | مورد نیاز | آدرس نقطه مورد علاقه که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) نقطه مورد علاقه. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت یا استان (در صورت وجود) که نقطه مورد نظر در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) نقطه مورد علاقه. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله (در صورت وجود) نقطه مورد علاقه. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
AvailabilityTimeWindow - زمان شروع | اختیاری | زمانی که انتظار میرود نقطه مورد نظر باز/در دسترس باشد، مهر زمانی دوره در میلیثانیه است. | مهر زمانی دوره در میلی ثانیه |
AvailabilityTimeWindow - زمان پایان | اختیاری | مهر زمانی دوره در میلی ثانیه که انتظار می رود نقطه مورد نظر باز/در دسترس باشد. | مهر زمانی دوره در میلی ثانیه |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. | |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
رتبه - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه - ارزش فعلی | اختیاری | ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه بندی - شمارش | اختیاری | شمارش رتبه بندی برای نقطه مورد علاقه. توجه: اگر برنامه شما نحوه نمایش تعداد به کاربران را کنترل میکند، این قسمت را وارد کنید. از یک رشته مختصر استفاده کنید. به عنوان مثال، اگر تعداد 1,000,000 باشد، از مخففهایی مانند 1M استفاده کنید تا این تعداد در اندازههای نمایشگر کوچکتر کوتاه نشود. | رشته |
رتبه بندی - مقدار شمارش | اختیاری | شمارش رتبه بندی برای نقطه مورد علاقه. توجه: اگر خودتان از منطق اختصارات نمایشگر استفاده نمی کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، تعداد به کاربران نمایش داده می شود | طولانی |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی بلیت / مجوز ورود برای نقطه مورد علاقه. در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی بلیط / مجوز ورود برای نقطه مورد علاقه. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
دسته بندی های محتوا | اختیاری | دسته بندی محتوا را در موجودیت توضیح دهید. | فهرست فهرست های واجد شرایط
برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید. |
PersonEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
مشخصات - نام | مورد نیاز | نام یا شناسه یا دسته نمایه، به عنوان مثال "John Doe"، "@TeamPixel"، و غیره. | رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
نمایه - آواتار | مورد نیاز | تصویر نمایه یا تصویر آواتار کاربر. توجه: تصویر باید مربع 1:1 باشد. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
نمایه - متن اضافی | اختیاری | متن رایگان مانند دسته پروفایل. | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نمایه - تصویر اضافی | اختیاری | تصویر کوچک مانند نشان تأیید شده. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
تصویر هدر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
محبوبیت - شمارش | اختیاری | تعداد فالوورها یا مقدار محبوبیت را نشان دهید، به عنوان مثال - "3.7 M". توجه: اگر تعداد و مقدار تعداد هر دو ارائه شده باشد، از شمارش استفاده می شود | رشته اندازه متن توصیه شده: حداکثر 20 کاراکتر برای تعداد + برچسب ترکیب شده است |
محبوبیت - مقدار شمارش | اختیاری | تعداد فالوورها یا ارزش محبوبیت. توجه: اگر برنامه شما نمیخواهد منطقی در مورد نحوه بهینهسازی یک عدد بزرگ برای اندازههای مختلف نمایشگر انجام دهد، مقدار شمارش را ارائه دهید. اگر تعداد و مقدار تعداد هر دو ارائه شده باشد، از شمارش استفاده می شود. | طولانی |
محبوبیت - برچسب | اختیاری | برچسب محبوبیت را مشخص کنید. به عنوان مثال - "پسند". | رشته اندازه متن توصیه شده: حداکثر 20 کاراکتر برای تعداد + برچسب ترکیب شده است |
محبوبیت - بصری | اختیاری | مشخص کنید که این تعامل برای چیست. به عنوان مثال - تصویری که نماد Likes، Emojis را نشان می دهد. می تواند بیش از 1 تصویر ارائه دهد، اگرچه ممکن است همه آنها در همه عوامل شکل نشان داده نشوند. توجه: تصویر باید مربع 1:1 باشد | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
رتبه - حداکثر مقدار | مورد نیاز | حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه - ارزش فعلی | مورد نیاز | ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه بندی - شمارش | اختیاری | تعداد رتبهبندیها برای نهاد. توجه: اگر برنامه شما میخواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازههای نمایشگر کوچکتر کوتاه نشود. | رشته |
رتبه بندی - مقدار شمارش | اختیاری | تعداد رتبهبندیها برای نهاد. توجه: اگر نمیخواهید منطق مخفف نمایش را خودتان مدیریت کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد | طولانی |
مکان - کشور | اختیاری | کشوری که فرد در آن قرار دارد یا در حال خدمت است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | اختیاری | شهری که فرد در آن قرار دارد یا در آن خدمت می کند. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | اختیاری | آدرسی که شخص در آن قرار دارد یا در آن خدمت می کند به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) جایی که فرد در آن واقع شده یا در حال خدمت است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت (در صورت وجود) جایی که فرد در آن قرار دارد یا در حال خدمت است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) جایی که شخص در آن قرار دارد یا در حال خدمت است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله ای (در صورت وجود) که فرد در آن قرار دارد یا در حال خدمت است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. | |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
دسته بندی های محتوا | اختیاری | دسته بندی محتوا را در موجودیت توضیح دهید. | فهرست فهرست های واجد شرایط
برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید. |
RestaurantReservationEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
زمان شروع رزرو | مورد نیاز | زمانی که انتظار میرود رزرو شروع شود، مهر زمانی دوره در میلیثانیه است. | مهر زمانی دوره در میلی ثانیه |
مکان - کشور | مورد نیاز | کشوری که رستوران در آن اتفاق می افتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | مورد نیاز | شهری که رستوران در آن اتفاق می افتد. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | مورد نیاز | آدرس پیش رستورانی که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) رستوران. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت یا استان (در صورت وجود) که رستوران در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) رستوران. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله (در صورت وجود) رستوران. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
تصاویر پوستر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
اندازه جدول | اختیاری | تعداد افراد در گروه رزرو | عدد صحیح > 0 |
EventReservationEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | رشته اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
زمان شروع | مورد نیاز | مهر زمانی دورانی که انتظار می رود رویداد شروع شود. توجه: این در میلی ثانیه نمایش داده می شود. | مهر زمانی دوره در میلی ثانیه |
حالت رویداد | مورد نیاز | فیلدی برای نشان دادن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود. | تعداد: VIRTUAL، IN_PERSON، یا HYBRID |
مکان - کشور | مشروط مورد نیاز است | کشوری که رویداد در آن رخ می دهد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | مشروط مورد نیاز است | شهری که رویداد در آن اتفاق می افتد. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | مشروط مورد نیاز است | آدرس یا نام محل برگزاری رویداد که باید به کاربر نمایش داده شود. توجه: این برای رویدادهایی که IN_PERSON یا HYBRID هستند لازم است | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) مکانی که رویداد در آن میزبانی می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت یا استان (در صورت وجود) که رویداد در آن میزبانی می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) مکانی که رویداد در آن میزبانی می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله ای (در صورت وجود) که رویداد در آن برگزار می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
تصاویر پوستر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
زمان پایان | اختیاری | مهر زمانی دوره ای که انتظار می رود رویداد به پایان برسد. توجه: این در میلی ثانیه نمایش داده می شود. | مهر زمانی دوره در میلی ثانیه |
ارائه دهنده خدمات - نام | اختیاری | نام ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است. | متن رایگان. به عنوان مثال، نام برگزار کننده رویداد/تور |
ارائه دهنده خدمات - تصویر | اختیاری | آرم/تصویر ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
نشان ها | اختیاری | هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است. | |
نشان - متن | اختیاری | عنوان برای نشان توجه: متن یا تصویر برای نشان مورد نیاز است | متن رایگان اندازه متن پیشنهادی: حداکثر 15 کاراکتر |
نشان - تصویر | اختیاری | تصویر کوچک درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو. توجه: متن یا تصویر برای نشان مورد نیاز است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
شناسه رزرو | اختیاری | شناسه رزرو برای رزرو رویداد. | متن رایگان |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی بلیط/گذرنامه برای رویداد. در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی بلیط/گذرنامه برای رویداد. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
رتبه - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه - ارزش فعلی | اختیاری | ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه بندی - شمارش | اختیاری | تعداد امتیازات این رویداد. توجه: اگر برنامه شما میخواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازههای نمایشگر کوچکتر کوتاه نشود. | رشته |
رتبه بندی - مقدار شمارش | اختیاری | تعداد امتیازات این رویداد. توجه: اگر نمیخواهید منطق مخفف نمایش را خودتان مدیریت کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد | طولانی |
دسته بندی های محتوا | اختیاری | دسته بندی محتوا را در موجودیت توضیح دهید. | فهرست فهرست های واجد شرایط
برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید. |
LodgingReservationEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | متن رایگان. به عنوان مثال، "اقامت شما از 12 دسامبر" اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
زمان ورود | مورد نیاز | مهر زمانی دوره در میلی ثانیه که نشان دهنده زمان بررسی برای رزرو است. | مهر زمانی دوره در میلی ثانیه |
زمان خروج | مورد نیاز | مهر زمانی دوره در میلی ثانیه که نشان دهنده زمان خروج برای رزرو است. | مهر زمانی دوره در میلی ثانیه |
مکان - کشور | مورد نیاز | کشوری که اقامتگاه در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - شهر | مورد نیاز | شهری که اقامتگاه در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - نشانی نمایش | مورد نیاز | آدرس اقامتگاهی که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - ایالت | اختیاری | ایالت یا استان (در صورت وجود) که اقامتگاه در آن واقع شده است. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
مکان - کد پستی | اختیاری | کد پستی (در صورت وجود) اقامتگاه. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل - محله | اختیاری | محله (در صورت وجود) محل اقامت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
تصاویر پوستر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
شناسه رزرو | اختیاری | شناسه رزرو برای رزرو اقامتگاه. | متن رایگان |
رتبه - حداکثر مقدار | اختیاری | حداکثر مقدار مقیاس رتبه بندی. اگر ارزش فعلی رتبهبندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه - ارزش فعلی | اختیاری | ارزش فعلی مقیاس رتبه بندی. اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود. | عدد >= 0.0 |
رتبه بندی - شمارش | اختیاری | شمارش رتبه بندی برای اقامتگاه. توجه: اگر برنامه شما میخواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازههای نمایشگر کوچکتر کوتاه نشود. | رشته |
رتبه بندی - مقدار شمارش | اختیاری | شمارش رتبه بندی برای اقامتگاه. توجه: اگر نمیخواهید منطق مخفف نمایش را خودتان مدیریت کنید، این فیلد را وارد کنید. اگر تعداد و مقدار تعداد هر دو موجود باشد، از تعداد برای نمایش به کاربران استفاده خواهیم کرد | طولانی |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی اقامتگاه در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی اقامتگاه، که در UI مشخص شده است. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
TransportationReservationEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | متن رایگان. به عنوان مثال، "SFO to SAN" اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
نوع حمل و نقل | مورد نیاز | حالت/نوع حمل و نقل برای رزرو. | تعداد: پرواز، قطار، اتوبوس، یا کشتی |
زمان حرکت | مورد نیاز | مهر زمانی دوره در میلی ثانیه که نشان دهنده زمان حرکت است. | مهر زمانی دوره در میلی ثانیه |
زمان ورود | مورد نیاز | مهر زمانی دوره در میلی ثانیه که نشان دهنده زمان رسیدن است. | مهر زمانی دوره در میلی ثانیه |
محل عزیمت - کشور | اختیاری | کشور مبدا. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل عزیمت - شهر | اختیاری | شهر مبدأ. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل عزیمت - نشانی نمایش | اختیاری | محل عزیمت که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل عزیمت - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل عزیمت - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل عزیمت - کد پستی | اختیاری | کد پستی (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل حرکت - محله | اختیاری | محله (در صورت وجود) محل عزیمت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - کشور | اختیاری | کشور ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - شهر | اختیاری | شهر ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - نشانی نمایش | اختیاری | محل ورود که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - کد پستی | اختیاری | کد پستی (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
محل ورود - محله | اختیاری | محله (در صورت وجود) محل ورود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
ارائه دهنده خدمات - نام | اختیاری | نام ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است. | متن رایگان. به عنوان مثال، نام هواپیمایی |
ارائه دهنده خدمات - تصویر | اختیاری | آرم/تصویر ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
تصاویر پوستر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
شناسه رزرو | اختیاری | شناسه رزرو برای رزرو حمل و نقل. | متن رایگان |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی رزرو. در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی رزرو، که در UI مشخص شده است. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
شماره حمل و نقل | مورد نیاز | شماره پرواز، شماره اتوبوس، شماره قطار یا شماره کشتی/کروز. | متن رایگان |
زمان سوار شدن | مورد نیاز | مهر زمانی دوره ای که نشان دهنده زمان پرواز برای رزرو است (در صورت وجود) | مهر زمانی دوره در میلی ثانیه |
VehicleRentalReservationEntity
صفت | مورد نیاز | توضیحات | قالب |
---|---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به نهاد موجود در برنامه ارائه دهنده. توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید | اوری |
عنوان | مورد نیاز | عنوان نهاد. | متن رایگان. به عنوان مثال، "Avis Union Square SF" اندازه متن پیشنهادی: حداکثر 50 کاراکتر |
زمان تحویل | مورد نیاز | مهر زمانی دوره ای که نشان دهنده زمان تحویل برای رزرو است. | مهر زمانی دوره در میلی ثانیه |
زمان بازگشت | اختیاری | مهر زمانی دوره ای که نشان دهنده زمان خروج برای رزرو است. | مهر زمانی دوره در میلی ثانیه |
آدرس وانت - کشور | اختیاری | کشور محل وانت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس وانت - شهر | اختیاری | شهر محل وانت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس پیکاپ - نشانی نمایش | اختیاری | محل دریافت که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس وانت - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس وانت - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل وانت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس وانت - کد پستی | اختیاری | کد پستی (در صورت وجود) محل تحویل. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس وانت - محله | اختیاری | محله (در صورت وجود) محل وانت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - کشور | اختیاری | کشور محل بازگشت | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - شهر | اختیاری | شهر محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - نشانی نمایش | اختیاری | مکان بازگشتی که به کاربر نمایش داده می شود. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - آدرس خیابان | اختیاری | آدرس خیابان (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - ایالت | اختیاری | ایالت یا استان (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - کد پستی | اختیاری | کد پستی (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
آدرس برگشت - محله | اختیاری | محله (در صورت وجود) محل بازگشت. | متن رایگان اندازه متن پیشنهادی: حداکثر ~20 کاراکتر |
ارائه دهنده خدمات - نام | اختیاری | نام ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است. | متن رایگان. به عنوان مثال، "اجاره خودرو Avis" |
ارائه دهنده خدمات - تصویر | اختیاری | آرم/تصویر ارائه دهنده خدمات. توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است. | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
تصاویر پوستر | اختیاری | هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است | برای راهنمایی به مشخصات تصویر مراجعه کنید. |
توضیحات | اختیاری | یک پاراگراف متنی برای توصیف موجودیت. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن پیشنهادی: 180 کاراکتر |
لیست زیرنویس | اختیاری | حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن. توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو. | متن رایگان اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر |
شناسه تایید | اختیاری | شناسه تاییدیه رزرو کرایه خودرو. | متن رایگان |
قیمت - قیمت فعلی | مشروط مورد نیاز است | قیمت فعلی رزرو. در صورت ارائه قیمت خطی باید ارائه شود. | متن رایگان |
قیمت - StrikethroughPrice | اختیاری | قیمت اصلی رزرو، که در UI مشخص شده است. | متن رایگان |
فراخوان قیمت | اختیاری | اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود. | متن رایگان اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد) |
مشخصات تصویر
مشخصات مورد نیاز برای دارایی های تصویر در این جدول آمده است:
نسبت ابعاد | حداقل پیکسل | پیکسل های توصیه شده |
---|---|---|
مربع (1x1) ترجیح داده شده است | 300x300 | 1200x1200 |
منظره (1.91x1) | 600x314 | 1200x628 |
پرتره (4x5) | 480x600 | 960x1200 |
این تصاویر باید در CDN های عمومی میزبانی شوند تا Google بتواند به آنها دسترسی داشته باشد.
فرمت های فایل
PNG، JPG، GIF استاتیک، WebP
حداکثر اندازه فایل
5120 کیلوبایت
توصیه های اضافی
- ناحیه امن تصویر: محتوای مهم خود را 80 درصد در مرکز تصویر قرار دهید.
- از پس زمینه شفاف استفاده کنید تا تصویر به درستی در تنظیمات تم تیره و روشن نمایش داده شود.
دسته بندی محتوا
دسته محتوا به برنامه ها اجازه می دهد تا محتوای متعلق به چندین دسته را منتشر کنند. این نقشه محتوا را با برخی از مقوله های از پیش تعریف شده نشان می دهد:
-
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 های عمومی میزبانی شوند تا Google بتواند به آنها دسترسی داشته باشد.
راهنمایی برای استفاده از دسته بندی محتوا
- برخی از نهادها مانند ArticleEntity و GenericFeaturedEntity واجد شرایط استفاده از هر یک از دسته بندی های محتوا هستند. برای نهادهای دیگر مانند EventEntity ، EventReservationEntity ، PointOfInterestEntity ، تنها زیرمجموعهای از این دستهها واجد شرایط هستند. قبل از پر کردن فهرست، فهرست دستههای واجد شرایط برای یک نوع نهاد را بررسی کنید.
از نوع موجودیت خاص برای برخی از دستههای محتوا بر روی ترکیبی از موجودیتهای عمومی و دسته محتوا استفاده کنید:
- TYPE_MOVIES_AND_TV_SHOWS - قبل از استفاده از موجودیتهای عمومی، موجودیتهای راهنمای ادغام Watch را بررسی کنید.
- TYPE_BOOKS - قبل از استفاده از موجودیتهای عمومی، EbookEntity را بررسی کنید.
- TYPE_AUDIOBOOKS - قبل از استفاده از موجودیتهای عمومی، AudiobookEntity را بررسی کنید.
- TYPE_SHOPPING - قبل از استفاده از نهادهای عمومی، ShoppingEntity را بررسی کنید.
- TYPE_FOOD_AND_DRINK - قبل از استفاده از موجودیتهای عمومی، موجودیتها را از راهنمای Food Integration بررسی کنید.
قسمت ContentCategory اختیاری است و اگر محتوا به هیچ یک از دستههایی که قبلاً ذکر شد تعلق ندارد، باید خالی بماند.
در صورتی که چندین دسته محتوا ارائه شده است، آنها را به ترتیب مرتبط با محتوا با مرتبط ترین دسته بندی محتوا در ابتدا در لیست ارائه دهید.
مرحله 2: داده های Cluster را ارائه دهید
توصیه میشود کار انتشار محتوا در پسزمینه اجرا شود (مثلاً با استفاده از WorkManager ) و به طور منظم یا بر اساس رویداد برنامهریزی شود (به عنوان مثال، هر بار که کاربر برنامه را باز میکند یا زمانی که کاربر به تازگی چیزی به آن اضافه کرده است. سبد خرید آنها).
AppEngagePublishClient
مسئول انتشار خوشه ها است.
API های زیر برای انتشار خوشه ها در مشتری وجود دارد:
-
isServiceAvailable
-
publishRecommendationClusters
-
publishFeaturedCluster
-
publishContinuationCluster
-
publishUserAccountManagementRequest
-
updatePublishStatus
-
deleteRecommendationsClusters
-
deleteFeaturedCluster
-
deleteContinuationCluster
-
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
موجود از شریک توسعه حذف شده است. - داده های درخواست تجزیه و تحلیل می شود و در خوشه ویژه به روز شده ذخیره می شود.
در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.
publishContinuationCluster
این API برای انتشار یک شی ContinuationCluster
استفاده می شود.
کاتلین
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
جاوا
client.publishContinuationCluster( new PublishContinuationClusterRequest.Builder() .setContinuationCluster( new ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
هنگامی که سرویس درخواست را دریافت می کند، اقدامات زیر در یک تراکنش انجام می شود:
- داده های موجود
ContinuationCluster
از شریک توسعه دهنده حذف شده است. - دادههای درخواست تجزیه و تحلیل میشوند و در Continuation Cluster بهروز شده ذخیره میشوند.
در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.
publishUserAccountManagementRequest
این API برای انتشار کارت ورود به سیستم استفاده می شود. عمل ورود به سیستم، کاربران را به صفحه ورود به برنامه هدایت میکند تا برنامه بتواند محتوا را منتشر کند (یا محتوای شخصیسازیشدهتری ارائه کند)
فراداده زیر بخشی از کارت ورود به سیستم است -
صفت | مورد نیاز | توضیحات |
---|---|---|
اکشن اوری | مورد نیاز | پیوند عمیق به Action (یعنی به صفحه ورود به برنامه پیمایش میکند) |
تصویر | اختیاری - در صورت عدم ارائه، عنوان باید ارائه شود | تصویر روی کارت نشان داده شده است تصاویر با نسبت ابعاد 16x9 با وضوح 1264x712 |
عنوان | اختیاری - اگر ارائه نشد، تصویر باید ارائه شود | عنوان روی کارت |
متن اقدام | اختیاری | متن نمایش داده شده در CTA (یعنی ورود به سیستم) |
زیرنویس | اختیاری | زیرنویس اختیاری روی کارت |
کاتلین
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 API بهروزرسانی کنید. این مهم است زیرا:
- ارائه وضعیت در همه سناریوها، حتی زمانی که محتوا منتشر می شود (وضعیت == منتشر شده)، برای پر کردن داشبوردهایی که از این وضعیت صریح برای انتقال سلامت و سایر معیارهای ادغام شما استفاده می کنند، بسیار مهم است.
- اگر محتوایی منتشر نشود اما وضعیت ادغام خراب نباشد (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 API تماس بگیرید.
کاتلین
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();
هنگامی که سرویس درخواست را دریافت می کند، داده های موجود را از خوشه ویژه حذف می کند. در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.
deleteContinuationCluster
این API برای حذف محتوای Continuation Cluster استفاده می شود.
کاتلین
client.deleteContinuationCluster()
جاوا
client.deleteContinuationCluster();
هنگامی که سرویس درخواست را دریافت می کند، داده های موجود را از Continuation Cluster حذف می کند. در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.
deleteUserManagementCluster
این API برای حذف محتوای UserAccountManagement Cluster استفاده می شود.
کاتلین
client.deleteUserManagementCluster()
جاوا
client.deleteUserManagementCluster();
هنگامی که سرویس درخواست را دریافت می کند، داده های موجود را از UserAccountManagement Cluster حذف می کند. در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.
deleteClusters
این API برای حذف محتوای یک نوع خوشه مشخص استفاده می شود.
کاتلین
client.deleteClusters( DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .build())
جاوا
client.deleteClusters( new DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .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 | تماس سرویس خیلی مکرر برقرار می شود. |
مرحله 3: اهداف پخش را مدیریت کنید
علاوه بر برقراری تماسهای API محتوای انتشار از طریق یک کار، برای دریافت درخواست انتشار محتوا نیز باید یک BroadcastReceiver
راهاندازی کرد.
هدف از اهداف پخش عمدتاً فعال سازی مجدد برنامه و همگام سازی اجباری داده ها است. اهداف پخش برای ارسال خیلی مکرر طراحی نشده اند. تنها زمانی فعال میشود که سرویس Engage تشخیص دهد که ممکن است محتوا قدیمی باشد (مثلاً یک هفتهای است). به این ترتیب، اطمینان بیشتری وجود دارد که کاربر می تواند یک تجربه محتوای تازه داشته باشد، حتی اگر برنامه برای مدت طولانی اجرا نشده باشد.
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 continuation cluster publish when PUBLISH_CONTINUATION broadcast is // received } fun registerBroadcastReceivers(context: Context){ var context = context context = context.applicationContext // Register Recommendation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION)) // Register Featured Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_FEATURED)) // Register Continuation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION)) }
جاوا
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 continuation cluster publish when PUBLISH_CONTINUATION 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)); // Register Featured Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED)); // Register Continuation Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION)); }
- به صورت ایستا یک پیاده سازی را با تگ
<receiver>
در فایلAndroidManifest.xml
خود اعلام کنید. این اجازه می دهد تا برنامه زمانی که در حال اجرا نیست، اهداف پخش را دریافت کند و همچنین به برنامه اجازه می دهد محتوا را منتشر کند.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
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.PUBLISH_CONTINUATION" />
</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.PUBLISH_CONTINUATION
توصیه می شود هنگام دریافت این هدف، یک تماسpublishContinuationCluster
شروع کنید.
گردش کار یکپارچه سازی
برای راهنمایی گام به گام در مورد تأیید ادغام خود پس از تکمیل، به گردش کار ادغام برنامهنویس Engage مراجعه کنید.
سوالات متداول
برای پرسشهای متداول به پرسشهای متداول SDK مراجعه کنید.
تماس بگیرید
در صورت وجود هرگونه سوال در طول فرآیند ادغام، با engage-developers@google.com تماس بگیرید.
مراحل بعدی
پس از تکمیل این ادغام، مراحل بعدی شما به شرح زیر است:
- یک ایمیل به engage-developers@google.com ارسال کنید و APK یکپارچه خود را که برای آزمایش توسط Google آماده است، پیوست کنید.
- Google یک راستیآزمایی را انجام میدهد و به صورت داخلی بررسی میکند تا مطمئن شود ادغام مطابق انتظار عمل میکند. در صورت نیاز به تغییرات، Google با هر گونه جزئیات لازم با شما تماس می گیرد.
- وقتی آزمایش کامل شد و نیازی به تغییر نیست، Google با شما تماس می گیرد تا به شما اطلاع دهد که می توانید شروع به انتشار APK به روز شده و یکپارچه در فروشگاه Play کنید.
- پس از اینکه Google تأیید کرد که APK بهروزرسانی شده شما در فروشگاه Play منتشر شده است، ممکن است خوشههای توصیه ، ویژه و ادامه شما برای کاربران منتشر و قابل مشاهده باشند.