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

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


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

เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้เพิ่ม

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

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้เพิ่มทรัพยากร Dependency สำหรับไลบรารี In-App Messaging สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี

หากต้องการใช้ In-App Messaging คุณต้องเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอป

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.1"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

(ทางเลือก)  เพิ่มทรัพยากร Dependency ของไลบรารี Firebase โดยไม่ใช้ BoM

หากเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันของไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดทรัพยากร Dependency

โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลายรายการในแอป เราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารี ซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

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

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

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

อุปกรณ์ทดสอบดังกล่าวจะกำหนดโดยรหัส FirebaseInstallations หรือ FID ค้นหา FID ของแอปทดสอบโดยตรวจสอบ Logcat ใน Android Studio เพื่อหาบันทึกระดับ `Info` ต่อไปนี้

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

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

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

  1. ในคอนโซล Firebase ให้ไปที่ DevOps และการมีส่วนร่วม > การรับส่งข้อความ

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

    • หากนี่เป็นแคมเปญแรก ให้ทำดังนี้

      1. คลิกสร้างแคมเปญแรก
      2. เลือกข้อความในแอป Firebase แล้วคลิกสร้าง
    • หากคุณเคยสร้างแคมเปญไว้ก่อนหน้านี้ ให้ทำดังนี้

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

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

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

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

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

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

I/FIAM.Headless: Setting this device as a test device