Engage SDK Travel: دستورالعمل‌های یکپارچه‌سازی فنی شخص ثالث، Engage SDK Travel: دستورالعمل‌های یکپارچه‌سازی فنی شخص ثالث

با دسترسی به کاربران خود در جایی که هستند، تعامل برنامه را افزایش دهید. Engage SDK را ادغام کنید تا توصیه‌های شخصی‌شده و محتوای ادامه‌دهنده را مستقیماً به کاربران در سطوح مختلف روی دستگاه مانند مجموعه‌ها ، فضای سرگرمی و فروشگاه Play ارائه دهید. این ادغام کمتر از 50 کیلوبایت (فشرده شده) به میانگین APK اضافه می کند و بیشتر برنامه ها را حدود یک هفته از زمان توسعه دهندگان می گیرد. در سایت کسب و کار ما بیشتر بیاموزید.

این راهنما حاوی دستورالعمل هایی برای شرکای توسعه دهنده است تا محتوای سفر و رویدادها را به سطوح محتوای Engage ارائه دهند.

جزئیات یکپارچه سازی

اصطلاحات

این ادغام شامل انواع خوشه زیر است: توصیه ، ویژه ، رزرو و ادامه جستجو .

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

    • یک خوشه Recommendation می تواند از لیست های ArticleEntity ، EventEntity ، LodgingEntity ، PointOfInterestEntity یا StoreEntity ساخته شود، اما ترکیبی از انواع موجودیت های مختلف نباشد.

    توصیه های شما ساختار زیر را دارد:

    • Recommendation Cluster: نمای رابط کاربری که شامل گروهی از توصیه‌های یک شریک توسعه‌دهنده است.

    • Entity: یک شی که یک آیتم را در یک خوشه نشان می دهد. این ادغام برخی از موجودیت هایی را ارائه می دهد که با استفاده از خوشه توصیه ظاهر می شوند:

      • ArticleEntity : ArticleEntity یک توصیه برای محتوای متنی مرتبط با سفر و رویدادها است. می توان از آن برای مقالات، پست های وبلاگ، محتوای بازاریابی، قطعات خبری و غیره استفاده کرد.

        شکل 1: UI که یک ArticleEntity را در کلاستر Recommendations نشان می دهد.

      • EventEntity : EventEntity نشان دهنده رویدادی است که در آینده اتفاق می افتد. زمان شروع رویداد یک بخش مهم از اطلاعات است که باید به کاربران منتقل شود.

        شکل 2: رابط کاربری که یک EventEntity را در کلاستر Recommendations نشان می دهد.

      • LodgingEntity : LodgingEntity نشان دهنده محل اقامتی مانند هتل، آپارتمان، خانه تعطیلات برای اجاره کوتاه مدت و بلند مدت است.

        شکل 3: UI که یک LodgingEntity را در کلاستر Recommendations نشان می دهد.

      • StoreEntity : StoreEntity یک فروشگاه، رستوران، کافه و غیره را نشان می‌دهد. محتوایی را که در آن مکان غذاخوری یا فروشگاه، بخش مهمی از اطلاعات است که باید به کاربران منتقل شود، برجسته می‌کند.

        شکل 4: رابط کاربری که یک StoreEntity را در کلاستر Recommendations نشان می دهد.

      • PointOfInterestEntity : PointOfInterestEntity نشان دهنده مکان مورد علاقه مانند، پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه توریستی، مسیر پیاده روی و غیره است. محتوایی را برجسته می کند که در آن مکان یک قطعه اطلاعات مهم است که باید به کاربران منتقل شود. نباید برای اقامت، فروشگاه یا محل غذاخوری استفاده شود.

        شکل 5: رابط کاربری که یک PointOfInterestEntity را در کلاستر Recommendations نشان می دهد.

  • خوشه رزرو ، محتوایی را نشان می‌دهد که اخیراً توسط کاربران چندین شریک توسعه‌دهنده در یک گروه UI واحد درگیر شده‌اند. هر شریک توسعه‌دهنده مجاز است حداکثر 10 موجودیت را در خوشه رزرو پخش کند.

    محتوای رزرو شما می تواند ساختار زیر را داشته باشد:

    • RestaurantReservationEntity : RestaurantReservationEntity نشان دهنده رزرو یک رستوران یا کافه است و به کاربران کمک می کند تا رزروهای رستوران آتی یا در حال انجام را پیگیری کنند.

      شکل 6. رابط کاربری یک RestaurantReservationEntity را در یک کلاستر رزرو نشان می دهد.

    • EventReservationEntity : EventReservationEntity یک رزرو برای یک رویداد را نشان می دهد و به کاربران کمک می کند رزرو رویدادهای آینده یا در حال انجام را پیگیری کنند. رویدادها می توانند شامل موارد زیر باشند، اما نه محدود به آنها:

      • رویدادهای ورزشی مانند رزرو برای یک مسابقه فوتبال
      • رویدادهای بازی مانند رزرو برای ورزش های الکترونیکی
      • رویدادهای سرگرمی مانند رزرو فیلم در سینما، کنسرت، تئاتر، امضای کتاب
      • رزرو سفر یا نقاط مورد علاقه مانند تورهای راهنما، بلیط موزه
      • اجتماعی / سمینار / کنفرانس ها رزرو
      • آموزش / رزرو جلسات آموزشی
      شکل 7. رابط کاربری که یک EventReservationEntity را در یک کلاستر رزرو نشان می دهد.

    • LodgingReservationEntity : LodgingEntityReservation نشان دهنده رزرو اقامتگاه مسافرتی است و به کاربران کمک می کند رزروهای آتی یا جاری هتل یا تعطیلات را ردیابی کنند.

      شکل 8. UI که یک LodgingReservationEntity را در یک کلاستر رزرو نشان می دهد.

    • TransportationReservationEntity : TransportationReservationEntity نشان دهنده رزرو برای حمل و نقل با هر حالتی است و به کاربران کمک می کند تا رزروهای پرواز آینده یا جاری، کشتی، قطار، اتوبوس، سواری-تگرگ، یا سفر دریایی را پیگیری کنند.

      شکل 9. UI که یک TransportationReservationEntity را در یک کلاستر رزرو نشان می دهد.

    • VehicleRentalReservationEntity : VehicleRentalReservationEntity نشان دهنده رزرو کرایه وسیله نقلیه است و به کاربران کمک می کند رزروهای اجاره خودروی آینده یا در حال انجام را پیگیری کنند.

      شکل 10. رابط کاربری که یک VehicleRentalReservationEntity را در یک کلاستر رزرو نشان می دهد.

  • خوشه ویژه مجموعه‌ای از موجودیت‌ها را از چندین شریک توسعه‌دهنده در یک گروه‌بندی UI به نمایش می‌گذارد. یک خوشه ویژه وجود خواهد داشت که در نزدیکی بالای رابط کاربری با اولویت بالاتر از همه خوشه‌های توصیه ظاهر می‌شود. هر شریک توسعه دهنده مجاز به پخش حداکثر 10 موجودیت در خوشه ویژه خواهد بود.

    • GenericFeaturedEntity : GenericFeaturedEntity با آیتم توصیه تفاوت دارد زیرا آیتم Featured باید برای یک محتوای برتر از توسعه دهندگان استفاده شود و باید مهمترین محتوایی را نشان دهد که برای کاربران جالب و مرتبط باشد.

      شکل 11: رابط کاربری که یک FeaturedCluster را با لیستی از GenericFeaturedEntity نشان می دهد.

  • خوشه Continue Search به کاربران کمک می‌کند تا با نمایش فهرستی از عبارت‌های جستجویی که کاربر اخیراً در تمام برنامه‌های سفر خود جستجو کرده است، سفر جستجوی سفر قبلی خود را از سر بگیرند. خوشه در موقعیت دوم، پس از رزرو و قبل از خوشه های ویژه و توصیه سنجاق می شود. هر شریک توسعه دهنده مجاز به پخش حداکثر 3 موجودیت در خوشه جستجوی ادامه دارد.

    • PointOfInterestEntity: PointOfInterestEntity نشان دهنده یک مکان دیدنی مانند، پمپ بنزین، محل برگزاری رویداد، پارک موضوعی، موزه، جاذبه توریستی، مسیر پیاده روی و غیره است. محتوایی را که کاربر قبلاً جستجو کرده است را برجسته می کند.

