월렛 패스 캠페인 생성하기

월렛 패스 캠페인을 사용하면 단일 Apple 월렛 또는 Google 월렛 패스 템플릿을 디자인하고 여러 사용자에게 발급하며 업데이트를 중앙에서 관리할 수 있습니다.

어떤 필드를 공유할지(모든 사용자 기기에 변경 사항을 동시에 동기화)와 어떤 필드를 개인으로 할지(이름, 바코드, 잔액과 같은 고유 값을 각 사용자별로 보존) 선택할 수 있습니다.

월렛 패스 캠페인으로 할 수 있는 일

Apple 월렛 또는 Google 월렛 패스 빌더에서 각 패스를 수동으로 설정하는 대신, 캠페인에서 하나의 패스를 디자인합니다.
어떤 필드를 전체적으로 업데이트할지(공유)와 어떤 필드를 패스별로 유지할지(개인) 선택합니다.
필드 편집이 저장되기 전에 얼마나 많은 발급된 패스에 영향을 미치는지 확인합니다.
하나의 패스에서 공유 필드를 재정의한 다음, 나중에 다시 캠페인 제어로 되돌립니다.
캠페인 외부에서 발급된 패스를 첨부하여 공유 필드를 따르도록 합니다.
캠페인 수정 내역과 각 업데이트의 전송 상태를 추적합니다.

전제 조건

캠페인은 독립형 패스와 동일한 일회성 설정을 사용합니다:

Apple 월렛:

활성 Apple Developer Program 멤버십
애플리케이션에 연결된 iOS 플랫폼
Pushwoosh에 업로드된 패스 서명 인증서

Google 월렛:

활성 Google Pay & Wallet Console 발급자 계정
애플리케이션에 대해 구성된 Google 월렛 (발급자 ID 및 Google Cloud 서비스 계정 키)

캠페인 생성

캠페인 생성을 시작하려면 Campaigns → Wallet Passes → Campaigns로 이동하여 Create campaign을 클릭합니다.

월렛 패스의 빈 캠페인 목록과 Create campaign 버튼이 강조 표시됨

캠페인 세부 정보 및 플랫폼 설정

Platform: 페이지 상단에서 Apple Wallet 또는 Google Wallet을 선택합니다. 이 선택은 캠페인에 대해 영구적입니다.
Campaign: 내부 참조용으로 Name과 선택적 Description을 입력합니다. 둘 다 패스에 표시되지 않습니다.
Pass format: Pass Style(Apple) 또는 Pass Type(Google) 아래에서 패스 레이아웃을 선택합니다:
- Apple Wallet: Boarding Pass, Coupon, Event Ticket, Store Card, Generic. 패스 스타일 선택을 참조하세요.
- Google Wallet: Generic, Offer, Loyalty card, Event ticket, Gift card, Flight, Transit. 생성 후에는 변경할 수 없습니다. 패스 유형 선택을 참조하세요.

패스 디자인 및 브랜딩 구성

패스의 표준 섹션을 구성합니다:

Basic Information, Colors, and Barcode: 패스 제목, 배경 및 텍스트 색상, 바코드 유형을 설정합니다. 각 섹션에 대한 자세한 지침은 Apple 월렛 패스 빌더에서 패스 디자인하기 또는 패스 빌더에서 Google 월렛 패스 디자인하기를 참조하세요.
Pass fields: 카드에 표시되어야 할 필드를 추가합니다(Apple 월렛 패스 필드 또는 Google 월렛 필드 및 세부 정보 참조).
Expiration: 관련 날짜 및 만료 규칙을 설정합니다(Apple 월렛 만료 또는 Google 월렛 만료 참조).
Locations: 위치 기반 관련성을 설정합니다(Apple 월렛 위치 또는 Google 월렛 위치 참조).

공유 및 개인 필드 설정

Shared and personal fields 섹션에서 어떤 필드가 모든 패스에 걸쳐 전역적으로 업데이트되고 어떤 필드가 사용자별로 고유한 값을 유지할지 구성합니다. 이는 나중에 캠페인을 편집할 때 발생하는 일을 제어합니다: 공유 필드는 모든 발급된 패스에서 업데이트되지만 개인 필드는 변경되지 않은 상태로 유지됩니다.

