WordPress

​

개요

​

버전 3+의 새로운 기능

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

​

설정

• OneSignal 계정 (무료 생성)
• 플러그인을 설치하고 구성하기 위한 WordPress 관리자 액세스 권한
• HTTPS 지원 웹사이트 (웹 푸시 알림에 필요)

​

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

OneSignal 대시보드의 Website Builder 옵션에서 WordPress 선택

​

사이트 설정

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

정확한 Site URL을 입력하세요. https://your-site.com과 https://www.your-site.com은 다릅니다—한 가지 형식만 일관되게 사용하세요

​

권한 프롬프트

• 기본 프롬프트 설정
• 고급: 카테고리 기반 세분화

1

Push Slide Prompt를 클릭하여 사용자 지정

푸시 슬라이드 프롬프트 설정에 액세스하고 사용자 지정

2

타이밍 및 텍스트 구성:

• 초기 테스트를 위해 Auto Prompt를 1 페이지뷰와 1초로 설정
  • 프롬프트 텍스트 및 모양 사용자 지정
  • 출시 후 사용자 행동에 따라 타이밍 조정

자동 프롬프트 타이밍을 구성하고 프롬프트 모양을 사용자 지정

3

프롬프트 구성을 완료하면 완료를 클릭하세요.

사용자 관심사에 따른 타겟 메시징을 위해 카테고리를 설정하세요:

1

프롬프트 설정에서 카테고리 선택

2

다음을 사용하여 각 카테고리 구성:

• Label: 사용자가 프롬프트에서 보는 내용
• Tag Key: 세분화를 위한 내부 태그 키

3

프롬프트 구성을 완료하면 완료를 클릭하세요.

예: 뉴스 및 거래 카테고리를 설정하면 이러한 옵션을 선택한 사용자에 대해 'news: 1' 및 'deals: 1' 태그가 생성됩니다

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

​

환영 알림

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

​

2. WordPress 플러그인 구성

OneSignal 대시보드에서 App ID와 API Key를 복사

WordPress 플러그인 App ID와 REST API Key가 OneSignal 대시보드와 정확히 일치하는지 확인

​

고급 설정

향상된 기능 및 분석 추적을 위한 고급 설정

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. 마이그레이션 완료 (업그레이드 사용자만 해당)

플러그인 업그레이드를 완료하려면 Migration Completed 클릭

​

설정 테스트

• 초기 테스트
• 구독 확인
• 테스트 메시지 보내기

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

구성한 슬라이드다운 프롬프트가 타이밍 설정에 따라 나타나야 합니다

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

웹 푸시 알림에 필요한 브라우저 권한 프롬프트 (브라우저에 따라 모양이 다름)

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

환영 알림은 성공적인 구독 직후에 나타납니다

1. OneSignal 대시보드에서 오디언스 > 구독으로 이동 2. 웹 푸시 구독이 “Subscribed”로 표시되어야 합니다

성공한 구독은 OneSignal 대시보드 오디언스에 나타납니다

1. OneSignal 대시보드에서 메시지 > 푸시로 이동 2. 새 메시지 생성 3. 자신에게 테스트 알림 보내기 4. 알림이 올바르게 표시되는지 확인 자세한 지침은 푸시 메시징 가이드를 참조하세요.

• 고급 사용자 지정을 위해 웹 권한 프롬프트 검토
• 이메일 및 SMS 통합을 위해 채널 설정 탐색
• 타겟 메시징을 위한 세분화 전략 설정

​

알림 게시

​

기본 게시물 알림

OneSignal Push Notifications 메타박스—필요한 경우 드래그하여 위치 변경

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

​

오디언스 타겟팅

​

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

​

특정 세그먼트에 보내기

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

태그는 대소문자를 구분합니다! 'news'와 'News'는 다른 태그입니다

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

관련 사용자 그룹을 타겟팅하려면 특정 세그먼트 선택

​

알림 콘텐츠 사용자 지정

​

기본 동작

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

​

맞춤 콘텐츠

알림 제목, 콘텐츠 및 기타 요소 사용자 지정

사용자에게 표시되는 사용자 지정 푸시 알림

​

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

​

맞춤 게시물 유형 이름 찾기

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

​

OneSignal 설정에 추가

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

​

모바일 앱 통합

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

​

FAQ

특정 페이지에서 프롬프트를 비활성화하려면 어떻게 하나요?

참고: 이 방법은 슬라이드다운 및 네이티브 권한 프롬프트에만 작동하며, 벨 또는 맞춤 링크 프롬프트에는 작동하지 않습니다.

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

프롬프트가 표시되는 시점을 수동으로 제어하려면 Auto Prompt 비활성화

4. 아래로 스크롤하여 저장을 클릭한 다음 완료 클릭
5. 프롬프트를 표시하려는 특정 페이지에 맞춤 JavaScript 코드 추가

이를 통해 프롬프트 타이밍 및 배치를 완전히 제어할 수 있습니다. 구현 세부 사항은 웹 권한 프롬프트를 참조하세요.

마이그레이션 후 프롬프트가 작동하지 않는 이유는 무엇인가요?

캐싱 문제: WordPress 캐싱으로 인해 마이그레이션 변경 사항이 지연될 수 있습니다.해결책:1단계: 웹사이트를 마우스 오른쪽 버튼으로 클릭하고 검사 선택2단계: Network 탭으로 이동3단계: “Disable cache” 선택

마이그레이션 후 업데이트된 파일을 강제로 로드하려면 브라우저 캐시 비활성화

4단계: 현재 구성을 보려면 웹사이트 새로고침5단계: 해당하는 경우 WordPress 캐시 플러그인 설정 지우기

`A bad HTTP response code (404)` 오류는 무엇을 의미하나요?

이 오류는 불완전한 마이그레이션을 나타냅니다:

브라우저 콘솔의 404 오류는 불완전한 마이그레이션 프로세스를 나타냅니다

해결책:

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

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

<?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);