s-3.664-0.699-5.062-2.099c-1.397-1.398-2.097-3.087-2.097-5.065s0.699-3.667,2.097-5.065c1.397-1.399,3.085-2.099,5.062-2.099 s3.664,0.699,5.062,2.099C223.888,120.556,224.587,122.244,224.587,124.223z"/>
سوالات متداول - پوشه

عمومی

نوتیفیکیشن چیست؟

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

برای مثال توسعه دهنده می خواهد به کاربران خود بگوید که اپلیکیشن را آپدیت کنند یا او می تواند به راحتی از طریق نوتیفیکیشن این اطلاع را به کاربران خود بدهد و همچنین لینک آپدیت را در آن قرار دهد.

یکی دیگر از کاربردهای نوتیفیکیشن، استفاده از آن برای تغییر مقداری در اپلیکیشن است. به طور مثال شما یک اپلیکیشن بازی دارید و می خواهید به مناسبتی به کاربران خود ستاره هدیه بدهید. برای این کار میتوایند در آن تاریخ نوتیفیکیشنی به کاربران خود ارسال کنید که در آن از طریق استفاده از json دلخواه متغیری در اپلیکیشن خود را مقدار دهی کنید.

پوشه چیست؟

پوشه یک سرویس ارسال پوش نوتیفیکیشن برای نرم افزارهای موبایل و وب است. کسب‌وکارها و توسعه‌دهندگان موبایل و وب به هنگام نوشتن برنامه، ازSDK پوشه در نرم افزار خودشان استفاده می‌کنند تا از طریق آن نرخ بازگشت و میزان درگیر شدن کاربرانشان با برنامه را افزایش دهند و از آمار و فیلترهایی که پوشه در اختیارشان قرار می‌دهد برای بهبود برنامه و افزایش رضایت کاربران بهره ببرند.
توسعه‌دهندگان می‌توانند ارسال پوش نوتیفیکیشن را از طریق APIهای پوشه نیز انجام دهند.
برای آشنایی بیشتر با نحوه‌ی استفاده از پوشه مستندات را مطالعه کنید یا سری به پنل دمو بزنید.

آیا پوشه در هر پلتفرمی کار می‌کند؟

با استفاده از پوشه می‌توانید به برنامه‌های خود در پلتفرم‌های اندروید، آی‌اواس و وب اعلان ارسال کنید. فریم‌ورک‌هایی که با پوشه سازگارند اندروید استودیو، یونیتی، کوردوا، آیونیک، زامارین، ری‌اکت نیتیو و …هستند.
همچنین پوشه در اپلیکیشن‌سازهایی مانند جواپ، اپتو، پازلی قابل استفاده است.
برای دسترسی به اطلاعات بیشتر می‌توانید به صفحه‌ی مستندات مراجعه کنید.

آیا می‌توانم از پوشه در اپلیکیشن‌های مختلف استفاده کنم؟

بله. امکان اضافه کردن هر تعداد اپلیکیشن و ارسال همزمان یک اعلان به هر تعداد از آن‌ها در پوشه وجود دارد.

آیا پوشه از GCM استفاده می‌کند؟

بله. پوشه از بستر Google Cloud Messaging برای ارسال و دریافت پوش استفاده می کند.

آیا می‌توان از پوشه همراه با وان‌سیگنال، ادجاست، فایربیس و دیگر سرویس‌های گوگل مانند آنالیتیکز استفاده کرده؟

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

چرا در برخی دستگاه‌ها پوش نوتیفیکیشن فقط هنگام باز کردن اپ دریافت می‌شود؟

