Crear campañas de pases de Wallet

Una campaña de pases de Wallet te permite diseñar una única plantilla de pase de Apple Wallet o Google Wallet, emitirla a múltiples usuarios y gestionar las actualizaciones de forma centralizada.

Tú eliges qué campos son Compartidos (sincronizando los cambios a todos los dispositivos de los usuarios simultáneamente) y cuáles son Personales (preservando valores únicos como nombres, códigos de barras o saldos para cada usuario).

Nota

Una campaña de pases de Wallet no está relacionada con una campaña de Customer Journey o una notificación push. Es una herramienta para gestionar plantillas de pases, su emisión y actualizaciones de pases en tiempo real.

Qué puedes hacer con las campañas de pases de Wallet

• Diseñar un pase en una campaña, en lugar de configurar cada pase a mano en el creador de pases de Apple Wallet o Google Wallet.
• Elegir qué campos se actualizan en todas partes (compartidos) y cuáles se mantienen por pase (personales).
• Ver cuántos pases emitidos afecta una edición de campo antes de guardarla.
• Sobrescribir un campo compartido en un pase y luego devolver el control a la campaña más tarde.
• Adjuntar pases emitidos fuera de una campaña para que comiencen a seguir sus campos compartidos.
• Rastrear las revisiones de la campaña y el estado de entrega de cada actualización.

Prerrequisitos

Una campaña utiliza la misma configuración única que un pase independiente:

Apple Wallet:

• Membresía activa del Programa de Desarrolladores de Apple
• Plataforma iOS conectada a la aplicación
• Certificado de firma de pases subido a Pushwoosh

Google Wallet:

• Cuenta de emisor activa en la Consola de Google Pay y Wallet
• Google Wallet configurado para la aplicación (ID de emisor y clave de cuenta de servicio de Google Cloud)

Crear una campaña

Para comenzar a crear una campaña, ve a Campañas → Pases de Wallet → Campañas y haz clic en Crear campaña.

Establecer detalles de la campaña y plataforma

• Plataforma: selecciona Apple Wallet o Google Wallet en la parte superior de la página. Esta elección es permanente para la campaña.
• Campaña: introduce un Nombre y una Descripción opcional para tu referencia interna. Ninguno de los dos aparece en el pase.
• Formato del pase: en Estilo del pase (Apple) o Tipo de pase (Google), elige el diseño para tu pase:
  • Apple Wallet: Tarjeta de embarque, Cupón, Entrada de evento, Tarjeta de tienda, Genérico. Consulta Elegir un estilo de pase.
  • Google Wallet: Genérico, Oferta, Tarjeta de fidelidad, Entrada de evento, Tarjeta de regalo, Vuelo, Tránsito. Esto no se puede cambiar después de la creación. Consulta Elegir un tipo de pase.

Configurar el diseño y la marca del pase

Configura las secciones estándar del pase:

• Información básica, Colores y Código de barras: establece el título del pase, los colores de fondo y de texto, y el tipo de código de barras. Para obtener una guía detallada sobre cada sección, consulta Diseñar pases en el creador de pases de Apple Wallet o Diseñar pases de Google Wallet en el creador de pases.
• Campos del pase: añade los campos que deben aparecer en la tarjeta (consulta Campos del pase de Apple Wallet o Campos y detalles de Google Wallet).
• Caducidad: establece fechas relevantes y reglas de caducidad (consulta Caducidad de Apple Wallet o Caducidad de Google Wallet).
• Ubicaciones: establece la relevancia basada en la ubicación (consulta Ubicaciones de Apple Wallet o Ubicaciones de Google Wallet).

Consejo

Para Google Wallet, utiliza Quién puede guardar el pase para controlar si el pase está vinculado a una única cuenta de Google, a un único dispositivo o si es accesible para cualquiera con el enlace.

Establecer campos compartidos y personales

