Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn 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.
- Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
- Chọn thư viện In-App Messaging.
- Thêm cờ
-ObjCvào phần Other Linker Flags (Cờ trình liên kết khác) trong chế độ cài đặt bản dựng của mục tiêu. - Để 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 thu thập IDFA hoặc thư viện có thu thập IDFA. Xem Câu hỏi thường gặp của chúng tôi về cách tổ chức mô-đun mới nhất trong Google Analytics cho Firebase SDK.
- 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.
https://github.com/firebase/firebase-ios-sdk.git
Bây giờ, hãy khởi chạy SDK trong ứng dụng:
- Nhập mô-đun Firebase trong cấu trúc
ApphoặcUIApplicationDelegate, nếu bạn chưa làm:Swift
import Firebase
Objective-C
@import Firebase;
- Đồng thời, hãy định cấu hình một
FirebaseAppthực thể dùng chung, thường là trong trình khởi chạyApp's hoặc phương thứcapplication(_:didFinishLaunchingWithOptions:)của đại diện ứng dụng, nếu bạn chưa làm:Swift
FirebaseApp.configure()
Objective-C
[FIRApp configure];
- 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 ứ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 kiểm thử, vì vậy, 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 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:
- Khi dự án Xcode đang mở, hãy chọn Product > Scheme > Edit scheme... từ thanh trình đơn trên cùng.
- Mở thẻ Arguments (Đối số) của hộp thoại bật lên.
- 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).
- Nhập "-FIRDebugEnabled" vào trường mới tạo.
- 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 một thông báo thử nghiệm:
- Trong bảng điều khiển Firebase, hãy mở trang Gửi thông báo.
- Nếu đây là chiến dịch đầu tiên của bạn, hãy nhấp vào Create your first campaign (Tạo chiến dịch đầu tiên).
- 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 không, trên thẻ Campaigns (Chiến dịch), hãy nhấp vào New campaign (Chiến dịch mới).
- Chọn In-App Messaging (Gửi thông báo trong ứng dụng).
- Nhập Title (Tiêu đề) cho thông báo đầu tiên.
- Nhấp vào Test on Device (Kiểm thử trên thiết bị)
- Nhập mã lượt cài đặt Firebase của ứng dụng vào trường Add an installation ID (Thêm mã lượt cài đặt).
- Nhấp vào Test (Kiểm thử) để gửi thông báo.
Firebase In-App Messaging sẽ gửi thông báo thử nghiệm ngay khi bạn nhấp vào Test. Để xem thông báo, 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.