قبل از کار

حداقل سطح 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'
}

خلاصه

طراحی بر اساس اجرای یک سرویس محدود است.

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

نوع خوشه محدودیت های خوشه ای حداقل محدودیت موجودیت در یک خوشه حداکثر محدودیت موجودیت در یک خوشه
خوشه(های) توصیه حداکثر 7 حداقل 1 حداکثر 50 ( ArticleEntity ، EventEntity ، LodgingEntity ، StoreEntity ، یا PointOfInterestEntity )
خوشه رزرو حداکثر 1 حداقل 1 حداکثر 20 ( RestaurantReservationEntity , EventReservationEntity , LodgingReservationEntity , TransportationReservationEntity یا VehicleRentalReservationEntity )
خوشه ویژه حداکثر 1 حداقل 1 حداکثر 20 ( GenericFeaturedEntity )
خوشه جستجو را ادامه دهید حداکثر 1 حداقل 1 حداکثر 3 ( PointOfInterestEntity )

مرحله 1: داده های موجودیت را ارائه دهید

SDK موجودیت های مختلفی را برای نشان دادن هر نوع مورد تعریف کرده است. ما از نهادهای زیر برای دسته سفر و رویدادها پشتیبانی می کنیم:

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

نمودارهای زیر ویژگی ها و الزامات موجود برای هر نوع را مشخص می کند.

GenericFeaturedEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
تصاویر پوستر مورد نیاز

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید.

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
عنوان اختیاری عنوان نهاد.

متن رایگان

اندازه متن پیشنهادی: 50 کاراکتر

توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

نشان ها اختیاری

هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.

درمان ویژه UX در بالای تصویر/فیلم، به عنوان مثال، به عنوان پوشش نشان روی تصویر

  • "به روز رسانی زنده"
  • مدت زمان خواندن مقاله
نشان - متن اختیاری

عنوان برای نشان

توجه: متن یا تصویر برای نشان مورد نیاز است

متن رایگان

اندازه متن پیشنهادی: حداکثر 15 کاراکتر

نشان - تصویر اختیاری

تصویر کوچک

درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو.

توجه: متن یا تصویر برای نشان مورد نیاز است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
دسته بندی های محتوا اختیاری دسته بندی محتوا را در موجودیت توضیح دهید.

فهرست Enums

برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

ArticleEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

متن رایگان

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

تصاویر پوستر اختیاری

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

توجه: تصویر به شدت توصیه می شود. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
منبع - عنوان اختیاری نام نویسنده، سازمان یا گزارشگر

متن رایگان

اندازه متن پیشنهادی: زیر 25 کاراکتر

منبع - تصویر اختیاری تصویری از منبع مانند نویسنده، سازمان، گزارشگر برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

نشان ها اختیاری

هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.

درمان ویژه UX در بالای تصویر/فیلم، به عنوان مثال، به عنوان همپوشانی نشان روی تصویر

  • "به روز رسانی زنده"
  • مدت زمان خواندن مقاله
نشان - متن اختیاری

عنوان برای نشان

توجه: متن یا تصویر برای نشان مورد نیاز است

متن رایگان

اندازه متن پیشنهادی: حداکثر 15 کاراکتر

نشان - تصویر اختیاری

تصویر کوچک

درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو.

توجه: متن یا تصویر برای نشان مورد نیاز است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
زمان انتشار محتوا اختیاری این مهر زمانی در میلی ثانیه در زمانی است که محتوا در برنامه منتشر شد/به‌روزرسانی شد. مهر زمانی دوره در میلی ثانیه
آخرین زمان نامزدی اختیاری

مهر زمانی دوره در میلی ثانیه زمانی که کاربر آخرین بار با این موجودیت تعامل داشت.

 مهر زمانی دوره در میلی ثانیه
درصد پیشرفت اختیاری

درصد محتوای کامل مصرف شده توسط کاربر تا به امروز.

 مقدار int بین 0 تا 100 شامل.
دسته بندی های محتوا اختیاری دسته بندی محتوا را در موجودیت توضیح دهید.

فهرست Enums

برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

EventEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

رشته

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

زمان شروع محلی - مهر زمانی مورد نیاز

مهر زمانی دورانی که انتظار می رود رویداد شروع شود.

 Joda-Time Instant
زمان شروع محلی - منطقه زمانی مورد نیاز

منطقه زمانی که انتظار می رود رویداد در آن شروع شود.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

حالت رویداد مورد نیاز

فیلدی برای نشان دادن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود.

 تعداد: 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 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

دسته بندی های محتوا اختیاری دسته بندی محتوا را در موجودیت توضیح دهید.

فهرست فهرست های واجد شرایط

  • TYPE_MOVIES_AND_TV_SHOWS (مثال - سینما)
  • TYPE_DIGITAL_GAMES (مثال - ورزشهای الکترونیکی)
  • TYPE_MUSIC (مثال - کنسرت)
  • TYPE_TRAVEL_AND_LOCAL (مثال - تور، جشنواره)
  • TYPE_HEALTH_AND_FITENESS (مثال - کلاس یوگا)
  • TYPE_EDUCATION (مثال - کلاس)
  • TYPE_SPORTS (مثال - بازی فوتبال)
  • TYPE_DATING (مثال - ملاقات)

برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

LodgingEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

رشته

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

تصاویر پوستر مورد نیاز

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید.

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
مکان - کشور مورد نیاز کشوری که اقامت در آن اتفاق می افتد.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - شهر مورد نیاز شهری که در آن اقامتگاه اتفاق می افتد.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - نشانی نمایش مورد نیاز آدرسی که به کاربر نمایش داده می شود. توصیه می کنیم نام شهر و احتمالاً ایالت یا کشور را برای بیشتر موارد استفاده درج کنید. فقط در صورتی آدرس خیابان یا محله را درج کنید که کاربر در نزدیکی مکان باشد، کاربر با مکان آشنا باشد یا شهر در عنوان خوشه گنجانده شده باشد. اگر آدرس خیابان را وارد می‌کنید، با استفاده از اختصارات در صورت امکان، یک آدرس مختصر ارائه دهید (به عنوان مثال، "St" برای "خیابان"، "Ave" برای "Avenue").

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) محل اقامت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - ایالت اختیاری ایالت یا استان (در صورت وجود) که اقامتگاه در آن واقع شده است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - کد پستی اختیاری کد پستی (در صورت وجود) اقامتگاه.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل - محله اختیاری محله (در صورت وجود) محل اقامت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

نشان ها اختیاری

هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.

نشان - متن اختیاری

عنوان برای نشان

توجه: متن یا تصویر برای نشان مورد نیاز است

متن رایگان

اندازه متن پیشنهادی: حداکثر 15 کاراکتر

نشان - تصویر اختیاری

تصویر کوچک

درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو.

توجه: متن یا تصویر برای نشان مورد نیاز است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

AvailabilityTimeWindow - زمان شروع محلی - مهر زمانی اختیاری مهر زمانی زمانی که انتظار می رود اقامتگاه باز/در دسترس باشد. Joda-Time Instant
AvailabilityTimeWindow - زمان شروع محلی - منطقه زمانی اختیاری منطقه زمانی که انتظار می رود اقامتگاه در آن باز/در دسترس باشد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

AvailabilityTimeWindow - زمان پایان محلی شده - مهر زمانی اختیاری مهر زمانی دوره ای که انتظار می رود اقامتگاه تا آن زمان باز/در دسترس باشد. Joda-Time Instant
AvailabilityTimeWindow - زمان پایان موضعی - منطقه زمانی اختیاری منطقه زمانی که انتظار می رود اقامتگاه در آن باز/در دسترس باشد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

رتبه - حداکثر مقدار اختیاری

حداکثر مقدار مقیاس رتبه بندی.

اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه - ارزش فعلی اختیاری

ارزش فعلی مقیاس رتبه بندی.

اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه بندی - شمارش اختیاری

شمارش رتبه بندی برای اقامتگاه.

توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.

 رشته
رتبه بندی - مقدار شمارش اختیاری

شمارش رتبه بندی برای اقامتگاه.

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

 طولانی
قیمت - قیمت فعلی مشروط مورد نیاز است

قیمت فعلی اقامتگاه

در صورت ارائه قیمت خطی باید ارائه شود.

 متن رایگان
قیمت - StrikethroughPrice اختیاری قیمت اصلی اقامتگاه، که در UI مشخص شده است. متن رایگان
فراخوان قیمت اختیاری اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

StoreEntity

شی StoreEntity نشان‌دهنده فروشگاهی است که شرکای توسعه‌دهنده می‌خواهند آن را منتشر کنند، مانند یک غذاخوری یا غذاخوری محبوب که به تجربه سفر فرد مرتبط است.

صفت مورد نیاز توضیحات قالب
تصاویر پوستر مورد نیاز حداقل یک تصویر باید ارائه شود. برای راهنمایی به مشخصات تصویر مراجعه کنید.
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان اختیاری نام فروشگاه.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

