Inscrição no programa de fidelidade para usuários e upgrades de passes

O recurso de inscrição e login no programa de fidelidade permite que os usuários procurem seu programa e participem ou façam login na conta diretamente pela Carteira do Google. Os usuários serão direcionados para o site compatível com dispositivos móveis a fim de concluir o processo. Depois disso, eles poderão adicionar o cartão oficial à Carteira do Google.

A implementação desse recurso é o pré-requisito para converter cartões "estáticos" adicionados pelo usuário em cartões "dinâmicos" vinculados à API. Neste guia, apresentamos uma visão geral dos benefícios e das etapas de implementação necessárias para ativar a inscrição, o login e os upgrades de cartão no seu programa de fidelidade.

Visão geral

Para começar, verifique se você já configurou seu projeto e tem acesso à API Google Wallet.

Siga estas quatro etapas para implementar o recurso:

  1. Configure uma classe de teste: configure a Carteira do Google para testar seus fluxos.
  2. Desenvolva páginas: crie páginas de inscrição/login usando o SharedDataType da Carteira do Google.
  3. Implementar push back: Envie o cartão fidelidade para a Carteira do Google após a ação.
  4. Solicitar verificação: envie para análise e peça a ativação do upgrade.

Por que implementar a inscrição em programas de fidelidade?

Para entender o valor dessa integração, é importante distinguir entre os dois tipos de cartões que existem na Carteira do Google: L1 (adicionado pelo usuário) e L2 (emitido pelo parceiro).

A diferença entre L1 e L2

Recurso Passe L1 (adicionado pelo usuário) Passe L2 (emitido pelo parceiro)
Origem Criado quando um usuário lê manualmente um cartão físico ou digita um número. Criado e enviado usando a API Wallet depois que um usuário se inscreve ou faz login usando seu fluxo.
Controle Estático. O parceiro não tem visibilidade nem controle sobre esse cartão. Dinâmico. O parceiro tem controle total usando a API.
Funcionalidade Uma imagem estática de um código de barras. Não é possível atualizá-lo. Pode atualizar saldos de pontos, status de nível, exibir ofertas personalizadas e receber notificações.

Caminhos de upgrade: a "ponte" para seu programa

Ao criar o fluxo de inscrição no programa de fidelidade (o "destino"), você permite que o Google crie uma "ponte" que atualiza os usuários de cartões estáticos de nível 1 para seus cartões oficiais de nível 2. Há dois gatilhos principais de upgrade:

  1. Upgrade de cartão L1 para L2: se um usuário já tiver adicionado seu cartão manualmente (L1), a Carteira do Google poderá solicitar que ele acesse o novo fluxo de login para fazer upgrade para o cartão dinâmico oficial (L2).
  2. Upgrade de cartões importados do Gmail: se a Carteira do Google detectar um cartão de fidelidade usando o Gmail de um usuário, ela poderá solicitar que ele acesse seu fluxo e faça a autenticação para receber o cartão oficial de nível 2.

Etapa 1: configurar uma classe de teste na Carteira do Google

Determine os URLs de inscrição e login, além do logotipo do programa e dos campos de usuário escolhidos. Em seguida, use os campos aninhados discoverableProgram em loyaltyclass para definir os valores apropriados.

Defina os valores em discoverableProgram para criar uma versão de rascunho do programa de fidelidade habilitado para inscrição/login. Para garantir que isso fique visível para os testadores, verifique se eles têm acesso ao Console do Google Pay e da Carteira. Para saber como compartilhar o acesso ao Console do Google Pay e da Carteira com outras pessoas, consulte Saiba mais sobre a página "Usuários".

Para concluir a verificação da funcionalidade da sua implementação durante o processo de desenvolvimento, entre em contato conosco pelo widget de suporte de contato no Console do Google Pay e da Carteira. Enquanto estiver no console, selecione API Google Wallet no tópico e depois Login/inscrição de fidelidade no subtópico.

Etapa 2: desenvolver páginas de inscrição e login

Ao optar por fazer login ou se inscrever no programa de fidelidade, o usuário é direcionado para uma página personalizada no site para concluir o processo de inscrição ou login. Se um usuário quiser se inscrever, a Carteira do Google vai solicitar que ele compartilhe os dados dele com você.

Para que o usuário conclua essas ações, é necessário fornecer uma destas duas páginas ou ambas:

  1. Um URL de login em que o usuário possa fazer login em uma conta.
  2. Um URL de inscrição em que o usuário possa criar uma conta nova.

