Google Ads với các sự kiện tùy chỉnh trong Google Analytics cho Firebase – Unity

1. Giới thiệu

Last Updated: 2021-02-19

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 các sự kiện tuỳ chỉnh bằng GA4F iOS trong môi trường Unity và khởi chạy chiến dịch thúc đẩy hành động thông qua Google Ads.

Trong suốt 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 gặp phải. Nếu bạn muốn tìm hiểu phần giới thiệu nhẹ nhàng hơn về Firebase và AdMob trên iOS, hãy bắt đầu với lớp học lập trình AdMob+Firebase 101 Unity: Thiết lập và các nguyên tắc cơ bản về Analytics.

Kiến thức bạn sẽ học được

• Cách khởi chạy GA4F (Google Analytics cho Firebase) trong Unity + iOS.
• Cách tạo sự kiện và tham số tuỳ chỉnh.
• Cách nhập sự kiện từ Firebase vào Google Ads.
• Khởi 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
• Unity
• Tài khoản Firebase
• Tài khoản Google Ads

2. Bắt đầu dự án Unity mới

Tạo một ứng dụng Unity đơn giản dựa trên mẫu. Bạn sửa đổi ứng dụng đơn giản này để tạo ứng dụng hoàn chỉnh.

Khởi chạy Unity

1. Nếu bạn không có dự án nào đang mở, hãy chọn tạo dự án mới.
2. Chọn mẫu 3D trong hộp thoại.
3. Điền vào Tên dự án: ví dụ: Unity Firebase Custom Event.
4. Chọn một Vị trí để lưu dự án rồi nhấp vào TẠO.
5. Unity 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 một dự án Firebase.

Nếu có một dự án Firebase hiện có 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.

1. Đă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) rồi đặt tên cho dự án Firebase của bạn là Firebase-iOS-Ads

2. 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ác sự kiện Google Analytics để theo dõi các sự kiện thúc đẩy 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. Định cấu hình Unity

1. Trong Unity > File > Build Settings (Unity > Tệp > Cài đặt bản dựng). Giá trị quan trọng là đặt mã nhận dạng gói iOS. Bạn sẽ nhận được giá trị này bằng cách thực hiện bước sau.

Bạn sẽ thấy hộp thoại như trong màn hình sau.

2. Trong dự án Unity cho ứng dụng iOS, hãy mở hộp thoại Build Settings (Cài đặt bản dựng), File > Build Settings (Tệp > Cài đặt bản dựng) (Nếu Platform (Nền tảng) chưa được đặt thành iOS, bạn có thể chọn iOS Platform (Nền tảng iOS) rồi nhấp vào nút Switch Platform (Chuyển đổi nền tảng))

3. Sau khi thay đổi nền tảng, hãy nhấp vào nút Player Settings (Cài đặt trình phát) để đặt mã nhận dạng gói. Bạn có thể thấy trường văn bản xung quanh khu vực Identification (Nhận dạng).
4. Giá trị của trường Bundle Identifier (Mã nhận dạng gói) là mã nhận dạng gói iOS (ví dụ: com.yourcompany.yourproject). Sao chép giá trị này hoặc đặt giá trị của bạn rồi sao chép giá trị đó.
5. Trong hộp thoại Firebase, hãy dán mã nhận dạng gói đã sao chép vào trường iOS bundle ID (Mã nhận dạng gói iOS).
6. Nhấp vào Register App (Đăng ký ứng dụng).
7. 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.plist xuống
8. Mở cửa sổ Project (Dự án) của dự án Unity, sau đó di chuyển (các) tệp cấu hình vào thư mục Assets (Nội dung).
9. 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 Unity

Trong bước này, bạn sẽ bắt đầu thêm SDK Firebase vào dự án Unity.

1. Truy cập vào bảng điều khiển của Firebase.
2. Ở trung tâm trang tổng quan của dự án, hãy nhấp vào biểu tượng Unity ( ) để chạy quy trình thiết lập. Nếu bạn đã thêm một ứng dụng vào dự án Firebase, hãy nhấp vào Add app (Thêm ứng dụng) để hiển thị các lựa chọn nền tảng.
3. Chọn mục tiêu bản dựng của dự án Unity mà bạn muốn đăng ký hoặc bạn thậm chí có thể chọn đăng ký cả hai mục tiêu cùng một lúc.

Lưu ý: Nếu hiện tại bạn chỉ đăng ký một mục tiêu bản dựng của dự án Unity, thì bạn luôn có thể quay lại quy trình thiết lập sau này để đăng ký mục tiêu bản dựng khác.

