إنشاء رسائل داخل التطبيق باستخدام JavaScript

يتم عرض الرسائل داخل التطبيق (in-app messages) مباشرة داخل واجهة التطبيق أثناء تفاعل المستخدم معه بالفعل. ونتيجة لذلك، يرى المستخدمون أن الرسائل داخل التطبيق أقل تدخلاً من الإشعارات الفورية (push notifications) أو رسائل البريد الإلكتروني أو الرسائل القصيرة (SMS).

تحتوي الرسائل داخل التطبيق دائمًا على صور أو مقاطع فيديو تسمى الوسائط الغنية (Rich Media). يمكن أن تتضمن الرسائل داخل التطبيق أيضًا نصوصًا منسقة وروابط وأزرارًا تحتوي على عبارات تحث المستخدم على اتخاذ إجراء (CTAs) وبيانات أخرى، مما يتيح لك التواصل مع مستخدمي تطبيقك بأشكال جذابة.

تعتمد الرسائل داخل التطبيق على HTML وتدعم JavaScript. يقوم Pushwoosh SDK بحقن متغير pushwoosh الذي يوفر واجهة برمجة التطبيقات (API) التالية:

يمكنك استخدام دالة postEvent لإرسال event جديد مباشرة من كود JavaScript الخاص بالرسالة داخل التطبيق.

pushwoosh.postEvent(
  'eventName',
  {
    TestAttributeString: 'testString',
    TestAttributeInt: 42,
    TestAttributeList: [123, 456, 'someString'],
    TestAttributeBool: true,
    TestAttributeNull: null,
    TestAttributeDaysAgo: 7,
    TestAttributeDate: new Date()
  },
  function() {
    console.log('Post event success')
  },
  function(error) {
    console.log('Post event failed: ', error)
  }
)

يمكنك أيضًا استخدام دالة sendTags لتعيين tags للجهاز من رسالة داخل التطبيق:

pushwoosh.sendTags({
  IntTag: 42,
  BoolTag: true,
  StringTag: 'testString',
  ListTag: ['string1', 'string2']
})

للحصول على tags الجهاز، استخدم دالة getTags كما يلي:

pushwoosh.getTags(
  function(tags) {
    console.log('tags: ' + JSON.stringify(tags))
  },
  function(error) {
    console.log('failed to get tags: ' + error)
  }
)

إذا كنت ترغب في إغلاق رسالة داخل التطبيق من كود JavaScript، فاستدعِ دالة closeInApp():

pushwoosh.closeInApp();

أو ببساطة استخدم مخطط URL المخصص للزر/الرابط <a href="pushwoosh://close">

لطلب إذن الإشعارات الفورية (push permission) من داخل رسالة داخل التطبيق (على سبيل المثال، رسالة طلب إذن مسبق تظهر قبل مطالبة النظام)، استدعِ registerForPushNotifications():

pushwoosh.registerForPushNotifications();

لا تأخذ الدالة أي وسائط وتطلق مطالبة الإذن الأصلية للمنصة. على iOS، يقوم SDK أيضًا بإغلاق الرسالة داخل التطبيق تلقائيًا بمجرد استدعائها، لذا فإن استدعاء closeInApp() إضافي هو أمر اختياري وغير ضار. على Android، تظل الرسالة داخل التطبيق مفتوحة حتى تستدعي closeInApp() بنفسك.

عند إرسال إشعار فوري (push notification) مع وسائط غنية (Rich Media)، يمكنك الحصول على البيانات المخصصة لذلك الإشعار باستخدام الكود التالي: pushwoosh.getCustomData()

واجهة JavaScript المخصصة

يمكن توسيع وظائف JavaScript في رسائل داخل التطبيق (In-App Messages) بشكل غير محدود عن طريق كشف دوال Java/Objective-C/Swift الأصلية لـ JavaScript. يمكن تحقيق ذلك باستخدام دوال addJavascriptInterface الخاصة بـ Pushwoosh SDK لنظامي iOS و Android.