مکان اختیاری موقعیت فروشگاه.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

فراخوانی اختیاری فراخوانی برای ارائه تبلیغات، رویداد یا به‌روزرسانی برای فروشگاه، در صورت وجود.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

چاپ ریز چاپ اختیاری متن چاپ دقیق برای فراخوانی.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

توضیحات اختیاری توضیحات فروشگاه

متن رایگان

اندازه متن توصیه شده: کمتر از 90 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

دسته بندی اختیاری

طبقه بندی یک فروشگاه، در زمینه مکان های غذاخوری، می تواند غذاهایی مانند "فرانسوی"، "آمریکایی جدید"، "رامن"، "ناهارخوری خوب" باشد.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

رتبه - حداکثر مقدار اختیاری

حداکثر مقدار مقیاس رتبه بندی.

اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه - ارزش فعلی اختیاری

ارزش فعلی مقیاس رتبه بندی.

اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه بندی - شمارش اختیاری

شمارش رتبه بندی برای اقامتگاه.

توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.

 رشته
رتبه بندی - مقدار شمارش اختیاری

شمارش رتبه بندی برای اقامتگاه.

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

 طولانی
DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

PointOfInterestEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

رشته

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

تصاویر پوستر مشروط مورد نیاز است

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

توجه: اگر موجودیت بخشی از خوشه توصیه باشد، تصویر مورد نیاز است. اگر نشان ارائه شده است، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
آخرین زمان نامزدی مشروط مورد نیاز است

مهر زمانی زمانی که کاربر آخرین بار با این موجودیت تعامل داشته است.

توجه: اگر موجودیت بخشی از خوشه جستجوی ادامه باشد، این فیلد ضروری است.

 Joda-Time Instant
مکان - کشور مشروط مورد نیاز است

کشوری که نقطه مورد علاقه در آن اتفاق می افتد.

توجه: اگر موجودیت بخشی از خوشه توصیه باشد، این فیلد ضروری است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - شهر مشروط مورد نیاز است

شهری که نقطه دیدنی در آن اتفاق می افتد.

توجه: اگر موجودیت بخشی از خوشه توصیه باشد، این فیلد ضروری است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - نشانی نمایش مشروط مورد نیاز است

آدرسی که به کاربر نمایش داده می شود. در صورت امکان از اختصارات استفاده کنید (به عنوان مثال، "St" برای "Street"، "Ave" برای "Avenue") یک آدرس مختصر ارائه دهید. این رشته ممکن است بسته به دستگاه و تنظیمات کاربر کوتاه شود. نام شهر را برای شناسایی واضح درج کنید.

توجه: اگر موجودیت بخشی از خوشه توصیه باشد، این فیلد ضروری است.

متن رایگان

اندازه متن توصیه شده: حداکثر ~ 35 کاراکتر

مکان - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) نقطه مورد علاقه.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - ایالت اختیاری ایالت یا استان (در صورت وجود) که نقطه مورد نظر در آن واقع شده است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - کد پستی اختیاری کد پستی (در صورت وجود) نقطه مورد علاقه.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل - محله اختیاری محله (در صورت وجود) نقطه مورد علاقه.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

AvailabilityTimeWindow - زمان شروع محلی - مهر زمانی اختیاری مهر زمانی دوره ای که انتظار می رود نقطه مورد علاقه باز/در دسترس باشد. Joda-Time Instant
AvailabilityTimeWindow - زمان شروع محلی - منطقه زمانی اختیاری منطقه زمانی که انتظار می رود نقطه مورد علاقه در آن باز/در دسترس باشد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

AvailabilityTimeWindow - زمان پایان محلی شده - مهر زمانی اختیاری مهر زمانی دوره ای که انتظار می رود نقطه مورد علاقه تا آن زمان باز/در دسترس باشد. Joda-Time Instant
AvailabilityTimeWindow - زمان پایان موضعی - منطقه زمانی اختیاری منطقه زمانی که انتظار می رود نقطه مورد علاقه در آن باز/در دسترس باشد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

نشان ها اختیاری

هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.

نشان - متن اختیاری

عنوان برای نشان

توجه: متن یا تصویر برای نشان مورد نیاز است

متن رایگان

اندازه متن پیشنهادی: حداکثر 15 کاراکتر

نشان - تصویر اختیاری

تصویر کوچک

درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو.

توجه: متن یا تصویر برای نشان مورد نیاز است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

رتبه - حداکثر مقدار اختیاری

حداکثر مقدار مقیاس رتبه بندی.

اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه - ارزش فعلی اختیاری

ارزش فعلی مقیاس رتبه بندی.

اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه بندی - شمارش اختیاری

شمارش رتبه بندی برای نقطه مورد علاقه.

توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.

 رشته
رتبه بندی - مقدار شمارش اختیاری

شمارش رتبه بندی برای نقطه مورد علاقه.

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

 طولانی
قیمت - قیمت فعلی مشروط مورد نیاز است

قیمت فعلی بلیت / مجوز ورود برای نقطه مورد علاقه.

در صورت ارائه قیمت خطی باید ارائه شود.

 متن رایگان
قیمت - StrikethroughPrice اختیاری قیمت اصلی بلیط / مجوز ورود برای نقطه مورد علاقه. متن رایگان
فراخوان قیمت اختیاری اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

دسته بندی های محتوا اختیاری دسته بندی محتوا را در موجودیت توضیح دهید.

فهرست فهرست های واجد شرایط

  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (مثال - تئاتر)
  • TYPE_MEDICAL (مثال - بیمارستان)
  • TYPE_EDUCATION (مثال - مدرسه)
  • TYPE_SPORTS (مثال - استادیوم)

برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

RestaurantReservationEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

رشته

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