En la sección Campos compartidos y personales, configura qué campos se actualizan globalmente en todos los pases y cuáles mantienen valores únicos por usuario. Esto controla lo que sucede cuando editas la campaña más tarde: los campos compartidos se actualizan en cada pase emitido, mientras que los campos personales permanecen sin cambios.

Activa el interruptor Personal para cualquier campo que deba contener valores únicos por usuario.

Tipo de campo	Comportamiento	Ejemplos
Compartido	Impulsado por la campaña. Actualizar este campo sincroniza el nuevo valor con cada pase en los dispositivos de los usuarios.	Fecha del evento, Número de puerta, Dirección de la tienda, Porcentaje de descuento
Personal	Único por usuario. La campaña no sobrescribe estos valores cuando se actualiza.	Nombre de usuario, Número de asiento, ID de membresía, Saldo de puntos

El valor de un campo personal puede incluir un marcador de posición de tag, {tag} o {tag|formato|alternativo} (por ejemplo, {Seat}). Pushwoosh lo rellena a partir del tag del destinatario cuando sirve el pase. Si el destinatario no tiene valor para ese tag, Pushwoosh utiliza el valor alternativo del marcador de posición, o deja el campo en blanco cuando el marcador de posición no tiene ninguno.

• Solo el tag, nada más, como {Seat}: el campo no aparece en el diálogo Emitir pase.
• El tag mezclado con otro texto, como Asiento {Seat}, o sin tag en absoluto: el campo aparece como una entrada editable en el diálogo Emitir pase, prellenado con ese valor. Cualquier tag dentro de él todavía se resuelve por destinatario cuando Pushwoosh sirve el pase.

Consejo

El código de barras de un pase se configura y personaliza en la sección Código de barras. Consulta Código de barras de Apple Wallet o Código de barras de Google Wallet para más detalles.

Subir imágenes de la campaña

1. En la sección Imágenes de la campaña, haz clic en Elegir una imagen junto a una ranura de imagen.
2. Selecciona una imagen existente de tu Almacén de medios o arrastra y suelta un nuevo archivo para subirlo.
3. Repite para cada ranura de imagen disponible:
   • Apple Wallet: Icono, Logotipo, Fondo, Pie de página, Tira y Miniatura (consulta Imágenes de Apple Wallet).
   • Google Wallet: Logotipo e Imagen principal.

Nota

• Las imágenes deben tener menos de 10 MB y 25 megapíxeles.
• Apple Wallet: a diferencia de un pase independiente, donde las imágenes se bloquean después de la creación, una actualización de imagen de campaña llega a cada pase emitido.
• Google Wallet: un pase independiente ya te permite cambiar su logotipo e imagen principal en cualquier momento a través de Editar. Una imagen de campaña funciona de la misma manera, excepto que una edición llega a cada pase emitido a la vez en lugar de solo a uno.

Previsualizar y crear la campaña

1. Comprueba el panel Previsualizar como usuario a la derecha para ver cómo se ve la tarjeta. Puedes introducir un ID de usuario de prueba para previsualizar los campos personalizados.

Consejo

Haz clic en Validar pase para comprobar el diseño con los requisitos de Apple o Google antes de guardar, sin crear la campaña todavía.

2. Haz clic en Crear campaña en la parte inferior de la página.

Pushwoosh crea la campaña en estado Borrador y abre su espacio de trabajo, con las pestañas Diseño, Pases e Historial.

Nota

Crear una campaña solo guarda el diseño del pase y no envía pases a los usuarios. Para distribuir los pases a tu audiencia, procede a Emitir pases a los usuarios.

Emitir pases a los usuarios

Emitir un pase desde la campaña

1. En la pestaña Pases, haz clic en Emitir pase.
2. Introduce el ID de usuario de Pushwoosh del destinatario.

3. Haz clic en Emitir pase para confirmar.

Dependiendo de cómo hayas configurado los Campos personales, el modal los maneja de la siguiente manera:

• Campos editables: aparecen con valores predeterminados que puedes cambiar para este usuario.
• Marcadores de posición de tags (como {Seat}): no aparecen en el diálogo. Pushwoosh los rellena automáticamente a partir de los tags del usuario.

