Construtor de passes da Apple Wallet

O construtor de passes da Apple Wallet é um designer visual no Painel de Controle. Você escolhe um estilo de passe, preenche a marca, os campos e um código de barras, assiste a uma prévia ao vivo e gera o passe, então não precisa escrever pass.json manualmente.

Criar um passe

No Painel de Controle, vá para Campanhas → Wallet Passes, abra a aba Todos os passes, selecione Apple Wallet e clique em Criar passe.

Configurar o passe

• Do zero: comece com um passe vazio. Escolha um estilo de passe e, em seguida, defina cores, imagens, campos, código de barras e outras opções você mesmo nas seções abaixo.

• A partir de um modelo: clique em Carregar modelo, escolha um passe integrado em Selecionar Modelo (cartão de embarque, cupom, ingresso de evento, genérico ou cartão de loja). O modelo é aplicado assim que você clica nele. O formulário preenche previamente o estilo do passe, cores, campos do passe, código de barras e informações básicas, e define Data de relevância como o horário atual. Os modelos não incluem imagens, então carregue o Ícone e o Logo antes de gerar o passe. Edite qualquer valor ou altere o estilo conforme necessário. O Pushwoosh substitui os IDs de equipe e Tipo de Passe do modelo pelos valores da sua aplicação.

Escolha um estilo de passe

Em ESTILO DO PASSE, escolha um dos cinco estilos de passe da Apple Wallet. O estilo controla o layout e quais áreas de campo e imagens estão disponíveis:

• Boarding Pass (Cartão de Embarque)
• Coupon (Cupom)
• Event Ticket (Ingresso de Evento)
• Store Card (Cartão de Loja)
• Generic (Genérico)

Escolha o estilo antes de adicionar campos e imagens, porque mudar o estilo apaga todos os campos do passe.

Adicione o nome e a descrição do passe

Em INFORMAÇÕES BÁSICAS, preencha:

Nome do Passe	O título do passe e o nome da fonte exibido nas notificações de atualização.
Descrição	Uma breve descrição do passe.
Texto do Logo	Texto exibido ao lado do logo.

Defina cores e imagens

Cores

Em CORES, defina:

• Cor de Fundo: o fundo do passe.
• Cor do Primeiro Plano: texto principal e ícones no passe.
• Cor do Rótulo: cor dos rótulos dos campos (por exemplo, DE, PORTÃO).

Para definir ou alterar uma cor, clique em seu campo e escolha uma cor no seletor.

Nota

As cores são armazenadas no formato rgb(r, g, b).

Imagens

Em IMAGENS, carregue o Ícone e o Logo (ambos obrigatórios). As imagens opcionais dependem do estilo do passe:

Imagem	Tamanho	Disponível para
Ícone	29×29	Todos os estilos (obrigatória)
Logo	160×50	Todos os estilos (obrigatória)
Faixa	375×144	Cupom, Ingresso de Evento, Cartão de Loja
Fundo	180×220	Ingresso de Evento
Miniatura	90×90	Ingresso de Evento, Genérico
Rodapé	286×15	Cartão de Embarque

Clique em Escolher arquivo ao lado de cada espaço de imagem e carregue um arquivo PNG ou JPEG. O Pushwoosh recorta cada imagem a partir do centro no tamanho do espaço e prepara as resoluções que a Apple exige (@1x, @2x, @3x).

Preencha os campos do passe

Em CAMPOS DO PASSE, adicione o texto e os valores que aparecem no passe. Todos os estilos têm os mesmos grupos de campos, com estes limites:

• Campos do cabeçalho (topo do passe): até 3
• Campos primários (conteúdo principal): 1. Em um cartão de embarque, o grupo se chama Campos primários (origem/destino) e contém 2
• Campos secundários (informações de suporte): até 4
• Campos auxiliares (detalhes extras): até 4, ou 5 em um cartão de embarque
• Campos do verso (lado de trás do passe)

