Google Wallet 패스 빌더

Google Wallet 패스 빌더는 Control Panel에 있는 시각적 디자이너입니다. 패스 유형을 선택하고, 브랜딩, 필드, 바코드를 채우고, 실시간 미리보기를 확인한 후 패스를 생성합니다. 패스를 생성하면 Pushwoosh가 Google Wallet에 패스 객체를 생성하고 ‘Google Wallet에 추가’ 저장 링크를 반환합니다.

패스 생성하기

먼저 구성이 필요합니다

빌더는 애플리케이션에 대해 Google Wallet이 구성된(발급자 ID가 설정되고 Pushwoosh 서비스 계정이 발급자에 초대된) 후에만 사용할 수 있습니다. 아직 구성되지 않았다면 먼저 설정하세요: Android용 Google Wallet 패스 구성.

Control Panel에서 캠페인 → 월렛 패스로 이동하여 전체 패스 탭을 열고 Google Wallet을 선택한 다음 패스 생성을 클릭합니다.

패스 구성하기

• 처음부터: 빈 패스로 시작합니다. 패스 유형을 선택한 다음 아래 섹션에서 필드, 모양, 바코드 및 기타 옵션을 직접 설정합니다.

• 템플릿에서: 템플릿 로드를 클릭하고 템플릿 선택에서 내장된 패스(일반, 쿠폰, 멤버십, 이벤트 티켓, 기프트 카드, 항공권 또는 교통권)를 선택합니다. 템플릿은 클릭하는 즉시 적용됩니다. 양식에 패스 유형, 필드, 색상 및 바코드가 미리 채워지고 자리 표시자 로고가 설정됩니다. 패스를 생성하기 전에 로고를 직접 준비한 로고로 바꾸세요. 그렇지 않으면 자리 표시자 로고가 패스에 그대로 포함됩니다. 필요에 따라 값을 편집하거나 유형을 변경할 수 있습니다.

패스 유형 선택하기

패스 유형에서 7가지 Google Wallet 패스 유형 중 하나를 선택합니다. 유형에 따라 카드 레이아웃과 사용 가능한 필드가 결정됩니다. 유형이 지정된 패스는 Google의 기본 레이아웃을 사용합니다. 일반 패스는 자유 형식입니다. 패스를 생성한 후에는 유형을 변경할 수 없습니다.

• 일반: 직접 만든 필드로 구성된 자유 형식 카드입니다.
• 쿠폰: 쿠폰 및 할인입니다.
• 멤버십 카드: 멤버십 및 회원 카드입니다.
• 이벤트 티켓: 이벤트 티켓입니다.
• 기프트 카드: 기프트 및 선불 카드입니다.
• 항공권: 탑승권입니다.
• 교통권: 철도, 버스, 트램 및 페리 티켓입니다.

패스 필드 채우기

표시되는 필드는 패스 유형에 따라 다릅니다. 빌더는 필수 필드를 표시하지 않지만 패스 검증과 생성을 실행하면 비어 있는 필수 필드가 보고됩니다. 유형별 공통 필드:

패스 유형	주요 필드
일반	카드 제목*, 헤더*, 서브헤더, 카드에 최대 6개 필드
쿠폰	제목*, 제공자*, 세부 정보, 약관, 사용 채널(BOTH, INSTORE, ONLINE 또는 TEMPORARY_PRICE_REDUCTION), 발급자 이름
멤버십	프로그램 이름*, 회원 이름, 회원 ID, 포인트 잔액, 포인트 라벨, 리워드 등급, 등급 라벨, 발급자 이름
이벤트 티켓	이벤트 이름*, 장소, 주소, 시작, 종료, 티켓 소지자, 티켓 번호, 티켓 종류, 구역, 열, 좌석, 게이트
기프트 카드	가맹점*, 카드 번호*, PIN, 잔액 + 통화
항공권	항공사(IATA 코드), 항공편 번호, 출발지*, 도착지*, 출발 시간*, 승객 이름*, 탑승 시간, 좌석, 클래스, 탑승 그룹, 확인 코드
교통권	유형*(버스/철도/트램/페리/기타), 운영사*(발급처 이름이 설정되지 않은 경우), 승객*, 여행 유형, 여정 구간(출발지*, 도착지*, 시간, 플랫폼, 객차, 좌석), 발급처 이름

* Google 필수 항목입니다.

날짜 및 시간

대부분의 패스 유형은 UTC 오프셋이 있는 ISO 8601을 사용합니다(예: 2026-07-01T19:30:00+02:00). 항공권 패스는 예외입니다. Google은 출발, 탑승 및 도착 시간을 오프셋 없이 공항의 현지 시간으로 요구합니다(예: 2026-09-01T06:30:00).

