Rilevare e consegnare articoli una tantum

Questo documento descrive come rilevare e distribuire prodotti a pagamento singolo nel tuo gioco dopo che i giocatori li hanno acquistati con Play Points nell'app Google Play.

Una volta che gli utenti riscattano i punti Play per un prodotto a pagamento singolo nell'app Google Play, gli articoli devono essere consegnati immediatamente nel tuo gioco. Di seguito viene mostrato come un utente acquista articoli con i punti Play.

1. Fai clic su Play Points.	2. Fai clic sulla scheda Usa per visualizzare gli elementi.	3. Seleziona un articolo e fai clic su Usa punti per completare l'acquisto.	4. Ricevi l'articolo.

Nell'esempio, il gioco non è in esecuzione mentre il prodotto viene acquistato. Gli utenti possono anche scambiare punti Play con prodotti quando il gioco non è installato sul loro dispositivo. Per questo motivo, devi progettare il gioco in modo che gestisca la consegna degli articoli in-app al di fuori dello store in-game.

Prima di iniziare

Prima di rilevare e distribuire un prodotto a pagamento singolo, devi creare il prodotto e le promozioni Play Points.

Requisiti di pubblicazione

Quando distribuisci prodotti a pagamento singolo nel tuo gioco utilizzando una promozione Play Points, devi rispettare i requisiti di questa sezione.

Tempi di consegna

Quando un giocatore scambia punti Play con un prodotto a pagamento singolo, utilizza la Libreria Fatturazione Google Play per consegnare l'articolo in modo tempestivo.

Messaggio di consegna

Quando un utente torna al tuo gioco dopo aver acquistato un prodotto a pagamento singolo al di fuori del gioco, devi mostrare una conferma che il prodotto è stato concesso correttamente all'interno del gioco. Il messaggio deve essere visualizzato sotto forma di finestra di dialogo o di messaggio in-game. Gli utenti non devono eseguire ulteriori passaggi per ricevere l'articolo.

Ecco il formato del messaggio richiesto:

• Un messaggio chiaro che indica che l'articolo è stato ricevuto.

• Fai riferimento chiaramente al nome dell'articolo e a "Punti Play" per consentire agli utenti di distinguerlo da altri contenuti che ricevono.

• Il nome dell'articolo deve includere anche la denominazione corretta se sono presenti articoli simili con più denominazioni.

• La finestra di dialogo, il messaggio o la notifica in-game devono essere visibili all'utente finché non fa clic su una conferma, ad esempio Continua o Ok. Non deve essere presente un pulsante Annulla, in quanto questo messaggio ha solo lo scopo di notificare agli utenti l'articolo che hanno ricevuto in-game. Se non è presente un pulsante di conferma, il messaggio deve essere visibile agli utenti per almeno 3 secondi prima di scomparire per assicurarsi che sappiano di aver ricevuto l'articolo.

Ecco un esempio di messaggio:

"Articolo ricevuto. Hai appena ricevuto 100 Gemme con Play Points. Continua."

Gli utenti dovrebbero vedere un'animazione o una conferma visiva che mostri l'aumento del saldo della valuta in-game. Se l'articolo è un articolo in-app durevole o di consumo, gli utenti devono essere indirizzati alla posizione in cui l'articolo è stato sbloccato o è disponibile all'interno del gioco.

Rilevare gli articoli ricevuti al di fuori del gioco

Se il tuo gioco utilizza il sistema di fatturazione di Google Play, consulta Rilevare ed elaborare gli acquisti per rilevare i prodotti a pagamento singolo ricevuti al di fuori del gioco.

Visualizzare una conferma di consegna

Quando gli utenti utilizzano i punti Play e ricevono un articolo di scambio, si aspettano che il gioco mostri un messaggio in-game o utilizzi un tipo di notifica per informarli che l'articolo è stato ricevuto ed elaborato correttamente. Consulta Notifica all'utente per confermare l'acquisto.

Aggiornamenti per motori di gioco specifici

Ecco alcune considerazioni da fare per motori di gioco specifici:

• Se il tuo gioco è stato creato con Unity, ti consigliamo di verificare se l'implementazione degli acquisti in-app che utilizzi supporta già le promozioni Play Points.

• Se il tuo gioco è creato con Cocos2d-x o Unreal Engine (C/C++), molto probabilmente dovrai scrivere il codice JNI che chiama le API Java dal tuo codice C/C++.

Best practice lato server

Questa sezione contiene le best practice lato server da utilizzare per le promozioni Play Points:

• Se chiami Purchases.products: get sul tuo server, verifica se devi gestire separatamente gli articoli di scambio delle ricompense di Play e altri prodotti una tantum in base ai valori di productId.

• Se utilizzi Onetimeproducts: list sul tuo server, verifica se devi separare gli articoli di scambio di premi Play da altri prodotti a pagamento singolo in base ai valori productId.

• Esamina le seguenti best practice per verificare se devi apportare ulteriori modifiche:

  • Riferimento:
    • Combattere frodi e abusi
    • Best practice per gli identificatori univoci
  • Implementa la verifica della firma lato server.
  • Assicurati che i valori di purchaseToken e orderId siano univoci e non siano stati utilizzati in precedenza.

Risoluzione dei problemi

Questa sezione contiene consigli per scenari che possono comportare richieste dei clienti.

Più account utente

Se un utente ha più Account Google sul proprio dispositivo e riscatta Play Points sull'account sbagliato, Google non può trasferire gli articoli agli altri account. Allo stesso modo, la tua app non può trasferire l'elemento chiamando il metodo getPurchases(). In questo scenario, valuta la possibilità di fornire manualmente gli articoli in-app all'utente utilizzando le operazioni di assistenza clienti.

Articoli in ritardo o mancanti

Se i giocatori riscontrano ritardi o problemi con gli articoli premio, consulta la guida alla risoluzione dei problemi relativi agli acquisti in-app nella documentazione del Centro assistenza Google Play.