4. Nhập(các) mã nhận dạng dành riêng cho nền tảng của dự án Unity.

• Đối với iOS – Nhập mã nhận dạng gói iOS của dự án Unity vào trường iOS bundle ID.
• Đối với Android – Nhập mã nhận dạng thiết bị Android của dự án Unity vào trường Android package name. Các thuật ngữ tên gói và mã ứng dụng thường được dùng thay thế cho nhau.

5. Bạn tìm thấy mã nhận dạng của dự án Unity ở đâu?

Lưu ý: Đảm bảo rằng bạn nhập mã nhận dạng mà dự án thực sự đang sử dụng. Giá trị mã nhận dạng có phân biệt chữ hoa chữ thường và bạn không thể thay đổi giá trị này cho các ứng dụng Firebase này sau khi đăng ký với dự án Firebase.

6. (Không bắt buộc) Nhập(các) biệt hiệu dành riêng cho nền tảng của dự án Unity. Đây là các mã nhận dạng nội bộ, tiện lợi và chỉ bạn mới có thể nhìn thấy trong bảng điều khiển của Firebase.
7. Nhấp vào Register app (Đăng ký ứng dụng).

Thêm SDK Firebase Analytics cho Unity

1. Trong bảng điều khiển của Firebase, hãy nhấp vào Download Firebase Unity SDK (Tải SDK Firebase cho Unity xuống), sau đó giải nén SDK ở một vị trí thuận tiện.

• Bạn có thể tải lại SDK của Firebase cho Unity xuống bất cứ lúc nào.
• SDK của Firebase cho Unity không dành riêng cho nền tảng.

2. Trong dự án Unity đang mở, hãy chuyển đến Assets (Nội dung) > Import Package (Nhập gói) > Custom Package (Gói tuỳ chỉnh).
3. Trong SDK đã giải nén, hãy chọn các sản phẩm Firebase được hỗ trợ mà bạn muốn sử dụng trong ứng dụng.

• Thêm gói Firebase cho Google Analytics: FirebaseAnalytics.unitypackage
• Thêm các gói cho bất kỳ sản phẩm Firebase nào khác mà bạn muốn sử dụng trong ứng dụng. Ví dụ: để sử dụng Xác thực Firebase và Cơ sở dữ liệu theo thời gian thực của Firebase: FirebaseAuth.unitypackage và FirebaseDatabase.unitypackage

Unity 5.x trở xuống sử dụng khung .NET 3.x, vì vậy, hãy nhập gói dotnet3/. Unity 2017.x trở lên cho phép sử dụng khung .NET 4.x. Nếu dự án Unity của bạn sử dụng .NET 4.x, hãy nhập gói dotnet4/. Unity 2019 trở lên không còn hỗ trợ khung .NET 3.x, vì vậy, hãy nhập gói dotnet4/.

4. Trong cửa sổ Import Unity Package (Nhập gói Unity), hãy nhấp vào Import (Nhập).
5. Quay lại bảng điều khiển của Firebase, trong quy trình thiết lập, hãy nhấp vào Next (Tiếp theo).

Quan trọng: Với SDK của Firebase cho Unity dành cho iOS, không tắt tính năng thay đổi phương thức. SDK yêu cầu tính năng hoán đổi; nếu không có tính năng này, các tính năng chính của Firebase (chẳng hạn như xử lý mã thông báo FCM) sẽ không hoạt động đúng cách.

6. Ghi nhật ký 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 nhật ký sự kiện tuỳ chỉnh bằng Firebase Analytics trong ứng dụng Unity iOS.

Firebase Analytics sẽ tự động ghi nhật ký một số sự kiện cho bạn; bạn không cần thêm mã nào để nhận các sự kiện đó. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể ghi nhật ký tối đa 500 loại Sự kiện tuỳ chỉnh của Analytics trong ứng dụng.

Ghi nhật ký sự kiện

Sau khi định cấu hình thực thể FirebaseApp, bạn có thể bắt đầu ghi nhật ký sự kiện bằng phương thức logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Xem sự kiện trong bảng điều khiển gỡ lỗi Xcode

Bạn có thể bật tính năng ghi nhật ký chi tiết để theo dõi việc ghi nhật ký sự kiện của SDK nhằm giúp xác minh rằng các sự kiện đang được ghi nhật ký đúng cách. Điều này bao gồm cả các sự kiện được ghi nhật ký 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:

