iOS SDK คำถามที่พบบ่อย

คำถามที่พบบ่อยเกี่ยวกับการผสานรวม iOS

ถาม: ฉันจะติดตั้ง Pushwoosh SDK ในโปรเจกต์ iOS ของฉันได้อย่างไร?

คุณสามารถผสานรวม Pushwoosh SDK โดยใช้ Swift Package Manager หรือ CocoaPods ก็ได้

ถาม: ฉันจะติดตั้ง Pushwoosh SDK โดยใช้ Swift Package Manager ได้อย่างไร?

ใน Xcode ไปที่ส่วน Package Dependencies และเพิ่ม package โดยใช้ URL ต่อไปนี้: https://github.com/Pushwoosh/Pushwoosh-XCFramework

ถาม: ฉันจะติดตั้ง Pushwoosh SDK โดยใช้ CocoaPods ได้อย่างไร?

เปิด Podfile ของโปรเจกต์ของคุณและเพิ่มบรรทัด pod 'PushwooshXCFramework' จากนั้นรันคำสั่ง pod install ใน terminal

ถาม: ฉันต้องเพิ่ม capabilities ใดบ้างในโปรเจกต์ของฉันเพื่อเปิดใช้งาน Push Notifications?

ในส่วน Signing & Capabilities ของการตั้งค่าโปรเจกต์ คุณต้องเพิ่ม capabilities Push Notifications และ Background Modes เมื่อเพิ่ม Background Modes ตรวจสอบให้แน่ใจว่าคุณได้เลือกช่องสำหรับ Remote notifications

ถาม: ต้องใช้ capability เพิ่มเติมใดสำหรับ Time Sensitive Notifications?

หากคุณต้องการใช้ Time Sensitive Notifications (iOS 15+) คุณต้องเพิ่ม capability Time Sensitive Notifications ด้วย

ถาม: ฉันต้องเพิ่มโค้ดเริ่มต้นของ Pushwoosh ที่ไหน?

โค้ดเริ่มต้นต้องถูกเพิ่มในคลาส AppDelegate ของคุณ

ถาม: ฉันควรเพิ่มโค้ดเริ่มต้นใดใน AppDelegate ของ SwiftUI?

โปรดดู ตัวอย่างโค้ด Swift ที่ให้ไว้สำหรับการผสานรวม Pushwoosh ในโปรเจกต์ SwiftUI

ถาม: ฉันควรเพิ่มโค้ดเริ่มต้นใดใน AppDelegate ของ Swift มาตรฐาน?

โปรดดู ตัวอย่างโค้ด Swift ที่ให้ไว้สำหรับการผสานรวม Pushwoosh ในโปรเจกต์ Swift มาตรฐาน

ถาม: ฉันควรเพิ่มโค้ดเริ่มต้นใดใน AppDelegate ของ Objective-C?

โปรดดู ตัวอย่างโค้ด Objective-C ที่ให้ไว้สำหรับการผสานรวม Pushwoosh ในโปรเจกต์ Objective-C

ถาม: ฉันต้องเพิ่ม key ใดบ้างในไฟล์ Info.plist ของฉัน?

คุณต้องเพิ่ม key Pushwoosh_APPID ที่ตั้งค่าเป็น Application Code ของคุณ และ key PW_API_TOKEN ที่ตั้งค่าเป็น API Token ของคุณในไฟล์ Info.plist ของแอป

ถาม: วัตถุประสงค์ของการติดตามการส่งข้อความคืออะไร?

Pushwoosh รองรับการติดตามเหตุการณ์การส่งสำหรับ push notifications โดยใช้ Notification Service Extension

ถาม: ฉันจะเพิ่ม Notification Service Extension ในโปรเจกต์ของฉันได้อย่างไร?

ใน Xcode ไปที่ File > New > Target… เลือก Notification Service Extension และกด Next ป้อนชื่อ target แล้วกด Finish เมื่อถูกถามให้เปิดใช้งาน ให้กด Cancel

ถาม: ฉันจะเพิ่ม Pushwoosh SDK ใน Notification Service Extension ได้อย่างไร?

เพิ่ม ตัวอย่างโค้ด Swift หรือ Objective-C ที่ให้ไว้ ในไฟล์หลัก .swift หรือ .m ของ Notification Service Extension ของคุณ โค้ดนี้ใช้ PWNotificationExtensionManager เพื่อจัดการกับคำขอการแจ้งเตือน

