เพิ่มอุปกรณ์ทดสอบพุช

คุณสามารถใช้ Test Devices เพื่อดูตัวอย่างว่าการแจ้งเตือนพุชมีลักษณะอย่างไรบนอุปกรณ์ก่อนที่จะส่งไปยังผู้ใช้แอป ในการทำเช่นนั้น คุณต้อง ลงทะเบียนอุปกรณ์ของคุณ (ที่ติดตั้งแอปของคุณไว้) เป็น Test Device

หมายเหตุ

คู่มือนี้ครอบคลุมอุปกรณ์ทดสอบพุช อุปกรณ์ทดสอบอีเมลและ SMS ไม่จำเป็นต้องมีการผสานรวมฝั่งแอป — ดู อุปกรณ์ทดสอบอีเมล และ อุปกรณ์ทดสอบ SMS ในเอกสารผลิตภัณฑ์

ในการเพิ่มอุปกรณ์ทดสอบ:

1. ไปที่ส่วน Test devices ในบัญชี Pushwoosh ของคุณ

2. คลิกปุ่มดรอปดาวน์ Create test device ที่มุมขวาบนและเลือก Push

คุณสามารถเพิ่มอุปกรณ์ทดสอบพุชได้โดยใช้วิธีใดวิธีหนึ่งจากสามวิธี: การกำหนดค่าอัตโนมัติด้วย QR code, การลงทะเบียนจากแอป หรือการกำหนดค่าด้วยตนเอง

การเพิ่มอุปกรณ์ทดสอบโดยอัตโนมัติ

วิธีนี้เหมาะสำหรับอุปกรณ์ iOS และ Android เท่านั้น

ก่อนการลงทะเบียนครั้งแรกของคุณ ให้เพิ่มการจัดการ deep link สำหรับอุปกรณ์ทดสอบลงในแอป — เป็นการตั้งค่าครั้งเดียว ซึ่งโดยปกติจะทำพร้อมกับการผสานรวม Pushwoosh SDK:

• สำหรับ Android: เพิ่ม DeepLinkActivity ไปยังไฟล์ AndroidManifest.xml
• สำหรับ iOS: เพิ่ม pushwoosh-YOUR_PUSHWOOSH_APP_ID URL scheme ไปยังไฟล์ Info.plist

ทำตามคำแนะนำสำหรับ Android และ iOS ใน ส่วนการนำไปใช้งาน

เมื่อเสร็จแล้ว ในการลงทะเบียนอุปกรณ์:

1. ในส่วน Test Devices คลิก Create test device และเลือก Push
2. สแกน QR code ที่ปรากฏในป๊อปอัปด้วยแอปสแกน QR ใดก็ได้ การทำเช่นนี้จะเปิด deep link ที่ Pushwoosh SDK จะแยกวิเคราะห์เพื่อลงทะเบียนอุปกรณ์ของคุณเป็นอุปกรณ์ทดสอบ

Tip for QR Readers

ตรวจสอบให้แน่ใจว่าลิงก์ที่สแกนเปิดในเบราว์เซอร์ของเครื่อง ไม่ใช่ใน webview ของตัวอ่าน QR ตัวอ่าน QR จำนวนมากมีปุ่ม “Open in Browser” เพื่อจุดประสงค์นี้

การลงทะเบียนอุปกรณ์ทดสอบจากแอป

นอกเหนือจากวิธี QR code ข้างต้น Pushwoosh SDK สามารถลงทะเบียนอุปกรณ์ปัจจุบันเป็นอุปกรณ์ทดสอบได้ด้วยตัวเอง: โดยการส่งแอปไปที่พื้นหลังและนำกลับมาที่เบื้องหน้า 6 ครั้งภายใน 30 วินาที ไม่จำเป็นต้องสแกนหรือป้อนข้อมูลด้วยตนเอง

เพื่อป้องกันการลงทะเบียนโดยไม่ได้ตั้งใจ วิธีนี้จะทำงานเฉพาะเมื่อหน้าต่างการลงทะเบียน 1 ชั่วโมงเปิดอยู่เท่านั้น

1. ใน ส่วน Test Devices ให้เปิดสวิตช์ Add test devices from the app การทำเช่นนี้จะเปิดหน้าต่างเป็นเวลา 1 ชั่วโมง

ข้อควรระวัง

การเปิดสวิตช์ต้องได้รับอนุญาตให้แก้ไขแอปพลิเคชัน หากไม่มีสิทธิ์ คำขอจะล้มเหลวพร้อมข้อผิดพลาด “user cannot modify application” หน้าต่างจะเปิดอยู่เป็นเวลา 1 ชั่วโมงแล้วปิดโดยอัตโนมัติ ในขณะที่ปิดอยู่ การเรียกใช้การลงทะเบียนของแอปจะยังคงส่งคืนค่าสำเร็จ แต่จะไม่มีการลงทะเบียนอุปกรณ์

2. ในขณะที่หน้าต่างเปิดอยู่ ให้ส่งแอปไปที่พื้นหลังและนำกลับมาที่เบื้องหน้า 6 ครั้งภายใน 30 วินาที อุปกรณ์จะถูกเพิ่มไปยังรายการ Test Devices

การเพิ่มอุปกรณ์ทดสอบด้วยตนเอง

หากคุณต้องการลงทะเบียนอุปกรณ์ทดสอบด้วยตนเอง ให้ทำตามขั้นตอนเหล่านี้:

