Diseñar pases en el creador de pases

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 un archivo .pkpass firmado, sin necesidad de escribir pass.json a mano.

Crear un pase

En el Panel de Control, vaya a Campañas → Apple Wallet y haga clic en Crear pase.

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) y confirme. El formulario rellena previamente el estilo del pase, colores, imágenes, campos del pase, código de barras e información básica. 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

Si comienza desde cero, elija el estilo antes de agregar campos e imágenes. Cambiar el estilo restablece los campos específicos del estilo.

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 (se utiliza cuando no se carga ninguna imagen de 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.

Nota

Los colores se almacenan en formato rgb(r, g, b).

Imágenes

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

Haga clic en Elegir archivo junto a cada ranura de imagen. Cargue archivos PNG o JPEG. Pushwoosh procesa cada imagen en las resoluciones que Apple requiere (@1x, @2x, @3x) cuando genera el pase.

Rellenar los campos del pase

En CAMPOS DEL PASE, agregue el texto y los valores que aparecen en el pase. Los grupos que vea dependerán del estilo del pase:

• Campos de encabezado (parte superior del pase): Tarjeta de embarque, Entrada de evento
• Campos primarios (contenido principal): todos los estilos
• Campos secundarios (información de apoyo): todos los estilos
• Campos auxiliares (detalles adicionales): todos los estilos
• Campos posteriores (reverso del pase): todos los estilos

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 y hora, o Número/moneda.
• Alineación del texto: Predeterminada (Natural), izquierda, centro o derecha.
• 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.

Añadir un código de barras

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

1. 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.
   • Code 128: 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.
2. 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).
3. Texto alternativo (opcional): texto que se muestra debajo del código de barras en el pase.

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.

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.

Ubicaciones vs. balizas

La sección RELEVANCIA BASADA EN LA UBICACIÓN solo configura ubicaciones basadas en mapas. Usted define un lugar y una distancia máxima en metros. El dispositivo utiliza los servicios de localización para decidir cuándo el usuario está lo suficientemente cerca. Wallet puede entonces mostrar el texto de su pantalla de bloqueo para esa ubicación.

PassKit también puede vincular un pase a hardware iBeacon en interiores. Esa opción no está disponible en el creador de pases. Configure las balizas en la API de PassKit cuando su equipo utilice transmisores de balizas.

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.

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.

La vista previa puede diferir en un dispositivo

La vista previa es una aproximación. El pase puede verse diferente en un dispositivo real. El código de barras que se muestra es un marcador de posición. El código de barras real se genera en el archivo .pkpass final.

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, procesa las imágenes y firma el paquete. La generación toma unos segundos, después de lo cual el pase aparece en su lista de pases.

Para editar (incluida la actualización por número de serie), descargar, compartir y eliminar pases después de la generación, consulte Administrar pases existentes.

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