Creador de pases de Apple Wallet

El creador de pases de Apple Wallet es un diseñador visual en el Panel de Control. Usted elige un estilo de pase, completa la marca, los campos y un código de barras, ve una vista previa en vivo y genera el pase, por lo que no necesita escribir pass.json a mano.

Crear un pase

En el Panel de Control, vaya a Campañas → Wallet Passes, abra la pestaña Todos los pases, seleccione Apple Wallet y haga clic en Crear pase.

Pestaña Todos los pases con Apple Wallet seleccionado, la búsqueda y el filtro de campaña, el botón Crear pase y columnas de tabla para el pase, estilo, usuario, campaña y última actualización

Configurar el pase

Desde cero: comience con un pase vacío. Elija un estilo de pase, luego configure los colores, imágenes, campos, código de barras y otras opciones usted mismo en las secciones a continuación.
Desde una plantilla: haga clic en Cargar plantilla, elija un pase predefinido en Seleccionar plantilla (tarjeta de embarque, cupón, entrada de evento, genérico o tarjeta de tienda). La plantilla se aplica en cuanto hace clic en ella. El formulario rellena previamente el estilo del pase, colores, campos del pase, código de barras e información básica, y establece Fecha de relevancia en la hora actual. Las plantillas no incluyen imágenes, así que cargue Icono y Logo antes de generar el pase. Edite cualquier valor o cambie el estilo según sea necesario. Pushwoosh reemplaza los ID de equipo y de tipo de pase de la plantilla con los valores de su aplicación.

Elegir un estilo de pase

En ESTILO DE PASE, elija uno de los cinco estilos de pase de Apple Wallet. El estilo controla el diseño y qué áreas de campo e imágenes están disponibles:

Tarjeta de embarque
Cupón
Entrada de evento
Tarjeta de tienda
Genérico

Elija el estilo antes de agregar campos e imágenes, porque cambiar el estilo borra todos los campos del pase.

Añadir nombre y descripción del pase

En INFORMACIÓN BÁSICA, complete:


Nombre del pase	El título del pase y el nombre de la fuente que se muestra en las notificaciones de actualización.
Descripción	Una breve descripción del pase.
Texto del logotipo	Texto que se muestra junto al logotipo.

Sección de información básica con los campos Nombre del pase, Descripción y Texto del logotipo

Establecer colores e imágenes

Colores

En COLORES, establezca:

Color de fondo: el fondo del pase.
Color de primer plano: texto principal e iconos en el pase.
Color de etiqueta: color de las etiquetas de los campos (por ejemplo, FROM, GATE).

Para establecer o cambiar un color, haga clic en su campo y elija un color en el selector.

Sección de colores con los campos Color de fondo, Color de primer plano y Color de etiqueta

Imágenes

En IMÁGENES, cargue Icono y Logotipo (ambos obligatorios). Las imágenes opcionales dependen del estilo del pase:

Imagen	Tamaño	Disponible para
Icono	29×29	Todos los estilos (obligatoria)
Logo	160×50	Todos los estilos (obligatoria)
Franja	375×144	Cupón, Entrada de evento, Tarjeta de tienda
Fondo	180×220	Entrada de evento
Miniatura	90×90	Entrada de evento, Genérico
Pie	286×15	Tarjeta de embarque

Haga clic en Elegir archivo junto a cada ranura de imagen y cargue un archivo PNG o JPEG. Pushwoosh recorta cada imagen desde el centro al tamaño de la ranura y prepara las resoluciones que Apple requiere (@1x, @2x, @3x).

Rellenar los campos del pase

En CAMPOS DEL PASE, agregue el texto y los valores que aparecen en el pase. Todos los estilos tienen los mismos grupos de campos, con estos límites:

