Introdução



A API Mobile Data Plan Sharing permite que os assinantes de serviços móveis vejam as informações do plano nas Configurações usando padrões estabelecidos de interface do usuário do Android. Ele também permite que os usuários vejam e gerenciem o plano usando outras plataformas, como o Google Assistente. Muitos usuários vão conhecer o plano de dados móveis por uma notificação informando que é possível ver e gerenciar o plano. Depois de consentir com o compartilhamento de plano de dados entre a operadora e o Google, os assinantes poderão ver o plano de dados móveis com as informações enviadas pela API.
A interface à direita é um exemplo de como uma integração pode ser na versão 20.1 do Google Play Services. Role a imagem para ver mais.
Os princípios norteadores.
-
Precisão
O operador fornece informações precisas e oportunas usando a API da melhor maneira possível. Qualquer imprecisão afeta negativamente a confiabilidade do plano de dados móveis e prejudica a experiência do usuário com os apps do Google que usam essas informações. -
Clareza
O usuário pode ver o que assinou ou comprou usando a estrutura da API de plano e módulo. Os nomes e as descrições dos planos e módulos são escritos para serem o mais claros possível. Alguns usuários podem ter menos conhecimento digital ou usar um idioma diferente do materno no smartphone. Em vez de usar termos técnicos como "limitado", use uma palavra não técnica quando apropriado, por exemplo, "seus dados serão reduzidos para…". -
Brevidade
Os usuários geralmente verificam em vez de ler o texto para procurar informações importantes. Coloque palavras-chave no início das frases e remova as que não mudam o significado e aproveitam o contexto. Por exemplo, quando o contexto é o saldo da conta do usuário, "Ao fazer uma recarga, a validade do saldo da sua conta será estendida" pode ser abreviado para "Estenda a validade fazendo uma recarga".
Opções de configuração

1 Logotipo 2 Nome da marca do operador
Logotipo
Antes de testar a integração, um membro da equipe vai pedir um recurso de imagem do logotipo que vai aparecer ao lado do seu nome. Consulte as diretrizes de marca da sua operadora para saber os usos aprovados do seu logotipo. Envie um logotipo quadrado de 600 por 600 pixels ou maior em um plano de fundo opaco, de preferência no formato PNG ou SVG, mas um JPG de alta qualidade também é aceitável.
O logotipo da operadora em combinação com o nome da marca é um sinal para os usuários de que as informações do plano e da conta são confiáveis. Escolher o logotipo certo para a interface é importante porque ele precisa ser reconhecido rapidamente, mesmo em tamanhos pequenos. Por esses motivos, os Brandmarks são a melhor opção. Se a cor estiver fortemente associada à sua marca, use uma versão do logotipo que a utilize por completo. Evite usar marcas denominativas, se possível, porque elas podem não ser muito legíveis em tamanho pequeno, e o nome do operador vai aparecer ao lado delas. Não combine marcas e marcas nominativas em uma imagem, porque isso vai dificultar ainda mais a leitura.

Não use marcas de marca ou marcas de palavras abreviadas

Evite marcas de palavras longas devido à legibilidade e à duplicação

Não use logotipos completos ou com elementos extras.
Nome da marca da operadora
O nome da marca precisa ser facilmente reconhecido pelos usuários e ser a versão mais curta possível. Não use slogans nem escreva siglas por extenso quando uma versão mais curta for possível. Confira alguns exemplos abaixo:
Bom: "MyTelco", "ACG"
Evite: "MyTelco Wireless", "American Cellular Group"
Ruim: "MyTelco - Inovação sem limites", "ACG Inc."
Diretrizes de escrita
- Seja breve
O espaço é limitado e fica mais fácil para os usuários lerem. Isso é especialmente importante para usuários que estão acessando a Internet pela primeira vez. - NÃO USE LETRAS MAIÚSCULAS
Os usuários podem achar que você está gritando com eles, e também é mais difícil ler ou verificar. Isso não se aplica a acrônimos ou nomes de marcas. - Evite pontuação desnecessária
Não seja bombástico! Sempre termine a última frase com um ponto final. Não use pontos-finais se houver apenas uma frase. - Não inclua URLs
A menos que indicado de outra forma pela referência da API, eles não poderão ser tocados na interface.
Tipo de plano
Para a maioria das operadoras, é simplesmente "pré-pago" ou "pós-pago", mas às vezes os usuários se identificam com um tipo de plano exclusivo ou comercializado a que se inscreveram. Não use um nome de plano descritivo que possa mudar de mês para mês ou incluir detalhes como tarifas de ligação ou SMS. Esse campo também pode ser deixado em branco se não for necessário.

