Importar cartões de fidelidade de e-mails de associação

A integração da Carteira do Google ao seu sistema de associação ajuda você a alcançar os usuários de forma mais eficaz e melhorar a experiência deles. A integração da Carteira do Google com o Gmail permite a criação automática de cartões digitais para usuários que recebem mensagens de e-mail qualificadas.

Para conseguir essa integração perfeita, há duas maneiras: (1) incluir informações relevantes no corpo do e-mail ou (2) usar a marcação estruturada nos e-mails enviados aos clientes, principalmente nos campos membershipNumber e program.

Esta documentação fornece as informações necessárias para incluir na próxima campanha de e-mail / CRM para seus usuários e gerar automaticamente cartões de fidelidade na Carteira.

Importar cartões de fidelidade de e-mails de associação para melhorar a integração com a Carteira do Google

O recurso de cartão importado do Gmail é um mecanismo simples para pegar seus e-mails de fidelidade atuais e convertê-los em cartões na Carteira de um usuário. As informações são extraídas automaticamente do conteúdo do e-mail, minimizando o atrito do usuário e aumentando as taxas de adoção.

Essa solução foi projetada para funcionar de forma complementar às implementações atuais da API Google Wallet. Ela (1) oferece aos usuários um cartão digital utilizável gerado pelas campanhas por e-mail que você envia e (2) serve como um ponto de entrada para mais funcionalidades de reconhecimento e engajamento disponíveis nas nossas integrações abrangentes de API.

Cartão importado do Gmail	Integração com a API Google Wallet
Informações do usuário: ID da participação no programa de fidelidade Nome do comerciante Nome do programa Pontos de fidelidade (com base na origem do e-mail) Capacidade de gerar automaticamente um código QR/de barras se o ID da assinatura estiver presente	Todas as informações do usuário e as informações personalizadas definidas Atualizações dinâmicas das informações do usuário Nível de saldo de pontos mais atualizado QR code/código de barras mais atualizado Notificações push Cartões vinculados automaticamente Oportunidades de valor agregado de passes E mais

Em breve, vamos permitir que os usuários com itens importados do Gmail e o recurso Inscrição no programa de fidelidade ativado façam upgrade para um item integrado à API Wallet.

Opção 1: corpo do e-mail

Quando um usuário recebe um e-mail do seu domínio, como uma mensagem de boas-vindas ou um extrato mensal de fidelidade, o Gmail pode detectar de forma inteligente os campos principais no corpo do e-mail e criar um cartão de fidelidade na Carteira do Google.

Campos obrigatórios (em texto simples)

Para ativar a detecção automática, inclua os seguintes campos de forma clara no corpo do e-mail:

1. Nome do comerciante (por exemplo, "CoffeeShop")
2. ID da assinatura (por exemplo, "1234567890")

Campos opcionais

Você também pode incluir estes campos para melhorar a experiência do usuário:

1. Nome do membro (por exemplo, "João Silva")
2. Pontos de fidelidade (por exemplo, "1.200 pontos")
3. Nome do programa (por exemplo, "Nível Gold", "Clube Premium")
4. Imagem de QR code / código de barras

Confira um exemplo de e-mail (por exemplo, extrato mensal do programa de fidelidade)

Assunto:resumo da sua conta - CoffeeShop Rewards

Olá, João,

Agradecemos por assinar o CoffeeShop Rewards. Aqui está seu extrato de assinatura de junho de 2025:

RESUMO DA CONTA

Nome do membro: João Silva ID do membro: 1234567890 Pontos de fidelidade: 1.200 Nome do programa: Clube Premium

É ótimo ter você com a gente. Para conferir o extrato completo da sua conta, faça login no site do CoffeeShop Rewards.

Atenciosamente,

Equipe da CoffeeShop

Este é o cartão fidelidade relacionado na Carteira do Google

Integrar

1. Crie sua campanha por e-mail: projete e envie campanhas por e-mail para sua base de usuários, verificando se todas as informações necessárias para a geração de passes mencionadas na seção "Como funciona" estão claramente presentes no corpo do e-mail.

2. Encaminhe um exemplo de e-mail para nosso [e-mail]

• Para atualizações nos modelos de e-mail, encaminhe para o mesmo endereço para que o Gmail possa detectar as versões mais recentes.
• Verifique se o remetente original é o remetente real do e-mail das suas campanhas.

3. Depois que recebermos seu modelo de e-mail de exemplo, nossa equipe vai analisar e configurar a lógica de análise. O recurso será lançado com sucesso para o modelo de e-mail enviado em até cinco (5) dias úteis.

Observação:talvez entremos em contato com você usando o e-mail que você enviou. Verifique se o e-mail que você usa para encaminhar a amostra para nós pode receber mensagens.

Opção 2: microdados do Gmail

Uma das chaves para alcançar essa integração perfeita é o uso de marcação estruturada nos e-mails enviados aos clientes, principalmente nos campos membershipNumber e program.

Por que usar a marcação de incorporação?

A incorporação de marcação nos e-mails de registro ou atualização de associação ao programa de fidelidade permite que os detalhes da associação sejam reconhecidos e importados automaticamente para a Carteira do Google do cliente (se o recurso estiver ativado). Esse processo, facilitado por dados estruturados no formato Schema.org, melhora a funcionalidade da Carteira do Google adicionando automaticamente informações relevantes sobre a assinatura.

Exemplo

Dois campos obrigatórios para o cartão de assinatura na Carteira.

• membershipNumber: o identificador exclusivo da associação.
• program/programName: o programa que oferece a assinatura.

Veja como estruturar a marcação de e-mail:

<script type="application/ld+json">
[
{
"@context": "http://schema.org/",
"@type": "ProgramMembership",
   "hostingOrganization":
  {
    "@type": "Organization",
    "legalName": "CoffeeShop"
  },
  "member":
  {
    "@type": "Person",
    "familyName": "Doe",
    "givenName": "John"
  },
  "membershipNumber": "1234567890",
  "programName": "CoffeeShop Rewards"
}
]
</script>