Emitir pase de Wallet

El elemento Emitir pase de Wallet crea un pase de Apple Wallet o Google Wallet para un viajero desde una Campaña de pases de Wallet. Después de que se ejecuta, puedes insertar el enlace de instalación o guardado en un mensaje posterior en el mismo journey.

Nota

Este elemento solo emite el pase. No lo entrega al usuario. Agrega un elemento Enviar Push o Enviar Email después para enviar el enlace de instalación. Consulta Entregar el pase al viajero a continuación.

Casos de uso de ejemplo

Tarjeta de embarque después del check-in

Emite una tarjeta de embarque de Apple o Google Wallet una vez que un viajero hace el check-in. Personaliza el asiento y la puerta de embarque a partir del evento de check-in, luego envía el enlace de instalación por push antes de la salida.

• Desencadenante: CheckInCompleted
• Campos personales: asigna Asiento y Puerta a los atributos del evento correspondientes
• Entrega: Enviar Push con apple_install_link o google_save_link

Tarjeta de fidelidad al registrarse

Emite una tarjeta de fidelidad la primera vez que un viajero se une a un programa de recompensas. Personalízala con su saldo de puntos inicial.

• Desencadenante: LoyaltySignup
• Campos personales: asigna Puntos al atributo points del evento
• Entrega: Enviar Email justo después, con el enlace para guardar en el mensaje de bienvenida

Entrada para un evento después de la compra

Emite una entrada una vez que un viajero completa la compra de una entrada. Personaliza el asiento o la fila a partir del pedido.

• Desencadenante: TicketPurchased
• Campos personales: asigna Asiento y Fila a los atributos del pedido
• Entrega: correo electrónico de confirmación con apple_install_link para que el viajero pueda agregar la entrada con un solo toque

Prerrequisitos

Antes de agregar este elemento:

• Campaña de pases de Wallet: crea al menos una Campaña de pases de Wallet para la aplicación. Emitir pase de Wallet solo puede emitir pases de una campaña existente. No puede diseñar una.
• Apple Wallet: conecta la plataforma iOS y completa la configuración del pase de Apple Wallet para la aplicación. Consulta también Primeros pasos con los pases de Apple Wallet.
• Google Wallet: configura Google Wallet para Android para la aplicación. Consulta también Primeros pasos con los pases de Google Wallet.

Prerrequisitos completos de la campaña para ambas plataformas: Prerrequisitos de las Campañas de pases de Wallet.

Agregar el elemento

1. Arrastra el elemento Emitir pase de Wallet al lienzo después del paso que debería desencadenar la emisión.
2. Haz doble clic en el elemento para abrir su configuración.
3. Ingresa un nombre reconocible en Nombre del paso, por ejemplo Tarjeta de fidelidad. Usarás este nombre más tarde cuando insertes el enlace del pase en un elemento Enviar Push o Enviar Email.
4. En Campaña de Apple Wallet y Campaña de Google Wallet, selecciona una campaña para cualquiera de las plataformas, o para ambas. Cada menú desplegable acepta una campaña. Deja un menú desplegable vacío para omitir esa plataforma.

Consejo

Seleccionar ambas plataformas permite que el mismo paso del journey cubra a los viajeros de iPhone y Android a la vez. Cada plataforma emite (o reutiliza, consulta Repetir entradas y condiciones de abandono a continuación) su propio pase de forma independiente para el mismo viajero.

Ambos menús desplegables solo listan las campañas de esta aplicación para la plataforma correspondiente, excluyendo ya las archivadas.

Nota

Una campaña en Borrador todavía se lista y emite pases exactamente como una Activa, por lo que sacar una campaña del estado de Borrador no es un prerrequisito aquí.

Rellenar campos personales

En Campos personales en el pase, establece un valor para cada campo que aparece.

La lista permanece vacía hasta que selecciones una campaña arriba. Luego muestra los campos Personales de esa campaña, los mismos que rellenas en el diálogo Emitir pase de la campaña. Si cambias la campaña, la lista se actualiza para coincidir.

Para cada campo, abre el menú desplegable de valor y elige una de las siguientes opciones:

• Valor estático: escribe un valor para cada viajero que llegue a este elemento. Por ejemplo, escribe VERANO2026 en un campo OFERTA para que cada pase que emita este elemento lleve el mismo código promocional.

• Un evento anterior en la ruta del viajero a través del journey. Luego, elige un Atributo del cual obtener el valor del campo. Por ejemplo, elige el evento de entrada y su atributo offer_code para rellenar el campo OFERTA con el valor propio de cada viajero en lugar de un valor para todos. Pushwoosh lee ese atributo de los datos del evento del propio viajero cuando se ejecuta este elemento, por lo que el pase de cada viajero obtiene su propio valor.

Nota

Dos tipos de campos no se listan aquí, porque no necesitan tu intervención:

• Un campo escrito simplemente como {Seat} se rellena automáticamente para cada viajero.
• Los campos Compartidos de la campaña llevan el mismo valor en cada pase. Estableces ese valor una vez, en la propia campaña.

Con campañas seleccionadas para ambas plataformas, la lista muestra campos de ambas. Un campo que solo tiene una campaña se rellena solo para el pase de esa plataforma.

Nota

Si el evento de origen nunca se disparó para un viajero, o el atributo está vacío, el pase utiliza el valor propio de la campaña para ese campo, establecido en Establecer campos compartidos y personales. El viajero no es abandonado.

