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

چگونه یک پیوست عالی ایجاد کنم؟

Nearby Notifications پیام‌ها را در بخش Nearby تنظیمات Google نشان می‌دهد، کاشی تنظیمات سریع Nearby را در دستگاه‌های پشتیبانی‌شده روشن می‌کند، و بهترین پیوست‌ها را به عنوان اعلان تبلیغ می‌کند.

برای حداکثر اثربخشی، پیوست ها باید:

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

پیوست من در بخش Nearby در تنظیمات Google نشان داده نمی شود. چرا؟

• برای پیام‌هایی که نشان می‌دهیم محدودیت‌هایی وجود دارد، مانند مجاز کردن فقط نشانی‌های وب HTTPS و غیرمجاز کردن محتوایی که خط‌مشی‌های ما را نقض می‌کند.
• پیوندهای play.google.com پشتیبانی نمی شوند. به جای آن از پیوست‌های App Intent برای فعال کردن تجربه‌ای که توسط یک برنامه پشتیبانی می‌شود، استفاده کنید.

پیام من به عنوان اعلان نشان داده نمی شود. چرا؟

دلایل مختلفی وجود دارد که ممکن است اعلان ظاهر نشود.

1. اگر کاربران از پیوست به خوبی دریافت نکنند، اعلان نشان داده نمی‌شود. نکاتی برای ایجاد یک پیوست عالی را می توان در بالا یافت.
2. Nearby Notifications معمولاً چند ثانیه پس از روشن شدن صفحه نمایش، نشانگرها را اسکن می کند. اگر صفحه برای مدتی روشن نشده باشد، دستگاه چراغ های جدید را پیدا نمی کند.
3. یک پیوست در حالت اشکال زدایی فقط در دستگاه های حالت اشکال زدایی نشان داده می شود. همچنین حالت Debug را ببینید
4. اگر اعلان اخیراً در دستگاهی رد شده باشد، آن دستگاه ممکن است اعلان دیگری را برای مدتی نشان ندهد. اگر کاربر بخش Nearby در تنظیمات Google را باز کند، خط‌مشی عقب‌نشینی نیز بازنشانی می‌شود.
5. اگر اعلان خط‌مشی‌های Nearby Notifications را نقض کند، ممکن است نشان داده نشود.

کدام نسخه اندروید از Nearby Notifications پشتیبانی می کند؟

Nearby Notifications در اندروید 4.4 (KitKat) و جدیدتر پشتیبانی می‌شود.

چگونه Nearby Notifications با Eddystone-URL یا Physical Web مرتبط است؟

Nearby Notifications به موازات Eddystone-URL و Physical Web با رفتار دقیق بسته به موارد استفاده و قابلیت‌های شما کار می‌کند. به عنوان مثال، اگر یک مورد استفاده دارید که در وب سایت شما موجود است، ممکن است از یک Beacon Eddystone-URL استفاده کنید. اگر مورد استفاده در برنامه شما موجود است، ممکن است از Nearby Notifications با هدف برنامه استفاده کنید.

قالب مورد نیاز برای پیوست‌های Nearby Notifications در Proximity Beacon API چیست؟

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

    {
      "title": "Example",
      "url": "https://www.example.com"
    }

در پیوست‌های Nearby Notifications، عنوان چگونه استفاده می‌شود؟

عنوان در اعلان‌ها و لیست‌هایی که توسط Nearby Notifications نمایش داده می‌شوند ظاهر می‌شود. برای مثال، اگر عنوان شما روی «عملیات نمونه در مکان» تنظیم شده باشد، متن اعلان علاوه بر نام یا نشانی اینترنتی برنامه، به‌عنوان "Example action at place" ظاهر می‌شود.

آیا Nearby Notifications برنامه را در پس‌زمینه نصب می‌کند؟

خیر. Nearby Notifications کاربران را به فروشگاه Google Play هدایت می‌کند تا از آنجا نصب کنند.

چگونه بفهمم کاربری از طریق Nearby Notifications به برنامه من آمده است؟

پیوندهای Nearby Notifications پیوندهای عمیق استاندارد اندروید هستند، اما اگر می‌خواهید برچسب‌های اضافی، به عنوان مثال، برای معیارها یا تجزیه و تحلیل‌ها ارائه کنید، می‌توانید پارامترهای رشته جستجو را به مؤلفه مسیر URL intent اضافه کنید.

آیا Nearby Notifications از iBeacon پشتیبانی می‌کند؟

بله، تا زمانی که بیکن دارای شناسه iBeacon ثابت باشد. این شناسه‌ها می‌توانند در API Proximity Beacon ثبت شوند و می‌توانند پیوست‌های Nearby Notifications را داشته باشند.

کجا و چه زمانی اسکن انجام می شود، اگر در برنامه من نیست؟

اسکن توسط خدمات Google Play انجام می شود و فقط در رویدادهای "صفحه روشن" انجام می شود.

چه کسی مسئول ثبت بیکن ها در API Proximity Beacon است؟

هر کسی می‌تواند نشانگر را ثبت کند، به شرطی که پیوست دارای فضای نام و نوع مناسب باشد. در بیشتر موارد، این مالک بیکن خواهد بود، اما اگر با آنها قرارداد دارید، ممکن است OEM چراغ دریایی باشد.

فرمت URI هدف برنامه چیست؟

ابتدا، با داشبورد Beacon می‌توانید به وب سایت اجازه دهید یک URI معتبر برای شما بسازد، مشروط بر اینکه بخش‌های طرح، میزبان و مسیر URI را بدانید. در اینجا یک مثال است:

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

    <data android:host="item"
          android:pathPrefix="/scanner"
          android:scheme="myapp" />

Intent:// URI مربوطه خواهد بود:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;end

یعنی URI را می توان به این صورت تقسیم کرد:

    intent://<host>/<path>#Intent;scheme=<scheme>;package=<package name>;end

اگر فعالیت شما به موارد اضافی قصد نیاز دارد، این موارد باید درست قبل از ;end اضافه شوند:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;S.string_extra=value%20one;B.bool_extra=true;end

انواع زیر را می توان در موارد اضافی استفاده کرد:

• بولی
• بایت
• Char
• دوبل
• شناور
• بین المللی
• طولانی
• کوتاه

همچنین Intent.java#parseUri() و Intent.java#toUri(int) را در زمینه URI_INTENT_SCHEME برای جزئیات بیشتر در مورد این URL intent ببینید.

درباره بومی‌سازی عنوانی که Nearby Notifications استفاده می‌کند چطور؟

پیوست‌های Nearby Notifications باید شامل زبان/محل به‌عنوان بخشی از فضای نام/نوع باشند، و Nearby Notifications فقط پیوست‌هایی را نشان می‌دهد که با تنظیمات محلی کاربر مطابقت دارند.