สร้าง In-app ด้วย JavaScript

ข้อความ In-app จะแสดงโดยตรงภายในอินเทอร์เฟซของแอปในขณะที่ผู้ใช้กำลังโต้ตอบกับแอปอยู่ ด้วยเหตุนี้ ผู้ใช้จึงมองว่า In-app ไม่เป็นการรบกวนเท่ากับการแจ้งเตือนแบบพุช (push notifications), อีเมล หรือ SMS

ข้อความ In-app มักจะมีรูปภาพหรือวิดีโอที่เรียกว่า Rich Media เสมอ In-app ยังสามารถรวมข้อความที่จัดรูปแบบ, ลิงก์, ปุ่มพร้อม CTA และข้อมูลอื่นๆ ซึ่งช่วยให้คุณสามารถสื่อสารกับผู้ใช้แอปของคุณในรูปแบบที่น่าสนใจได้

In-App เป็นแบบ HTML และรองรับ JavaScript Pushwoosh SDK จะแทรกตัวแปร pushwoosh ซึ่งมี API ดังต่อไปนี้:

คุณสามารถใช้เมธอด postEvent เพื่อส่ง event ใหม่ได้โดยตรงจากโค้ด JavaScript ของ In-App

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 เพื่อตั้งค่า tag สำหรับอุปกรณ์จาก In-app ได้:

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

หากต้องการรับ tag ของอุปกรณ์ ให้ใช้เมธอด getTags ดังนี้:

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

หากคุณต้องการปิด In-app จากโค้ด JavaScript ให้เรียกใช้เมธอด closeInApp():

pushwoosh.closeInApp();

หรือเพียงแค่ใช้ URL แบบ custom scheme สำหรับปุ่ม/ลิงก์ <a href="pushwoosh://close">

หากต้องการขออนุญาตส่งพุช (push permission) จากภายใน In-app (ตัวอย่างเช่น ข้อความขออนุญาตล่วงหน้า (pre-permission message) ที่แสดงก่อนที่ระบบจะแจ้งเตือน) ให้เรียกใช้ registerForPushNotifications():

pushwoosh.registerForPushNotifications();

เมธอดนี้ไม่รับอาร์กิวเมนต์ใดๆ และจะทริกเกอร์การแจ้งเตือนขออนุญาตของแพลตฟอร์ม บน iOS, SDK จะปิด In-app โดยอัตโนมัติเมื่อคุณเรียกใช้ ดังนั้นการเรียก closeInApp() เพิ่มเติมจึงเป็นทางเลือกและไม่มีผลเสียใดๆ บน Android, In-app จะยังคงเปิดอยู่จนกว่าคุณจะเรียก closeInApp() ด้วยตนเอง

เมื่อส่งการแจ้งเตือนแบบพุช (push notification) พร้อม Rich Media คุณสามารถรับข้อมูลที่กำหนดเอง (custom data) ของพุชนั้นได้ด้วยโค้ดต่อไปนี้: pushwoosh.getCustomData()

อินเทอร์เฟซ JavaScript ที่กำหนดเอง

ฟังก์ชันการทำงานของ JavaScript ใน In-App Messages สามารถขยายได้อย่างไม่จำกัดโดยการเปิดเผยเมธอดเนทีฟของ Java/Objective-C/Swift ให้กับ JavaScript ซึ่งสามารถทำได้ด้วยเมธอด addJavascriptInterface ของ Pushwoosh SDK สำหรับ iOS และ Android