패스 콘텐츠 개인화하기

각 패스는 하나의 User ID에 연결됩니다. 태그 자리 표시자를 사용하여 해당 사용자에게 고유한 데이터(예: 멤버십 카드의 포인트 잔액 또는 기프트 카드의 수신자 이름)를 표시합니다. 각 수신자가 자신의 값을 받을 수 있도록 User ID당 하나의 패스를 발급합니다.

태그 자리 표시자를 삽입하려면:

1. 지원되는 텍스트 필드(예: 판매자, 카드 제목 또는 헤더) 옆에 있는 {}를 클릭하여 태그를 삽입합니다.
2. 태그에서 필드에 삽입할 태그를 선택합니다.
3. 형식에서 태그 값을 표시할 방법을 선택합니다: 있는 그대로(저장된 값 사용), 정수(정수로 반올림), 가격 (0.00)(소수점 두 자리 표시), 첫 글자를 대문자로, 날짜 (5 Aug 1980), 날짜 및 시간 (5 Aug 1980 14:30) 또는 시간 (14:30).
4. 대체 값 (비어 있는 경우) 필드에서 수신자가 태그에 대한 값이 없을 때 표시할 텍스트를 선택적으로 입력합니다.
5. 삽입을 클릭합니다.

Pushwoosh는 패스를 생성할 때 태그 값을 채우고 업데이트할 때마다 새로 고칩니다.

모양 설정하기

모양에서 색상, 이미지, 패스를 저장할 수 있는 사람 및 만료를 구성합니다.

색상

배경색을 클릭하고 색상 선택기에서 색상을 선택합니다.

이미지

로고 옆의 이미지 선택을 클릭하여 애플리케이션의 미디어 스토리지에서 이미지를 선택하거나, 새 이미지를 업로드하거나, 스톡 사진 또는 AI 생성으로 이미지를 가져옵니다. 선택기는 PNG 및 JPEG 파일을 지원합니다. 로고는 멤버십 및 교통권 패스에 필수입니다.

선택적으로 히어로 이미지 옆의 이미지 선택을 클릭하여 패스 앞면의 카드 세부 정보 아래에 표시되는 넓은 배너를 선택합니다. 권장 크기는 1032×336 픽셀입니다.

애플리케이션의 미디어 스토리지에 해당 배치에 맞게 이미 크기가 조정된 크롭이 있으면 그 크롭을 선택하세요.

미디어 스토리지에서 이미지 삭제

미디어 스토리지는 Wallet Pass 캠페인이 이미지를 사용하는 동안에만 해당 이미지의 삭제를 차단합니다. 단일 패스에 선택한 이미지는 보호되지 않으므로 패스를 사용하는 동안에는 미디어 스토리지에 이미지를 유지하세요.

패스를 저장할 수 있는 사람

패스 저장 권한에서 Google Wallet에 패스를 추가할 수 있는 사람을 선택합니다. 패스를 생성한 후에는 이 설정을 변경할 수 없습니다.

• 한 명의 사용자, 모든 기기(기본값): 패스는 하나의 Google 계정에 연결되며 해당 계정의 모든 기기에서 동기화됩니다.
• 한 명의 사용자, 하나의 기기: 패스는 단일 기기에만 저장됩니다.
• 링크가 있는 모든 사용자: 저장 링크를 여는 모든 Google 계정은 동일한 공유 패스 객체를 받습니다. 패스를 업데이트하면 Google은 모든 소지자에게 자동으로 변경 사항을 전달합니다.

링크가 있는 모든 사용자

모든 소지자가 동일한 콘텐츠를 보는 패스(예: 매장 전체 쿠폰 또는 좌석이 지정되지 않은 공개 이벤트 티켓)에 이 옵션을 사용하세요. 멤버십 카드, 기프트 카드 또는 사용자별로 콘텐츠를 개인화해야 하는 모든 패스에는 사용하지 마세요. Pushwoosh는 공유 객체에 대해 하나의 기기만 추적하므로 개별 소지자는 보이지 않으며 별도로 타겟팅할 수 없습니다.

만료

Google이 패스를 만료시켜야 할 때를 만료일로 설정하거나, 만료가 없는 경우 비워 둡니다.

바코드 추가하기

바코드에서 형식을 선택하고 인코딩할 값을 입력합니다:

1. 형식: 바코드의 모양과 읽을 수 있는 스캐너 유형을 선택합니다.
   • QR_CODE: 대부분의 휴대폰과 스캐너가 쉽게 읽을 수 있는 사각형 코드입니다. 대부분의 패스에 가장 적합합니다.
   • PDF_417: 여러 줄의 선으로 구성된 넓은 바코드입니다. 탑승권에 종종 필요합니다.
   • AZTEC: QR과 유사한 소형 사각형 코드입니다. 이벤트 및 교통 티켓에 흔히 사용됩니다.
   • CODE_128 / EAN_13: 1D 바코드입니다. 스캐너나 POS 시스템에서 요구하는 경우에만 선택하세요.