1. รับ Hardware ID (HWID) ของอุปกรณ์จากการเรียก API /registerDevice ที่สำเร็จ
2. กรอกข้อมูลในช่องที่จำเป็น:
   • Device Name: ชื่อที่สื่อความหมายสำหรับอุปกรณ์ทดสอบ (เช่น “John’s Android”)
   • Device HWID: Hardware ID ที่ไม่ซ้ำกันของอุปกรณ์
   • Device Type: เลือกแพลตฟอร์ม (เช่น iOS, Android, Web)
   • Description (Optional): เพิ่มบันทึกหรือรายละเอียดเกี่ยวกับอุปกรณ์เพื่อการอ้างอิง
3. คลิก Save เพื่อลงทะเบียนอุปกรณ์ทดสอบ

เมื่อลงทะเบียนแล้ว อุปกรณ์ทดสอบจะพร้อมใช้งานในส่วน Test Devices

การลงทะเบียนอุปกรณ์ทดสอบผ่าน API

หากต้องการจัดเตรียมอุปกรณ์ทดสอบจากสคริปต์หรือ CI pipeline แทนการใช้ฟอร์มด้วยตนเอง ให้เรียกใช้ createTestDevice พร้อมด้วย push token ของอุปกรณ์ — ไม่ใช่ HWID ที่ใช้ในฟอร์มด้วยตนเอง ซึ่งเป็นตัวระบุที่แตกต่างกันที่ได้รับในลักษณะเดียวกัน เช่น จากการเรียก /registerDevice ที่สำเร็จ listTestDevices จะส่งคืนสิ่งที่ลงทะเบียนไว้แล้วสำหรับแอปพลิเคชัน

การนำไปใช้งาน

Android

1. ผสานรวม Pushwoosh SDK กับแอปพลิเคชันของคุณ

2. เพิ่ม DeepLinkActivity ไปยัง AndroidManifest.xml ของคุณ:

<activity
          android:name="com.pushwoosh.DeepLinkActivity"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" >
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="pushwoosh-YOUR_PUSHWOOSH_APP_ID" />
  </intent-filter>
</activity>

อย่าลืมแทนที่ YOUR_PUSHWOOSH_APP_ID ใน xml ข้างต้นด้วย Pushwoosh App ID ของคุณ
ตัวอย่าง: <data android:scheme=“pushwoosh-ABCDE-EDCBA” />

3. เปิดแอปพลิเคชันเพื่อสมัครรับการแจ้งเตือนพุช

4. สแกน QR Code ในฟอร์ม Test Devices โดยใช้แอปสแกน QR Code ที่เหมาะสม* ข้อความ toast จะปรากฏขึ้นเพื่อระบุสถานะการลงทะเบียนอุปกรณ์ทดสอบ

* แอปสแกน QR code ส่วนใหญ่จัดการกับ deep link ดังกล่าวได้อย่างถูกต้อง นี่คือตัวอย่างบางส่วน:

• QR & Barcode Scanner, Gamma Play
• QR & Barcode Scanner, Maker, AppSourceHub

iOS

1. ผสานรวม Pushwoosh SDK กับแอปพลิเคชันของคุณ

2. เพิ่ม pushwoosh-YOUR_PUSHWOOSH_APP_ID URL scheme ไปยังไฟล์ Info.plist:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>com.pushwoosh.scheme</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>pushwoosh-YOUR_PUSHWOOSH_APP_ID</string>
    </array>
  </dict>
</array>

อย่าลืมแทนที่ YOUR_PUSHWOOSH_APP_ID ใน XML ข้างต้นด้วย Pushwoosh App ID ของคุณ
ตัวอย่าง: pushwoosh-ABCDE-EDCBA

ข้อควรระวัง

หากโปรเจกต์ของคุณสร้างด้วย SwiftUI (เท่านั้น) คุณต้องเพิ่ม SceneDelegate

SwiftUI จัดการวงจรชีวิตของแอปแตกต่างจาก UIKit เพื่อให้แน่ใจว่าเหตุการณ์ของระบบบางอย่างทำงานได้อย่างถูกต้อง — เช่น การลงทะเบียนอุปกรณ์ทดสอบสำหรับการแจ้งเตือนพุชหรือการจัดการ deep link — คุณต้องเพิ่มและลงทะเบียน SceneDelegate อย่างชัดเจน

หากไม่มีสิ่งนี้ เหตุการณ์เหล่านี้อาจไม่ถูกทริกเกอร์อย่างถูกต้อง และการลงทะเบียนพุชอาจล้มเหลว

หากคุณไม่ได้ใช้ SwiftUI คุณสามารถข้ามขั้นตอนนี้และไปที่ ขั้นตอนที่ 3 ได้โดยตรง

Info.plist

เพิ่ม UIApplicationSceneManifest ไปยัง Info.plist ของคุณ

  <key>UIApplicationSceneManifest</key>
  <dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
      <key>UIWindowSceneSessionRoleApplication</key>
      <array>
        <dict>
          <key>UISceneConfigurationName</key>
          <string></string>
          <key>UISceneDelegateClassName</key>
          <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
        </dict>
      </array>
    </dict>
  </dict>

SceneDelegate

เพิ่มโค้ด SceneDelegate ตามที่แสดงในตัวอย่างด้านล่าง

import SwiftUI

@main
struct DemoApp: App {
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
      WindowGroup {
          ContentView()
      }
  }
}

class SceneDelegate: NSObject, UIWindowSceneDelegate {

  var window: UIWindow?

  func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
      guard let _ = (scene as? UIWindowScene) else { return }
  }
}

class AppDelegate: NSObject, UIApplicationDelegate, PWMessagingDelegate {

  func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
      let sceneConfig: UISceneConfiguration = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role)
      sceneConfig.delegateClass = SceneDelegate.self
      return sceneConfig
  }

}

3. เปิดแอปพลิเคชันเพื่อสมัครรับการแจ้งเตือนพุช

4. สแกน QR Code ในฟอร์ม Test Devices โดยใช้เครื่องสแกน QR Code ที่เหมาะสม