Wallet Pass 발급

Issue Wallet Pass 요소는 Wallet Pass Campaign에서 여행객을 위한 Apple Wallet 또는 Google Wallet Pass를 생성합니다. 실행 후, 동일한 Journey의 나중 메시지에 설치 또는 저장 링크를 삽입할 수 있습니다.

참고

이 요소는 Pass만 발급하며 사용자에게 전달하지는 않습니다. 설치 링크를 보내려면 그 뒤에 Send Push 또는 Send Email 요소를 추가하세요. 아래의 여행객에게 Pass 전달하기를 참조하세요.

사용 사례 예시

체크인 후 탑승권

여행객이 체크인하면 Apple 또는 Google Wallet 탑승권을 발급합니다. 체크인 이벤트에서 좌석과 게이트를 개인화한 다음, 출발 전에 푸시로 설치 링크를 보냅니다.

• 트리거: CheckInCompleted
• 개인화 필드: Seat 및 Gate를 일치하는 이벤트 속성에 매핑합니다.
• 전달: apple_install_link 또는 google_save_link를 사용하여 Send Push

가입 시 로열티 카드

여행객이 리워드 프로그램에 처음 가입할 때 로열티 카드를 발급합니다. 시작 포인트 잔액으로 개인화합니다.

• 트리거: LoyaltySignup
• 개인화 필드: Points를 이벤트의 points 속성에 매핑합니다.
• 전달: 바로 뒤에 Send Email을 보내고, 환영 메시지에 저장 링크를 포함합니다.

구매 후 이벤트 티켓

여행객이 티켓 구매를 완료하면 티켓을 발급합니다. 주문에서 좌석 또는 열을 개인화합니다.

• 트리거: TicketPurchased
• 개인화 필드: Seat 및 Row를 주문 속성에 매핑합니다.
• 전달: 여행객이 한 번의 탭으로 티켓을 추가할 수 있도록 apple_install_link가 포함된 확인 이메일

사전 요구 사항

이 요소를 추가하기 전에:

• Wallet Pass Campaign: 애플리케이션에 대해 최소 하나 이상의 Wallet Pass Campaign을 생성하세요. Issue Wallet Pass는 기존 캠페인에서만 Pass를 발급할 수 있으며, 디자인할 수는 없습니다.
• Apple Wallet: 애플리케이션에 대해 iOS 플랫폼을 연결하고 Apple Wallet Pass 설정을 완료하세요. Apple Wallet Pass 시작하기도 참조하세요.
• Google Wallet: 애플리케이션에 대해 Android용 Google Wallet 구성을 하세요. Google Wallet Pass 시작하기도 참조하세요.

두 플랫폼에 대한 전체 캠페인 사전 요구 사항: Wallet Pass Campaign 사전 요구 사항.

요소 추가하기

1. 발급을 트리거해야 하는 단계 뒤에 Issue Wallet Pass 요소를 캔버스로 드래그합니다.
2. 요소를 더블 클릭하여 설정을 엽니다.
3. Step Name에 Loyalty card와 같이 식별 가능한 이름을 입력합니다. 이 이름은 나중에 Send Push 또는 Send Email 요소에 Pass 링크를 삽입할 때 사용됩니다.
4. Apple Wallet campaign 및 Google Wallet campaign에서 한 플랫폼 또는 두 플랫폼 모두에 대한 캠페인을 선택합니다. 각 드롭다운은 하나의 캠페인을 허용합니다. 해당 플랫폼을 건너뛰려면 드롭다운을 비워 둡니다.

팁

두 플랫폼을 모두 선택하면 동일한 Journey 단계에서 iPhone 및 Android 여행객을 한 번에 처리할 수 있습니다. 각 플랫폼은 동일한 여행객에 대해 독립적으로 자체 Pass를 발급(또는 아래의 반복 진입 및 드롭 조건 참조)합니다.

두 드롭다운 모두 이 애플리케이션의 일치하는 플랫폼에 대한 캠페인만 나열하며, 보관된 캠페인은 이미 제외됩니다.

참고

초안(Draft) 캠페인도 목록에 표시되며 활성(Active) 캠페인과 똑같이 Pass를 발급하므로, 캠페인을 초안 상태에서 변경하는 것은 여기서 사전 요구 사항이 아닙니다.

