Tích hợp Firebase với dự án trên Dịch vụ trò chơi của Play

Firebase có thể giúp nâng tầm trò chơi của bạn:

• Ghi lại các sự kiện trong Trò chơi bằng Google Analytics, một giải pháp đo lường ứng dụng miễn phí cung cấp thông tin chi tiết về mức sử dụng ứng dụng và hoạt động tương tác của người dùng.

• Sử dụng bất kỳ sản phẩm Firebase nào hỗ trợ trò chơi, chẳng hạn như Crashlytics, Remote Config, v.v.

Bắt đầu

1. Nếu bạn chưa tạo, hãy tạo một dự án Firebase, sau đó thêm Firebase vào trò chơi (C++ | Unity).

   Xin lưu ý những điều sau:

   • Nếu trước đây bạn đã liên kết tài khoản nhà phát triển Google Play với dự án Google Cloud trong Bảng điều khiển Play, hãy sử dụng chính dự án đó để bắt đầu sử dụng Firebase. Ở hậu trường, dự án Firebase là một dự án Google Cloud (tìm hiểu thêm).
   • Hãy nhớ bật Google Analytics trong quy trình tạo dự án Firebase hoặc bật sau khi tạo dự án trong thẻ Tích hợp của bảng điều khiển Firebase.

2. Liên kết ứng dụng Firebase với tài khoản nhà phát triển Google Play. Dự án Play Games services của bạn cũng sẽ sử dụng đường liên kết này.
   Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Tích hợp. Trên thẻ Google Play, hãy nhấp vào Liên kết, sau đó làm theo hướng dẫn trên màn hình để tạo đường liên kết.

3. Đảm bảo rằng ứng dụng của bạn trong Google Play được thiết lập để sử dụng Play Games services.

   Khi bạn được yêu cầu chỉ định xem trò chơi của mình đã sử dụng API của Google hay chưa, hãy chọn Có, trò chơi của tôi đã sử dụng API của Google. Chọn dự án Firebase của bạn trong danh sách rồi nhấp vào Sử dụng.

Ghi nhật ký sự kiện Trò chơi bằng Google Analytics

1. Thêm Google Analytics vào ứng dụng.

2. Sau khi thêm SDK Firebase cho Google Analytics vào ứng dụng, bạn có thể bắt đầu ghi lại các sự kiện Play Games. Dưới đây là một số sự kiện mẫu mà bạn có thể ghi lại:

   • Sự kiện đăng nhập

     Bundle bundle = new Bundle();
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.LOGIN, bundle);
     

   • Mở khoá thành tích

     Bundle bundle = new Bundle();
     bundle.putString(FirebaseAnalytics.Param.ACHIEVEMENT_ID, achievementId);
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.UNLOCK_ACHIEVEMENT, bundle);
     

   • Điểm số trên bảng xếp hạng

     Bundle bundle = new Bundle();
     bundle.putLong(FirebaseAnalytics.Param.SCORE, score);
     bundle.putString("leaderboard_id", leaderboardId);
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.POST_SCORE, bundle);
     

3. Bạn có thể xem các sự kiện đã ghi lại trong trang tổng quan Analytics của bảng điều khiển Firebase.

   Bạn cũng có thể truy cập vào bảng điều khiển Firebase từ Bảng điều khiển Play bằng cách nhấp vào biểu tượng Firebase bên cạnh biểu tượng của ứng dụng trong trang Thông tin chi tiết về trò chơi.

Khắc phục các lỗi thường gặp

Không thể xem các sự kiện Play Games trong trang tổng quan Analytics

• Kiểm tra để đảm bảo bạn đã bật Google Analytics cho dự án Firebase và bạn đã tích hợp Google Analytics vào trò chơi của mình.

• Xác minh rằng mã của bạn triển khai các sự kiện cho LOGIN, UNLOCK_ACHIEVEMENT hoặc POST_SCORE.

• Xác minh SDK đang ghi nhật ký sự kiện bằng cách bật tính năng ghi nhật ký chi tiết. Vì các thiết bị phân lô sự kiện để tiết kiệm pin, nên có thể mất một khoảng thời gian trước khi các sự kiện này xuất hiện trong trang tổng quan Analytics.

Không thể liên kết Google Play với Firebase

Bạn cần liên kết Google Play với Firebase bằng bảng điều khiển Firebase ( > Cài đặt dự án > Tích hợp > Google Play). Nếu bạn gặp sự cố khi liên kết, hãy kiểm tra những điều sau:

• Đảm bảo rằng ứng dụng của bạn đáp ứng tất cả yêu cầu tiên quyết để liên kết.

• Đảm bảo rằng bạn có quyền truy cập cần thiết để tạo đường liên kết.

Không thể truy cập vào bảng điều khiển Firebase từ Bảng điều khiển Play

Đảm bảo rằng tài khoản nhà phát triển Google Play của bạn được liên kết với một ứng dụng Firebase. Trong Bảng điều khiển Play, Chủ sở hữu hoặc Quản trị viên của tài khoản nhà phát triển Play có thể xem trạng thái liên kết trong Thiết lập > Dịch vụ được liên kết > Firebase.