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

لقد قدمنا الحالة الاستراتيجية في مكان آخر: لقد ولّى عصر الإعلانات الجماعية، والإشعارات المستندة إلى السلوك هي ما تكافئه المنصات ويتحمله المشتركون. هذا الدليل هو النصف الآخر - كيفية تشغيل الإشعارات الفورية فعليًا من أحداث التطبيق على نظام iOS، من الأدوات إلى تسليم التسويق. إنه مكتوب للمطور الذي يقوم بالربط، مع الكود الذي ستقوم بشحنه والاتفاقيات التي تحافظ على قابليته للصيانة.

الهندسة المعمارية في فقرة واحدة

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

trackEvent: الإشارة العامة

قدم حزمة تطوير البرامج لنظام iOS 1.0 `trackEvent`، وهي الأداة الرئيسية للإشارات السلوكية المخصصة:

PushEngage.trackEvent(name: "product_viewed",
                      properties: [
                        "sku": "WCJ-1042",
                        "category": "outerwear",
                        "price": 189.00,
                        "in_stock": true
                      ],
                      profileId: currentUserId,   // ties the event to an identified subscriber
                      provider: nil,
                      eventType: nil) { success, error in
    if !success { log(error) }
}

ثلاث قواعد تفرضها حزمة تطوير البرامج، لذا صممها مسبقًا:

• يجب أن تكون قيم الخصائص سلاسل نصية أو أرقامًا أو قيمًا منطقية. يتم رفض المصفوفات والقواميس والتواريخ من جانب العميل - قم بتسطيحها قبل إرسالها.
• يجب أن تكون أسماء الأحداث ومفاتيح الخصائص غير فارغة. يخبرك معالج الإكمال عند فشل التحقق؛ قم بتسجيله في إصدارات التصحيح.
• تصل معالجات الإكمال إلى قائمة انتظار خلفية. قم بالإرسال إلى الواجهة الرئيسية قبل لمس واجهة المستخدم.

مرر `profileId` كلما تم تحديد المستخدم - فهذا ما يسمح للحملة بتتبع العميل عبر الأجهزة بدلاً من تتبع جهاز.

sendTriggerEvent: ربط حملات التشغيل الكلاسيكية

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

let trigger = TriggerCampaign(campaignName: "cart_abandonment",
                              eventName: "add_to_cart",
                              data: [
                                "productname": "Waxed Canvas Jacket",
                                "price": "$189",
                                "cartlink": "myapp://cart"
                              ])

PushEngage.sendTriggerEvent(triggerCampaign: trigger) { success, error in
    // background queue — dispatch before UI work
}

تتدفق رموز `data` إلى نص الإشعار - هذه هي الطريقة التي يتم بها تخصيص "سترتك القماش المشمع الخاصة بك في انتظارك" دون أن يلمس المسوق الكود. لقد قمنا بتغطية تسلسل استعادة سلة التسوق بالكامل في دليل التخلي عن سلة التسوق للتطبيقات المحمولة؛ هذا الاستدعاء هو محركه.

addAlert: انخفاض الأسعار والعودة إلى المخزون، مدمجة

أعلى محفزين للتجارة من حيث النية لا يحتاجان حتى إلى حملات مخصصة - فهما مواطنان من الدرجة الأولى في حزمة تطوير البرامج. عندما يشاهد المستخدم منتجًا، قم بتسجيل التنبيه:

let alert = TriggerAlert(type: .priceDrop,        // or .inventory
                         productId: "WCJ-1042",
                         link: "myapp://product/WCJ-1042",
                         price: 189.00,
                         data: ["size": "M"])

PushEngage.addAlert(triggerAlert: alert) { success, error in }

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

تصنيف أحداث قابل للتوسع

ديون الأدوات حقيقية: بعد ستة أشهر، لا أحد يتذكر ما إذا كان الحدث هو addToCart، أو cart_add، أو CartUpdated. اختر الاتفاقيات من اليوم الأول — أسماء snake_case، ترتيب object_action، مفاتيح خصائص فردية — وغطِ مجموعة التجارة الأساسية:

الحدث	الخصائص الرئيسية	الحملات التي يدعمها
product_viewed	sku، category، price	التخلي عن التصفح، التخصيص
product_saved	sku، price	انخفاض السعر، العودة إلى المخزون، خطافات استعادة العملاء
cart_updated	cart_value، item_count، top_item	التخلي عن عربة التسوق
purchase_completed	order_value، item_count	شروط الخروج، ما بعد الشراء، الأهداف
search_performed	query، results_count	استعادة النتائج الصفرية، شرائح الاهتمام
onboarding_step	step، completed	تفرع سلسلة الإعداد

ستة أحداث، تم قياسها مرة واحدة، تدعم سلسلة الإعداد، واستعادة سلة التسوق، وخطافات استعادة العملاء، وكل شريحة سيطلبها فريق التسويق الخاص بك هذا العام.

اختبر الحلقة قبل تسليمها

قم بتعيين PushEngage.enableLogging = true في إصدارات التصحيح وراقب الأحداث وهي تغادر الجهاز. قم بتشغيل كل حدث من إصدار اختبار، وتأكد من وصوله إلى عرض الأحداث في لوحة التحكم، وأرسل حملة اختبار واحدة شاملة لكل مشغل. تتضمن تطبيقات العينة في مستودع SDK شاشة مشغل عامل يمكنك استعارة التدفق منها. خمسة عشر دقيقة من التحقق هنا توفر التحقيق "لماذا لم يتم تشغيل الحملة" لاحقًا — والذي عادة ما يكون اسم حدث به خطأ إملائي على أحد جانبي العقد.

التسليم: ما يمتلكه قسم التسويق من هنا

بمجرد تدفق الأحداث، ينتهي دورك. يقوم قسم التسويق ببناء قواعد المشغلات، وكتابة النصوص، وتعيين التأخيرات وشروط الخروج، واختبار A/B للمتغيرات، وإرفاق تتبع الأهداف لتتبع الإيرادات — كل ذلك في لوحة التحكم، وكل ذلك بدون تذكرة. انشر جدول تصنيف الأحداث في ويكي فريقك كعقد بين الجانبين. ثم راقب قائمة انتظار الطلبات لطلبات "هل يمكنك إرسال دفعة؟" تختفي بهدوء إلى الصفر — وهو ما كان الهدف منه طوال الوقت. بالنسبة للاستراتيجية التي يجب أن تتبعها تلك الحملات، سلم فريق التسويق الخاص بك دليل تسويق دفعات التطبيق.