התראות push של OneSignal: SDK, API, סגמנטציה

כבר יש לך 10,000 משתמשים, אבל הודעות push נשלחות עם עיכובים וללא אנליטיקה? הבעיה הזו מוכרת: צוות הקצה-אחורי שולח הודעות ישירות דרך APNs/FCM, וזה הופך לבלאגן — קוד נפרד ל-iOS, קוד נפרד ל-Android, אין אנליטיקה פתוחה, אין סגמנטים, ניסיונות חוזרים נכתבים ידנית. כתוצאה מכך, שיעור המסירה יורד ל-85%, והיישום המותאם אישית לוקח 3–4 שבועות. OneSignal פותר את כל המחסנית עם API ו-SDK אחד. יישמנו עשרות אינטגרציות כאלה במפתח מלא — מההתחלה או עם הגירה מהלוגיקה הקיימת. בממוצע, OneSignal מאיץ את היישום פי 5: 5 ימים במקום 3 שבועות. חיסכון בזמן — עד 70% בהשוואה לפיתוח עצמי. אינטגרציה זו חוסכת בדרך כלל $5,000–$10,000 בעלויות פיתוח בהשוואה ליישום APNs/FCM מותאם אישית. כפי שמאושר ב-תיעוד OneSignal, שיעור המסירה הממוצע הוא 99.9%.

כיצד OneSignal פותר את בעיית ה-API המאוחד

ה-SDK של OneSignal גרסה 5.x עבר לארכיטקטורה מודולרית: OneSignal.User, OneSignal.Notifications, OneSignal.InAppMessages — מרחבי שמות נפרדים. זה חשוב בעת שדרוג מגרסה 3.x, שבה הכל היה API שטוח. ההגירה אינה טריוויאלית: sendTag הוחלף ב-OneSignal.User.addTag, setExternalUserId ב-OneSignal.login. להלן אתחול עבור iOS ו-Android.

// iOS — AppDelegate.swift
OneSignal.initialize("YOUR_APP_ID", withLaunchOptions: launchOptions)
OneSignal.Notifications.requestPermission({ accepted in
    print("Permission granted: \(accepted)")
}, fallbackToSettings: true)

// Android — Application.kt
OneSignal.initWithContext(this, "YOUR_APP_ID")
OneSignal.Notifications.requestPermission({ accepted ->
    Log.d("OneSignal", "Permission: $accepted")
}, this, true)

למה OneSignal עדיף על אינטגרציה מותאמת אישית

אינטגרציית OneSignal מספקת פתרון מאוחד להודעות push ל-iOS ו-Android, בניגוד ל-APNs/FCM מותאם אישית הדורש קוד נפרד לכל פלטפורמה. המתודולוגיה המוכחת שלנו מבטיחה שיעור מסירה של 99.9%, ושיעורי הקליקים גדלים פי 2–3 עם סגמנטציה נכונה.

אינטגרציה מותאמת אישית עולה 2–3 שבועות פיתוח בתוספת שיפורים מתמידים. OneSignal — 3–5 ימים, ואנליטיקה עם סגמנטים מגיעה מוכנה. חיסכון בזמן — עד 70%, והמרת הודעות push עולה פי 2–3 בזכות סגמנטציה נכונה.

כיצד להגדיר OneSignal ב-5 שלבים

1. צור פרויקט בלוח הבקרה של OneSignal וצור מפתחות APNs/FCM.
2. התקן את ה-SDK דרך CocoaPods/Swift Package Manager עבור iOS או Gradle עבור Android.
3. אתחל את ה-SDK עם // iOS — AppDelegate.swift OneSignal.initialize("YOUR_APP_ID", withLaunchOptions: launchOptions) OneSignal.Notifications.requestPermission({ accepted in print("Permission granted: \(accepted)") }, fallbackToSettings: true) והגדר הרשאות (ראה דוגמאות למעלה).
4. יישם מטפל פתיחת הודעה עבור קישורים עמוקים.
5. הוסף תגיות לסגמנטציה ובדוק שליחה דרך REST API.

כיצד לזהות משתמשים ולהגדיר תגיות

