Skip to main content

ارسال اعلان تراکنشی

تعریف اعلان تراکنشی

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

تفاوت این نوع اعلان با نوع ساده و فیلتردار این است که در این نوع اعلان ارسال شده در پنل ثبت نمی‌شود و آمار آن هم قابل مشاهده نخواهد بود و ویژگی این نوع اعلان سرعت بالای ارسال آن نسبت به انواع دیگر اعلان می‌باشد.

در ارسال این نوع اعلان باید به موارد زیر دقت کنید

  • گیرندگان اعلان در هر درخواست باید توسط یکی از امکان‌های دسته‌بندی device_id و یا custom_id مشخص شوند
  • حداکثر تعداد دریافت‌کننده‌گان اعلان در یک درخواست ۵۰۰ کاربر است

آدرس (url) ارسال اعلان تراکنشی

برای ارسال اعلان تراکنشی برای هر دو پلتفرم اندروید و آی‌او‌اس می توانید از آدرس زیر استفاده کنید. ‍https://api.pushe.co/v2/messaging/web-rapid/

کلید‌های ارسال اعلان تراکنشی

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

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

برای دسته‌بندی کاربران در اعلان تراکنشی تنها استفاده از یکی از امکان‌های دسته‌بندی یعنی custom_id یا device_id اجباری می‌باشد و در صورت استفاده همزمان بیش از یک مورد به شما پیام خطا بازگردانده می‌شود.

  • data: یک دیکشنری که مقادیر (محتوای) اعلان را نگه می‌دارد.

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

نکته

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

نمونه کد ارسال اعلان تراکنشی

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

  • در این نمونه کد از cURL استفاده شده است که می‌توانیدتوسط sudo apt install curl آن را نصب کنید.
curl -X POST https://api.pushe.co/v2/messaging/web-rapid/ \
-H 'authorization: Token YOUR_TOKEN' \
-H 'content-type: application/json' \
-d '{
"app_id": "YOUR_APP_ID",
"device_id": ["device_id_1","device_id_3", "device_id_2", "device_id_4"],
"data": {"title": "عنوان پیام", "content": "محتوای پیام"},
"custom_content": {"key1": "Value1","Key2": "Value2"}}'