1 planStatus.title
2 planStatus.updateTime
O que fazer | O que não fazer | Contagem de caracteres | Truncamento |
Assinatura pré-paga
Pós-pago SuperMetro GoJUMP |
Chamadas ilimitadas na rede, R$ 0,20/SMS
Nenhum plano Super Internet 5GB 129b |
Recomendamos usar menos de 50 caracteres | Elipse após duas linhas |
Nome do módulo
Referência da API: PlanModule.moduleName

1 PlanModule.moduleName
2 Plan.expirationTime
3 PlanModule.description
Mantenha os nomes dos módulos curtos usando nomes exclusivos ao considerar todos os possíveis nomes de planos que podem aparecer aqui. Use a descrição dos módulos para comunicar os detalhes do plano. Evite colocar cota ou validade no título, porque eles vão aparecer duplicados na barra de dados e acima dela.
Se o nome do módulo for deixado em branco, os padrões da interface serão "Dados" para dados medidos e "Dados ilimitados" para dados não medidos.
O que fazer | O que não fazer | Contagem de caracteres | Truncamento |
Velocidade máxima da Internet
Pacote de diversão nas redes sociais Noite de cinema Dados 3G Dados ilimitados a 1 Mbps |
Recarga de 1 GB de Internet rápida
Vídeo ilimitado com iFlix, Netflix, YouTube, LINE TV, JOOX, Apple Music, Fungjai, TIDAL, AtimeOnline, Deezer, Cat Radio, COOLISM e BEC TERO RADIO |
Recomendamos menos de 24 caracteres | nenhum |
Descrição do módulo
Referência da API: PlanModule.description
Descreva os detalhes que não foram incluídos no título. Por exemplo, explique os benefícios do "Pacote Ultra Entretenimento" de maneira concisa. Evite linguagem de marketing ou promocional, repetir o nome do plano ou detalhes de ligações/SMS.
O que fazer | O que não fazer | Contagem de caracteres | Truncamento |
Streaming ilimitado de entretenimento a uma velocidade de 2 Mbps no YouTube, LINE TV, JOOX, Apple Music, Fungjai, TIDAL, AtimeOnline, Deezer, Cat Radio, COOLISM e BEC TERO RADIO | Aproveite 12 horas de Internet ilimitada e 24 horas de ligações ilimitadas.
Com os novos planos SuperMetro, sua conta sempre fica ativa durante todo o período da assinatura. |
Recomendamos não exceder 180 caracteres | nenhum |
Saldo da conta
Referência da API: AccountInfo
Os usuários pré-pagos podem conferir o saldo atual da conta, a validade dele e, opcionalmente, um texto que descreve as políticas da operadora sobre validade e uso do saldo.

1 AccountInfo.accountBalance
2 AccountInfo.validUntil
3 Texto de ajuda do saldo da conta (entre em contato para configurar)
Saldos de empréstimos
Referência da API: AccountInfo
O status do empréstimo pode ser mostrado ao lado do saldo da conta para usuários pré-pagos. Isso inclui o valor do empréstimo e qualquer saldo disponível que possa ser gasto. É necessário fornecer uma breve descrição ao usuário sobre como o valor do empréstimo será coletado.

1 AccountInfo.accountBalance
+ AccountInfo.loanBalance
2 AccountInfo.unpaidLoan
3 AccountInfo.loanBalance
4 Texto de ajuda sobre empréstimos (entre em contato para configurar)
Nome da oferta
Referência da API: Offer.planName
Mantenha o nome o mais curto possível usando um nome exclusivo ou descritivo ao considerar todos os nomes possíveis de planos de oferta. Use a descrição da oferta para comunicar os detalhes dela, como política de uso aceitável ou outras restrições. Não use linguagem promocional ou de marketing desnecessária quando um nome descritivo for suficiente. Evite incluir o preço no nome, porque ele aparece ao lado da oferta.

