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

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

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

تعتمد الرسائل داخل التطبيق (In-Apps) على 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 notification) مع Rich Media، يمكنك الحصول على البيانات المخصصة (custom data) لهذا الإشعار باستخدام الكود التالي: pushwoosh.getCustomData()

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

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