Campos de cabecera (Parte superior del pase): hasta 3
Campos principales (Contenido principal): 1. En una tarjeta de embarque, el grupo se llama Campos principales (Origen/Destino) y contiene 2
Campos secundarios (Información de apoyo): hasta 4
Campos auxiliares (Detalles adicionales): hasta 4, o 5 en una tarjeta de embarque
Campos del reverso (Parte trasera del pase)

Haga clic en + Añadir campo en cada grupo que necesite.

Para cada campo, establezca:


Clave (ID)	Identificador de campo único (generado automáticamente).
Etiqueta	Etiqueta corta en el pase (por ejemplo, `FROM`).
Valor	Valor que se muestra en el pase (por ejemplo, `SFO`).
Mensaje de cambio	Texto en la notificación de actualización cuando este valor cambia. Se muestra solo cuando el valor cambia. Use `%@` para el nuevo valor (por ejemplo, `Puerta cambiada a %@`).

En la tarjeta del campo, haga clic en Formato para mostrar las opciones de formato. Haga clic en X para eliminar el campo.

Opciones de formato

Formato del valor: Texto, Fecha / hora o Número / moneda.
Alineación del texto: Predeterminado (Natural), Izquierda, Centro, Derecha o Natural.
Detectores de datos (solo campos posteriores): convierten números de teléfono, enlaces, direcciones y eventos de calendario en contenido pulsable en los campos posteriores.

Personalizar el contenido del pase

Para mostrar datos únicos del destinatario, como un nombre o un saldo de puntos, inserte un marcador de posición de tag en un campo de texto. El botón { } está disponible en:

Nombre del pase, Descripción y Texto del logotipo
Etiqueta, Valor y mensaje de cambio de un campo
Mensaje del código de barras, Texto alternativo e Identificador de agrupación

Para insertar un marcador de posición:

Haga clic en { } junto al campo de texto.
Elija el tag.
Elija un Formato. Para conocer las opciones, consulte Personaliza el contenido del pase en el creador de Google Wallet, que usa el mismo cuadro de diálogo.
Opcionalmente, introduzca un valor en Valor alternativo (si está vacío).

La vista previa en vivo muestra los valores de los tags del usuario que introduzca en User ID. Sin un User ID, muestra los marcadores de posición.

Añadir un código de barras

En CÓDIGO DE BARRAS, elija un formato e ingrese los datos a codificar:

Formato del código de barras: elija cómo se ve el código de barras y qué tipo de escáner puede leerlo.
- Código QR (recomendado): código cuadrado que la mayoría de los teléfonos y escáneres leen fácilmente. Ideal para cupones, tarjetas de fidelidad y la mayoría de los pases.
- PDF417: código de barras ancho compuesto por varias filas de líneas. A menudo se requiere para tarjetas de embarque de aerolíneas o de tránsito.
- Aztec: código cuadrado compacto, similar al QR. Común en entradas de eventos y de tránsito.
- Code128: código de barras clásico de líneas verticales. Elija este solo si su escáner o sistema POS requiere un código de barras 1D.
Mensaje del código de barras: el valor codificado en el código de barras (por ejemplo, un número de entrada o de membresía).
Texto alternativo (opcional): texto que se muestra debajo del código de barras en el pase.

Sección CÓDIGO DE BARRAS con menú desplegable de formato, campo de mensaje de código de barras y campo de texto alternativo opcional

Establecer caducidad y estado

En CADUCIDAD Y ESTADO, controle cuándo se muestra el pase, cuándo caduca y si sigue siendo válido:

Fecha relevante (cuándo mostrar el pase): fecha y hora en que el pase puede aparecer en la pantalla de bloqueo.
Fecha de caducidad (cuándo caduca el pase): fecha y hora después de la cual el pase aparece atenuado en Wallet.
Marcar como anulado (invalidar este pase): casilla de verificación para invalidar el pase para que ya no sea utilizable.

Sección de caducidad y estado con fecha relevante, fecha de caducidad y casilla de verificación de anulado

Opciones específicas de estilo y avanzadas

