เริ่มต้นใช้งานการรับส่งข้อความในแอปของ Firebase

การเริ่มต้นใช้งานนี้จะแสดงวิธีตั้งค่า Firebase In-App Messaging และส่งข้อความแรก

iOS+ Android Flutter

ก่อนเริ่มต้น

ก่อนเริ่มต้น อย่าลืมเพิ่ม Firebase ลงในโปรเจ็กต์ Apple

เพิ่ม Firebase In-App Messaging SDK ลงในโปรเจ็กต์

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase

ไปที่คู่มือการติดตั้งเพื่อดูวิธีต่างๆ ในการเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Apple ซึ่งรวมถึงการนําเข้าเฟรมเวิร์กโดยตรงและการใช้ CocoaPods

1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ Firebase SDK สําหรับแพลตฟอร์ม Apple ดังนี้

  https://github.com/firebase/firebase-ios-sdk.git

หมายเหตุ: โปรเจ็กต์ใหม่ควรใช้ SDK เวอร์ชันเริ่มต้น (ล่าสุด) แต่คุณจะเลือกเวอร์ชันเก่าก็ได้หากจำเป็น
3. เลือกคลัง In-App Messaging
4. เพิ่ม Flag -ObjC ลงในส่วน Other Linker Flags ของการตั้งค่าบิลด์เป้าหมาย
5. หากต้องการใช้ In-App Messaging คุณต้องเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สําหรับ Google Analytics ลงในแอป โดยสามารถเลือกใช้ไลบรารีที่ไม่มีคอลเล็กชัน IDFA หรือมีคอลเล็กชัน IDFA ก็ได้
6. เมื่อเสร็จแล้ว Xcode จะเริ่มจับคู่ข้อมูลและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

ตอนนี้ให้เริ่มต้น SDK ในแอป โดยทำดังนี้

1. นําเข้าโมดูล Firebase ในApp struct หรือ UIApplicationDelegate หากยังไม่ได้ทําดังนี้

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. นอกจากนี้ ให้กําหนดค่าอินสแตนซ์ที่แชร์ของ FirebaseApp โดยปกติแล้วจะอยู่ในตัวสร้างของ App หรือเมธอด application(_:didFinishLaunchingWithOptions:) ของตัวแทนแอป หากยังไม่ได้ดำเนินการ

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. คอมไพล์และเรียกใช้แอป

หมายเหตุ: Firebase In-App Messaging ต้องใช้ Firebase เวอร์ชัน 5.6.0 ขึ้นไป หากพบปัญหาในการคอมไพล์แอป ให้ลองเรียกใช้ pod update ในไดเรกทอรีโปรเจ็กต์ของแอป อย่างไรก็ตาม โปรดทราบว่าคําสั่งนี้จะอัปเดตทรัพยากร Dependencies ทั้งหมดของแอป ไม่ใช่แค่ของ Firebase

ส่งข้อความทดสอบ

รับรหัสการติดตั้งของแอป

Firebase In-App Messaging จะดึงข้อมูลข้อความจากเซิร์ฟเวอร์เพียงวันละครั้งเพื่อประหยัดพลังงาน ซึ่งอาจทําให้การทดสอบทําได้ยาก ด้วยเหตุนี้ Firebaseคอนโซลจึงให้คุณระบุอุปกรณ์ทดสอบที่แสดงข้อความได้เมื่อต้องการ

อุปกรณ์ทดสอบนั้นกำหนดโดยFirebaseรหัสการติดตั้งที่บริการการติดตั้งFirebaseให้มา หากต้องการค้นหารหัสการติดตั้งของแอปทดสอบ ให้เรียกใช้แอปด้วยอาร์กิวเมนต์คำสั่งรันไทม์ -FIRDebugEnabled ดังนี้

1. เปิดโปรเจ็กต์ Xcode แล้วเลือกผลิตภัณฑ์ > สคีมา > แก้ไขสคีมา... จากแถบเมนูด้านบน
2. เปิดแท็บอาร์กิวเมนต์ของกล่องโต้ตอบที่ปรากฏขึ้น
3. คลิก + เพิ่มรายการในส่วนอาร์กิวเมนต์ที่ส่งเมื่อเปิดใช้งาน
4. ป้อน "-FIRDebugEnabled" ในช่องที่สร้างขึ้นใหม่
5. คลิกปิด แล้วเรียกใช้แอป

เมื่อแอปเริ่มทํางาน ให้มองหาบรรทัดต่อไปนี้ในบันทึกของคอนโซล Xcode

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

ส่งข้อความไปยังอุปกรณ์ทดสอบ

เมื่อเปิดแอปในอุปกรณ์ทดสอบแล้วและมีFirebaseรหัสการติดตั้ง (FID) ของแอปแล้ว คุณสามารถลองFirebase In-App Messagingการตั้งค่าโดยส่งข้อความทดสอบ ดังนี้

1. ในคอนโซล Firebase ให้เปิดหน้าการรับส่งข้อความ
2. หากนี่เป็นแคมเปญแรก ให้คลิกสร้างแคมเปญแรก
   1. เลือกข้อความในแอป Firebase แล้วคลิกสร้าง
3. หรือคลิกแคมเปญใหม่ในแท็บแคมเปญ
   1. เลือกการรับส่งข้อความในแอป
4. ป้อนชื่อสำหรับข้อความแรก
5. คลิกทดสอบในอุปกรณ์
6. ป้อนFirebaseรหัสการติดตั้งของแอปในช่องเพิ่มรหัสการติดตั้ง
7. คลิกทดสอบเพื่อส่งข้อความ

Firebase In-App Messaging จะส่งข้อความทดสอบทันทีที่คุณคลิกทดสอบ หากต้องการดูข้อความ คุณต้องปิดแล้วเปิดแอปอีกครั้งในอุปกรณ์ทดสอบ

หากต้องการยืนยันว่าอุปกรณ์ของคุณเป็นอุปกรณ์ทดสอบหรือไม่ ให้มองหาข้อความต่อไปนี้ในบันทึก

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.