1. Giới thiệu
Lần cập nhật gần đây nhất: ngày 14 tháng 12 năm 2020
Sản phẩm bạn sẽ tạo ra
Trong lớp học lập trình này, bạn sẽ tìm hiểu cách triển khai sự kiện tuỳ chỉnh bằng SDK iOS của GA4F và khởi chạy các chiến dịch hành động thông qua Google Ads.
Thông qua lớp học lập trình này, bạn có thể trải nghiệm toàn bộ quy trình kinh doanh ứng dụng mà khách hàng của chúng tôi đang thực hiện. Nếu bạn muốn tìm hiểu sơ lược hơn về Firebase iOS, hãy bắt đầu với Firebase iOS Codelab Swift
Kiến thức bạn sẽ học được
- Cách khởi chạy GA4F (Google Analytics cho Firebase) trong iOS Swift
- Cách tạo sự kiện và thông số tuỳ chỉnh.
- Cách nhập sự kiện từ Firebase vào Google Ads
- Chạy chiến dịch thúc đẩy hành động bằng sự kiện tuỳ chỉnh.
Bạn cần có
- Xcode
- Tài khoản Firebase
- Tài khoản Google Ads
2. Bắt đầu một dự án iOS Swift mới
Tạo một ứng dụng iOS Swift theo mẫu đơn giản. Bạn sẽ sửa đổi ứng dụng khởi đầu này để tạo ứng dụng hoàn chỉnh.
Trước tiên, hãy mở Xcode.
- Nếu bạn không có dự án nào đang mở, hãy chọn Tạo dự án Xcode mới trên trang chào mừng.
- Chọn iOS ở đầu hộp thoại.
- Trong phần Application (Ứng dụng), hãy chọn App (Ứng dụng) rồi nhấp vào Next (Tiếp theo).
- Trong hộp thoại xuất hiện, hãy sử dụng các giá trị sau để đặt tên cho ứng dụng của bạn và chọn các tuỳ chọn bổ sung cho dự án, sau đó nhấp vào Tiếp theo :
- Tên sản phẩm, ví dụ: ứng dụng iOS
Xcode sử dụng tên sản phẩm bạn đã nhập để đặt tên cho dự án và ứng dụng của bạn.
- Nhóm: Nếu hệ thống không tự động điền, hãy đặt nhóm thành Không có.
- Tên tổ chức: Tên tổ chức hoặc tên của chính bạn.
- Mã nhận dạng gói: Giá trị này được tạo tự động dựa trên tên sản phẩm và mã nhận dạng tổ chức của bạn.
- Ngôn ngữ: Swift
- Chọn vị trí để lưu dự án của bạn rồi nhấp vào Tạo.
- Xcode sẽ mở dự án mới của bạn trong cửa sổ không gian làm việc.
3. Tạo và thiết lập dự án Firebase
Để bắt đầu sử dụng Firebase, bạn cần tạo và thiết lập dự án Firebase.
Tạo dự án Firebase
Nếu có một dự án Firebase hiện tại chưa bật Google Analytics, bạn có thể bật Google Analytics từ thẻ Tích hợp trong phần cài đặt > Cài đặt dự án. Chuyển sang Bước định cấu hình Firebase.
- Đăng nhập vào Firebase.
Trong bảng điều khiển của Firebase, hãy nhấp vào Thêm dự án(hoặc Tạo dự án) và đặt tên cho dự án Firebase là Firebase-iOS-Ads
- Nhấp vào các tùy chọn tạo dự án. Chấp nhận các điều khoản của Firebase nếu được nhắc đến. Bạn nên bật Google Analytics cho dự án này vì bạn cần có sự kiện Google Analytics để theo dõi các sự kiện hành động và lượt chuyển đổi.
Để tìm hiểu thêm về các dự án Firebase, hãy xem bài viết Tìm hiểu về các dự án Firebase.
4. Cấu hình Firebase
- Trong Bảng điều khiển của Firebase, chọn Tổng quan về dự án > Project Settings (Cài đặt dự án) trong thanh điều hướng bên trái, sau đó nhấp vào nút iOS trong phần General > (Chung >) Ứng dụng của bạn
Bạn sẽ thấy hộp thoại xuất hiện trên màn hình sau đây.
- Giá trị quan trọng cần cung cấp là mã nhận dạng gói iOS mà bạn sẽ nhận được qua bước sau.
- Trong dự án Xcode của bạn cho ứng dụng iOS, hãy chọn ứng dụng cấp cao nhất trong trình điều hướng dự án, sau đó chọn thẻ Chung.
- Giá trị của trường Mã nhận dạng gói là mã nhận dạng gói iOS (chẳng hạn như
com.yourcompany.yourproject). Sao chép giá trị này. - Trong hộp thoại Firebase, hãy dán mã gói đã sao chép vào trường
iOS bundle ID. - Nhấp vào Đăng ký ứng dụng.
- Tiếp tục trong Firebase, hãy làm theo hướng dẫn để tải tệp cấu hình
GoogleService-Info.plistxuống
- Chuyển đến Dự án Xcode của bạn, sau đó di chuyển tệp
GoogleService-Info.plist(mà bạn vừa tải xuống) vào thư mục gốc của dự án Xcode. - Bỏ qua các bước còn lại và quay lại trang chính của bảng điều khiển của Firebase.
5. Định cấu hình Firebase Analytics trong Xcode
Ở bước này, bạn sẽ bắt đầu thêm Firebase SDK vào dự án Xcode của mình.
- Mở cửa sổ dòng lệnh rồi chuyển tới vị trí của dự án Xcode cho ứng dụng của bạn.
- Tạo Podfile nếu bạn chưa có:
$ pod init
- Mở Podfile và thêm :
$ vi Podfile
$ pod 'Firebase/Analytics' 
- Lưu tệp và chạy :
$ pod install
- Thêm mã khởi tạo :
Để kết nối Firebase khi ứng dụng của bạn khởi động, hãy thêm mã khởi chạy bên dưới vào lớp AppDelegate chính.
import UIKit
import Firebase
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
FirebaseApp.configure()
return true
}
}
- Bạn đã hoàn tất! Tiếp tục chuyển đến bảng điều khiển.
Bây giờ, bạn đã sẵn sàng kích hoạt một số nhật ký sự kiện tuỳ chỉnh!
6. Ghi lại sự kiện tuỳ chỉnh bằng Firebase Analytics
Trong bước này, bạn sẽ tìm hiểu cách ghi lại sự kiện tùy chỉnh bằng Firebase Analytics trong ứng dụng dành cho iOS.
Firebase Analytics tự động ghi lại một số sự kiện cho bạn; bạn không cần thêm mã nào để nhận chúng. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể ghi lại tối đa 500 loại Sự kiện tuỳ chỉnh Analytics khác nhau trong ứng dụng của mình.
Ghi nhật ký sự kiện
Sau khi định cấu hình phiên bản FirebaseApp, bạn có thể bắt đầu ghi nhật ký sự kiện bằng phương thức logEvent().
Analytics.logEvent("text_search", parameters: [
"name": name as NSObject,
"full_text": text as NSObject
])
Đặt thông số sự kiện mặc định
Bạn có thể ghi lại thông số trên các sự kiện bằng cách sử dụng setDefaultEventParameters. Các thông số mặc định được liên kết với tất cả sự kiện trong tương lai được ghi lại.
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Xem các sự kiện trong bảng điều khiển gỡ lỗi của Xcode
Bạn có thể bật tính năng ghi nhật ký chi tiết để giám sát việc SDK ghi nhật ký các sự kiện nhằm giúp xác minh rằng các sự kiện đang được ghi lại đúng cách. Điều này bao gồm cả sự kiện được ghi lại tự động và thủ công.
Bạn có thể bật tính năng ghi nhật ký chi tiết như sau:
- Trong Xcode, hãy chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ...
- Chọn Run (Chạy) trên trình đơn bên trái.
- Chọn thẻ Arguments (Đối số).
- Trong mục Đối số đã thông qua khi khởi chạy, hãy thêm -FIRAnalyticsDebugEnabled.
Vào lần tiếp theo bạn chạy ứng dụng, các sự kiện của bạn sẽ hiển thị trong bảng điều khiển gỡ lỗi của Xcode, giúp bạn xác minh ngay lập tức rằng các sự kiện đang được gửi.
Xem các sự kiện trong trang tổng quan
Bạn sẽ thấy sự kiện đã ghi lại trong bảng điều khiển của Firebase sau vài giờ. Thẻ này nằm trong Analytics → Sự kiện. Bạn cũng có thể tìm thấy các giá trị thông số bằng cách nhấp vào sự kiện.
Bạn sẽ đánh dấu "text_search" là lượt chuyển đổi bằng cách trượt mục "đánh dấu là lượt chuyển đổi" chuyển sang phải.
Bạn có thể kiểm tra kỹ xem sự kiện đó có được đánh dấu thành công là lượt chuyển đổi hay không thông qua thẻ Lượt chuyển đổi của Firebase Analytics. Khi bạn đánh dấu sự kiện đó là lượt chuyển đổi, Google Ads cũng có thể nhập sự kiện đó dưới dạng lượt chuyển đổi.
7. Nhập sự kiện phân tích vào Google Ads
Quá trình thiết lập Firebase-iOS đã hoàn tất và bạn đã sẵn sàng chạy chiến dịch quảng cáo ứng dụng với các sự kiện hành động được ghi lại. Hãy bắt đầu bằng cách liên kết Firebase với Google Ads. Bằng cách liên kết Firebase với Google Ads, chiến dịch Quảng cáo ứng dụng sẽ có thể tìm hiểu thêm về đối tượng và tăng cường khả năng tìm hiểu cho chiến dịch Quảng cáo ứng dụng, từ đó giúp bạn đạt được hiệu suất cao hơn và số lượt chuyển đổi cao hơn.
- Chuyển đến phần Cài đặt Firebase bằng cách nhấp vào nút ngay bên cạnh Tổng quan về dự án.
- Trong thẻ Tích hợp, bạn sẽ thấy Google Ads và nút Liên kết. Nhấp vào Liên kết và tiếp tục.
- Chọn tài khoản Google Ads.
Phần Firebase đã hoàn tất.
Bây giờ, hãy chuyển đến Google Ads và đăng nhập.
- Truy cập vào Google Ads, đăng nhập rồi chuyển đến phần Công cụ và Cài đặt → Đo lường → Lượt chuyển đổi để nhập sự kiện tuỳ chỉnh dưới dạng lượt chuyển đổi.
- Nhấp vào nút + để thêm hành động chuyển đổi mới.
- Chọn tài sản Google Analytics 4 (Firebase) rồi nhấp vào tiếp tục.
- Bạn có thể thấy tất cả những sự kiện trong Analytics được đánh dấu là lượt chuyển đổi. Tìm sự kiện
clicked_countermà chúng ta đã triển khai trước đó.
- Kiểm tra và nhấp vào nút Nhập và tiếp tục.
Sau khi đặt text_search làm hành động chuyển đổi, bạn có thể chạy một chiến dịch nhắm đến những người dùng có khả năng sẽ kích hoạt sự kiện text_search.
8. Triển khai chiến dịch thúc đẩy hành động trong ứng dụng có sự kiện được nhập
- Chuyển đến tab chiến dịch của tài khoản hiện tại và bắt đầu chiến dịch mới bằng cách nhấp vào nút +. Hãy nhấp vào chiến dịch mới rồi tiếp tục.
- Lần này, chúng tôi sẽ chạy một Chiến dịch quảng cáo ứng dụng có lựa chọn Lượt cài đặt ứng dụng.
- Tìm ứng dụng của bạn bằng cách cung cấp tên ứng dụng, tên gói hoặc nhà xuất bản.
- Trong phần Đặt giá thầu, hãy chọn Hành động trong ứng dụng trên dropbox để Google Ads tập trung vào hành động.
- bạn có thể tìm thấy các sự kiện tuỳ chỉnh trong danh sách được cung cấp. Đặt Chi phí mục tiêu trên mỗi hành động và điền cả các lựa chọn khác.
- Định cấu hình chế độ cài đặt chiến dịch. Nội dung này sẽ nằm ngoài phạm vi của lớp học lập trình này. Vì vậy, hãy tham khảo các tài liệu này hoặc liên hệ qua bất kỳ kênh nào khác để tối ưu hoá chế độ cài đặt.
9. Xin chúc mừng
Xin chúc mừng! Bạn đã tích hợp thành công Firebase và Google Ads! Điều này sẽ giúp bạn tăng hiệu suất chiến dịch.
Bạn đã cài đặt tập lệnh, tạo và triển khai một danh sách thay đổi mới của lớp học lập trình, cập nhật và triển khai danh sách thay đổi của lớp học lập trình đang chờ xử lý, xem xét và phê duyệt danh sách thay đổi của lớp học lập trình này, đồng thời gửi và xuất bản danh sách thay đổi của lớp học lập trình này.
Bạn đã tìm hiểu về
- Cách định cấu hình Firebase cho iOS
- Cách ghi lại sự kiện tuỳ chỉnh bằng iOS và Firebase Analytics
- Cách nhập sự kiện và sử dụng sự kiện đó cho chiến dịch thúc đẩy hành động.