메인 콘텐츠로 건너뛰기

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.

​
개요

OneSignal은 사용자가 쉽게 구독을 취소하고 구독 상태가 실시간으로 업데이트되도록 이메일 템플릿에 링크를 삽입하는 기본 이메일 규정 준수 수신 거부 경험을 제공합니다. 브랜딩, 카피 및 필드(예: 카테고리 옵트아웃)를 완전히 제어하려는 경우 기본 링크를 자체 사용자 지정 페이지로 교체하고 OneSignal API를 사용하여 사용자 기본 설정을 구독 취소하거나 업데이트할 수 있습니다. 이 가이드는 이메일에 자체 사용자 지정 수신 거부 페이지를 추가하는 방법(기본 OneSignal 링크 제거)과 사용자의 이메일 구독을 취소하는 데 사용할 API를 설명합니다. 사용자 지정 수신 거부 페이지에 더 많은 기능(모든 이메일 대신 특정 이메일 카테고리에서 옵트아웃하는 것과 같은)을 추가하려면 기본 설정 센터 튜토리얼에 자세히 설명되어 있습니다.

​
OneSignal의 기본 수신 거부 링크 제거

OneSignal은 이메일 템플릿에 [unsubscribe_url] 형식의 특수 링크를 자동으로 삽입합니다. 이 URL은 OneSignal의 모든 이메일에서 사용자를 구독 취소합니다. 자세한 내용은 이메일 수신 거부 링크를 참조하세요. 자체 페이지를 사용하려면 템플릿에서 기본 링크를 찾아 제거하세요.
드래그 앤 드롭 편집기에서 기본 링크는 다음과 같이 중첩되어 나타날 수 있습니다:
드래그 앤 드롭 편집기 수신 거부 링크

​
사용자 지정 수신 거부 링크 추가

이제 특수 링크를 제거했으므로 자체 URL로 교체할 수 있습니다. 많은 경우 이러한 링크는 페이지에 전달해야 할 추가 데이터가 필요합니다. Liquid 변수를 사용하여 OneSignal 데이터를 페이지에 전달하세요. 일반 매개변수:
매개변수설명
subscription.email구독자의 이메일 주소
subscription.external_id사용자의 외부 ID
app.idOneSignal 앱 ID
message.id이메일 알림의 ID
subscription.language선호 언어(현지화용)
subscription.unsubscribe_tokenAPI 확인을 위한 보안 토큰
예제 URL: 
https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}
HTML
  <div style="text-align: center;">
    <a
      href="https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
      data-disable-tracking="true"
      style="display: inline; text-decoration: none;"
    >
      Unsubscribe
    </a>
    <p style="display: inline;"> from our emails</p>
  </div>
사용자 지정 수신 거부 링크 추가

​
클릭 추적 비활성화

수신 거부 클릭은 일반적으로 참여 메트릭에 사용되지 않습니다. 링크 추적을 비활성화하려면 다음과 같이 링크에 data-disable-tracking="true" 속성을 추가할 수 있습니다:
HTML
  <a
    href="https://www.examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
    data-disable-tracking="true"
  >
    Unsubscribe
  </a>
공급자별 속성:
공급자속성
OneSignaldata-disable-tracking="true"
Mailgundisable-tracking=true
SendGridclicktracking=off
Mandrillmc:disable-tracking

​
사용자 지정 수신 거부 페이지 호스팅

다음을 수행하는 웹 페이지를 배포하세요:
  • 수신 거부 링크에서 쿼리 매개변수를 읽습니다.
  • 사용자 친화적인 옵트아웃 또는 기본 설정 옵션을 표시합니다.
  • API를 통해 OneSignal에 수신 거부 또는 업데이트 요청을 보냅니다.
포크하고 배포할 수 있는 작동하는 GitHub 샘플 프로젝트를 제공합니다.
샘플 수신 거부 페이지

​
OneSignal API 호출

사용 사례에 따라 다음 API를 사용하여 사용자 기본 설정을 구독 취소하거나 업데이트할 수 있습니다:
이 API는 사용자의 이메일 주소가 있고 모든 이메일에서 구독하거나 구독을 취소하려는 경우에 가장 일반적으로 사용됩니다.필수 쿼리 매개변수:
  • app_id
  • token
인증 필요
  • 서버에서 이 API를 호출하세요.
이제 사용자 지정 수신 거부 페이지 만들기에 대해 알아야 할 모든 것을 갖추었습니다.