Выпуск карты Wallet

Элемент Issue Wallet Pass создает карту Apple Wallet или Google Wallet для путешественника из кампании Wallet Pass. После его выполнения вы можете вставить ссылку на установку или сохранение в последующее сообщение в том же Journey.

Примечание

Этот элемент только выпускает карту. Он не доставляет ее пользователю. Добавьте после него элемент Send Push или Send Email, чтобы отправить ссылку на установку. См. раздел Доставка карты путешественнику ниже.

Примеры использования

Посадочный талон после регистрации

Выпустите посадочный талон Apple или Google Wallet, как только путешественник зарегистрируется. Персонализируйте место и выход на посадку из события регистрации, а затем отправьте ссылку на установку с помощью push-уведомления перед вылетом.

• Триггер: CheckInCompleted
• Персональные поля: сопоставьте Seat и Gate с соответствующими атрибутами события
• Доставка: Send Push с apple_install_link или google_save_link

Карта лояльности при регистрации

Выпустите карту лояльности, когда путешественник впервые присоединяется к программе вознаграждений. Персонализируйте ее, указав начальный баланс баллов.

• Триггер: LoyaltySignup
• Персональные поля: сопоставьте Points с атрибутом points события
• Доставка: Send Email сразу после, со ссылкой на сохранение в приветственном сообщении

Билет на мероприятие после покупки

Выпустите билет, как только путешественник завершит покупку билета. Персонализируйте место или ряд из заказа.

• Триггер: TicketPurchased
• Персональные поля: сопоставьте Seat и Row с атрибутами заказа
• Доставка: email-подтверждение с apple_install_link, чтобы путешественник мог добавить билет в одно касание

Предварительные требования

Прежде чем добавить этот элемент:

• Кампания Wallet Pass: создайте хотя бы одну кампанию Wallet Pass для приложения. Issue Wallet Pass может выпускать карты только из существующей кампании. Он не может создавать дизайн карты.
• Apple Wallet: подключите платформу iOS и завершите настройку карт Apple Wallet для приложения. См. также Начало работы с картами Apple Wallet.
• Google Wallet: настройте Google Wallet для Android для приложения. См. также Начало работы с картами Google Wallet.

Полные предварительные требования для кампаний на обеих платформах: Предварительные требования для кампаний Wallet Pass.

Добавление элемента

1. Перетащите элемент Issue Wallet Pass на холст после шага, который должен инициировать выпуск.
2. Дважды щелкните элемент, чтобы открыть его настройки.
3. Введите узнаваемое имя в поле Step Name, например, Карта лояльности. Вы будете использовать это имя позже, когда будете вставлять ссылку на карту в элемент Send Push или Send Email.
4. В полях Apple Wallet campaign и Google Wallet campaign выберите кампанию для одной из платформ или для обеих. Каждый выпадающий список принимает одну кампанию. Оставьте выпадающий список пустым, чтобы пропустить эту платформу.

Совет

Выбор обеих платформ позволяет одному и тому же шагу Journey охватывать путешественников на iPhone и Android одновременно. Каждая платформа выпускает (или использует повторно, см. Повторные входы и условия выхода ниже) свою собственную карту независимо для одного и того же путешественника.

Оба выпадающих списка содержат только кампании этого приложения для соответствующей платформы, уже исключая архивные.

Примечание

Кампания в статусе Draft по-прежнему отображается в списке и выпускает карты точно так же, как и кампания в статусе Active, поэтому перевод кампании из статуса Draft не является здесь обязательным условием.

Заполнение персональных полей

В разделе Personal fields on the pass установите значение для каждого отображаемого поля.

Список остается пустым, пока вы не выберете кампанию выше. Затем он показывает Персональные поля этой кампании, те же самые, которые вы заполняете в диалоговом окне Issue pass кампании. Если вы смените кампанию, список обновится соответствующим образом.

Для каждого поля откройте выпадающий список значений и выберите один из следующих вариантов:

• Статическое значение: введите одно значение для каждого путешественника, который достигает этого элемента. Например, введите SUMMER2026 в поле OFFER, чтобы каждая карта, выпущенная этим элементом, содержала один и тот же промокод.

• Событие, произошедшее ранее на пути путешественника в Journey. Затем выберите Атрибут, из которого будет браться значение поля. Например, выберите событие входа и его атрибут offer_code, чтобы заполнить поле OFFER собственным значением каждого путешественника вместо одного значения для всех. Pushwoosh считывает этот атрибут из данных о событиях самого путешественника при выполнении этого элемента, поэтому карта каждого путешественника получает свое собственное значение.

Примечание

Здесь не перечислены два типа полей, поскольку они не требуют вашего ввода:

• Поле, записанное как {Seat}, заполняется автоматически для каждого путешественника.
• Общие поля кампании имеют одинаковое значение на каждой карте. Вы устанавливаете это значение один раз, в самой кампании.

При выборе кампаний для обеих платформ в списке отображаются поля из обеих. Поле, которое есть только в одной кампании, заполняется только для карты этой платформы.

Примечание

