Bắt đầu sử dụng tính năng Gửi thông báo trong ứng dụng của Firebase

Hướng dẫn nhanh này cho bạn biết cách thiết lập Firebase In-App Messaging và gửi thông báo đầu tiên.


Trước khi bắt đầu

Trước khi bắt đầu, hãy nhớ thêm Firebase vào dự án Apple.

Thêm SDK Firebase In-App Messaging vào dự án

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc của Firebase.

  1. Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Chọn thư viện In-App Messaging.
  5. Thêm cờ -ObjC vào phần Other Linker Flags (Cờ trình liên kết khác) trong phần cài đặt bản dựng của mục tiêu.
  6. Để sử dụng In-App Messaging, bạn phải bật Google Analytics trong dự án Firebase và thêm Firebase SDK cho Google Analytics vào ứng dụng. Bạn có thể chọn thư viện không có tính năng thu thập IDFA hoặc có tính năng thu thập IDFA. Hãy xem Câu hỏi thường gặp của chúng tôi về tổ chức mô-đun mới nhất trong Google Analytics cho Firebase SDK.
  7. Sau khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.

Bây giờ, hãy khởi chạy SDK trong ứng dụng:

  1. Nhập mô-đun Firebase vào cấu trúc App hoặc UIApplicationDelegate, nếu bạn chưa làm:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Đồng thời định cấu hình một FirebaseApp thực thể dùng chung, thường là trong trình khởi chạy của App's hoặc phương thức application(_:didFinishLaunchingWithOptions:) của uỷ quyền ứng dụng, nếu bạn chưa làm:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Biên dịch và chạy ứng dụng của bạn.

Gửi tin nhắn thử nghiệm

Lấy mã lượt cài đặt của ứng dụng

Để tiết kiệm pin, Firebase In-App Messaging chỉ truy xuất thông báo từ máy chủ một lần mỗi ngày. Điều này có thể gây khó khăn cho việc thử nghiệm, vì vậy, bảng điều khiển của Firebase cho phép bạn chỉ định một thiết bị thử nghiệm để hiển thị thông báo theo yêu cầu.

Thiết bị thử nghiệm đó được xác định bằng một Firebase mã lượt cài đặt do dịch vụ Firebase lượt cài đặt cung cấp. Để tìm mã lượt cài đặt của ứng dụng thử nghiệm, hãy chạy ứng dụng bằng đối số lệnh thời gian chạy -FIRDebugEnabled:

  1. Khi dự án Xcode đang mở, hãy chọn Product > Scheme > Edit scheme... từ thanh trình đơn trên cùng.
  2. Mở thẻ Arguments (Đối số) của hộp thoại bật lên.
  3. Nhấp vào + Add items (Thêm mục) trong phần Arguments Passed On Launch (Đối số được truyền khi khởi chạy).
  4. Nhập "-FIRDebugEnabled" vào trường mới tạo.
  5. Nhấp vào Close (Đóng), sau đó chạy ứng dụng.

Sau khi ứng dụng bắt đầu chạy, hãy tìm dòng sau trong nhật ký của bảng điều khiển Xcode:

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

Gửi thông báo đến thiết bị thử nghiệm

Sau khi khởi chạy ứng dụng trên thiết bị thử nghiệm và có Firebase mã lượt cài đặt (FID) của thiết bị đó, bạn có thể dùng thử chế độ Firebase In-App Messaging thiết lập bằng cách gửi thông báo thử nghiệm:

  1. Trong bảng điều khiển của Firebase, hãy chuyển đến DevOps & Engagement > Messaging (DevOps và Tương tác > Gửi thông báo).

  2. Khởi chạy quy trình làm việc để thiết lập một chiến dịch mới:

    • Nếu đây là chiến dịch đầu tiên của bạn:

      1. Nhấp vào Create your first campaign (Tạo chiến dịch đầu tiên).
      2. Chọn Firebase In-App messages (Thông báo trong ứng dụng của Firebase) rồi nhấp vào Create (Tạo).
    • Nếu bạn đã tạo chiến dịch trước đó:

      1. Trên thẻ Campaigns (Chiến dịch), hãy nhấp vào New campaign (Chiến dịch mới).
      2. Chọn In-App Messaging (Gửi thông báo trong ứng dụng).
  3. Nhập Title (Tiêu đề) cho thông báo đầu tiên.

  4. Nhấp vào Test on Device (Thử nghiệm trên thiết bị).

  5. Nhập mã lượt cài đặt Firebase Firebase của ứng dụng vào trường Add an installation ID.

  6. Nhấp vào Test (Thử nghiệm) để gửi thông báo. Thông báo sẽ được gửi ngay lập tức.

  7. Để xem thông báo trên thiết bị thử nghiệm, bạn cần đóng rồi mở lại ứng dụng trên thiết bị thử nghiệm.

Để xác nhận xem thiết bị của bạn có phải là thiết bị thử nghiệm hay không, hãy tìm thông điệp nhật ký sau:

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