Obiettivi

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 tuo gioco con stili di gioco completamente diversi. Gli obiettivi possono anche essere un modo divertente per i giocatori di confrontare i propri progressi e sfidarsi in modo amichevole.

Per scoprire come implementare i traguardi per la tua piattaforma, consulta la sezione Implementazioni per i client.

Attributi

Per capire come funzionano i traguardi, è consigliabile conoscere alcuni degli attributi associati.

A ogni obiettivo sono associati questi elementi di base:

  • 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 descrizione concisa del tuo obiettivo. Di solito viene spiegato al giocatore come ottenere il traguardo (ad esempio, "Fai una torta meringata al limone prima del tramonto"). Il valore può contenere fino a 500 caratteri.
  • Icona è un'icona quadrata associata al tuo traguardo. Per le best practice sulla creazione delle icone dei traguardi, 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. Possono essere nell'ordine che preferisci. Gli obiettivi sbloccati vengono visualizzati in cima all'elenco nell'ordine in cui sono stati raggiunti.

Stato

I traguardi possono trovarsi in uno dei tre seguenti stati:

  • Un obiettivo nascosto indica che i dettagli dell'obiettivo sono nascosti al giocatore. Play Services per i giochi fornisce una descrizione e un'icona generiche per il segnaposto dell'obiettivo quando è in uno stato nascosto. Ti consigliamo di nascondere un obiettivo se contiene uno spoiler che non vuoi rivelare troppo presto sul tuo gioco (ad esempio, "Scopri di essere un fantasma").
  • Un obiettivo rivelato indica che il giocatore conosce l'obiettivo, ma non lo ha ancora ottenuto. La maggior parte dei traguardi inizia nello stato di scoperto.
  • Un obiettivo sbloccato indica che il giocatore lo ha ottenuto. Un obiettivo può essere sbloccato offline. Quando il gioco viene attivato online, si sincronizza con i servizi per i giochi di Google Play per aggiornare lo stato di sblocco dell'obiettivo.

Risultati incrementali

I traguardi possono essere definiti standard o incrementali. In genere, un obiettivo incrementale prevede che un giocatore effettui progressi graduali per ottenerlo in un periodo di tempo più lungo. Man mano che il giocatore fa progressi verso l'obiettivo incrementale, puoi segnalare i suoi progressi parziali a Play Giochi.

Il servizio Google Play tiene traccia delle informazioni sui progressi, avvisa il gioco quando il giocatore ha soddisfatto i criteri necessari per sbloccare il risultato e indica al giocatore quanto manca per raggiungere l'obiettivo.

Un obiettivo incrementale di esempio che mostra l'avanzamento del giocatore al 23%.
Obiettivo incrementale che mostra l'avanzamento del giocatore al 23%.

Gli obiettivi incrementali sono cumulativi nelle sessioni di gioco e i progressi non possono essere rimossi o reimpostati all'interno del gioco. Ad esempio, "Vinci 50 partite" potrebbe essere considerato un obiettivo incrementale. "Vinci 3 partite di fila" non lo farebbe, poiché i progressi del giocatore verrebbero reimpostati quando perde una partita. Anche "avere 5000 chip di poker" non è idoneo, in quanto un giocatore può guadagnare e perdere chip durante il gioco. Per questi ultimi due obiettivi, sta a te monitorare lo stato "Vince consecutive" o il totale dei chip 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 fa progressi verso lo sblocco del traguardo, devi segnalare il numero di passaggi aggiuntivi che ha completato a Play Services. Quando il numero totale di passaggi raggiunge il valore di sblocco, l'obiettivo viene sbloccato (anche se era nascosto). Non è necessario memorizzare il progresso cumulativo dell'utente.

Punti

A ogni obiettivo è 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 proprio profilo 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 ottiene. In altre parole:

XP for an achievement = 100 * (point value for the achievement)

I servizi di Play Giochi monitorano le XP guadagnate da ogni giocatore e inviano una notifica all'app Google Play Giochi quando il giocatore ha guadagnato punti sufficienti per "aumentare di livello". I giocatori possono visualizzare il loro livello e la cronologia delle XP dalla pagina del profilo nell'app Google Play Giochi.

Obiettivi minimi

Un gioco che integra gli obiettivi deve avere almeno cinque obiettivi prima di essere pubblicato. Puoi eseguire il test con meno di cinque obiettivi, ma è consigliabile 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.

Linee guida per le icone

