کلیک بدون باز کردن صفحه (do_not_open)

با افزودن ?_osp=do_not_open به انتهای لینک مقصد، کلیک روی اعلان فقط آن را می‌بندد و هیچ صفحه‌ای باز نمی‌شود. فقط برای وب پوش.

این قابلیت چه می‌کند؟

گاهی می‌خواهید کاربر با کلیک روی اعلان صرفاً آن را ببندد و صفحه‌ای باز نشود (مثلاً اعلان‌های اطلاع‌رسانی صرف). کافی است پارامتر ?_osp=do_not_open را به انتهای لینک مقصد (link_url) اضافه کنید. سرویس‌ورکر پوشفا این پارامتر را تشخیص می‌دهد و به‌جای باز کردن صفحه، فقط اعلان را می‌بندد. این رفتار دقیقاً مشابه OneSignal است و فقط برای وب پوش کار می‌کند.

گزارش کلیک (در صورت فعال بودن) همچنان ثبت می‌شود؛ تنها باز شدن صفحه لغو می‌شود.

نمونه

لینک مقصد را به این شکل تنظیم کنید:

https://yoursite.com/page?_osp=do_not_open

نمونه درخواست API

ارسال تکی با لینک «بدون باز شدن»:

این قابلیت فقط برای وب پوش است؛ روی اپلیکیشن‌های موبایل اثری ندارد.
curl -X POST https://pushfa.com/api/webservices/send-single-message \
  -H "Content-Type: application/json" \
  -d '{
    "api_public_key": "YOUR_PUBLIC_KEY",
    "api_private_key": "YOUR_PRIVATE_KEY",
    "subscriber_id": "SUBSCRIBER_UUID",
    "title": "اطلاع‌رسانی",
    "body": "این پیام فقط برای اطلاع است",
    "link_url": "https://yoursite.com/page?_osp=do_not_open",
    "send_time": "current"
  }'

شناسه پایدار مخاطب و سازگاری با کلیدهای قدیمی

از subscriber_id برای یک مخاطب و subscriber_ids[] برای چند مخاطب استفاده کنید؛ این شناسه‌ها با چرخش توکن تغییر نمی‌کنند و پایدارترند. کلیدهای fcm_token و fcm_tokens[] به دلیل پایداری کمتر منسوخ شده‌اند، اما برای سازگاری همچنان پشتیبانی می‌شوند. ارسال هم‌زمان subscriber_id و fcm_token یا subscriber_ids و fcm_tokens، حتی با مقدار خالی، خطای اعتبارسنجی 422 می‌دهد.

Ctrl+I