زمان شروع رزرو محلی - مهر زمانی مورد نیاز مهر زمانی زمانی که انتظار می رود رزرو شروع شود. Joda-Time Instant
زمان شروع رزرو محلی - منطقه زمانی مورد نیاز منطقه زمانی که انتظار می رود رزرو در آن شروع شود.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

مکان - کشور مورد نیاز کشوری که رستوران در آن اتفاق می افتد.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - شهر مورد نیاز شهری که رستوران در آن اتفاق می افتد.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - نشانی نمایش مورد نیاز آدرس پیش رستورانی که به کاربر نمایش داده می شود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) رستوران.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - ایالت اختیاری ایالت یا استان (در صورت وجود) که رستوران در آن واقع شده است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - کد پستی اختیاری کد پستی (در صورت وجود) رستوران.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل - محله اختیاری محله (در صورت وجود) رستوران.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

تصاویر پوستر اختیاری هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

اندازه جدول اختیاری تعداد افراد در گروه رزرو عدد صحیح > 0
DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

EventReservationEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

رشته

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

زمان شروع محلی - مهر زمانی مورد نیاز

مهر زمانی دورانی که انتظار می رود رویداد شروع شود.

 Joda-Time Instant
زمان شروع محلی - منطقه زمانی مورد نیاز

منطقه زمانی که انتظار می رود رویداد در آن شروع شود.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

حالت رویداد مورد نیاز

فیلدی برای نشان دادن اینکه آیا رویداد مجازی، حضوری یا هر دو خواهد بود.

 تعداد: 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 در بالا و پایین تصویر اطمینان حاصل کنید

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
زمان پایان محلی - مهر زمانی اختیاری

مهر زمانی دوره ای که انتظار می رود رویداد به پایان برسد.

 Joda-Time Instant
زمان پایان محلی - منطقه زمانی اختیاری

منطقه زمانی که انتظار می‌رود رویداد در آن به پایان برسد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

ارائه دهنده خدمات - نام اختیاری

نام ارائه دهنده خدمات.

توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است.

 متن رایگان. به عنوان مثال، نام برگزار کننده رویداد/تور
ارائه دهنده خدمات - تصویر اختیاری

آرم/تصویر ارائه دهنده خدمات.

توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است.

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

نشان ها اختیاری

هر نشان یا متن آزاد (حداکثر 15 کاراکتر) یا تصویر کوچک است.

نشان - متن اختیاری

عنوان برای نشان

توجه: متن یا تصویر برای نشان مورد نیاز است

متن رایگان

اندازه متن پیشنهادی: حداکثر 15 کاراکتر

نشان - تصویر اختیاری

تصویر کوچک

درمان ویژه UX، برای مثال به عنوان روکش نشان روی تصویر کوچک تصویر/ویدیو.

توجه: متن یا تصویر برای نشان مورد نیاز است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
شناسه رزرو اختیاری شناسه رزرو برای رزرو رویداد. متن رایگان
قیمت - قیمت فعلی مشروط مورد نیاز است

قیمت فعلی بلیط/گذرنامه برای رویداد.

در صورت ارائه قیمت خطی باید ارائه شود.

 متن رایگان
قیمت - StrikethroughPrice اختیاری قیمت اصلی بلیط/گذرنامه برای رویداد. متن رایگان
فراخوان قیمت اختیاری اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

رتبه - حداکثر مقدار اختیاری

حداکثر مقدار مقیاس رتبه بندی.

اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه - ارزش فعلی اختیاری

ارزش فعلی مقیاس رتبه بندی.

اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه بندی - شمارش اختیاری

تعداد امتیازات این رویداد.

توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.

 رشته
رتبه بندی - مقدار شمارش اختیاری

تعداد امتیازات این رویداد.

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

 طولانی
دسته بندی های محتوا اختیاری دسته بندی محتوا را در موجودیت توضیح دهید.

فهرست فهرست های واجد شرایط

  • TYPE_MOVIES_AND_TV_SHOWS (مثال - سینما)
  • TYPE_DIGITAL_GAMES (مثال - ورزشهای الکترونیکی)
  • TYPE_MUSIC (مثال - کنسرت)
  • TYPE_TRAVEL_AND_LOCAL (مثال - تور، جشنواره)
  • TYPE_HEALTH_AND_FITENESS (مثال - کلاس یوگا)
  • TYPE_EDUCATION (مثال - کلاس)
  • TYPE_SPORTS (مثال - بازی فوتبال)
  • TYPE_DATING (مثال - ملاقات)

برای راهنمایی به بخش دسته بندی محتوا مراجعه کنید.

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

LodgingReservationEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

متن رایگان. به عنوان مثال، "اقامت شما از 12 دسامبر"

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

زمان ورود محلی - مهر زمانی مورد نیاز مهر زمانی دوره ای که نشان دهنده زمان بررسی برای رزرو است. Joda-Time Instant
زمان ورود محلی - منطقه زمانی مورد نیاز منطقه زمانی که در آن زمان بررسی برای رزرو وجود دارد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

زمان پرداخت محلی - مهر زمانی مورد نیاز مهر زمانی دوره ای که نشان دهنده زمان خروج برای رزرو است. Joda-Time Instant
زمان پرداخت محلی - منطقه زمانی مورد نیاز منطقه زمانی که در آن زمان خروج برای رزرو وجود دارد.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

مکان - کشور مورد نیاز کشوری که اقامتگاه در آن واقع شده است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - شهر مورد نیاز شهری که اقامتگاه در آن واقع شده است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - نشانی نمایش مورد نیاز آدرسی که به کاربر نمایش داده می شود. در صورت امکان از اختصارات استفاده کنید (به عنوان مثال، "St" برای "Street"، "Ave" برای "Avenue") یک آدرس مختصر ارائه دهید. این رشته ممکن است بسته به دستگاه و تنظیمات کاربر کوتاه شود. نام شهر را برای شناسایی واضح درج کنید.