1 Offer.planName
2 Offer.planDescription
3 PlanOffer.FormOfPayment 4 Termos de compra
O que fazer | O que não fazer | Contagem de caracteres | Truncamento |
Go No Limit 1 Mbps Day Pass
Recarga de 1 GB 1 GB de dados 3G Passe de um dia de Internet ilimitada |
A melhor recarga de 4 GB!
Recarga de 1 GB com desconto |
Recomendamos menos de 40 caracteres | nenhum |
Descrição da oferta
Referência da API: Offer.planDescription
Seja breve e o mais específico possível para comunicar limitações de uso relacionadas a velocidade, validade ou limites de tempo, se aplicável. Evite linguagem promocional e de marketing em excesso.
O que fazer | O que não fazer | Contagem de caracteres | Truncamento |
Dados 4G com velocidade máxima de 10 Mbps. Válido por 24 horas. | Internet 4G mais rápida. Adquira o seu hoje mesmo!
Dados LTE ilimitados na melhor operadora de celular do país |
Recomendar informações importantes com menos de 50 caracteres para aparecer na lista de ofertas | Reticências em duas linhas na lista de ofertas
Nenhuma truncagem na caixa de diálogo da oferta |
Carrossel de recompra
Quando as ofertas são marcadas como uma recompra, elas aparecem acima de todas as outras ofertas. Assim, os usuários podem encontrar e renovar rapidamente os planos e pacotes favoritos. Confira como ele aparece na introdução.
Forma de Pagamento.
Traduzido e anexado à descrição da oferta, esse texto fornecido pelo GTAF é definido para todas as ofertas enviadas a um usuário. Por exemplo, "Deduzido do saldo da conta" para a maioria dos usuários pré-pagos ou "Cobrado usando sua forma de pagamento salva" para casos em que um cartão de crédito ou débito está registrado. As mensagens exatas estão sujeitas a mudanças. Confira outras opções.
Termos de compra
O plano de dados móveis pode oferecer suporte a todos os termos ou condições de compra que aparecem atualmente com ofertas em outros canais em que são vendidos. Por exemplo, se o IVA normalmente for excluído do preço, diga "O preço não inclui 7% de IVA". Isso é configurado quando o operador faz o onboarding.
Cota e uso
Com o plano de dados móveis, os usuários podem acompanhar facilmente o uso e a cota restante. Alguns campos são obrigatórios, mas todos os operadores precisam preencher o máximo possível para ajudar o usuário a acompanhar o que ele usou e o que ainda tem. Na interface mostrada abaixo, tudo, exceto o título do módulo "Cota de Internet", é formatado e traduzido pelo Google.

1Ícone com base no tipo de dados especificado em PlanModuleTrafficCategory
. Os ícones abaixo vão aparecer com as categorias de tráfego indicadas. Não defina arbitrariamente a categoria de trânsito para forçar o aparecimento de um ícone específico.
2quotaBytes
menos remainingBytes
3A barra de progresso só aparece se quotaBytes
e remainingBytes
forem preenchidos
7planState
definido como INACTIVE
para casos em que os recursos do plano estão temporariamente inativos
Notificações
As notificações são essenciais para que os usuários gerenciem os dados móveis de maneira eficaz. Os operadores podem enviar notificações específicas aos assinantes sobre os planos deles usando a API. O texto da notificação é gerado, traduzido e enviado pelo GTAF com base nos campos obrigatórios da API. Para uma lista atualizada de notificações compatíveis e o campo obrigatório delas, consulte o guia da API Notifications. O design segue as diretrizes de notificação do Android Material Design com o objetivo de fornecer notificações oportunas, contextuais, precisas e específicas para que os usuários possam gerenciar os dados deles.

Exemplos de notificações compatíveis (o conteúdo está sujeito a mudanças):
1 Saldo de dados baixo 2 Sem dados 3 Lembrete de expiração 4 Notificação de boas-vindas 5 Aviso do PAYGO 6 Recarga do saldo da conta
Página de suporte
Uma página de suporte pode ser configurada para direcionar os usuários aos seus canais de suporte em vez de enviar para a ferramenta de feedback do Google. A partir do Google Play Services 15.3, os usuários podem acessar esse recurso no menu de mais opções, na parte de cima do plano de dados móveis. Entre em contato com um membro da equipe de compartilhamento de plano de dados móveis para configurar.

1 Ajuda do suporte 2 Título do link 3 Subtítulo do link
Os usuários podem ver uma lista de opções de suporte por e-mail, SMS, chamada e Web, além de um trecho de texto para definir o contexto. Não é possível vincular a outros apps nem fazer o download de outros apps na Play Store. O título e o subtítulo do link são especificados em inglês e traduzidos pelo Google.
As intents de e-mail e SMS podem ser preenchidas com um corpo e uma linha de assunto (somente e-mail). Use essas respostas se quiser orientar o usuário a fornecer as informações adequadas para lidar com a solicitação de suporte.
Dicas da página de suporte
Quando os usuários chegam aqui, como eles sabem qual opção escolher? Se algumas opções forem para tipos de conta específicos, deixe isso claro. Use o subtítulo para dar aos usuários uma ideia de quando ou por que eles devem usar essa opção, usando tempos de resposta esperados, horários de funcionamento ou outras informações úteis.