# Google Wallet 패스 시작하기

Google Wallet 패스는 사용자가 Google Wallet 앱에 보관하는 멤버십 카드, 쿠폰, 기프트 카드, 이벤트 티켓, 탑승권, 교통카드와 같은 디지털 카드입니다.

Pushwoosh를 사용하면 Control Panel에서 패스를 디자인하고 사용자에게 전송하며 언제든지 패스를 업데이트할 수 있습니다. 변경 사항은 저장된 모든 기기에 자동으로 동기화됩니다.

## Google Wallet 패스로 할 수 있는 작업

* [패스 빌더](/ko/product/messaging-channels/google-wallet-passes/pass-builder/)에서 패스 디자인하기
* 저장 링크 또는 QR 코드를 사용자와 공유하기
* 언제든지 패스 업데이트하기. Google은 변경 사항을 저장된 모든 기기에 동기화합니다
* 일회성 푸시, 패스 업데이트 알림 또는 Customer Journey를 통해 [패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/google-wallet-passes/message-pass-holders/)

## 사전 요구 사항

* [Google Pay & Wallet Console](https://pay.google.com/business/console) 발급기관 계정
* 서비스 계정 키가 있는 Google Cloud 프로젝트

## Google Wallet 패스 작업 시작하기

[사전 요구 사항](#prerequisites)이 준비되면 다음 흐름에 따라 작업하세요:

<Steps>

1. **Pushwoosh에서 Google Wallet 구성**

   개발팀에 Pushwoosh의 애플리케이션에 Google Wallet을 연결하도록 요청하세요.

   [Google Wallet 설정 방법](/ko/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

2. **패스 디자인**

   **Campaigns → Wallet Passes**에서 패스 빌더를 열고, 패스 유형을 선택하고, 브랜딩과 필드를 추가한 후 실시간 미리보기를 확인하세요.

   [패스 빌더에서 Google Wallet 패스 디자인하기](/ko/product/messaging-channels/google-wallet-passes/pass-builder/)

3. **패스 생성**

   패스가 올바르게 보이면 [패스 빌더](/ko/product/messaging-channels/google-wallet-passes/pass-builder/#generate-the-pass)에서 **Generate**를 클릭하세요.

4. **사용자에게 패스 전송**

   **All passes**에서 저장 링크 또는 QR 코드를 공유하세요. [Pushwoosh 채널을 통해 사용자와 패스 공유하기](#share-the-pass-with-users-via-pushwoosh-channels)를 참조하세요. 각 사용자에게 대규모로 패스를 보내려면 개발팀이 [Google Wallet API](/ko/developer/api-reference/google-wallet-api/)를 사용할 수 있습니다.

5. **패스 업데이트**

   [**All passes**](#view-and-manage-existing-passes)에서 패스의 **Edit**를 클릭하거나 [Google Wallet API](/ko/developer/api-reference/google-wallet-api/)를 통해 업데이트하세요. 저장하면 Google은 패스를 저장한 모든 기기에 업데이트를 전달합니다. 사용자는 다시 저장할 필요가 없습니다.

6. **패스 소지자에게 메시지 보내기**

   사용자가 패스를 저장하면 일회성 푸시 또는 자동화된 Customer Journey로 사용자에게 도달할 수 있습니다.

   [Google Wallet 패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/google-wallet-passes/message-pass-holders/)

</Steps>

## 기존 패스 보기 및 관리

Control Panel에서 **Campaigns → Wallet Passes**로 이동하여 **Google Wallet** 탭을 엽니다. **All passes** 표에는 애플리케이션의 모든 패스가 나열되며, 패스 이름, 스타일, 연결된 [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/), 상태 및 마지막 업데이트 시점이 포함됩니다.

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

* **Edit:** 필드 값 및 라벨, 색상, 로고 및 히어로 이미지 URL, 바코드, 링크, 위치 및 만료일을 변경합니다. 패스 유형은 생성 후 잠깁니다. 저장하면 패스를 저장한 모든 기기가 업데이트를 받습니다.

<Aside type="note" title="패스 업데이트 및 알림">
변경 사항을 저장하면 패스를 저장한 모든 기기에서 패스가 업데이트됩니다. **Notify about changed fields**가 활성화된 경우(기본적으로 켜져 있음), Google은 소지자에게 Android 알림도 보냅니다.

알림은 **멤버십**, **이벤트 티켓**, **항공권** 패스에서 지원됩니다. Google은 변경된 필드를 기반으로 알림 텍스트를 자동으로 생성합니다. 이벤트 및 항공권 패스의 경우, 시작 시간까지 3시간 미만이 남았을 때만 알림이 발생하며, Google은 24시간당 패스당 3개로 제한합니다.

패스 소지자에게 자신만의 메시지를 보내려면 [Google Wallet 패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/google-wallet-passes/message-pass-holders/)를 참조하세요.
</Aside>

* **Send message:** 일회성 푸시 작성기를 열어 패스 소지자에게 메시지를 보냅니다. 사용자에게 도달하는 모든 방법에 대해서는 [Google Wallet 패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/google-wallet-passes/message-pass-holders/)를 참조하세요.
* **QR code:** 패스 저장 링크를 인코딩하는 QR 코드를 표시합니다. 사용자는 이를 스캔하여 Google Wallet에 패스를 저장하고 업데이트를 위해 기기를 등록합니다.
* **Copy install link:** 메시징 채널에서 공유할 패스 저장 링크를 복사합니다. [자세히 알아보기](#share-the-pass-with-users-via-pushwoosh-channels).
* **Invalidate:** 활성 패스를 비활성으로 설정합니다. 패스는 Google Wallet에서 사용자의 **만료된 패스** 섹션으로 이동합니다. 기록은 Pushwoosh에 남아 있습니다.
* **Activate:** 비활성 패스를 다시 활성으로 설정합니다. 이 옵션은 패스가 비활성일 때만 작업 메뉴에 나타납니다. Google Wallet에서 패스를 복원합니다.
* **Delete:** Google에서 패스를 무효화하고 Pushwoosh에서 해당 기록을 제거합니다. Google은 기기에 이미 저장된 패스를 강제로 제거하는 것을 허용하지 않습니다. 패스는 무효화되고 **만료된 패스**로 이동합니다.


## Pushwoosh 채널을 통해 사용자와 패스 공유하기

**Google Wallet에 추가** 링크는 일반 URL(`https://pay.google.com/gp/v/save/...`)입니다. 기기에서 이 링크를 열면 사용자에게 Google Wallet에 패스를 저장하라는 메시지가 표시됩니다. 이미 잠재고객에게 도달하는 데 사용하는 것과 동일한 Pushwoosh 채널에서 이 링크를 사용할 수 있습니다:

* **Email:** [이메일 편집기](/ko/product/content/email-content/drag-and-drop-email-editor/)의 버튼이나 텍스트 링크에 "Google Wallet에 추가"와 같은 행동 유도 문구로 링크를 추가합니다.
* **Push notifications:** 알림의 [열기 동작](/ko/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked)으로 링크를 설정하여 탭하면 패스가 열리도록 합니다.
* **SMS:** [SMS 콘텐츠](/ko/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content)에 링크를 포함합니다.

## API를 통해 패스 관리

패스 빌더가 수행하는 모든 작업은 Google Wallet API를 통해 프로그래밍 방식으로도 사용할 수 있습니다: 패스 생성, 업데이트, 목록 조회, 저장 링크 가져오기, 상태 설정 및 삭제.

<LinkCard title="Google Wallet API" href="/developer/api-reference/google-wallet-api/" />

## User Explorer에서 패스 소지자 보기

사용자가 패스를 저장하면 Pushwoosh는 [User Explorer](/ko/product/audience-data-and-segmentation/user-explorer/)의 **Devices and platforms** 탭에 해당 패스를 나열합니다.

1. **Audience → User Explorer**로 이동하여 사용자 프로필을 엽니다.
2. **Devices and platforms** 탭을 엽니다.
3. 사이드바에서 **Google Wallet**을 선택합니다.

플랫폼 프로필에서 다음을 검토할 수 있습니다:

* **Subscription status:** 예: **SUBSCRIBED**
* **Platform identifier:** 플랫폼 이름 아래에 표시되는 패스 식별자
* **Metadata:** **First subscription**, **Timezone** 및 사용 가능한 경우 기타 필드
* **Tags:** 패스 발급 시 설정한 태그를 포함한 플랫폼 태그

[자세히 알아보기](/ko/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)