Integracja statystyk gry

Z tego dokumentu dowiesz się, jak zintegrować statystyki gier z grą za pomocą Konsoli Google Play. Omawia on podstawowe formaty plików CSV i ZIP oraz opisuje, jak je tworzyć, importować i nimi zarządzać.

Tworzenie wydarzeń

Aby utworzyć wydarzenie dla nowej, nieopublikowanej gry:

  1. Utwórz plik CSV z wydarzeniami PlayerGameEvent.csv.
  2. W Konsoli Google Play wybierz grę.
  3. Na stronie Usługi gier Play – statystyki gry (Zwiększaj liczbę użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Statystyki gry) kliknij Skonfiguruj zdarzenia.
  4. Na stronie Konfiguracja wydarzeń upuść plik CSV, aby go przesłać.
  5. Po utworzeniu wydarzenia musisz skonfigurować statystyki.

Konfigurowanie statystyk

Po utworzeniu wydarzenia musisz skonfigurować statystyki:

  1. Utwórz plik ZIP zawierający statystyki, pliki lokalizacji i pliki ikon.Wskazówki dotyczące pliku ZIP ze statystykami
  2. W Konsoli Google Play wybierz grę.
  3. Na stronie Usługi gier Play – statystyki gry (Zwiększaj liczbę użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Statystyki gry) kliknij Skonfiguruj statystyki.
  4. Na stronie Konfiguracja statystyk gry upuść plik ZIP, aby go przesłać.
  5. Po przesłaniu wszystkich statystyk możesz opublikować grę.

Testowanie statystyk gry

Aby sprawdzić, czy statystyki gier działają prawidłowo, wykonaj te czynności:

  • Skonfiguruj ścieżkę testu wewnętrznego.
  • Dodaj konta testowe do projektu gry dla testerów.
  • Utwórz profil w Usługach gier Play na jednym z kont testowych za pomocą aplikacji Gry Play.
  • Otwórz grę, używając tego samego konta testowego, dla którego utworzono profil w usługach gier Play.
  • Sprawdź, czy na ekranie wyświetla się „powiadomienie powitalne” Usług gier Play jako potwierdzenie udanego automatycznego uwierzytelniania podczas uruchamiania gry.
  • Użytkownik konta testowego może grać w grę, aby wywoływać zdarzenia. Sprawdź odpowiedź interfejsu API, aby dowiedzieć się, czy zdarzenia zostały zarejestrowane.

Publikowanie statystyk gry

Po zakończeniu testowania musisz opublikować grę. Wszystkie wydarzenia i statystyki gry zostaną opublikowane razem z nią.

Aby opublikować, wykonaj te czynności:

  1. W Konsoli Google Play wybierz grę.
  2. Na stronie Usługi gier Play – statystyki gry (Zwiększaj liczbę użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Statystyki gry) kliknij Sprawdź i opublikuj.
  3. Na stronie Usługi gier Play – publikowanie (Zwiększaj liczbę użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Publikowanie) sprawdź działania i rozwiąż problemy.
  4. Kliknij Opublikuj. Wszystkie statystyki gry zostaną opublikowane.

Usuwanie statystyk gry

Opublikowanych statystyk gry nie można usunąć.

Wytyczne dotyczące plików CSV w przypadku wydarzeń

Pierwszy wiersz pliku CSV to wiersz nagłówka. Wydarzenia musisz importować za pomocą pliku CSV wydarzeń, np. PlayerGameEvent.csv.

Format pliku PlayerGameEvent.csv

Plik CSV zawiera zadeklarowane zdarzenie i jego właściwości w postaci wartości rozdzielonych przecinkami w tej kolejności:

 Event Name,Property Name,Property Type

Jeśli wysyłasz zdarzenie progressUpdate dla progressionStat, dodaj wiersz dla tego zdarzenia. To zdarzenie musi zawierać co najmniej właściwość currentProgress typu INT lub STRING oraz inne właściwości, które chcesz wysłać.

Pola są opisane w tej tabeli:

Nagłówki kolumn CSV Wymagane czy opcjonalne Akceptowane wartości
Nazwa zdarzenia Wymagane Maksymalnie 50 znaków

Musi składać się tylko z liter, cyfr i znaków podkreślenia.

Jeśli używana jest nazwa zdarzenia specjalnego progressUpdate, musi ona zawierać właściwość o nazwie currentProgress typu INT64 lub STRING.
Nazwa właściwości Wymagane Maksymalnie 50 znaków

