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

1. Giới thiệu

Lần cập nhật gần đây nhất: ngày 19 tháng 2 năm 2021

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 trên môi trường Unity và 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 thông tin giới thiệu cơ bản về Firebase và AdMob trên iOS, hãy bắt đầu với AdMob+Firebase 101 Unity: Thiết lập và thông tin 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à 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 các 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 một 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ẽ 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 một 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 (Sự kiện tuỳ chỉnh Firebase Unity).
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 sự kiện Google Analytics để theo dõi 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 Unity

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

Bạn sẽ thấy hộp thoại xuất hiện trên 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 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 Nhận dạng.
4. Giá trị của trường Bundle Identifier là mã nhận dạng gói iOS (chẳng hạn như com.yourcompany.yourproject). Sao chép giá trị này hoặc đặt giá trị của bạn rồi sao chép.
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.
6. Nhấp vào Đă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 (Tài sản).
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 của mình.

1. Truy cập vào bảng điều khiển của Firebase.
2. Ở giữa trang tổng quan về 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 Thêm ứng dụng để hiển thị các lựa chọn về nền tảng.
3. Chọn mục tiêu bản dựng mà bạn muốn đăng ký cho dự án Unity của mình, 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 chỉ đăng ký một mục tiêu bản dựng của dự án Unity ngay bây giờ, bạn luôn có thể quay lại quy trình thiết lập sau để đă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 iOS của dự án Unity vào trường Mã nhận dạng gói iOS.
• Đối với Android – Nhập mã nhận dạng thiết bị Android của dự án Unity vào trường Tên gói Android. 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 có thể tìm thấy mã nhận dạng dự án Unity ở đâu?

Lưu ý: Đảm bảo rằng bạn nhập mã nhận dạng mà dự án của bạn đang thực sự 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 chúng được đăng ký với dự án Firebase của bạn.

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 biệt hiệu nội bộ, là giá trị nhận dạng thuận tiện và chỉ bạn mới thấy được trong bảng điều khiển của Firebase.
7. Nhấp vào Đă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 Tải SDK của Firebase cho Unity xuống, sau đó giải nén SDK ở một nơi 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 (Tài sản) > 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 được Firebase hỗ trợ mà bạn muốn sử dụng trong ứng dụng của mình.

• Thêm gói Firebase cho Google Analytics: FirebaseAnalytics.unitypackage
• Thêm các gói cho mọi sản phẩm khác của Firebase mà bạn muốn dùng trong ứng dụng. Ví dụ: để 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 nữa, 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. Trong bảng điều khiển của Firebase, trong quy trình thiết lập, hãy nhấp vào Tiếp theo.

Lưu ý quan trọng: Với SDK của Firebase cho Unity cho iOS, đừng tắt tính năng thay đổi phương thức. SDK yêu cầu bạn thực hiện swizzling; nếu không, 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 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 nhật ký các sự kiện tuỳ chỉnh bằng Firebase Analytics trong ứng dụng Unity iOS.

Firebase Analytics tự động ghi lại nhật ký của 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ày. 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 Analytics khác nhau trong ứng dụng.

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 lại các sự kiện bằng phương thức logEvent().

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

Xem các 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 hoạt động 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 áp dụng cho cả sự kiện được ghi nhật ký tự động và theo cách 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ẽ xuất hiện 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 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ờ. Bạn có thể xem báo cáo này 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 nút "đá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 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 phân tích trong Google Ads

Bạn đã hoàn tất việc thiết lập Firebase-iOS và 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 đã ghi lại. 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 của chiến dịch quảng cáo ứng dụng. Điều này 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 phần 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 chính xác là lượt chuyển đổi.

Đến đây là xong phần Firebase.

Bây giờ, hãy chuyển đến Google Ads rồi đăng nhập.

1. Truy cập vào Google Ads rồi đă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ể xem tất cả các sự kiện phân tích đượ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, giờ là thời điểm để chạy một chiến dịch nhắm đến những người dùng có khả năng kích hoạt sự kiện text_search.

8. Ra mắt chiến dịch thúc đẩy hành động trong ứng dụng bằng các sự kiện được nhập

Lưu ý quan trọng: Để chạy một chiến dịch quảng cáo ứng dụng, bạn cần có một ứng dụng cấp sản xuất trong Google Play. Nếu chưa sẵn sàng xuất bản ứng dụng, bạn có thể 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 một 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 và tiếp tục.
7. Trong thời gian này, chúng tôi sẽ ra mắt một chiến dịch quảng bá ứng dụng có lựa chọn Lượt 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 mục Đặt giá thầu, hãy chọn Hành động trong ứng dụng trong trình đơn thả xuống để Quảng cáo tập trung vào hành động.
10. bạn có thể tìm thấy các sự kiện tuỳ chỉnh của mì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. Việc 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ệ 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ới Unity và Google Ads! Điều này sẽ giúp bạn nâng cao hiệu suất chiến dịch.

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

• Cách định cấu hình Firebase cho nền tảng Unity iOS
• Cách ghi lại 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