Clique em + Adicionar Campo em cada grupo que você precisar.

Para cada campo, defina:

Chave (ID)	Identificador de campo único (gerado automaticamente).
Rótulo	Rótulo curto no passe (por exemplo, DE).
Valor	Valor exibido no passe (por exemplo, SFO).
Mensagem de alteração	Texto na notificação de atualização quando este valor muda. Exibido apenas quando o valor muda. Use %@ para o novo valor (por exemplo, Portão alterado para %@).

No cartão do campo, clique em Formatar para mostrar as opções de formatação. Clique em X para remover o campo.

Opções de formatação

• Formato do valor: Texto, Data / hora ou Número / moeda.
• Alinhamento do texto: Padrão (Natural), Esquerda, Centro, Direita ou Natural.
• Detectores de dados (apenas campos do verso): transforme números de telefone, links, endereços e eventos de calendário em conteúdo tocável nos campos do verso.

Personalize o conteúdo do passe

Para mostrar dados exclusivos do destinatário, como um nome ou saldo de pontos, insira um placeholder de tag em um campo de texto. O botão { } está disponível em:

• Nome do Passe, Descrição e Texto do Logotipo
• Rótulo, Valor e mensagem de alteração de um campo
• Mensagem do código de barras, Texto alternativo e Identificador de agrupamento

Para inserir um placeholder:

1. Clique em { } ao lado do campo de texto.
2. Escolha a tag.
3. Escolha um Formato. Para ver as opções, consulte Personalize o conteúdo do passe no construtor do Google Wallet, que usa a mesma caixa de diálogo.
4. Opcionalmente, insira um valor em Fallback (se estiver vazio).

A pré-visualização ao vivo mostra os valores das tags do usuário que você inserir em User ID. Sem um User ID, ela mostra os placeholders.

Adicione um código de barras

Em CÓDIGO DE BARRAS, escolha um formato e insira os dados a serem codificados:

1. Formato do Código de Barras: escolha como o código de barras se parece e que tipo de scanner pode lê-lo.
   • QR Code (recomendado): código quadrado que a maioria dos telefones e scanners lê facilmente. Melhor para cupons, cartões de fidelidade e a maioria dos passes.
   • PDF417: código de barras largo feito de várias fileiras de linhas. Frequentemente exigido para cartões de embarque de companhias aéreas ou de trânsito.
   • Aztec: código quadrado compacto, semelhante ao QR. Comum em ingressos de eventos e de trânsito.
   • Code128: código de barras clássico de linhas verticais. Escolha este apenas se o seu scanner ou sistema de ponto de venda exigir um código de barras 1D.
2. Mensagem do Código de Barras: o valor codificado no código de barras (por exemplo, um número de ingresso ou de membro).
3. Texto Alternativo (opcional): texto exibido abaixo do código de barras no passe.

Defina a expiração e o status

Em EXPIRAÇÃO E STATUS, controle quando o passe é exibido, quando expira e se ainda é válido:

• Data Relevante (quando mostrar o passe): data e hora em que o passe pode aparecer na tela de bloqueio.
• Data de Expiração (quando o passe expira): data e hora após as quais o passe fica esmaecido no Wallet.
• Marcar como Anulado (invalidar este passe): caixa de seleção para invalidar o passe para que ele não seja mais utilizável.

Opções específicas de estilo e avançadas

• Tipo de trânsito (apenas Cartão de Embarque): Aéreo, Trem, Ônibus, Barco ou Genérico.
• Identificador de agrupamento: agrupe passes relacionados no Wallet.

Relevância baseada na localização (opcional)

Em RELEVÂNCIA BASEADA NA LOCALIZAÇÃO, o passe aparece quando o usuário está perto dos locais que você adiciona. Para cada local, defina o texto exibido na tela de bloqueio quando o usuário estiver por perto. Você pode adicionar até 10 locais.