Le icone devono essere create come file PNG o JPG da 512 x 512 pixel. Devi solo fornirci l'icona dell'obiettivo sbloccato. Genereremo automaticamente una versione in scala di grigi per l'icona rivelata. Per questo motivo, ti consigliamo di includere elementi colorati nelle icone dei traguardi, in modo che gli utenti possano distinguere facilmente tra i traguardi rivelati e quelli sbloccati.

Quando un'icona di un obiettivo viene visualizzata in un messaggio popup di Android, l'icona viene sovrapposta da un cerchio e i suoi angoli esterni vengono nascosti. Assicurati che l'icona abbia un aspetto ancora gradevole in queste circostanze.

Un'icona di obiettivo di esempio.
Un'icona di obiettivo di esempio.

La stessa icona viene utilizzata in tutte le lingue, pertanto ti consigliamo di non includere testo o contenuti localizzati in un'icona.

Creare un obiettivo

Questa sezione descrive come creare obiettivi per i giochi nuovi e pubblicati.

Nuova partita

Per creare un obiettivo per un gioco nuovo e non pubblicato, vai alla voce di Google Play Console relativa al tuo gioco nella scheda Giochi con servizi per i giochi.

Seleziona la scheda Obiettivi a sinistra e fai clic sul pulsante Aggiungi obiettivo.

Il pulsante "Aggiungi obiettivo" nel riquadro principale Obiettivi
Il pulsante "Aggiungi obiettivo" nel riquadro principale degli obiettivi.

Poi, compila le informazioni richieste per questo traguardo.

Un modulo di esempio compilato per il traguardo "Ultimo posto".
Un modulo di esempio per il traguardo "Ultimo posto" compilato.

Fai clic su Salva e il tuo traguardo verrà reso disponibile in modalità "Pronto per la pubblicazione". Una volta pubblicato il gioco, tutti i relativi obiettivi verranno pubblicati con il gioco.

Gioco pubblicato

Per creare un obiettivo aggiuntivo per un gioco già pubblicato, segui gli stessi passaggi descritti sopra. L'unica differenza è che il pulsante Salva verrà rinominato Salva come bozza e il tuo obiettivo sarà in modalità "Pronto per il test". Per ulteriori informazioni su come testare una versione aggiornata di un gioco, consulta Pubblicare le modifiche del gioco.

Una volta che hai testato l'obiettivo e ritieni che sia soddisfacente, puoi ripubblicare il tuo gioco con i nuovi obiettivi, che verranno pubblicati a livello mondiale.

Modificare un obiettivo

Per modificare un obiettivo che hai già creato, selezionalo nella scheda Obiettivi di Google Play Console. A questo punto, vedrai lo stesso modulo utilizzato per la prima creazione del traguardo e potrai modificare uno qualsiasi dei 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à nella fase"Pronto per il test" e potrai provarlo. Se funziona correttamente, seleziona Ripubblica dall'elenco a discesa. Il tuo gioco, insieme a tutti i traguardi aggiornati, verrà ripubblicato per il pubblico.

Annullare 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 torneranno alla versione pubblicata in precedenza.

Eliminare 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.

Reimpostare un obiettivo

Puoi reimpostare i dati relativi all'avanzamento dei giocatori solo per gli obiettivi in bozza.

  • Per reimpostare i risultati in Google Play Console, fai clic sul pulsante Ripristina avanzamento dei risultati nella parte inferiore del modulo relativo all'evento.
  • Per reimpostare i dati dei traguardi in modo programmatico, chiama i metodi dell'API di gestioneAchievements.

Aggiungere traduzioni per gli obiettivi

Puoi specificare le tue traduzioni per gli obiettivi associati al tuo gioco. Prima di procedere, assicurati di completare i passaggi descritti in Aggiunta di traduzioni per il tuo gioco. Inoltre, devi aver creato uno o più obiettivi per il tuo gioco.

Per aggiungere le tue traduzioni per i traguardi, apri la scheda Obiettivi per il tuo gioco in Google Play Console, quindi seleziona un obiettivo esistente. Nella pagina dei dettagli dei traguardi, seleziona la scheda di una lingua che hai aggiunto in precedenza nella scheda Dettagli del gioco. Nella pagina dei dettagli del traguardo per la lingua in questione, modifica il modulo con le tue traduzioni per il traguardo. Fai clic su Salva per memorizzare i dettagli del traguardo tradotti.

Implementazioni client

Per scoprire come implementare i traguardi per la tua piattaforma, consulta le seguenti risorse: