Creare un prodotto gestito

Il servizio di fatturazione di Google Play ti permette di offrire prodotti in-app che addebitano i costi ai clienti una tantum, noti come prodotti gestiti. I prodotti gestiti possono includere elementi come beni virtuali (ad esempio: livelli di gioco o pozioni) e servizi premium all'interno dell'app su Google Play.

• Puoi anche creare un prodotto gestito che addebiti i costi agli utenti periodicamente.

Importante: le Norme del programma per sviluppatori Google Play e le commissioni sulle transazioni si applicano sia agli abbonamenti sia ai prodotti gestiti in-app.

Disponibilità

Se ti trovi in una località supportata per la registrazione come commerciante, puoi utilizzare il servizio di fatturazione di Google Play.

Se ti trovi in una località supportata e vuoi iniziare a utilizzare le funzioni di fatturazione di Google Play nelle tue app, imposta un profilo pagamenti ed esamina la documentazione dell'API Fatturazione Google Play.

Dopo aver creato un prodotto gestito, tale prodotto è disponibile per gli utenti che utilizzano la versione più recente del Google Play Store.

Autorizzazioni richieste

Per poter offrire un prodotto gestito, devi dichiarare l'autorizzazione com.android.vending.BILLING nel tuo file manifest dell'APK dell'app. Se distribuisci la tua app a livello internazionale, puoi continuare a pubblicare app che utilizzano l'autorizzazione com.android.vending.BILLING in tutti i paesi.

Creare prodotti gestiti

Creare un singolo prodotto gestito

Prima di creare un prodotto gestito, pianifica con attenzione gli ID prodotto. Questi devono essere univoci nella tua app e, una volta creati, non possono essere modificati o riutilizzati.

• Gli ID prodotto devono iniziare con una lettera minuscola o un numero e possono contenere solo lettere minuscole (a-z), numeri (0-9), trattini bassi (_) e punti (.)
• Nota: l'ID prodotto android.test non può essere utilizzato, come qualunque ID prodotto che inizi con android.test.

Per creare un prodotto gestito:

1. Accedi a Play Console.
2. Seleziona l'app.
3. Nel menu a sinistra fai clic su Presenza nello Store > Prodotti in-app > Prodotti gestiti.
4. Fai clic su Crea prodotto gestito.
5. Inserisci i dati del prodotto.
   • Titolo: breve nome dell'elemento (fino a 55 caratteri, ma è consigliabile che ogni titolo contenga un massimo di 25 caratteri, in modo da poter essere visualizzato correttamente in tutti i contesti), ad esempio "Pozione sonnifera".
   • Descrizione: descrizione dettagliata dell'elemento (fino a 80 caratteri), come "Addormenta all'istante qualsiasi creatura".
   • Prezzo: inserisci un prezzo nella valuta locale, oppure seleziona un modello di prezzi.
6. Accanto a "Stato", scegli Attivo o Non attivo.
   • Per essere acquistabile, un prodotto deve essere attivo e la relativa app deve essere pubblicata.
   • Se utilizzi un account di prova, gli elementi attivi sono disponibili nelle app non pubblicate. Per ulteriori informazioni, visita il sito degli sviluppatori Android.
7. Fai clic su Salva.

Lingue e traduzioni

I prodotti gestiti utilizzano la lingua predefinita della loro app. Per aggiungere le traduzioni in lingue specifiche, seleziona un prodotto gestito, quindi fai clic su Aggiungi traduzioni. Ulteriori informazioni sulla traduzione della tua app.

Creare un gruppo di più prodotti gestiti

Per creare più prodotti gestiti contemporaneamente, puoi caricare un file CSV che contenga i dettagli di ognuno dei tuoi prodotti.

I file CSV utilizzano le virgole (,) e il punto e virgola (;) per separare i valori dei dati. Le virgole separano i valori dei dati primari e i punti e virgola separano i valori secondari.

Quando crei un file CSV di prodotti gestiti, specifica la sintassi CSV nella prima riga, seguita dai dettagli del prodotto nelle righe successive.