Если исходное событие никогда не срабатывало для путешественника или атрибут пуст, для этого поля используется собственное значение кампании, установленное в разделе Установка общих и персональных полей. Путешественник не выходит из Journey.

Когда вы закончите, нажмите Применить, чтобы сохранить настройки элемента.

Повторные входы и условия выхода

Если тот же путешественник снова достигает этого элемента, например, после возврата в Journey, Pushwoosh возвращает уже выпущенную ему карту, а не создает новую. У каждого путешественника может быть не более одной карты на кампанию.

Issue Wallet Pass выводит путешественника из Journey без автоматической повторной попытки в двух случаях:

• У путешественника вообще нет User ID, даже стандартного HWID устройства, который автоматически устанавливается при обычной сессии SDK. Это происходит, когда путешественник входит в Journey без него, например, через API-based entry или полезную нагрузку события, в которой нет поля User ID.
• Не удалось выпустить карту для настроенной кампании, например, потому что она была удалена или заархивирована после добавления элемента. Когда настроены обе платформы, сначала делается попытка для Apple. Если она не удается, путешественник выходит из Journey до попытки для Google, поэтому частичный результат никогда не достигается.

Информацию о том, что нужно проверить, см. в разделах Нет User ID и Не удалось выпустить карту.

Доставка карты путешественнику

При персонализации последующего push-уведомления или email вы можете извлекать значения из этого шага Issue Wallet Pass по заданному вами Step Name. Вот атрибуты, которые вы можете вставить:

Атрибут	Платформа	Содержит
apple_install_link	Apple Wallet	URL для установки карты
google_save_link	Google Wallet	URL для сохранения карты

Доступен только атрибут для той платформы (или платформ), которую вы настроили в элементе.

Осторожно

Элемент выпускает карту только для настроенных вами платформ, а не на основе фактического устройства путешественника. Путешественник на другой платформе все равно перейдет к стандартному выходу, но со ссылкой, которую он не сможет использовать. Настройте и Apple Wallet, и Google Wallet, если ваша аудитория использует обе платформы.

1. Добавьте элемент Send Push или Send Email после Issue Wallet Pass.
2. В теле сообщения введите плейсхолдер ссылки на установку с вертикальными чертами, например, {apple_install_link|regular|}. Не используйте просто {apple_install_link}. Полный синтаксис см. в разделе Динамический контент или шаблоны Liquid в Journey.
3. Включите Персонализировать сообщение с атрибутами события.
4. В таблице установите флажок Перезаписать плейсхолдер рядом с вашим плейсхолдером. Его выпадающие списки Исходное событие и Динамический атрибут останутся неактивными, пока вы этого не сделаете.
5. В Исходном событии выберите ваш шаг Issue Wallet Pass по заданному вами Step Name, например, Карта лояльности.
6. В Динамическом атрибуте выберите apple_install_link или google_save_link в соответствии с использованным вами плейсхолдером.

Примечание

Для Send Push повторно выберите пресет после редактирования сообщения, чтобы сопоставление распознало новый плейсхолдер. Для Send Email плейсхолдер с вертикальными чертами работает и в теме письма, а не только в теле сообщения.

Каждая выпущенная карта также имеет серийный номер (apple_serial_number или google_serial_number в контексте точки). Передайте его в свои собственные системы с помощью элемента Data to app или Webhook, например, чтобы зарегистрировать его в CRM или инструменте поддержки. Чтобы найти соответствующую карту в Pushwoosh по ее серийному номеру, используйте вкладку Passes кампании Wallet Pass или API AttachPasses, когда вам нужно прикрепить отдельную карту к кампании.

Осторожно

Панель элемента показывает входы и выходы, включая причину выхода путешественника: Нет User ID или Не удалось выпустить карту. Чтобы узнать, сколько карт было фактически выпущено, проверьте статистику последующего элемента Send Push или Send Email.

Пример сценария: предложение лояльности от кофейни

Кофейня хочет приветствовать каждого нового участника программы лояльности скидочной картой, которую они могут добавить в кошелек своего телефона.

1. Создайте событие CoffeeClubJoined и убедитесь, что оно включает атрибут для приветственного предложения, например, offer_code. Узнайте больше о создании событий
2. Установите это событие в качестве триггера для Journey, чтобы каждый новый участник входил в него сразу после присоединения.

3. Добавьте Issue Wallet Pass после триггера.
4. Назовите его Карта лояльности.
5. Выберите кампанию лояльности, например, Скидка на кофе, для Apple Wallet campaign (а также для Google Wallet campaign, если вы поддерживаете Android).
6. В разделе Personal fields on the pass установите для OFFER событие входа триггера.
7. Выберите offer_code в качестве Атрибута.

8. Добавьте элемент Send Email сразу после Issue Wallet Pass.
9. Персонализируйте его с помощью apple_install_link (или google_save_link), чтобы приветственное письмо содержало ссылку для добавления карты в одно касание.

Когда срабатывает CoffeeClubJoined, путешественник входит в Journey, Issue Wallet Pass выпускает его карту с offer_code из этого события, а Send Email отправляет приветственное сообщение со ссылкой для ее добавления.