Creare un prodotto in-app

Il sistema di fatturazione di Google Play ti consente di offrire prodotti in-app i cui costi vengono addebitati agli utenti una sola volta. I prodotti in-app possono includere elementi come beni virtuali (ad esempio, livelli di giochi o pozioni) e servizi premium all'interno della tua app su Google Play.

Puoi anche creare un abbonamento che addebiti i costi agli utenti periodicamente.

Importante: le Norme del programma per gli sviluppatori e le commissioni di servizio di Google Play si applicano ai prodotti in-app e agli abbonamenti.

Disponibilità

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

Se ti trovi in una località supportata e vuoi iniziare a utilizzare le funzionalità del sistema di fatturazione di Google Play nelle tue app, configura un profilo pagamenti e scopri di più sulla configurazione del sistema di fatturazione di Google Play sul sito Android for Developers.

Per essere acquistabile, un prodotto in-app deve essere attivo e la relativa app deve avere come target il paese o la regione dell'utente. Un prodotto in-app sarà disponibile per l'acquisto finché sarà attivo, anche se la relativa app è non pubblicata. Devi disattivare un prodotto in-app se non vuoi che sia disponibile.

Se utilizzi un account di prova, visita il sito Android for Developers per scoprire di più sui test dell'integrazione di Libreria Fatturazione Google Play.

Dopo la sua creazione, il prodotto in-app è disponibile per gli utenti che utilizzano l'ultima versione del Google Play Store.

Nota: questa disponibilità in Play Console potrebbe rendere lo SKU disponibile per l'acquisto diretto dalla home page di Giochi nel Play Store, anziché all'interno della tua app, nell'ambito della funzionalità di promemoria di abbandono del carrello, che spinge gli utenti a completare gli acquisti abbandonati in precedenza. Scopri di più sugli acquisti effettuati al di fuori della tua app qui. Questa funzionalità è attiva per impostazione predefinita per tutti gli sviluppatori.

Per disattivare il promemoria di abbandono del carrello nella tua app, invia questo modulo.

Autorizzazioni richieste

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

Creare prodotti in-app

Creare un singolo prodotto in-app

Prima di creare un prodotto, pianifica con attenzione i relativi ID. Gli ID prodotto devono essere univoci per la tua app e, una volta creati, non possono essere modificati o riutilizzati.

• Gli ID prodotto devono iniziare con un numero o una lettera minuscola e possono contenere numeri (0-9), lettere minuscole (a-z), trattini bassi (_) e punti (.).
• Non puoi modificare o utilizzare nuovamente un ID prodotto dopo aver creato il prodotto.
• Nota: l'ID prodotto android.test non può essere utilizzato, così come qualunque ID prodotto che inizi con android.test.

Per creare un prodotto in-app, svolgi i seguenti passaggi:

1. Apri Play Console.
2. Vai alla pagina Prodotti in-app (Monetizza con Google Play > Prodotti > Prodotti in-app).
3. Fai clic su Crea prodotto.
4. Inserisci i dettagli del prodotto.
   • ID prodotto: un ID univoco del tuo prodotto in-app.
   • Titolo: nome breve 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 lunga dell'elemento (fino a 200 caratteri), come "Fa addormentare all'istante qualsiasi creatura".
   • Icona: un'immagine unica e precisa per il prodotto. Non includere testo, promozioni o branding. L'icona del prodotto viene mostrata nella scheda dello Store e durante il flusso di acquisto.
     • PNG a 32 bit
     • 512 x 512 pixel
     • Fino a 1 MB
   • Prezzo: inserisci un prezzo nella valuta locale oppure seleziona un modello di prezzi.
   • Più quantità: consenti il pagamento di più quantità per questo prodotto. Gli utenti potranno effettuare acquisti di più quantità rispettando la soglia del paese o della regione. Prendi nota di quanto segue:
     • Per configurare il pagamento di più quantità in Play Console, la tua app deve avere l'API Libreria Fatturazione Google Play 4.0. Visita il sito Android for Developers per scoprire come integrare l'API Libreria Fatturazione Google Play nella tua app.
     • Il pagamento di più quantità non è disponibile in alcuni paesi o regioni.
     • Nella maggior parte dei paesi o delle regioni in cui è disponibile il pagamento di più quantità, la soglia di prezzo SKU è pari a circa 100 $. Per consentire il pagamento di più quantità, devi modificare il prezzo (al netto delle imposte) in modo che sia inferiore alla soglia in ogni paese o regione.
   • Esclusivo di Play Points: rendi il tuo prodotto disponibile solo in Google Play Points.
5. Salva le modifiche e fai clic su Attiva per rendere il prodotto in-app disponibile per gli utenti.

Lingue e traduzioni

Per i prodotti in-app viene usata la lingua predefinita della relativa app. Per aggiungere le traduzioni in lingue specifiche, seleziona un prodotto in-app, quindi fai clic su Gestisci traduzioni e applica le lingue che vuoi. Per scoprire di più su come offrire un'esperienza localizzata agli utenti, consulta l'articolo Tradurre e localizzare le app.

Creare un gruppo di più prodotti in-app

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

