Questo documento spiega come integrare le statistiche di gioco nel tuo gioco utilizzando Google Play Console. Vengono trattati i formati essenziali dei file CSV e ZIP e viene descritto come crearli, importarli e gestirli.
Crea eventi
Per creare un evento per un gioco nuovo e non pubblicato, completa questi passaggi:
- Crea il file CSV degli eventi PlayerGameEvent.csv
- In Google Play Console, seleziona un gioco.
- Nella pagina Play Games Services - Statistiche di gioco (Aumenta il numero di utenti > Play Games Services > Configurazione e gestione > Statistiche di gioco), seleziona Configura eventi.
- Nella pagina Configurazione eventi, trascina il file CSV da caricare.
- Dopo aver creato un evento, devi configurare le statistiche.
Configurare le statistiche
Dopo aver creato un evento, devi configurare le statistiche:
- Crea il file ZIP contenente statistiche, localizzazioni e file delle icone Linee guida per i file ZIP per le statistiche.
- In Google Play Console, seleziona un gioco.
- Nella pagina Play Games Services - Statistiche di gioco (Aumenta il numero di utenti > Play Games Services > Configurazione e gestione > Statistiche di gioco), seleziona Configura statistiche.
- Nella pagina Configurazione delle statistiche di gioco, rilascia il file ZIP da caricare.
- Dopo aver caricato tutte le statistiche, puoi pubblicare il gioco.
Testare le statistiche di gioco
Per verificare che le statistiche di gioco funzionino come previsto, segui i passaggi per testarle:
- Configura un canale di test interno.
- Aggiungi account di test al tuo progetto di gioco per i tester.
- Crea un profilo Play Games Services per uno degli account di test utilizzando l'app Play Giochi.
- Apri il gioco utilizzando lo stesso account di test per cui hai creato il profilo di Play Games Services.
- Verifica che il "toast di benvenuto" dei servizi per i giochi di Play venga visualizzato sullo schermo come conferma dell'autenticazione automatica riuscita all'avvio del gioco.
- L'utente dell'account di test può giocare per attivare gli eventi. Controlla la risposta dell'API per sapere se gli eventi sono stati registrati.
Pubblicare le statistiche di gioco
Una volta terminato il test, devi pubblicare il gioco. Tutti gli eventi e le statistiche del gioco vengono pubblicati insieme al gioco stesso.
Per pubblicare, segui questi passaggi:
- In Google Play Console, seleziona un gioco.
- Nella pagina Play Games Services - Statistiche di gioco (Aumenta il numero di utenti > Play Games Services > Configurazione e gestione > Statistiche di gioco), fai clic su Rivedi e pubblica.
- Nella pagina Play Games Services - Pubblicazione (Aumenta il numero di utenti > Play Games Services > Configurazione e gestione > Pubblicazione), esamina le azioni e risolvi i problemi.
- Fai clic su Pubblica. Tutte le tue statistiche di gioco vengono pubblicate.
Eliminare le statistiche di gioco
Una volta pubblicate, le statistiche di gioco non possono essere eliminate.
Linee guida relative ai file CSV per gli eventi
La prima riga del file CSV è una riga di intestazione. Devi importare gli eventi utilizzando il file CSV degli eventi, ad esempio PlayerGameEvent.csv.
Formato PlayerGameEvent.csv
Il file CSV contiene l'evento dichiarato e le relative proprietà come valori separati da virgola nel seguente ordine:
Event Name,Property Name,Property Type
Se invii l'evento progressUpdate per progressionStat, aggiungi una riga per questo evento. Questo evento deve contenere almeno una proprietà currentProgress di tipo INT o STRINGA, oltre a qualsiasi altra proprietà che vuoi inviare.
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Valori accettati |
|---|---|---|
| Nome evento | Obbligatorio | Massimo 50 caratteri Deve essere composto solo da lettere, numeri e trattini bassi. Se viene utilizzato il nome dell'evento speciale |
| Nome proprietà | Obbligatorio | Massimo 50 caratteri Deve essere composto solo da lettere, numeri e trattini bassi. Univoco per evento:i nomi delle proprietà devono essere univoci all'interno dello stesso evento. Non utilizzare le seguenti parole chiave riservate: |
| Tipo di proprietà | Obbligatorio | Corrispondenza di stringhe enum sensibili alle maiuscole e minuscole con uno dei tipi di dati supportati:
INT64, DOUBLE, STRING, BOOL
|
Requisiti del file PlayerGameEvent.csv:
- Il file supporta un massimo di 20 nomi di eventi univoci, con un massimo di 20 proprietà per evento.
- Il contenuto del file non può essere vuoto e deve contenere almeno una riga.
Esempio tabella
| Nome evento | Nome proprietà | Tipo di proprietà |
|---|---|---|
| matchCompleted | durata | DOPPIO |
| matchCompleted | uccisioni | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
Linee guida per i file ZIP per le statistiche
Puoi importare le statistiche contemporaneamente utilizzando un file ZIP. Fai riferimento alla tabella di seguito per i nomi file esatti da utilizzare nel file ZIP:
| Nome file | Obbligatorio o facoltativo | Valori accettati |
|---|---|---|
RepetitiveStatsConfig.csv
|
Obbligatorio | Una statistica ripetitiva rappresenta le azioni in-game che si verificano regolarmente eseguite dai giocatori. |
ProgressionStatConfig.csv
|
Obbligatorio | Una statistica di avanzamento rappresenta i progressi di un giocatore in un gioco. |
StatLocalizations.csv
|
Facoltativo | Fornisce le traduzioni dei nomi e delle descrizioni delle statistiche di gioco. |
| File delle icone | Obbligatorio | Icone in formato PNG, JPEG o JPG da 512 x 512. |
Il file ZIP deve soddisfare i seguenti requisiti:
- Limite di dimensione del file ZIP:la dimensione totale massima non compressa è 10 MB.
- Numero massimo di file:massimo 53 file totali (3 CSV e 50 icone) all'interno dell'archivio ZIP.
- Limite massimo di statistiche combinate: massimo 50 statistiche totali tra
ProgressionStatConfig.csveRepetitiveStatsConfig.csv. - File CSV supportati:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csveStatLocalizations.csv(facoltativo). Se vuoi caricare solo le statistiche di avanzamento, non includere il file CSV delle statistiche ripetitive nel file ZIP, altrimenti la console genera un errore. Lo stesso vale se vuoi caricare solo statistiche ripetitive. - File immagine dell'icona: PNG (.png) o JPEG (.jpg, .jpeg).
- Tutte le icone a cui viene fatto riferimento nei file CSV devono essere presenti nella radice del file ZIP.
- Tutti i file immagine presenti nel file ZIP devono essere referenziati da almeno una statistica.
- Struttura delle directory:tutti i file devono trovarsi nella directory root del file ZIP. Non sono consentite sottodirectory.
Formato RepetitiveStatsConfig.csv
Il file CSV contiene l'evento dichiarato e le relative proprietà come valori separati da virgola nel seguente ordine:
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
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Valori accettati |
|---|---|---|
| ID statistica | Obbligatorio | Massimo 100 caratteri Deve essere composto solo da lettere, numeri e trattini bassi. Deve essere univoco in tutte le statistiche del gioco. |
| Nome proprietà evento | Obbligatorio | Massimo 50 caratteri |
| Nome visualizzato della statistica | Obbligatorio | Massimo 50 caratteri Nome visualizzato predefinito per la statistica (località predefinita). Deve essere univoco in tutte le statistiche. |
| Stat Description | Obbligatorio | Massimo 500 caratteri Descrizione predefinita della statistica. |
| Tipo di aggregazione | Obbligatorio | Massimo 50 caratteri SUM, MAX, MIN, COUNT. |
| Filtra proprietà | Facoltativo | Massimo 50 caratteri Deve essere un nome proprietà definito in PlayerGameEvent.csv. |
| Operatore di filtro | Facoltativo | =, !=, >, <, >=, <=Operatori di confronto dei filtri. |
| Valore filtro | Facoltativo | Rispetto alla proprietà di filtro.
Il valore di filtro deve essere INT64, DOUBLE, BOOL, STRING.
|
| È competitivo | Obbligatorio | true, false
|
| Limite minimo | Obbligatorio quando Is Competitive è true | Punteggio minimo consentito per le statistiche competitive. |
| Limite massimo | Obbligatorio quando Is Competitive è true | Il punteggio massimo consentito per le statistiche competitive. |
| Nome file dell'icona | Obbligatorio | Nome del file dell'immagine dell'icona incluso nella radice del file ZIP. Non può entrare in conflitto con i nomi dei file delle icone utilizzati nelle statistiche ripetitive. |
| Indicazione di un buon rapporto qualità-prezzo | Obbligatorio | Specifica se sono migliori i valori più alti INCREASING o quelli più bassi DECREASING.
|
| Unità | Facoltativo | Unità di misura per i valori numerici o di durata non elaborati. Ad esempio, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Se non vuoi utilizzare la condizione di filtro, lascia la cella vuota.
Esempio tabella
| ID stat | Nome evento | Nome proprietà | Aggregazione | Nome visualizzato della statistica | Stat Description | Proprietà del filtro (facoltativo) | Operatore di filtro (facoltativo) | Valore filtro (facoltativo) | È competitivo | minLimit | maxLimit | Nome file dell'icona | Numero di sequenza | Indicazione di un buon rapporto qualità-prezzo | unità |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | durata | MAX | Sopravvivenza nella partita più lunga | Indica il tempo di sopravvivenza di un giocatore in una partita | isWinner | = | VERO | VERO | 0 | 50 | stat1.png | 1 | In diminuzione | secondi |
| 2 | matchCompleted | isWinner | COUNT | Partite vinte | Indica il numero di partite vinte da un giocatore | isWinner | = | VERO | VERO | 0 | 50 | stat3.png | 2 | In aumento | |
| 3 | matchCompleted | uccisioni | SUM | Uccisioni in scontri 1 contro 1 | Numero di uccisioni effettuate nelle partite 1 contro 1 | matchType | = | "1-on-1" | FALSO | stat4.png | 4 | In aumento | |||
| 4 | itemCollected | coinsAmount | SUM | Oro totale raccolto | Il giocatore raccoglie monete mentre gioca in una partita | weaponType | = | "sword" | FALSO | stat2.png | 3 | In aumento |
Formato ProgressionStatConfig.csv
Il file CSV contiene l'evento dichiarato e le relative proprietà come valori separati da virgola nel seguente ordine:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
La statistica di progressione verrà mostrata come prima statistica a un giocatore nel suo profilo giocatore.
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Valori accettati |
|---|---|---|
| ID statistica | Obbligatorio | Massimo 100 caratteri Deve essere composto solo da lettere, numeri e trattini bassi. Deve essere univoco in tutte le statistiche del gioco. |
| Nome evento | Obbligatorio | Massimo 50 caratteri Deve fare riferimento al nome evento definito nel formato PlayerGameEvent.csv. |
| Nome proprietà evento | Obbligatorio | Massimo 50 caratteri Deve essere un nome proprietà definito in PlayerGameEvent.csv. |
| Nome visualizzato della statistica | Obbligatorio | Deve essere un nome univoco. |
| Stat Description | Obbligatorio | Massimo 50 caratteri Descrizione predefinita della statistica. |
| Nome file dell'icona | Obbligatorio | Nome del file dell'immagine dell'icona incluso nella radice del file ZIP. Non può entrare in conflitto con i nomi dei file delle icone utilizzati nelle statistiche ripetitive. |
| Indicazione di un buon rapporto qualità-prezzo | Obbligatorio | Specifica se sono migliori i valori più alti INCREASING o quelli più bassi DECREASING.
|
| Unità | Facoltativo | Unità di misura per i valori numerici o di durata non elaborati. Ad esempio, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Esempio tabella
| ID statistica | Nome proprietà evento | Stat Display Name | Stat Description | Nome file icona | Indicazioni sul rapporto qualità-prezzo |
|---|---|---|---|---|---|
| 5 | currentProgress | Livello | I giocatori accumulano XP giocando partite e salgono di livello. | Level.png | in aumento |
Formato StatLocalizations.csv
Il file CSV contiene l'evento dichiarato e le relative proprietà come valori separati da virgola nel seguente ordine:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Valori accettati |
|---|---|---|
| ID statistica | Obbligatorio | Massimo 100 caratteri Deve essere composto solo da lettere, numeri e trattini bassi. Deve essere univoco in tutte le statistiche del gioco. |
| Nome visualizzato della statistica | Obbligatorio | Deve essere un nome univoco. |
| Impostazioni internazionali | Obbligatorio | Il codice della lingua, ad esempio en-US. Aggiungi le traduzioni per il tuo gioco prima di specificare una lingua. Tieni presente che non puoi specificare la lingua predefinita. Puoi trovare i codici delle impostazioni internazionali supportate nell'elenco delle lingue supportate. |
| Localized Stat Display Name | Facoltativo | Massimo 50 caratteri. Nome visualizzato della statistica tradotto per le impostazioni internazionali specificate. |
| Descrizione localizzata della statistica | Facoltativo | Massimo 500 caratteri. Descrizione della statistica tradotta per le impostazioni internazionali specificate. |
Esempio tabella
| ID statistica | Stat Display Name | Codice lingua | Localized Stat Name (UTF-8) | Descrizione statistica localizzata (UTF-8) | 1 | Sopravvivenza nella partita più lunga | es | Sopravvivenza più lunga nelle partite | Indica il tempo di sopravvivenza di un giocatore in una partita. | 1 | Sopravvivenza nella partita più lunga | fr | Sopravvivenza nella partita più lunga | Indica la durata della sopravvivenza di un giocatore in una partita. | 4 | Oro totale raccolto | es | Oro totale raccolto | La giocatrice raccoglie monete mentre gioca una partita | 4 | Oro totale raccolto | fr | O totale raccolto | Il giocatore raccoglie monete giocando una partita |
File delle icone
Le icone a cui fai riferimento nel file .csv devono essere incluse nel
file ZIP corrente che importi.
Le regole di convalida delle icone sono:
| Proprietà di convalida | Vincolo / regola applicato |
|---|---|
| Dimensioni massime del file | Massimo 1 MB (1.048.576 byte) per file icona. |
| Dimensioni | Esattamente 512 × 512 pixel (larghezza = 512, altezza = 512) |
| Proporzioni | Rigorosamente 1:1 (proporzioni quadrate) |
| Formati consentiti | PNG (.png) e JPEG (.jpg, .jpeg) |
| Posizionamento nel file ZIP | Deve trovarsi nella directory principale del file ZIP. |
| Controllo per riferimento | Tutti i nomi dei file delle icone specificati nelle colonne Nome file icona devono esistere nel file ZIP. |
| Controllo orfani | Tutti i file immagine all'interno del file ZIP devono essere referenziati da almeno una statistica. |
| Controllo dei conflitti | I nomi file delle icone in ProgressionStatConfig.csv non devono
essere in conflitto con RepetitiveStatsConfig.csv.
|
| Duplicati visivi | Le icone duplicate vengono contrassegnate. |
Linee guida per le icone
Le icone devono essere create come file PNG, JPEG o JPG da 512 x 512.
La stessa icona viene utilizzata in tutte le impostazioni internazionali, pertanto ti sconsigliamo di includere testo o contenuti localizzati.
Specifiche dell'unità
Le colonne Unità controllano la formattazione e la localizzazione dei valori delle statistiche non elaborate per i giocatori.
Proprietà delle statistiche numeriche (INT64, DOUBLE)
| Valore unità consentito | Valore non elaborato di esempio |
| (Vuoto) / SENZA UNITÀ / NESSUNO | 1234567 |
| % / PERCENTUALE / PERCENT | 0,857 |
| Distanza/Lunghezza: CENTIMETRO, METRO, CHILOMETRO, PIEDE, POLLICE, MIGLIO, IARDA, MILLIMETRO, NANOMETRO | 15 (CHILOMETRI) |
| Velocità: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
Proprietà delle statistiche non numeriche (STRING, BOOL)
Le colonne delle unità devono essere lasciate vuote.