사용자별로 고유한 값을 가져야 하는 필드에 대해 Personal 토글을 켭니다.

각 필드 옆에 Personal 토글이 있는 공유 및 개인 필드 구성 섹션

필드 유형	동작	예시
공유	캠페인에 의해 구동됩니다. 이 필드를 업데이트하면 새 값이 사용자의 기기에 있는 모든 패스에 동기화됩니다.	이벤트 날짜, 게이트 번호, 매장 주소, 할인율
개인	사용자별로 고유합니다. 캠페인이 업데이트될 때 이러한 값을 덮어쓰지 않습니다.	사용자 이름, 좌석 번호, 멤버십 ID, 포인트 잔액

개인 필드의 값에는 태그 플레이스홀더 {tag} 또는 {tag|format|fallback}(예: {Seat})가 포함될 수 있습니다. Pushwoosh는 패스를 제공할 때 수신자의 태그에서 이를 채웁니다. 수신자가 해당 태그에 대한 값이 없는 경우 Pushwoosh는 플레이스홀더의 대체 값을 사용하거나 플레이스홀더에 아무것도 없으면 필드를 비워 둡니다.

태그만 있는 경우(예: {Seat}): 필드는 Issue pass 대화 상자에 나타나지 않습니다.
태그가 다른 텍스트와 혼합된 경우(예: Seat {Seat}) 또는 태그가 전혀 없는 경우: 필드는 Issue pass 대화 상자에서 편집 가능한 입력란으로 나타나며 해당 값으로 미리 채워집니다. Pushwoosh가 패스를 제공할 때 그 안에 있는 모든 태그는 여전히 수신자별로 해석됩니다.

캠페인 이미지 업로드

Campaign images 섹션에서 이미지 슬롯 옆에 있는 Choose an image를 클릭합니다.
Media store에서 기존 이미지를 선택하거나 새 파일을 드래그 앤 드롭하여 업로드합니다.
사용 가능한 각 이미지 슬롯에 대해 반복합니다:
- Apple Wallet: Icon, Logo, Background, Footer, Strip, Thumbnail (Apple 월렛 이미지 참조).
- Google Wallet: Logo 및 Hero image.

아이콘, 로고 및 사용자 정의 패스 이미지를 위한 업로드 슬롯이 있는 캠페인 이미지 섹션

미리보기 및 캠페인 생성

오른쪽의 Preview as user 패널을 확인하여 카드가 어떻게 보이는지 확인합니다. 테스트 User ID를 입력하여 개인화된 필드를 미리 볼 수 있습니다.

Preview as user 필드와 렌더링된 디지털 패스 카드가 있는 실시간 패스 미리보기 패널

페이지 하단의 Create campaign을 클릭합니다.

Pushwoosh는 Draft 상태로 캠페인을 생성하고 Design, Passes, History 탭이 있는 작업 공간을 엽니다.

사용자에게 패스 발급하기

캠페인에서 패스 발급하기

Passes 탭에서 Issue pass를 클릭합니다.
수신자의 Pushwoosh User ID를 입력합니다.

Pushwoosh User ID 필드와 Issue pass 확인 버튼이 있는 패스 발급 모달 대화 상자

Issue pass를 클릭하여 확인합니다.

Personal fields를 어떻게 구성했는지에 따라 모달은 다음과 같이 처리합니다:

Editable fields: 이 사용자에 대해 변경할 수 있는 기본값과 함께 나타납니다.
Tag placeholders (like {Seat}): 대화 상자에 나타나지 않습니다. Pushwoosh는 사용자의 태그에서 자동으로 채웁니다.

발급 후 언제든지 개별 패스에서 개인 필드를 편집할 수도 있습니다.

Pushwoosh는 캠페인의 현재 디자인에서 패스를 생성하고 Passes 탭과 애플리케이션의 All passes 테이블(Apple Wallet 또는 Google Wallet)에 나열합니다.