개인화 필드 채우기

Pass의 개인화 필드 아래에 나타나는 각 필드에 대한 값을 설정합니다.

위에서 캠페인을 선택할 때까지 목록은 비어 있습니다. 그런 다음 해당 캠페인의 개인화 필드가 표시되며, 이는 캠페인의 Pass 발급 대화 상자에서 채우는 것과 동일한 필드입니다. 캠페인을 전환하면 목록이 일치하도록 업데이트됩니다.

각 필드에 대해 값 드롭다운을 열고 다음 중 하나를 선택합니다:

• 정적 값: 이 요소에 도달하는 모든 여행객에 대해 하나의 값을 입력합니다. 예를 들어, OFFER 필드에 SUMMER2026을 입력하면 이 요소가 발급하는 모든 Pass에 동일한 프로모션 코드가 포함됩니다.

• Journey를 통과하는 여행객의 경로에서 이전 이벤트. 그런 다음 필드 값을 가져올 **속성(Attribute)**을 선택합니다. 예를 들어, 진입 이벤트를 선택하고 해당 offer_code 속성을 선택하여 모든 사람에게 하나의 값을 사용하는 대신 각 여행객의 고유한 값으로 OFFER 필드를 채웁니다. Pushwoosh는 이 요소가 실행될 때 여행객의 자체 이벤트 데이터에서 해당 속성을 읽으므로 각 여행객의 Pass는 자신의 값을 갖게 됩니다.

참고

두 종류의 필드는 여기에 나열되지 않는데, 이는 사용자로부터 입력이 필요하지 않기 때문입니다:

• {Seat}으로만 작성된 필드는 각 여행객에 대해 자동으로 채워집니다.
• 캠페인의 공유 필드는 모든 Pass에 동일한 값을 가집니다. 이 값은 캠페인 자체에서 한 번 설정합니다.

두 플랫폼에 대한 캠페인을 모두 선택하면 목록에 두 캠페인의 필드가 모두 표시됩니다. 한 캠페인에만 있는 필드는 해당 플랫폼의 Pass에 대해서만 채워집니다.

참고

만약 소스 이벤트가 여행객에게 발생하지 않았거나 속성이 비어 있는 경우, Pass는 대신 공유 및 개인화 필드 설정에서 설정된 캠페인 자체의 값을 사용합니다. 여행객은 드롭되지 않습니다.

완료되면 **적용(Apply)**을 클릭하여 요소 설정을 저장합니다.

반복 진입 및 드롭 조건

동일한 여행객이 이 요소에 다시 도달하면(예: Journey에서 루프백 후), Pushwoosh는 새 Pass를 생성하는 대신 이미 발급된 Pass를 반환합니다. 각 여행객은 캠페인당 최대 하나의 Pass만 보유할 수 있습니다.

Issue Wallet Pass는 자동 재시도 없이 다음 두 가지 경우에 여행객을 드롭합니다:

• 여행객에게 User ID가 전혀 없는 경우, 심지어 일반적인 SDK 세션이 자동으로 설정하는 기본 장치 HWID조차 없는 경우입니다. 이는 여행객이 User ID 없이 Journey에 진입할 때 발생합니다(예: API 기반 진입 또는 User ID 필드가 없는 이벤트 페이로드를 통해).
• 구성된 캠페인에 대한 Pass 발급이 실패한 경우(예: 요소를 추가한 후 캠페인이 삭제되거나 보관된 경우). 두 플랫폼이 모두 구성된 경우 Apple이 먼저 시도됩니다. 실패하면 Google을 시도하기 전에 여행객이 드롭되므로 부분적인 결과는 발생하지 않습니다.

확인할 사항은 User ID 없음 및 Pass 발급 실패를 참조하세요.

여행객에게 Pass 전달하기

나중에 푸시나 이메일을 개인화할 때, 이 Issue Wallet Pass 단계에서 지정한 **단계 이름(Step Name)**으로 값을 가져올 수 있습니다. 삽입할 수 있는 속성은 다음과 같습니다:

속성	플랫폼	내용
apple_install_link	Apple Wallet	Pass를 설치하기 위한 URL
google_save_link	Google Wallet	Pass를 저장하기 위한 URL

요소에서 구성한 플랫폼에 대한 속성만 사용할 수 있습니다.

