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

Xuyên 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 thực hiện. Nếu bạn muốn tìm hiểu sơ lược hơn về Firebase và AdMob trên iOS, hãy bắt đầu bằng Unity 101 AdMob+Firebase 101: Kiến thức cơ bản về cách thiết lập và phân tích.

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 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 có mẫu đơn giản. Bạn sẽ sửa đổi ứng dụng đơn giản này để tạo ứng dụng hoàn chỉnh.

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 Tên dự án, ví dụ: Sự kiện tùy chỉnh Firebase Firebase.
4. Chọn một Vị trí để lưu dự án của bạ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ó 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 Unity

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

Bạn sẽ thấy hộp thoại xuất hiện trên màn hình sau đây.

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 chưa đặt Platform (Nền tảng) 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 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 Giấy tờ tuỳ thân.
4. 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). Hãy 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ã 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

Ở bước này, bạn sẽ bắt đầu thêm Firebase SDK 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. Ở 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 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 của dự án Unity mà bạn muốn đăng ký hoặc thậm chí bạn có thể chọn đăng ký cả hai mục tiêu ngay bây giờ cùng 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 vào lúc khác để đăng ký mục tiêu bản dựng khác.

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

• Đối với iOS – Nhập mã iOS của dự án Unity vào trường Mã gói iOS.
• Đối với Android – Nhập mã Android của dự án Unity vào trường Android package name (Tên gói Android). 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ã dự án Unity ở đâu?

Lưu ý: Hãy nhớ nhập mã nhận dạng mà dự án của bạ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ý các ứng dụng này 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. Các biệt hiệu này là giá trị nhận dạng nội bộ, thuận tiện và chỉ bạn mới nhìn thấy 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 Unity

1. Trong bảng điều khiển của Firebase, hãy nhấp vào Tải Firebase Unity SDK xuống, sau đó giải nén SDK ở nơi thuận tiện.

• Bạn có thể tải Firebase Unity SDK xuống lại bất cứ lúc nào.
• Firebase Unity SDK không dành riêng cho từng 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. Từ SDK đã giải nén, hãy chọn các sản phẩm được hỗ trợ của Firebase 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 Firebase khác mà bạn muốn sử dụng trong ứng dụng. Ví dụ: để sử dụng tính năng Xác thực Firebase và Cơ sở dữ liệu thời gian thực 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 Tiếp theo.

Lưu ý quan trọng: Với Firebase Unity SDK dành cho iOS, đừng tắt tính năng tạo nhanh phương thức. SDK yêu cầu phải có thao tác vuốt; 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 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ý sự kiện tuỳ chỉnh bằng Firebase Analytics trong ứng dụng Unity dành cho iOS.

Firebase Analytics sẽ 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 những 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 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().

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

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 để 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ả 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:

1. Trong Xcode, hãy chọn 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 phần Arguments Passed On Launch (Đối số được truyền 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 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 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 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. 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

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

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 chính xác là lượt chuyển đổi.

Phần Firebase đã hoàn tất.

Bây giờ, hãy chuyển đến Google Ads và đă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ả 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. Đánh dấu vào ô 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ạ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

Lưu ý quan trọng: Để triển khai 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 độ phát hành công khai trong Google Play. Nếu bạn chưa sẵn sàng xuất bản ứng dụng, hãy tạm dừng bước này.

6. 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 +. Nhấp vào chiến dịch mới rồi tiếp tục.
7. 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.

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 hộp 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 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 tuỳ chọn khác.

11. Định cấu hình chế độ cài đặt chiến dịch. Việc 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 của mình vào Unity và Google Ads! Việc này sẽ giúp bạn tăng hiệu suất của chiến dịch.

Bạn đã tìm hiểu về

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