Musi składać się tylko z liter, cyfr i znaków podkreślenia.

Unikalne w ramach zdarzenia: nazwy właściwości muszą być unikalne w ramach tego samego zdarzenia.

Nie używaj tych słów kluczowych: id, count, key, value, where, from, and, or, true i false.
Typ usługi Wymagane Ciąg wyliczeniowy z rozróżnianiem wielkości liter, który pasuje do jednego z obsługiwanych typów danych: INT64, DOUBLE, STRING, BOOL

Wymagania dotyczące pliku PlayerGameEvent.csv:

  • Plik może zawierać maksymalnie 20 niepowtarzalnych nazw zdarzeń i do 20 właściwości na zdarzenie.
  • Zawartość pliku nie może być pusta i musi zawierać co najmniej 1 wiersz.
Przykładowa tabela
Nazwa zdarzenia Nazwa właściwości Typ usługi
matchCompleted czas trwania PODWÓJNE
matchCompleted zabójstwa, INT64
matchCompleted isWinner BOOL
matchCompleted matchType CIĄG ZNAKÓW
itemCollected coinsAmount INT64
itemCollected weaponType CIĄG ZNAKÓW
progressUpdate currentProgress INT64

Wytyczne dotyczące plików ZIP ze statystykami

Statystyki możesz zaimportować naraz za pomocą pliku ZIP. Dokładne nazwy plików do użycia w pliku ZIP znajdziesz w tabeli:

Nazwa pliku Wymagany czy opcjonalny Akceptowane wartości
RepetitiveStatsConfig.csv Wymagane Powtarzalne statystyki reprezentują regularnie występujące w grze działania wykonywane przez graczy.
ProgressionStatConfig.csv Wymagane Statystyka postępów odzwierciedla postępy gracza w grze.
StatLocalizations.csv Opcjonalnie Zawiera tłumaczenia nazw i opisów statystyk gier.
Pliki ikon Wymagane Ikony w formacie PNG, JPEG lub JPG o wymiarach 512 x 512 pikseli.

Plik ZIP musi spełniać te wymagania:

  • Maksymalny rozmiar pliku ZIP: maksymalny rozmiar po rozpakowaniu to 10 MB.
  • Maksymalna liczba plików: maksymalnie 53 pliki (3 pliki CSV i 50 ikon) w archiwum ZIP.
  • Maksymalny limit łącznych statystyk: maksymalnie 50 statystyk łącznie w przypadku ProgressionStatConfig.csv i RepetitiveStatsConfig.csv.
  • Obsługiwane pliki CSV: ProgressionStatConfig.csv, RepetitiveStatsConfig.csv i StatLocalizations.csv (opcjonalnie). Jeśli chcesz przesłać tylko statystyki postępów, nie umieszczaj w pliku ZIP powtarzalnego pliku CSV ze statystykami. W przeciwnym razie konsola zgłosi błąd. To samo dotyczy sytuacji, gdy chcesz przesłać tylko powtarzające się statystyki.
  • Pliki obrazów ikon: PNG (.png) lub JPEG (.jpg, .jpeg).
    • Wszystkie ikony, do których odwołujesz się w plikach CSV, muszą znajdować się w katalogu głównym pliku ZIP.
    • Do wszystkich plików graficznych w pliku ZIP musi się odwoływać co najmniej 1 statystyka.
  • Struktura katalogu: wszystkie pliki muszą znajdować się w katalogu głównym pliku ZIP. Podkatalogi są niedozwolone.

Format pliku RepetitiveStatsConfig.csv

Plik CSV zawiera zadeklarowane zdarzenie i jego właściwości w postaci wartości rozdzielonych przecinkami w tej kolejności:

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

Pola są opisane w tej tabeli:

Nagłówki kolumn CSV Wymagane czy opcjonalne Akceptowane wartości
Identyfikator statystyki Wymagane Maksymalnie 100 znaków.

