Wallet Pass 캠페인 생성

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

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

Wallet Pass 캠페인으로 할 수 있는 작업

Apple Wallet 또는 Google Wallet Pass 빌더에서 각 Pass를 수동으로 설정하는 대신, 캠페인에서 하나의 Pass를 디자인합니다.
어떤 필드를 모든 곳에서 업데이트(공유)하고 어떤 필드를 Pass별로 유지(개인)할지 선택합니다.
필드 편집이 저장되기 전에 얼마나 많은 발급된 Pass에 영향을 미치는지 확인합니다.
하나의 Pass에서 공유 필드를 재정의한 다음, 나중에 캠페인에 제어권을 다시 넘겨줍니다.
캠페인 외부에서 발급된 Pass를 첨부하여 공유 필드를 따르도록 합니다.
캠페인 리비전과 각 업데이트의 전달 상태를 추적합니다.
캠페인을 편집하지 않고도 필드 중 하나의 태그가 변경될 때마다 Pass를 자동으로 새로 고칩니다.

사전 요구 사항

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

Apple Wallet:

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

Google Wallet:

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

캠페인 생성

캠페인 생성을 시작하려면 캠페인 → Wallet Pass → 캠페인으로 이동하여 캠페인 생성을 클릭합니다.

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

플랫폼: 페이지 상단에서 Apple Wallet 또는 Google Wallet을 선택합니다. 이 선택은 캠페인에 대해 영구적입니다.
캠페인: 내부 참조용으로 이름과 선택적 설명을 입력합니다. 둘 다 Pass에 표시되지 않습니다.
Pass 형식: Pass 스타일(Apple) 또는 Pass 유형(Google)에서 Pass의 레이아웃을 선택합니다:
- Apple Wallet: 탑승권, 쿠폰, 이벤트 티켓, 스토어 카드, 일반. Pass 스타일 선택을 참조하세요.
- Google Wallet: 일반, 혜택, 멤버십 카드, 이벤트 티켓, 기프트 카드, 항공편, 대중교통. 생성 후에는 변경할 수 없습니다. Pass 유형 선택을 참조하세요.

이름 및 설명 필드와 Pass 스타일 선택기가 표시된 새 캠페인 생성 양식

Pass 디자인 및 브랜딩 구성

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

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

공유 및 개인 필드 설정

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

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

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

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

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

태그 동기화 켜기

태그 동기화 섹션에서 태그에서 Pass 필드 업데이트를 켜면 Pushwoosh가 주기적으로 캠페인 필드에 사용된 태그 플레이스홀더를 다시 확인하고 태그가 변경된 모든 Pass에 새로운 값을 푸시합니다.

간격(분): Pushwoosh가 태그를 다시 읽는 빈도입니다. 기본값은 60이며 5 미만으로 설정할 수 없습니다. Pass는 그 사이에 태그가 몇 번 변경되든 간에 간격당 최대 한 번의 새로 고침을 받습니다.
알림(Google Wallet만 해당): 소유자가 새로 고침에 대해 알게 되는 방법을 선택합니다: 자동, 자체 메시지(업데이트와 함께 전송되는 메시지 텍스트 채우기) 또는 Google 필드 알림(Google 자체 필드 업데이트 알림). Google은 이를 Pass당 24시간에 3개로 제한합니다. 이를 초과하면 새 값은 알림 없이 Pass에 도달합니다.

꺼짐, 자동 새로고침이 있는 Google, 사용자 지정 메시지가 있는 Google, 알림 선택기 대신 변경 메시지 메모를 보여주는 Apple의 네 가지 상태의 태그 동기화 섹션

캠페인 이미지 업로드

캠페인 이미지 섹션에서 이미지 슬롯 옆의 이미지 선택을 클릭합니다.
미디어 스토리지에서 기존 이미지를 선택하거나 새 파일을 드래그 앤 드롭하여 업로드합니다.
사용 가능한 각 이미지 슬롯에 대해 반복합니다:
- Apple Wallet: 아이콘, 로고, 배경, 바닥글, 스트립 및 썸네일 (Apple Wallet 이미지 참조).
- Google Wallet: 로고 및 히어로 이미지.

아이콘, 로고 및 사용자 지정 Pass 이미지용 업로드 슬롯이 있는 캠페인 이미지 섹션

캠페인 미리보기 및 생성

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

사용자로 미리보기 필드와 렌더링된 디지털 Pass 카드가 있는 실시간 Pass 미리보기 패널

페이지 하단의 캠페인 생성을 클릭합니다.

Pushwoosh는 초안 상태로 캠페인을 생성하고 디자인, Pass, 기록 탭이 있는 작업 공간을 엽니다.

사용자에게 Pass 발급

캠페인에서 Pass 발급

Pass 탭에서 Pass 발급을 클릭합니다.
수신자의 Pushwoosh User ID를 입력합니다.

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

Pass 발급을 클릭하여 확인합니다.

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

