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

คุณสามารถใช้ 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 พร้อมด้วย HWID หรือ push token ของอุปกรณ์ ฟอร์มด้วยตนเองรับเฉพาะ HWID ในขณะที่ API รับตัวระบุได้ทั้งสองแบบ 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 ที่เหมาะสม