# Google Wallet 패스 소지자에게 메시지 보내기

사용자가 Google Wallet 패스를 저장하면 Pushwoosh는 해당 [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/)에 연결된 Google Wallet 플랫폼 구독으로 등록합니다.

그런 다음 여러 가지 방법으로 사용자에게 도달할 수 있습니다: 알림으로 패스를 업데이트하거나, 일회성 푸시를 보내거나, Customer Journey에서 메시지를 자동화하거나, Google의 내장된 지오펜싱을 사용하거나, API를 통해 특정 패스 소지자에게 알릴 수 있습니다.

## 알림과 함께 패스 업데이트 보내기


패스를 편집하고 저장하면 저장한 모든 기기에 새 버전이 동기화됩니다. 로열티, 이벤트 티켓, 항공권 패스의 경우 알림을 활성화하여 소지자에게 변경 사항을 알릴 수도 있습니다.

1. **Campaigns → Wallet Passes → Google Wallet**에서 패스를 찾아 작업 메뉴에서 **Edit**을 클릭합니다.
2. 필요한 필드를 변경합니다.
3. **Notify about changed fields**가 활성화되어 있는지 확인합니다.
4. **Save changes**를 클릭합니다.

Google은 패스를 저장한 모든 기기에 업데이트를 동기화합니다. [**Notify about changed fields**](/ko/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes)가 켜져 있으면 Google은 소지자에게 Android 알림도 보냅니다.

<Aside type="note" title="이벤트 및 항공권 패스">
- Google이 알림 텍스트를 생성합니다.
- 이벤트 및 항공권 패스의 경우, 시작 시간까지 3시간 미만이 남았을 때만 알림이 발송됩니다.
- Google은 24시간당 패스당 최대 3개의 알림만 허용합니다. 한도에 도달하면 패스는 조용히 업데이트됩니다.
</Aside>

## 패스 소지자에게 일회성 푸시 보내기


한 명의 패스 소지자 또는 더 넓은 잠재고객에게 독립적인 푸시를 보냅니다.

