Eventi

Il servizio di eventi di Google Play Giochi ti consente di raccogliere dati cumulativi generati dai giocatori durante il gameplay e di memorizzarli nei server di Google per l'analisi del gioco. Puoi definire in modo flessibile i dati sui giocatori che il tuo gioco deve raccogliere, ad esempio metriche quali la frequenza:

  • I giocatori usano un oggetto particolare
  • I giocatori raggiungono un determinato livello
  • I giocatori eseguono azioni di gioco specifiche

Puoi usare i dati sugli eventi come feedback su come migliorare il tuo gioco. Ad esempio, puoi regolare il livello di difficoltà di alcuni livelli del gioco che i giocatori trovano troppo difficile da completare.

Per informazioni su come implementare gli eventi per la tua piattaforma, consulta Implementazioni dei client.

Integrazione di eventi nel gioco

Il seguente flusso di lavoro descrive come applicare eventi nel tuo gioco:

  1. Definisci gli eventi. Per definire nuovi eventi da acquisire nel gioco:
    1. Vai alla pagina Eventi del tuo gioco in Google Play Console.
    2. Fai clic sul pulsante Aggiungi nuovo evento e configura le proprietà dell'evento.
    3. Pubblica le definizioni degli eventi seguendo i passaggi descritti nella sezione Pubblicare le modifiche al gioco.

  2. Implementa l'acquisizione di eventi nel tuo gioco utilizzando le API Eventi. Ad esempio, nel codice Android, chiama il metodo increment degli eventi ogni volta che il gioco rileva che è stato attivato un evento di suo interesse.

  3. Visualizzare i dati degli eventi. Vai alla pagina Eventi del tuo gioco in Google Play Console per visualizzare le statistiche relative agli eventi acquisiti.

Nozioni di base sugli eventi

Le API Eventi ti consentono di definire e raccogliere metriche di gameplay interessanti e di caricarle nell'SDK di Play Giochi.

Un evento dell'SDK Play Giochi contiene le seguenti proprietà chiave:

Proprietà Descrizione
ID Una stringa univoca generata da Google Play Console per questo evento. Usa questo ID univoco per fare riferimento all'evento nei tuoi client di gioco.
funzionalità Un nome breve dell'evento. Il nome può contenere fino a 100 caratteri. Questo valore è utilizzato da Google Play Console e può essere visualizzato nel tuo gioco.

Esempi:

  • "Gli zombie uccisi"
  • "Gemme rosse raccolte"
Descrizione Una descrizione più lunga dell'evento (ad esempio, "Numero di volte che un giocatore ha ucciso uno zombi" o "Il numero totale di gemme rosse che il giocatore ha eliminato e abbinato"). La descrizione può contenere fino a 500 caratteri. Questo valore viene utilizzato da Google Play Console e può essere mostrato nel tuo gioco.
Tipo di evento

Un campo che dichiara il tipo di dati monitorati dall'evento. Questo valore viene utilizzato da Google Play Console per supportare i report di analisi dei giocatori.

Sono supportati due tipi di eventi:

Origine valuta premium
Seleziona questo tipo per gli eventi che monitorano le sorgenti di una valuta premium. Ad esempio:
  • "monete d'oro guadagnate"
  • "Smeraldi comprati"
Sink di valuta premium
Seleziona questo tipo per gli eventi che monitorano i sink, o il consumo, di una valuta premium. Ad esempio:
  • "Monete d'oro spese"
  • "Smeraldi usati"
Icona Un'icona quadrata che verrà associata all'evento.

Creare un evento

Per creare un nuovo evento per il tuo gioco:

  1. Aggiungi il tuo gioco in Google Play Console, se non l'hai ancora fatto.
  2. In Google Play Console, fai clic sull'icona Servizi di giochi a sinistra e seleziona la voce relativa al tuo gioco.
  3. Seleziona la scheda Eventi a sinistra e fai clic sul pulsante Aggiungi evento.
  4. Inserisci i dettagli dell'evento che vuoi creare.
  5. Fai clic su Salva. Se non sono presenti errori, l'evento si trova nello stato "Pronto per la pubblicazione". Ora puoi procedere con la pubblicazione delle modifiche al gioco.

Modifica un evento

Per modificare un evento creato da te:

  1. In Google Play Console, apri la scheda Eventi e seleziona la voce relativa all'evento da modificare. Dovresti vedere lo stesso modulo che hai utilizzato durante la creazione dell'evento.
  2. Apporta le modifiche.
  3. Quando hai finito di modificare l'evento, fai clic sul pulsante Salva.
  4. Testa il gioco per verificare l'evento modificato. Se funziona correttamente, ripubblica le modifiche apportate al gioco.

Elimina un evento

Puoi eliminare gli eventi in stato di bozza o che sono stati pubblicati. Per eliminare un evento in Google Play Console, fai clic sul pulsante Elimina nella parte inferiore del modulo relativo all'evento in questione.

Reimposta dati sugli eventi

Puoi reimpostare i dati di avanzamento dei giocatori per i tester dei tuoi eventi.

  • Per reimpostare gli eventi in bozza in Google Play Console, fai clic sul pulsante Reimposta l'avanzamento dell'evento nella parte inferiore del modulo per l'evento in questione.
  • Per reimpostare i dati sugli eventi in modo programmatico, chiama i metodi Events dell'API di gestione.

Implementazioni client

Per scoprire come implementare gli eventi per la tua piattaforma, consulta le seguenti risorse: