Localization Testing: metodi, strumenti e controlli geografici

Il test di localizzazione è il processo di verifica che un prodotto software si comporti correttamente per una specifica località di destinazione, coprendo la lingua, i formati regionali, il layout e il contenuto geo-specifico piuttosto che la sola traduzione. Questa guida confronta il modo in cui i team QA eseguono effettivamente i test di localizzazione: revisione manuale, controlli automatizzati e il passaggio aggiuntivo di testare ciò che vedono gli utenti reali dall’interno di un Paese di destinazione.

Otterrai una definizione autonoma, un’analisi dettagliata dei controlli dei test di localizzazione, un flusso di lavoro ripetibile con un framework denominato, un confronto dei metodi di verifica geografica e limitazioni oneste. L’attenzione è rivolta alle decisioni pratiche per il QA e agli ingegneri del software, non alle affermazioni di marketing.

DataImpulse è un fornitore di proxy etico che offre oltre 90 Mln di indirizzi IP residenziali, mobili e di data center in 195 paesi. Utilizza un modello a consumo da 1 dollaro per GB con traffico senza scadenza e viene utilizzato per web scraping, ad verification, monitoraggio dei prezzi, ricerche di mercato e gestione di più account.

Cos’è il test di localizzazione nei test del software?

Il test di localizzazione è un’attività di garanzia della qualità che conferma che una build localizzata è corretta, completa e naturale per un locale di destinazione. Va oltre il controllo che le stringhe siano state tradotte e chiede se l’intera esperienza si adatta alla lingua, alla regione e alla cultura dell’utente.

Un locale è più di una lingua. Raggruppa una lingua, un paese o una regione e una serie di convenzioni per date, numeri, valuta, ordinamento e direzione del testo. L’inglese per gli Stati Uniti e l’inglese per il Regno Unito condividono parole ma differiscono nell’ortografia, nell’ordine delle date, nella valuta e in alcune note legali. I test di localizzazione rilevano le discrepanze che la pura traduzione lascia dietro di sé.

È diverso dal test di internazionalizzazione (i18n), che verifica che il codice sia costruito per supportare molte localizzazioni, ad esempio esternalizzando stringhe e gestendo Unicode. L’internazionalizzazione è il fondamento dell’ingegneria; il test di localizzazione è la verifica locale che si trova sopra di esso. Entrambi sono importanti, e un prodotto che ha superato i test di internazionalizzazione può comunque fallire i test di localizzazione per un singolo mercato.

Cosa controlla il test di localizzazione?

I test di localizzazione controllano ogni superficie in cui le impostazioni locali modificano l’output corretto: lingua, formati, layout, direzione e contenuti specifici della regione. L’elenco seguente è l’elenco di controllo funzionante su cui convergono la maggior parte dei team QA.

• Qualità della lingua e della traduzione: stringhe accurate e contestualizzate senza frammenti non tradotti, segnaposto rotti o frasi concatenate che non sopravvivono alla traduzione.
• Valuta e prezzi: il simbolo di valuta, il codice, la posizione e il separatore decimale corretti per la locale, più le tasse o la visualizzazione VAT dove richiesto.
• Formati di data, ora e numero: ordinamento corretto (giorno-mese-anno rispetto a mese-giorno-anno), orologio a 12 rispetto a 24 ore, separatori delle migliaia e decimali e primo giorno della settimana.
• Direzione del testo e RTL: le lingue con scrittura da destra a sinistra come l’arabo e l’ebraico necessitano di layout speculari, icone allineate e corretta gestione del testo bidirezionale.
• Layout e troncamento: Le stringhe tedesche o finlandesi possono essere molto più lunghe di quelle inglesi, quindi pulsanti, etichette e menu devono espandersi o avvolgersi senza ritagliarsi o sovrapporsi.
• Contenuti legali e geo-specifici: termini specifici per regione, banner di consenso, avvisi fiscali, dichiarazioni di non responsabilità e testo normativo richiesto.
• Modalità di pagamento e disponibilità: opzioni di pagamento previste a livello locale, oltre a prodotti, spedizioni o funzionalità offerte solo in determinati paesi.
• Adattamento culturale: icone, colori, immagini, nomi ed esempi che siano letti in modo appropriato anziché confusi o offensivi.

Gli ultimi tre elementi sono quelli in cui il test diventa difficile, perché la risposta corretta dipende dal paese da cui sembra provenire la richiesta. Questa è la parte che gli ambienti di test standard gestiscono male.

Localization testing automatizzati e manuali: quali utilizzare?

Utilizza l’automazione per controlli oggettivi e ripetibili e test manuali per il giudizio linguistico e culturale. Nessuno dei due sostituisce l’altro e i team maturi gestiscono entrambi in modo stratificato.

Localization testing manuale si affida a revisori umani, idealmente madrelingua, che leggono le schermate nel contesto e giudicano la fluidità, il tono, l’adattamento culturale e se il testo legale viene letto correttamente. Gli esseri umani colgono una traduzione rigida, un linguaggio scomodo o un’immagine culturalmente sbagliata che nessuna affermazione può smentire. Il costo è che i passaggi manuali sono lenti, difficili da ripetere in modo identico e costosi da eseguire per ogni locale in ogni versione.

Localization testing automatizzati è efficace a livello meccanico: rileva stringhe non tradotte, chiavi mancanti, segnaposto rotti, violazioni del formato e troncamento del layout tramite confronto visivo. La pseudo-localizzazione, in cui le stringhe vengono espanse e accentate prima che esista la traduzione reale, è una tecnica automatizzata economica che fa emergere stringhe codificate e il layout si interrompe presto. L’automazione funziona velocemente in CI e si adatta a dozzine di lingue, ma non è in grado di giudicare se una traduzione dall’aspetto corretto sia effettivamente letta bene.

La risposta pratica a come automatizzare i test di localizzazione è automatizzare i controlli con un’unica risposta oggettiva giusta e riservare il significato a revisori umani. Vedi la nostra nota su raschiare senza bloccarsi per modelli correlati quando i controlli automatizzati recuperano pagine localizzate in tempo reale su larga scala.

Come eseguite i test di localizzazione passo dopo passo?

Esegui i test di localizzazione come un flusso di lavoro ripetibile: prepara, imposta le impostazioni locali, esegui controlli su ogni superficie, verifica i contenuti geografici, registra i difetti con il contesto locale ed esegui nuovamente i test. Per mantenere una copertura onesta in tutte le località, i team possono utilizzare un semplice modello denominato.

Lo chiamiamo modello LARGE, una struttura a 5 fattori che associa le cinque cose che una locale può interrompere:

• L – Lingua: completezza della traduzione, accuratezza del contesto e assenza di stringhe non tradotte o troncate.
• A – Aspetto: layout, troncamento, mirroring RTL, caratteri e codifica.
• R – Formato regionale: date, numeri, valuta, ora, ordinamento e formati di indirizzo.
• G – Contenuti geografici: prezzi, prodotti, note legali, metodi di pagamento e funzionalità geograficamente bloccati per regione.
• E – Esperienza: adattamento culturale di immagini, tono, esempi e flusso end-to-end.

Un flusso di lavoro concreto che utilizza il modello LARGE è simile al seguente. Innanzitutto, prepara i dati del test, un glossario o una guida stilistica e i risultati attesi per ogni locale. In secondo luogo, configurare l’ambiente per le impostazioni locali di destinazione impostando OS o la lingua, la regione e il fuso orario del browser. Terzo, cammina su ogni schermata ed esegui i controlli L, A, R ed E. In quarto luogo, eseguire i controlli G da un IP che sembra effettivamente trovarsi nel paese di destinazione, come descritto nella sezione successiva. In quinto luogo, registrare ogni difetto con uno screenshot, la localizzazione esatta e l’ambiente in modo che sia riproducibile. In sesto luogo, testare nuovamente le correzioni ed eseguire un passaggio di regressione sulle versioni locali già approvate, poiché una modifica di stringa condivisa può regredire su più versioni locali contemporaneamente.

Come si testano i contenuti geo-specifici di un altro Paese?

Per verificare i contenuti geo-specifici devi inviare la tua richiesta da un indirizzo IP che sembra effettivamente trovarsi nel Paese di destinazione, perché molti siti offrono prezzi, valuta, prodotti, note legali e funzionalità geo-bloccate localizzate in base a IP del visitatore. Un emulatore o un cambio di impostazione locale del browser cambia ciò che dici di essere; non cambia dove il server pensa che tu sia.

Questo è il fattore di contenuto geografico (G) del modello LARGE ed è quello che un normale ambiente di staging non può coprire. Se la tua build offre prezzi tedeschi, un metodo di pagamento solo per il Brasile o un banner di consenso specifico per paese, l’unico modo affidabile per vedere esattamente ciò che vede un utente locale è originare la richiesta da quel paese. Targeting per Paese residential proxies instrada il tuo traffico attraverso un dispositivo reale IP nel paese prescelto, così il sito di destinazione ti geolocalizza come un vero visitatore locale. DataImpulse offre oltre 90 Mln di IP in 195 paesi con targeting per paese incluso nel prezzo base, che copre la maggior parte delle matrici di test di localizzazione.

Un controllo Playwright minimo che apre una pagina di prezzi localizzata tramite un proxy mirato alla Germania impostando allo stesso tempo le impostazioni locali del browser è simile al seguente:

