구독 상태 및 차단 로직
이메일 구독은 다음 중 하나입니다:- 구독됨 – 이메일 메시지를 받을 수 있습니다.
- 구독 취소됨 – 명시적으로 재정의하지 않는 한 대부분의 이메일 전송에서 제외됩니다.
- 대시보드에서: 이메일을 보낼 때 고급 설정 > 구독 취소된 사용자에게 보내기 포함을 활성화합니다.
- API에서: 이메일 알림 생성 API에서
include_unsubscribed속성을 사용합니다.

구독 취소된 사용자에게 보내기 활성화
사용자가 구독 취소되는 방법
이메일 구독 상태는 다음을 통해 업데이트됩니다:- 사용자가 구독 취소 링크 또는 List-Unsubscribe 헤더를 클릭
- 이메일 주소 CSV를 가져오고
subscribed를no로 설정 - 사용자 생성, 사용자 업데이트 또는 구독 업데이트 API를 통해
enabled : false를 설정 - 오디언스 > 구독 > 옵션 > 이메일 구독 취소에서 수동으로 구독 취소
구독 취소 헤더 vs 구독 취소 링크
- List-Unsubscribe 헤더: 받은 편지함 제공업체가 네이티브 “구독 취소” 버튼을 표시하는 데 사용하는 숨겨진 이메일 헤더입니다(예: Gmail, Yahoo).
- 구독 취소 링크:
[unsubscribe_url]토큰을 사용하여 이메일 콘텐츠에 배치되는 보이는 클릭 가능한 URL입니다.
List-Unsubscribe 헤더 동작
OneSignal은 “구독 취소된 사용자에게 보내기 포함”을 활성화하는 경우를 제외하고 모든 이메일에List-Unsubscribe 헤더를 포함합니다. 이는 다음에 도움이 됩니다:
- 이메일이 스팸으로 표시되는 것을 방지
- Gmail/Yahoo 2024 규칙을 준수
사용자가 이를 클릭하면 OneSignal 앱에서 이메일 구독이 구독 취소됨으로 표시됩니다.
이메일에 구독 취소 링크 추가
OneSignal은 이메일 콘텐츠에 보이는 구독 취소 링크를 삽입하는[unsubscribe_url] 토큰을 제공합니다.
자체 구독 취소 페이지로 브랜드 경험을 만들 수도 있습니다. 사용자 지정 구독 취소 페이지 만들기를 참조하세요.
HTML 편집기
HTML 편집기를 사용하는 경우 기본 템플릿에 구독 취소 링크가 자동으로 포함됩니다:
기본 구독 취소 링크가 있는 HTML 편집기
email_body로 API를 통해):
HTML
드래그 앤 드롭 편집기
텍스트 블록에서:- 특수 링크 > 차단 > 구독 취소를 클릭합니다
[unsubscribe_url]플레이스홀더가 삽입됩니다- 삽입하기 전에 텍스트를 강조 표시하여 링크로 변환할 수 있습니다

드래그 앤 드롭 편집기의 구독 취소 링크
읽을 수 있는 글꼴 크기(최소 12px) 및 강한 대비로 구독 취소 링크를 항상 매우 눈에 띄게 만드세요. 숨겨져 있거나 찾기 어려운 링크는 사용자가 메시지를 스팸으로 표시하도록 유도하여 향후 전달률을 손상시킬 수 있습니다.
사용자 지정 구독 취소 링크 대상
자체 구독 취소 랜딩 페이지로[unsubscribe_url]을 교체할 수 있습니다.
이렇게 하려면:
- 사용자 지정 구독 취소 페이지 만들기의 단계를 따르세요.
- 이메일의
[unsubscribe_url]을 사용자 지정 구독 취소 페이지의 URL로 교체합니다.
사용자 지정 링크를 사용하는 경우 OneSignal은 사용자를 자동으로 구독 취소됨으로 표시하지 않습니다. API 또는 페이지 동작을 통해 처리해야 합니다.
FAQ
테스트 이메일에서 구독 취소 링크가 작동하지 않는 이유는 무엇인가요?
OneSignal 이메일 전송 도메인이 아직 확인되지 않은 경우 테스트 이메일의 구독 취소 링크가 작동하지 않습니다. 플레이스홀더 텍스트가 표시되지만 실제 링크는 표시되지 않습니다. 도메인이 확인되면 구독 취소 링크가 렌더링되고 제대로 작동합니다.이메일 주소를 다시 구독하려면 어떻게 해야 하나요?
사용자는 세 가지 방법으로 재구독할 수 있습니다:- 대시보드: 오디언스 > 구독 > 옵션 > 이메일 재구독으로 이동합니다
- API: 사용자 생성 또는 구독 업데이트 API에서
enabled: true를 설정합니다 - CSV 가져오기: 이메일 주소를 가져올 때
subscribed = yes를 설정합니다
타사 이메일 제공업체(ESP)를 사용하는 경우 차단 목록을 확인하고 해당 주소도 제거하세요.
이메일에 구독 취소 링크가 두 개 있는 이유는 무엇인가요?
Mailgun 또는 SendGrid와 같은 ESP를 사용하는 경우 자체 구독 취소 링크를 삽입할 수 있습니다. ESP 설정에서 이를 비활성화하여 중복을 방지할 수 있습니다.구독 취소 클릭이 분석에 포함되나요?
- OneSignal 사용자 지정
[unsubscribe_url]을 클릭해도 클릭 분석에 포함되지 않습니다. - 사용자 지정 구독 취소 URL을 클릭하면 클릭으로 계산됩니다. 자세한 내용은 URL, 링크 및 딥 링크를 참조하세요.