También puedes editar cualquier campo personal en un pase individual en cualquier momento después de la emisión.

Pushwoosh genera el pase a partir del diseño actual de la campaña y lo lista en la pestaña Pases y en la tabla Todos los pases de la aplicación (Apple Wallet o Google Wallet).

Entregar el pase al destinatario

Emitir un pase crea el registro del pase en Pushwoosh. Para entregarlo al dispositivo del usuario, comparte el enlace de instalación:

1. Abre el menú de acciones del pase en la pestaña Pases o en Todos los pases.
2. Selecciona Copiar enlace de instalación o Código QR. Los pases de Apple Wallet también ofrecen Descargar para el archivo .pkpass firmado.
3. Envía el enlace o archivo al destinatario a través de push, correo electrónico, SMS o un Customer Journey. Para emitir un pase y entregar su enlace automáticamente a medida que los viajeros avanzan en un journey, utiliza el elemento Emitir Pase de Wallet en lugar de emitirlo aquí.

Para más formas de distribuir pases, consulta Compartir pases de Apple Wallet o Compartir pases de Google Wallet.

Adjuntar un pase existente a una campaña

Puedes adjuntar pases independientes (creados fuera de cualquier campaña) a una campaña para que comiencen a recibir actualizaciones compartidas.

1. En la pestaña Pases, haz clic en Adjuntar pases.
2. Busca pases por ID de usuario, número de serie o código de barras.
3. Selecciona los pases y confirma.

Una vez adjuntados:

• Los campos compartidos comienzan a seguir la campaña y se actualizan cada vez que cambias la plantilla del pase.
• Los valores personales que ya están en el pase (como detalles del usuario o saldos únicos) se conservan.

Adjuntar pases a través de la API

También puedes adjuntar pases programáticamente utilizando el método de la API AttachPasses (hasta 500 números de serie por solicitud).

Si un pase no se puede adjuntar, la API devuelve la razón específica para ese serial:

• El pase ya está asignado a otra campaña.
• El estilo del pase no coincide con el formato de la campaña.
• Al pase le faltan campos de campaña requeridos.
• El número de serie no existe o pertenece a una plataforma diferente.

Gestionar una campaña existente

Al abrir una campaña creada desde Campañas → Pases de Wallet → Campañas se muestra su estado, contador de revisiones, vista previa del pase en vivo y tres pestañas principales: Diseño, Pases e Historial.

Cambiar el estado de la campaña

Utiliza el estado para rastrear en qué punto se encuentra cada campaña: todavía en diseño, emitiendo pases activamente, o terminada y archivada.

Para cambiar el estado, selecciona una opción del menú desplegable Estado en el encabezado de la campaña. El cambio se guarda inmediatamente sin un paso de confirmación por separado:

• Borrador o Activa: te permite emitir nuevos pases, adjuntar los existentes y enviar actualizaciones de diseño.
• Archivada: pausa la emisión de nuevos pases. No puedes emitir ni adjuntar pases mientras la campaña está archivada, pero los pases emitidos anteriormente continúan funcionando y recibiendo actualizaciones compartidas.

Pestaña Diseño

En la pestaña Diseño, puedes actualizar la plantilla del pase, cambiar colores, modificar campos compartidos y personales, o subir nuevas imágenes de la campaña.

Actualizar el diseño y enviar cambios a los pases

Editar cualquiera de los siguientes elementos y hacer clic en Guardar cambios muestra un diálogo de confirmación que indica cuántos pases emitidos se actualizarán:

• Información básica, colores o tipo de código de barras
• Caducidad o ubicaciones
• Un campo compartido
• Una imagen de la campaña

Confirma la actualización:

• Si ningún pase tiene sobrescrituras: haz clic en Actualizar para enviar los cambios a todos los pases emitidos.
• Si algunos pases tienen sobrescrituras: elige si actualizar solo los pases estándar (preservando las sobrescrituras del usuario) o sobrescribir todos los pases.

