Emitir Passe da Wallet

O elemento Emitir Passe da Wallet cria um passe da Apple Wallet ou Google Wallet para um usuário a partir de uma Campanha de Passe da Wallet. Após sua execução, você pode inserir o link de instalação ou salvamento em uma mensagem posterior na mesma Journey.

Nota

Este elemento apenas emite o passe. Ele não o entrega ao usuário. Adicione um elemento Enviar Push ou Enviar E-mail após ele para enviar o link de instalação. Consulte Entregar o passe ao usuário abaixo.

Exemplos de casos de uso

Cartão de embarque após o check-in

Emita um cartão de embarque da Apple ou Google Wallet assim que um usuário fizer o check-in. Personalize o assento e o portão a partir do evento de check-in e, em seguida, envie o link de instalação por push antes da partida.

• Gatilho: CheckInCompleted
• Campos pessoais: mapeie Assento e Portão para os atributos de evento correspondentes
• Entrega: Enviar Push com apple_install_link ou google_save_link

Cartão de fidelidade no cadastro

Emita um cartão de fidelidade na primeira vez que um usuário se inscreve em um programa de recompensas. Personalize-o com o saldo de pontos inicial.

• Gatilho: LoyaltySignup
• Campos pessoais: mapeie Pontos para o atributo points do evento
• Entrega: Enviar E-mail logo em seguida, com o link de salvamento na mensagem de boas-vindas

Ingresso do evento após a compra

Emita um ingresso assim que um usuário concluir a compra de um ingresso. Personalize o assento ou a fileira a partir do pedido.

• Gatilho: TicketPurchased
• Campos pessoais: mapeie Assento e Fileira para os atributos do pedido
• Entrega: e-mail de confirmação com apple_install_link para que o usuário possa adicionar o ingresso com um toque

Pré-requisitos

Antes de adicionar este elemento:

• Campanha de Passe da Wallet: crie pelo menos uma Campanha de Passe da Wallet para a aplicação. O Emitir Passe da Wallet só pode emitir passes de uma campanha existente. Ele não pode criar uma.
• Apple Wallet: conecte a plataforma iOS e conclua a configuração do passe da Apple Wallet para a aplicação. Consulte também Primeiros passos com os passes da Apple Wallet.
• Google Wallet: configure a Google Wallet para Android para a aplicação. Consulte também Primeiros passos com os passes da Google Wallet.

Pré-requisitos completos da campanha para ambas as plataformas: Pré-requisitos das Campanhas de Passe da Wallet.

Adicionar o elemento

1. Arraste o elemento Emitir Passe da Wallet para a tela após a etapa que deve acionar a emissão.
2. Clique duas vezes no elemento para abrir suas configurações.
3. Insira um nome reconhecível em Nome da Etapa, por exemplo, Cartão de fidelidade. Você usará este nome mais tarde ao inserir o link do passe em um elemento Enviar Push ou Enviar E-mail.
4. Em Campanha da Apple Wallet e Campanha da Google Wallet, selecione uma campanha para uma das plataformas, ou para ambas. Cada menu suspenso aceita uma campanha. Deixe um menu suspenso vazio para pular essa plataforma.

Dica

Selecionar ambas as plataformas permite que a mesma etapa da Journey cubra usuários de iPhone e Android de uma só vez. Cada plataforma emite (ou reutiliza, veja Entradas repetidas e condições de abandono abaixo) seu próprio passe de forma independente para o mesmo usuário.

Ambos os menus suspensos listam apenas as campanhas desta aplicação para a plataforma correspondente, já excluindo as arquivadas.

Nota

Uma campanha em Rascunho ainda é listada e emite passes exatamente como uma Ativa, então tirar uma campanha do Rascunho não é um pré-requisito aqui.

Preencher campos pessoais

Em Campos pessoais no passe, defina um valor para cada campo que aparece.

A lista permanece vazia até que você selecione uma campanha acima. Em seguida, ela mostra os campos Pessoais daquela campanha, os mesmos que você preenche na caixa de diálogo Emitir passe da campanha. Se você trocar de campanha, a lista é atualizada para corresponder.

Para cada campo, abra o menu suspenso de valor e escolha uma das seguintes opções:

• Valor estático: digite um valor para cada usuário que chega a este elemento. Por exemplo, digite SUMMER2026 em um campo OFERTA para que cada passe que este elemento emite tenha o mesmo código promocional.

• Um evento anterior no caminho do usuário pela Journey. Em seguida, escolha um Atributo para extrair o valor do campo. Por exemplo, escolha o evento de entrada e seu atributo offer_code para preencher o campo OFERTA com o valor próprio de cada usuário, em vez de um valor para todos. A Pushwoosh lê esse atributo dos dados de evento do próprio usuário quando este elemento é executado, para que o passe de cada usuário receba seu próprio valor.

Nota

Dois tipos de campos não são listados aqui, porque não precisam de sua entrada:

• Um campo escrito apenas como {Seat} se preenche automaticamente para cada usuário.
• Os campos Compartilhados da campanha carregam o mesmo valor em cada passe. Você define esse valor uma vez, na própria campanha.

Com campanhas selecionadas para ambas as plataformas, a lista mostra campos de ambas. Um campo que apenas uma campanha possui é preenchido apenas para o passe daquela plataforma.

Nota

Se o evento de origem nunca foi disparado para um usuário, ou se o atributo estiver vazio, o passe usa o valor próprio da campanha para aquele campo, definido em Definir campos compartilhados e pessoais. O usuário não é abandonado.

