OneTrace.pro Central de ajuda

Cartões Wallet

O cartão de fidelidade no Apple Wallet e no Google Wallet fica sempre no celular do cliente: nele aparecem o saldo de pontos, o nível, o cupom válido e o código de barras para o caixa. O OneTrace.pro atualiza o cartão sozinho: depois de um pedido, de um ganho de pontos ou da emissão de um cupom, o cliente vê os novos valores, e o Apple Wallet mostra uma notificação. O cartão também é um canal de mensagens: uma mensagem curta chega como notificação e fica no verso do cartão.

Os cartões Wallet estão disponíveis a partir do plano “Crescimento” (planos). A seção fica no menu Engajamento → Cartões Wallet. As estatísticas e o visual podem ser vistos por “Gerente”, “Observador” e superiores; alterar o visual é permitido para as funções com permissão para gerenciar integrações: “Administrador” e “Proprietário”.

Conexão

Os cartões são emitidos pela sua loja, em nome dela e com as suas próprias chaves da Apple e do Google. Conecte uma das plataformas ou as duas:

  1. Abra Integrações e clique em Adicionar integração → Cartões Wallet (integrações).
  2. Para o Apple Wallet:
    • no Apple Developer, abra Certificates, Identifiers & Profiles → Identifiers e registre um Pass Type ID, por exemplo pass.com.example.loyalty;
    • crie para ele um certificado Pass Type ID Certificate, instale-o em um Mac e exporte-o do “Acesso às Chaves” junto com a chave privada para um arquivo .p12;
    • cole no campo Certificado do Pass Type ID o conteúdo do .p12 em base64 ou o certificado e a chave em PEM e, no campo Senha da chave, a senha da exportação. O certificado intermediário Apple WWDR é adicionado pelo próprio OneTrace.pro.
  3. Para o Google Wallet:
    • no Google Pay & Wallet Console, crie um emissor e copie o Issuer ID;
    • no Google Cloud, ative a Google Wallet API, crie uma conta de serviço e uma chave JSON para ela;
    • adicione o e-mail da conta de serviço ao Google Pay & Wallet Console como usuário do emissor;
    • cole o Issuer ID e a chave JSON na integração.
  4. Clique em Salvar e Testar: para a Apple, o teste mostra o Pass Type ID, a equipe e a validade do certificado; para o Google, que a classe de cartão foi criada.

Enquanto o Google não aprovar o seu emissor para publicação, o cartão do Google só pode ser salvo pelos usuários de teste adicionados no console. O certificado da Apple é emitido por um ano: antes do vencimento, emita um novo e substitua-o na integração; caso contrário, os cartões deixarão de ser atualizados.

Visual do cartão

Abra Cartões Wallet ou clique em Design do cartão na integração. Se houver várias integrações, escolha a desejada no topo.

Campo O que define
Nome no cartão A loja que emite o cartão. Se vazio, o nome da integração
Fundo, Texto, Rótulos As cores do cartão. O Google Wallet usa apenas a cor de fundo e escolhe sozinho a cor do texto
Logotipo Apple: no canto superior esquerdo, no lugar do nome. Envie uma imagem de pelo menos 480×150 pixels
Faixa Apple: imagem larga abaixo do logotipo, atrás dos pontos; Google: cabeçalho do cartão. Cerca de 1125×369 pixels
Ícone Quadrado de pelo menos 660×660 pixels: ícone de notificações da Apple e logotipo do programa no Google Wallet
Código de barras QR code, Code 128, PDF417 ou Aztec: o que o leitor do caixa conseguir ler. O código de barras contém o número do cartão
Campos personalizados Até 4 campos: o rótulo no cartão e um atributo do perfil, por exemplo, “Cidade” — city. Se o perfil não tiver o atributo, o campo também não aparece no cartão dele

As imagens são escolhidas na biblioteca de mídia; para isso, é preciso ter acesso aos modelos de mensagem. Uma imagem usada pelo cartão não pode ser excluída da biblioteca de mídia. À direita fica a Pré-visualização com dados de exemplo; o seletor mostra como o cartão aparece no Apple Wallet e no Google Wallet. A pré-visualização é aproximada: a aparência exata depende do celular.

Clique em Salvar. Os cartões que os clientes já instalaram serão atualizados em alguns minutos.

Visual do cartão com pré-visualização do Apple Wallet

Pré-visualização do cartão no Google Wallet

O que aparece no cartão

  • Pontos e nível: da conta do cliente no programa de fidelidade.
  • Nome: dos atributos first_name e last_name.
  • Cupom: o último cupom pessoal emitido para o cliente e ainda não usado.
  • Número do cartão e código de barras. Se o perfil já tiver um número de cartão de fidelidade (o identificador loyalty_card, por exemplo das vendas nas lojas físicas), o cartão Wallet usa esse mesmo número; caso contrário, o OneTrace.pro emite um novo número de 13 dígitos.
  • Os campos personalizados do visual e a última mensagem: no verso do cartão.

O cartão é atualizado quando mudam os pontos, o nível, o nome, os campos personalizados ou o cupom. O Apple Wallet mostra uma notificação sobre o novo saldo, o nível e o cupom. Se dois perfis forem mesclados em um, os cartões passam para o perfil que permanece.

O cartão é emitido por um link pessoal: uma página no domínio da sua marca com os botões Adicionar à Apple Wallet e Adicionar à Carteira do Google. O primeiro botão é o da plataforma em que a página foi aberta. O link vale por 90 dias, e a página fica no idioma do perfil.

  • Nos e-mails e outras mensagens: a variável {{ wallet_url }} (modelos), por exemplo na jornada de boas-vindas do programa de fidelidade.
  • Na central de preferências: o link Cartão de fidelidade na Carteira.
  • Na área do cliente da loja: a requisição GET /api/v1/profiles/{type}/{value}/wallet com a chave secreta e a permissão “Ler perfis” (chaves de API): o link, a validade dele, as plataformas e os cartões do perfil.

O link aparece quando o projeto tem uma integração “Cartões Wallet” ativada com um certificado da Apple ou uma chave do Google.

Mensagens no cartão

O canal Cartões Wallet funciona nos modelos, nas jornadas e nas campanhas como os outros canais, com variantes A/B e status de entrega. No modelo, há o Título (o rótulo do campo no verso), o Texto e um Link opcional; as variáveis funcionam neles.

  • O Apple Wallet mostra o texto como notificação e o deixa no verso do cartão até a próxima mensagem. A mensagem é entregue quando o celular baixa o cartão atualizado.
  • O Google Wallet adiciona a mensagem ao cartão com uma notificação. O Google mostra no máximo 3 notificações por dia para cada cartão.

A mensagem só chega aos clientes com um cartão desta integração instalado. Se não houver cartão, o envio termina com o erro “O perfil não tem nenhum cartão Wallet instalado”: use uma condição ou um segmento para enviar mensagens pelo Wallet apenas para quem tem o cartão.

Estatísticas

O bloco Estatísticas dos cartões mostra para cada plataforma:

  • Emitidos: quantos cartões foram criados pelos links;
  • Instalados: quantos cartões estão agora no Wallet dos clientes;
  • Removidos: quantos clientes removeram o cartão.

O gráfico abaixo mostra as instalações e remoções por dia nos últimos 30 dias, no fuso horário do projeto.

Estatísticas dos cartões Wallet

Na página do perfil, o bloco Cartões Wallet mostra os cartões do cliente: a plataforma, o número do cartão e a data em que o cartão foi instalado, removido ou emitido sem ser instalado.