1. 일회성 푸시 작성기를 엽니다. **Campaigns → Wallet Passes → Google Wallet**에서 **Send message**를 클릭하거나, **Campaigns → One-Time Messages**로 이동하여 **Send message → One-time push**를 클릭합니다.
2. **Content** 단계에서 메시지를 작성하거나 프리셋을 선택합니다.
3. **Audience** 단계에서 메시지를 받을 사람을 설정합니다. 기본값은 작성기를 연 위치에 따라 다릅니다:

   * **패스에서 Send message를 클릭한 경우:** **Send to specific users**가 선택되고, **Recipients (User IDs)**에 해당 패스 소지자의 [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/)가 이미 나열됩니다. 해당 소지자 한 명에게 보내려면 그대로 보내거나, 잠재고객을 변경할 수 있습니다:
     * **Recipients (User IDs)**에 더 많은 User ID를 추가합니다.
     * **Send to segment**로 전환합니다.
     * **Send to all subscribers**를 선택합니다.
   * **One-Time Messages에서:** 일반적인 [일회성 푸시](/ko/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#select-audience-for-push-notification)에서와 같이 잠재고객을 설정합니다: **Send to specific users**, **Send to segment** 또는 **Send to all subscribers**.

<img src="/google-wallet-passes-message-pass-holders-1.webp" alt="수신자에 패스 소지자 User ID가 미리 채워진 Send to specific users가 선택된 Audience 단계"/>

4. **Target platforms** 아래에서 **Google Wallet**을 선택합니다.
5. 메시지를 보내거나 예약합니다.

<Aside type="note">
세그먼트를 타겟팅할 때, 특정 패스를 저장한 모든 사람이 아니라 Google Wallet 플랫폼이 등록된 해당 세그먼트의 사용자에게 전달됩니다.
</Aside>

## Customer Journey에서 메시지 자동화하기



이벤트나 세그먼트를 기반으로 메시지를 자동으로 보냅니다.

### 트리거 기반 진입 Journey

<Aside type="caution" icon="setting" title="개발자 지원 필요">
사용자 지정 이벤트를 보내려면 개발팀이 [`postEvent`](/ko/developer/api-reference/user-centric-api/#postevent) API 호출을 백엔드 또는 CRM에 통합해야 합니다. 이 섹션을 개발팀과 공유하세요.
</Aside>

1. [Customer Journey](/ko/product/customer-journey/pushwoosh-journey-overview/)를 만들고 [**Trigger-based entry**](/ko/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/)를 추가합니다.
2. Journey를 시작해야 하는 이벤트를 선택합니다. 아직 만들지 않았다면 먼저 Control Panel에서 사용자 지정 이벤트를 만듭니다(예: `RewardAvailable`).
3. 푸시 요소를 추가하고 구성합니다. 저장된 패스를 포함하여 사용자와 연결된 모든 기기에 푸시가 도달하도록 [**Send by User ID**](/ko/product/customer-journey/journey-elements/channels/push/#send-by-user-id)를 활성화합니다.
4. Journey 구성을 완료하고 활성화합니다.

진입 이벤트가 발생하면 Pushwoosh는 사용자와 연결된 모든 기기에 푸시를 보냅니다. 패스 소지자는 패스에서 알림으로 받습니다. Google Wallet 패스가 없는 사용자는 다른 기기에서 받습니다.

<Aside type="tip" title="패스 콘텐츠">
푸시는 패스 필드를 변경하지 않습니다. 메시지와 함께 패스 콘텐츠(예: 포인트 잔액)를 업데이트하려면 [All passes](/ko/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes)에서 **Edit**을 통해 또는 [Google Wallet API](/ko/developer/api-reference/google-wallet-api/)를 통해 패스를 별도로 업데이트하세요.
</Aside>

**예시: 사용자에게 보상이 사용 가능함을 알림**

`POST https://api.pushwoosh.com/json/1.3/postEvent`

```json
{
  "request": {
    "application": "XXXXX-XXXXX",
    "userId": "u12345",
    "event": "RewardAvailable",
    "attributes": {
      "reward": "Free coffee",
      "expires": "2026-07-01"
    }
  }
}
```

`event` 이름은 Control Panel에서 생성된 이벤트와 일치해야 합니다.


### Journey를 구축하는 다른 방법

위의 트리거 기반 흐름은 하나의 옵션입니다. Journey를 시작해야 하는 요소에 따라 다른 [진입 요소](/ko/product/customer-journey/journey-elements/entry-elements/)를 선택하세요:

* **[Audience-based entry](/ko/product/customer-journey/journey-elements/entry-elements/audience-based-entry/):** 단일 이벤트 대신 전체 세그먼트에 대해 Journey를 시작합니다. 한 번 실행하거나, 일정에 따라 실행하거나, 주기적으로(예: 매주 활성 패스를 보유한 모든 사람에게) 실행하며, 새 사용자는 세그먼트에 가입할 때 진입합니다.
* **[API-based entry](/ko/product/customer-journey/journey-elements/entry-elements/api-based-entry/):** 항공편 지연이나 게이트 변경과 같이 앱 외부에서 발생하는 비즈니스 이벤트에서 Journey를 시작합니다. 외부 시스템이 진입 요소의 요청 템플릿을 호출하고 필터를 전달하여 올바른 사용자를 타겟팅합니다. 예를 들어 패스가 발급될 때 `flightNumber = SU1234` 태그가 설정된 모든 사람을 타겟팅합니다. 탑승권 및 이벤트 티켓에 적합합니다.


## API를 통해 특정 패스 소지자에게 알림

하나의 특정 패스를 저장한 모든 사람에게 사용자 지정 알림을 보내려면, `notifyMessage`를 설정하여 [Update a pass](/ko/developer/api-reference/google-wallet-api/#update-a-pass)를 호출하세요.

<LinkCard title="패스 업데이트" href="/developer/api-reference/google-wallet-api/#update-a-pass" />