Gli obiettivi possono essere un ottimo modo per aumentare il coinvolgimento degli utenti nel tuo gioco. Puoi implementare gli obiettivi nel tuo gioco per incoraggiare i giocatori a sperimentare funzionalità che normalmente non userebbero o ad approcciarsi al gioco con stili di gioco completamente diversi. Gli obiettivi possono anche essere un modo divertente per i giocatori di confrontare i loro progressi e impegnarsi in una competizione leggera.
Per scoprire come implementare gli obiettivi per la tua piattaforma, consulta Implementazioni client.
Attributi
Per capire come funzionano gli obiettivi, devi conoscere alcuni degli attributi associati.
Questi elementi di base sono associati a ogni obiettivo:
- Id è una stringa univoca generata da Google Play Console. Utilizzerai questo ID univoco per fare riferimento all'obiettivo nei client di gioco.
- Nome è un nome breve dell'obiettivo (ad esempio, "Pieman"). Il valore può contenere fino a 100 caratteri.
- Descrizione è una breve descrizione del tuo obiettivo. Di solito indica al giocatore come ottenere l'obiettivo (ad esempio, "Cuoci una torta meringata al limone prima del tramonto"). Il valore può contenere fino a 500 caratteri.
- L'icona è un'icona quadrata associata al tuo obiettivo. Per le best practice per la creazione delle icone degli obiettivi, consulta la sezione Linee guida per le icone.
- L'ordine dell'elenco è l'ordine in cui vengono visualizzati gli obiettivi bloccati quando un giocatore visualizza gli obiettivi associati al tuo gioco. Puoi disporli nell'ordine che preferisci. Gli obiettivi sbloccati vengono visualizzati in cima all'elenco nell'ordine in cui sono stati raggiunti.
Stato
Gli obiettivi possono avere uno dei tre seguenti stati:
- Un obiettivo nascosto significa che i dettagli dell'obiettivo sono nascosti al giocatore. Play Games Services fornisce una descrizione e un'icona generiche per l'obiettivo mentre è in stato nascosto. Ti consigliamo di nascondere un obiettivo se contiene uno spoiler che non vuoi rivelare troppo presto sul tuo gioco (ad esempio, "Scopri che sei sempre stato un fantasma!").
- Un obiettivo rivelato significa che il giocatore conosce l'obiettivo, ma non l'ha ancora raggiunto. La maggior parte degli obiettivi inizia nello stato rivelato.
- Un obiettivo sbloccato significa che il giocatore lo ha ottenuto. Un obiettivo può essere sbloccato offline. Quando il gioco torna online, si sincronizza con i servizi per i giochi di Play per aggiornare lo stato di sblocco dell'obiettivo.
Risultati incrementali
Gli obiettivi possono essere designati come standard o incrementali. In genere, un obiettivo incrementale prevede che un giocatore faccia progressi graduali verso il raggiungimento dell'obiettivo in un periodo di tempo più lungo. Man mano che il giocatore avanza verso l'obiettivo incrementale, puoi segnalare i progressi parziali a Play Games Services.
Il servizio Google Play tiene traccia delle informazioni sul progresso, avvisa il gioco quando il giocatore ha soddisfatto i criteri necessari per sbloccare il risultato e comunica al giocatore a che punto si trova per raggiungere l'obiettivo.
Gli obiettivi incrementali sono cumulativi nelle sessioni di gioco e i progressi non possono essere rimossi o ripristinati all'interno del gioco. Ad esempio, "Vinci 50 partite" sarebbe considerato un obiettivo incrementale. "Vinci 3 partite di fila" non lo sarebbe, in quanto i progressi del giocatore verrebbero azzerati quando perde una partita. Anche "Avere 5000 fiches da poker" non sarebbe idoneo, in quanto un giocatore potrebbe guadagnare e perdere fiches mentre gioca. Per gli ultimi due obiettivi, spetta a te monitorare lo stato di "Vittorie consecutive" o il totale delle fiches del giocatore e sbloccare gli obiettivi standard quando il giocatore li ottiene.
Quando crei un obiettivo incrementale, devi definire il numero totale di passaggi necessari per sbloccarlo (deve essere un numero compreso tra 2 e 10.000). Man mano che l'utente avanza verso lo sblocco dell'obiettivo, devi segnalare il numero di passaggi aggiuntivi che ha compiuto a Play Games Services. Una volta che il numero totale di passi raggiunge il valore di sblocco, l'obiettivo viene sbloccato (anche se era nascosto). Non è necessario memorizzare i progressi cumulativi dell'utente.
Punti
Ai traguardi è associato un valore in punti. Il punteggio del giocatore deve essere un multiplo di 5 e un gioco non può mai avere un totale di più di 1000 punti per tutti i suoi obiettivi (anche se può averne di meno). Inoltre, nessun singolo obiettivo può avere più di 200 punti.
Monitorare i punti esperienza (XP)
I giocatori possono salire di livello nel loro profilo di gioco quando ottengono obiettivi nei giochi compatibili con Play Giochi. Per ogni punto associato a un obiettivo, il giocatore guadagna 100 punti esperienza (XP) quando lo raggiunge. In altre parole:
XP for an achievement = 100 * (point value for the achievement)
I servizi Google Play Giochi tengono traccia dei punti esperienza guadagnati da ogni giocatore e inviano una notifica all'app Google Play Giochi quando il giocatore ha guadagnato punti sufficienti per "salire di livello". I giocatori possono visualizzare la cronologia del livello e dell'esperienza nella pagina del profilo dell'app Google Play Giochi.
Obiettivi minimi
Un gioco che integra gli obiettivi deve averne almeno cinque prima di essere pubblicato. Puoi eseguire test con meno di cinque obiettivi, ma ti consigliamo di crearne almeno cinque prima di pubblicare il gioco.
Obiettivi massimi
Il numero di obiettivi è limitato dai limiti e dalla distribuzione dei punti. Con un numero massimo di punti pari a 1000 e 5 punti assegnati a ogni obiettivo, il numero massimo di obiettivi è 200. Tuttavia, se ai risultati vengono assegnati più punti, il numero di risultati disponibili diminuisce di conseguenza.
Aggiungi obiettivi
Esistono due modi per creare obiettivi per la prima volta utilizzando Google Play Console:
- Crea un obiettivo: aggiungi definizioni e metadati per ogni obiettivo uno alla volta.
- Importa obiettivi: importa definizioni e altri metadati per più obiettivi contemporaneamente in un unico passaggio.
Creare un obiettivo
Per creare un obiettivo per un gioco nuovo e non pubblicato, completa questi passaggi:
- In Google Play Console, seleziona un gioco.
- Nella pagina Servizi per i giochi di Play - Obiettivi (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Obiettivi), seleziona Crea obiettivo.
- Nella pagina Aggiungi obiettivi, compila il modulo.
- Fai clic su Salva come bozza.
- Dopo aver creato un obiettivo, devi pubblicare il gioco.
Aggiungi altri obiettivi
Se hai già degli obiettivi e vuoi aggiungerne altri:
- In Google Play Console, seleziona un gioco.
- Nella pagina Servizi per i giochi di Play - Obiettivi (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Obiettivi), seleziona Aggiungi obiettivi.
Importa obiettivi
Per aggiungere più obiettivi contemporaneamente al tuo gioco, segui questi passaggi:
- Crea un file ZIP contenente i tuoi obiettivi.
- Carica il file.
Per ulteriori informazioni sul file ZIP, consulta le linee guida relative ai file ZIP.
Per importare gli obiettivi:
- In Google Play Console, seleziona un gioco.
- Nella pagina Servizi per i giochi di Play - Obiettivi (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Obiettivi), seleziona Importa obiettivi.
- Nella pagina Importa obiettivi, fai clic su Carica.
- Seleziona il file ZIP da caricare.
- Fai clic su Salva come bozza.
- Dopo aver importato gli obiettivi, devi pubblicare il gioco.
Pubblica il tuo gioco
Una volta testato e pubblicato il gioco, tutti i relativi obiettivi vengono pubblicati con il gioco stesso.
Modifica un obiettivo
Per modificare un obiettivo già creato, selezionalo nella scheda Obiettivi di Google Play Console. A questo punto, vedrai lo stesso modulo utilizzato per la creazione dell'obiettivo e potrai modificare i campi in base alle tue esigenze.
Al termine della modifica di un obiettivo, fai clic sul pulsante Salva come bozza. L'obiettivo appena modificato sarà testabile e potrai dunque verificarne il funzionamento. Se funziona correttamente, seleziona Ripubblica dall'elenco a discesa. il gioco verrà ripubblicato insieme a tutti gli obiettivi aggiornati.
Annulla una modifica
Se decidi che il tuo attuale obiettivo non ti piace e vuoi tornare a quello precedente, seleziona Ripristina dall'elenco a discesa in Google Play Console e tutti i tuoi obiettivi verranno ripristinati alla versione pubblicata in precedenza.
Elimina un obiettivo
Una volta pubblicato, l'obiettivo non può essere eliminato.
Puoi eliminare un obiettivo in stato di prepubblicazione solo facendo clic sul pulsante Elimina nella parte inferiore del modulo relativo all'obiettivo.
Reimposta un obiettivo
Puoi reimpostare i dati relativi ai progressi dei giocatori solo per gli obiettivi nello stato "Bozza".
- Per reimpostare gli obiettivi in Google Play Console, fai clic sul pulsante Reimposta progressi obiettivi nella parte inferiore del modulo relativo all'evento.
- Per reimpostare i dati degli obiettivi in modo programmatico, chiama i metodi relativi agli
Achievementsdell'API di gestione.
Linee guida per le icone
Le icone devono essere create come file PNG, JPEG o JPG da 512 x 512. Devi solamente fornirci l'icona dell'obiettivo sbloccato. Genereremo automaticamente una versione in scala di grigi per l'icona svelata. Per questo motivo, ti consigliamo di includere elementi colorati nelle icone degli obiettivi, in modo che gli utenti possano distinguere gli obiettivi svelati da quelli sbloccati.
Quando l'icona di un obiettivo viene visualizzata in una notifica toast di Android, è sovrapposta da un cerchio e gli angoli esterni sono nascosti. Assicurati che l'icona abbia una buona resa in queste circostanze.
La stessa icona viene utilizzata in tutte le impostazioni internazionali, pertanto ti sconsigliamo di includere testo o contenuti localizzati in un'icona.
Linee guida per i file ZIP
Puoi importare più obiettivi 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 |
|---|---|---|
AchievementsMetadata.csv
|
Obbligatorio | Metadati per ogni obiettivo. Consulta la sezione Attributi. |
AchievementsLocalizations.csv
|
Facoltativo | Fornisce le traduzioni dei nomi e delle descrizioni degli obiettivi. |
AchievementsIconMappings.csv
|
Facoltativo | Associa gli obiettivi ai relativi file delle icone. |
| File delle icone | Facoltativo | Icone in formato PNG, JPEG o JPG. |
Requisiti del file ZIP:
- Nessuna sottodirectory.
- Nomi file univoci.
- Solo file CSV, PNG, JPEG o JPG.
- I file CSV non devono avere una riga di intestazione.
- Le dimensioni di ogni file non devono superare 1 MB.
- Il file zip non deve contenere più di 203 file.
- La dimensione totale del file ZIP deve essere inferiore a 200 MB.
Formato AchievementsMetadata.csv
Il file AchievementsMetadata.csv contiene i metadati di ogni obiettivo.
Deve includere le informazioni come valori separati da virgola nel seguente ordine:
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Valori accettati |
|---|---|---|
| Nome | Obbligatorio | Massimo 100 caratteri |
| Descrizione | Facoltativo | Massimo 500 caratteri |
| Valore incrementale | Facoltativo | True o False
|
| Passaggi necessari | Obbligatorio se Incremental Value è True.
|
Numero (senza frazioni o decimali) |
| Stato iniziale | Obbligatorio | Hidden o Revealed
|
| Punti | Obbligatorio | Numero multiplo di 5 con un valore compreso tra 5 e 200 |
| Ordine in elenco | Facoltativo | Numero (senza frazioni o decimali e maggiore di zero) |
Requisiti del file AchievementsMetadata.csv:
- Ogni riga deve avere sette valori. Se vuoi omettere un valore, lascialo vuoto.
- I campi
NameeDescriptionvengono utilizzati come impostazioni internazionali predefinite. - Il campo
Namedeve essere univoco per tutti gli obiettivi. - I seguenti campi non devono contenere virgole:
NameeDescription.
File AchievementsMetadata.csv di esempio:
Achievement1,Achievement One,True,100,Hidden,5,20
Achievement2,Achievement Two,False,,Revealed,10,30
AchievementsLocalizations.csv format
Il file AchievementsLocalizations.csv è un file facoltativo che configura tutti i dati necessari per descrivere ogni obiettivo agli utenti in lingue diverse.
Gli obiettivi vengono tradotti in base alle lingue specificate per il gioco.
Deve includere le informazioni come valori separati da virgola nel seguente ordine:
Name, Localized name, Localized description, locale
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Descrizione | Valori accettati |
|---|---|---|---|
| Nome | Obbligatorio | Deve corrispondere alla colonna Name di AchievementsMetadata.csv.
|
Massimo 100 caratteri |
| Nome localizzato | Obbligatorio | Il nome localizzato dell'obiettivo. | Massimo 100 caratteri |
| Descrizione localizzata | Facoltativo | La descrizione localizzata dell'obiettivo nella lingua specificata. | Massimo 500 caratteri |
| 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. |
Requisiti del file AchievementsLocalizations.csv:
- I nomi degli obiettivi all'interno di un gioco devono essere univoci per ogni lingua. Ad esempio, se un gioco supporta le impostazioni internazionali en-US e fr-FR, un obiettivo denominato "Achievement1" per en-US può avere lo stesso nome per fr-FR.
- Ogni riga deve avere quattro valori. Se vuoi omettere il valore Descrizione localizzata, lascialo vuoto.
File AchievementsLocalizations.csv di esempio:
Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
Formato AchievementsIconMappings.csv
Il file AchievementsIconMappings.csv è un file facoltativo utilizzato per associare
gli obiettivi all'icona specificata. Deve includere le informazioni come valori separati da virgola nel seguente ordine:
Name, icon filename
Questi campi sono descritti nella tabella seguente:
| Intestazioni colonna CSV | Obbligatorio o facoltativo | Descrizione |
|---|---|---|
| Nome | Obbligatorio | Deve corrispondere alla colonna Name di AchievementsMetadata.csv.
|
| Nome file dell'icona | Obbligatorio | Il nome del file dell'icona. |
Requisiti del file AchievementsIconMappings.csv:
- Ogni riga deve avere due valori.
- I file delle icone possono essere solo in formato PNG o JPEG.
File AchievementsIconMappings.csv di esempio:
Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg
File delle icone
Le icone a cui fai riferimento nel file AchievementsIconMappings.csv devono essere incluse nel file ZIP corrente che importi. Per ulteriori informazioni, consulta le
linee guida per le icone.
Aggiungere traduzioni per gli obiettivi
Puoi specificare le tue traduzioni per gli obiettivi associati al gioco. Prima di procedere, assicurati di completare i passaggi descritti nella sezione Aggiunta di traduzioni per il gioco.
Esistono due modi per aggiungere le traduzioni per il tuo gioco:
Puoi utilizzare l'opzione Importa obiettivi per caricare le traduzioni di svariati nuovi obiettivi contemporaneamente. Non puoi utilizzare questa opzione per caricare le traduzioni di obiettivi esistenti.
Puoi aggiungere le traduzioni per ogni obiettivo del tuo gioco. Per aggiungere la tua traduzione per ogni obiettivo:
- In Google Play Console, apri la scheda Obiettivi del tuo gioco, quindi seleziona un obiettivo esistente.
- Nella pagina dei dettagli degli obiettivi, seleziona la scheda di una lingua che hai aggiunto in precedenza nella scheda Dettagli del gioco.
- Nella pagina dei dettagli dell'obiettivo per la lingua in questione, modifica il modulo con le tue traduzioni per l'obiettivo.
- Fai clic su Salva per memorizzare i dettagli dell'obiettivo tradotti.
Implementazioni client
Per scoprire come implementare gli obiettivi per la tua piattaforma, consulta le seguenti risorse: