Introduzione
L'API per la condivisione del piano dati mobili consente agli abbonati di visualizzare le informazioni sul proprio piano all'interno delle Impostazioni utilizzando i pattern dell'interfaccia utente Android consolidati. Inoltre, consente facoltativamente agli utenti di visualizzare e gestire il proprio piano utilizzando altre piattaforme come l'assistente. Molti utenti verranno introdotti per la prima volta al piano dati mobili tramite una notifica che li informa che possono visualizzare e gestire il proprio piano. Dopo aver acconsentito alla condivisione del piano dati tra il proprio operatore e Google, gli abbonati potranno visualizzare il piano dati mobile con le informazioni inviate tramite l'API.
L'interfaccia utente a destra è un esempio di come potrebbe apparire un'integrazione a partire dalla versione 20.1 di Google Play Services. Scorri all'interno dell'immagine per vedere altro.
Principi guida
-
Accuratezza
L'operatore fornisce informazioni accurate e tempestive utilizzando l'API al meglio delle sue capacità. Eventuali imprecisioni influiranno negativamente sull'affidabilità di Piano dati mobili e peggioreranno l'esperienza dell'utente con le app Google che utilizzano queste informazioni. -
Chiarezza
L'utente può vedere a cosa si è abbonato o cosa ha acquistato utilizzando la struttura dell'API per piani e moduli. Il nome e le descrizioni del piano e del modulo sono scritti in modo da essere il più chiari possibile. Tieni presente che alcuni utenti potrebbero avere meno competenze digitali o avere impostato il telefono su una lingua diversa dalla loro lingua principale. Invece di utilizzare termini tecnici come "limitato", utilizza una parola non tecnica quando appropriato, ad esempio "la velocità dei tuoi dati verrà ridotta a…". -
Concisezza
Gli utenti spesso scorrono il testo anziché leggerlo per cercare le informazioni chiave. Inserisci le parole chiave all'inizio delle frasi e rimuovi le parole che non ne cambiano il significato e sfrutta il contesto. Ad esempio, se il contesto è il saldo dell'account dell'utente, la frase "Quando ricarichi il tuo account, la validità del saldo dell'account viene estesa" potrebbe essere abbreviata in "Estendi la validità ricaricando il saldo".
Opzioni di configurazione
1 Logo 2 Nome del brand dell'operatore
Logo
Prima di testare l'integrazione, un membro del team ti chiederà un asset immagine del logo che verrà visualizzato accanto al tuo nome. Controlla le linee guida per il brand del tuo operatore per scoprire gli utilizzi approvati del tuo logo. Fornisci un logo quadrato di almeno 600 x 600 pixel su uno sfondo opaco, preferibilmente in formato PNG o SVG, ma è accettabile anche un JPG di alta qualità.
Il logo dell'operatore in combinazione con il nome del brand indica agli utenti che possono fidarsi delle informazioni sul piano e sull'account. Scegliere il logo giusto per la UI è importante perché deve essere riconoscibile a colpo d'occhio anche in dimensioni ridotte. I brandmark sono la soluzione migliore per questi motivi. Se il colore è fortemente associato al tuo brand, valuta la possibilità di utilizzare una versione del logo che lo sfrutti appieno. Se possibile, evita di utilizzare i marchi denominativi, in quanto potrebbero non essere molto leggibili a dimensioni ridotte e il nome dell'operatore verrà visualizzato accanto. Non combinare il brand e i logotipi in un'unica immagine, perché risulterà ancora meno leggibile.
Utilizza marchi o marchi denominativi abbreviati
Evita i marchi denominativi lunghi a causa di leggibilità e duplicazione
Non utilizzare loghi completi o loghi con elementi aggiuntivi
Nome del brand dell'operatore
Il nome del brand deve essere quello che gli utenti riconosceranno facilmente e deve essere la versione più breve. Non utilizzare slogan o acronimi quando è possibile una versione più breve. Ecco alcuni esempi:
Buono: "MyTelco", "ACG"
Evita: "MyTelco Wireless", "American Cellular Group"
Esempio non valido: "MyTelco - Innovation unbound", "ACG Inc."
Linee guida per la scrittura
- Sii breve
Lo spazio è limitato e sarà più facile per gli utenti eseguire la scansione. Ciò è particolarmente importante per gli utenti che si connettono a internet per la prima volta. - NON UTILIZZARE TUTTE LE LETTERE MAIUSCOLE
Gli utenti potrebbero avere l'impressione che tu stia urlando contro di loro ed è anche più difficile leggere o scorrere il testo. Questo non vale per gli acronimi o i nomi dei brand. - Evita la punteggiatura non necessaria
Non essere pomposo. Termina sempre l'ultima frase con un punto. Non utilizzare i punti fermi se è presente una sola frase. - Non includere URL
Se non diversamente indicato nel riferimento API, non saranno selezionabili nell'interfaccia utente.
Tipo di piano
Per la maggior parte degli operatori, si tratta semplicemente di "prepagato" o "postpagato", anche se a volte gli utenti si identificano con un tipo di piano unico o commercializzato a cui hanno sottoscritto un abbonamento. Non utilizzare un nome del piano descrittivo che può cambiare di mese in mese o includere dettagli del piano come tariffe per chiamate o SMS. Se non necessario, questo campo può anche essere lasciato vuoto.
1 planStatus.title 2 planStatus.updateTime
| Cosa fare | Cosa non fare | Conteggio dei caratteri | Troncamento |
| Pagamento anticipato
Pagamento posticipato SuperMetro GoJUMP |
Chiamate illimitate sulla rete, 20 cent/SMS
Nessun piano Super Internet 5GB 129b |
Consigliamo di non superare i 50 caratteri | Puntini di sospensione dopo due righe |
Nome modulo
Riferimento API: PlanModule.moduleName
1 PlanModule.moduleName 2 Plan.expirationTime 3 PlanModule.description
Mantieni brevi i nomi dei moduli utilizzando nomi univoci quando prendi in considerazione tutti i possibili nomi dei piani che potrebbero essere visualizzati qui. Utilizza la descrizione dei moduli per comunicare i dettagli del piano. Evita di inserire la quota o la validità nel titolo, in quanto verranno visualizzate duplicate nella barra dei dati e sopra.
Se il nome del modulo viene lasciato vuoto, i valori predefiniti dell'interfaccia utente sono "Dati" per i dati a consumo e "Dati illimitati" per i dati non a consumo.
| Cosa fare | Cosa non fare | Conteggio dei caratteri | Troncamento |
| Velocità massima di internet
Social Fun Pack Serata cinema Dati 3G Dati illimitati a 1 Mbps |
1 GB di velocità internet aggiuntiva
Video illimitati con iFlix, Netflix, YouTube, LINE TV, JOOX, Apple Music, Fungjai, TIDAL, AtimeOnline, Deezer, Cat Radio, COOLISM e BEC TERO RADIO |
Consigliamo meno di 24 caratteri | nessuno |
Descrizione del modulo
Riferimento API: PlanModule.description
Descrivi eventuali dettagli omessi nel titolo. Ad esempio, spiega in modo conciso i vantaggi del "Pacchetto intrattenimento Ultra". Evita un linguaggio di marketing o promozionale, la ripetizione del nome del piano o i dettagli di chiamate/SMS.
| Cosa fare | Cosa non fare | Conteggio dei caratteri | Troncamento |
| Streaming illimitato di contenuti di intrattenimento a una velocità di 2 Mbps su YouTube, LINE TV, JOOX, Apple Music, Fungjai, TIDAL, AtimeOnline, Deezer, Cat Radio, COOLISM e BEC TERO RADIO | Continua a divertirti con 12 ore di internet illimitato e 24 ore di chiamate illimitate.
I nuovi piani SuperMetro garantiscono che il tuo account rimanga sempre attivo per tutta la durata dell'abbonamento. |
Consigliamo di non superare i 180 caratteri | nessuno |
Saldo account
Riferimento API: AccountInfo
Gli utenti prepagati possono visualizzare il saldo attuale del proprio account, la sua validità e, facoltativamente, il testo che descrive le eventuali norme del tuo operatore relative alla validità e all'utilizzo del saldo.
1 AccountInfo.accountBalance 2 AccountInfo.validUntil 3 Testo di assistenza per il saldo dell'account (contatta per la configurazione)
Saldi dei prestiti
Riferimento API: AccountInfo
Lo stato del prestito può essere visualizzato insieme al saldo del conto per gli utenti prepagati. Sono inclusi l'importo del prestito e l'eventuale saldo disponibile che può essere speso. È obbligatorio fornire all'utente una breve descrizione di come verrà raccolto l'importo del prestito.
1 AccountInfo.accountBalance + AccountInfo.loanBalance 2 AccountInfo.unpaidLoan 3 AccountInfo.loanBalance 4 Testo di assistenza per il prestito (contatta per la configurazione)
Nome dell'offerta
Riferimento API: Offer.planName
Mantieni questo valore il più breve possibile utilizzando un nome univoco o descrittivo quando prendi in considerazione tutti i possibili nomi dei piani dell'offerta. Fai affidamento sulla descrizione dell'offerta per comunicare i dettagli dell'offerta, come la norma sul fair use o altre limitazioni. Non utilizzare un linguaggio promozionale o di marketing superfluo quando è sufficiente un nome descrittivo. Evita di includere il prezzo nel nome perché viene visualizzato accanto all'offerta.
1 Offer.planName 2 Offer.planDescription 3 PlanOffer.FormOfPayment 4 Termini di acquisto
| Cosa fare | Cosa non fare | Conteggio dei caratteri | Troncamento |
| Go No Limit 1 Mbps Day Pass
Ricarica 1 GB 1 GB di dati 3G Pass giornaliero per internet illimitato |
Miglior ricarica da 4 GB.
Ricarica di 1 GB a prezzo scontato |
Consigliamo di non superare i 40 caratteri | nessuno |
Descrizione offerta
Riferimento API: Offer.planDescription
Sii breve e il più specifico possibile per comunicare le limitazioni di utilizzo relative a velocità, scadenza o limiti di tempo, se applicabile. Evita un linguaggio promozionale e di marketing eccessivo.
| Cosa fare | Cosa non fare | Conteggio dei caratteri | Troncamento |
| Dati 4G a una velocità massima di 10 Mbps. Valido per 24 ore. | Internet 4G più veloce. Scaricalo oggi stesso.
Dati LTE illimitati sul miglior operatore di telefonia mobile del paese |
Consiglia informazioni essenziali con meno di 50 caratteri da visualizzare nell'elenco delle offerte | Puntini di sospensione su due righe nell'elenco delle offerte
Nessun troncamento nella finestra di dialogo dell'offerta |
Carosello di riacquisto
Quando le offerte vengono contrassegnate come riacquisto, vengono visualizzate sopra tutte le altre offerte, in modo che gli utenti possano trovare e rinnovare rapidamente i loro piani e pacchetti preferiti. Scopri come appare nell'introduzione.
Forma di pagamento
Tradotto e aggiunto alla descrizione dell'offerta, questo testo fornito da GTAF viene impostato per tutte le offerte inviate a un utente. Ad esempio, "Detratto dal saldo dell'account" per la maggior parte degli utenti prepagati o "Addebito tramite il metodo di pagamento salvato" per i casi in cui è registrata una carta di credito o di debito. I messaggi esatti sono soggetti a modifiche. Vedi altre opzioni.
Termini per l'acquisto
Il piano dati mobile può supportare qualsiasi termine o condizione di acquisto attualmente visualizzato con le offerte in altri canali in cui vengono vendute. Ad esempio, se l'IVA è generalmente esclusa dal prezzo, indica "Prezzo IVA esclusa al 7%". Questa impostazione viene configurata durante l'onboarding dell'operatore.
Quota e utilizzo
Il piano dati mobili consente agli utenti di monitorare facilmente l'utilizzo e la quota rimanente. Alcuni campi sono obbligatori, ma tutti gli operatori devono compilare il maggior numero possibile di campi per aiutare l'utente a tenere traccia di ciò che ha utilizzato e di ciò che gli rimane. Nell'interfaccia utente mostrata di seguito, tutto tranne il titolo del modulo "Quota internet" è formattato e tradotto da Google.
1Icona basata sul tipo di dati specificato in PlanModuleTrafficCategory. Le icone riportate di seguito vengono visualizzate con le categorie di traffico indicate. Non impostare arbitrariamente la categoria di traffico per forzare la visualizzazione di una determinata icona.
2quotaBytes meno remainingBytes
3La barra di avanzamento viene visualizzata solo se i campi quotaBytes e remainingBytes sono compilati
7planState impostato su INACTIVE per i casi in cui le funzionalità del piano sono temporaneamente inattive
Notifiche
Le notifiche sono fondamentali per consentire agli utenti di gestire in modo efficace i propri dati mobili. Gli operatori possono inviare notifiche specifiche ai propri abbonati in merito ai loro piani tramite l'API. Il testo della notifica viene generato, tradotto e inviato da GTAF in base ai campi API obbligatori. Per un elenco aggiornato delle notifiche supportate e del relativo campo obbligatorio, consulta la guida all'API Notifications. Il loro design segue le linee guida per le notifiche Android di Material Design con l'obiettivo di fornire notifiche tempestive, contestuali, accurate e specifiche in modo che gli utenti possano gestire i propri dati.
Esempi di notifiche supportate: (contenuti soggetti a modifiche)
1 Saldo dati basso 2 Dati esauriti 3 Promemoria scadenza 4 Notifica di benvenuto 5 Avviso PAYG 6 Ricarica del saldo dell'account
Pagina di assistenza
Una pagina di assistenza può essere configurata per indirizzare gli utenti verso i tuoi canali di assistenza anziché inviare il feedback allo strumento di Google. A partire da Google Play Services 15.3+, gli utenti possono accedervi dal menu Altre opzioni nella parte superiore del piano dati mobili. Contatta un membro del team di condivisione del piano dati mobili per la configurazione.
1 Support help 2 Link title 3 Link subtitle
Gli utenti possono visualizzare un elenco di opzioni di assistenza via email, SMS, chiamata e web, nonché un frammento di testo per fornire un contesto all'utente. Il collegamento ad altre app o il download di altre app dal Play Store non è supportato. Il titolo e il sottotitolo del link sono specificati in inglese e tradotti da Google.
Gli intent email e SMS possono essere compilati con un corpo e una riga dell'oggetto (solo email). Utilizzali se vuoi indirizzare l'utente a fornire le informazioni appropriate per gestire la sua richiesta di assistenza.
Suggerimenti per la pagina di assistenza
Quando gli utenti arrivano qui, come fanno a sapere quale opzione scegliere? Se alcune opzioni sono per tipi di account particolari, specificalo. Utilizza il sottotitolo per dare agli utenti un'idea di quando o perché dovrebbero utilizzare questa opzione utilizzando i tempi di risposta previsti, gli orari di apertura o altre informazioni utili.