패스 빌더에서 패스 디자인하기

Apple Wallet 패스 빌더는 Control Panel에 있는 시각적 디자이너입니다. 패스 스타일을 선택하고, 브랜딩, 필드, 바코드를 채우고, 실시간 미리보기를 확인한 후, 서명된 .pkpass를 생성할 수 있습니다. pass.json을 직접 작성할 필요가 없습니다.

패스 생성하기

Control Panel에서 Campaigns → Apple Wallet으로 이동하여 **패스 생성(Create pass)**을 클릭합니다.

패스 이름, 스타일, 사용자, 마지막 업데이트 열이 있는 테이블과 패스 생성 버튼이 있는 모든 패스 페이지

패스 구성하기

처음부터 만들기: 빈 패스로 시작합니다. 패스 스타일을 선택한 다음, 아래 섹션에서 색상, 이미지, 필드, 바코드 및 기타 옵션을 직접 설정합니다.
템플릿에서 만들기: **템플릿 로드(Load template)**를 클릭하고, **템플릿 선택(Select Template)**에서 내장된 패스(탑승권, 쿠폰, 이벤트 티켓, 일반 또는 스토어 카드)를 선택한 후 확인합니다. 양식에 패스 스타일, 색상, 이미지, 패스 필드, 바코드 및 기본 정보가 미리 채워집니다. 필요에 따라 값을 편집하거나 스타일을 변경할 수 있습니다. Pushwoosh는 템플릿의 팀 및 패스 유형 ID를 애플리케이션의 값으로 대체합니다.

패스 스타일 선택하기

**패스 스타일(PASS STYLE)**에서 5가지 Apple Wallet 패스 스타일 중 하나를 선택합니다. 스타일은 레이아웃과 사용 가능한 필드 영역 및 이미지를 제어합니다.

탑승권(Boarding Pass)
쿠폰(Coupon)
이벤트 티켓(Event Ticket)
스토어 카드(Store Card)
일반(Generic)

처음부터 시작하는 경우, 필드와 이미지를 추가하기 전에 스타일을 선택하세요. 스타일을 전환하면 스타일에 특화된 필드가 초기화됩니다.

패스 이름 및 설명 추가하기

**기본 정보(BASIC INFORMATION)**에서 다음을 입력합니다.


패스 이름(Pass Name)	패스 제목이며, 업데이트 알림에 표시되는 소스 이름입니다.
설명(Description)	패스에 대한 간략한 설명입니다.
로고 텍스트(Logo Text)	로고 옆에 표시되는 텍스트입니다(로고 이미지가 업로드되지 않았을 때 사용됨).

색상 및 이미지 설정하기

색상

**색상(COLORS)**에서 다음을 설정합니다.

배경색(Background Color): 패스 배경입니다.
전경색(Foreground Color): 패스의 주요 텍스트 및 아이콘입니다.
레이블 색상(Label Color): 필드 레이블의 색상입니다(예: FROM, GATE).

색상을 설정하거나 변경하려면 해당 필드를 클릭하고 색상 선택기에서 색상을 선택합니다.

이미지

**이미지(IMAGES)**에서 **아이콘(Icon)**과 **로고(Logo)**를 업로드합니다(둘 다 필수). 선택적 이미지는 패스 스타일에 따라 다릅니다.

각 이미지 슬롯 옆의 **파일 선택(Choose file)**을 클릭합니다. PNG 또는 JPEG 파일을 업로드합니다. Pushwoosh는 패스를 생성할 때 각 이미지를 Apple이 요구하는 해상도(@1x, @2x, @3x)로 처리합니다.

패스 필드 채우기

**패스 필드(PASS FIELDS)**에서 패스에 표시되는 텍스트와 값을 추가합니다. 표시되는 그룹은 패스 스타일에 따라 다릅니다.

헤더 필드(패스 상단): 탑승권, 이벤트 티켓
기본 필드(주요 콘텐츠): 모든 스타일
보조 필드(지원 정보): 모든 스타일
추가 필드(추가 세부 정보): 모든 스타일
뒷면 필드(패스 뒷면): 모든 스타일

필요한 각 그룹에서 **+ 필드 추가(+ Add Field)**를 클릭합니다.

각 필드에 대해 다음을 설정합니다.


키(ID)	고유한 필드 식별자입니다(자동으로 생성됨).
레이블	패스에 표시되는 짧은 레이블입니다(예: `FROM`).
값	패스에 표시되는 값입니다(예: `SFO`).
변경 메시지	이 값이 변경될 때 업데이트 알림에 표시되는 텍스트입니다. 값이 변경될 때만 표시됩니다. 새 값에는 `%@`를 사용합니다(예: `게이트가 %@(으)로 변경되었습니다`).

필드 카드에서 **서식(Format)**을 클릭하여 서식 옵션을 표시합니다. 필드를 제거하려면 X를 클릭합니다.

서식 옵션

값 형식: 텍스트, 날짜 및 시간 또는 숫자/통화.
텍스트 정렬: 기본값(자연스러움), 왼쪽, 가운데 또는 오른쪽.
데이터 탐지기 (뒷면 필드만 해당): 뒷면 필드의 전화번호, 링크, 주소, 캘린더 이벤트를 탭할 수 있는 콘텐츠로 전환합니다.