Importante: all'interno del file CSV ogni elemento deve occupare una singola riga.

Caricare un file CSV di prodotti gestiti

1. Accedi a Play Console.
2. Seleziona l'app.
3. Nel menu a sinistra fai clic su Presenza nello Store > Prodotti in-app > Prodotti gestiti.
4. Fai clic su Importa/Esporta > Importa prodotti gestiti da file CSV.
   • Per sovrascrivere i prodotti gestiti esistenti nell'elenco dei prodotti, seleziona la casella di controllo Sovrascrivi i prodotti esistenti. I prodotti esistenti vengono sovrascritti solo se il valore Product ID nel file CSV corrisponde al Product ID di un prodotto gestito esistente nell'elenco dei prodotti. La sovrascrittura di un prodotto non elimina i prodotti gestiti che non sono contenuti nel CSV.
5. Fai clic su Sfoglia file, quindi seleziona il tuo file CSV.

Esportare un file CSV di prodotti gestiti esistenti

Se hai creato dei prodotti gestiti uno per volta in Play Console, esportare un file CSV può essere un ottimo modo per iniziare a crearne di nuovi.

1. Accedi a Play Console.
2. Seleziona l'app.
3. Nel menu a sinistra fai clic su Presenza nello Store > Prodotti in-app > Prodotti gestiti.
4. Fai clic su Importa/Esporta > Esporta prodotti in-app in file CSV.

Vedere un esempio di file CSV

Di seguito sono riportati un esempio della sintassi CSV da utilizzare e tre esempi di prodotti gestiti:

• Il primo esempio fornisce un titolo e una descrizione in due lingue diverse (en_US e it_IT). Un modello di prezzi definisce il prezzo dell'articolo.
• Il secondo esempio non utilizza un modello di prezzi, ma specifica un prezzo per il paese predefinito (Stati Uniti). Play Console utilizza tassi di cambio correnti e modelli di prezzi pertinenti a livello locale per impostare automaticamente i prezzi in tutti i paesi in cui viene distribuita l'app.
• Neanche il terzo esempio utilizza un modello di prezzi. Il prezzo dell'elemento viene specificato manualmente per ogni paese in cui viene distribuita l'app.

Esempio di sintassi CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Esempi di prodotti gestiti

Esempio 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

Esempio 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

Esempio 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Valori dei dati per file CSV 

Ogni riga di un file CSV di prodotti gestiti può contenere i seguenti valori, ma almeno uno di questi valori è assente in ogni riga:  

