Skip to main content

ارسال اعلان با محتوا دلخواه

تعریف اعلان با محتوای دلخواه

این نوع اعلان ارسال محتوای دلخواه به شکل json به اپلیکیشن می‌باشد. در این نوع اعلان ارسال محتوای (عنوان، متن، آیکن، عکس و ...) به کاربر اختیاری می‌باشد و می‌توانید اعلانی بدون نمایش محتوا ارسال کنید.

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

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

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

برای مشاهده نحوه دریافت مقدار محتوای دلخواه ارسال شده در پلتفرم‌های متفاوت به راهنمای اندروید استودیو ، راهنمای فلاتر ، راهنما یونیتی ، راهنمای ری‌اکت‌نیتیو مراجعه کنید.

آدرس (url) ارسال اعلان

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

https://api.pushe.co/v2/messaging/notifications/

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

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

  • app_id: شناسه اپلیکیشن که از نوع رشته string می‌باشد.
    این فیلد اجباری است
  • custom_content: یک دیکشنری است که کلید ها و مقادیر دلخواهی که می‌خواهید ارسال کنید را نگه می‌دارد
    این فیلد اجباری است

امکان استفاده از کلیدهایی که در قسمت ارسال اعلان ساده و در قسمت ارسال اعلان فیلتردار گفته شد در این نوع اعلان هم امکان‌پذیر می‌باشد.

نکته

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

تبصره

در اعلان‌های غیرتراکنشی استفاده همزمان از دو کلید data و custom_content مجاز است.

نکته مهم

در صورت استفاده همزمان از کلید‌های custom_content و data، علاوه بر ارسال محتوای دلخواه، اعلان نیز به کاربر نمایش داده می‌شود.

نمونه کد ارسال اعلان با محتوای دلخواه

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

  • در این نمونه کد از cURL استفاده شده است که می‌توانیدتوسط sudo apt install curl آن را نصب کنید.
curl -X POST https://api.pushe.co/v2/messaging/notifications/ \
-H 'authorization: Token YOUR_TOKEN' \
-H 'content-type: application/json' \
-d '{"app_ids": "YOUR_APP_ID", "custom_content": {"key1": "Value1","Key2": "Value2"}}'