ถาม: วัตถุประสงค์ของ App Groups คืออะไร?

capability ของ App Groups จำเป็นเพื่อให้ Notification Service Extension สามารถสื่อสารกับแอปพลิเคชันหลักได้

ถาม: ฉันจะเปิดใช้งาน App Groups สำหรับ target หลักและ Notification Service Extension ของฉันได้อย่างไร?

สำหรับทั้งสอง targets ไปที่ Signing & Capabilities เพิ่ม capability App Groups และสร้างกลุ่มใหม่โดยกดปุ่ม + ตรวจสอบให้แน่ใจว่าชื่อกลุ่มขึ้นต้นด้วย group. และใช้ชื่อกลุ่มเดียวกันสำหรับทั้งสอง targets

ถาม: ฉันต้องเพิ่ม key ใดบ้างใน Info.plist ของ target หลักสำหรับ App Groups?

ใน Info.plist ของ target หลักของคุณ ให้เพิ่ม key PW_APP_GROUPS_NAME และตั้งค่าเป็นชื่อกลุ่ม App Groups ของคุณ

ถาม: ฉันต้องเพิ่ม key ใดบ้างใน Info.plist ของ Notification Service Extension ของฉัน?

ใน Info.plist ของ Notification Service Extension ของคุณ ให้เพิ่ม key PW_APP_GROUPS_NAME (ตั้งค่าเป็นชื่อ App Groups ของคุณ) และ key Pushwoosh_APPID (ตั้งค่าเป็น Application Code ของคุณ)

ถาม: ฉันจะตรวจสอบการผสานรวม Pushwoosh ได้อย่างไร?

หลังจาก build และ run โปรเจกต์ของคุณแล้ว ให้ไปที่ Pushwoosh Control Panel และส่ง push notification ไปยังแอปพลิเคชันของคุณ คุณควรจะเห็นการแจ้งเตือนปรากฏบนอุปกรณ์ของคุณ

ถาม: callback หลักสองตัวสำหรับจัดการ push notifications ใน Pushwoosh SDK คืออะไร?

callback หลักสองตัวคือ onMessageReceived และ onMessageOpened

ถาม: callback onMessageReceived ถูกเรียกใช้เมื่อใด?

เมธอด onMessageReceived จะถูกเรียกเมื่อแอปพลิเคชันได้รับการแจ้งเตือนแบบ push

ถาม: callback onMessageOpened ถูกเรียกใช้เมื่อใด?

เมธอด onMessageOpened จะถูกเรียกเมื่อผู้ใช้โต้ตอบและเปิดการแจ้งเตือนแบบ push

ถาม: ฉันจะเข้าถึง payload ของ push notification ที่ได้รับหรือเปิดได้อย่างไร?

payload ของอ็อบเจกต์ PWMessage (ที่ส่งไปยัง callback onMessageReceived และ onMessageOpened) สามารถเข้าถึงได้ผ่าน property payload ของมัน

ถาม: ฉันจะตั้งค่า User ID ใน Pushwoosh ได้อย่างไร?

ใช้เมธอด setUserId(_:) ของอ็อบเจกต์ Pushwoosh.sharedInstance() โดยส่ง ID ของผู้ใช้เป็น argument

ถาม: ฉันจะตั้งค่าที่อยู่อีเมลของผู้ใช้ใน Pushwoosh ได้อย่างไร?

ใช้เมธอด setEmail(_:) ของอ็อบเจกต์ Pushwoosh.sharedInstance() โดยระบุอีเมลของผู้ใช้

ฉันจะตั้งค่าข้อมูลผู้ใช้เพิ่มเติมเป็น tags ใน Pushwoosh ได้อย่างไร?

ใช้เมธอด setTags(_:) ของอ็อบเจกต์ Pushwoosh.sharedInstance() โดยส่ง dictionary ที่มี key เป็นชื่อ tag และ value เป็นค่า tag ที่สอดคล้องกัน

ฉันจะติดตาม event ของผู้ใช้พร้อมกับ attributes เพิ่มเติมได้อย่างไร?

ใช้เมธอด postEvent(_:withAttributes:) ของ PWInAppManager.shared() โดยระบุชื่อ event (เช่น "login") และ dictionary ของ attributes (เช่น "name", "last_login")

