Obiettivi

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Invia feedback

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 Implementazioni per i client.

Attributi

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

A ogni traguardo 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 Games Services 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 è a conoscenza dell'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 progredisca gradualmente verso il suo ottenimento 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.

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 potrebbe guadagnare e perdere chip durante il gioco. Per gli ultimi due obiettivi, sta a te monitorare lo stato "Vittorie 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 meno). Inoltre, nessun singolo achievement può avere più di 200 punti.

Monitorare i punti esperienza (XP)

I giocatori possono salire di livello nel proprio profilo quando guadagnano 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.

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 singolarmente.
• 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:

1. In Google Play Console, seleziona un gioco.
2. Nella pagina Servizi per i giochi di Play - Obiettivi (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Obiettivi), selezionare Crea obiettivo.
3. Nella pagina Aggiungi obiettivi, compila il modulo.
4. Fai clic su Salva come bozza.
5. Dopo aver creato un obiettivo, devi pubblicare il gioco.

Aggiungere altri obiettivi

Se hai già degli obiettivi e vuoi aggiungerne altri:

1. In Google Play Console, seleziona un gioco.
2. Nella pagina Servizi per i giochi di Play - Obiettivi (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Obiettivi), selezionare Aggiungi obiettivi.

Importa obiettivi

Per aggiungere più obiettivi contemporaneamente al tuo gioco:

1. Crea un file ZIP contenente i tuoi obiettivi.
2. Carica il file.

Per ulteriori informazioni sul file ZIP, consulta le linee guida relative ai file ZIP.

Per importare gli obiettivi:

1. In Google Play Console, seleziona un gioco.
2. Nella pagina Servizi per i giochi di Play - Obiettivi (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Obiettivi), selezionare Importa obiettivi.
3. Nella pagina Importa obiettivi, fai clic su Carica.
4. Seleziona il file ZIP da caricare.
5. Fai clic su Salva come bozza.
6. Dopo aver importato gli obiettivi, devi pubblicare il gioco.

Pubblica il tuo gioco

Una volta testato e pubblicato il gioco, tutti gli obiettivi del gioco vengono pubblicati con il gioco.

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.

Linee guida per le icone

Le icone devono essere create come file PNG, JPEG o JPG da 512 x 512 pixel. Devi solo fornirci l'icona del traguardo sbloccato. Genereremo automaticamente una versione in scala di grigi per l'icona rivelata. Per questo motivo, consigliamo di includere elementi colorati nelle icone dei traguardi, in modo che gli utenti possano distinguere 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 gradevole anche in queste circostanze.

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

Linee guida per i file ZIP

Puoi importare più obiettivi contemporaneamente utilizzando un file ZIP. Consulta la tabella per i nomi di file esatti da utilizzare nel file ZIP:

Requisiti del file ZIP:

• Nessun 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.
• Le dimensioni totali del file ZIP non devono superare i 200 MB.

Formato AchievementsMetadata.csv

Il file AchievementsMetadata.csv contiene i metadati di ogni obiettivo. Deve includere le informazioni come valori separati da virgola nell'ordine seguente:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Questi campi sono descritti nella tabella seguente:

Requisiti dei file AchievementsMetadata.csv:

• Ogni riga deve avere sette valori. Se vuoi omettere un valore, lascialo vuoto.
• I campi Name e Description vengono utilizzati come impostazioni internazionali predefinite.
• Il campo Name deve essere univoco per tutti i traguardi.
• I seguenti campi non devono contenere virgole: Name e Description.

Un file AchievementsMetadata.csv di esempio:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

Formato AchievementsLocalizations.csv

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 nell'ordine seguente:

   Name, Localized name, Localized description, locale

Questi campi sono descritti nella tabella seguente:

Requisiti dei 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 chiamato "Obiettivo1" per en-US può essere chiamato anche "Obiettivo1" per fr-FR.
• Ogni riga deve avere quattro valori. Se vuoi omettere il valore Descrizione localized, lascialo vuoto.

Un 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 mappare i tuoi obiettivi con l'icona specificata. Deve includere le informazioni come valori separati da virgola nell'ordine seguente:

Name, icon filename

Questi campi sono descritti nella tabella seguente:

Requisiti dei file AchievementsIconMappings.csv:

• Ogni riga deve avere due valori.
• I file di icone possono essere solo in formato PNG o JPEG.

Un 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 di icone

Le icone a cui fai riferimento nel file AchievementsIconMappings.csv devono esistere nell'archivio zip corrente che importi. Per ulteriori informazioni, consulta Linee guida per le icone.

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.

Esistono due modi per aggiungere le traduzioni per il tuo gioco:

• Puoi utilizzare l'opzione Importa obiettivi per caricare contemporaneamente le traduzioni di molti nuovi obiettivi. Non puoi utilizzare questa opzione per caricare le traduzioni di obiettivi già esistenti.

• Puoi aggiungere le traduzioni per ogni obiettivo del tuo gioco. Per aggiungere la tua traduzione per ogni obiettivo:

  1. In Google Play Console, apri la scheda Obiettivi per il tuo gioco, quindi seleziona un obiettivo esistente.
  2. Nella pagina dei dettagli dei traguardi, seleziona la scheda di una lingua che hai aggiunto in precedenza nella scheda Dettagli del gioco.
  3. Nella pagina dei dettagli del traguardo per la lingua in questione, modifica il modulo con le tue traduzioni per il traguardo.
  4. 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:

• Android
• Unity
• Web
• Best practice per l'implementazione dei traguardi