كيفية استخدام حزمة تطوير برامج (SDK) لإشعارات الدفع لنظام iOS لتطبيقك (مع الكود)

تقوم حزمة تطوير برامج (SDK) لإشعارات الدفع لنظام iOS بوظيفتين: فهي تتعامل مع البنية التحتية بين تطبيقك وخدمة إشعارات الدفع من Apple، وتربط هذه البنية التحتية بمنصة حملات حتى يتمكن فريق التسويق الخاص بك من استخدامها فعليًا. يغطي هذا الدليل كليهما - خطوات التكامل الفعلية مع الكود الذي ستقوم بشحنه، وما يصبح ممكنًا في لوحة التحكم بمجرد تثبيت حزمة تطوير البرامج (SDK). إنه يعكس حزمة تطوير برامج (SDK) PushEngage لنظام iOS 1.0، الإصدار الحالي.

لماذا تستخدم حزمة تطوير برامج (SDK) لإشعارات الدفع لنظام iOS لتطبيقك

يمكنك التحدث مباشرة إلى APNs - التسجيل للحصول على رمز جهاز، وبناء مرسل، والتعامل مع ردود الاتصال بالتسليم بنفسك. ما تحصل عليه من APNs الخام هو التسليم؛ ما لا تحصل عليه هو كل ما يحتاجه التسويق: التقسيم، والحملات المجدولة والمشغلة، واختبار A/B، والتحليلات، وإسناد الإيرادات. حزمة تطوير برامج (SDK) مثل PushEngage تربط تطبيقك بهذه الطبقة مرة واحدة، لذلك يتم إنشاء الحملات في لوحة تحكم بدلاً من مشروع Xcode. النتيجة العملية: بعد أسبوع التكامل، تتوقف حملات الدفع عن كونها تذاكر هندسية.

كيفية تثبيت حزمة تطوير برامج (SDK) إشعارات الدفع لنظام iOS من PushEngage

ستحتاج إلى iOS 12+، و Xcode 15+، و مفتاح APNs تم تحميله إلى لوحة تحكم PushEngage الخاصة بك، وحوالي فترة ما بعد الظهيرة. يتم شحن حزمة تطوير البرامج (SDK) كوحدتين: PushEngage لهدف تطبيقك و PushEngageExtension لأهداف امتداد الإشعارات.

الخطوة 1: إضافة الحزمة

في Xcode، انتقل إلى ملف → إضافة تبعيات الحزمة وأدخل عنوان URL للمستودع - أو استخدم CocoaPods:

# Swift Package Manager
https://github.com/awesomemotive/pushengage-ios-sdk

# CocoaPods
target 'YourApp' do
  pod 'PushEngage', '~> 1.0.0'
end
target 'YourNotificationServiceExtension' do
  pod 'PushEngageExtension', '~> 1.0.0'
end

الخطوة 2: تكوين مجموعة التطبيقات

أضف إمكانية مجموعات التطبيقات إلى هدف تطبيقك وكل هدف امتداد إشعارات، باستخدام نفس معرف المجموعة، وأعلنه في ملف Info.plist لكل هدف:

<key>PushEngage_App_Group_Key</key>
<string>group.com.yourcompany.yourapp</string>

يتشارك التطبيق وامتداداته حالة المشترك من خلال هذه الحاوية. يعد تخطيها الخطأ الأكثر شيوعًا في التكامل - بدونها، تبدأ امتداداتك فارغة عند كل تسليم.

الخطوة 3: تهيئة وطلب الإذن

import PushEngage

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        PushEngage.setAppID(id: "YOUR_APP_ID")
        PushEngage.setInitialInfo(for: application, with: launchOptions)
        return true
    }
}

// Later, at a value moment — not on first launch:
PushEngage.requestNotificationPermission { granted, error in
    if granted { /* subscribed */ }
}

مكان وضع استدعاء الإذن هذا يهم أكثر من أي شيء آخر في هذا الدليل - يمنحك نظام iOS مطالبة أصلية واحدة بالضبط. يغطي دليل تهيئة الإذن نمط الطلب الناعم الذي يحميه.

كيفية إرسال إشعارات دفع غنية للتطبيقات لنظام iOS

تتطلب الصور وأزرار الإجراءات والأصوات المخصصة امتداد خدمة إشعارات - هدف صغير يعترض كل إشعار ويضيف وسائط قبل العرض. أضف الهدف في Xcode، وقم بربط PushEngageExtension به، وقم بتمرير استدعاءات دورة الحياة الاثنتين:

import PushEngageExtension

