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 Control Panel, envia-o aos 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

• Criar passes no construtor de passes
• Compartilhar o link de salvamento ou o código QR com os usuários
• Atualizar os passes a qualquer momento. O Google sincroniza as alterações em todos os dispositivos salvos
• Emitir um design de passe para muitos usuários e atualizar campos compartilhados em todos os passes emitidos de um só lugar. Consulte Criar Campanhas de Passes da Carteira
• Enviar mensagens aos portadores de passes com um push único, notificação de atualização de passe ou uma Customer Journey

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 em vigor, 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 design do 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.

   Criar 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 de salvamento 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.

   Enviar mensagens aos portadores de passes da Carteira do Google

Visualizar e gerenciar passes existentes

No Control Panel, vá para Campaigns → Wallet Passes e abra a aba Google Wallet. A tabela Todos os passes lista todos os passes do aplicativo, incluindo o nome do passe, 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: alterar valores e rótulos de campos, cores, URLs de logotipo e 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 Notificar sobre campos alterados estiver ativado (por padrão), o Google também envia uma notificação do Android para os portadores.

As notificações são suportadas para passes de fidelidade, ingresso de 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 todas as formas de alcançá-los.
• Código QR: mostre um código QR que codifica o link de salvamento do 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 de salvamento do 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 é um 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á usa 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 de salvamento, definir estado e excluir passes.

API da Carteira do Google

Visualizar portadores de passes no User Explorer

Quando um usuário salva seu passe, o Pushwoosh o lista na aba Dispositivos e plataformas no User Explorer.

1. Vá para Audience → User Explorer e abra o perfil do usuário.
2. Abra a aba Dispositivos e plataformas.
3. Selecione Google Wallet na barra lateral.

No perfil da plataforma, você pode revisar:

• Status da inscrição: por exemplo, INSCRITO
• Identificador da plataforma: o identificador do passe exibido sob o nome da plataforma
• Metadados: Primeira inscrição, Fuso horário e outros campos quando disponíveis
• Tags: tags da plataforma, incluindo quaisquer que você tenha definido ao emitir o passe

Saiba mais