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

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

iOS+ Android Flutter

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

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

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

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

ดูข้อมูลเกี่ยวกับวิธีต่างๆ ที่คุณสามารถเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Apple ได้ใน คู่มือการติดตั้ง

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

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

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

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

1. นำเข้าโมดูล Firebase ในโครงสร้าง App หรือ UIApplicationDelegate หากยังไม่ได้ดำเนินการ

   Swift

   import Firebase

   Objective-C

   @import Firebase;

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

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

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

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

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

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

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

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

1. เปิดโปรเจ็กต์ Xcode แล้วเลือก Product > Scheme > Edit scheme... จาก แถบเมนูด้านบน
2. เปิดแท็บ Arguments ของกล่องโต้ตอบที่ปรากฏขึ้น
3. คลิก + Add items ในส่วน Arguments Passed On Launch
4. ป้อน "-FIRDebugEnabled" ในช่องที่สร้างขึ้นใหม่
5. คลิก Close แล้วเรียกใช้แอป

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

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

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

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

1. ในคอนโซล Firebase ให้ไปที่ DevOps & Engagement > Messaging

2. เปิดเวิร์กโฟลว์เพื่อตั้งค่าแคมเปญใหม่

   • หากนี่เป็นแคมเปญแรก

     1. คลิกสร้างแคมเปญแรก
     2. เลือกข้อความในแอป Firebase แล้วคลิกสร้าง

   • หากคุณเคยสร้างแคมเปญไว้ก่อนหน้านี้

     1. ในแท็บแคมเปญ ให้คลิกแคมเปญใหม่
     2. เลือกการรับส่งข้อความในแอป

3. ป้อนชื่อ สำหรับข้อความแรก

4. คลิกทดสอบในอุปกรณ์

5. ป้อนรหัสการติดตั้ง Firebase Firebase ของแอปในช่อง เพิ่มรหัสการติดตั้ง

6. คลิกทดสอบ เพื่อส่งข้อความ ระบบจะส่งข้อความทันที

7. หากต้องการดูข้อความในอุปกรณ์ทดสอบ คุณต้องปิดแล้วเปิดแอปอีกครั้งในอุปกรณ์ทดสอบ

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

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