Crea azioni localizzate

Puoi localizzare le azioni per l'Assistente Google per fornire esperienze personalizzate per le diverse lingue e impostazioni internazionali impostate dagli utenti sui loro dispositivi. Inoltre, puoi limitare l'accesso alle tue Azioni in base alle regioni o alla posizione fisica dei tuoi utenti.

Prima di andare avanti, è utile conoscere alcuni termini per capire come offrire le tue azioni a utenti diversi:

• Lingua:una modalità di comunicazione concordata, parlata e scritta.
• Regione: un'area fisica definita di solito associata a un paese
• Locale: la combinazione di una lingua e un'area geografica.

Ora che conosci alcuni termini di base, ecco come puoi organizzare le tue azioni per lingue, regioni e impostazioni internazionali diverse con Actions Builder o l'SDK Actions.

Lingue e impostazioni internazionali

Le impostazioni internazionali vengono create utilizzando la lingua impostata nelle impostazioni dell'assistente e la regione impostate nelle impostazioni del dispositivo. La combinazione di questi elementi deve formare un'impostazione internazionale supportata. Ad esempio, un dispositivo impostato sulla regione BR e un dispositivo con l'assistente impostato su en-US generano un'impostazione internazionale en-BR, che non è supportata da Actions on Google.

Per impostazione predefinita, le Azioni supportano tutte le regioni (paesi). Gli utenti che hanno impostato le impostazioni internazionali dell'assistente su una di queste regioni potranno utilizzare l'Azione.

Quando un utente interagisce con l'Azione, le impostazioni internazionali dell'assistente vengono utilizzate anche per determinare quale voce di sintesi vocale (TTS) viene utilizzata per l'Azione. Questo comportamento predefinito può essere sovrascritto scegliendo una voce di sintesi vocale specifica in Sviluppo > Chiamata > Impostazioni.

Aggiungere lingue e impostazioni internazionali

Per aggiungere lingue e impostazioni internazionali all'Azione, procedi nel seguente modo:

1. Nella console di Actions, vai a > Impostazioni progetto.
2. Fai clic sulla scheda Lingue e seleziona le lingue che vuoi attivare. Usa + Aggiungi impostazioni internazionali per mostrare le impostazioni internazionali di una lingua principale.
3. Fai clic su Salva.

Modificare gli elementi

In Actions Builder, puoi cambiare la lingua della chiamata predefinita dell'Azione, dei link diretti, delle scene, degli intent e dei tipi. Per farlo, fai clic sul selettore della lingua con uno di questi oggetti selezionato.

Figura 1. Il selettore della lingua nell'interfaccia utente di Action Builder.

Scheda Localizzazione

Nella pagina Impostazioni progetto dell'Azione, la scheda Localizzazione consente di modificare impostazioni, prompt, frasi di addestramento e tipi per tutte le lingue supportate dall'Azione.

Figura 2. La scheda Localizzazione delle impostazioni progetto di un'Azione.

• Impostazioni:opzioni come il nome visualizzato e la pronuncia per ogni lingua.
• Prompt: tutti i prompt definiti nell'Azione, così come i prompt per gli intent di sistema.

  Se agli intent di sistema non vengono aggiunti prompt localizzati, viene utilizzato il prompt della lingua predefinita.

• Frasi di addestramento: un elenco degli intent dell'Azione e delle frasi di addestramento al loro interno.
• Digita sinonimi: un elenco di tipi e dei relativi sinonimi definiti.

Attenzione: i prompt, le frasi di addestramento e i sinonimi del tipo devono essere aggiunti ad altre lingue per consentire all'Azione di funzionare con le lingue selezionate. Fanno eccezione le impostazioni internazionali, in cui prompt, frasi di addestramento e sinonimi di tipo definiti nella lingua principale vengono utilizzati come predefiniti, se non diversamente specificato.

In fase di pubblicazione

La console di Actions ti consente di personalizzare le seguenti informazioni quando pubblichi il tuo progetto Actions:

• Informazioni specifiche per lingua e lingua: puoi specificare dettagli diversi relativi alle informazioni sull'azione, ad esempio nome e descrizione, a livello di lingua e di area geografica per ciascuno dei tuoi progetti.
• Targeting per località: puoi specificare le regioni in cui è disponibile l'Azione. Per impostazione predefinita, l'Azione supporta tutte le regioni, a patto che gli utenti abbiano impostato le impostazioni internazionali dell'assistente su una supportata dall'Azione.
• Personalizzazione vocale TTS: per impostazione predefinita, l'Azione utilizza automaticamente un insieme di voci TTS che corrisponde alle impostazioni internazionali dell'assistente dell'utente. Puoi ignorare questo comportamento e scegliere una voce di sintesi vocale specifica che non cambi in base alle impostazioni internazionali dell'assistente dell'utente.

Nota: eventuali modifiche alle impostazioni specifiche per le impostazioni internazionali nella console di Actions richiedono di inviare nuovamente il progetto Actions per l'approvazione.

Consulta la pagina Pubblicare azioni localizzate per avere ulteriori informazioni su come localizzare la distribuzione delle azioni.

Test

Durante lo sviluppo, puoi testare l'Azione localizzata con dispositivi hardware o il simulatore di Actions con le seguenti funzionalità:

• La simulazione della lingua ti consente di impostare le impostazioni internazionali di un dispositivo per testare le risposte e la logica specifiche per area geografica nell'Azione.
• La simulazione della località ti consente di impostare la posizione fisica del dispositivo per testare il targeting per località e le eventuali risposte specifiche per regione nel completamento.

Consulta la pagina del Simulatore di Azioni per ulteriori informazioni su come testare le azioni localizzate con il simulatore di Actions.