class NotificationService: UNNotificationServiceExtension {
    override func didReceive(_ request: UNNotificationRequest,
                             withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        PushEngageExtension.didReceiveNotificationExtensionRequest(request,
                                                                   bestContentHandler: contentHandler)
    }

    override func serviceExtensionTimeWillExpire() {
        // hand back the best content prepared so far
    }
}

من هناك، الوسائط الغنية هي ميزة لوحة التحكم: يقوم فريق التسويق الخاص بك بإرفاق صورة المنتج أو الرسم الرئيسي عند إنشاء الحملة، ويقوم الامتداد بعرضها. لا توجد تغييرات إضافية في التطبيق لكل حملة.

كيفية إنشاء إشعارات دفع مخصصة لنظام iOS

يعتمد التخصيص على ما يعرفه الـ SDK عن كل مشترك. حدد هويتك وقم بإرفاق السمات، ويمكن لكل حملة التقسيم والقوالب بناءً عليها:

// Identify the signed-in user (12 predefined fields supported)
PushEngage.identify(fields: [
    "first_name": "Priya",
    "email": "[email protected]",
    "profile_id": "user-42",
    "city": "Austin"
]) { success, error in }

// Attach custom attributes for segmentation
PushEngage.addSubscriberAttributes([
    "favorite_category": "outerwear",
    "loyalty_tier": "gold"
]) { success, error in }

// On sign-out, clear PII but keep the anonymous subscription
PushEngage.logout(fieldNames: nil) { success, error in }

تؤدي استدعاءات identify المتكررة بنفس البيانات إلى اختصار محلي، لذا فإن استدعاءها عند كل تشغيل آمن. بمجرد تدفق السمات، يحدث التجزئة في لوحة التحكم - يصبح "متسوقو الملابس الخارجية من الفئة الذهبية" جمهورًا محفوظًا، وليس طلب SQL.

كيفية إضافة رابط عميق في إشعارات دفع لنظام iOS

يجب أن يؤدي كل نقرة على الحملة إلى الشاشة التي وعدت بها. قم بتعيين معالج فتح الإشعار مرة واحدة، وقم بالتوجيه بناءً على الرابط العميق الذي يحمله:

PushEngage.setNotificationOpenHandler { result in
    // actionID is nil when the SDK already opened the URL itself
    guard let deepLink = result.notificationAction.actionID else { return }
    DispatchQueue.main.async {
        router.navigate(to: deepLink)   // e.g. myapp://cart
    }
}

يقوم المسوق بلصق الرابط العميق في نموذج الحملة؛ يقوم المعالج الخاص بك بالتوجيه. الأنماط الكاملة - بما في ذلك الروابط الشاملة وخيار الفتح التلقائي - موجودة في دليل الربط العميق.

كيفية تشغيل الحملات من أحداث التطبيق

يقوم استدعاء trackEvent في الـ SDK الإصدار 1.0 بتحويل أي سلوك داخل التطبيق إلى مشغل حملة - عربة تسوق مهجورة، خطوة إكمال في عملية الإعداد، فئة تم تصفحها:

PushEngage.trackEvent(name: "cart_updated",
                      properties: ["cart_value": 89.50, "item_count": 2],
                      profileId: currentUserId,
                      provider: nil, eventType: nil) { _, _ in }

قم بتجهيز الحدث مرة واحدة؛ يقوم التسويق بإنشاء الحملات وتكرارها بناءً عليه إلى أجل غير مسمى. يحتوي دليل الحملات المشغلة بالأحداث على التصنيف الكامل، وتوصيلات عربة التسوق، والإعداد، واستعادة العملاء.

ماذا تفعل الآن بعد أن أصبح لديك SDK لإشعارات دفع لنظام iOS

التكامل هو البداية، وليس خط النهاية. التسلسل الذي يحقق أسرع عائد: احمِ معدل الموافقة الخاص بك من خلال تدفق إذن مُجهز، قم بتشغيل تسلسل التخلي عن عربة التسوق (الحملة ذات أعلى عائد استثمار لتطبيقات التجارة)، وأضف تتبع الأهداف حتى تقوم كل حملة بالإبلاغ عن الإيرادات بدلاً من الفتحات، ثم قم ببناء دورة الحياة - سلسلة الإعداد في الواجهة الأمامية، واستعادة العملاء في الواجهة الخلفية. يغطي دليل تسويق دفع التطبيقات طبقة الاستراتيجية هذه من البداية إلى النهاية، ويوضح توثيق الإعداد كل شاشة في لوحة التحكم. كل خطة مدفوعة تأتي مع ضمان استعادة الأموال لمدة 14 يومًا - والـ SDK مرخص بموجب MIT على GitHub، لذا يمكنك قراءة ما تقوم بتشغيله بالضبط.