Tipo de tránsito (solo Tarjeta de embarque): Aéreo, Tren, Autobús, Barco o Genérico.
Identificador de agrupación: agrupa pases relacionados en Wallet.

Relevancia basada en la ubicación (opcional)

En RELEVANCIA BASADA EN LA UBICACIÓN, el pase aparece cuando el usuario está cerca de las ubicaciones que usted agrega. Para cada ubicación, establezca el texto que se muestra en la pantalla de bloqueo cuando el usuario está cerca. Puede agregar hasta 10 ubicaciones.

Haga clic en el mapa, busque una dirección, pegue coordenadas o importe una geozona para agregar un punto. Arrastre el marcador para ajustar la posición.

Una distancia máxima (en metros) controla qué tan cerca debe estar el usuario para que el pase siga siendo relevante.

Sección de relevancia basada en la ubicación con mapa, lista de ubicaciones, texto de pantalla de bloqueo y campo de distancia máxima

Ejemplos de casos de uso

Venta al por menor: una tarjeta de fidelidad o un cupón aparece cuando el cliente está cerca de su tienda. El texto de la pantalla de bloqueo podría decir que está cerca de la tienda y recordarle que use el pase.
Eventos: una entrada de evento aparece cuando el usuario está cerca del lugar (estadio, teatro o recinto del festival) para que pueda encontrar el pase rápidamente en la entrada.
Viajes: una tarjeta de embarque se vuelve prominente cerca del aeropuerto o terminal de salida, para que el pasajero vea los detalles de la puerta o del vuelo en la pantalla de bloqueo antes de abrir Wallet.
Hostelería: un cupón o pase de membresía puede aparecer cerca de una cafetería u hotel que usted defina.

Relevancia de iBeacon (opcional)

En RELEVANCIA DE IBEACON, el pase aparece cuando el dispositivo está cerca de un transmisor iBeacon físico que emite una señal coincidente. Esto funciona en interiores, donde los servicios de localización basados en mapas no son fiables.

Para agregar una baliza, haga clic en Añadir baliza (hasta 10 en total). Para eliminar una, haga clic en × en su tarjeta.

Para cada baliza, establezca:

Proximity UUID: el identificador de la baliza (por ejemplo, B9407F30-F5F8-466E-AFF9-25556B57FE6D).
Major y Minor (opcional): limitan la coincidencia a un recinto y a una sola baliza. Cada uno es un número de 0 a 65535, y 0 se comporta como vacío. Deje ambos vacíos, o establezca ambos en 0, para que coincida cualquier baliza que emita ese UUID.
Texto relevante: el texto que se muestra en la pantalla de bloqueo cuando el pase se vuelve relevante.

Sección Relevancia de iBeacon con una entrada de baliza que muestra los campos Proximity UUID, Major, Minor y Texto relevante

Ingresar un User ID

Ingrese el User ID de Pushwoosh para la persona que recibirá este pase. Pushwoosh emite el pase a ese usuario y lo lista bajo USUARIO en Todos los pases.

Previsualizar y validar

Una vista previa en vivo se actualiza a medida que edita, para que pueda ver aproximadamente cómo se verá el pase en Wallet.

Para verificar el pase con las especificaciones de Apple sin crearlo, haga clic en Validar pase. El creador marca las imágenes requeridas faltantes y otros problemas.

Generar el pase

Seleccione Generar. Pushwoosh valida el pase y procesa las imágenes. La generación toma unos segundos, después de lo cual el pase aparece en Todos los pases.

Para editar (incluida la actualización por número de serie), descargar y eliminar pases después de la generación, consulte Administrar pases existentes. Para enviar el pase a los usuarios, consulte Compartir pases de Wallet.

Para emitir un mismo diseño a muchos usuarios y actualizar a la vez los campos compartidos en todos los pases emitidos, cree en su lugar una Wallet Pass Campaign. Una campaña usa las mismas secciones de diseño que este creador.

Administrar pases a través de la API

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

API de PassKit de Apple Wallet