Musi składać się tylko z liter, cyfr i znaków podkreślenia. Musi być unikalny we wszystkich statystykach w grze.
Nazwa usługi zdarzenia Wymagane Może mieć maksymalnie 50 znaków.
Wyświetlana nazwa statystyki Wymagane Maksymalnie 50 znaków
Domyślna wyświetlana nazwa statystyki (domyślne ustawienia regionalne). Musi być unikalny w przypadku wszystkich statystyk.
Stat Description Wymagane Maksymalnie 500 znaków.
Domyślny opis statystyki.
Rodzaj agregacji Wymagane Maksymalnie 50 znaków.
SUM, MAX, MIN, COUNT.
Filtruj usługę Opcjonalnie Maksymalnie 50 znaków.
Musi to być nazwa właściwości zdefiniowana w pliku PlayerGameEvent.csv.
Filtr operatora Opcjonalnie =, !=, >, <, >=, <=
Operatory porównania filtrów.
Wartość filtra Opcjonalnie W porównaniu z właściwością filtra. Wartość filtra musi wynosić INT64, DOUBLE, BOOL, STRING.
Is Competitive Wymagane true, false
Limit minimalny Wymagane, gdy pole Is Competitive ma wartość true Minimalny dopuszczalny wynik w przypadku statystyk konkurencyjnych.
Maksymalny limit Wymagane, gdy pole Is Competitive ma wartość true Maksymalny dozwolony wynik w przypadku statystyk konkurencji.
Nazwa pliku ikony Wymagane Nazwa pliku obrazu ikony znajdującego się w katalogu głównym pliku ZIP. Nie może kolidować z nazwami plików ikon używanymi w powtarzalnych statystykach.
Kierunek dobrej ceny Wymagane Określa, czy lepsze są wyższe INCREASING czy niższe DECREASING wartości.
Jednostka Opcjonalnie Jednostka miary dla surowych wartości liczbowych lub wartości czasu trwania. Na przykład KILOMETER, SECOND, PERCENTAGE, UNITLESS.

Jeśli nie chcesz używać warunku filtra, pozostaw komórkę pustą.

Przykładowa tabela
Identyfikator statystyki Nazwa zdarzenia Nazwa właściwości Agregacja Wyświetlana nazwa statystyki Stat Description Filtruj usługę (opcjonalnie) Filtr operatora (opcjonalnie) Wartość filtra (opcjonalnie) Is Competitive minLimit maxLimit Nazwa pliku ikony Numer sekwencyjny Kierunek dobrej ceny jednostka
1 matchCompleted czas trwania MAKS. Najdłuższy mecz w trybie przetrwania Oznacza czas przetrwania gracza w dowolnym meczu. isWinner = PRAWDA PRAWDA 0 50 stat1.png 1 Malejący s
2 matchCompleted isWinner COUNT Wygrane mecze Oznacza liczbę wygranych meczów. isWinner = PRAWDA PRAWDA 0 50 stat3.png 2 Rosnący
3 matchCompleted zabójstwa, SUMA Zabójstwa w pojedynkach Liczba zabójstw w pojedynkach matchType = „1 na 1” FAŁSZ stat4.png 4 Rosnący
4 itemCollected coinsAmount SUMA Łączna ilość zebranego złota Gracz zbiera monety podczas meczu weaponType = „sword” FAŁSZ stat2.png 3 Rosnący

Format pliku ProgressionStatConfig.csv

Plik CSV zawiera zadeklarowane zdarzenie i jego właściwości w postaci wartości rozdzielonych przecinkami w tej kolejności:

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

Statystyka postępów będzie wyświetlana jako pierwsza w profilu gracza.

Pola są opisane w tej tabeli:

Nagłówki kolumn CSV Wymagane czy opcjonalne Akceptowane wartości
Identyfikator statystyki Wymagane Maksymalnie 100 znaków.

Musi składać się tylko z liter, cyfr i znaków podkreślenia. Musi być unikalny we wszystkich statystykach w grze.
Nazwa zdarzenia Wymagane Maksymalnie 50 znaków

Musi odwoływać się do nazwy zdarzenia zdefiniowanej w formacie PlayerGameEvent.csv.
Nazwa usługi zdarzenia Wymagane Maksymalnie 50 znaków

Musi to być nazwa właściwości zdefiniowana w pliku PlayerGameEvent.csv.
Wyświetlana nazwa statystyki Wymagane Musi to być unikalna nazwa.
Stat Description Wymagane Maksymalnie 50 znaków
Domyślny opis statystyki.
Nazwa pliku ikony Wymagane Nazwa pliku obrazu ikony znajdującego się w katalogu głównym pliku ZIP. Nie może kolidować z nazwami plików ikon używanymi w powtarzalnych statystykach.
Kierunek dobrej ceny Wymagane Określa, czy lepsze są wyższe INCREASING czy niższe DECREASING wartości.
Jednostka Opcjonalnie Jednostka miary dla surowych wartości liczbowych lub wartości czasu trwania. Na przykład KILOMETER, SECOND, PERCENTAGE, UNITLESS.
Przykładowa tabela
Identyfikator statystyki Nazwa właściwości zdarzenia Wyświetlana nazwa statystyki Opis statystyki Nazwa pliku ikony Kierunek dobrej wartości
5 currentProgress Poziom Gracze zdobywają punkty XP, grając w mecze i awansując na kolejne poziomy. Level.png zwiększanie,