متن رایگان

اندازه متن توصیه شده: حداکثر ~ 35 کاراکتر

مکان - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) محل اقامت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - ایالت اختیاری ایالت یا استان (در صورت وجود) که اقامتگاه در آن واقع شده است.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

مکان - کد پستی اختیاری کد پستی (در صورت وجود) اقامتگاه.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل - محله اختیاری محله (در صورت وجود) محل اقامت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

تصاویر پوستر اختیاری

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

توجه: در صورت ارائه نشان، از فضای ایمن 24 dps در بالا و پایین تصویر اطمینان حاصل کنید.

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

شناسه رزرو اختیاری شناسه رزرو برای رزرو اقامتگاه. متن رایگان
رتبه - حداکثر مقدار اختیاری

حداکثر مقدار مقیاس رتبه بندی.

اگر ارزش فعلی رتبه‌بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه - ارزش فعلی اختیاری

ارزش فعلی مقیاس رتبه بندی.

اگر حداکثر مقدار رتبه بندی نیز ارائه شده باشد، باید ارائه شود.

 عدد >= 0.0
رتبه بندی - شمارش اختیاری

شمارش رتبه بندی برای اقامتگاه.

توجه: اگر برنامه شما می‌خواهد نحوه نمایش آن را برای کاربران کنترل کند، این قسمت را وارد کنید. رشته مختصری را ارائه دهید که می تواند به کاربر نمایش داده شود. برای مثال، اگر تعداد 1,000,000 باشد، از اختصاراتی مانند 1M استفاده کنید تا در اندازه‌های نمایشگر کوچک‌تر کوتاه نشود.

 رشته
رتبه بندی - مقدار شمارش اختیاری

شمارش رتبه بندی برای اقامتگاه.

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

 طولانی
قیمت - قیمت فعلی مشروط مورد نیاز است

قیمت فعلی اقامتگاه

در صورت ارائه قیمت خطی باید ارائه شود.

 متن رایگان
قیمت - StrikethroughPrice اختیاری قیمت اصلی اقامتگاه، که در UI مشخص شده است. متن رایگان
فراخوان قیمت اختیاری اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

TransportationReservationEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

متن رایگان. به عنوان مثال، "SFO to SAN"

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

نوع حمل و نقل مورد نیاز حالت/نوع حمل و نقل برای رزرو. تعداد: پرواز، قطار، اتوبوس، یا کشتی
زمان حرکت محلی - مهر زمانی مورد نیاز مهر زمانی دوره ای که نشان دهنده زمان حرکت است. Joda-Time Instant
زمان حرکت محلی - منطقه زمانی مورد نیاز منطقه زمانی زمان حرکت.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

زمان رسیدن محلی - مهر زمانی مورد نیاز مهر زمانی دوره ای که نشان دهنده زمان رسیدن است. Joda-Time Instant
زمان رسیدن محلی - منطقه زمانی مورد نیاز منطقه زمانی زمان رسیدن.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

شماره حمل و نقل مورد نیاز شماره پرواز، شماره اتوبوس، شماره قطار یا شماره کشتی/کروز. متن رایگان
زمان شبانه روزی محلی - مهر زمانی مورد نیاز مهر زمانی دوره ای که نشان دهنده زمان پرواز برای رزرو است (در صورت وجود) Joda-Time Instant
زمان شبانه روزی محلی - منطقه زمانی مورد نیاز منطقه زمانی زمان پرواز برای رزرو (در صورت وجود)

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

محل عزیمت - کشور اختیاری کشور مبدا.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل عزیمت - شهر اختیاری شهر مبدأ.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل عزیمت - نشانی نمایش اختیاری محل عزیمت که به کاربر نمایش داده می شود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل عزیمت - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) محل عزیمت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل عزیمت - ایالت اختیاری ایالت یا استان (در صورت وجود) محل عزیمت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل عزیمت - کد پستی اختیاری کد پستی (در صورت وجود) محل عزیمت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل حرکت - محله اختیاری محله (در صورت وجود) محل عزیمت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - کشور اختیاری کشور ورود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - شهر اختیاری شهر ورود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - نشانی نمایش اختیاری محل ورود که به کاربر نمایش داده می شود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) محل ورود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - ایالت اختیاری ایالت یا استان (در صورت وجود) محل ورود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - کد پستی اختیاری کد پستی (در صورت وجود) محل ورود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

محل ورود - محله اختیاری محله (در صورت وجود) محل ورود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

ارائه دهنده خدمات - نام اختیاری

نام ارائه دهنده خدمات.

توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است.

 متن رایگان. به عنوان مثال، نام هواپیمایی
ارائه دهنده خدمات - تصویر اختیاری

آرم/تصویر ارائه دهنده خدمات.

توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است.

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
تصاویر پوستر اختیاری

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

شناسه رزرو اختیاری شناسه رزرو برای رزرو حمل و نقل. متن رایگان
قیمت - قیمت فعلی مشروط مورد نیاز است

قیمت فعلی رزرو.

در صورت ارائه قیمت خطی باید ارائه شود.

 متن رایگان
قیمت - StrikethroughPrice اختیاری قیمت اصلی رزرو، که در UI مشخص شده است. متن رایگان
فراخوان قیمت اختیاری اعلام قیمت برای نمایش تبلیغات، رویداد، تخفیف عضو، در صورت وجود.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

VehicleRentalReservationEntity

صفت مورد نیاز توضیحات قالب
اکشن اوری مورد نیاز

پیوند عمیق به نهاد موجود در برنامه ارائه دهنده.

توجه: می توانید از پیوندهای عمیق برای ذکر منبع استفاده کنید. به این سؤالات متداول مراجعه کنید

 اوری
عنوان مورد نیاز عنوان نهاد.

