Wallet 패스 관리

패스를 생성한 후에는 모든 패스 목록에서 패스를 관리합니다. 패스를 편집하고, 설치 링크나 QR 코드를 가져오고, 더 이상 필요하지 않으면 삭제할 수 있습니다. 패스 소지자는 사용자 탐색기에 표시되므로 누가 패스를 추가했는지 확인할 수 있습니다. 사용자에게 패스를 보내려면 Wallet 패스 공유를 참조하세요.

기존 패스 보기 및 관리

Apple Wallet

1. Control Panel에서 캠페인 → 월렛 패스로 이동합니다.
2. 모든 패스 탭을 열고 Apple Wallet을 선택합니다.
3. 패스를 찾으려면 User ID나 일련번호로 검색하거나 캠페인별로 목록을 필터링합니다.

애플리케이션의 각 패스에 대해 표에는 다음이 표시됩니다.

• 패스 이름 및 스타일
• 연결된 User ID
• 캠페인에서 발급되었는지 여부
• 마지막 업데이트 날짜 및 시간

패스 목록에서 작업 메뉴(⋮)를 열어 다음을 수행할 수 있습니다.

• 편집: 패스 이름 및 설명, 필드 값 및 레이블, 변경 메시지, 색상, 바코드 메시지, 만료 및 상태, 위치, 비콘을 업데이트합니다. 패스 스타일과 이미지는 생성 후 잠깁니다. 변경 사항 저장을 클릭하면 패스를 추가한 모든 기기가 업데이트를 받으며, 사용자는 패스를 다시 추가할 필요가 없습니다. 변경 사항을 소지자에게 알리려면 Apple Wallet 변경 메시지를 참조하세요.

• 다운로드: 서명된 .pkpass 파일을 다운로드합니다.

• 메시지 보내기: 일회성 푸시 작성기를 열어 User ID로 패스 소지자에게 메시지를 보냅니다. 이 옵션을 사용하려면 애플리케이션에서 메시지를 보낼 권한이 필요하며, 패스에 User ID가 없으면 사용할 수 없습니다. 소지자에게 도달하는 모든 방법은 Wallet 패스 소지자에게 메시지 보내기를 참조하세요.

• QR 코드: 사용자가 스캔하여 Wallet에 패스를 추가하고 업데이트를 받도록 기기를 등록할 수 있는 설치 QR 코드를 표시합니다. 이 창에서는 QR 아래의 설치 링크 복사도 사용할 수 있습니다.

• 설치 링크 복사: 메시징 채널에서 패스를 공유할 수 있도록 설치 URL을 복사합니다. 자세히 알아보기.

• 삭제: 패스를 제거합니다. 기기에 이미 설치된 사본은 업데이트를 더 이상 받지 않으며 다음 새로 고침 시 무효화됩니다.

Google Wallet

1. Control Panel에서 캠페인 → 월렛 패스로 이동합니다.
2. 모든 패스 탭을 열고 Google Wallet을 선택합니다.

애플리케이션의 각 패스에 대해 표에는 다음이 표시됩니다.

• 패스 이름 및 스타일
• 연결된 User ID
• 패스 상태
• 마지막 업데이트 시점

패스 목록에서 작업 메뉴(⋮)를 열어 다음을 수행할 수 있습니다.

• 편집: 필드 값 및 레이블, 색상, 로고 및 히어로 이미지, 바코드, 링크, 앱 링크, 위치, 만료일을 변경합니다. 패스 유형은 생성 후 잠깁니다. 패스 저장 권한 항목은 편집 페이지에 표시되지만, 값을 변경하면 저장할 때 거부됩니다. 저장하면 패스를 저장한 모든 기기가 업데이트를 받습니다.

  • 변경된 필드에 대해 알림: 로열티, 이벤트 티켓, 항공권 패스의 편집 페이지에서는 이 체크박스가 기본적으로 선택되어 있습니다. 선택되어 있으면 Google이 소지자에게 Android 알림을 보냅니다. 알림 텍스트는 Google이 변경된 필드를 바탕으로 작성합니다. 알림 제한은 Google Wallet 알림을 참조하세요.

• 메시지 보내기: 일회성 푸시 작성기를 열어 User ID로 패스 소지자에게 메시지를 보냅니다. Apple Wallet과 마찬가지로 메시지를 보낼 권한과 패스의 User ID가 필요합니다. 소지자에게 도달하는 모든 방법은 Wallet 패스 소지자에게 메시지 보내기를 참조하세요.

• QR 코드: 패스 저장 링크를 인코딩한 QR 코드를 표시합니다. 사용자는 이를 스캔하여 Google Wallet에 패스를 저장하고 업데이트를 받도록 기기를 등록합니다.

