Primeros pasos con los pases de Apple Wallet

Los pases de Apple Wallet son tarjetas digitales, como tarjetas de fidelización, cupones, entradas para eventos, tarjetas de embarque y tarjetas de tiendas, que sus usuarios guardan en la aplicación Wallet en iPhone y Apple Watch. Con Pushwoosh, puede diseñar un pase visualmente en el Control Panel, compartirlo y luego enviar actualizaciones en cualquier momento sin pedir a los usuarios que reinstalen nada.

Cuando cambia un pase, Pushwoosh notifica a cada dispositivo que lo agregó, y iOS obtiene silenciosamente la nueva versión. El código de barras, el saldo, el número de puerta o la fecha de caducidad en el teléfono del usuario se actualizan por sí solos.

Qué puede hacer con los pases de Apple Wallet

Con los pases de Apple Wallet en Pushwoosh, puede:

• Diseñar pases visualmente con colores, campos, logotipo, imagen de banda y código de barras, sin escribir pass.json a mano.
• Crear tarjetas de fidelización, cupones, entradas para eventos, tarjetas de embarque y tarjetas de tienda genéricas.
• Distribuir pases a los usuarios como un archivo .pkpass, un enlace de instalación o un código QR.
• Actualizar el contenido del pase y entregar los cambios a los dispositivos que agregaron el pase.
• Llegar a los titulares de pases con una notificación push única, una actualización de pase o un Customer Journey. Consulte Enviar mensajes a los titulares de pases de Apple Wallet.

Requisitos previos

Se necesita la ayuda de un desarrollador

La emisión de pases de Apple Wallet requiere una cuenta de desarrollador de Apple y certificados de firma. Comparta esta sección con su equipo de desarrolladores para completar la configuración única.

Antes de diseñar su primer pase, confirme lo siguiente:

• Programa de Desarrolladores de Apple: Necesita una membresía activa para registrar los ID de tipo de pase y crear certificados de firma. Inscríbase o gestione su cuenta
• Plataforma iOS: Su aplicación debe tener iOS conectado en Pushwoosh antes de poder agregar un certificado de firma de pase. Configurar iOS

Empezar a trabajar con los pases de Apple Wallet

Una vez que los requisitos previos estén listos, siga este flujo:

1. Configurar los pases de Wallet en Pushwoosh

   Antes de que pueda diseñar pases, Pushwoosh debe tener su certificado de firma de Apple para la aplicación. Su equipo de desarrolladores lo crea en Apple Developer y lo sube a Pushwoosh. Esta es una configuración única por aplicación.

   Cómo configurar el certificado de firma

2. Diseñar el pase

   En el creador de pases, elija un estilo de pase, establezca los campos y la marca, y compruebe la vista previa en vivo.

3. Generar un .pkpass firmado

   Una vez que cree y valide el pase, en el creador de pases, seleccione Generar. Pushwoosh prepara las imágenes en las resoluciones requeridas y firma el archivo con su certificado.

4. Distribuir el pase

   Envíe a los usuarios el archivo .pkpass, el enlace de instalación o el código QR. Consulte Compartir el pase con los usuarios a través de los canales de Pushwoosh. Cuando los usuarios agregan el pase a Wallet, su dispositivo se registra para futuras actualizaciones.

5. Actualizar el contenido del pase

   Edite el pase en el creador de pases o a través de la API y guarde. Pushwoosh notifica a los dispositivos registrados, y iOS descarga la nueva versión en segundo plano. Los usuarios no necesitan reinstalar el pase.

6. Enviar mensajes a los titulares de pases

   Una vez que los usuarios agregan el pase a Wallet, puede llegar a ellos con una notificación push única, una actualización de pase o un Customer Journey automatizado.

   Enviar mensajes a los titulares de pases de Apple Wallet

Ver y gestionar pases existentes