As páginas de login e inscrição precisam atender aos seguintes requisitos:

  • Ofereça uma experiência do usuário compatível com dispositivos móveis.
  • Minimize o número de campos obrigatórios durante o processo de inscrição.
  • Permita que o usuário conclua o login ou a inscrição em uma única página.
  • Use a criptografia HTTPS com um certificado válido para garantir que os dados do usuário sejam transmitidos com segurança.
  • Garanta pelo menos 99,9% de tempo de atividade nas páginas de login e inscrição.

Além desses requisitos, recomendamos que você permita que os usuários se inscrevam no seu programa de fidelidade sem preencher nenhum formulário ou que mantenha a página apenas para aceitação dos Termos de Serviço.

  • Ao usar os dados do usuário fornecidos no SharedDataType, você pode criar uma conta e enviar o cartão fidelidade imediatamente.
  • Em seguida, você pode enviar ao usuário uma senha única ou um link para configurar a senha e os detalhes opcionais da conta.
  • Isso reduz a chance de abandono do processo de inscrição pelo usuário, porque cada etapa extra pode levar a mais desistências.

Ao apresentar a página de login ou inscrição, a Carteira do Google cria um Android WebView, e uma solicitação POST é enviada ao URL fornecido. Os dados do usuário são fornecidos no parâmetro SharedDataType, que é incluído na solicitação POST com um Content-Type de application/x-www-form-urlencoded e codificação UTF-8. O valor do parâmetro SharedDataType é um objeto JSON codificado em Base64.

Dependendo da ação escolhida pelo usuário e dos campos que você especificou para solicitar ao usuário, o objeto JSON pode conter os campos a seguir.

Campo Registro
e-mail ✓
firstName ✓
lastName ✓
addressLine [1-3] ✓
cidade ✓
estado ✓
CEP ✓
país ✓
telefone ✓

Confira abaixo um exemplo de objeto JSON decodificado contido no SharedDataType.

Recurso

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "jane.doe@example.com",
  "phone": "555-555-5555"
}

Etapa 3: implementar o envio imediato para a Carteira do Google

Depois da autenticação (login) ou após a criação da conta (inscrição), a página precisa enviar imediatamente o cartão fidelidade do usuário para a Carteira do Google.

É possível enviar o cartão fidelidade de volta para a Carteira do Google redirecionando para um link que siga a estrutura abaixo.

https://pay.google.com/gp/v/save/{jwt_generated}

O comprimento seguro de um URL é de 2.000 caracteres. Seus links não podem exceder esse limite. Os objetos codificados em JWTs precisam ser pequenos e conter apenas dados específicos do usuário. Tente manter a maioria dos dados na classe do objeto, criando-a antes do JWT. Para objetos maiores, que excedam o limite, é possível criar o objeto primeiro na API Google Wallet e enviar apenas o ID do objeto no JWT.

Fluxo de comunicação típico

O fluxo de comunicação para um usuário que conclui a inscrição ou o login é ilustrado na imagem a seguir. Todas as ações entre "Seu servidor" são de sua responsabilidade.

Fluxos de login de inscrição

Etapa 4: solicitar a verificação e a ativação

Depois de concluir o trabalho de desenvolvimento e testar os fluxos de inscrição/login, envie uma solicitação para que sua implementação seja revisada e totalmente ativada.

  1. Acesse o Console do Google Pay e da Carteira.
  2. Use o widget Entrar em contato com o suporte.
  3. Informe à equipe de suporte que você concluiu a integração da inscrição no programa de fidelidade.

Depois de uma avaliação completa da implementação que confirme o funcionamento correto com o app Carteira do Google, o recurso de inscrição/login será lançado publicamente para o programa de fidelidade.

Para garantir uma experiência do usuário ideal, verificações recorrentes da implementação de inscrição/login serão realizadas para garantir conformidade contínua com os requisitos do recurso. Você vai receber uma notificação no caso de discrepâncias, e a funcionalidade de login/inscrição poderá ser desativada até o problema ser resolvido.

Perguntas frequentes

  • Há algum requisito para as imagens usadas em meu programa de fidelidade? Sim, as imagens precisam ser hospedadas em um local HTTPS porque, de outra forma, não estarão visíveis na Carteira do Google.

  • Há alguma ferramenta que simplifique a implementação e a depuração de JWTs? Sim, plataformas como www.jwt.io permitem decodificar e depurar os tokens durante o processo de desenvolvimento para verificar o conteúdo que está sendo enviado. O Google não tem afiliação e não recomenda nenhum desses terceiros especificamente.

  • Como processamos corretamente os dados SharedDataType codificados em Base64? Use a codificação UTF-8 em todo o processo. A string JSON é codificada primeiro em UTF-8 e, depois, em android.util.Base64 com as opções NO_WRAP e URL_SAFE. Esse método corresponde à seção 4 do RFC 3548.