패스를 발급하면 Pushwoosh에 패스 레코드가 생성됩니다. 사용자 기기로 전달하려면 설치 링크를 공유하세요:

Passes 탭 또는 All passes에서 패스의 작업 메뉴를 엽니다.
Copy install link 또는 QR code를 선택합니다. Apple 월렛 패스는 서명된 .pkpass 파일에 대한 Download도 제공합니다.
푸시, 이메일, SMS 또는 Customer Journey를 통해 수신자에게 링크나 파일을 보냅니다. 여행자가 여정을 통과할 때 패스를 발급하고 링크를 자동으로 전달하려면, 여기서 발급하는 대신 Issue Wallet Pass 요소를 사용하세요.

패스 배포 방법에 대한 자세한 내용은 Apple 월렛 패스 공유하기 또는 Google 월렛 패스 공유하기를 참조하세요.

기존 패스를 캠페인에 첨부하기

독립형 패스(캠페인 외부에서 생성됨)를 캠페인에 첨부하여 공유 업데이트를 받기 시작할 수 있습니다.

Passes 탭에서 Attach passes를 클릭합니다.
User ID, 일련 번호 또는 바코드로 패스를 검색합니다.
패스를 선택하고 확인합니다.

첨부되면:

Shared fields는 캠페인을 따르기 시작하고 패스 템플릿을 변경할 때마다 업데이트됩니다.
패스에 이미 있는 Personal values(예: 사용자 세부 정보 또는 고유 잔액)는 보존됩니다.

기존 캠페인 관리하기

Campaigns → Wallet Passes → Campaigns에서 생성된 캠페인을 열면 상태, 수정 카운터, 실시간 패스 미리보기 및 세 가지 주요 탭인 Design, Passes, History가 표시됩니다.

Design, Passes, History 탭, 수정 카운터 및 Draft로 설정된 상태 드롭다운이 있는 캠페인 헤더

캠페인 상태 변경하기

상태를 사용하여 각 캠페인이 어떤 단계에 있는지 추적합니다: 아직 디자인 중인지, 활발하게 패스를 발급 중인지, 또는 완료되어 보관되었는지.

상태를 변경하려면 캠페인 헤더의 Status 드롭다운에서 옵션을 선택합니다. 변경 사항은 별도의 확인 단계 없이 즉시 저장됩니다:

Draft 또는 Active: 새 패스를 발급하고, 기존 패스를 첨부하고, 디자인 업데이트를 푸시할 수 있습니다.
Archived: 새 패스 발급을 일시 중지합니다. 캠페인이 보관된 동안에는 패스를 발급하거나 첨부할 수 없지만, 이전에 발급된 패스는 계속 작동하고 공유 업데이트를 받습니다.

Design 탭

Design 탭에서는 패스 템플릿을 업데이트하고, 색상을 변경하고, 공유 및 개인 필드를 수정하거나, 새 캠페인 이미지를 업로드할 수 있습니다.

디자인 업데이트 및 패스에 변경 사항 푸시하기

다음 중 하나를 편집하고 Save changes를 클릭하면 업데이트될 발급된 패스 수를 보여주는 확인 대화 상자가 표시됩니다:

기본 정보, 색상 또는 바코드 유형
만료 또는 위치
공유 필드
캠페인 이미지

업데이트를 확인합니다:

재정의된 패스가 없는 경우: Update를 클릭하여 모든 발급된 패스에 변경 사항을 푸시합니다.
일부 패스에 재정의가 있는 경우: 표준 패스만 업데이트할지(사용자 재정의 보존) 또는 모든 패스를 덮어쓸지 선택합니다.

업데이트를 확인하면 캠페인의 수정 카운터가 증가하고(예: Revision 2로) 변경 사항이 사용자 기기에 자동으로 동기화됩니다.

개별 패스에서 공유 필드 재정의하기

특정 사용자에 대해 공유 필드를 사용자 정의해야 하는 경우, 해당 개별 패스에서 직접 필드를 편집합니다(Passes 탭 또는 All passes에서):