متن رایگان. به عنوان مثال، "Avis Union Square SF"

اندازه متن پیشنهادی: حداکثر 50 کاراکتر

زمان تحویل محلی - مهر زمانی مورد نیاز مهر زمانی دوره ای که نشان دهنده زمان تحویل برای رزرو است. Joda-Time Instant
زمان تحویل محلی - منطقه زمانی مورد نیاز منطقه زمانی زمان تحویل گرفتن برای رزرو.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

زمان بازگشت محلی - مهر زمانی اختیاری مهر زمانی دوره ای که نشان دهنده زمان خروج برای رزرو است. Joda-Time Instant
زمان بازگشت محلی - منطقه زمانی اختیاری منطقه زمانی زمان خروج برای رزرو.

Joda-Time DateTimeZone

برای راهنمایی به مشخصات منطقه زمانی مراجعه کنید.

آدرس وانت - کشور اختیاری کشور محل وانت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس وانت - شهر اختیاری شهر محل وانت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس پیکاپ - نشانی نمایش اختیاری محل دریافت که به کاربر نمایش داده می شود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس وانت - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) محل تحویل.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس وانت - ایالت اختیاری ایالت یا استان (در صورت وجود) محل وانت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس وانت - کد پستی اختیاری کد پستی (در صورت وجود) محل تحویل.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس وانت - محله اختیاری محله (در صورت وجود) محل وانت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - کشور اختیاری کشور محل بازگشت

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - شهر اختیاری شهر محل بازگشت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - نشانی نمایش اختیاری مکان بازگشتی که به کاربر نمایش داده می شود.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - آدرس خیابان اختیاری آدرس خیابان (در صورت وجود) محل بازگشت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - ایالت اختیاری ایالت یا استان (در صورت وجود) محل بازگشت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - کد پستی اختیاری کد پستی (در صورت وجود) محل بازگشت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

آدرس برگشت - محله اختیاری محله (در صورت وجود) محل بازگشت.

متن رایگان

اندازه متن پیشنهادی: حداکثر ~20 کاراکتر

ارائه دهنده خدمات - نام اختیاری

نام ارائه دهنده خدمات.

توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است.

 متن رایگان. به عنوان مثال، "اجاره خودرو Avis"
ارائه دهنده خدمات - تصویر اختیاری

آرم/تصویر ارائه دهنده خدمات.

توجه: متن یا تصویر برای ارائه دهنده خدمات مورد نیاز است.

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
تصاویر پوستر اختیاری

هنگامی که چندین تصویر ارائه می شود، تنها 1 تصویر را نشان خواهیم داد. نسبت تصویر پیشنهادی 16:9 است

 برای راهنمایی به مشخصات تصویر مراجعه کنید.
توضیحات اختیاری

یک پاراگراف متنی برای توصیف موجودیت.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن پیشنهادی: 180 کاراکتر

لیست زیرنویس اختیاری

حداکثر 3 زیرنویس، با هر زیرنویس یک خط متن.

توجه: توضیحات یا لیست زیرنویس برای کاربر نمایش داده می شود، نه هر دو.

متن رایگان

اندازه متن توصیه شده برای هر زیرنویس: حداکثر 50 کاراکتر

شناسه تایید اختیاری شناسه تاییدیه رزرو کرایه خودرو. متن رایگان
Price - CurrentPrice مشروط مورد نیاز است

The current price of the reservation.

در صورت ارائه قیمت خطی باید ارائه شود.

 متن رایگان
Price - StrikethroughPrice اختیاری The original price of the reservation, which is be struck-through in the UI. متن رایگان
Price Callout اختیاری Price callout to feature a promo, event, member discount, if available.

متن رایگان

اندازه متن توصیه شده: کمتر از 45 کاراکتر (متنی که خیلی طولانی است ممکن است بیضی نشان دهد)

DisplayTimeWindow (اختیاری) - یک پنجره زمانی برای نمایش محتوا روی سطح تنظیم کنید
مهر زمانی را شروع کنید اختیاری

مهر زمانی دوره که پس از آن محتوا باید روی سطح نشان داده شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه
پایان مهر زمان اختیاری

مهر زمانی دوره ای که پس از آن محتوا دیگر روی سطح نشان داده نمی شود.

اگر تنظیم نشود، محتوا واجد شرایط نمایش در سطح است.

 مهر زمانی دوره در میلی ثانیه

مشخصات تصویر

Required specifications for image assets are listed in this table:

نسبت ابعاد حداقل پیکسل پیکسل های توصیه شده

مربع (1x1)

ترجیح داده شده است

 300x300 1200x1200
منظره (1.91x1) 600x314 1200x628
پرتره (4x5) 480x600 960x1200

The images are required to be hosted on public CDNs so that Google can access them.

فرمت های فایل

PNG، JPG، GIF استاتیک، WebP

حداکثر اندازه فایل

5120 کیلوبایت

توصیه های اضافی

  • ناحیه امن تصویر: محتوای مهم خود را 80 درصد در مرکز تصویر قرار دهید.
  • از پس زمینه شفاف استفاده کنید تا تصویر به درستی در تنظیمات تم تیره و روشن نمایش داده شود.

Timezone specifications

Prefer ID (for example, "America/Los_Angeles") over offset (for example, "-07:00").

Sample usage: DateTimeZone.forID("America/Los_Angeles")

دسته بندی محتوا

The content category allows apps to publish content belonging to multiple categories. This maps the content with some of the predefined categories namely:

  • 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

The images are required to be hosted on public CDNs so that Google can access them.

