Integrare gli obiettivi

Creare un obiettivo

Per creare un obiettivo per un gioco nuovo e non pubblicato, completa questi passaggi:

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), seleziona Crea obiettivo.
3. Nella pagina Aggiungi obiettivi, compila il modulo.
4. Fai clic su Salva come bozza.
5. Dopo aver creato un obiettivo, devi pubblicarlo.

Importa obiettivi

Per aggiungere più obiettivi contemporaneamente al tuo gioco, segui questi passaggi:

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), seleziona 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.

Linee guida per i file ZIP

Puoi importare più obiettivi contemporaneamente utilizzando un file ZIP. Fai riferimento alla tabella per i nomi file esatti da utilizzare nel file ZIP:

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:

Requisiti del 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 gli obiettivi.
• I seguenti campi non devono contenere virgole: Name e Description.

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:

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

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

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][a] 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.

File delle icone

Le icone a cui fai riferimento nel file AchievementsIconMappings.csv devono essere incluse nel file ZIP corrente che importi.

Modificare gli obiettivi

Se hai già degli obiettivi e vuoi modificarli:

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), seleziona un obiettivo.
3. Puoi modificare uno qualsiasi dei campi.
4. Fai clic su Salva come bozza.
5. Nella pagina Servizi per i giochi di Play - Obiettivi, l'obiettivo modificato ha lo stato "Disponibile per i tester".
6. Dopo aver testato l'obiettivo, fai clic su Rivedi e pubblica.

   il gioco verrà ripubblicato insieme a tutti gli obiettivi aggiornati.

Elimina un obiettivo

Una volta pubblicato, l'obiettivo non può essere eliminato. Puoi eliminare un obiettivo solo se si trova in stato di prepubblicazione

1. Nella pagina Servizi per i giochi di Play - Obiettivi, seleziona un obiettivo.
2. Per eliminare l'obiettivo, fai clic su Elimina obiettivo.

Reimposta un obiettivo

Puoi reimpostare i dati relativi ai progressi dei giocatori solo per gli obiettivi nello stato "Bozza".

1. Nella pagina Servizi per i giochi di Play - Obiettivi, seleziona un obiettivo.
2. Per reimpostare gli obiettivi, fai clic su Reimposta progressi.
3. Per reimpostare i dati degli obiettivi in modo programmatico, chiama i metodi dell'API di gestione Achievements.