در برخی از دستگاه‌های هواوی (و ال‌جی و شیاومی) لازم است اپلیکیشن در لیست اپ‌هایی که اجازه دارند در بکگراند اجرا شوند قرار بگیرد. چون در غیر این صورت، به محض این که اپلیکیشن متوقف شود (با حذف کردن از لیست برنامه‌های اخیر یا این که خود اندروید برای حفظ مصرف منابع آن را ببندد) به صورت خودکار دوباره فعال نمی‌شود و فقط زمانی که اپ را باز کنید پوش نمایش داده می‌شود. به عنوان یک توسعه دهنده نمی‌توانید اپلیکیشن خود را به «اپلیکیشن‌های حفاظت‌شده یا protected apps» اضافه کنید تا از دریافت پوش در گوشی‌های هواوی مطمئن شوید. بهتر است بعد از نصب اپتان به کاربر یادآوری کنید درصورتی که تمایل به دریافت پوش نوتیفیکیشن دارد، اپلیکیشن شما را به این لیست اضافه کند.

آیا پوشه برای کاربران برنامه‌ی ما تبلیغ ارسال می‌کند؟

خیر، پوشه صرفا بستری برای ارسال پوش نوتیفیکیشن است و فعالیت تبلیغاتی ندارد. همچنین بر اساس قوانین پوشه، ما هیچ گونه استفاده‌ی تبلیغاتی‌ای از کاربران شما نمی‌توانیم داشته باشیم.

شرایط استفاده و حریم خصوصی در پوشه چیست؟

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

آنالیتیکس و ارسال

«تمام نصب‌ها» چگونه محاسبه می‌شود؟

زمانی که اپلیکیشن شما (که حاوی کد SDK پوشه است) روی موبایل شما و یا کاربران‌تان نصب می‌شود، یک درخواست ثبت‌نام (registration) برای سرور پوشه ارسال می‌شود. زمانی که پیام ثبت‌نام موفقیت‌آمیز (Successfully registered to pushe) را در لاگ‌کت مشاهده می‌کنید،نصب کاربر شما در پنل پوشه قرار می‌گیرد و در آمار تمامی نصب‌ها قرار داده می‌شود. توجه داشته باشید که برای موفقیت این عملیات لازم است که کاربر شما برنامه‌ی google play service را بر روی دستگاه خود نصب داشته باشد که بر اساس آمارهای ما حدود 10 درصد کاربران ممکن است این برنامه را نداشته باشند. از آنجایی که در بعضی شرایط ممکن است خود سیستم گوگل‌پلی دچار اختلالات موقتی شود و یا مشکلی در سرویس اینترنت ایجاد شود که باعث شود نصب کاربر به سرور پوشه نرسد، ما هر ساعت عملیات نصب را تکرار می‌کنیم تا مطمئن شویم نصب شما در پنل پوشه قرار گرفته است. توجه داشته باشید که در این آمار اگر یک دستگاه بیش از یکی از اپلیکیشن‌های شما را بر روی دستگاه خود نصب کرده باشد، ۲ بار شمرده می‌شود.

«نصب فعال»، «کاربران یکتا» و «کاربران دردسترس» چیست؟

  • نصب‌های فعال اشاره به دستگاه‌هایی دارد که اپلیکیشن شما بر روی آن‌ها نصب شده و کاربر آن را از دستگاه حذف نکرده است.
  • کاربران یکتا کاربرانی هستند که تعدادی از اپلیکیشن های شما را نصب کرده‌اند ولی دیگر در آمار ما چندبار شمرده نمی‌شوند. برفرض مثال شما 7 اپلیکیشن دارید که یک دستگاه هر 7 برنامه شما را نصب دارد. ما در آمار کاربر یکتا، برای شما آن دستگاه را یک کاربر حساب کرده‌ایم تا آمار دقیق‌تری نسبت به تعداد کاربران‌تان داشته باشید.
  • کاربران دردسترس، کاربران یکتایی هستند که حداقل در دو هفته‌ی قبل یک بار به اینترنت وصل شده‌اند. درواقع زمانی که شما پوش نوتیفیکیشنی به تمامی کاربران‌تان می‌فرستید، این کاربران در دسترس هستند که آن ها را دریافت می‌کنند.

برای کسب اطلاعات بیشتر این پست بلاگ را بخوانید.

چرا آمار نصب فعال من در پوشه با کافه بازار و وان سیگنال متفاوت است؟

پس از اینکه شما sdk پوشه را در اپلیکیشن‌تان قرار بدید و کاربران آن را نصب کنند، هر کاربری که برنامه را نصب کند، در صفحه نصب‌ها اضافه می‌شود. اما توجه داشته باشید که پوشه نصب‌هایی را که برنامه‌ی Google Play Service بر روی دستگاه کاربر شما قرار داشته باشد،تشخیص می‌دهد. یکی از اصلی‌ترین تفاوت‌های آماری ما با کافه بازار امکان تشخیص نصب کافه بازار بدون نیاز به وجود Google Play Service بر روی دستگاه کاربر است و این تفاوت به دلیل تفاوت ماهیتی ما با کافه بازار است. آمارهای ما نشان می‌دهد که در حدود 10 درصد کاربران اندروید در ایران، Google Play Service را نصب ندارند،همین تفاوت باعث بوجود آمدن یک اختلاف اولیه 10 درصدی بین نصب های فعال کافه بازار و کاربران در دسترس پوشه می‌شود.

تفاوت بعدی در زمان بررسی در دسترس بودن کاربران است. کافه بازار کاربر فعال را بر اساس آنلاین بودن کاربر در دو ماه اخیر حساب می‌کند اما در پوشه اگر کاربر طی چهارده روز با سرورها تراکنش داشته باشد، کاربر در دسترس در نظر گرفته می‌شود و در غیر اینصورت از کاربران در دسترس، تا هر موقع که تراکنش جدیدی از آن دریافت شود، خارج می شود.

نکته آخر در وجود اختلاف مابین کافه بازار و پوشه این است که اگر یک اپلیکیشن بر روی یک گوشی تلفن همراه نصب شود، فارغ از اینکه توسط کاربر اپلیکیشن حداقل یک بار باز شود یا نه، کافه بازار درصورت اتصال دستگاه به اینترنت آن را یک نصب جدید محسوب می‌کند. اما در پوشه تنها زمانی که اپلیکیشن برای اولین بار توسط کاربر باز شود و بعد از آن نیز حداقل یک بار به اینترنت متصل گردد، نصب جدید در پوشه لحاظ می‌شود. از طرف دیگر حتی این احتمال وجود دارد که اپلیکیشن بعد از باز شدن دچار خطا شود که در این صورت نیز در آمار پوشه نخواهد آمد. برای مثال شما در نظر بگیرید که اپلیکیشن شما بر روی برخی آندرویدهای ورژن ۴.۲.۲ دچار اختلال شده و کتابخانه پوشه اصلا initialize نشده است. فلذا این نصب در نمودار شما وجود نخواهد داشت.

پوشه روی گوشی هایی که گوگل پلی سرویس را نصب نداشته باشند یا نسخه ی گوگل پلی سرویس آنها کمتر از ۳ باشد اجرا نمی شود. همچنین حداقل نسخه ی اندروید برای اجرای پوشه، اندروید ورژن ۲.۳ یا API ی ۹ هست. با توجه به اینکه گوشی هایی با اندروید کاستوم یا رام های genymotion و مشابه آن بصورت پیش فرض گوگل پلی سرویس را ندارند یا نسخه های گوگل پلی سرویس آنها بصورت جداگانه نصب شده و ممکن است یک نسخه ی سازگار نباشد، تا حدی اختلاف (حدود ۱۰ درصد) بین آمار نصب فعال شما در پنل پوشه و کافه بازار طبیعی است. بنابراین علاوه بر کاربرانی که گوگل پلی سرویس ندارند،بدلیل همه‌ی موارد ذکر شده ممکن است آمار پوشه کمتر از آمار کافه بازار باشد.

چرا تعداد کاربران من پس از ارسال کم می‌شود؟

برخی از کاربران شما هستند که پس از نصب اپلیکیشن شما، اون رو حذف میکنند. ما در دو زمان تعداد کاربران حذف شده رو شمارش می کنیم:

  • زمانی که شما یک اعلان به همه کاربران ارسال می کنید و ما متوجه می شویم که چه تعدادی از آنها اپ رو حذف کرده اند
  • شب ها ما کاربرانی که اپ شما را حذف کرده اند را از نصب های شما کم می کنیم