2. 값: 바코드에 인코딩된 데이터입니다(예: 티켓 또는 회원 번호). 사용자별로 고유한 값을 사용하려면 필드 옆의 {}를 클릭하고 태그 자리 표시자를 삽입합니다.
3. 대체 텍스트: 패스의 바코드 아래에 표시되는 텍스트입니다.

세부 정보 필드 및 링크 추가하기

패스 앞면에서 사용자는 메인 카드를 봅니다. 패스 세부 정보(뒷면)를 열면 여기에 추가한 추가 섹션을 읽고 링크를 탭할 수 있습니다.

• 상세 정보 필드: 패스 뒷면에 있는 추가 텍스트입니다. + 필드 추가를 클릭하고 레이블과 값을 설정합니다. 약관, 지침 또는 앞면에 맞지 않는 기타 정보에 사용합니다.
• 링크: 패스 뒷면에 있는 탭 가능한 링크입니다. + 링크 추가를 클릭한 다음 URL과 짧은 링크 레이블(예: “매장 찾기” 또는 “이용 약관”)을 설정합니다.

앱 링크 추가하기 (선택 사항)

앱 링크에서 패스 앞면에 버튼을 추가하여 탭하면 웹 페이지나 Android 앱이 열리도록 합니다. URL, Android 패키지 이름 또는 둘 다 설정할 수 있습니다.

URL만 설정하면 버튼은 모든 기기에서 해당 웹 주소를 엽니다. 패키지 이름만 설정하면 버튼은 앱이 설치된 Android 기기에서 작동하며 웹 대체 기능은 없습니다. URL은 https://로 시작해야 합니다.

패스를 생성한 후에는 앱 링크를 변경할 수 있지만 삭제할 수는 없습니다.

위치 추가하기 (선택 사항)

위치 기반 관련성에서 관심 지점을 추가합니다. 사용자가 추가한 위치 근처에 있을 때 Google은 지오펜스 알림을 표시합니다. 예를 들어, 매장 근처에서는 멤버십 카드를, 공연장 근처에서는 이벤트 티켓을, 공항 근처에서는 탑승권을 표시합니다.

위치를 최대 10개까지 추가할 수 있습니다. 위치를 추가하려면 지도를 클릭하거나, 주소를 검색하거나, 좌표를 붙여넣거나, 지오존을 가져옵니다.

Google Wallet의 위치

Google은 지오펜스 반경을 제어하고 알림을 표시할 시기를 결정합니다. 위치별 최대 거리를 설정할 수 없습니다.

User ID 입력하기

이 패스를 받을 사람의 Pushwoosh User ID를 입력합니다.

Pushwoosh는 해당 사용자에게 패스를 발급하고 모든 패스의 사용자 아래에 목록을 표시합니다.

미리보기 및 유효성 검사

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

기기에서는 미리보기가 다를 수 있습니다

미리보기는 근사치입니다. 유형이 지정된 패스는 Google의 기본 레이아웃을 사용하므로 실제 기기에서는 패스가 다르게 보일 수 있습니다. 미리보기의 QR 코드는 실제 값을 인코딩하며, 다른 바코드 형식은 자리 표시자로 표시됩니다.

패스를 생성하지 않고 Google의 요구 사항과 비교하여 확인하려면 패스 검증을 클릭합니다. 빌더는 누락된 필수 필드 및 기타 문제를 표시합니다.

패스 생성하기

생성을 클릭합니다. Pushwoosh는 패스를 확인하고 Google Wallet에서 생성합니다. 사용자와 공유할 수 있는 Google Wallet에 추가 저장 링크를 받게 됩니다. 몇 초 내에 패스가 모든 패스에 나타납니다.

생성 후 패스 편집, 저장 링크 받기, 무효화 및 삭제에 대한 정보는 기존 패스 관리를 참조하세요. 사용자에게 패스를 보내려면 Wallet 패스 공유를 참조하세요.

하나의 디자인을 여러 사용자에게 발급하고 발급된 모든 패스의 공유 필드를 한 번에 업데이트하려면 대신 Wallet Pass 캠페인을 생성하세요. 캠페인은 이 빌더와 동일한 디자인 섹션을 사용합니다.

API를 통해 패스 관리하기

패스 빌더가 수행하는 모든 작업은 Google Wallet API를 통해서도 가능합니다: 패스 생성, 업데이트, 목록 조회, 저장 링크 받기, 상태 설정 및 삭제.

Google Wallet API