주의

이 요소는 여행객의 실제 장치가 아닌, 사용자가 구성한 플랫폼에 대해서만 Pass를 발급합니다. 다른 플랫폼의 여행객은 사용할 수 없는 링크를 가지고 기본 출력으로 계속 진행됩니다. 잠재 고객이 두 플랫폼을 모두 사용하는 경우 Apple Wallet과 Google Wallet을 모두 구성하세요.

1. Issue Wallet Pass 뒤에 Send Push 또는 Send Email 요소를 추가합니다.
2. 메시지 본문에 수직 막대가 있는 설치 링크 플레이스홀더를 입력합니다(예: {apple_install_link|regular|}). 일반 {apple_install_link}를 사용하지 마세요. 전체 구문은 Journey의 동적 콘텐츠 또는 Liquid 템플릿을 참조하세요.
3. 이벤트 속성으로 메시지 개인화를 켭니다.
4. 표에서 플레이스홀더 옆의 플레이스홀더 덮어쓰기(Overwrite placeholder) 상자를 선택합니다. 이 작업을 수행할 때까지 소스 이벤트(Source event) 및 동적 속성(Dynamic attribute) 드롭다운은 비활성화된 상태로 유지됩니다.
5. **소스 이벤트(Source event)**에서 지정한 **단계 이름(Step Name)**으로 Issue Wallet Pass 단계를 선택합니다(예: Loyalty card).
6. **동적 속성(Dynamic attribute)**에서 사용한 플레이스홀더와 일치하도록 apple_install_link 또는 google_save_link를 선택합니다.

참고

Send Push의 경우, 메시지를 편집한 후 프리셋을 다시 선택하여 매핑이 새 플레이스홀더를 인식하도록 하세요. Send Email의 경우, 수직 막대가 있는 플레이스홀더는 메시지 본문뿐만 아니라 제목 줄에서도 작동합니다.

발급된 각 Pass에는 일련 번호(apple_serial_number 또는 google_serial_number)도 있습니다. Data to app 또는 Webhook 요소를 사용하여 CRM이나 지원 도구에 기록하는 등 자체 시스템으로 전달하세요. 일련 번호로 Pushwoosh에서 일치하는 Pass를 찾으려면 Wallet Pass Campaign의 Passes 탭 또는 AttachPasses API를 사용하세요. 기존 Pass를 캠페인에 첨부해야 할 때 필요합니다.

주의

요소 패널에는 진입 및 드롭오프가 표시되며, 여행객이 드롭된 이유도 포함됩니다: User ID 없음 또는 Pass 발급 실패. 실제로 발급된 Pass 수는 다운스트림 Send Push 또는 Send Email 요소의 통계를 확인하세요.

예시 시나리오: 커피숍 로열티 혜택

한 커피숍에서 모든 신규 로열티 회원에게 휴대폰 Wallet에 추가할 수 있는 할인 Pass로 환영하고자 합니다.

1. CoffeeClubJoined 이벤트를 생성하고 환영 혜택에 대한 속성(예: offer_code)이 포함되어 있는지 확인합니다. 이벤트 생성에 대해 자세히 알아보기
2. 이 이벤트를 Journey의 트리거로 설정하여 모든 신규 회원이 가입하자마자 진입하도록 합니다.

3. 트리거 뒤에 Issue Wallet Pass를 추가합니다.
4. 이름을 Loyalty card로 지정합니다.
5. Apple Wallet campaign(Android를 지원하는 경우 Google Wallet campaign도 포함)에 대해 로열티 캠페인(예: Coffee discount)을 선택합니다.
6. Pass의 개인화 필드 아래에서 OFFER를 트리거 진입 이벤트로 설정합니다.
7. **속성(Attribute)**으로 offer_code를 선택합니다.

8. Issue Wallet Pass 바로 뒤에 Send Email 요소를 추가합니다.
9. 환영 이메일에 Pass를 추가하는 원탭 링크가 포함되도록 apple_install_link(또는 google_save_link)로 개인화합니다.

CoffeeClubJoined가 실행되면 여행객은 Journey에 진입하고, Issue Wallet Pass는 해당 이벤트의 offer_code로 Pass를 발급하며, Send Email은 Pass를 추가할 수 있는 링크가 포함된 환영 메시지를 보냅니다.