ถาม: ฉันจะติดตาม event การซื้อของผู้ใช้พร้อมกับรายละเอียดสินค้าได้อย่างไร?

ใช้เมธอด postEvent(_:withAttributes:) ของ PWInAppManager.shared() ด้วยชื่อ event "purchase" และ dictionary ที่มีรายละเอียดสินค้าเช่น "product_id", "product_name", "price" และ "quantity"

ถาม: ฉันจะตั้งค่า delegate เพื่อจัดการการนำเสนอ rich media ได้อย่างไร?

ใน view controller ของคุณหรือคลาสอื่นที่เหมาะสม ให้สอดคล้องกับโปรโตคอล PWRichMediaPresentingDelegate และตั้งค่า property delegate ของ PWRichMediaManager.shared() เป็น instance ที่สอดคล้องของคุณ

ถาม: ฉันจะกำหนดค่ารูปแบบการนำเสนอของ rich media ได้อย่างไร?

ใช้อ็อบเจกต์ PWModalWindowConfiguration.shared() เพื่อกำหนดค่า properties เช่น ตำแหน่งหน้าต่าง modal และ animation การแสดง/ซ่อน โดยใช้เมธอด configureModalWindow(with:present:dismiss:)

ถาม: ฉันสามารถเข้าถึงข้อมูลใดได้บ้างในเมธอด delegate ของ rich media?

เมธอด delegate ให้การเข้าถึงอ็อบเจกต์ PWRichMedia ซึ่งมีข้อมูลเกี่ยวกับเนื้อหา rich media รวมถึง pushPayload ของมัน เมธอด presentingDidFailForRichMedia:withError: ยังให้ Error object ที่อธิบายความล้มเหลวด้วย

การแก้ไขปัญหา

ข้อควรระวัง

เพื่อวัตถุประสงค์ในการทำ load balancing เราอาจต้องเปลี่ยน API endpoints ในแอปพลิเคชันของคุณ สิ่งนี้เกิดขึ้นโดยอัตโนมัติและจัดการโดย SDK ของเรา โปรดตรวจสอบให้แน่ใจว่าไม่มีอะไรในแอปของคุณที่บล็อกการเข้าถึง URL ใดๆ ที่มี *.pushwoosh.com

หมายเหตุ

หากคุณอยู่หลัง Firewall หรือเราเตอร์ WiFi ของคุณทำหน้าที่เป็น Firewall

หากอุปกรณ์ของคุณเชื่อมต่อกับอินเทอร์เน็ตผ่าน WiFi และข้อความไม่ส่งถึงอุปกรณ์ โปรดตรวจสอบให้แน่ใจว่าพอร์ต APNs ไม่ได้ถูกบล็อกโดย firewall ของคุณ
ผู้ให้บริการ Push, อุปกรณ์ iOS และคอมพิวเตอร์ Mac มักจะอยู่หลัง firewalls ในการส่งการแจ้งเตือน คุณจะต้องอนุญาตแพ็กเก็ต TCP ขาเข้าและขาออกผ่านพอร์ต 2195 อุปกรณ์และคอมพิวเตอร์ที่เชื่อมต่อกับบริการ push ผ่าน Wi-Fi จะต้องอนุญาตแพ็กเก็ต TCP ขาเข้าและขาออกผ่านพอร์ต 5223
ช่วงที่อยู่ IP สำหรับบริการ push สามารถเปลี่ยนแปลงได้ ผู้ให้บริการควรเชื่อมต่อด้วยชื่อโฮสต์แทนที่อยู่ IP บริการ Push ใช้รูปแบบ load balancing ที่ให้ที่อยู่ IP ที่แตกต่างกันสำหรับชื่อโฮสต์เดียวกัน อย่างไรก็ตาม บล็อกที่อยู่ 17.0.0.0/8 ทั้งหมดถูกกำหนดให้กับ Apple ดังนั้นคุณสามารถระบุช่วงนั้นในกฎ firewall ของคุณได้

ถาม: ข้อผิดพลาด “Your provisioning profile does not have APS entry”

หากคุณเห็นข้อความแสดงข้อผิดพลาด “Your provisioning profile does not have APS entry.” ตรวจสอบให้แน่ใจว่า provisioning profile ของคุณเข้ากันได้กับ push และมีสตริง aps-environment อยู่ในนั้นพร้อมกับค่า production หรือ development วิธีที่ง่ายที่สุดในการตรวจสอบคือการเปิดไฟล์ mobile provisioning profile ในโปรแกรมแก้ไขข้อความใดๆ และมองหาสตริง aps-environment มันควรจะอยู่ที่นั่น

