Eventi

Il servizio eventi Google Play Giochi ti consente di raccogliere dati cumulativi generati dai tuoi giocatori durante il gameplay e di archiviarli nei server di Google per l'analisi dei giochi. Puoi definire in modo flessibile i dati del giocatore che il gioco deve raccogliere; ciò potrebbe includere metriche quali la frequenza:

  • I giocatori utilizzano un particolare articolo
  • I giocatori raggiungono un determinato livello
  • I giocatori eseguono azioni di gioco specifiche

Puoi utilizzare i dati degli eventi come feedback per migliorare il gioco. Ad esempio, puoi regolare il livello di difficoltà di alcuni livelli del gioco che i giocatori hanno difficoltà a completare.

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

Integrazione di eventi nel gioco

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

  1. Definire gli eventi. Per definire nuovi eventi da acquisire nel tuo 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à evento.
    3. Pubblica le definizioni degli eventi seguendo la procedura descritta nella sezione Pubblicare le modifiche del gioco.

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

  3. Visualizzare i dati sugli eventi. Visita la 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 offrono un modo per definire e raccogliere metriche di gameplay interessanti e caricarle sui servizi per i giochi di Google Play.

Un evento dei servizi per i giochi di Google Play contiene queste proprietà principali:

Proprietà Descrizione
ID Una stringa univoca generata da Google Play Console per questo evento. Utilizza 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 viene utilizzato da Google Play Console e può essere visualizzato nel tuo gioco.

Esempi:

  • "Zombie uccisi"
  • "Gemme rosse raccolte"
Description (Descrizione) Una descrizione più lunga dell'evento (ad esempio, "Numero di volte in cui un giocatore ha ucciso uno zombi" o "Il numero totale di gemme rosse che il giocatore ha eliminato e trovato"). La descrizione può contenere fino a 500 caratteri. Questo valore viene utilizzato da Google Play Console e può essere visualizzato 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 Analytics per i giocatori.

Sono supportati due tipi di eventi:

Origine valuta premium
Seleziona questo tipo per gli eventi che monitorano le origini di una valuta premium. Ad esempio:
  • "monete d'oro guadagnate"
  • "Smeraldi acquistati"
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 al tuo evento.

Creazione di 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, lo stato dell'evento è "Pronto per la pubblicazione". Ora puoi procedere alla pubblicazione delle modifiche al gioco.

Modifica di un evento

Per modificare un evento che hai creato:

  1. In Google Play Console, apri la scheda Eventi e seleziona la voce per l'evento da modificare. Dovresti vedere lo stesso modulo utilizzato durante la creazione dell'evento.
  2. Apporta le modifiche.
  3. Al termine della modifica dell'evento, fai clic sul pulsante Salva.
  4. Testa il tuo gioco per verificare l'evento modificato. Se funziona correttamente, ripubblica le modifiche al gioco.

Eliminazione di 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.

Reimpostare i dati dell'evento

Puoi reimpostare i dati sui progressi dei giocatori per i tester dei tuoi eventi.

  • Per reimpostare le bozze di eventi in Google Play Console, fai clic sul pulsante Reimposta lo stato di avanzamento degli eventi nella parte inferiore del modulo.
  • Per reimpostare i dati sugli eventi in modo programmatico, chiama i metodi dell'API di gestione Events.

Implementazioni client

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