1. Trong Xcode, chọn Product > Scheme > Edit scheme... (Sản phẩm > Lược đồ > Chỉnh sửa lược đồ)
2. Chọn Run (Chạy) trong trình đơn bên trái.
3. Chọn thẻ Arguments (Đối số).
4. Trong mục Arguments Passed On Launch (Đối số được chuyển khi mở), hãy thêm -FIRAnalyticsDebugEnabled.

Lần tiếp theo bạn chạy ứng dụng, các sự kiện sẽ hiển thị trong bảng điều khiển gỡ lỗi Xcode, giúp bạn xác minh ngay rằng các sự kiện đang được gửi.

Xem sự kiện trong trang tổng quan

Bạn sẽ thấy sự kiện đã ghi nhật ký trong bảng điều khiển của Firebase sau vài giờ. Sự kiện này nằm trong mục Analytics → Events (Analytics → Sự kiện). Bạn cũng có thể tìm thấy các giá trị tham 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 nút "mark as conversion" (đánh dấu là lượt chuyển đổi) sang phải.

Bạn có thể kiểm tra kỹ xem sự kiện có được đánh dấu là lượt chuyển đổi thành công hay không thông qua thẻ Lượt chuyển đổi của Firebase Analytics. Bằng cách đá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 Analytics vào Google Ads

Bạn đã hoàn tất quá trình thiết lập Firebase-iOS và sẵn sàng khởi chạy chiến dịch quảng cáo ứng dụng bằng các sự kiện thúc đẩy hành động đã ghi nhật ký. Bạn sẽ 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 học hỏi của chiến dịch quảng cáo ứng dụng, thường dẫn đến hiệu suất và lượt chuyển đổi tốt hơn.

1. 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.
2. 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.

3. Chọn tài khoản Google Ads.

Thận trọng: Nếu sự kiện mục tiêu không được đánh dấu là lượt chuyển đổi, thì Google Ads sẽ không thể nhập sự kiện đó. Đảm bảo sự kiện được đánh dấu là lượt chuyển đổi đúng cách.

Bây giờ, bạn đã hoàn tất phần Firebase.

Bây giờ, hãy chuyển đến Google Ads và Đăng nhập.

1. Chuyển đến Google Ads và đăng nhập, sau đó chuyển đến mục 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.
2. Nhấp vào nút + để thêm hành động chuyển đổi mới.

3. Chọn tài sản Google Analytics 4 (Firebase) rồi nhấp vào Tiếp tục.

4. Bạn có thể thấy tất cả các sự kiện Analytics được đánh dấu là lượt chuyển đổi. Tìm sự kiện clicked_counter mà chúng ta đã triển khai trước đó.

5. Kiểm tra rồi 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ây giờ là thời điểm khởi chạy chiến dịch nhắm mục tiêu đến những người dùng có khả năng kích hoạt sự kiện text_search.

8. Khởi chạy chiến dịch thúc đẩy hành động trong ứng dụng bằng các sự kiện đã nhập

Quan trọng: Để khởi chạy chiến dịch quảng cáo ứng dụng, bạn cần có một ứng dụng ở cấp độ phát hành công khai trên Google Play. Nếu bạn chưa sẵn sàng phát hành ứng dụng, hãy bỏ qua bước này.

6. Chuyển đến thẻ chiến dịch của tài khoản hiện tại rồi bắt đầu chiến dịch mới bằng cách nhấp vào nút +. Nhấp vào chiến dịch mới rồi tiếp tục.
7. Trong thời gian này, chúng ta sẽ khởi chạy chiến dịch Quảng bá ứng dụng với lựa chọn Cài đặt ứng dụng.

8. 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.
9. Trong phần Đặt giá thầu, hãy chọn Hành động trong ứng dụng trong hộp thả xuống để Quảng cáo tập trung vào các hành động.
10. 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 lựa chọn khác.

11. Định cấu hình chế độ cài đặt chiến dịch. Nội dung này nằm ngoài phạm vi của lớp học lập trình, vì vậy, hãy tham khảo các tài liệu này hoặc liên hệ thông 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ào Unity và Google Ads! Điều này sẽ giúp bạn tăng hiệu suất chiến dịch.

Bạn đã học được

• Cách định cấu hình Firebase cho nền tảng Unity iOS
• Cách ghi nhật ký sự kiện tuỳ chỉnh bằng Unity 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.

Tài liệu tham khảo

• Thêm Firebase vào dự án Unity
• GitHub: firebase/quickstart-unity