Guidelines to use the content categories

  1. Some entities like ArticleEntity and GenericFeaturedEntity are eligible to use any of the content categories. For other entities like EventEntity , EventReservationEntity , PointOfInterestEntity , only a subset of these categories are eligible. Check the list of categories eligible for an entity type before populating the list.

  2. Use the specific entity type for some content categories over a combination of the Generic entities and the ContentCategory:

    • TYPE_MOVIES_AND_TV_SHOWS - Check out the entities from Watch integration guide before using the generic entities.
    • TYPE_BOOKS - Check out the EbookEntity before using the generic entities.
    • TYPE_AUDIOBOOKS - Check out AudiobookEntity before using the generic entities.
    • TYPE_SHOPPING - Check out ShoppingEntity before using the generic entities.
    • TYPE_FOOD_AND_DRINK - Check out entities from Food Integration guide before using the generic entities.

  3. The ContentCategory field is optional and should be left blank if the content doesn't belong to any of the categories mentioned earlier.

  4. In case multiple content categories are provided, provide them in the order of relevance to the content with the most relevant content category placed first in the list.

مرحله 2: داده های Cluster را ارائه دهید

توصیه می‌شود کار انتشار محتوا در پس‌زمینه اجرا شود (مثلاً با استفاده از WorkManager ) و به‌طور منظم یا بر اساس رویداد برنامه‌ریزی شود (به عنوان مثال، هر بار که کاربر برنامه را باز می‌کند یا زمانی که کاربر به تازگی چیزی را به سبد خرید خود اضافه کرده است).

AppEngageTravelClient is responsible for publishing clusters.

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 موجود از شریک توسعه حذف شده است.
  • داده های درخواست تجزیه و تحلیل می شود و در خوشه ویژه به روز شده ذخیره می شود.

در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

publishReservationCluster

This API is used to publish a ReservationCluster object.

کاتلین 

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());

هنگامی که سرویس درخواست را دریافت می کند، اقدامات زیر در یک تراکنش انجام می شود:

  • Existing ReservationCluster data from the developer partner is removed.
  • Data from the request is parsed and stored in the updated Reservation Cluster.

در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

publishContinueSearchCluster

This API is used to publish a list of ContinueSearchCluster objects.

کاتلین 

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());

هنگامی که سرویس درخواست را دریافت می کند، اقدامات زیر در یک تراکنش انجام می شود:

  • Existing ContinueSearchCluster data from the developer partner is removed.
  • Data from the request is parsed and stored in the updated Continue Search 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();

هنگامی که سرویس درخواست را دریافت می کند، داده های موجود را از خوشه ویژه حذف می کند. در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

deleteReservationCluster

This API is used to delete the content of Reservation Cluster.

کاتلین 

client.deleteReservationCluster()

جاوا 

client.deleteReservationCluster();

When the service receives the request, it removes the existing data from the Reservation Cluster. در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

deleteUserManagementCluster

این API برای حذف محتوای UserAccountManagement Cluster استفاده می شود.

کاتلین 

client.deleteUserManagementCluster()

جاوا 

client.deleteUserManagementCluster();

هنگامی که سرویس درخواست را دریافت می کند، داده های موجود را از UserAccountManagement Cluster حذف می کند. در صورت بروز خطا، کل درخواست رد می شود و وضعیت موجود حفظ می شود.

deleteContinueSearchCluster

This API is used to delete the content of Continue Search Cluster.

کاتلین 

client.deleteContinueSearchCluster()

جاوا 

client.deleteContinueSearchCluster();

When the service receives the request, it removes the existing data from the Continue Search Cluster. In case of an error, the entire request is rejected, and the existing state is maintained.

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 اجرای کار به دلیل مشکلات رشته ای انجام نشد. در این صورت می توان آن را دوباره امتحان کرد.
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 continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continue Search Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

جاوا 

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

  • به صورت ایستا یک پیاده سازی را با تگ <receiver> در فایل AndroidManifest.xml خود اعلام کنید. این اجازه می دهد تا برنامه زمانی که در حال اجرا نیست، اهداف پخش را دریافت کند و همچنین به برنامه اجازه می دهد محتوا را منتشر کند. 

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

اهداف زیر توسط سرویس ارسال می شود:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION توصیه می شود هنگام دریافت این هدف، یک تماس publishRecommendationClusters شروع کنید.
  • com.google.android.engage.action.PUBLISH_FEATURED توصیه می شود هنگام دریافت این هدف، یک تماس publishFeaturedCluster شروع کنید.
  • com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH It is recommended to start a publishContinueSearchCluster call when receiving this intent.
  • com.google.android.engage.action.travel.PUBLISH_RESERVATION It is recommended to start a publishReservationCluster call when receiving this intent.

گردش کار یکپارچه سازی

برای راهنمایی گام به گام در مورد تأیید ادغام خود پس از تکمیل، به گردش کار ادغام برنامه‌نویس Engage مراجعه کنید.

سوالات متداول

برای پرسش‌های متداول به پرسش‌های متداول SDK مراجعه کنید.

تماس بگیرید

در صورت وجود هرگونه سوال در طول فرآیند ادغام، با engage-developers@google.com تماس بگیرید.

مراحل بعدی

پس از تکمیل این ادغام، مراحل بعدی شما به شرح زیر است:

  • یک ایمیل به engage-developers@google.com ارسال کنید و APK یکپارچه خود را که برای آزمایش توسط Google آماده است، پیوست کنید.
  • Google یک راستی‌آزمایی را انجام می‌دهد و به صورت داخلی بررسی می‌کند تا مطمئن شود ادغام مطابق انتظار عمل می‌کند. در صورت نیاز به تغییرات، Google با هر گونه جزئیات لازم با شما تماس می گیرد.
  • وقتی آزمایش کامل شد و نیازی به تغییر نیست، Google با شما تماس می گیرد تا به شما اطلاع دهد که می توانید شروع به انتشار APK به روز شده و یکپارچه در فروشگاه Play کنید.
  • After Google has confirmed that your updated APK has been published to the Play Store, your Recommendation , Featured , Reservation , and Continue Search clusters may be published and visible to users.