const { chromium } = require('playwright');

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.dataimpulse.com:823',
    username: 'YOUR_USER__cr.de',
    password: 'YOUR_PASS'
  }
});
const page = await browser.newPage({ locale: 'de-DE' });
await page.goto('https://shop.example.com/pricing');
console.log(await page.locator('.price').first().innerText());
await browser.close();

La stessa idea funziona dalla riga di comando, associando un proxy mirato al paese con un’intestazione Accept-Language in modo che sia IP che il suggerimento sulla lingua corrispondano alla locale sottoposta a test:

@@BLOCCOCODICE1@@

curl -x http://gw.dataimpulse.com:823 \
  -U "YOUR_USER__cr.jp:YOUR_PASS" \
  -H "Accept-Language: ja-JP" \
  https://shop.example.com/pricing

Modifica il tag del paese nel nome utente per spostare l’uscita IP su un altro mercato, quindi confronta l’output localizzato con il risultato previsto per quella località. Se non sei sicuro in quale paese si risolve un IP durante il debug, an Ricerca indirizzo IP conferma la posizione di uscita prima di fidarsi dei risultati. In scala, residential proxies conta di più datacenter proxies qui, perché molti siti localizzati trattano gli intervalli IP del data center come sospetti e potrebbero fornire un’esperienza di fallback.

Quale metodo di test geografico dovresti scegliere?

Scegli un emulatore o un interruttore locale per i controlli della lingua e del formato, uno VPN per controlli manuali occasionali e uno residential proxies mirato per paese per una verifica dei contenuti geografici accurata e scalabile. La tabella mette a confronto i tre assi che interessano ai team QA.

Matrice decisionale. Utilizza un emulatore o un commutatore locale quando stai testando la traduzione, il layout, RTL o i formati di data e numero, in cui il paese visualizzato dal server non modifica l’output. Utilizza VPN quando hai bisogno di una rapida visualizzazione manuale una tantum da un paese comune e l’automazione non è un requisito. Utilizza un residential proxy con targeting per Paese quando devi verificare prezzi, prodotti, note legali o funzionalità bloccate geograficamente o quando devi coprire molti paesi in corse automatizzate. Evita i test del solo emulatore quando il contenuto stesso viene scelto da IP ed evita di fare affidamento su VPN quando hai bisogno di una copertura parallela di molte località o paesi che un provider VPN non offre. DataImpulse ottiene i suoi IP dagli utenti che accettano e ricevono un compenso, quindi questo è un deleghe etiche approccio piuttosto che una soluzione alternativa nell’area grigia.

Quali sono i limiti dei test di localizzazione?

I test di localizzazione presentano limiti reali e nominarli mantiene il processo onesto. Nessun metodo singolo copre ogni problema locale e i proxy risolvono un problema specifico, non tutti.

• L’automazione non può giudicare il significato: una stringa può superare ogni controllo di formato e completezza e tuttavia essere letta come innaturale o culturalmente sbagliata. La revisione umana nativa rimane necessaria.
• I segnali geografici sono stratificati: IP è il segnale più forte, ma alcuni siti utilizzano anche GPS, il paese dell’account, l’indirizzo di fatturazione o le impostazioni internazionali del browser. Uno IP mirato al Paese corregge solo il livello IP; allinea anche l’intestazione Accept-Language e le eventuali impostazioni dell’account.
• I proxy non sono uno scraping API: DataImpulse fornisce il livello di rete (IP, rotazione, targeting per Paese) ma non analizza le pagine né gestisce i tentativi per te. Non è uno scraping gestito API e non un proxy web gratuito, quindi il tuo sistema di test possiede ancora la logica.
• I dati del test vanno alla deriva: i prezzi localizzati, le norme fiscali e il testo legale cambiano nel tempo, quindi i risultati attesi necessitano di aggiornamenti periodici altrimenti le tue asserzioni segnaleranno falsi errori.
• I costi di copertura crescono con le impostazioni locali: la matrice locale si moltiplica rapidamente, quindi stabilisci la priorità in base alle entrate e al rischio del mercato piuttosto che provare a testare completamente ogni locale in ogni versione.

Considerato come un livello in una strategia QA più ampia, il test di localizzazione rileva i difetti che la revisione della traduzione e i test funzionali non rilevano, purché si rispetti ciò che ciascun metodo può e non può verificare.

Domande frequenti

Guide correlate

• Proxy per l’Asia
• Sblocco Web per l’intelligenza artificiale
• Quanto costano i proxy

Prova ogni locale del paese giusto

Per verificare i contenuti geo-specifici nel modo in cui li vedono gli utenti locali reali, è necessario un vero IP locale per ciascun mercato nella matrice di test. Crea un account DataImpulse per instradare test di localizzazione attraverso IP residenziali in 195 paesi, con targeting per paese incluso e traffico a consumo a partire da $ 1/GB.