Primeiros passos com os passes da Carteira do Google

Os passes da Carteira do Google são cartões digitais, como cartões de fidelidade, ofertas, vales-presente, ingressos para eventos, cartões de embarque e bilhetes de transporte público, que os usuários guardam no aplicativo Carteira do Google.

Com o Pushwoosh, você cria um passe no Painel de Controle, envia para os usuários e atualiza o passe a qualquer momento. As alterações são sincronizadas automaticamente em todos os dispositivos salvos.

O que você pode fazer com os passes da Carteira do Google

• Crie passes no construtor de passes
• Compartilhe o link para salvar ou o código QR com os usuários
• Atualize os passes a qualquer momento. O Google sincroniza as alterações em todos os dispositivos salvos

Pré-requisitos

• Uma conta de emissor do Google Pay & Wallet Console
• Um projeto do Google Cloud com uma chave de conta de serviço

Comece a trabalhar com os passes da Carteira do Google

Depois que os pré-requisitos estiverem prontos, siga este fluxo:

1. Configure a Carteira do Google no Pushwoosh

   Peça à sua equipe de desenvolvedores para conectar a Carteira do Google ao seu aplicativo no Pushwoosh.

   Como configurar a Carteira do Google

2. Crie o passe

   Abra o construtor de passes em Campaigns → Wallet Passes, escolha um tipo de passe, adicione sua marca e campos e verifique a visualização ao vivo.

   Crie passes da Carteira do Google no construtor de passes

3. Crie o passe

   Quando o passe estiver com a aparência correta, clique em Gerar no construtor de passes.

4. Envie o passe para os usuários

   Compartilhe o link para salvar ou um código QR de Todos os passes. Consulte Compartilhar o passe com os usuários através dos canais do Pushwoosh. Para enviar um passe para cada usuário em escala, sua equipe de desenvolvedores pode usar a API da Carteira do Google.

5. Atualize o passe

   Em Todos os passes, clique em Editar no passe ou atualize-o através da API da Carteira do Google. Ao salvar, o Google entrega a atualização para todos os dispositivos que salvaram o passe. Os usuários não precisam salvá-lo novamente.

6. Envie mensagens aos portadores de passes

   Depois que os usuários salvam o passe, você pode alcançá-los com um push único ou uma Customer Journey automatizada.

   Envie mensagens aos portadores de passes da Carteira do Google

Visualizar e gerenciar passes existentes

No Painel de Controle, vá para Campaigns → Wallet Passes e abra a guia Google Wallet. A tabela Todos os passes lista todos os passes do aplicativo, incluindo o nome do passe, o estilo, o User ID ao qual está vinculado, seu estado e quando foi atualizado pela última vez.

Na lista de passes, abra o menu de ações (⋮) para:

• Editar: altere os valores e rótulos dos campos, cores, URLs do logotipo e da imagem principal, código de barras, links, locais e expiração. O tipo de passe permanece bloqueado após a criação. Ao salvar, todos os dispositivos que salvaram o passe recebem a atualização.

Atualizações e notificações de passes

Ao salvar as alterações, o passe é atualizado em todos os dispositivos que o salvaram. Se a opção Notificar sobre campos alterados estiver ativada (por padrão), o Google também envia uma notificação do Android para os portadores.

As notificações são compatíveis com passes de fidelidade, ingresso para evento e voo. O Google gera o texto da notificação automaticamente com base nos campos alterados. Para passes de evento e voo, as notificações só são disparadas se faltarem menos de 3 horas para o horário de início, e o Google as limita a 3 por passe a cada 24 horas.

Para enviar sua própria mensagem aos portadores de passes, consulte Enviar mensagens aos portadores de passes da Carteira do Google.

• Enviar mensagem: abra o compositor de Push Único para enviar mensagens aos portadores de passes. Consulte Enviar mensagens aos portadores de passes da Carteira do Google para ver todas as formas de alcançá-los.
• Código QR: exiba um código QR que codifica o link para salvar o passe. Os usuários o escaneiam para salvar o passe na Carteira do Google e registrar seu dispositivo para atualizações.
• Copiar link de instalação: copie o link para salvar o passe para compartilhar em seus canais de mensagens. Saiba mais.
• Invalidar: defina um passe ativo como inativo. O passe é movido para a seção Passes expirados do usuário na Carteira do Google. O registro permanece no Pushwoosh.
• Ativar: defina um passe inativo de volta para ativo. Esta opção aparece no menu de ações apenas quando o passe está inativo. Restaura o passe na Carteira do Google.
• Excluir: invalide o passe no Google e remova seu registro no Pushwoosh. O Google não permite a remoção forçada de um passe já salvo em um dispositivo. Ele se torna inválido e é movido para Passes expirados.

Compartilhar o passe com os usuários através dos canais do Pushwoosh

O link Adicionar à Carteira do Google é uma URL regular (https://pay.google.com/gp/v/save/...). Abri-lo em um dispositivo solicita que o usuário salve o passe na Carteira do Google. Você pode usar este link nos mesmos canais do Pushwoosh que já utiliza para alcançar seu público:

• E-mail: adicione o link a um botão ou link de texto no editor de e-mail, por exemplo, uma chamada para ação “Adicionar à Carteira do Google”.
• Notificações push: defina o link como a ação de abertura da notificação para que um toque abra o passe.
• SMS: inclua o link no conteúdo do SMS.

Gerenciar passes via API

Tudo o que o construtor de passes faz também está disponível programaticamente através da API da Carteira do Google: criar, atualizar, listar, obter um link para salvar, definir o estado e excluir passes.

API da Carteira do Google

Visualizar portadores de passes no User Explorer

Quando um usuário salva seu passe, ele aparece no User Explorer como um dispositivo na plataforma Carteira do Google. Abra um usuário e verifique seus dispositivos para confirmar que ele possui um passe e veja os detalhes vinculados:

• Plataforma: o dispositivo é listado como Carteira do Google.
• HWID: o ID do objeto do passe.
• Tags: as tags do usuário e do dispositivo, incluindo quaisquer que você tenha definido ao emitir o passe.