• 설치 링크 복사: 메시징 채널에서 공유할 수 있도록 패스 저장 링크를 복사합니다. 자세히 알아보기.

• 무효화: 확인 없이 활성 패스를 즉시 비활성으로 설정합니다. 패스는 사용자의 Google Wallet에 있는 만료된 패스 섹션으로 이동합니다. 기록은 Pushwoosh에 남아 있습니다.

• 활성화: 비활성 패스를 다시 활성으로 설정합니다. 이 옵션은 패스가 비활성일 때만 작업 메뉴에 나타납니다. 패스는 Google Wallet에서 복원됩니다.

• 삭제: Google에서 패스를 무효화하고 Pushwoosh에서 해당 기록을 제거합니다. Google은 기기에 이미 저장된 패스를 강제로 제거하는 것을 허용하지 않습니다. 패스는 무효화되어 만료된 패스로 이동합니다.

패스 업데이트를 소지자에게 알리기

패스를 편집하고 저장하면 별도의 메시지 없이 패스를 추가한 모든 기기에 새 버전이 전송됩니다. 변경 사항을 소지자에게 알리는 방법은 플랫폼마다 다릅니다.

Apple Wallet 변경 메시지

소지자에게 알리려는 필드마다 변경 메시지 (업데이트 알림) 항목을 설정합니다. iOS는 이를 잠금 화면 메시지로 표시합니다. 변경 메시지가 없는 필드는 알림 없이 업데이트됩니다.

1. 캠페인 → 월렛 패스에서 모든 패스 → Apple Wallet을 열고 패스를 찾은 다음 작업 메뉴에서 편집을 클릭합니다.
2. 필요한 필드를 변경하고, 소지자에게 알리려는 필드에 변경 메시지를 추가합니다.
3. 변경 사항 저장을 클릭합니다.

Google Wallet 알림

로열티, 이벤트 티켓, 항공권 패스의 경우 변경된 필드에 대해 알림을 활성화하면 Google이 동기화와 함께 Android 알림을 보냅니다. 다른 패스 유형은 알림 없이 동기화됩니다.

1. 캠페인 → 월렛 패스에서 모든 패스 → Google Wallet을 열고 패스를 찾은 다음 작업 메뉴에서 편집을 클릭합니다.
2. 필요한 필드를 변경합니다.
3. 변경된 필드에 대해 알림 체크박스가 선택되어 있는지 확인합니다.
4. 변경 사항 저장을 클릭합니다.

Google 알림에는 다음과 같은 제한이 있습니다.

• 알림 텍스트는 Google이 생성합니다. Apple Wallet 변경 메시지처럼 사용자 지정할 수 없습니다.
• 이벤트 및 항공권 패스의 경우 시작 시간까지 3시간 미만이 남았을 때만 알림이 발생합니다.
• Google은 패스당 24시간에 최대 3개의 알림을 허용합니다. 한도에 도달하면 패스는 알림 없이 업데이트됩니다.

API를 통한 패스 관리

패스 빌더에서 할 수 있는 모든 작업은 프로그래밍 방식으로도 가능합니다. 패스 생성, 업데이트, 목록 조회, 삭제가 가능합니다. Apple Wallet API로는 .pkpass 파일도 다운로드할 수 있습니다. Google Wallet API는 저장 링크도 반환하고 패스 상태도 설정합니다.

패스 하나를 업데이트하고 소지자에게 알리려면 Update a pass(Apple Wallet, Google Wallet)를 호출합니다. 이 호출은 패스를 업데이트하고 기기에 알립니다. Google Wallet에서는 notifyMessage를 설정하면 업데이트와 함께 사용자 지정 알림을 보낼 수 있습니다. 설정하지 않으면 패스는 알림 없이 동기화되며, 단 notifyOnUpdate가 설정된 경우에는 Google이 로열티, 이벤트 티켓, 항공권 패스에 대해 변경된 필드에 관한 자체 알림을 보냅니다.

Apple Wallet PassKit API

Google Wallet API

사용자 탐색기에서 패스 소지자 보기

사용자가 패스를 추가하면 Pushwoosh는 사용자 탐색기의 기기 및 플랫폼 탭에 이를 표시합니다.

1. 오디언스 → 사용자 탐색기로 이동하여 사용자 프로필을 엽니다.
2. 기기 및 플랫폼 탭을 엽니다.
3. 사이드바에서 Apple Wallet 또는 Google Wallet을 선택합니다.

플랫폼 프로필에서 다음을 확인할 수 있습니다.

• 구독 상태: 예: 구독됨
• 플랫폼 식별자: 플랫폼 이름 아래에 표시되는 패스 식별자
• 메타데이터: 첫 구독, 시간대 및 기타 사용 가능한 필드
• 태그: 패스를 발급할 때 설정한 태그를 포함한 플랫폼 태그

자세히 알아보기