Quando terminar, clique em Aplicar para salvar as configurações do elemento.

Entradas repetidas e condições de abandono

Se o mesmo usuário chegar a este elemento novamente, por exemplo, após um loop na Journey, a Pushwoosh retorna o passe já emitido para ele em vez de criar um novo. Cada usuário possui no máximo um passe por campanha.

O Emitir Passe da Wallet abandona o usuário, sem nova tentativa automática, em dois casos:

• O usuário não tem nenhum User ID, nem mesmo o HWID de dispositivo padrão que uma sessão normal do SDK define automaticamente. Isso acontece quando um usuário entra na Journey sem um, por exemplo, através de uma entrada baseada em API ou de um payload de evento que não possui um campo de User ID.
• A emissão do passe falhou para uma campanha configurada, por exemplo, porque foi excluída ou arquivada depois que você adicionou o elemento. Quando ambas as plataformas estão configuradas, a tentativa é feita primeiro com a Apple. Se falhar, o usuário é abandonado antes mesmo da tentativa com o Google, então um resultado parcial nunca acontece.

Consulte Sem User ID e Falha na emissão do passe para saber o que verificar.

Entregar o passe ao usuário

Ao personalizar um push ou e-mail posterior, você pode extrair valores desta etapa Emitir Passe da Wallet pelo Nome da Etapa que você deu a ela. Estes são os atributos que você pode inserir:

Atributo	Plataforma	Contém
apple_install_link	Apple Wallet	URL para instalar o passe
google_save_link	Google Wallet	URL para salvar o passe

Apenas o atributo para a(s) plataforma(s) que você configurou no elemento está disponível.

Cuidado

O elemento emite um passe apenas para a(s) plataforma(s) que você configurou, não com base no dispositivo real do usuário. Um usuário na outra plataforma ainda avança para a saída padrão, apenas com um link que não pode usar. Configure tanto a Apple Wallet quanto a Google Wallet se seu público usar ambas as plataformas.

1. Adicione um elemento Enviar Push ou Enviar E-mail após o Emitir Passe da Wallet.
2. No corpo da mensagem, digite o placeholder do link de instalação com barras verticais, por exemplo, {apple_install_link|regular|}. Não use um {apple_install_link} simples. Consulte Conteúdo Dinâmico ou Templates Liquid para a sintaxe completa.
3. Ative Personalizar mensagem com atributos de evento.
4. Na tabela, marque a caixa Sobrescrever placeholder ao lado do seu placeholder. Seus menus suspensos Evento de origem e Atributo dinâmico permanecem desativados até que você faça isso.
5. Em Evento de origem, escolha sua etapa Emitir Passe da Wallet pelo Nome da Etapa que você deu a ela, por exemplo, Cartão de fidelidade.
6. Em Atributo dinâmico, escolha apple_install_link ou google_save_link para corresponder ao placeholder que você usou.

Nota

Para Enviar Push, selecione novamente a predefinição após editar a mensagem para que o mapeamento reconheça o novo placeholder. Para Enviar E-mail, um placeholder com barras verticais também funciona na linha de assunto, não apenas no corpo da mensagem.

Cada passe emitido também tem um número de série (apple_serial_number ou google_serial_number no contexto do ponto). Passe-o para seus próprios sistemas com um elemento Dados para o aplicativo ou Webhook, por exemplo, para registrá-lo em um CRM ou ferramenta de suporte. Para encontrar o passe correspondente na Pushwoosh pelo seu número de série, use a aba Passes da Campanha de Passe da Wallet ou a API AttachPasses, quando precisar anexar um passe independente a uma campanha.

Cuidado

O painel do elemento mostra entradas e abandonos, incluindo por que um usuário foi abandonado: Sem User ID ou Falha na emissão do passe. Para saber quantos passes foram realmente emitidos, verifique as estatísticas do elemento Enviar Push ou Enviar E-mail subsequente.

Cenário de exemplo: oferta de fidelidade de cafeteria

Uma cafeteria quer dar as boas-vindas a cada novo membro do programa de fidelidade com um passe de desconto que eles podem adicionar à carteira do celular.

1. Crie o evento CoffeeClubJoined e certifique-se de que ele inclua um atributo para a oferta de boas-vindas, por exemplo, offer_code. Saiba mais sobre a criação de eventos
2. Defina este evento como o gatilho para a Journey, para que cada novo membro entre assim que se inscrever.

3. Adicione o Emitir Passe da Wallet após o gatilho.
4. Dê o nome de Cartão de fidelidade.
5. Selecione a campanha de fidelidade, por exemplo, Desconto Café, para a Campanha da Apple Wallet (e também para a Campanha da Google Wallet, se você oferecer suporte ao Android).
6. Em Campos pessoais no passe, defina OFERTA para o evento de entrada do gatilho.
7. Escolha offer_code como o Atributo.

8. Adicione um elemento Enviar E-mail logo após o Emitir Passe da Wallet.
9. Personalize-o com apple_install_link (ou google_save_link) para que o e-mail de boas-vindas inclua um link de um toque para adicionar o passe.

Quando o CoffeeClubJoined é disparado, o usuário entra na Journey, o Emitir Passe da Wallet emite seu passe com o offer_code desse evento, e o Enviar E-mail envia a mensagem de boas-vindas com o link para adicioná-lo.