Cuando hayas terminado, haz clic en Aplicar para guardar la configuración del elemento.

Repetir entradas y condiciones de abandono

Si el mismo viajero llega de nuevo a este elemento, por ejemplo, después de volver en un bucle en el journey, Pushwoosh devuelve el pase ya emitido en lugar de crear uno nuevo. Cada viajero tiene como máximo un pase por campaña.

Emitir pase de Wallet abandona al viajero, sin reintento automático, en dos casos:

• El viajero no tiene ningún ID de Usuario, ni siquiera el HWID de dispositivo predeterminado que una sesión normal del SDK establece automáticamente. Esto sucede cuando un viajero entra en el journey sin uno, por ejemplo, a través de una entrada basada en API o una carga útil de evento que no tiene campo de ID de Usuario.
• La emisión del pase falló para una campaña configurada, por ejemplo, porque fue eliminada o archivada después de que agregaste el elemento. Cuando ambas plataformas están configuradas, se intenta primero con Apple. Si falla, el viajero es abandonado antes de que se intente con Google, por lo que nunca ocurre un resultado parcial.

Consulta Sin ID de Usuario y Falló la emisión del pase para saber qué verificar.

Entregar el pase al viajero

Cuando personalizas un push o correo electrónico posterior, puedes obtener valores de este paso de Emitir pase de Wallet por el Nombre del paso que le diste. Estos son los atributos que puedes insertar:

Atributo	Plataforma	Contiene
apple_install_link	Apple Wallet	URL para instalar el pase
google_save_link	Google Wallet	URL para guardar el pase

Solo está disponible el atributo para la(s) plataforma(s) que configuraste en el elemento.

Precaución

El elemento emite un pase solo para la(s) plataforma(s) que configuraste, no en función del dispositivo real del viajero. Un viajero en la otra plataforma aún avanza a la salida predeterminada, solo que con un enlace que no puede usar. Configura tanto Apple Wallet como Google Wallet si tu audiencia usa ambas plataformas.

1. Agrega un elemento Enviar Push o Enviar Email después de Emitir pase de Wallet.
2. En el cuerpo del mensaje, escribe el marcador de posición del enlace de instalación con barras verticales, por ejemplo {apple_install_link|regular|}. No uses un {apple_install_link} simple. Consulta Contenido dinámico o plantillas Liquid para la sintaxis completa.
3. Activa Personalizar mensaje con atributos de evento.
4. En la tabla, marca la casilla Sobrescribir marcador de posición junto a tu marcador de posición. Sus menús desplegables Evento de origen y Atributo dinámico permanecen deshabilitados hasta que lo hagas.
5. En Evento de origen, elige tu paso de Emitir pase de Wallet por el Nombre del paso que le diste, por ejemplo Tarjeta de fidelidad.
6. En Atributo dinámico, elige apple_install_link o google_save_link para que coincida con el marcador de posición que usaste.

Nota

Para Enviar Push, vuelve a seleccionar el preset después de editar el mensaje para que el mapeo recoja el nuevo marcador de posición. Para Enviar Email, un marcador de posición con barras verticales también funciona en la línea de asunto, no solo en el cuerpo del mensaje.

Cada pase emitido también tiene un número de serie (apple_serial_number o google_serial_number en el contexto del punto). Pásalo a tus propios sistemas con un elemento Datos a la aplicación o Webhook, por ejemplo, para registrarlo en un CRM o herramienta de soporte. Para encontrar el pase correspondiente en Pushwoosh por su número de serie, usa la pestaña Pases de la Campaña de pases de Wallet o la API AttachPasses, cuando necesites adjuntar un pase independiente a una campaña.

Precaución

El panel del elemento muestra entradas y abandonos, incluyendo por qué un viajero fue abandonado: Sin ID de Usuario o Falló la emisión del pase. Para saber cuántos pases se emitieron realmente, consulta las estadísticas del elemento Enviar Push o Enviar Email subsiguiente.

Escenario de ejemplo: oferta de fidelidad de una cafetería

Una cafetería quiere dar la bienvenida a cada nuevo miembro de su programa de fidelidad con un pase de descuento que puedan agregar a la wallet de su teléfono.

1. Crea el evento CoffeeClubJoined y asegúrate de que incluya un atributo para la oferta de bienvenida, por ejemplo offer_code. Aprende más sobre la creación de eventos
2. Establece este evento como el desencadenante del journey, para que cada nuevo miembro entre tan pronto como se una.

3. Agrega Emitir pase de Wallet después del desencadenante.
4. Nómbralo Tarjeta de fidelidad.
5. Selecciona la campaña de fidelidad, por ejemplo Descuento de café, para la Campaña de Apple Wallet (y también para la Campaña de Google Wallet, si das soporte a Android).
6. En Campos personales en el pase, establece OFERTA en el evento de entrada del desencadenante.
7. Elige offer_code como el Atributo.

8. Agrega un elemento Enviar Email justo después de Emitir pase de Wallet.
9. Personalízalo con apple_install_link (o google_save_link) para que el correo electrónico de bienvenida incluya un enlace de un solo toque para agregar el pase.

Cuando se dispara CoffeeClubJoined, el viajero entra en el journey, Emitir pase de Wallet emite su pase con el offer_code de ese evento, y Enviar Email envía el mensaje de bienvenida con el enlace para agregarlo.