편집 가능한 필드: 이 사용자에 대해 변경할 수 있는 기본값과 함께 나타납니다.
태그 플레이스홀더(예: {Seat}): 대화 상자에 나타나지 않습니다. Pushwoosh는 사용자의 태그에서 자동으로 채웁니다.

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

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

기존 Pass를 캠페인에 첨부

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

Pass 탭에서 Pass 첨부를 클릭합니다.
User ID, 일련 번호 또는 바코드로 Pass를 검색합니다.
Pass를 선택하고 확인합니다.

첨부되면:

공유 필드는 캠페인을 따르기 시작하고 Pass 템플릿을 변경할 때마다 업데이트됩니다.
Pass에 이미 있는 개인 값(예: 사용자 세부 정보 또는 고유 잔액)은 보존됩니다.

기존 캠페인 관리

캠페인 → Wallet Pass → 캠페인에서 생성된 캠페인을 열면 상태, 리비전 카운터, 실시간 Pass 미리보기 및 세 가지 주요 탭인 디자인, Pass, 기록이 표시됩니다.

디자인, Pass, 기록 탭, 리비전 카운터 및 초안으로 설정된 상태 드롭다운이 있는 캠페인 헤더

캠페인 상태 변경

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

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

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

디자인 탭

디자인 탭에서 Pass 템플릿을 업데이트하고, 색상을 변경하고, 공유 및 개인 필드를 수정하고, 새 캠페인 이미지를 업로드하거나, 태그 동기화 설정을 변경할 수 있습니다.

디자인 업데이트 및 Pass에 변경 사항 푸시

디자인 탭에서 기본 정보, 색상, 바코드 유형, 만료, 위치, 공유 필드 또는 캠페인 이미지를 편집합니다.
변경 사항 저장을 클릭합니다.
캠페인 편집 적용 대화 상자에서 업데이트를 확인합니다:
- 변경된 필드를 재정의하는 Pass가 없는 경우: N개 업데이트, 수동 편집 유지를 클릭하여 모든 N개의 Pass에 편집 내용을 푸시합니다.
- 일부 Pass가 변경된 필드를 재정의하는 경우: 대화 상자에 필드 이름과 이를 재정의하는 Pass 수가 표시됩니다. N개 업데이트, 수동 편집 유지를 클릭하여 해당 Pass를 제외한 모든 Pass에 편집 내용을 푸시하거나, 모든 N개 덮어쓰기를 클릭하여 재정의된 Pass를 포함한 모든 N개의 Pass에 푸시합니다. 덮어쓰면 재정의가 지워집니다.

1개의 Pass에서 재정의된 장소 필드를 나열하는 캠페인 편집 적용 대화 상자, '3개 업데이트, 수동 편집 유지' 및 '모든 4개 덮어쓰기' 버튼이 있음

어떤 버튼을 클릭하든 업데이트는 새 리비전(예: 리비전 2)으로 저장되므로 기록 탭에서 무엇이 언제 변경되었는지 확인할 수 있습니다.

리비전 2 행이 강조 표시된 기록 탭, 변경된 필드 키와 생성 타임스탬프가 표시됨

개별 Pass에서 공유 필드 재정의

특정 사용자에 대해 공유 필드를 사용자 지정해야 하는 경우, 해당 개별 Pass에서 직접 필드를 편집합니다(Pass 탭 또는 모든 Pass에서):

재정의 생성: 개별 Pass에 사용자 지정 값을 저장하면 해당 필드가 캠페인 전체 업데이트에서 분리됩니다. 예약된 태그 동기화 새로 고침을 포함한 향후 캠페인 업데이트는 해당 특정 필드에 대해 이 Pass를 건너뜁니다.
재정의 제거: 캠페인 제어를 복원하려면 Pass를 편집하고 재정의된 필드 옆의 캠페인 값 사용을 클릭합니다.

'캠페인 값 사용' 버튼이 강조 표시된 '캠페인에서' 필드를 보여주는 Pass 편집 화면

고정된 필드 열 아래의 Pass 탭에서 어떤 Pass에 사용자 지정된 값이 있는지 추적할 수 있습니다.

Pass 탭

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

태그 동기화가 켜져 있으면 탭에는 마지막 예약 실행 날짜와 시간이 포함된 태그 동기화됨 줄이 테이블 위에 표시되거나, 첫 번째 실행 전에는 아직 안 됨으로 표시됩니다.

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

고정된 필드 있음: 사용자 지정 편집된 필드가 하나 이상 있는 Pass를 표시합니다.
리비전 뒤처짐: 최신 캠페인 업데이트를 아직 받지 못한 Pass를 표시합니다.

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

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

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

기록 탭

기록 탭에는 캠페인의 모든 리비전이 시간순으로 나열되며, 각 버전에서 어떤 필드가 수정되었는지 보여줍니다.

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

취소: 아직 도달하지 않은 Pass로의 업데이트 전송을 중지합니다. 이 Pass들은 이전 리비전에 남아 있습니다.
실패한 항목 재시도: 업데이트에 실패한 Pass(5회 시도 후 실패로 표시됨)에 대한 전달을 다시 시도합니다.

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

캠페인 삭제

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

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