재정의 생성: 개별 패스에 사용자 정의 값을 저장하면 해당 필드가 캠페인 전체 업데이트에서 분리됩니다. 향후 캠페인 업데이트는 해당 특정 필드에 대해 이 패스를 건너뜁니다.
재정의 제거: 캠페인 제어를 복원하려면 패스를 편집하고 재정의된 필드 옆에 있는 Use the campaign value를 클릭합니다.

Use the campaign value 버튼이 강조 표시된 From campaign 필드가 있는 패스 편집 화면

Overrides 열 아래의 Passes 탭에서 어떤 패스에 사용자 정의된 값이 있는지 추적할 수 있습니다.

Passes 탭

Passes 탭에는 캠페인에서 발급한 모든 패스가 나열되며, 일련 번호, 수신자 User ID, 활성 재정의, 현재 수정 버전 및 마지막 업데이트 날짜가 포함됩니다.

테이블 필터를 사용하여 특정 패스를 찾습니다:

With overrides: 하나 이상의 사용자 정의 편집 필드가 있는 패스를 표시합니다.
Behind the revision: 최신 캠페인 업데이트를 아직 받지 못한 패스를 표시합니다.

새 패스를 발급하거나 기존 패스를 첨부하려면 사용자에게 패스 발급하기를 참조하세요.

행의 작업 메뉴(⋮)를 열어 해당 패스를 관리합니다:

Edit: 플랫폼의 편집 페이지에서 패스를 열어 개인 필드를 변경하거나 공유 필드를 재정의합니다.
Download: Apple 월렛 캠페인에서 서명된 .pkpass 파일을 다운로드합니다. Google 월렛 캠페인에는 다운로드 가능한 파일에 해당하는 것이 없으므로 이 옵션이 표시되지 않습니다.
Send message: 일회성 푸시 작성기를 열어 패스 수신자에게 User ID로 메시지를 보냅니다. 그들에게 연락하는 모든 방법에 대해서는 월렛 패스 소지자에게 메시지 보내기를 참조하세요.
QR code: 사용자가 스캔하여 패스를 추가하고 업데이트를 위해 기기를 등록할 수 있는 설치 QR 코드를 표시합니다.
Copy install link: 메시징 채널에서 패스를 공유하기 위해 설치 URL을 복사합니다.
Delete: 패스를 제거합니다. 이 작업은 되돌릴 수 없습니다. Apple 월렛에서는 이미 설치된 사본이 업데이트 수신을 중단하고 다음 새로 고침 시 무효화됩니다. Google 월렛에서는 Google이 기기에 이미 저장된 패스를 강제로 제거하는 것을 허용하지 않으므로, 무효화되어 사용자의 Expired passes로 이동하고 Pushwoosh는 해당 레코드를 제거합니다. 여기서 패스를 삭제해도 캠페인이나 다른 발급된 패스는 삭제되지 않습니다.

History 탭

History 탭에는 캠페인의 모든 수정 내역이 시간순으로 나열되며, 각 버전에서 수정된 필드를 보여줍니다.

가장 최근 업데이트의 전송 상태가 탭 아래에 나타납니다:

Cancel: 아직 도달하지 않은 패스로의 업데이트 전송을 중지합니다. 이 패스들은 이전 수정 버전에 머무릅니다.
Retry failed: 업데이트에 실패한 패스(5번 시도 후 실패로 표시됨)에 대해 전송을 다시 시도합니다.

새 수정 버전이 저장되면 이전 업데이트는 더 이상 재시도하거나 취소할 수 없습니다.

캠페인 삭제하기

캠페인을 열고 페이지 오른쪽 상단의 Delete campaign을 클릭합니다.

오른쪽 상단에 Delete campaign 버튼이 강조 표시된 캠페인 작업 공간 헤더

캠페인을 삭제해도 이미 발급된 패스는 삭제되거나 무효화되지 않습니다. 발급된 패스는 현재 콘텐츠와 이미지를 유지하지만 공유 업데이트 수신을 중단합니다. 향후 변경 사항은 각 패스에서 개별적으로 이루어져야 합니다.