Clique no mapa, pesquise um endereço, cole coordenadas ou importe uma geozona para adicionar um ponto. Arraste o marcador para ajustar a posição.

Uma distância máxima (em metros) controla o quão perto o usuário deve estar para que o passe permaneça relevante.

Locais vs. beacons

A seção RELEVÂNCIA BASEADA NA LOCALIZAÇÃO configura apenas locais baseados em mapa. Você define um lugar e uma distância máxima em metros. O dispositivo usa serviços de localização para decidir quando o usuário está perto o suficiente. O Wallet pode então mostrar o texto da sua tela de bloqueio para aquele local.

Para vincular um passe a hardware iBeacon em ambientes internos, use a seção RELEVÂNCIA DE IBEACON abaixo.

Exemplos de casos de uso

• Varejo: um cartão de fidelidade ou cupom aparece quando o cliente está perto da sua loja. O texto da tela de bloqueio pode dizer que ele está perto da loja e lembrá-lo de usar o passe.
• Eventos: um ingresso de evento aparece quando o usuário está perto do local (estádio, teatro ou área do festival) para que ele possa encontrar o passe rapidamente na entrada.
• Viagens: um cartão de embarque se torna proeminente perto do aeroporto ou terminal de partida, para que o passageiro veja os detalhes do portão ou do voo na tela de bloqueio antes de abrir o Wallet.
• Hotelaria: um cupom ou passe de membro pode aparecer perto de um café ou hotel que você definir.

Relevância de iBeacon (opcional)

Em RELEVÂNCIA DE IBEACON, o passe aparece quando o dispositivo está perto de um transmissor iBeacon físico que transmite um sinal correspondente. Isso funciona em ambientes internos, onde os serviços de localização baseados em mapa não são confiáveis.

Para adicionar um beacon, clique em Adicionar beacon (até 10 no total). Para remover um, clique em × no cartão dele.

Para cada beacon, defina:

• Proximity UUID: o identificador do beacon (por exemplo, B9407F30-F5F8-466E-AFF9-25556B57FE6D).
• Major e Minor (opcional): restringem a correspondência a um local e a um único beacon. Cada um é um número de 0 a 65535, e 0 se comporta como vazio. Deixe ambos vazios, ou defina ambos como 0, para corresponder a qualquer beacon que transmita esse UUID.
• Texto Relevante: o texto exibido na tela de bloqueio quando o passe se torna relevante.

Insira um ID de Usuário

Insira o User ID do Pushwoosh para a pessoa que receberá este passe. O Pushwoosh emite o passe para esse usuário e o lista em USUÁRIO em Todos os passes.

Pré-visualize e valide

Uma pré-visualização ao vivo é atualizada conforme você edita, para que você possa ver aproximadamente como o passe ficará no Wallet.

A pré-visualização pode ser diferente em um dispositivo

A pré-visualização é uma aproximação. O passe pode parecer diferente em um dispositivo real. O código de barras mostrado é um marcador de posição. O código de barras real é gerado no .pkpass final.

Para verificar o passe em relação às especificações da Apple sem criá-lo, clique em Validar passe. O construtor sinaliza imagens obrigatórias ausentes e outros problemas.

Gerar o passe

Selecione Gerar. O Pushwoosh valida o passe e processa as imagens. A geração leva alguns segundos, após os quais o passe aparece em Todos os passes.

Para editar (incluindo atualização por número de série), baixar e excluir passes após a geração, consulte Gerenciar passes existentes. Para enviar o passe aos usuários, consulte Compartilhar passes do Wallet.

Para emitir um mesmo design para muitos usuários e atualizar de uma só vez os campos compartilhados em todos os passes emitidos, crie uma Wallet Pass Campaign. Uma campanha usa as mesmas seções de design que este construtor.

Gerenciar passes via API

Tudo o que o construtor de passes faz também está disponível através da API do Designer PassKit: criar, atualizar, listar, baixar e excluir passes.

API PassKit da Apple Wallet