כברירת מחדל, OneSignal יוצר // Android — Application.kt OneSignal.initWithContext(this, "YOUR_APP_ID") OneSignal.Notifications.requestPermission({ accepted -> Log.d("OneSignal", "Permission: $accepted") }, this, true) אנונימי (מזהה ברמת מכשיר). עבור לוגיקה עסקית, יש צורך בקישור למשתמש במערכת שלך:

// После логина пользователя
OneSignal.login("user_internal_id_12345")
// Атрибуты для сегментации
OneSignal.User.addTag("plan", "premium")
OneSignal.User.addTag("city", "kyiv")
OneSignal.User.addTag("last_purchase_days", "3")

תגיות הן הבסיס לסגמנטציה נוספת. יש לתכנן אותן מראש: 10–15 תגיות מפתח מספיקות לרוב התרחישים. אם התגיות מפוזרות, האנליטיקה מאבדת דיוק.

שליחה דרך REST API

צד השרת הוא HTTP REST. בקשה מינימלית לשליחה לפי external_id:

POST https://onesignal.com/api/v1/notifications
{
  "app_id": "YOUR_APP_ID",
  "include_aliases": {
    "external_id": ["user_12345"]
  },
  "target_channel": "push",
  "contents": {
    "en": "Your order is ready",
    "ru": "Ваш заказ готов"
  },
  "data": {
    "order_id": "98765",
    "screen": "order_detail"
  }
}

השדה app_id הוא ה-payload עבור קישורים עמוקים. בצד הלקוח הנייד, הוא מעובד על ידי Player ID:

// iOS OneSignal.Notifications.addClickListener { event in
    if let orderId = event.notification.additionalData?["order_id"] as? String {
        AppRouter.navigate(to: .orderDetail(id: orderId))
    }
}

מסירה ואנליטיקה

OneSignal מספק שיעור מסירה (99.9% בממוצע), שיעור קליקים, פתיחות מושפעות (המשתמש פתח את האפליקציה תוך 60 שניות מבלי ללחוץ). עבור מסחר אלקטרוני, זהו מדד חשוב — ההודעה עבדה, אבל המשתמש פתח את האפליקציה בדרך אחרת. אם יש צורך באנליטיקה עמוקה יותר, OneSignal משתלב עם Mixpanel, Amplitude דרך אירועי תוצאה. לדוגמה, שליחת אירוע רכישה: // После логина пользователя OneSignal.login("user_internal_id_12345") // Атрибуты для сегментации OneSignal.User.addTag("plan", "premium") OneSignal.User.addTag("city", "kyiv") OneSignal.User.addTag("last_purchase_days", "3") ו-POST https://onesignal.com/api/v1/notifications { "app_id": "YOUR_APP_ID", "include_aliases": { "external_id": ["user_12345"] }, "target_channel": "push", "contents": { "en": "Your order is ready", "ru": "Ваш заказ готов" }, "data": { "order_id": "98765", "screen": "order_detail" } } . נתונים אלה מאפשרים בניית משפכים והערכת ROI של קמפיין push.

מה כלול באינטגרציה במפתח מלא

כל האינטגרציות כוללות: תיעוד מפורט, גישה ללוח בקרה, מפתחות API, מפגש הדרכה של שעתיים, ו-30 ימי תמיכה לאחר ההשקה.

לוחות זמנים וכיצד להתחיל

אינטגרציית OneSignal בסיסית (iOS + Android או Flutter/RN), הגדרת אישורי APNs/FCM, קישור מזהה משתמש חיצוני, מטפל פתיחה — 3–5 ימי עסקים. אם מתווספת לוגיקת שליחה מצד השרת, הגדרת סגמנטים ותבניות בלוח הבקרה של OneSignal — עוד 2–3 ימים.

הזמן ביקורת של ארכיטקטורת ה-push הנוכחית שלך — נסקור אותה. צור קשר לייעוץ: המהנדסים שלנו עם ניסיון של 5+ שנים בעבודה עם OneSignal SDK ו-REST API יעריכו את הפרויקט שלך ויציעו תוכנית אופטימלית. פנה אלינו, ואנו נגדיר את OneSignal עבור המחסנית שלך תוך מספר ימים בלבד.