Contexto
A integração da Carteira do Google aos seus sistemas de reserva de voos pode melhorar significativamente a experiência do cliente, verificando se todas as informações de embarque estão acessíveis. 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 no campo "ticketToken".
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 embarque na Carteira.
Importar informações de cartão de embarque de e-mails para melhorar a integração com a Carteira do Google
O recurso de cartão importado do Gmail é um mecanismo simples para digitalizar os cartões de embarque dos usuários na Carteira do Google. 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 ao produto da API Carteira do Google. Os cartões importados do Gmail oferecem as informações mais básicas para os usuários:
| Cartão importado do Gmail | Integração com a API Google Wallet |
|---|---|
|
|
Nosso objetivo é aumentar e complementar a adoção do cartão digital da sua companhia aérea e equipar os usuários que não clicaram no botão "Adicionar à Carteira do Google" com um cartão de embarque automático gerado pelos e-mails que você envia a eles.
Opção 1: corpo do e-mail
Incluir informações relevantes no corpo do e-mail pode fazer com que ele seja detectado e extraído automaticamente.
Campos obrigatórios (em texto simples)
Para ativar a detecção automática, inclua os seguintes campos de forma clara no corpo ou nos anexos do e-mail:
- Informações do passageiro:
- Nome do passageiro (por exemplo, "JOHN DOE")
- Informações do voo
- Referência da reserva ou número do tíquete
- Aeroporto de partida (por exemplo, código IATA de Los Angeles como "LAX")
- Data e hora de partida
- Aeroporto de chegada (por exemplo, código IATA, como Los Angeles, que é "LAX")
- Data e hora de chegada
- Número do voo
- Número do assento
- Portão de embarque
- QR code do cartão de embarque:uma imagem in-line ou um anexo de imagem do QR code do cartão de embarque. O tipo de QR code preferido é QR_CODE ou PDF417. O tipo MIME de imagem preferido é PNG e JPG.
Campos opcionais
Também é possível gerar cartões de fidelidade com base nas informações do cartão de embarque para melhorar a experiência do usuário. Para ativar a detecção automática, inclua os seguintes campos de forma clara no corpo do e-mail:
- Nome do comerciante (por exemplo, "ABC Airline")
- ID do programa de milhagem (por exemplo, "1234567890")
- Nome do programa de fidelidade da companhia aérea ou de milhagem (por exemplo, "Mileage Plus Rewards")
Confira mais detalhes na página de instruções do Loyalty (link para a página da Web do Loyalty).
Confira um exemplo de e-mail (por exemplo, um e-mail com cartão de embarque)
|
|---|
Aqui está o cartão de embarque relacionado na Carteira do Google
Integrar à Carteira do Google
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 Campos obrigatórios estão claramente presentes no corpo do e-mail.
2. Encaminhe um exemplo de e-mail para nosso parser-sample+wallet_partner_boardingpass@google.com
- Para atualizações nos modelos de e-mail, encaminhe para o mesmo endereço parser-sample+wallet_partner_boardingpass@google.com para que o Gmail detecte os modelos 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 pode receber mensagens.
Opção 2: microdados do Gmail
Uma chave para alcançar essa integração perfeita é o uso de marcação estruturada nos e-mails enviados aos clientes, principalmente no campo ticketToken.
Por que usar a marcação de incorporação?
A incorporação de marcação nos e-mails de confirmação de voo permite que os detalhes da reserva 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 o voo.
Campo-chave: ticketToken
O campo ticketToken é crucial porque geralmente contém um tipo de código seguro e um valor bruto que pode ser renderizado diretamente como um código legível. Esse campo garante que todas as informações necessárias para o embarque estejam disponíveis instantaneamente na Carteira do Google do cliente. Além disso, o valor bruto precisa estar em conformidade com o
BCBP
(Bar Coded Boarding Pass). É possível usar um decodificador
para decodificar o valor do token. O comerciante precisa garantir que o valor em JSON seja
consistente com o valor decodificado.
Confira alguns tipos de código compatíveis:
- barcode128
- pdf417
- qrCode
- aztecCode
Confira alguns exemplos de ticketTokens válidos:
barcode128:M1HANFENG/ZHU EMWLPJ SFOAUSGG 123 350J25A 614a 10A1973966772
pdf417:M1HANFENG/ZHU EMWLPJ SFOAUSGG 123 350J25A 614a 10A1973966772
qrCode:M1HANFENG/ZHU EMWLPJ SFOAUSGG 123 350J25A 614a 10A1973966772
aztecCode:M1HANFENG/ZHU EMWLPJ SFOAUSGG 123 350J25A 614a 10A1973966772
Veja como estruturar a marcação de e-mail:
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "FlightReservation",
"reservationNumber": "RXJ34P",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "HANFENG/ZHU"
},
"reservationFor": {
"@type": "Flight",
"flightNumber": "123",
"airline": {
"@type": "Airline",
"name": "United",
"iataCode": "GG"
},
"departureAirport": {
"@type": "Airport",
"name": "San Francisco Airport",
"iataCode": "SFO"
},
"departureTime": "2027-03-04T20:15:00-08:00",
"arrivalAirport": {
"@type": "Airport",
"name": "Austin-Bergstorm International Airport",
"iataCode": "AUS"
},
"arrivalTime": "2027-03-05T06:30:00-05:00"
},
"airplaneSeat": "9A",
"airplaneSeatClass": {
"@type": "AirplaneSeatClass",
"name": "Business"
},
"ticketToken": "qrCode:M1HANFENG/ZHU EMWLPJ SFOAUSGG 123 350J25A 614a 10A1973966772"
}
</script>