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 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 nào của Firebase có hỗ trợ trò chơi, chẳng hạn như Crashlytics, Remote Config và nhiều sản phẩm khác.

Bắt đầu

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

  2. Liên kết ứng dụng Firebase với Google Playtài khoản nhà phát triển. Dự án Play Games services của bạn sẽ dùng chính đườ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 rồi 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.

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

  1. Thêm Google Analytics vào ứng dụng của bạn.

  2. Sau khi thêm Firebase SDK 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 Analytics trang tổng quan 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ừ Play Console bằng cách nhấp vào biểu tượng Firebase bên cạnh biểu tượng ứng dụng của bạn trong trang Chi tiết về trò chơi.

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

Không xem được 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à đã 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 rằng SDK đang ghi nhật ký các 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 để duy trì thời lượng pin, nên có thể mất một khoảng thời gian trước khi những sự kiện này xuất hiện trong trang tổng quan Analytics.

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 > Các công cụ tích hợp > Google Play). Nếu bạn gặp vấn đề khi liên kết, hãy kiểm tra những điều sau:

Không truy cập được 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 PlayConsole (Bảng điều khiển), 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 phần Thiết lập > Dịch vụ được liên kết > Firebase.