바코드 추가하기

**바코드(BARCODE)**에서 형식을 선택하고 인코딩할 데이터를 입력합니다.

바코드 형식: 바코드 모양과 어떤 유형의 스캐너가 읽을 수 있는지 선택합니다.
- QR 코드(권장): 대부분의 휴대폰과 스캐너가 쉽게 읽을 수 있는 정사각형 코드입니다. 쿠폰, 멤버십 카드 및 대부분의 패스에 가장 적합합니다.
- PDF417: 여러 줄의 선으로 구성된 넓은 바코드입니다. 항공사 또는 대중교통 탑승권에 종종 필요합니다.
- Aztec: QR과 유사한 소형 정사각형 코드입니다. 이벤트 및 대중교통 티켓에 일반적입니다.
- Code 128: 고전적인 수직선 바코드입니다. 스캐너나 POS 시스템에서 1D 바코드를 요구하는 경우에만 선택하세요.
바코드 메시지: 바코드에 인코딩된 값입니다(예: 티켓 또는 멤버십 번호).
대체 텍스트(선택 사항): 패스의 바코드 아래에 표시되는 텍스트입니다.

형식 드롭다운, 바코드 메시지 필드, 선택적 대체 텍스트 필드가 있는 바코드 섹션

만료 및 상태 설정하기

**만료 및 상태(EXPIRATION & STATUS)**에서 패스가 표시되는 시점, 만료 시점, 유효 여부를 제어합니다.

관련 날짜(패스 표시 시점): 패스가 잠금 화면에 나타날 수 있는 날짜 및 시간입니다.
만료 날짜(패스 만료 시점): 이 날짜 및 시간 이후에는 Wallet에서 패스가 회색으로 표시됩니다.
무효로 표시(이 패스 무효화): 패스를 더 이상 사용할 수 없도록 무효화하는 체크박스입니다.

스타일에 특화된 고급 옵션

교통 수단 유형 (탑승권만 해당): 항공, 기차, 버스, 보트 또는 일반.
그룹화 식별자: 관련된 패스를 Wallet에서 함께 그룹화합니다.

위치 기반 관련성 (선택 사항)

**위치 기반 관련성(LOCATION-BASED RELEVANCE)**에서 사용자가 추가한 위치 근처에 있을 때 패스가 나타납니다. 각 위치에 대해 사용자가 근처에 있을 때 잠금 화면에 표시될 텍스트를 설정합니다. 최대 10개의 위치를 추가할 수 있습니다.

지도를 클릭하거나, 주소를 검색하거나, 좌표를 붙여넣거나, 지오존을 가져와 지점을 추가합니다. 마커를 드래그하여 위치를 미세 조정합니다.

최대 거리(미터 단위)는 패스가 관련성을 유지하기 위해 사용자가 얼마나 가까이 있어야 하는지를 제어합니다.

지도, 위치 목록, 잠금 화면 텍스트, 최대 거리 필드가 있는 위치 기반 관련성 섹션

사용 사례 예시

소매: 고객이 매장 근처에 있을 때 멤버십 카드나 쿠폰이 나타납니다. 잠금 화면 텍스트는 매장 근처에 있다는 것을 알리고 패스 사용을 상기시킬 수 있습니다.
이벤트: 사용자가 행사장(경기장, 극장 또는 축제장) 근처에 있을 때 이벤트 티켓이 나타나 문 앞에서 패스를 빠르게 찾을 수 있습니다.
여행: 출발 공항이나 터미널 근처에서 탑승권이 눈에 띄게 되어 승객이 Wallet을 열기 전에 잠금 화면에서 게이트나 항공편 세부 정보를 볼 수 있습니다.
호텔/식당: 정의한 카페나 호텔 위치 근처에서 쿠폰이나 멤버십 패스가 나타날 수 있습니다.

User ID 입력하기

이 패스를 받을 사람의 Pushwoosh User ID를 입력합니다. Pushwoosh는 해당 사용자에게 패스를 발급하고 **모든 패스(All passes)**의 사용자(USER) 아래에 목록으로 표시합니다.

미리보기 및 유효성 검사

실시간 미리보기는 편집하는 동안 업데이트되므로 Wallet에서 패스가 어떻게 보일지 대략적으로 확인할 수 있습니다.

패스를 생성하지 않고 Apple의 사양과 비교하여 확인하려면 **패스 유효성 검사(Validate pass)**를 클릭합니다. 빌더는 누락된 필수 이미지 및 기타 문제를 표시합니다.

패스 생성하기

**생성(Generate)**을 선택합니다. Pushwoosh는 패스의 유효성을 검사하고, 이미지를 처리하며, 패키지에 서명합니다. 생성에는 몇 초가 걸리며, 그 후 패스가 패스 목록에 나타납니다.

생성 후 패스 편집(일련 번호로 업데이트 포함), 다운로드, 공유 및 삭제에 대해서는 기존 패스 관리하기를 참조하세요.

API를 통해 패스 관리하기

패스 빌더가 수행하는 모든 작업은 PassKit Designer API를 통해서도 가능합니다: 패스 생성, 업데이트, 목록 조회, 다운로드 및 삭제.

Apple Wallet PassKit API