En el Control Panel, vaya a Campañas → Pases de Wallet y abra la pestaña Apple Wallet. La tabla Todos los pases lista cada pase para la aplicación, incluyendo su nombre, estilo, el User ID con el que está asociado, y la fecha y hora en que fue actualizado por última vez.

En la lista de pases, abra el menú de acciones (⋮) para:

• Editar: cambiar el nombre y la descripción del pase, los valores y etiquetas de los campos, cambiar mensajes, colores, mensaje del código de barras, caducidad y estado, y ubicaciones. El estilo y las imágenes del pase permanecen bloqueados después de la creación. Cuando guarda, cada dispositivo que agregó el pase recibe la actualización.

Las actualizaciones se entregan como notificaciones push silenciosas

Cuando guarda un cambio, Pushwoosh vuelve a firmar el pase y notifica a cada dispositivo registrado con una notificación push sin contenido. iOS obtiene la nueva versión por sí solo, no se requiere reinstalación.

• Descargar: descargar el archivo .pkpass firmado.
• Código QR: mostrar un código QR de instalación que los usuarios pueden escanear para agregar el pase a Wallet y registrar su dispositivo para recibir actualizaciones. En esta ventana, también puede usar Copiar enlace de instalación debajo del QR.
• Copiar enlace de instalación: copiar la URL de instalación para compartir el pase en sus canales de mensajería. Más información.
• Enviar mensaje: abrir el compositor de notificaciones push únicas para enviar mensajes a los titulares de pases. Cuando lo abre desde la lista, se dirige al propietario del pase por User ID. Consulte Enviar mensajes a los titulares de pases de Apple Wallet para conocer todas las formas de llegar a ellos.
• Eliminar: eliminar el pase. Las copias ya instaladas en los dispositivos dejan de recibir actualizaciones y se invalidan en su próxima actualización.

Compartir el pase con los usuarios a través de los canales de Pushwoosh

El enlace de instalación que copia en el creador (Copiar enlace de instalación) es una URL normal. Abrirlo en un iPhone agrega el pase a Apple Wallet. Puede usar este enlace en los mismos canales de Pushwoosh que ya utiliza para llegar a su audiencia:

• Correo electrónico: agregue el enlace a un botón o enlace de texto en el editor de correo electrónico, por ejemplo, una llamada a la acción “Agregar a Apple Wallet”.
• Notificaciones push: establezca el enlace como la acción de apertura de la notificación para que un toque abra el pase.
• SMS: incluya el enlace en el contenido del SMS.

Un enlace por pase

Cada enlace de instalación está vinculado a un único pase (lleva el número de serie y el token de ese pase), por lo que un enlace funciona para un pase compartido, lo cual es útil para un cupón o una entrada de evento común. Para dar a cada destinatario su propio pase, genere un pase por usuario con la API PassKit y envíe a cada usuario su propio enlace. Los pases de Wallet se instalan solo en dispositivos Apple: iPhone y Apple Watch.

Gestionar pases a través de la API

Todo lo que hace el creador de pases también está disponible programáticamente a través de la API PassKit Designer: crear, actualizar, listar, descargar y eliminar pases.

API PassKit de Apple Wallet

Ver a los titulares de pases en User Explorer

Cuando un usuario agrega su pase a Wallet, Pushwoosh lo lista en la pestaña Dispositivos y plataformas en User Explorer.

1. Vaya a Audiencia → User Explorer y abra el perfil del usuario.
2. Abra la pestaña Dispositivos y plataformas.
3. Seleccione Apple Wallet en la barra lateral.

En el perfil de la plataforma, puede revisar:

• Estado de la suscripción: por ejemplo, SUBSCRIBED
• Identificador de la plataforma: el identificador del pase que se muestra bajo el nombre de la plataforma
• Metadatos: Primera suscripción, Zona horaria y otros campos cuando estén disponibles
• Tags: tags de la plataforma, incluyendo cualquiera que haya establecido al emitir el pase

Más información