Format pliku StatLocalizations.csv

Plik CSV zawiera zadeklarowane zdarzenie i jego właściwości w postaci wartości rozdzielonych przecinkami w tej kolejności:

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

Pola są opisane w tej tabeli:

Nagłówki kolumn CSV Wymagane czy opcjonalne Akceptowane wartości
Identyfikator statystyki Wymagane Maksymalnie 100 znaków.

Musi składać się tylko z liter, cyfr i znaków podkreślenia. Musi być unikalny we wszystkich statystykach w grze.
Wyświetlana nazwa statystyki Wymagane Musi to być unikalna nazwa.
Język Wymagane Kod języka, np. en-US.
Zanim określisz język,dodaj tłumaczenia gry. Pamiętaj, że nie możesz określić języka domyślnego.

Obsługiwane kody ustawień regionalnych znajdziesz na liście obsługiwanych języków.
Zlokalizowana wyświetlana nazwa statystyki Opcjonalnie Maksymalnie 50 znaków. Przetłumaczona wyświetlana nazwa statystyki w danym języku.
Zlokalizowany opis statystyk Opcjonalnie Maksymalna liczba znaków to 500. Przetłumaczony opis statystyk w danym języku.
Przykładowa tabela
Identyfikator statystyki Wyświetlana nazwa statystyki Language Code Localized Stat Name (UTF-8) Localized Stat Description (UTF-8) 1 Najdłuższy mecz w trybie przetrwania es Supervivencia más larga en partidos Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. 1 Najdłuższy mecz w trybie przetrwania fr Survie du match le plus long Cela indique la durée de survie d'un joueur dans n'importe quel match. 4 Łączna ilość zebranego złota es Całkowita ilość zebranego złota La jugadora recoge monedas mientras juega en un partido 4 Łączna ilość zebranego złota fr Or total collecté Le joueur collecte des pièces en jouant un match

Pliki ikon

Ikony, do których odwołujesz się w pliku .csv, muszą znajdować się w bieżącym importowanym archiwum ZIP.

Reguły weryfikacji ikon:

Właściwość weryfikacji Egzekwowane ograniczenie lub reguła
Maksymalny rozmiar pliku Maksymalny rozmiar pliku ikony to 1 MB (1 048 576 bajtów).
Wymiary Dokładnie 512 x 512 pikseli (szerokość = 512, wysokość = 512)
Format obrazu Ściśle 1:1 (kwadratowy format obrazu)
Dozwolone formaty PNG (.png) i JPEG (.jpg, .jpeg)
Miejsce docelowe w kodzie pocztowym Musi znajdować się w katalogu głównym pliku ZIP.
Sprawdzanie przywoływane Wszystkie nazwy plików ikon podane w kolumnach Nazwa pliku ikony muszą znajdować się w pliku ZIP.
Sprawdzanie osieroconych Do wszystkich plików graficznych w pliku ZIP musi się odwoływać co najmniej 1 statystyka.
Sprawdzanie pod kątem konfliktu Nazwy plików ikon w zasadzie ProgressionStatConfig.csv nie mogą kolidować z zasadą RepetitiveStatsConfig.csv.
Duplikaty wizualne Zduplikowane ikony są oznaczane.

Wytyczne dotyczące ikon

Ikony powinny mieć wymiary 512 x 512 pikseli i format PNG, JPEG lub JPG.

We wszystkich wersjach językowych używana jest ta sama ikona, dlatego nie zalecamy umieszczania na niej tekstu ani treści zlokalizowanych.

Specyfikacja jednostki

Kolumny Jednostka określają sposób formatowania i lokalizowania surowych wartości statystyk dla graczy.

Właściwości statystyk liczbowych (INT64, DOUBLE)

Dozwolona wartość jednostki Przykładowa wartość pierwotna
(Empty) / UNITLESS / NONE 1234567
% / PERCENTAGE / PERCENT 0,857
Odległość/długość: CENTYMETR, METR, KILOMETR, STOPA, CAL, MILA, JARD, MILIMETR, NANOMETR 15 (KILOMETR)
Prędkość: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

Właściwości statystyk nieliczbowych (STRING, BOOL)

Kolumny jednostek muszą pozostać puste.