I file CSV utilizzano la virgola (,) 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 in-app, 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 in-app

Per caricare un file CSV, svolgi i seguenti passaggi:

1. Apri Play Console.
2. Vai alla pagina Prodotti in-app (Monetizza con Google Play > Prodotti > Prodotti in-app).
3. Fai clic su Importa.
   • L'importazione di più prodotti tramite caricamento di un file CSV sovrascrive i prodotti esistenti solo se il valore Product ID nel file CSV corrisponde al Product ID di un prodotto in-app esistente nell'elenco dei prodotti. La sovrascrittura di un prodotto non elimina i prodotti in-app che non sono inclusi nel CSV.
4. Trascina il file CSV da caricare o fai clic su Carica.

Esportare un file CSV di prodotti in-app esistenti

Per esportare un file CSV, svolgi i seguenti passaggi:

1. Apri Play Console.
2. Vai alla pagina Prodotti in-app (Monetizza con Google Play > Prodotti > Prodotti in-app).
3. Fai clic su Esporta.

Vedere un esempio di file CSV

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

• Il primo esempio fornisce un titolo e una descrizione in due lingue diverse (en_US e es_ES). 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 in-app

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 in-app può contenere i seguenti valori, ma almeno uno è 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 in-app. Se specifichi un ID prodotto assegnato a un prodotto in-app già presente in un elenco di prodotti, i dati del prodotto in-app esistente vengono sovrascritti con i valori specificati nel file CSV.
Publish State	Questo valore deve essere impostato su published o unpublished. Equivale a impostare un prodotto in-app come 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 dei dettagli dei prodotti in-app non è supportata. Se vuoi fornire le traduzioni del titolo e della descrizione di un prodotto in-app, specifica queste traduzioni in modo esplicito all'interno del 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 da impostazioni internazionali, descrizione e titolo per ogni traduzione. Nell'esempio riportato di seguito, il prodotto in-app utilizza en_US (inglese, Stati Uniti) come impostazioni internazionali predefinite ed 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 in-app 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 in-app utilizza un modello di prezzi, dovresti impostare Auto Fill Prices su false e non impostare alcun valore per Price. Nota: quando specifichi il prezzo di un elemento in un file CSV, fornisci un prezzo in micro-unità, dove 1.000.000 di micro-unità corrispondono a 1 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 in-app è 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, usa la scheda Paesi/regioni nella pagina Produzione. 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: 6,99 R$ in Brasile 129 ₽ in Russia 130 ₹ in India 27.000 Rp in Indonesia 37 $ in Messico 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 Pricing Template ID. Devi invece impostare Auto Fill Prices, Country e Price in base a come vuoi impostare i prezzi del prodotto in-app. Se importi un file CSV, puoi aggiornare i collegamenti tra prodotti in-app e i modelli di prezzo. Per collegare il prodotto a un determinato modello di prezzo, imposta il valore Pricing Template ID sull'ID di quel modello. Per scollegare un prodotto in-app 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 in-app a un determinato modello di prezzo. Inoltre, non specificare lo stesso valore Pricing Template ID in più di 1000 righe di un file CSV.
EEA Withdrawal Right Type	Se esegui la distribuzione agli utenti nello Spazio economico europeo (SEE), devi impostare il valore qui per DIGITAL_CONTENT o SERVICE.
Reduced VAT Rates	Se vendi audiolibri, audio, musica, video, libri, giornali, riviste o notizie digitali in diversi paesi o regioni, potresti avere diritto a usufruire di aliquote IVA ridotte. Per le aliquote ridotte, i valori in questo campo saranno nel seguente formato: CountryCode;VATRate; Devi far seguire ogni coppia di paese o tariffa da un punto e virgola prima di aggiungere una nuova coppia. Ecco alcuni esempi: CA;BOOKS_1 per impostare l'aliquota ridotta dei libri di livello 1 per il Canada. FR; NEWS_1; GR;NEWS_2 per impostare l'aliquota ridotta per le notizie di livello 1 per la Francia e di livello 2 per la Grecia. I livelli possono essere impostati come BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (in lettere maiuscole o minuscole).
Communications and amusement taxes	Se vuoi riscuotere le imposte statali sulle comunicazioni e sull'intrattenimento, devi specificare che la tua app o il tuo prodotto sono un prodotto di streaming e impostare questo campo come ELIGIBLE. In caso contrario, lascia vuoto il campo. Attualmente, l'unico paese consentito per questo tipo di imposte sono gli Stati Uniti. Il valore di questo campo è sempre impostato come segue: Codice paese;Idoneità;Imposta Ecco alcuni esempi: US;ELIGIBLE;VIDEO_RENTAL Se idoneo, puoi impostare il campo in base alle seguenti categorie: VIDEO_RENTAL per streaming video - abbonamento, noleggio o pay-per-view VIDEO_SALES per streaming video - vendite VIDEO_MULTI_CHANNEL per streaming video - multicanale AUDIO_RENTAL per streaming audio - abbonamenti o noleggio AUDIO_SALES per streaming audio - vendite AUDIO_MULTI_CHANNEL per streaming audio - multicanale