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 en todos los dispositivos de los usuarios simultáneamente) y cuáles son Personales (conservando 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 manualmente 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 a cuántos pases emitidos afecta una edición de campo antes de guardarla.
• Anular 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.
• Actualizar automáticamente un pase cada vez que la etiqueta detrás de uno de sus campos cambie, sin editar la campaña.

Prerrequisitos

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

Apple Wallet:

• Membresía activa en el Programa de Desarrolladores de Apple
• Plataforma iOS conectada a la aplicación
• Certificado de firma de pase 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 empezar 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 de pase (Apple) o Tipo de pase (Google), elige el diseño para tu pase:
  • Apple Wallet: Tarjeta de embarque, Cupón, Entrada para evento, Tarjeta de tienda, Genérico. Consulta Elegir un estilo de pase.
  • Google Wallet: Genérico, Oferta, Tarjeta de fidelización, Entrada para 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 en Apple Wallet o Caducidad en Google Wallet).
• Ubicaciones: establece la relevancia basada en la ubicación (consulta Ubicaciones en Apple Wallet o Ubicaciones en 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 cualquier persona 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	Controlado por la campaña. La actualización de este campo sincroniza el nuevo valor en 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 etiqueta, {tag} o {tag|formato|alternativo} (por ejemplo, {Asiento}). Pushwoosh lo rellena a partir de la etiqueta del destinatario cuando entrega el pase. Si el destinatario no tiene un valor para esa etiqueta, Pushwoosh utiliza el valor alternativo del marcador de posición, o deja el campo en blanco si el marcador de posición no tiene ninguno.

• Solo la etiqueta, nada más, como {Asiento}: el campo no aparece en el diálogo Emitir pase.
• La etiqueta mezclada con otro texto, como Asiento {Asiento}, o sin etiqueta: el campo aparece como una entrada editable en el diálogo Emitir pase, prellenado con ese valor. Cualquier etiqueta dentro de él se resuelve por destinatario cuando Pushwoosh entrega 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.

Activar la sincronización de etiquetas

En la sección Sincronización de etiquetas, activa Actualizar campos del pase desde etiquetas para que Pushwoosh verifique periódicamente los marcadores de posición de etiquetas utilizados en los campos de la campaña y envíe un valor nuevo a cualquier pase cuya etiqueta haya cambiado.

• Intervalo (minutos): con qué frecuencia Pushwoosh vuelve a leer las etiquetas. El valor predeterminado es 60 y no puede ser inferior a 5. Un pase recibe como máximo una actualización por intervalo, sin importar cuántas veces cambie su etiqueta en ese período.
• Notificación (solo Google Wallet): elige cómo el titular se entera de la actualización: Silenciosamente, Mensaje propio (completa el Texto del mensaje, enviado con la actualización), o Notificación de campo de Google (la propia alerta de actualización de campo de Google). Google las limita a 3 por pase cada 24 horas. Pasado ese límite, los nuevos valores siguen llegando al pase, pero sin notificación.

Nota

Apple Wallet no tiene una notificación para toda la campaña, por lo que este selector no aparece para las campañas de Apple. El texto de la notificación se encuentra en el propio campo. Completa el Mensaje de cambio en cada campo en el creador de pases de Apple Wallet.

Precaución

La sincronización de etiquetas solo se ejecuta mientras el estado de la campaña es Activo. Establécelo en Borrador o Archivado para pausar las verificaciones programadas sin desactivar el interruptor.

Activar la sincronización de etiquetas para una campaña que ya tiene pases emitidos no espera a que termine el primer intervalo. La siguiente verificación programada trata una campaña que nunca se ha sincronizado como si debiera ejecutarse de inmediato, y en el modo Mensaje propio o Notificación de campo de Google esto puede notificar a todos los titulares a la vez y agotar el límite de 3 por 24 horas del pase en una sola ejecución.

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 la imagen de la 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. Verifica 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 verificar el diseño con los requisitos de Apple o Google antes de guardar, sin crear aún la campañ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 etiquetas (como {Asiento}): no aparecen en el diálogo. Pushwoosh los rellena automáticamente a partir de las etiquetas 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 Issue Wallet Pass 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 usando 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 número de serie:

• 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 requeridos de la campaña.
• 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, previsualización del pase en vivo y tres pestañas principales: Diseño, Pases e Historial.

Cambiar el estado de la campaña

Usa 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 Activo: te permite emitir nuevos pases, adjuntar los existentes y enviar actualizaciones de diseño.
• Archivado: 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, subir nuevas imágenes de la campaña o cambiar la configuración de sincronización de etiquetas.

Actualizar el diseño y enviar los cambios a los pases

1. En la pestaña Diseño, edita la información básica, los colores, el tipo de código de barras, la caducidad, las ubicaciones, un campo compartido o una imagen de la campaña.
2. Haz clic en Guardar cambios.
3. En el diálogo Aplicar la edición de la campaña, confirma la actualización:
   • Ningún pase anula el campo cambiado: haz clic en Actualizar N, mantener ediciones manuales para enviar la edición a todos los N pases.
   • Algunos pases anulan el campo cambiado: el diálogo nombra el campo y cuántos pases lo anulan. Haz clic en Actualizar N, mantener ediciones manuales para enviar la edición a todos los pases excepto a esos, o en Sobrescribir todos los N para enviarla a todos los N pases, incluidos los anulados. La sobrescritura borra la anulación.

Cualquiera que sea el botón que presiones, la actualización se guarda como una nueva revisión (por ejemplo, Revisión 2), para que puedas verificar qué cambió y cuándo en la pestaña Historial.

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.

Anular 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 anulación: 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, incluida una actualización programada de sincronización de etiquetas, omitirán este pase para ese campo específico.
• Eliminar una anulación: 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 anulado.

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

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, campos anclados activos, revisión actual y fecha de la última actualización.

Si la sincronización de etiquetas está activada, la pestaña también muestra una línea Etiquetas sincronizadas sobre la tabla con la fecha y hora de la última ejecución programada, o aún no antes de la primera.

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

• Con campos anclados: 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 los campos personales o anular 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 un solo uso 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 eliminar forzosamente 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 la han recibido. 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.