หากมีอยู่แล้ว และคุณยังคงได้รับข้อผิดพลาด แสดงว่า XCode ยังคงเลือกโปรไฟล์ที่ “ไม่เข้ากันกับ push” โปรดตรวจสอบให้แน่ใจว่าคุณ sign ด้วยโปรไฟล์ที่ถูกต้อง - บางครั้งหากคุณมีสองโปรไฟล์สำหรับ App ID เดียวกัน XCode อาจทำให้เกิดความสับสนและ sign ด้วยโปรไฟล์เก่า

ขั้นตอนที่แนะนำคือ:

1. ลบ โปรไฟล์ XCode ทั้งหมด;
2. เพิ่มโปรไฟล์ใหม่เพียงโปรไฟล์เดียว;
3. Rebuild แอป

ถาม: iOS push token และ hwid มีลักษณะอย่างไร?

iOS device push token เป็นสตริงที่มีสัญลักษณ์เลขฐานสิบหก 64 ตัวอย่างของ Push token:
03df25c845d460bcdad7802d2vf6fc1dfde97283bf75cc993eb6dca835ea2e2f
ตรวจสอบให้แน่ใจว่า iOS push token ที่คุณใช้เมื่อกำหนดเป้าหมายอุปกรณ์เฉพาะในคำขอ API ของคุณเป็นตัวพิมพ์เล็ก

Pushwoosh ใช้ IDFV เป็น HWID ของอุปกรณ์ โปรดทราบว่าอาจมีการเปลี่ยนแปลงในกรณีที่ผู้ใช้ติดตั้งแอปทั้งหมดจากผู้จำหน่ายรายเดียวกันใหม่

CBAF8ED1-17FB-49A3-73BD-DC79B63AEF93

ถาม: ฉันจะเปิดและปิดแบนเนอร์เมื่อแอปของฉันกำลังทำงานได้อย่างไร?

โดยค่าเริ่มต้น iOS SDK ล่าสุดของเราจะแสดงแบนเนอร์การแจ้งเตือนเมื่อแอปกำลังทำงานในเบื้องหน้า
คุณสามารถควบคุมพฤติกรรมนี้ได้โดยการเปลี่ยน flag ต่อไปนี้ใน Info.plist:

Flag Pushwoosh_ALERT_TYPE – ประเภทสตริง, ค่าคือ:

• BANNER – ค่าเริ่มต้น, แสดงการแจ้งเตือนในแอปแบบแบนเนอร์
• ALERT – การแจ้งเตือนแบบ alert
• NONE – ไม่แสดงการแจ้งเตือนเมื่อแอปอยู่ในเบื้องหน้า

ถาม: ฉันจะรับ iOS device push token ของฉันเพื่อใช้ใน Test Devices ได้อย่างไร?

ในการรับ iOS device push token ของคุณ,

1. เปิด Xcode => Devices & Simulators;
2. เชื่อมต่ออุปกรณ์ทดสอบกับคอมพิวเตอร์ของคุณ;
3. เลือกอุปกรณ์ที่เชื่อมต่อของคุณในรายการอุปกรณ์ทางด้านซ้าย;
4. คลิกปุ่ม Open Console

เปิดแอปพลิเคชันที่คุณต้องการ device push token และค้นหา device push token ที่เป็นอักขระเลขฐานสิบหก 64 ตัวของคุณในบรรทัด “Registered for push notifications”:

ถาม: ทำไม badges ไม่ถูกล้างหลังจากที่ฉันถอนการติดตั้งแอปและติดตั้งใหม่ในระยะเวลาสั้นๆ?

นี่เป็นพฤติกรรมที่คาดไว้ - badges ถูกจัดการโดย iOS เองและค่าของมันจะถูกเก็บไว้ในการตั้งค่าของแอปพลิเคชัน ซึ่งจะไม่ถูกลบออกทันทีเมื่อคุณถอนการติดตั้งแอปของคุณ ค่า badge จะยังคงอยู่ที่นั่นชั่วขณะหนึ่งในกรณีที่มีการติดตั้งใหม่ทันที ส่งผลให้ badges เดิมยังคงแสดงอยู่หลังจากติดตั้งแอปใหม่