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 incorporado en Seleccionar plantilla (pase de abordar, cupón, boleto de evento, genérico o tarjeta de tienda) y confirme. El formulario rellena previamente el estilo del pase, los colores, las imágenes, los campos del pase, el código de barras y la 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.

Elija 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:

• Pase de abordar
• Cupón
• Boleto de evento
• Tarjeta de tienda
• Genérico

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

Añada el nombre y la 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 logo	Texto que se muestra junto al logo (se usa cuando no se ha subido ninguna imagen de logo).

Establezca colores e imágenes

Colores

En COLORES, establezca:

• Color de fondo: el fondo del pase.
• Color de primer plano: texto principal e íconos en el pase.
• Color de la 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, suba el Ícono y el Logo (ambos requeridos). Las imágenes opcionales dependen del estilo del pase.

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

Rellene los campos del pase

En CAMPOS DEL PASE, añada el texto y los valores que aparecen en el pase. Los grupos que vea dependen del estilo del pase:

• Campos de encabezado (parte superior del pase): Pase de abordar, Boleto 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): convierta números de teléfono, enlaces, direcciones y eventos de calendario en contenido pulsable en los campos posteriores.

Añada 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 pases de abordar de aerolíneas o de tránsito.
   • Aztec: código cuadrado compacto, similar al QR. Común en boletos 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 boleto o de membresía).
3. Texto alternativo (opcional): texto que se muestra debajo del código de barras en el pase.

Establezca el vencimiento y el estado

En VENCIMIENTO Y ESTADO, controle cuándo se muestra el pase, cuándo vence y si todavía es 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 vencimiento (cuándo vence 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 se pueda usar.

Opciones específicas de estilo y avanzadas

• Tipo de tránsito (solo Pase de abordar): Aéreo, Tren, Autobús, Barco o Genérico.
• Identificador de agrupación: agrupe 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 añade. Para cada ubicación, establezca el texto que se muestra en la pantalla de bloqueo cuando el usuario está cerca. Puede añadir hasta 10 ubicaciones.

Haga clic en el mapa, busque una dirección, pegue coordenadas o importe una geozona para añadir 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 ubicació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 minorista: 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: un boleto 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: un pase de abordar 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.

Ingrese un ID de Usuario

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

Previsualice y valide

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.

Genere 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 Gestionar pases existentes.

Gestione 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 PassKit: crear, actualizar, listar, descargar y eliminar pases.

API PassKit de Apple Wallet