من همه کاری انجام داده‌ام، ولی هیچ نصبی در پنل نیامده است.

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

  1. تابع ()Pushe.initialize را در یک اکتیویتی مناسب قرار داده باشید

  2. توکنی که در منیفست قرار داده اید همان توکنی باشد که پنل برای این اپلیکشن در اختیار شما قرار داده است (هر اپلیکیشن یک توکن مربوط به خود دارد)

  3. پکیج نیمی که در پنل ثبت کرده اید دقیقا برابر با پکیج نیمی باشد که در اپلیکیشن خود استفاده می کنید

چرا در اپ‌های قدیمی‌ام، نرخ دلیوری کاهش پیدا می‌کند؟

اگر اپ خود را مدت زیادی است که ریلیز کرده اید و اپی است که کاربر ممکن است مدت طولانی آن را باز نکند، به علت غیرفعال بودن اپ این حالت می تواند پیش بیاید که چون اپ مدت زیادی استفاده نشده است، سرویس های آن توسط سیستم عامل بسته شوند. در نسخه های ۱.۰.۰ به بعد،‌ راهکارهایی برای جلوگیری از این مسئله پیاده سازی شده است اما در نسخه های قدیمی تر این موضوع وجود دارد. اگر از نسخه های قدیمی تر پوشه استفاده می کنید، پیشنهاد می کنیم که اپ خود را با جدیدترین نسخه پوشه بروزرسانی کنید.

آیا می‌توان اپلیکیشن را در امولاتور اجرا کرد؟

از آنجا که اجرای اپلیکیشن حاوی کتابخانه پوشه نیازمند Google Play Services است، توصیه می شود اپلیکیشن را بر روی موبایل یا تلبت اجرا و تست کنید. اگر می خواهید اپلیکیشن را بر روی Emulator تست کنید، بر روی ایمولاتور شما باید Google API نصب باشد.

آیا نوتیفیکیشن فقط به کاربرانی که جیمیل داشته‌باشند ارسال میشه؟

اگر منظور این است که کاربر حتما باید با اکانت گوگل داشته باشند و در گوشی خود وارد شده باشند، خیر اینگونه نیست و فقط اگر گوگل پلی سرویس داشته باشه کفایت میکند.

آیا امکان ارسال مستقیم پیام بین کاربران وجود دارد؟ (client-to-client)

بله. در پوشه شما می‌توانید پیام‌رسانی دوطرفه بین کاربران را پیاده‌سازی کنید. برای اطلاع از نحوه‌ی استفاده، قسمت «ارسال پوش از یک دستگاه به دستگاه دیگر» در بخش مربوط به هرکدام از فریم‌ورک‌های پیاده‌سازی در صفحه‌ی مستندات را ببینید.

پوش تاپیک چیست؟

تاپیک یا تگ برای دسته بندی کاربران شما صورت میگیرد تا بتوانید پیامها را بر اساس علاقمندی آنها ارسال کنید. برای استفاده از این امکان لازم است تا شما راهکارهایی را برای عضویت افراد در دسته هایی که تعریف می کنید، در اپلیکیشن خود قرار دهید. در کتابخانه پوشه دو تابع برای عضویت و لغو عضویت در تاپیک ها وجود دارد. برای عضو کردن کاربری در یک دسته یا تاپیک میتوانید از تابع عضویت استفاده کنید: Pushe.subscribe("Topic_Name") و برای لغو عضویت یک کاربر از یک تاپیک از این تابع استفاده کنید: Pushe.unsubscribe("Topic_name")
برای کسب اطلاعات بیشتر درخصوص استفاده از تاپیک و نحوه‌ی ارسال به مستندات و این پست بلاگ مراجعه کنید.

همیشه در کنارتان هستیم

در اولین فرصت با ایمیل به شما پاسخ خواهیم داد.

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