> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress

> OneSignal WordPress 웹 푸시 플러그인 v3+ 완전 설정 및 마이그레이션 가이드. 간소화된 설정 프로세스를 통해 OneSignal 대시보드에서 푸시 알림, 프롬프트 및 세분화를 구성하세요.

## 개요

이 가이드는 OneSignal WordPress 웹 푸시 플러그인 v3+를 설정하고 구성하는 방법을 다룹니다.

<Info>
  이전 버전 2.x.x WordPress 문서는 [WordPress 레거시 플러그인](./wordpress-legacy)을 참조하세요.
</Info>

### 버전 3+의 새로운 기능

이번 릴리스는 설정 및 구성 프로세스를 간소화하여 중요한 업그레이드를 제공합니다. 버전 3+를 사용하면 모든 프롬프트 설정을 한 곳(OneSignal 대시보드)에서 처리할 수 있습니다.

* 🚀 **SDK 업그레이드**: OneSignal Web SDK를 버전 15에서 16으로 업데이트
* 💬 **대시보드 프롬프트**: 맞춤 코드 없이 OneSignal 대시보드에서 직접 모든 [권한 프롬프트](./permission-requests) 구성
* ⏩ **원클릭 게시**: "게시물이 게시될 때 알림 보내기"를 선택하여 자동으로 푸시 알림 전송
* 🧑‍🤝‍🧑 **오디언스 타겟팅**: 각 게시물에 대해 어떤 [세그먼트](./segmentation)가 알림을 받을지 선택
* 📲 **모바일 앱 통합**: 선택적 [딥 링킹](./links#deep-linking)으로 모바일 앱 구독자에게 전송

<Info>
  이전 버전 2.x.x WordPress 문서는 [WordPress 레거시 플러그인](./wordpress-legacy)을 참조하세요.
</Info>

***

## 설정

시작하기 전에 다음을 확인하세요:

* [OneSignal 계정](https://dashboard.onesignal.com/signup) (무료 생성)
* 플러그인을 설치하고 구성하기 위한 WordPress 관리자 액세스 권한
* HTTPS 지원 웹사이트 (웹 푸시 알림에 필요)

### 1. OneSignal 대시보드에서 WordPress 구성

**설정 > Push & In-App > Web > WordPress Plugin or Website Builder**로 이동

<Frame caption="OneSignal 대시보드의 Website Builder 옵션에서 WordPress 선택">
  <img src="https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-integration-selection.png?fit=max&auto=format&n=sCO1i1UqrWQxmZ28&q=85&s=d48170c90c2d9e309769c430c1f8336d" width="1916" height="590" data-path="images/dashboard/wordpress-integration-selection.png" />
</Frame>

#### 사이트 설정

* **Site Name**: 사이트 이름 및 기본 알림 제목.
* **Site URL**: WordPress 사이트의 정확한 URL과 일치해야 합니다 ([Same-origin policy](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy) 준수)
* **Auto Resubscribe**: 사용자가 브라우저 데이터를 지우고 사이트로 돌아올 때 자동으로 재구독할 수 있도록 이 옵션을 활성화합니다 (새로운 권한 프롬프트 필요 없음)
* **Default Icon URL**: 알림 및 프롬프트를 위한 정사각형 `256x256px` PNG 또는 JPG 파일 – MacOS Safari는 아이콘 없이 알림 프롬프트를 표시하지 않습니다.

<Frame caption="정확한 Site URL을 입력하세요. https://your-site.com과 https://www.your-site.com은 다릅니다—한 가지 형식만 일관되게 사용하세요">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5a29a00c2808e8128e2cd822d743d14b472637f65fbde2aa64d9f16a8658d4a6-Screenshot_2025-02-13_at_3.06.28_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=535d1d4b6d579d0d296fbed60d5d669b" width="2046" height="1036" data-path="images/docs/5a29a00c2808e8128e2cd822d743d14b472637f65fbde2aa64d9f16a8658d4a6-Screenshot_2025-02-13_at_3.06.28_PM.png" />
</Frame>

<Info>
  로컬에서 테스트하시나요? localhost 개발을 위한 [로컬 테스팅 가이드](./web-sdk-setup#local-testing)를 참조하세요
</Info>

#### 권한 프롬프트

Push, Email 및/또는 SMS에 대한 [권한 프롬프트](./permission-requests)를 설정하세요. Push Slide Prompt가 기본적으로 활성화되어 있지만, 추가 프롬프트를 사용자 지정하거나 추가할 수 있습니다.

<Info>
  **프로 팁**: 간단한 프롬프트로 시작하여 점진적으로 복잡성을 추가하세요. OneSignal 대시보드를 통해 언제든지 모든 프롬프트 설정을 수정할 수 있습니다. [웹 권한 프롬프트](./permission-requests)에서 사용 가능한 모든 옵션을 탐색하세요.
</Info>

<Tabs>
  <Tab title="기본 프롬프트 설정">
    <Steps>
      <Step title="Push Slide Prompt를 클릭하여 사용자 지정">
        <Frame caption="푸시 슬라이드 프롬프트 설정에 액세스하고 사용자 지정">
          <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/32d2f36e12becd930037774ab376b1c65080fbb801e99f37f00964603371614e-Screenshot_2025-02-13_at_3.39.15_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=fffa465720f34780e7c22b047a57ca4e" width="2534" height="452" data-path="images/docs/32d2f36e12becd930037774ab376b1c65080fbb801e99f37f00964603371614e-Screenshot_2025-02-13_at_3.39.15_PM.png" />
        </Frame>
      </Step>

      <Step title="타이밍 및 텍스트 구성:">
        * 초기 테스트를 위해 **Auto Prompt**를 `1` 페이지뷰와 `1`초로 설정
          * 프롬프트 텍스트 및 모양 사용자 지정
          * 출시 후 사용자 행동에 따라 타이밍 조정

        <Frame caption="자동 프롬프트 타이밍을 구성하고 프롬프트 모양을 사용자 지정">
          <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3f3638ec5fa60f55fb8aa922ba0f7197aee508f11b242e0377a0a8e255a2b38d-Screenshot_2025-02-13_at_3.42.09_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=33f5eb55da0cee00d1d8121bb3f66f89" width="1922" height="1594" data-path="images/docs/3f3638ec5fa60f55fb8aa922ba0f7197aee508f11b242e0377a0a8e255a2b38d-Screenshot_2025-02-13_at_3.42.09_PM.png" />
        </Frame>
      </Step>

      <Step title="프롬프트 구성을 완료하면 완료를 클릭하세요." />
    </Steps>
  </Tab>

  <Tab title="고급: 카테고리 기반 세분화">
    사용자 관심사에 따른 타겟 메시징을 위해 카테고리를 설정하세요:

    <Steps>
      <Step title="프롬프트 설정에서 카테고리 선택" />

      <Step title="다음을 사용하여 각 카테고리 구성:">
        * **Label**: 사용자가 프롬프트에서 보는 내용
        * **Tag Key**: 세분화를 위한 내부 [태그 키](./add-user-data-tags)
      </Step>

      <Step title="프롬프트 구성을 완료하면 완료를 클릭하세요." />
    </Steps>

    <Frame caption="예: 뉴스 및 거래 카테고리를 설정하면 이러한 옵션을 선택한 사용자에 대해 'news: 1' 및 'deals: 1' 태그가 생성됩니다">
      <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/39ebfb19de43d53d6f07956c6e96bb101dca53dca81a58f6fc55a021f73ccdc9-Screenshot_2025-02-18_at_3.36.56_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=3d0d41386891b9b84ed2619da519206d" width="1910" height="1604" data-path="images/docs/39ebfb19de43d53d6f07956c6e96bb101dca53dca81a58f6fc55a021f73ccdc9-Screenshot_2025-02-18_at_3.36.56_PM.png" />
    </Frame>

    **태그 로직**: 선택된 카테고리는 태그 값을 `1`로 설정하고, 선택되지 않은 카테고리는 `0`으로 설정합니다. 이러한 태그를 사용하면 특정 사용자 관심사에 대한 타겟 메시징이 가능합니다.
  </Tab>
</Tabs>

#### 환영 알림

사용자가 처음 구독한 후 전송되는 즉각적인 알림을 설정하세요. 이것은:

* 구독에 대해 사용자에게 감사 표시
* 알림이 어떻게 표시되는지 시연
* 참여도를 높이고 구독 취소를 줄임

환영 메시지 텍스트 및 타이밍을 구성한 다음 아래로 스크롤하여 **저장**을 클릭하세요.

<Tip>
  지금은 OneSignal 대시보드의 **Advanced Push Settings** 섹션을 건너뛰세요 — 이들은 맞춤 [Web SDK 설정](./web-sdk-setup)을 위한 것입니다. 계속하려면 **저장**을 클릭하세요.
</Tip>

### 2. WordPress 플러그인 구성

대시보드 구성을 저장한 후 **App ID**와 **API Key**가 표시됩니다. 이 값을 WordPress 플러그인에 복사하세요:

<Frame caption="OneSignal 대시보드에서 App ID와 API Key를 복사">
  <img src="https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-app-id-and-api-key.png?fit=max&auto=format&n=sCO1i1UqrWQxmZ28&q=85&s=90643a5aafc920c3785b42a093ae1773" width="1648" height="826" data-path="images/dashboard/wordpress-app-id-and-api-key.png" />
</Frame>

<Info>
  **API Key가 표시되지 않나요?** [Keys & IDs 가이드](./keys-and-ids)를 따라 생성하세요.
</Info>

<Steps>
  <Step title="WordPress 관리자에서 OneSignal 플러그인 설정으로 이동" />

  <Step title="대시보드에 표시된 대로 정확히 App ID와 REST API Key를 붙여넣기" />
</Steps>

<Frame caption="WordPress 플러그인 App ID와 REST API Key가 OneSignal 대시보드와 정확히 일치하는지 확인">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c92c0ca5a7e910104a2c3e5d0fa87e63c2a9adb61aa20de072b41b49006a70c0-Screenshot_2025-02-13_at_3.49.16_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=ba2996eacb58d914c34edc5884e5abb1" width="1828" height="1064" data-path="images/docs/c92c0ca5a7e910104a2c3e5d0fa87e63c2a9adb61aa20de072b41b49006a70c0-Screenshot_2025-02-13_at_3.49.16_PM.png" />
</Frame>

#### 고급 설정

필요에 따라 추가 플러그인 옵션을 구성하세요:

<Frame caption="향상된 기능 및 분석 추적을 위한 고급 설정">
  <img src="https://mintcdn.com/onesignal/bqiNDj5j2mpssdoy/images/push/wordpress-advanced-settings.png?fit=max&auto=format&n=bqiNDj5j2mpssdoy&q=85&s=a6142c3df995140d2927cbc7c6058149" width="1946" height="1410" data-path="images/push/wordpress-advanced-settings.png" />
</Frame>

**URL 매개변수 추적**

추적을 위해 알림 URL에 분석 매개변수를 추가합니다. **중요**: 특수 문자를 이스케이프하세요—입력이 그대로 URL에 추가됩니다.

**Google Analytics 예:**

```
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
```

**특수 문자가 있는 예:**

```
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
```

**추가 설정**

* **Custom Post Types**: 플러그인의 게시물 유형을 추가하여 알림 옵션 활성화
* **Automatically send notifications when a post is published**: 게시물을 게시할 때 자동으로 알림 확인란을 선택하여 수동으로 확인란을 선택하지 않고도 알림이 전송되도록 함
* **Automatically send notifications when a post is updated**: 게시물을 업데이트할 때 자동으로 알림 확인란을 선택하여 수동으로 확인란을 선택하지 않고도 알림이 전송되도록 함
* **Automatically send notifications when a page is published**: 페이지를 게시할 때 자동으로 알림 확인란을 선택하여 수동으로 확인란을 선택하지 않고도 알림이 전송되도록 함
* **Automatically send notifications when a page is updated**: 페이지를 업데이트할 때 자동으로 알림 확인란을 선택하여 수동으로 확인란을 선택하지 않고도 알림이 전송되도록 함
* **Automatically send a push notification when I publish a post from 3rd party plugins**: 외부 게시 플러그인에서 자동으로 알림 전송
* **Mobile App Integration**: 동일한 OneSignal App ID를 사용하여 모바일 앱 구독자에게 알림 전송

### 3. 마이그레이션 완료 (업그레이드 사용자만 해당)

<Note>
  **새로 설치하는 경우 이 단계를 건너뛸 수 있습니다. v2+에서 업그레이드하는 경우 따라하세요...**
</Note>

<Warning>
  **시간 제한**: 전환 기간 동안 사용자가 알림을 놓치지 않도록 가능한 한 빨리 이 단계를 완료하세요.
</Warning>

<Steps>
  <Step title="OneSignal 대시보드 구성을 저장한 후 WordPress로 돌아가기" />

  <Step title="플러그인 설정에서 Migration Completed 클릭" />

  <Step title="업그레이드를 완료하려면 저장 설정 클릭" />
</Steps>

<Frame caption="플러그인 업그레이드를 완료하려면 Migration Completed 클릭">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ba2d812c5757d50ee60885c45f229e2bba4ff2da42ba3fb0098ac5b5621eba-Screenshot_2024-12-19_at_2.33.31_PM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=2d55f565db10c116fed39ca3f5930cb4" width="1059" height="312" data-path="images/docs/01ba2d812c5757d50ee60885c45f229e2bba4ff2da42ba3fb0098ac5b5621eba-Screenshot_2024-12-19_at_2.33.31_PM.png" />
</Frame>

<Check>
  설정 완료! 플러그인 구성을 완료하려면 **저장 설정**을 클릭하세요.
</Check>

***

## 설정 테스트

<Tabs>
  <Tab title="초기 테스트">
    1. **웹사이트를 방문** (시크릿/프라이빗 브라우징 모드는 피하세요—사용자는 이러한 모드에서 구독할 수 없습니다) 2. **구성한 슬라이드다운 프롬프트를 찾으세요**

    <Frame caption="구성한 슬라이드다운 프롬프트가 타이밍 설정에 따라 나타나야 합니다">
      <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7aca650375517543ad8c80bedc0c75a224a51dd63e84c67798ab4b1812b01498-Screenshot_2025-02-24_at_9.58.05_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=d937481d712d3340ba8ef9b25a274901" width="1600" height="700" data-path="images/docs/7aca650375517543ad8c80bedc0c75a224a51dd63e84c67798ab4b1812b01498-Screenshot_2025-02-24_at_9.58.05_AM.png" />
    </Frame>

    3. **구독 버튼 클릭** (이 예에서는 "Subscribe"로 레이블됨)
    4. **프롬프트가 나타나면 브라우저 권한 수락**

    <Frame caption="웹 푸시 알림에 필요한 브라우저 권한 프롬프트 (브라우저에 따라 모양이 다름)">
      <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/fac77534f9a5182d0a2351713a23f10f26f779ff5182c0c2c8a1289372dea9a9-Screenshot_2025-02-13_at_4.44.29_PM.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=60785d5a04fe7f2f5450fb05b414d5ee" width="1612" height="490" data-path="images/docs/fac77534f9a5182d0a2351713a23f10f26f779ff5182c0c2c8a1289372dea9a9-Screenshot_2025-02-13_at_4.44.29_PM.png" />
    </Frame>

    5. **환영 알림 확인** (구성된 경우)

    <Frame caption="환영 알림은 성공적인 구독 직후에 나타납니다">
      <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1752c5e7341bbb505d93af428bba12e4042257cb518e281ccb887b1a415dbaee-Screenshot_2025-02-13_at_4.44.40_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=d9575a52cb6bfdb1ae770daf3bb82ed2" width="740" height="198" data-path="images/docs/1752c5e7341bbb505d93af428bba12e4042257cb518e281ccb887b1a415dbaee-Screenshot_2025-02-13_at_4.44.40_PM.png" />
    </Frame>
  </Tab>

  <Tab title="구독 확인">
    1. OneSignal 대시보드에서 **오디언스 > 구독**으로 이동 2. 웹 푸시 [구독](./subscriptions)이 "Subscribed"로 표시되어야 합니다

    <Frame caption="성공한 구독은 OneSignal 대시보드 오디언스에 나타납니다">
      <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/cf9b6a27fb8a32c5228e9123646e6ad5ca5b3ceb4d74fd8cf42e016e36f67c5a-Screenshot_2025-02-13_at_4.52.19_PM.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=b8152e5f84b8bcdda32888268bbede00" width="3006" height="788" data-path="images/docs/cf9b6a27fb8a32c5228e9123646e6ad5ca5b3ceb4d74fd8cf42e016e36f67c5a-Screenshot_2025-02-13_at_4.52.19_PM.png" />
    </Frame>
  </Tab>

  <Tab title="테스트 메시지 보내기">
    1. OneSignal 대시보드에서 **메시지 > 푸시**로 이동 2. **새 메시지** 생성 3. 자신에게 테스트 알림 보내기 4. 알림이 올바르게 표시되는지 확인 자세한 지침은 [푸시 메시징 가이드](./push)를 참조하세요.
  </Tab>
</Tabs>

<Check>
  **성공!** 이제 WordPress 사이트가 웹 푸시 알림으로 구성되었습니다. 사용자가 구독하면 구독에 나타나기 시작합니다.
</Check>

**다음 단계:**

* 고급 사용자 지정을 위해 [웹 권한 프롬프트](./permission-requests) 검토
* 이메일 및 SMS 통합을 위해 [채널 설정](./channel-setup) 탐색
* 타겟 메시징을 위한 [세분화 전략](./segmentation) 설정

<Info>
  **문제가 있으신가요?** 일반적인 솔루션은 [WordPress 문제 해결 가이드](./troubleshooting-wordpress-web-push)를 확인하세요.
</Info>

***

## 알림 게시

게시물을 예약하여 게시하면 OneSignal은 예약된 시간에 구독자에게 보낼 푸시 알림도 예약합니다. 게시물을 다시 예약하면 푸시 알림이 취소되고 새 시간에 대한 새 푸시가 예약됩니다.

**전달 > 예약된 메시지** 아래의 OneSignal 대시보드에서 예약되고 취소된 알림을 볼 수 있습니다. 자세한 내용은 [푸시 메시지 리포트](./push-notification-message-reports)를 참조하세요.

### 기본 게시물 알림

WordPress 게시물을 생성하거나 편집할 때 **OneSignal Push Notifications** 메타박스를 찾으세요 (일반적으로 게시물 편집기의 하단이나 사이드바에 있음).

<Frame caption="OneSignal Push Notifications 메타박스—필요한 경우 드래그하여 위치 변경">
  <img src="https://mintcdn.com/onesignal/kAXbp86YqdTAbPtE/images/web-push/onesignal-push-notifications-metabox-wordpress.png?fit=max&auto=format&n=kAXbp86YqdTAbPtE&q=85&s=428a477e16f85fa50f9ff69678304340" width="3252" height="1674" data-path="images/web-push/onesignal-push-notifications-metabox-wordpress.png" />
</Frame>

**알림을 보내려면:**

* **"Send notification when post is published or updated"** 선택
* 해당 게시물에 대한 알림 전송을 건너뛰려면 선택 취소

### 오디언스 타겟팅

#### 모든 구독자에게 보내기 (기본값)

기본적으로 알림은 모든 푸시 [구독자](./subscriptions)에게 전송됩니다.

#### 특정 세그먼트에 보내기

**오디언스 > 세그먼트**에서 생성한 [세그먼트](./segmentation)를 사용하여 특정 오디언스를 타겟팅하세요.

**3단계에서 카테고리를 설정한 경우** 해당 세그먼트를 생성하세요:

1. OneSignal 대시보드에서 **오디언스 > 세그먼트**로 이동
2. 태그 키를 사용하여 세그먼트 생성, 예:
   * **뉴스 세그먼트**: 태그 `news`가 `1`
   * **거래 세그먼트**: 태그 `deals`가 `1`

<Frame caption="태그는 대소문자를 구분합니다! 'news'와 'News'는 다른 태그입니다">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e7c2b21714e2de8653ac569fc65eb929988f5ccede8429168a40cae0067d893d-Screenshot_2025-02-18_at_4.45.19_PM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=361fb5f307e412e28b1f3da26c4682d3" width="1446" height="926" data-path="images/docs/e7c2b21714e2de8653ac569fc65eb929988f5ccede8429168a40cae0067d893d-Screenshot_2025-02-18_at_4.45.19_PM.png" />
</Frame>

3. 세그먼트를 생성한 후 WordPress 게시물 편집기를 새로고침
4. 드롭다운에서 대상 세그먼트 선택

<Frame caption="관련 사용자 그룹을 타겟팅하려면 특정 세그먼트 선택">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9cb2736bc8b318d1de60b5b40887db8adda8f7797289bb0ad00d8e98e9e9c902-Screenshot_2025-02-19_at_10.36.16_AM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=551c8c99851ad4fc431abf0e30084aa5" width="2030" height="796" data-path="images/docs/9cb2736bc8b318d1de60b5b40887db8adda8f7797289bb0ad00d8e98e9e9c902-Screenshot_2025-02-19_at_10.36.16_AM.png" />
</Frame>

<Check>
  **고급 세분화**: 사용자 행동, 위치, 기기 유형 등을 기반으로 세그먼트를 생성하세요. [태그](./add-user-data-tags)는 맞춤 사용자 데이터 및 개인화를 위한 가장 많은 유연성을 제공합니다.
</Check>

### 알림 콘텐츠 사용자 지정

#### 기본 동작

* **제목**: WordPress 사이트 제목 사용 (설정 > 일반)
* **메시지**: 게시물 제목 사용
* **이미지**: 게시물의 대표 이미지 사용 (설정된 경우)
* **URL**: 게시된 게시물로 링크

#### 맞춤 콘텐츠

기본값을 재정의하려면 \*\*"Customize notification content"\*\*를 선택하세요:

<Frame caption="알림 제목, 콘텐츠 및 기타 요소 사용자 지정">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/40837af4e6fefa7d4303f5a3d49992396eb152cec5fd2420d7064aecef32c1af-Screenshot_2025-02-19_at_10.48.18_AM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=8fef18d9723782c41604c358d69723ee" width="2064" height="1114" data-path="images/docs/40837af4e6fefa7d4303f5a3d49992396eb152cec5fd2420d7064aecef32c1af-Screenshot_2025-02-19_at_10.48.18_AM.png" />
</Frame>

**예시 결과:**

<Frame caption="사용자에게 표시되는 사용자 지정 푸시 알림">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a5011ec82798e7b6b31a9c5e2a26d2fb98a2c17dbc3fb0cb9895453f74d3240a-Screenshot_2025-02-19_at_10.49.26_AM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=f1bbce88aeba84939032658beef5cf4d" width="740" height="198" data-path="images/docs/a5011ec82798e7b6b31a9c5e2a26d2fb98a2c17dbc3fb0cb9895453f74d3240a-Screenshot_2025-02-19_at_10.49.26_AM.png" />
</Frame>

### OneSignal WordPress 플러그인에 맞춤 게시물 유형 추가

#### 맞춤 게시물 유형 이름 찾기

새 게시물을 만들 때 브라우저의 주소 표시줄을 확인하세요. URL은 다음과 같습니다:

```
https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type
```

`post_type` 매개변수의 값 (예: `your_custom_type`)이 OneSignal 플러그인 설정에 추가해야 하는 정확한 이름입니다.

#### OneSignal 설정에 추가

1. WordPress 관리자에서 **OneSignal > 설정**으로 이동
2. **고급 설정**에서 맞춤 게시물 유형 이름을 **Custom Post Types** 필드에 추가
3. 설정 저장

<Note>
  **일반적인 예:** `product` (WooCommerce), `tribe_events` (Events Calendar), `portfolio`{" "}
</Note>

## 모바일 앱 통합

동일한 OneSignal App ID를 사용하는 모바일 앱이 있는 경우:

1. 플러그인 설정에서 **"Send notification to Mobile app subscribers"** 활성화
2. 게시물 메타박스에서 [딥 링킹](./deep-linking)을 위한 **Mobile URL** 추가
3. 모바일 사용자는 웹 브라우저 대신 앱으로 이동됩니다

<Check>
  **확장 준비 완료**: 정교한 알림 캠페인을 위한 [고급 푸시 전략](./push) 및 [자동화된 저니](./journeys-overview)를 탐색하세요.
</Check>

<Warning>
  **알림이 표시되지 않나요?** 솔루션은 [웹 푸시 문제 해결 가이드](./notifications-not-shown-web-push)를 확인하세요.
</Warning>

***

## FAQ

<Accordion title="특정 페이지에서 프롬프트를 비활성화하려면 어떻게 하나요?" icon="circle-chevron-down">
  **참고**: 이 방법은 슬라이드다운 및 네이티브 권한 프롬프트에만 작동하며, 벨 또는 맞춤 링크 프롬프트에는 작동하지 않습니다.

  1. OneSignal 대시보드에서 **설정 > Push & In-App > 웹 설정**으로 이동
  2. **Permission Prompt Setup** 테이블에서 프롬프트 선택
  3. **Auto Prompt** 선택 취소 및 **완료** 클릭

  <Frame caption="프롬프트가 표시되는 시점을 수동으로 제어하려면 Auto Prompt 비활성화">
    <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/814f50f2de90ad37c5213f963cd9dca9214b5dcc708650269d139254d55a9985-Screenshot_2025-02-13_at_5.06.27_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=bd44f572649f92e94a98dbe772f5973b" width="712" height="840" data-path="images/docs/814f50f2de90ad37c5213f963cd9dca9214b5dcc708650269d139254d55a9985-Screenshot_2025-02-13_at_5.06.27_PM.png" />
  </Frame>

  4. 아래로 스크롤하여 **저장**을 클릭한 다음 **완료** 클릭
  5. 프롬프트를 표시하려는 특정 페이지에 [맞춤 JavaScript 코드](./web-sdk-reference#slidedown-prompts) 추가

  이를 통해 프롬프트 타이밍 및 배치를 완전히 제어할 수 있습니다. 구현 세부 사항은 [웹 권한 프롬프트](./permission-requests)를 참조하세요.
</Accordion>

<Accordion title="모바일 앱 구독자에게 알림을 보낼 수 있나요?" icon="circle-chevron-down">
  예! 모바일 앱이 동일한 OneSignal App ID를 사용하는 경우:

  1. WordPress 플러그인 설정에서 **"Send notification to Mobile app subscribers"** 활성화
  2. 게시물을 게시할 때 OneSignal 메타박스의 **Mobile URL** 필드를 사용하여 딥 링크 지정
  3. 맞춤 Mobile URL이 없으면 사용자는 웹사이트로 이동됩니다

  이 기능을 사용하면 단일 WordPress 인터페이스에서 크로스 플랫폼 메시징이 가능합니다.
</Accordion>

<Accordion title="WordPress에서 이메일 또는 SMS를 보내려면 어떻게 하나요?" icon="circle-chevron-down">
  WordPress 플러그인은 현재 푸시 알림만 지원합니다. 이메일 및 SMS의 경우:

  1. **이메일**: [이메일 설정 가이드](./email-setup)를 따른 다음 [이메일 메시징 도구](./email-messaging) 사용
  2. **SMS**: [SMS 설정 가이드](./sms-setup)를 따른 다음 [SMS 메시징 도구](./sms-messaging) 사용

  두 채널 모두 푸시 알림과 함께 동일한 OneSignal 대시보드에서 관리할 수 있습니다.
</Accordion>

<Accordion title="마이그레이션 후 프롬프트가 작동하지 않는 이유는 무엇인가요?" icon="circle-chevron-down">
  **캐싱 문제**: WordPress 캐싱으로 인해 마이그레이션 변경 사항이 지연될 수 있습니다.

  **해결책:**

  **1단계:** 웹사이트를 마우스 오른쪽 버튼으로 클릭하고 **검사** 선택

  **2단계:** **Network** 탭으로 이동

  **3단계:** **"Disable cache"** 선택

  <Frame caption="마이그레이션 후 업데이트된 파일을 강제로 로드하려면 브라우저 캐시 비활성화">
    <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/34b7e61edec0e1fec8954fec630ca0dc60459ad15d9472b5622b5e461b791256-Screenshot_2024-12-20_at_3.02.43_PM_1.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=9d7c9c09a6908cecf53578b1ba882342" width="777" height="156" data-path="images/docs/34b7e61edec0e1fec8954fec630ca0dc60459ad15d9472b5622b5e461b791256-Screenshot_2024-12-20_at_3.02.43_PM_1.png" />
  </Frame>

  **4단계:** 현재 구성을 보려면 웹사이트 새로고침

  **5단계:** 해당하는 경우 WordPress 캐시 플러그인 설정 지우기
</Accordion>

<Accordion title="`A bad HTTP response code (404)` 오류는 무엇을 의미하나요?" icon="circle-chevron-down">
  이 오류는 불완전한 마이그레이션을 나타냅니다:

  <Frame caption="브라우저 콘솔의 404 오류는 불완전한 마이그레이션 프로세스를 나타냅니다">
    <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5cf024c8bd09be6d420f85f846feef7242302c2052046f283ddeed09f73562d1-Screenshot_2024-12-20_at_3.11.58_PM_1.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=5cb3f5dac155fe97a0a1b3051a138242" width="1136" height="252" data-path="images/docs/5cf024c8bd09be6d420f85f846feef7242302c2052046f283ddeed09f73562d1-Screenshot_2024-12-20_at_3.11.58_PM_1.png" />
  </Frame>

  **해결책:**

  1. OneSignal 대시보드 구성을 저장했는지 확인
  2. WordPress에서 플러그인 설정의 **"Migration Completed"** 클릭
  3. 업그레이드를 완료하려면 **저장 설정** 클릭

  **이 오류는 버전 2.x.x에서 업그레이드하는 사용자에게만 영향을 미칩니다.**
</Accordion>

<Accordion title="보내기 전에 알림 매개변수를 수정할 수 있나요?" icon="circle-chevron-down">
  예, `onesignal_send_notification` 필터를 사용할 수 있습니다.

  <Info>
    맞춤 PHP 코드를 `wp-content/mu-plugins/onesignal-custom.php`에 배치하세요. 이렇게 하면 올바르게 로드되고 업데이트로 인해 덮어쓰지 않도록 방지됩니다.
  </Info>

  ```php theme={null}
  <?php

  add_filter('onesignal_send_notification', function($fields, $post_id) {

    // Create Notification API Reference에 언급된 모든 속성을 포함:
    // https://documentation.onesignal.com/reference/push-notification 예:

    // 액션 버튼 추가
    $fields['web_buttons'] = array(
      array(
        "id" => "read-more",
        "text" => "Read More",
        "url" => get_permalink($post->ID)
      )

    // 수정된 fields 배열 반환
    return $fields;

  }, 10, 2);
  ```
</Accordion>

***