Product ID	L'impostazione di questo valore nel file CSV equivale a inserire un ID prodotto quando crei un nuovo prodotto gestito. Se specifichi un Product ID assegnato a un prodotto gestito che esiste già nell'elenco di un prodotto e hai già selezionato la casella di controllo Sovrascrivi i prodotti esistenti nella finestra di dialogo "Importa prodotti in-app", i dati del prodotto gestito esistente vengono sovrascritti con i valori specificati nel file CSV.
Publish State	Questo valore deve essere impostato su published o unpublished. Questo equivale a impostare un prodotto gestito su Attivo o Non attivo.
Purchase Type	Questo valore deve essere impostato su managed_by_android.
Auto Translate	Questo valore deve essere impostato su false perché la traduzione automatica non è supportata per i prodotti gestiti. Se vuoi fornire le traduzioni del titolo e della descrizione di un prodotto gestito, specifica in modo esplicito queste traduzioni nel valore Locale.
Locale, Title e Description	Se per un elemento includi solo un'impostazione internazionale, devi specificare quella predefinita per la tua app, così come il titolo e la descrizione predefiniti dell'elemento: app_default_locale; item_default_title; item_default_description; Quando imposti il valore Locale, puoi utilizzare uno dei codici lingua che vengono visualizzati quando aggiungi le traduzioni della scheda dello store. Nota: quando specifichi i valori Title e Description, utilizza le barre rovesciate per dare un'interpretazione letterale ai caratteri punto e virgola (\;) e barra rovesciata (\\). Se vuoi inserire versioni tradotte del titolo e della descrizione dell'elemento, devi specificare le impostazioni internazionali, la descrizione e il titolo predefiniti, seguiti dalle impostazioni internazionali, la descrizione e il titolo per ogni traduzione. Nell'esempio riportato di seguito, il prodotto gestito utilizza en_US (inglese, Stati Uniti) come lingua predefinita e es_ES (spagnolo, Spagna) come traduzione. en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible. Nota: un'app ha una sola lingua predefinita, ma ogni prodotto gestito mantiene il proprio elenco di traduzioni. Anche se la prima lingua nel valore Locale di ogni elemento deve essere la stessa in tutto il file CSV, quelle che seguono possono differire da un elemento all'altro.
Auto Fill Prices, Country, e Price	Puoi impostare Auto Fill Prices su true o false. Se un prodotto gestito utilizza un modello di prezzi, dovresti impostare Auto Fill Prices su false e non impostare nessun valore per Price. Nota: quando specifichi il prezzo di un elemento nel file CSV, fornisci un prezzo in micro-unità, dove 1.000.000 micro-unità corrispondono a una unità della valuta reale. Utilizzare la compilazione automatica dei prezzi Le seguenti sezioni descrivono in che modo il valore Auto Fill Prices incide sulla sintassi e sul significato dei valori Country e Price. Se imposti Auto Fill Prices su true, specifichi solo il prezzo predefinito dell'elemento e non il valore Country. Ad esempio, date le seguenti condizioni: La lingua predefinita della tua app è en_US. Il prezzo non comprensivo di IVA predefinito di un prodotto gestito è $ 1,99. Vuoi che i prezzi per gli altri paesi vengano compilati automaticamente. Dovresti impostare i valori di Auto Fill Prices e Price alla fine di una riga del file CSV come segue: true, 1990000, Impostare il tuo prezzo per ogni paese   Se imposti Auto Fill Prices su false, puoi specificare una serie di valori di Country e Price per tutti i paesi in cui distribuisci la tua app, tra cui il paese corrispondente alla lingua predefinita dell'app. Ogni valore Country corrisponde al codice paese ISO di due lettere maiuscole che indica il paese in cui viene distribuita l'app. Nota: devi fornire un codice paese e un prezzo per ogni paese in cui vuoi distribuire la tua app. Per visualizzare e modificare l'elenco di questi paesi, apri la pagina dell'app Prezzi e distribuzione. Ogni valore Price definisce il costo dell'elemento in micro-unità della valuta utilizzata in quel paese. Ad esempio, se offri l'app ai seguenti prezzi (tutti comprensivi di tasse) in altri paesi: R$ 6,99 in Brasile  ₽ 129 in Russia ₹130 in India Rp 27.000 in Indonesia $ 37 in Mexico puoi impostare i valori di Auto Fill Prices, Country e Price alla fine di una riga nel file CSV come segue: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Se un elemento è collegato a un modello di prezzi, devi impostare Auto Fill Prices su false e non impostare un valore per la colonna Price. Se l'elemento non è collegato a un modello di prezzi, non devi impostare un valore per il Pricing Template ID. Devi invece impostare Auto Fill Prices, Country e Price in base a come vuoi impostare i prezzi del prodotto gestito. Se importi un file CSV e hai selezionato la casella di controllo Sovrascrivi i prodotti esistenti nella finestra di dialogo "Importa prodotti in-app", puoi aggiornare i collegamenti tra i prodotti gestiti e i modelli di prezzo. Per collegare il prodotto a un determinato modello di prezzi, imposta il valore Pricing Template ID sull'ID di quel modello di prezzi. Per scollegare un prodotto gestito da tutti i modelli di prezzo, non impostare alcun valore per il suo Pricing Template ID. Puoi collegare fino a 1000 prezzi delle app o dei prodotti gestiti a un determinato modello di prezzi Inoltre, non specificare lo stesso valore Pricing Template ID in più di 1000 righe di un file CSV.