Confirmar la actualización incrementa el contador de revisiones de la campaña (por ejemplo, a Revisión 2) y sincroniza automáticamente los cambios con los dispositivos de los usuarios.

Nota

Una edición realizada cuando aún no se han emitido pases se guarda inmediatamente sin un diálogo de confirmación, porque no hay pases existentes que actualizar.

Sobrescribir un campo compartido en un pase individual

Si necesitas personalizar un campo compartido para un usuario específico, edita ese campo directamente en su pase individual (desde la pestaña Pases o Todos los pases):

• Crear una sobrescritura: guardar un valor personalizado en un pase individual desvincula ese campo de las actualizaciones de toda la campaña. Las futuras actualizaciones de la campaña omitirán este pase para ese campo específico.
• Eliminar una sobrescritura: para restaurar el control de la campaña, edita el pase y haz clic en Usar el valor de la campaña junto al campo sobrescrito.

Puedes rastrear qué pases tienen valores personalizados en la pestaña Pases bajo la columna Sobrescrituras.

Pestaña Pases

La pestaña Pases lista cada pase emitido por la campaña, incluyendo su número de serie, ID de usuario del destinatario, sobrescrituras activas, revisión actual y fecha de la última actualización.

Usa los filtros de la tabla para encontrar pases específicos:

• Con sobrescrituras: muestra los pases que tienen al menos un campo editado a medida.
• Detrás de la revisión: muestra los pases que aún no han recibido la última actualización de la campaña.

Para emitir nuevos pases o adjuntar los existentes, consulta Emitir pases a los usuarios.

Abre el menú de acciones de una fila (⋮) para gestionar ese pase:

• Editar: abre el pase en la página de edición de su plataforma para cambiar campos personales o sobrescribir uno compartido.
• Descargar: en las campañas de Apple Wallet, descarga el archivo .pkpass firmado. Las campañas de Google Wallet no muestran esta opción, ya que Google Wallet no tiene un archivo descargable equivalente.
• Enviar mensaje: abre el compositor de push de una sola vez para enviar un mensaje al destinatario del pase por ID de usuario. Consulta Enviar mensajes a los titulares de pases de Wallet para conocer todas las formas de contactarlos.
• Código QR: muestra un código QR de instalación que los usuarios pueden escanear para añadir el pase y registrar su dispositivo para recibir actualizaciones.
• Copiar enlace de instalación: copia la URL de instalación para compartir el pase en tus canales de mensajería.
• Eliminar: elimina el pase. Esto no se puede deshacer. En Apple Wallet, las copias ya instaladas dejan de recibir actualizaciones y se invalidan en su próxima actualización. En Google Wallet, Google no permite forzar la eliminación de un pase ya guardado en un dispositivo, por lo que se invalida y se mueve a los Pases caducados del usuario mientras Pushwoosh elimina su registro. Eliminar un pase aquí no elimina la campaña ni ningún otro pase emitido.

Pestaña Historial

La pestaña Historial lista todas las revisiones de la campaña en orden cronológico, mostrando qué campos se modificaron en cada versión.

El estado de entrega de la actualización más reciente aparece debajo de las pestañas:

• Cancelar: detiene el envío de la actualización a los pases que aún no ha alcanzado. Estos pases permanecen en su revisión anterior.
• Reintentar fallidos: reintenta la entrega para los pases que no se pudieron actualizar (marcados como fallidos después de 5 intentos).

Una vez que se guarda una nueva revisión, las actualizaciones más antiguas ya no se pueden reintentar ni cancelar.

Eliminar una campaña

Abre la campaña y haz clic en Eliminar campaña en la parte superior derecha de la página.

Eliminar una campaña no elimina ni invalida los pases ya emitidos. Los pases emitidos conservan su contenido e imágenes actuales, pero dejan de recibir actualizaciones compartidas. Cualquier cambio futuro debe realizarse en cada pase individualmente.